BSD Ports

net-mgmt/observium 24.12 DragonFly

Autodiscovering PHP/MySQL/SNMP based network monitoring

System
DragonFly
Repository
DPorts
Maintainer
[email protected] (as in FreeBSD)
License
EULA
Categories
net-mgmt
Package size
74594.2 KiB, 910496.1 KiB installed

Description

Observium is an autodiscovering PHP/MySQL/SNMP based network monitoring which includes support for a wide range of network hardware and operating systems including Cisco, Linux, FreeBSD, Juniper, Brocade, Foundry, HP and many more.

Observium has grown out of a lack of easy to configure network monitoring platforms. It is intended to provide a more navigable interface to the health and performance of your network. Its design goals include collecting as much historical data about devices as possible, being completely autodiscovered with little or no manual intervention, and having a very intuitive interface.

In the other systems

The newest version among them is 26.1, as upstream numbers it.

SystemPortVersionVulnerabilitiesStatusMaintainerLast update
DragonFlynet-mgmt/observium24.12none known-[email protected]-
FreeBSDnet-mgmt/observium26.1 newestnone known-[email protected]-
HardenedBSDnet-mgmt/observium26.1 newestno data-[email protected]-
GhostBSDnet-mgmt/observium26.1 newestno data-[email protected]-

Install

Binary package:

pkg install observium-php81

From DPorts:

cd /usr/dports/net-mgmt/observium && make install clean

Dependency graph

Ports that need it on the left, what it needs to run on the right; at most 8 of each. "Dependencies" below lists them all.

Dependencies

Run dependencies 30

No port depends on this one.

Configuration

No options to configure.

Service scripts
none
Flavors
observium-php82-24.12, observium-php83-24.12, observium-php84-24.12

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.