Installation

Serveur principal

1. Se connecter root sur la machine hébergeant BlueMind et installer les paquets nécessaires (module principal et plugins de monitoring si la Console de monitoring n'est pas déjà installée), en acceptant l'installation des paquets additionnels :

   root@mail:~# aptitude install bm-tick-full bm-plugin-admin-console-monitoring bm-plugin-node-monitoring bm-plugin-core-monitoring
   Les NOUVEAUX paquets suivants vont être installés :
     bm-chronograf{a} bm-influxdb{a} bm-kapacitor{a} bm-metrics-agent{a} bm-telegraf{a} bm-tick-full bm-tick-node{a} 
   0 paquets mis à jour, 7 nouvellement installés, 0 à enlever et 0 non mis à jour.
   Il est nécessaire de télécharger 85,7 Mo d'archives. Après dépaquetage, 298 Mo seront utilisés.
   Voulez-vous continuer ? [Y/n/?] Y
   ...

   Redémarrer BlueMind une fois l'installation terminée :

   bmctl restart

2. Se connecter à la console d'administration en tant que superutilisateur admin0 (ou administrateur délégué ayant les droits nécessaires) et se rendre dans Gestion du système > Serveurs de l'application > sélectionner le serveur > onglet Rôles du serveur
3. Activer le rôle « Base de métriques (influxdb) » :
   
4. Enregistrer

5. Redémarrer BlueMind :

   bmctl restart

6. Lancer une génération initiale des alertes et tableaux de bord par défaut de l'application. Pour cela, toujours connecté root à la machine, lancer la commande suivante :

   curl -H "X-Bm-ApiKey: $(cat /etc/bm/bm-core.tok)" -XPOST http://localhost:8090/internal-api/tick/mgmt/_reconfigure

   NB : si vous souhaitez connecter d'autres serveur à la surveillance (voir paragraphe suivant), cette commande n'est pas nécessaire à cette étape, elle pourra être faite une seule fois en fin de procédure. Cependant, il n'est pas gênant de relancer plusieurs fois la commande car celle-ci ne concerne que la configuration par défaut et ne touche pas aux données.

Autres serveurs

Si le domaine comporte d'autres serveurs (serveur edge ou d'archivage par exemple), le nœud et son plugin doivent être installés sur chacun d'eux. :

1. se connecter root sur chacune des machines et installer les paquets :

   root@edge:~# aptitude install aptitude install bm-tick-node bm-plugin-node-monitoring

2. Redémarrer le service sur chacun des serveur :

   bmctl restart

3. Régénérer la configuration : se connecter root au serveur principal et lancer la commande telle que lors de l'installation initiale :

   root@mail:~# curl -H "X-Bm-ApiKey: $(cat /etc/bm/bm-core.tok)" -XPOST http://localhost:8090/internal-api/tick/mgmt/_reconfigure

   Configuration automatique simplifiée

   Lorsque le client de lignes de commandes bm-cli est installé, vous pouvez lancer la commande suivante à la place de la commande curl ci-dessus afin de déployer automatiquement la configuration sur l'ensemble des nœuds :

   # bm-cli tick reconfigure

Accéder à l'application

Une fois l'installation correctement effectuée, vous pouvez accéder à l'application en vous connectant à l'url https://<votre bluemind>.tld/tick

À partir de BlueMind 3.5.10 l'accès à l'application est simplifié et soumis à un rôle :

• Affecter le rôle "Console de monitoring" aux personnes souhaitées (via la gestion de chaque utilisateur ou via un groupe)
• Les personnes ont dès lors (une reconnexion peut être nécessaire) un lien "Supervision" dans le bandeau leur permettant d'accéder à la console :