Getting Started

Requirements

  • Naemon or Nagios 4
  • MySQL Server or MariaDB
  • PHP 5.4 or greater
I recommend to use Ubuntu 14.04 because everything you need is in the repository. If you want to use a different OS, please take a look at the advanced setup guide.

No Naemon installation?

Read the Naemon installation how to

Looking for other Ubuntu or Debian version?

Go to supported operating systems

PHP 7 ready!

Statusengine 2.x is tested on PHP 5 and PHP 7

Take a look at the PHP 7 guide for more information

Statusengine 2 is Ubuntu 16.04 LTS and systemd ready!

Statusengine is tested with

Naemon:

  • Naemon 0.8.0
  • Naemon 1.0.3

Nagios:

  • Nagios 4.0.8
  • Nagios 4.1.1

Installation

Notice:

If you want to install Statusengine and the Statusengine Web Interface click here!

Notice:

If you want to use Statusengine to write rrdtool based graphs, you need to install the following to packages:


apt-get install rrdtool php5-rrd

I try to keep the installation as easy as possible. If you want to migrate to Statusengine please check out the migration guide

  1. Download Statusengine
    The best way is to download a stable version or clone the repository
  2. Set required permissions
    
    chmod +x install.sh
    ./install.sh
    
    
  3. Set your MySQL username and passwort in /opt/statusengine/cakephp/app/Config/database.php
    
    <?php
    public $legacy = array(
        
    'datasource' => 'Database/Mysql',
        
    'persistent' => false,
        
    'host' => 'localhost',
        
    'login' => 'nagios',     //Username
        
    'password' => '12345',   //Password
        
    'database' => 'nagios',  //Database name
        
    'prefix' => 'nagios_',   //Table prefix, you can set this to naemon_ as well
        
    'encoding' => 'utf8',     //Set charset to UTF-8
    );
  4. Create MySQL databases
    Naemon:
    
    mysql -u root -p < sql/naemon.sql
    
    
    Nagios:
    
    mysql -u root -p < sql/nagios.sql
    
    
  5. Create database tables (using CakePHP shell) MyISAM
    
    /opt/statusengine/cakephp/app/Console/cake schema update --plugin Legacy --file legacy_schema.php --connection legacy
    
    

    or if you want to use InnoDB:
    Create database tables (using CakePHP shell) InnoDB (Recommended!)
    
    /opt/statusengine/cakephp/app/Console/cake schema update --plugin Legacy --file legacy_schema_innodb.php --connection legacy
    
    
  6. Change path to your naemon.cfg in /opt/statusengine/cakephp/app/Config/Statusengine.php
    
    <?php
    //some more content...
    'coreconfig' => '/etc/naemon/naemon.cfg',
  7. Load the broker module in your naemon.cfg
    
    broker_module=/opt/statusengine/statusengine-naemon.o
    
    
  8. Start the Gearman Job Server
    
    service gearman-job-server start start
    
    
  9. Run Statusengine in legacy mode
    
    service statusengine start
    
    
    Foreground mode for debugging:
    
    /opt/statusengine/cakephp/app/Console/cake statusengine_legacy -w
    
    
  10. Restart your Naemon
    
    service naemon restart
    
    
Thats all, now check your logs (naemon.log and/or /var/log/syslog) and your database if everything is working

Migrate to Statusengine

  1. Download Statusengine
    The best way is to download a stable version or clone the repository
  2. Set required permissions
    
    chmod +x install.sh
    ./install.sh
    
    
  3. Set your MySQL username and passwort in /opt/statusengine/cakephp/app/Config/database.php
    
    
    <?php
    public $legacy = array(
        
    'datasource' => 'Database/Mysql',
        
    'persistent' => false,
        
    'host' => 'localhost',
        
    'login' => 'nagios',     //Username
        
    'password' => '12345',   //Password
        
    'database' => 'nagios',  //Database name
        
    'prefix' => 'nagios_',   //Table prefix, you can set this to naemon_ as well
        
    'encoding' => 'utf8',    //Set charset to UTF-8
    );
  4. Stop your Naemon and DB connector
    
    service naemon stop
    /etc/init.d/${some well known other solution} stop
    
    
  5. Upgrade your database tables (using CakePHP shell) MyISAM
    
    /opt/statusengine/cakephp/app/Console/cake schema update --plugin Legacy --file legacy_schema.php --connection legacy
    
    
    or if you want to use InnoDB:
    Upgrade your database tables (using CakePHP shell) InnoDB (Recommended!)
    
    /opt/statusengine/cakephp/app/Console/cake schema update --plugin Legacy --file legacy_schema_innodb.php --connection legacy
    
    
  6. Change path to your naemon.cfg in /opt/statusengine/cakephp/app/Config/Statusengine.php
    
    <?php
    //some more content...
    'coreconfig' => '/etc/naemon/naemon.cfg',
  7. Load the broker module in your naemon.cfg
    
    broker_module=/opt/statusengine/statusengine-naemon.o
    
    
  8. Start the Gearman Job Server
    
    service gearman-job-server start
    
    
  9. Run Statusengine in legacy mode
    
    service statusengine start
    
    
    Foreground mode for debugging:
    
    /opt/statusengine/cakephp/app/Console/cake statusengine_legacy -w
    
    
  10. Start your Naemon
    
    service naemon start
    
    

Thats all, now check your logs (naemon.log and/or /var/log/syslog) and your database if everything is working


Nagios, NDOUtils and the Nagios logo are trademarks, servicemarks, registered trademarks or registered servicemarks owned by Nagios Enterprises, LLC. All other trademarks, servicemarks, registered trademarks, and registered servicemarks are the property of their respective owner(s).
All other trademarks are property of their respective owners. Other product or company names mentioned may be trademarks or trade names of their respective owner.