Hinweis: Supervisor wird mit einer festgelegten Konfiguration unter /var/www/share/etc/supervisor installiert. Es werden keine Vorlagen für Programme und Gruppen angelegt. Bereits angelegte Konfigurationen, wie z. B. von einer älteren und manuellen Installation, die unter /var/www/share/etc/supervisor/conf.d/*.conf abgelegt ist, werden im Managed Center übernommen.
Supervisor installieren
Um Supervisor im Managed Center zu installieren, gehen Sie bitte wie folgt vor:
- Loggen Sie sich zunächst mit Ihren Benutzerdaten unter app.maxcluster.de/login ein.
Nach erfolgreicher Anmeldung gelangen Sie automatisch in Ihre Übersicht. - Öffnen Sie das Managed Center Ihres Clusters. Sie werden dann in die Dashboard-Ansicht weitergeleitet.
- Klicken Sie in dem linken Navigationsmenü zuerst auf Zugriff & Verwaltung (Punkt 1) und dann auf Supervisor (Punkt 2).
- Um Supervisor zu installieren, wählen Sie Supervisor installieren aus (Punkt 3).
- Sobald Supervisor installiert ist, haben Sie die möglichkeit Supervisor zu aktivieren. Klicken Sie dafür auf den Toggle neben deaktiviert (Punkt 3). Dieser wechselt dann auf aktiviert.
Hinweis: Eingeschränkte Konfigurationsmöglichkeiten
Im Rahmen der Erstellung und Änderung von Supervisor-Programmen ist es bei uns nicht möglich, die Direktive startsecs mit einem Wert von 0 zu verwenden.
Wir unterbinden eine zu schnelle Neustart-Frequenz, weil das direkte und unendliche Neustarten von Programmen zu einer hohen Last Ihres Clusters führen kann, wodurch die Performance aller anderen Dienste und Ihrer Webseiten deutlich reduziert werden kann. Zu schnelle Neustarts sind in der Regel eine Folge einer Fehlkonfiguration oder eines Ausführungsfehlers, der direkt beim Start(-versuch) besteht.
Durch die Verwendung von startsecs=0 kann Supervisor den fehlerhaften Start eines Programmen nicht mehr erkennen, denn in Verbindung mit autorestart=true ignoriert Supervisor den Exit-Code des Programms. In dieser Konstellation bleibt auch die Konfigurationsdirektive startretries unberücksichtigt, und es kommt zu unendlichen Startversuchen, wodurch mehrere Tausend Neustarts pro Minute erzeugt werden können. Dennoch wird der “Status” eines solchen Programmes als RUNNING deklariert, sodass selbst eine Prüfung der Programme in Supervisor oder dem Managed Center keine Probleme (abgesehen von einer Uptime von 0 Sekunden) erkennen lässt.
Wir empfehlen den Einsatz von Superlance (folgender Abschnitt in diesem Artikel), um sich bei einer fehlerhaften Ausführung von Supervisor-Programmen benachrichtigen zu lassen. So können Sie zeitnah auf Probleme mit den Programmen reagieren und diese beheben, sodass Ihre Programme länger als 1 Sekunde aktiv bleiben.
Falls Sie Programme ausführen möchten, deren reguläre, fehlerfreie Ausführung weniger als eine Sekunde dauert, dann haben Sie folgende Möglichkeiten:
Sie verwenden ein Programm, welches zusätzlich zum eigentlichen Befehl noch den Befehl sleep 1 anhängt. Dadurch wird der Neustart um eine Sekunde verzögert, sodass das Programm mit startsecs=1 erfolgreich gestartet werden kann.
Sie verwenden anstelle eines Supervisor-Programms einen Cronjob. Cronjobs werden maximal einmal pro Minute ausgeführt und haben keine Beschränkung, wie lange ein solcher benötigen muss, um als erfolgreich gestartet zu gelten. Auch für Cronjobs können Sie eine Benachrichtigung über die Ausführung an Ihre E-Mail-Adresse erhalten.
Supervisor Superlance Plugin
Mit Superlance können die Supervisorprozesse überwacht werden. So können Sie z.B. beim Wechsel eines Programms in den FATAL-State, per E-Mail benachrichtigt werden.
Sobald Supervisor eingerichtet wird, wird Superlance automatisch mitinstalliert. Dieses Plugin muss nicht separat im Managed Center aktiviert werden.
Wie richte ich Superlance ein
Superlance wird automatisch hinzugefügt, wenn Sie Supervisor installieren, oder auch entfernt, wenn Supervisor deinstalliert wird.
In der Konfiguration von Superlance tragen Sie eine E-Mail-Adresse ein, worauf Sie, wenn beim Wechsel eines Programms in den FATAL-State, eine Benachrichtigung erhalten und entsprechend eingreifen können.
Die Konfiguration können Sie im Managed Center unter Zugriff & Verwaltung → Supervisor → Eventlistener+ wie folgt hinterlegen:
Beispiel für “fatalmailbatch”:
[eventlistener:fatalmailbatch]
command=fatalmailbatch --toEmail="<ADDRESS>" --fromEmail="supervisor@<DOMAIN>.de"
events=PROCESS_STATE,TICK_60
Tragen Sie bei dem neuen Eventlistener Folgendes ein:
- Name: z.b fatalmailbatch - dieses wird auch in der ersten Zeile bei eventlistener übernommen
- command=fatalmailbatch --toEmail="<ADDRESS>" --fromEmail="supervisor@<DOMAIN>.de"
- events=PROCESS_STATE,TICK_60
Hinweis: die Verwendung der Absenderdomain (fromEmail="supervisor@<DOMAIN>.de") muss auf dem jeweiligen Server durch SPF und/oder DKIM (empfohlen beides) legitimiert werden, damit die E-Mails auch zugestellt werden können! Weitere Informationen finden Sie unter:
maxcluster-Empfehlungen für einen SPF-Record
Postfix / Sendmail - DKIM einrichten
Damit Ihre Eingaben übernommen werden, bestätigen Sie mit Speichern.
Alternativ können Sie die Konfiguration auch selbst unter z. B. /var/www/share/etc/supervisor/conf.d/fatalmailbatch.conf eintragen.
Bei Fragen steht Ihnen unser Support telefonisch unter 05251/414130 oder per E-Mail an support@maxcluster.de zur Verfügung.