net-mgmt/observium 26.1 FreeBSD

Configuration

Options name: net-mgmt_observium

USES

cpe php:cli,flavors python shebangfix sudo

Service scripts

none

Flavors

observium-php83-26.1, observium-php84-26.1, observium-php85-26.1, observium-php86-26.1

Message after installing

=== Configuration details ===
You can mostly follow the guide at:
https://observium.org/wiki/Installation

with the following notes:
- Installation directory is /usr/local/www/observium
- The following lines should be put in a file /usr/local/etc/cron.d/observium
  or alternatively /etc/cron.d/observium

# Run a complete discovery of all devices once every 6 hours
33	*/6	*	*	*	www	/usr/local/www/observium/observium-wrapper discovery >/dev/null 2>&1
# Run automated discovery of newly added devices every 5 minutes
*/5	*	*	*	*	www	/usr/local/www/observium/observium-wrapper discovery --host new >/dev/null 2>&1
# Run multithreaded poller wrapper every 5 minutes
*/5	*	*	*	*	www	/usr/local/www/observium/observium-wrapper poller >/dev/null 2>&1
# Run housekeeping script daily for syslog, eventlog and alert log
13	5	*	*	*	www	/usr/local/www/observium/housekeeping.php -ysel >/dev/null 2>&1
# Run housekeeping script daily for rrds, ports, orphaned entries in the database and performance data
47	4	*	*	*	www	/usr/local/www/observium/housekeeping.php -yrptb >/dev/null 2>&1

Notes:

- A minimal install can be created with the following steps and configuration file:

0: make sure apache and mysql are up and running.

1: create the database and a dbaccount with the following (my)SQL commands:

    CREATE DATABASE observium DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
    GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost' IDENTIFIED BY 'notSecure';

2: create config file starting with the sample config file

        cp /usr/local/www/observium/config.php.default /usr/local/www/observium/config.php

   and make sure to set at least the following fields:

        $config['db_host'] = 'localhost';
        $config['db_user'] = 'observium';
        $config['db_pass'] = 'notSecure';
        $config['db_name'] = 'observium';

3:  populate the admin user and initialize the database (as 'www' user):

        sudo -u www /usr/local/www/observium/discovery.php -u
        sudo -u www /usr/local/www/observium/adduser.php admin SomeInsecureAdminPassword 10

4:   and verify that collection is working:

        sudo -u www /usr/local/www/observium/discovery.php -h all -d
        sudo -u www /usr/local/www/observium/poller.php -h all -d

5: Install the above crontabs.

6: Edit the file

   /usr/local/etc/apache24/Includes/observium.conf
   
   and fill out a port number and hostname, or use the
   default at port 8080.

7: restart the webserver with 

       service apache24 restart

   or stop/start if in case of IP or SSL changes.

6: log in with a web browser; using the username 'admin' and the
   password 'SomeInsecureAdminPassword'.

   Hosts can be added from the webinterface or from the commandline.