Documentation

Project: opcfg

Document: Requirements
- Web Server ( Apache )
- PHP 5.x
  - PHP MySQL Extension
  - PHP Session Extension
- MySQL Database Engine
  - Tested on MySQL 4.1, should work on 3.x as well.
- Nagios v3.x
  - Nagios v1.x and v2.x are no longer supported.
Document: Screenshots
Document: Installation
- Extract this codebase in your nagios web directory's document root ( in this example is /usr/local/nagios/share ). This will extract the files in a opcfg subdirectory.
```
 [root@localhost]# tar -xvzf opcfg-{VERSION}.tar.gz -C /usr/local/nagios/share  
```
- Create a symlink or copy of your nagios's icon logo's directory to the opcfg's base directory with the name of logos.
```
 [root@localhost ]# cd /usr/local/nagios/share/opcfg
 [root@localhost opcfg]# ln -sf /usr/local/nagios/share/images/logos .
```
- Create a database for opcfg in MySQL with select,insert,drop,empty privileges. Import the SQL data contained in sqldata/fruity-mysql.sql
```
 [root@localhost opcfg]# cd sqldata
 [root@localhost sqldata]# mysql -f -u {user} -p < opcfg.sql
 Enter password: {password}  
```
- Configure the config.inc file in opcfg's includes directory. Notes on what each parameter is specified in the file.
- Adjust nagios and opcfg's permission to allow web server group ( in this example is apache ) to write there.
```
 [root@localhost]# chow -R apache.apache /usr/local/nagios/share/opcfg
 [root@localhost]# chown -R .apache /usr/local/nagios/etc
 [root@localhost]# chown -R .apache /usr/local/nagios/libexec
 [root@localhost]# chmod -R g+w /usr/local/nagios/etc
 [root@localhost]# chmod -R g+w /usr/local/nagios/libexec
```
- Point your web browser to /nagios/opcfg/ on your webserver to start OpCfg.
Document: Todo
- Support for Nagios 3.x advanced timeperiods
- Support for groups ( hostgroups and servicegroups ) to have other groups as members

Project: opcp

Document: Requirements
- opcfg
- opdb
- nagios 3.x
Document: Screenshots

Project: opdb

Document: Requirements
- nagios 3.x
- Mysql database
- opmon-opcfg - the broker reads the host_ids and service_ids out of the opcfg database

Document: Installation

Open the pkg inside the modules directory of a nagios 3.x
Edit opdb.c and set up these 3 lines

 /* This file has the mysql database host, user and password, a example file is supplied */
 #define DBCONF "/usr/local/nagios/etc/db.php"
 /* In case the broker can't write to the database, it writes the queries to a file, so 
 they can be importer later on, both for opmon statiscts and performance database 
 */
 #define FAILED_QUERIES_FILE "/usr/local/nagios/var/opmon.sql"
 #define PERF_FAILED_QUERIES_FILE "/usr/local/nagios/var/opperf.sql"

In the directory modules run to compile it:

 gcc -D_GNU_SOURCE -Wall -shared -o opdb.o opdb.c -L/usr/lib/mysql -lmysqlclient -DNSCORE

Copy it to your nagios directory
create the mysql databases with the supplied script opmon-mysql.sql

 Ex. mysql -p -f < opmon-mysql.sql

in opcfg, go to Main Config, Event Broker and add it there
Export the configuration and you should see it writing to the databases

Document: Internal structure
- It writes all the nagios statistics like host state changes, service state changes, schedule downtimes, comments and so on in the database opmon.
- All performance data is written to the datadase opperf and each host has a dynamic created table in the format: perf_ where host_id comes from the opcfg database. This strategy was tought to easy administration, increase query speed and update, instead of having a huge table, we split them in hosts.
- In the opperf database there is a table service_metric that contains all the metrics a host and service have.

Projects

opcfg

OpCfg is a PHP-based HTTP configuration front-end to Nagios 3.x. OpCfg is a fork from Fruity.

opcp

OpCP is a capacity planning graph generator based on opdb ( nagios broker ) database.

opdb

The opdb project is a nagios broker that writes statistics and performance data to a mysql database.

opmonagent

OpMonAgent has been developed to get performance information from Windows Servers and return them to Nagios using the check_nt client.

Documentation

Project: opcfg

opcfg screenshot - services details

opcfg screenshot - search

opcfg screenshot - list by hostgroup

opcfg screenshot - import template

opcfg screenshot - host group and services

opcfg screenshot - export templates

opcfg screenshot - export details

opcfg screenshot - duplicate host

opcfg screenshot - create template from host

opcfg screenshot - contact group

opcfg screenshot - contact editor