Page tree

This page has not yet been translated to English.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DA and version BM-3.5
Sv translation
languagefr

Supervision du serveur

Au niveau serveur, il est conseillé de superviser les aspects suivants de la machine :

  • occupation des disques
  • utilisation de la mémoire RAM
  • utilisation des CPU
Note
titleImportant
En cas de panne grave d'un composant BlueMind, un fichier .hprof est généré dans le répertoire/var/log.

Il est donc primordial de pouvoir superviser l'apparition de tels fichiers.

Par défaut l'apparition d'un tel fichier est détecté par le système BlueMind et est enregistré sous forme d'erreur dans le fichier /var/log/bm-node/node.log.

Panel

Sur cette page :

Table of Contents
maxLevel2

En rapport :

 

Une commande pour réaliser manuellement cela peut être :

Code Block
ls /var/log/*.hprof

Un tel fichier est nommé sous la forme suivante :

java_pid1664.hprof

1664 est l'identifiant du processus ayant subi la panne. A partir de cet identifiant il est possible via les commandes ps ou jps de récupérer le composant responsable de la panne avant de redémarrer les services BlueMind.

Supervision des services

BlueMind utilise des composants standards de messagerie (Cyrus Imap, Postfix, nginx, tomcat...), qui peuvent être supervisés par des outils standards.

De plus, les API permettent d'interroger le serveur de la même façon que les interfaces, permettant ainsi de s'assurer du bon fonctionnement du composant BM-Core.

La liste des processus BlueMind en cours de fonctionnement sur le serveur est accessible via la commande :

Code Block
/usr/lib/jvm/bm-jdk/bin/jps -ml

En temps normal, les processus purement BlueMind attendus et que l'on peut superviser sont :

  • net.bluemind.eas.push

  • org.elasticsearch.bootstrap.Elasticsearch start -p /var/run/bm-elasticsearch.pid

  • net.bluemind.xmpp.server.launcher.tigase

  • net.bluemind.ips.vertx.ips

  • net.bluemind.lmtp.id1

  • net.bluemind.ysnp.ysnp

  • net.bluemind.application.launcher.coreLauncher

  • net.bluemind.hornetq.mqsrv

  • net.bluemind.webmodules.launcher.webLauncher

  • net.bluemind.locator.app

  • net.bluemind.node.server.nodelauncher

  • net.bluemind.tika.server.tika

  • net.bluemind.proxy.http.launcher.hpslauncher

Parmi les composants standards utilisés par BlueMind on trouve également :

  • postgresql
  • postfix
  • nginx
  • bm-php-fpm
  • cyrus (imapd et pop3d)

Utilisation de SNMP

BlueMind ne fournit pas de sondes SNMP. Pour pouvoir superviser un serveur BlueMind via SNMP, il est donc nécessaire de mettre en place manuellement la supervision de chaque service précédemment cité.

Scripts de supervision BlueMind

Afin de pouvoir superviser les services BlueMind, le paquet bm-checks doit être installé.

Une fois le paquet installé, des scripts de supervisions sont alors disponibles dans le répertoire /usr/share/bm-checks/.

Pour les utiliser, lancer l'exécution de ces scripts bash de manière régulière, avec un cron par exemple.

Chaque script renvoie un code de retour dépendant du status du service BlueMind :

  • 0 (zéro) si le service est fonctionnel
  • 1 (un) si une erreur a été détectée

En cas d'erreur, un message est renvoyé sur la sortie standard.

Supervision des logs

Les fichiers journaux des composants BlueMind sont récupérables dans le répertoire /var/log :

  • /var/log/bm/
  • /var/log/bm-eas/
  • /var/log/bm-elasticsearch/
  • /var/log/bm-hps/
  • /var/log/bm-ips/
  • /var/log/bm-lmtpd/
  • /var/log/bm-locator/
  • /var/log/bm-mq/
  • /var/log/bm-node/
  • /var/log/bm-tika/
  • /var/log/bm-webserver/
  • /var/log/bm-webmail/
  • /var/log/bm-xmpp/
  • /var/log/bm-ysnp/

Pour les autres composants qu'il est possible de superviser, les emplacements suivants peuvent être utilisés :

  • /var/log/mail.err
  • /var/log/mail.info
  • /var/log/mail.log
  • /var/log/mail.warn
  • /var/log/nginx/
  • /var/log/bm-php5-fpm.log
  • /var/log/postgresql/

Pilotage par script

BlueMind utilise des scripts système standards pour l'arrêt et le démarrage des services.

Ainsi, la commande :

bmctl restart relance l'ensemble des services BlueMind.

Réalisation d'opérations par script

Comme indiqué dans les sections relatives à l'intégration avec des applications tierces, BlueMind peut être totalement piloté par script.

A partir des API clientes (en PHP et Java), il est possible de réaliser n'importe quelle opération sur BlueMind, en particulier créer ou modifier un utilisateur, accéder à un agenda, ajouter un événement...

Enregistrer

Enregistrer

Sv translation
languageen

Server monitoring

We recommend that you monitor the following aspects of the server:

  • disk space usage
  • RAM usage
  • CPU usage
Note
titleImportant
In the event of a major BlueMind component failure, a file ".hprof" is generated in the directory "/var/log".

Monitoring file activity for such files appearing is therefore crucial.

By default, the BlueMind system detects such files when they are generated and records this as an error in the file "/var/log/bm-node/node.log" .

Panel

On this page:

Table of Contents
maxLevel2

Related:

 

You can perform this operation manually using a command such as:

Code Block
ls /var/log/*.hprof

Such a file is named according to this convention:

java_pid1664.hprof

 In this example, "1664" is the ID of the process with the failure. This ID enables you to retrieve the component that causes the failure by using the command "ps" or "jps" before restarting BlueMind services. 

Service monitoring

BlueMind uses standard messaging components (Cyrus Imap, Postfix, nginx, tomcat...) that can be monitored by standard tools.

In addition, APIs allow you to query the server the same way as interfaces and make sure that the BM-Core component runs properly.

The list of BlueMind processes running on the server can be accessed using the command:

Code Block
/usr/lib/jvm/bm-jdk/bin/jps -ml

Typically, BlueMind-specific processes you can expect to see and are able to monitor are:

  • net.bluemind.eas.push

  • org.elasticsearch.bootstrap.Elasticsearch start -p /var/run/bm-elasticsearch.pid

  • net.bluemind.xmpp.server.launcher.tigase

  • net.bluemind.ips.vertx.ips

  • net.bluemind.lmtp.id1

  • net.bluemind.ysnp.ysnp

  • net.bluemind.application.launcher.coreLauncher

  • net.bluemind.hornetq.mqsrv

  • net.bluemind.webmodules.launcher.webLauncher

  • net.bluemind.locator.app

  • net.bluemind.node.server.nodelauncher

  • net.bluemind.tika.server.tika

  • net.bluemind.proxy.http.launcher.hpslauncher

The standard processes BlueMind uses include:

  • postgresql
  • postfix
  • nginx
  • php-fpm
  • cyrus (imapd et pop3d)

Using SNMP

BlueMind does not provide SNMP probes. In order to monitor a BlueMind server with SNMP, you must therefore set up monitoring for each service mentioned above manually.

BlueMind's monitoring scripts

To be able to monitor BlueMind services, the package bm-checks must be installed.

Once the package is installed, monitoring scripts become available in the directory /usr/share/bm-checks/.

To use them, run the script bash as you would normally, using cron for instance.

Each script returns a code depending on the status of the BlueMind service:

  • 0 (zero) if the service is running properly
  • 1 (one) if an error has been detected

If an error is detected, a message is returned on the standard output.

Log monitoring

The BlueMind components log files can be retrieved in the directory "/var/log":

  • /var/log/bm/
  • /var/log/bm-backoffice/
  • /var/log/bm-dav/
  • /var/log/bm-eas/
  • /var/log/bm-elasticsearch/
  • /var/log/bm-hps/
  • /var/log/bm-ips/
  • /var/log/bm-kb/
  • /var/log/bm-lmtpd/
  • /var/log/bm-locator/
  • /var/log/bm-mq/
  • /var/log/bm-node/
  • /var/log/bm-tika/
  • /var/log/bm-tomcat/
  • /var/log/bm-webmail/
  • /var/log/bm-xmpp/
  • /var/log/ysnp/

To monitor other components the following locations can be used:

  • /var/log/mail.err
  • /var/log/mail.info
  • /var/log/mail.log
  • /var/log/mail.warn
  • /var/log/nginx/
  • /var/log/php5-fpm.log
  • /var/log/postgresql/

Script-based control

BlueMind uses standard system scripts to start and stop services.

The command:

bmctl restart restarts all BlueMind services.

Script-based operations

As mentioned in the sections on integrating BlueMind with third-party applications, BlueMind can be fully script-controlled.

From client APIs (in PHP and Java), you can perform any operation on BlueMind, such as create or modify users, access calendars, add events, etc. 

Enregistrer