Comparaison des versions

Ancienne version 5

changes.mady.by.user Marie Piochon

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Sophie Lepissier

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Sv translation
languagefr
Remarque

Cette page n'est plus actualisée. À partir de BlueMind 4.8, veuillez consulter la nouvelle documentation BlueMind

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
Remarque
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.

Volet

Sur cette page :

Sommaire
maxLevel2

En rapport :


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

Bloc de code
ls /var/log/*.hprof

Un tel fichier est nommé sous la forme suivante :

java_pid1664.hprof

où 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 :

Bloc de code
/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.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-mapi/
  • /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...

Sv translation
languageen
Remarque

This page is no longer being updated. From BlueMind 4.8, please refer to the new BlueMind documentation

Server monitoring

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

  • disk space usage
  • RAM usage
  • CPU usage
Remarque
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" .

Volet

On this page:

Sommaire
maxLevel2

Related:

 


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

Bloc de code
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:

Bloc de code
/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.ipsnet.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
  • bm-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-ipsmapi/
    • /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-tomcatwebserver/
    • /var/log/bm-webmail/
    • /var/log/bm-xmpp/
    • /var/log/bm-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/bm-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. 

    Sv translation
    languagede
    Remarque

    Diese Seite ist nicht mehr aktuell. Ab der Version BlueMind 4.8 finden Sie alle Infos in der neuen Dokumentation

    Server-Überwachung

    Auf der Serverebene ist es ratsam, die folgenden Punkte zu überwachen:

    • Festplatten-Belegung
    • RAM-Auslastung
    • CPU-Auslastung
    Remarque
    titleWichtig
    Im Falle eines schwerwiegenden Fehlers einer BlueMind-Komponente wird eine .hprof-Datei im Verzeichnis /var/log erzeugt.

    Es ist daher unerlässlich, das Erscheinen solcher Dateien überwachen zu können.

    Standardmäßig wird das Erscheinen einer solchen Datei vom BlueMind-System erkannt und als Fehler in der Datei /var/log/bm-node/node.log aufgezeichnet.

    Volet

    Auf dieser Seite:

    Sommaire
    maxLevel2

    Verwandt:


    Zur manuellen Durchführung kann z.B. der folgende Befehl verwendet werden:

    Bloc de code
    ls /var/log/*.hprof

    Eine solche Datei ist wie folgt benannt:

    java_pid1664.hprof

    wobei 1664 den fehlgeschlagenen Prozess identifiziert. Anhand dieser Identifizierung ist es möglich, über ps- oder jps-Befehle die für den Fehler verantwortliche Komponente wiederherzustellen, bevor die BlueMind-Dienste neu gestartet werden.

    Überwachung der Dienste

    BlueMind verwendet Standard-Messaging-Komponenten (Cyrus Imap, Postfix, nginx, tomcat...), die mit Standard-Tools überwacht werden können.

    Darüber hinaus ermöglichen die APIs die Abfrage des Servers in der gleichen Weise wie die Schnittstellen, so dass die Funktionsfähigkeit der BM-Core-Komponente gewährleistet ist.

    Der Zugriff auf die Liste der auf dem Server laufenden BlueMind-Prozesse erfolgt über den folgenden Befehl:

    Bloc de code
    /usr/lib/jvm/bm-jdk/bin/jps -ml

    Unter normalen Umständen sind die rein von BlueMind erwarteten und zu überwachenden Prozesse

    • net.bluemind.eas.push

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

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

    • 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

    Zu den von BlueMind verwendeten Standardkomponenten gehören auch:

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

    Verwendung von SNMP

    BlueMind bietet keine SNMP-Sonden an. Um einen BlueMind-Server über SNMP überwachen zu können, ist es daher notwendig, die Überwachung jedes oben genannten Dienstes manuell einzurichten.

    BlueMind-Überwachungsskripte

    Um BlueMind-Dienste zu überwachen, muss das Paket bm-checks installiert sein.

    Nach der Installation des Pakets sind Überwachungsskripte im Verzeichnis /usr/share/bm-checks/ verfügbar.

    Um sie zu verwenden, starten Sie die Ausführung dieser Bash-Skripte auf reguläre Art und Weise, z. B. mit einem Cron.

    Jedes Skript gibt einen Rückgabecode zurück, der vom Status des BlueMind-Dienstes abhängt:

    • 0 (Null), wenn der Dienst funktionsfähig ist
    • 1 (eins), wenn ein Fehler erkannt wurde

    Wenn ein Fehler auftritt, wird eine Meldung an dzn Standardausgang zurückgeschickt.

    Log-Überwachung

    Die Protokolldateien der BlueMind-Komponenten sind im Verzeichnis /var/log abrufbar:

    • /var/log/bm/
    • /var/log/bm-eas/
    • /var/log/bm-elasticsearch/
    • /var/log/bm-hps/
    • /var/log/bm-mapi/
    • /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/

    Für andere Komponenten, die überwacht werden können, können die folgenden Orte verwendet werden:

    • /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/

    Skriptsteuerung

    BlueMind verwendet Standard-Systemskripte zum Stoppen und Starten von Diensten.

    So startet der Befehl "bmctl restart" alle BlueMind-Dienste neu.

    Ausführen von Operationen per Skript

    Wie in den Abschnitten über die Integration mit Drittanwendungen erwähnt, kann BlueMind vollständig per Skript gesteuert werden.

    Über die Client-APIs (in PHP und Java) ist es möglich, jede beliebige Operation auf BlueMind durchzuführen, insbesondere einen Benutzer anzulegen oder zu ändern, auf einen Terminplaner zuzugreifen, einen Termin hinzuzufügen...

    Enregistrer