% 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> CREATE DATABASE observium; mysql> GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost' IDENTIFIED BY ''; 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 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 : ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ServerAdmin sysadm@pcX.ws.nsrc.org DocumentRoot /opt/observium/html ServerName observiumX.ws.nsrc.org SetHandler application/x-httpd-php Options FollowSymLinks AllowOverride None DirectoryIndex index.php Options Indexes FollowSymLinks MultiViews AllowOverride All Require all granted ErrorLog ${APACHE_LOG_DIR}/observium-error.log LogLevel warn CustomLog ${APACHE_LOG_DIR}/observium-access.log combined ServerSignature On ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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