Comparaison des versions

Ancienne version 45

changes.mady.by.user Sophie Lepissier

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

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