What is OKConfig ?

OKConfig is a robust templating mechanism for Nagios configuration files. Providing standardized set of configuration templates and pre-selected quality plugins to enterprise quality monitoring.

OKConfig includes default temlates for most common operating systems and devices found in the enterprise, along with tools to quickly add new hosts, service checks and groups.

Currently okconfig has over 500 predefined service checks and plugins for most common platforms and applications. See and (outdated) list of Supported Platforms

Design Goals

Our priority is to provide the following to Nagios administrators:

Rapid Deployment

• New Nagios Installation should be as rapid as possible
• Configure new hosts should be as rapid as possible
• Complex monitoring, with many service checks (like check_oracle) should be preconfigured

Batteries included

• Predefined service checks for the most common equipment found in the enterprise. In other words, configuring monitoring for a vmware server should not be an 8hour job.

Centrally managed

• Whenever possible, you should be able to define warning thresholds from the monitoring server

Stick to defaults

• Use mainstream community plugins wherever possible
• Use features of rich monitoring clients (like nsclient) if they exist and fit our purposes.
• Be compatible with other, pre-existing nagios installations (i.e. dont overwrite check_ping with another plugin)

Secure

• Take every precaution available with security sensitive features like "allow_arguments" on the nagios clients.

Examples on using OKConfig toolkit

Adding a new host to the environment:

# addhost --host host.example.com --ip 127.0.0.1 --templates windows,dns,mssql
Host host.example.com (127.0.0.1) successfully saved as /etc/nagios/okconfig/hosts/default/host.example.com-host.cfg
Template windows successfully added to /etc/nagios/okconfig/hosts/default/host.example.com-windows.cfg
Template dns successfully added to /etc/nagios/okconfig/hosts/default/host.example.com-dns.cfg
Template mssql successfully added to /etc/nagios/okconfig/hosts/default/host.example.com-mssql.cfg
# TODO: Remember to change MSSQL username/password whith access to the SQL Server

Adding Oracle checks to a pre-existing host:

# addtemplate --host oracleserver.example.com --template oracle }}}
Template oracle successfully added to /etc/nagios/okconfig/hosts/default/host.example.com-oracle.cfg
# TODO: Remember to change Oracle username/password with access to the SQL Server

Create a set of contactgroup/servicegroup/hostgroup called "databases":

# addgroup --group databases

Tools for adding devices and projects with connected contactgroups/hostgroups/servicegroups.