Statusengine - the missing event broker => 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

Download Statusengine
The best way is to download a stable version or clone the repository
Set required permissions
```
chmod +x install.sh
./install.sh
```

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
);

Create MySQL databases
Naemon:


mysql -u root -p < sql/naemon.sql

Nagios:


mysql -u root -p < sql/nagios.sql

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

Change path to your naemon.cfg in /opt/statusengine/cakephp/app/Config/Statusengine.php
```
<?php
//some more content...
'coreconfig' => '/etc/naemon/naemon.cfg',
```

Load the broker module in your naemon.cfg


broker_module=/opt/statusengine/statusengine-naemon.o

Start the Gearman Job Server
```
service gearman-job-server start
```

Run Statusengine in legacy mode


service statusengine start

Foreground mode for debugging:


/opt/statusengine/cakephp/app/Console/cake statusengine_legacy -w

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 ¶

Download Statusengine
The best way is to download a stable version or clone the repository
Set required permissions
```
chmod +x install.sh
./install.sh
```

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
);

Stop your Naemon and DB connector


service naemon stop
/etc/init.d/${some well known other solution} stop

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

Change path to your naemon.cfg in /opt/statusengine/cakephp/app/Config/Statusengine.php
```
<?php
//some more content...
'coreconfig' => '/etc/naemon/naemon.cfg',
```

Load the broker module in your naemon.cfg


broker_module=/opt/statusengine/statusengine-naemon.o

Start the Gearman Job Server
```
service gearman-job-server start
```

Run Statusengine in legacy mode


service statusengine start

Foreground mode for debugging:


/opt/statusengine/cakephp/app/Console/cake statusengine_legacy -w

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.