Installation
Prerequisites
Please make sure you have all the prerequisites installed on your system:
- WebReboot Enterprise -- firmware v1.2 -OR- WebReboot 3.0
- Nagios 2.0+ (note that Nagios 3.0b support has not been fully tested yet)
- Java 1.4+ (only necessary for WebReboot 3.0 support)
- Python 2.4+
- SQLite 3 (this is included in Python 2.5+ -- older versions of Python will require the pysqlite2 library)
- ZSI 2.0+ for Python
- Please make sure that you also install all of ZSI's dependencies.
- Do not install ZSI with easy_install. This method is broken. Install via source or your distribution's package management system.
- Note for pre-Gutsy Gibbon Ubuntu users: ZSI 2.0 is only available in the most recent stable release. You will have to download the ZSI deb file and install it manually via "dpkg -i" in order for these plugins to work. This will not impact any other part of your Python distribution.
Installing the Plugin
If you have not already done so, please download the latest version of the
WebReboot® Nagios® plugin. Once you have downloaded it, unpack the file like so:
tar -zxvf webreboot-nagios-plugin-latest.tar.gz
Inside the resulting webreboot-nagios-plugin directory, you will find a file named install.sh.
Before executing this file, you must modify some configuration values. These values are used
to indicate where the plugin should be installed and are particular to your Nagios installation
path.
vi webreboot-nagios-plugin/install.sh
The configuration values are:
| Name: | NAGIOS_PLUGIN_DIR |
|---|---|
| Description: | Fully specifed path to your Nagios plugins installation directory. |
| Default value: | '/usr/lib/nagios/plugins' |
| Name: | NAGIOS_CONFIG_DIR |
|---|---|
| Description: | Fully specified path to you Nagios configuration files directory. If your Nagios configuration does not load other configuration files by directory, then specify a temporary directory to store the WebReboot Nagios plugin configuration file. |
| Default value: | '/etc/nagios-plugins/config' |
| Name: | NAGIOS_USER |
|---|---|
| Description: | Username that the Nagios process will run as. The plugin installation directory must be owned by this user. Failure to set this property properly could result in the plugin failing to run or may lead to a leak of WebReboot connection information, including usernames and passwords. |
| Default value: | 'nagios' |
./webreboot-nagios-plugin/install.sh
The installer does not require elevated priviliges per se, but if your user account does not have
permissions to access the Nagios installation directories, then you will need to run the script with
an account that does.
At this point, the installation is complete. You can now move onto configuration.