Copyright (c) 2008 Nico Bagari & Thomas Buffagni
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License".

The instructions below are mainly for latest stable versions of BrainyPDM,
e.g. 1.0, and might differ in other versions of Nagios.

Please, visit www.brainypdm.org for more information.

I'm sorry for my primitive english.

Glossary

- $BRAINY_HOME: the path where your brainyPDM distribution reside.

Installation Preliminaries

- Install java jdk 1.5 or later

- verify your java settings:

[root@test brainy]# java -version
java version "1.5.0_06"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode, sharing)

- download the distribution (embedded db or not)

- Extract the zip distribution into a temporary location:
unzip <zip file name>

- Copy all unzipped file in your preferred path,
e.g. /opt/brainypdm (so your $BRAINY_HOME=/opt/brainypdm)

- setting all execution permission to *.sh file:

chmod ugo+x *.sh

- edit $BRAINY_HOME/conf/brainy.properties and setting port and
host name and ip.

Make brainy db

- If you are using db embedded distribution (full):

- starting BrainyPDM in db embedded creation mode:

./brainypdm.sh -q

- open Brainypdm console in a different bash:

./console.sh

- create db:

brainypdm>db -c

- shutdown the instance

brainypdm>shutdown -a

- starting brainyPDM:

./brainypdm.sh

- if you are using no db embedded distribution (light)

- setting in $BRAINY_HOME/conf/brainy.properties your
database information

- copy jdbc library for your preferred database in $BRAINY_HOME/lib

- open Brainypdm console:

./console.sh

- create db:

brainypdm>db -c

- starting brainyPDM:

./brainypdm.sh

Check if all works

The first log for brainy is $BRAINY_HOME/log/defaultInstance/brainy.log
Please, if you have some ERROR contact us at www.brainypdm.org.

Service Perfdata Processing Configuration

- copy $BRAINY_HOME/brainysend.sh in your preferred path

- edit brainysend.sh with host and nagios port
setted in $BRAINY_HOME/conf/brainy.properties

- test the comunication:

./brainysend.sh teststring

if it work, you have to see in $BRAINY_HOME/log/defaultInstance/brainy.log
an error.

- In nagios.cfg:

process_performance_data=1
service_perfdata_command=process-service-perfdata

Make sure that service_perfdata_file_processing_command is either
commented out or not defined.

- In checkcommands.cfg or misccommands.cfg, depending on which one is
defined in nagios.cfg:

define command{
command_name process-service-perfdata
command_line /usr/lib/nagios/plugins/send.sh "$LASTSERVICECHECK$||$HOSTNAME$||$SERVICESTATE$||$SERVICEEXECUTIONTIME$||

$SERVICEDESC$||$SERVICEOUTPUT$||$SERVICEPERFDATA$"
}

Enable graph generation

- Open web console on: http://<host>:<port>/ where host and
port are setted in $BRAINY_HOME/conf/brainy.properties

- enter with:

user: webadmin

password: websecret

- if brainy have collected some data, please, select host, then services
and performance data. Click "graph generation" if you want the graph.
The graph will generated approx in 25 minute depending on your configuration.

Thank you very much.

Last update: 11-08-2009