Installation
Info |
---|
title | Info version | Version information |
---|
|
The L'outil de monitoring bm-tick est disponible à partir de monitoring tool is available from BlueMind 3.5.9. Afin de vous prémunir d'éventuels conflits de version, assurez-vous de mettre à jour votre BlueMind avant de procéder à l'installation des paquets bm-tick. |
Sur l'installation BlueMind
Sur le serveur principal
To avoid possible version conflicts, make sure you update BlueMind before you install bm-tick packages. |
On the BlueMind install
On the main server
Log into the BlueMind host server as root and install the required packages (main module and monitoring plugins if the Monitoring Console isn't already installed), and accept the installation of additional packagesSe 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 :
Bloc de code |
---|
root@mail:~# aptitude install bm-tick-full bm-plugin-admin-console-monitoring bm-plugin-node-monitoring bm-plugin-core-monitoring
LesThe NOUVEAUXfollowing paquetsNEW suivantspackages vontwill êtrebe installés installed:
bm-chronograf{a} bm-influxdb{a} bm-kapacitor{a} bm-metrics-agent{a} bm-telegraf{plugin-admin-console-monitoring bm-plugin-core-monitoring bm-plugin-node-monitoring bm-telegraf{a} bm-tick-full bm-tick-node{a}
0 paquets mis à jourpackages upgraded, 710 nouvellementnewly installésinstalled, 0 àto enleverremove etand 079 non mis à journot upgraded.
IlNeed estto nécessaireget de87.7 téléchargerMB 85,7 Mo d'of archives. Après dépaquetage, 298 Mo seront utilisés.
Voulez-vous continuer After unpacking 301 MB will be used.
Do you want to continue? [Y/n/?] Y
... |
Redémarrer BlueMind une fois l'installation terminée Restart BlueMind once the installation is complete:
Bloc de code |
---|
bmctl restart |
- 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
- Activer le rôle « Base de métriques (influxdb) » :
Image Removed - Enregistrer
- Log into the admin console as superuser admin0 (or delegated administrator with the privileges required) and go to System management > Application's servers > select the server > Server roles tab
- Enable the role "metrics database":
Image Added - Save
Restart Redémarrer BlueMind:
Bloc de code |
---|
bmctl restart |
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 Run a first generation of the alerts' and the dashboards' default configuration. To do this, still logged in as root on the server, run the following command:
Bloc de code |
---|
curl# bm-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.
Astuce |
---|
title | 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 : Bloc de code |
---|
# bm-cli tick reconfigure |
|
Sur les 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. :
Note: if you want to add other servers for monitoring (see next paragraph), you don't need to run this command at this stage. You can just run it once at the end of the procedure, although running it several times doesn't interfere as it only applies to the default configuration and does not affect the data.
Astuce |
---|
When the bm-cli command line client is not installed, you can run the following command to roll out the configuration automatically on all nodes: Bloc de code |
---|
curl -H "X-Bm-ApiKey: $(cat /etc/bm/bm-core.tok)" -XPOST http://localhost:8090/internal-api/tick/mgmt/_reconfigure |
|
Reload the Nginx service:
Bloc de code |
---|
systemctl reload bm-nginx |
Note: this command has no impact on users, you can run it without risking a service break.
On other servers
If the domain has other servers (e.g. edge server or archive server), the node and its plugin must be installed on each:
Log in as root on each server and install the bm-tick packagesse connecter root sur chacune des machines et installer les paquets :
Bloc de code |
---|
root@edge:~# aptitude install bm-tick-node bm-plugin-node-monitoring |
Restart the service on every server:
Bloc de code |
---|
bmctl restart |
Regenerate the configuration: log into the main server as root and run the same command as during the first installationRedémarrer le service sur chacun des serveur :
Bloc de code |
---|
bmctl restart |
Régénérer la configuration : se connecter root au serveur principal et lancer la commande telle que lors de l'installation initiale # bm-cli tick reconfigure |
Astuce |
---|
When the bm-cli command line client is not installed, you can run the following command to roll out the configuration automatically on all nodes: Bloc de code |
---|
root@mail:~# curl -H "X-Bm-ApiKey: $(cat /etc/bm/bm-core.tok)" | -XPOST http://localhost:8090/internal-api/tick/mgmt/_reconfigure |
Astuce |
---|
title | 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 : Bloc de code |
---|
# bm-cli tick reconfigure |
|
Sur un serveur dédié
Pour installer bm-tick sur un serveur qui lui est dédié, les paquets sont à installer selon la distribution suivante :
Sur le serveur dédié au monitoring
-XPOST http://localhost:8090/internal-api/tick/mgmt/_reconfigure |
|
Reload the Nginx service:
Bloc de code |
---|
systemctl reload bm-nginx |
Note: this command has no impact on users, you can run it without risking a service break.
On a dedicated server
To install bm-tick on a dedicated server, the packages must be installed according to the following distribution:
On the monitoring server
The main bm-tick packageLes paquets bm-tick principaux :
Bloc de code |
---|
# aptitude install bm-tick-full bm-plugin-node-monitoring |
Sur le serveur BlueMind principal
On the main BlueMind server
The connection node and its dedicated pluginLe nœud de connexion et son plugin dédié :
Bloc de code |
---|
# aptitude install bm-tick-node bm-plugin-node-monitoring bm-plugin-core-monitoring bm-plugin-admin-console-monitoring |
Puis redémarrer le Then restart the service:
Bloc de code |
---|
# bmctl restart |
Se connecter à la console d'administration de BlueMind :
- se rendre dans la gestion des serveurs : Gestion du système > Serveurs de l'application
- ajouter un nouveau serveur pointant sur l'IP de votre serveur dédié à bm-tick
Et enfin, suivre les instructions données au paragraphe précédent : activer le rôle sur le nouveau serveur, redémarrer BlueMind (sur le serveur principal) une nouvelle fois, générer la configuration par curl ou bm-cli
Sur les autres serveurs
Suivre les instructions du paragraphe 2.1.b ci-dessus :
- installation des paquets
- redémarrage du service
- régénération de la configuration, par curl ou bm-cli
Configuration Nginx
Log into the BlueMind admin console:
- go to the server management page: System management > Application's servers
- add a new server pointing to the bm-tick-dedicated server's IP
Finally, follow the instructions as outlined in the previous paragraph: enable the role on the new server, restart BlueMind (on the main server) again, generate the configuration via curl or bm-cli.
On other servers
Follow the instructions outlined in paragraph 2.1.b above:
- install packages
- restart service
- configure regeneration, via curl or bm-cli
Nginx configuration
Finally, to make the url available in BlueMind links, you need to edit the nginx configuration in the file Enfin, pour rendre l'url accessible depuis les liens BlueMind, modifier la configuration nginx dans le fichier /etc/nginx/bm-local.d
en rajoutant by adding:
Bloc de code |
---|
location /tick/ {
gzip on;
gzip_min_length 1000;
gzip_proxied any;
gzip_types text/plain application/xml text/css text/javascript text/json application/json;
gzip_disable "MSIE [1-6]\.";
gzip_comp_level 9;
proxy_http_version 1.1;
proxy_pass http://<IP<DEDICATED.DUSERVER.SERVEUR.DÉDIÉ>IP>:8888/tick/;
} |
Accéder à l'Accessing the application
Une fois l'installation correctement effectuée, vous pouvez accéder à l'application en vous connectant à l'url Once the installation is complete, you can access the application by logging into https://<votre <your bluemind>.tld/tick
Astuce |
---|
L'identifiant et le mot de passe qui vous sont demandés sont ceux de l'assistant d'installation qui vous ont été fournis lors de l'installation de Bluemind et qui sont configurable dans l'administration de BlueMind. Si vous les avez perdus, vous pouvez consulter la FAQ à ce sujet : J'ai perdu le mot de passe de l'assistant d'installation |
The username and password requested are those for the setup wizard you were provided when you installed BlueMind, which you can configure in BlueMind's administration page. If you've lost your log in credentials, please refer to our FAQ on this issue: I have lost my password for the setup wizard |
From À partir de BlueMind 3.5.10 l'accès à l'application est simplifié et soumis à un rôle :
Affecter le rôle "Monitoring Console" aux personnes souhaitées (via la gestion de chaque utilisateur ou via un groupe), accessing the application is more straightforward but requires a role to be assigned:
- Assign the "Monitoring Console" role to the people you want (through each user's management page or through a group)
- These users then have a "Dashboards" link in their ribbon menu giving them access to the console (this may require them to log in again):
Image Added
Info |
---|
title | Known issue: error 404 |
---|
|
If you have an error 404 when accessing the application, you have to reload Nginx: Bloc de code |
---|
systemctl reload bm-nginx |
|
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 :Image Removed