Agenda: observium-install-vFR.txt

% Observium     
%
% Installation

# Introduction

## Objectifs

* Apprendre à installer observium

## Notes

* Les commandes précédées du symbole "$" doivent être exécutées avec le compte de l'utilisateur sysadm - pas en tant que root
* Les commandes précédées du symbole "#" doivent être exécutées en tant que root
* Certaines commandes seront éxécutées en mode CLI d'un équipement ou service (e.g. "rtrX>" or "mysql>") 

# Installation de Observium 

## 1. Installation basé on offical instructions

Notez que vous aurez besoin d'exécuter les commandes d'installations en utilisant 'sudo' ou en vous connectant temporairement avec le compte root avec 'sudo -s'

Source :

http://www.observium.org/wiki/Debian_Ubuntu_Installation

Nous avons effectué des modifications mineures mais l'URL ci-dessus est la source de référence pour l'installation de Observieum sous Ubuntu/

Nous ferons l'installation avec le compte root. Accédez à votre machine virtuelle avec l'utilisateur sysadm et exécutez les commandes ci-dessous :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ sudo -s
# apt-get update
# apt-get install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-snmp php-pear snmp graphviz \
                  php5-mcrypt php5-json subversion mysql-server mysql-client rrdtool fping \
                  imagemagick whois mtr-tiny nmap ipmitool python-mysqldb
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Cela prendra quelques minutes.

Si le mot de passe de l'utilisateur root pour accéder à mysql vous est demandé, mettez celui défini lors de l'installation de mysql. Probablement celui de la classe.

Une fois que l'installation sera terminée, exécutez les commandes ci-après:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# mkdir -p /opt/observium && cd /opt
# wget http://noc.ws.nsrc.org/downloads/observium/observium-community-latest.tar.gz
# tar zxvf observium-community-latest.tar.gz
# cd observium
# cp config.php.default config.php
# editor config.php
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Trouvez ces deux lignes:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$config['db_user'] = 'USERNAME';
$config['db_pass'] = 'PASSWORD';
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

et remplacez les par :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$config['db_user'] = 'observium';
$config['db_pass'] = 'nsrc+ws';
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Sauvegardez et quittez le fichier.

Nous allons maintenant créer la base de données Observium, définir le mot de passe et les privilèges pour l'utilisateur observium.
Le mot de passe de l'utilisateur root pour accéder à mysql devrait être le mot de passe de la classe.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# mysql -u root -p      <mysql root password>
mysql> CREATE DATABASE observium;
mysql> GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost' IDENTIFIED BY '<observium db password>';
mysql> exit
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Nous allons alimenter la base de données et créer un ensemble de répertoires :

Mais avant vous pouvez utiliser le script de validation validate.php fourni par observium, qui vous permettra de résoudre les différents soucis
de configuration. Les soucis renocntrés entre autres en utilisant validate.php : 

root@pc11:/opt/observium# php validate.php 
[FAIL]    $config['install_dir'] is not set correctly.  It should probably be set to: /opt/observium

Corriger en décommentant la ligne contenant 'install_dir' et en remplaçant "/opt/librenms"; par "/opt/observium";
ensuite installer les paquets manquants demandé par validate.php

# apt-get install php5-curl
# apt-get install git
# apt-get install php5-mcrypt php-net-ipv4 php-net-ipv6 
# php5enmod mcrypt

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# cd /opt/observium
# php ./includes/sql-schema/update.php
# mkdir rrd
# chown www-data:www-data rrd
# mkdir logs
# chown www-data logs
# useradd observium -d /opt/observium 
# adduser observium www-data
# chown -R observium:www-data /opt/observium
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Créeons un utilisateur Observium, appelé "admin" avec les privilèges d'ajout/modification/suppression d'enregistrements via l'interface web :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# ./adduser.php admin <CLASS_PASSWORD> 10
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

## 2. Configuronts le site virtuel pour Observium 

Assurez vous que le nom de domaine "observiumX.ws.nsrc.org" fonctionne, X représente le numéro de votre machine virtuelle.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# ping observiumX.ws.nsrc.org
PING observiumX.ws.nsrc.org (10.10.9.34) 56(84) bytes of data.
64 bytes from pcX.ws.nsrc.org (10.10.9.34): icmp_req=1 ttl=64 time=0.014 ms
64 bytes from pcX.ws.nsrc.org (10.10.9.34): icmp_req=2 ttl=64 time=0.059 ms
^C
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

(Cela ne fonctionnera que si le DNS de votre classe intégre les noms de domaine associés à votre site virtuel Observium).

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# cd /etc/apache2/sites-available
# editor observium.conf
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Ajoutez les lignes suivantes :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<VirtualHost *:80>
    ServerAdmin sysadm@pcX.ws.nsrc.org
    DocumentRoot /opt/observium/html
    ServerName  observiumX.ws.nsrc.org
    <FilesMatch \.php$>
      SetHandler application/x-httpd-php
    </FilesMatch>
    <Directory />
            Options FollowSymLinks
            AllowOverride None
    </Directory>
    <Directory /opt/observium/html/>
            DirectoryIndex index.php
            Options Indexes FollowSymLinks MultiViews
            AllowOverride All
            Require all granted
    </Directory>
    ErrorLog  ${APACHE_LOG_DIR}/observium-error.log
    LogLevel warn
    CustomLog  ${APACHE_LOG_DIR}/observium-access.log combined
    ServerSignature On
</VirtualHost>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Trouvez la ligne suivante

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ServerName observiumX.ws.nsrc.org
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
... et remplacez "X" par le numéro de votre machine virtuelle.

Enregistrez le fichier et quittez.

# 2. Activez votre site virtuel

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# a2enmod rewrite
# a2ensite observium
# service apache2 restart
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Retournons en mode utilisateur simple 'sysadm' :
créer utilisateur observium 
ajout utilisateur observium dans le groupe www-data
Modif config.php 

Modif install_dir ---> /opt/observium 

Vérification via php validate.php 
Changement des permission sur le dossier /opt/observium 

Création de l'utilisateur qui se connectera à observium 
Installer php5-netipv4 ????

génération de la base de données 


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# exit
$
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Observium est maintenant installé et configuré sur votre machine virtuelle.
Dans le prochain lab, nous allons : 

* Accéder à Observim via le navigateur web
* Configurer Observium pour la dévouverte automatique des équipements
* Ajouter les équipements manuellement via l'interface web
* Ajouter plusieurs utilisateurs en ligne de commandeU
* Automatiser la découverte et la mise à jour des processus des équipements
* Mettre à jour votre routeur avec les contacts et les informations géographiques
* Mettre à jour l'emplacement de votre carte Observium
* Désactiver certains ports d'un équipement
* Utiliser l'interface de Observium pour chercher des informations précises