| 1 | % Observium |
|---|
| 2 | % |
|---|
| 3 | % Installation |
|---|
| 4 | |
|---|
| 5 | # Introduction |
|---|
| 6 | |
|---|
| 7 | ## Objectifs |
|---|
| 8 | |
|---|
| 9 | * Apprendre à installer observium |
|---|
| 10 | |
|---|
| 11 | ## Notes |
|---|
| 12 | |
|---|
| 13 | * 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 |
|---|
| 14 | * Les commandes précédées du symbole "#" doivent être exécutées en tant que root |
|---|
| 15 | * Certaines commandes seront éxécutées en mode CLI d'un équipement ou service (e.g. "rtrX>" or "mysql>") |
|---|
| 16 | |
|---|
| 17 | # Installation de Observium |
|---|
| 18 | |
|---|
| 19 | ## 1. Installation basé on offical instructions |
|---|
| 20 | |
|---|
| 21 | 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' |
|---|
| 22 | |
|---|
| 23 | Source : |
|---|
| 24 | |
|---|
| 25 | http://www.observium.org/wiki/Debian_Ubuntu_Installation |
|---|
| 26 | |
|---|
| 27 | 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/ |
|---|
| 28 | |
|---|
| 29 | Nous ferons l'installation avec le compte root. Accédez à votre machine virtuelle avec l'utilisateur sysadm et exécutez les commandes ci-dessous : |
|---|
| 30 | |
|---|
| 31 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 32 | $ sudo -s |
|---|
| 33 | # apt-get update |
|---|
| 34 | # apt-get install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-snmp php-pear snmp graphviz \ |
|---|
| 35 | php5-mcrypt php5-json subversion mysql-server mysql-client rrdtool fping \ |
|---|
| 36 | imagemagick whois mtr-tiny nmap ipmitool python-mysqldb |
|---|
| 37 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 38 | |
|---|
| 39 | Cela prendra quelques minutes. |
|---|
| 40 | |
|---|
| 41 | 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. |
|---|
| 42 | |
|---|
| 43 | Une fois que l'installation sera terminée, exécutez les commandes ci-après: |
|---|
| 44 | |
|---|
| 45 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 46 | # mkdir -p /opt/observium && cd /opt |
|---|
| 47 | # wget http://noc.ws.nsrc.org/downloads/observium/observium-community-latest.tar.gz |
|---|
| 48 | # tar zxvf observium-community-latest.tar.gz |
|---|
| 49 | # cd observium |
|---|
| 50 | # cp config.php.default config.php |
|---|
| 51 | # editor config.php |
|---|
| 52 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 53 | |
|---|
| 54 | Trouvez ces deux lignes: |
|---|
| 55 | |
|---|
| 56 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 57 | $config['db_user'] = 'USERNAME'; |
|---|
| 58 | $config['db_pass'] = 'PASSWORD'; |
|---|
| 59 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 60 | |
|---|
| 61 | et remplacez les par : |
|---|
| 62 | |
|---|
| 63 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 64 | $config['db_user'] = 'observium'; |
|---|
| 65 | $config['db_pass'] = 'nsrc+ws'; |
|---|
| 66 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 67 | |
|---|
| 68 | Sauvegardez et quittez le fichier. |
|---|
| 69 | |
|---|
| 70 | 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. |
|---|
| 71 | Le mot de passe de l'utilisateur root pour accéder à mysql devrait être le mot de passe de la classe. |
|---|
| 72 | |
|---|
| 73 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 74 | # mysql -u root -p <mysql root password> |
|---|
| 75 | mysql> CREATE DATABASE observium; |
|---|
| 76 | mysql> GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost' IDENTIFIED BY '<observium db password>'; |
|---|
| 77 | mysql> exit |
|---|
| 78 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 79 | |
|---|
| 80 | Nous allons alimenter la base de données et créer un ensemble de répertoires : |
|---|
| 81 | |
|---|
| 82 | Mais avant vous pouvez utiliser le script de validation validate.php fourni par observium, qui vous permettra de résoudre les différents soucis |
|---|
| 83 | de configuration. Les soucis renocntrés entre autres en utilisant validate.php : |
|---|
| 84 | |
|---|
| 85 | root@pc11:/opt/observium# php validate.php |
|---|
| 86 | [FAIL] $config['install_dir'] is not set correctly. It should probably be set to: /opt/observium |
|---|
| 87 | |
|---|
| 88 | Corriger en décommentant la ligne contenant 'install_dir' et en remplaçant "/opt/librenms"; par "/opt/observium"; |
|---|
| 89 | ensuite installer les paquets manquants demandé par validate.php |
|---|
| 90 | |
|---|
| 91 | # apt-get install php5-curl |
|---|
| 92 | # apt-get install git |
|---|
| 93 | # apt-get install php5-mcrypt php-net-ipv4 php-net-ipv6 |
|---|
| 94 | # php5enmod mcrypt |
|---|
| 95 | |
|---|
| 96 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 97 | # cd /opt/observium |
|---|
| 98 | # php ./includes/sql-schema/update.php |
|---|
| 99 | # mkdir rrd |
|---|
| 100 | # chown www-data:www-data rrd |
|---|
| 101 | # mkdir logs |
|---|
| 102 | # chown www-data logs |
|---|
| 103 | # useradd observium -d /opt/observium |
|---|
| 104 | # adduser observium www-data |
|---|
| 105 | # chown -R observium:www-data /opt/observium |
|---|
| 106 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 107 | |
|---|
| 108 | Créeons un utilisateur Observium, appelé "admin" avec les privilèges d'ajout/modification/suppression d'enregistrements via l'interface web : |
|---|
| 109 | |
|---|
| 110 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 111 | # ./adduser.php admin <CLASS_PASSWORD> 10 |
|---|
| 112 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 113 | |
|---|
| 114 | ## 2. Configuronts le site virtuel pour Observium |
|---|
| 115 | |
|---|
| 116 | Assurez vous que le nom de domaine "observiumX.ws.nsrc.org" fonctionne, X représente le numéro de votre machine virtuelle. |
|---|
| 117 | |
|---|
| 118 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 119 | # ping observiumX.ws.nsrc.org |
|---|
| 120 | PING observiumX.ws.nsrc.org (10.10.9.34) 56(84) bytes of data. |
|---|
| 121 | 64 bytes from pcX.ws.nsrc.org (10.10.9.34): icmp_req=1 ttl=64 time=0.014 ms |
|---|
| 122 | 64 bytes from pcX.ws.nsrc.org (10.10.9.34): icmp_req=2 ttl=64 time=0.059 ms |
|---|
| 123 | ^C |
|---|
| 124 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 125 | |
|---|
| 126 | (Cela ne fonctionnera que si le DNS de votre classe intégre les noms de domaine associés à votre site virtuel Observium). |
|---|
| 127 | |
|---|
| 128 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 129 | # cd /etc/apache2/sites-available |
|---|
| 130 | # editor observium.conf |
|---|
| 131 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 132 | |
|---|
| 133 | Ajoutez les lignes suivantes : |
|---|
| 134 | |
|---|
| 135 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 136 | <VirtualHost *:80> |
|---|
| 137 | ServerAdmin sysadm@pcX.ws.nsrc.org |
|---|
| 138 | DocumentRoot /opt/observium/html |
|---|
| 139 | ServerName observiumX.ws.nsrc.org |
|---|
| 140 | <FilesMatch \.php$> |
|---|
| 141 | SetHandler application/x-httpd-php |
|---|
| 142 | </FilesMatch> |
|---|
| 143 | <Directory /> |
|---|
| 144 | Options FollowSymLinks |
|---|
| 145 | AllowOverride None |
|---|
| 146 | </Directory> |
|---|
| 147 | <Directory /opt/observium/html/> |
|---|
| 148 | DirectoryIndex index.php |
|---|
| 149 | Options Indexes FollowSymLinks MultiViews |
|---|
| 150 | AllowOverride All |
|---|
| 151 | Require all granted |
|---|
| 152 | </Directory> |
|---|
| 153 | ErrorLog ${APACHE_LOG_DIR}/observium-error.log |
|---|
| 154 | LogLevel warn |
|---|
| 155 | CustomLog ${APACHE_LOG_DIR}/observium-access.log combined |
|---|
| 156 | ServerSignature On |
|---|
| 157 | </VirtualHost> |
|---|
| 158 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 159 | |
|---|
| 160 | Trouvez la ligne suivante |
|---|
| 161 | |
|---|
| 162 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 163 | ServerName observiumX.ws.nsrc.org |
|---|
| 164 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 165 | |
|---|
| 166 | ... et remplacez "X" par le numéro de votre machine virtuelle. |
|---|
| 167 | |
|---|
| 168 | Enregistrez le fichier et quittez. |
|---|
| 169 | |
|---|
| 170 | # 2. Activez votre site virtuel |
|---|
| 171 | |
|---|
| 172 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 173 | # a2enmod rewrite |
|---|
| 174 | # a2ensite observium |
|---|
| 175 | # service apache2 restart |
|---|
| 176 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 177 | |
|---|
| 178 | Retournons en mode utilisateur simple 'sysadm' : |
|---|
| 179 | créer utilisateur observium |
|---|
| 180 | ajout utilisateur observium dans le groupe www-data |
|---|
| 181 | Modif config.php |
|---|
| 182 | |
|---|
| 183 | Modif install_dir ---> /opt/observium |
|---|
| 184 | |
|---|
| 185 | Vérification via php validate.php |
|---|
| 186 | Changement des permission sur le dossier /opt/observium |
|---|
| 187 | |
|---|
| 188 | Création de l'utilisateur qui se connectera à observium |
|---|
| 189 | Installer php5-netipv4 ???? |
|---|
| 190 | |
|---|
| 191 | génération de la base de données |
|---|
| 192 | |
|---|
| 193 | |
|---|
| 194 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 195 | # exit |
|---|
| 196 | $ |
|---|
| 197 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 198 | |
|---|
| 199 | Observium est maintenant installé et configuré sur votre machine virtuelle. |
|---|
| 200 | Dans le prochain lab, nous allons : |
|---|
| 201 | |
|---|
| 202 | * Accéder à Observim via le navigateur web |
|---|
| 203 | * Configurer Observium pour la dévouverte automatique des équipements |
|---|
| 204 | * Ajouter les équipements manuellement via l'interface web |
|---|
| 205 | * Ajouter plusieurs utilisateurs en ligne de commandeU |
|---|
| 206 | * Automatiser la découverte et la mise à jour des processus des équipements |
|---|
| 207 | * Mettre à jour votre routeur avec les contacts et les informations géographiques |
|---|
| 208 | * Mettre à jour l'emplacement de votre carte Observium |
|---|
| 209 | * Désactiver certains ports d'un équipement |
|---|
| 210 | * Utiliser l'interface de Observium pour chercher des informations précises |
|---|