Agenda: observium-lab-1-vFR.txt

% Observium - Lab

# Introduction

## Objectifs

* Acquerir de l'expérience avec Observium

## Notes

# 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>") 


# Observium lab

Tous les composants pour Observieur sont déja installés - c'est à vous de configurer les services, d'ajouter les hôtes ...
Si ce n'est pas le cas, référez vous au lab "Observium_partie1.txt". Suivez les instructions de ce premier lab pour finaliser l'installation.

Accédeez à votre machine virtuelle avec le compte sysadm puis suivez les instructions ci-dessous :

# 1. Accédez à Observium!

Vous avez déjà créé un utilisateur (dans le lab d'installation). Il s'agit de l'utilisateur 'admin' avec comme mot de passe celui de la classe.

http://observiumX.ws.nsrc.org/ 

Remplacez X par le numéro de votre machine virtuelle

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    User:      admin
    Password:  mot de passe de la classe
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Vous devriez être connecté à Observium. Aucun équipement ne devrait être configuré. 
Prenez le temps de regarder l'interface quelques minutes.s.

# 2. Editez le fichier de configuration d'Observium, pour lui fournir des informations sur notre réseau :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ sudo editor /opt/observium/config.php
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Faites les changements ci-dessous :

Trouvez la ligne
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$config['snmp']['community'] = array("public");
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

... et remplacez 'public' par 'NetManage' (ni "netmanage" ni "NETMANAGE"); ainsi, elle devrait ressemblez à ça :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$config['snmp']['community'] = array("NetManage");
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Ajoutez également la ligne ci-dessous : 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$config['autodiscovery']['xdp']            = TRUE;
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Enregistrez le fichier et quittez.

# 3. Ajoutez un hôte : votre propre routeur

Dans l'interface web (http://observiumX.ws.nsrc.org), allez dans le menu "Equipement/Device" et cliquez sur "Ajouter Equipement/Add Device"

Hostname: rtrX.ws.nsrc.org
SNMP Version: v2c [valeur par défaut]
SNMP Community: Vous pouvez ne pas le renseigner, si vous l'avez déjà défini dans le fichier de configuration,
                config.php, ou vous pouvez mettre : NetManage

Si tout s'est bien passé, vous devriez voir plusieurs messages de ce type :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Adding host rtrX.ws.nsrc.org community NetManage port 161

Trying v2c community NetManage ...

Device added (id = 1)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Vous pouvez parcourir la vue des équipements et constatez que le routeur a été ajouté :

        http://observiumX.ws.nsrc.org/devices/

... explorez l'interface web quelques minutes - mais aucune donnée n'est encore fournie, 
et si vous cliquez sur l'équipement (rtrX), Observium va signaler que l'équipement n'a pas encore été découvert.

Vous pouvez demander  à Observieum de recueillir les données pour cet hôte en exécutant les commandes suivantes :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ cd /opt/observium
$ sudo ./poller.php -h all
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

... Il est clair que nous n'avns pas envie de le faire manuellement. Nous allons automatiser cette action dans les prochaines étapes.

# 4. Dites à Observieum d'effectuer la découverte (scan) du réseau et de recueillir les données. 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ cd /opt/observium
$ sudo ./discovery.php -h all
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Vous vous rendres compte que beaucoup d'informations vont apparaitre.

Nous lançons de nouveau le recueil de données :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ sudo ./poller.php -h all
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

# 5. Retournez sur l'interface web.

        http://observiumX.ws.nsrc.org/

Que constatez vous ? Comment pensez vous que Observium a trouvé d'autres équipements sur le réseau ? Comment a t il pu les contacter ?

# 6. Automatisez les tâches

Il est temps d'automatiser le recueil de données.

Il est nécessaure d'automatiser certaines tâches : 

Créez le fichier /etc/cron.d/observium:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ sudo editor /etc/cron.d/observium
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

... et copiez/collez y les lignes suivantes :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33  */6   * * *   root    /opt/observium/discovery.php -h all >> /dev/null 2>&1
*/5 *     * * *   root    /opt/observium/discovery.php -h new >> /dev/null 2>&1
*/5 *     * * *   root    /opt/observium/poller-wrapper.py 1 >> /dev/null 2>&1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Les données apparaitrons sur les graphes au bout d'un certains temps.

# 7. En attendant que le traffic apparaissent, nous pouvons naviguer dans l'interface web

Allez sur http://observiumX.ws.nsrc.org/

Cliquez sur "Equipement/Devices" dans le menu du haut.
Trouvez le routeur de votre groupe et cliquez dessus.

Nous allons parcourir la page d'accueil de votre équipement.

Vous constaterez que Observium a automatiquement détecté plusieurs nformations sur votre routeurs.

Dans le haut de la page, sous le nom du routeur, vous verrez une liste de tableaux; chacun d'eux présentent des informations sur votre équipement :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Overview | Graphs | Health | Ports | Inventory | Logs | Alerts
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Sous "Graphes/Graphs", vous verrez toutes les informations qui peuvent être présentées dans un graphe : les E/S réseau, les E/S disques, la mémoire et l'utilisation du CPU, etc...

Vous verrez également une table de "santé/Health", qui présente les métriques sur le fonctionnement de l'équipement - température, voltage, vitesse du ventilateur ...
Notez que certaines de des informations sont également disponible dans la page d'accueil de l'équipement (qui apparait lorsque vous cliquez sur le nom de l'équipement).

Ciquez sur le menu "Ports"; vous y trouvez une synthèse des traffic sur tous les ports, incluant le nombre de bits par seconde, les paquets par seconde, la vitesse et le type de connexion (Ethernet ou non).
Notez que vous pouvez cliquer sur tous les élements de menu, y compris les petites graphes, et vous serez redirigés sur la page correspondante.

La table de routage vous présentera un aperçu des protocoles de routage activés.
si vous activez OSPF et BGP sur votre routeur, vous aurez des informations sur les sessions actives, les voisins et les postes, et d'autres informations spéicfiques au protocole.

L'inventaire contient une liste de modules et de numéros de série des équipements rattachés à votre retour.

Sous le menu "Logs", vous verrez une liste d'évènements sur votre routeur : les changements sur la configuration du routeur, ou sur les états des interfcaes, services ...

Les "Alertes /Alerts" sont pour le moment vide por votre routeur; on pouurra en parler plus tard.

Accéder également à la "Carte/Maps" disponibile sous le menu "Ports".

Cette fonctionnalité  permet d'accéder à  un schéma, généré automatiquement de la topologie de 
votre réseau, suivant le point de vue de votre routeur. C'est la seule fonctionnalité pour les équipements compatibles CDP/LLDP (Cisco, IOS, ...)

        Vous pouvez activer CDP/LLDP sur vos équipements Linux en installant le paquet 'ladvd'
        (sudo apt-get install ladvd). Essayez d'ajouter vos périphériques Linux de cette façon.

Ce ne sera disponible que si vous avez activé 'autodiscovery' 'xdp' comme décrit dans l'étape 2.

# 8. Ajoutez un emplacement géographique et un contact à votre routeur

Si vous accédez à la page d'accueil de votre routeur ('Equipements/Devices' >> 'rtrX'), vous verrez que Observium a récupéré les informations telles sur le matériel, le système d'exploitaton et le fonctionnement de votre équpement.

Connectez vous à votre routeur par SSH et ajoutez les informations ci-dessous à votre configuration SNMP : 

Préciser l'emplacement géographique (Ville, Pays) afin que votre équipement apparaisse sur la carte géographique

Définissez les informations de contact (adresse email ou nom)

POur le faire, tapez les commandes ci-après :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtr8> enable
Password: 
rtr8# conf terminal
Enter configuration commands, one per line.  End with CNTL/Z.
rtr8(config)# snmp-server contact user@email.address
rtr8(config)# snmp-server location Ville, Pays
rtr8(config)# exit
rtr8# write memory
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Vous devez remplacer "Ville, Pays" avec le nom de la ville et celui du pays dans lesquels vous êtes.
Exemple

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Bloomington, Indiana
Thimphu, Bhutan
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

etc...

Si vous patientez quelques minutes (maximum 5), vous devriez voir apparaitre ces informations automatiquement sur la page d'accueil de votre routeur/

Demandes à vos camarades de classe de mettre des Villes/Payx différents pour chacun de leurs routeurs. 
Attendez que Observium analyse de nouveau vos équipements puis consultez la carte géographique sur la page principale de Obervium (http://observiumX.ws.nsrc.org/)

# 9. Ajoutez une description à l'interface

Connectez vous à votre retour et ajoutez une pseudo interface à votre routeur pour vérifier si Observium récupère cette information :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtr8(config)# interface loopback123                    
rtr8(config-if)# description A useless interface
rtr8(config-if)# exit
rtr8(config)# exit
rtr8# write memory
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Cela devrait également apparaitre dans Observium après quelques minutes - trouvez la description sous "Ports"


# 10. Recherche d'adresse IP

Dans la page d'acceuil de Observium,  vous trouverez, dans le menu principal, un sous menu "Recherche" avec 5 options :

- Recherche IPv4  -> http://observiumX.ws.nsrc.org/search/search=ipv4/
- Recherche IPv6 -> http://observiumX.ws.nsrc.org/search/search=ipv6/
- Recherche MAC ->  http://observiumX.ws.nsrc.org/search/search=mac/
- Tables ARP/NDP ->  http://observiumX.ws.nsrc.org/search/search=arp/
- Tables FDB ->  http://observiumX.ws.nsrc.org/search/search=fdb/

En utilisant la recherche par IPv4 et par table ARP, essayez de retrouver les équipements suivants :

- IP du routeur principal (10.10.0.254)
- IPs des autres routeurs de la classe (10.10.X.254)
- IPs de certains PC (10.10.1.1, 10.10.5.17, etc...)

Essayez de trouver l'adresse IP de votre ordinateur portable. L'avez vous trouvée ? Pourquoi ?

# 11. Ajoutez un switch

Accédez au sous menu "Ajouter équipement/Add device" du menu "Equipements/Devices"

Saisissez les informations suivantes :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Hostname: sw.ws.nsrc.org
Community: NetManage
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Cliquez sur "Ajouter un hôte/Add Host". Après quelques secondes, il devrait avoir ajouté le switch.
Après quelques minutes, les données du switch apparaitront.

Notez la ligne "Ports" en haut à droite de l'interface de Observium. 

Certains ports sont t il inactifs ? Lesquels? 
    
Cliquez sur le message 'X down' en bas pour voir quels sont les ports inactifs et sur quels équipements. 


# 12. Désactivons les ports non utilisés

Accédez à la page d'accueil de votre switch "sw.ws.nsrc.org".

Cliquez sur l'icône représentant la clé (en haut à droite) pour configurer les équipements.
Vous avez ainsi accès à la page de configuration de l'équipement.

Ciquez sur 'Ports', vous aurez un aperçu des statuts des ports du switch.
Pour ceux qui sont inactifs, cliquez sur le bouton "Ignore" puis Sauvergarder (sous "Index").

Si vous rechargez la page d'acceuil :

        http://observiumX.ws.nsrc.org/

... Observium ne devrait plus afficher le message d'inactivité de ces ports!


# 15. Avez vous déjà ajouter votre PC ? Celui d'autres collègues ?

Faites quelques tests :

- A partir du menu principal, cliquez sur "Equipements/Devices -> Tous les équipements/All devices"

- Cliquez sur votre routeur

- En dessous de la synthèse graphique, vous trouverez la liste des interfaces actives sur votre routeur :

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        Fa0/0, Fa0/1, Null0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Cliquez sur Fa0/0

- Cliquez sur "Temps réel/Real Time"

# 16. Configuration des régions sur la carte

Vous pouvez définir la zone géographique de la carte qui apparait quand vous accédez à Observium.

Référez vous à l'étape 2.

Consultez les paramètres dans cette article :
http://www.observium.org/wiki/Configuration_Options#Map_overview_settings

Le paramètre $config['frontpage']['map']['region'] peut être initialisé à un pays ou une région. 
Pour plus d'informations, consultez la page  https://developers.google.com/chart/interactive/docs/gallery/geochart

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
region: La zone à afficher sur la carte. (Les zones environnantes seront également affichées). Ce paramètre peut prendre une des valeurs suivantes :

        * 'world' - Carte du monde.
        * Un continent ou une sous région continentale, représenté par 3 caractères numériques, ex : '011' pour l'Afrique de l'Ouest.
        * Un pays, représenté par son code ISO 3166-1 alpha-2, ex : 'AU' for Australia.
        * Un états des USA, représenté par son code ISO 3166-2:US, ex : 'US-AL' pour Alabama - Le paramètre résolution devra être défini à 'provinces' ou 'metros'.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Vous pouvez tester ces options en changeant les paramètres avec des valeurs de votre choix et rechargez la page d'accueil de Observium.