Einrichtung des Mailservers

Damit du Email-Benachrichtigungen erhältst, wenn in der Enginsight Plattform ein Alarm ausgelöst wird, musst du deinen Mailserver in der Enginsight Konfiguration einrichten. Im Folgenden zeigen wir dir, welche Schritte du dafür vornehmen musst.

---

Mailserver einrichten

Bitte beachte: Die folgenden Schritte müssen auf dem Enginsight Applikationsserver durchgeführt werden. Wenn du eine Lastverteilung einsetzt, musst du den Mailserver zusätzlich auf der virtuellen Maschine einrichten, auf der die Enginsight Services laufen.

1

Melde dich auf dem Enginsight Applikationsserver an, sofern du dies noch nicht getan hast.

Du kannst dies entweder direkt in der Konsole deiner Applikationsserver-VM oder per Fernzugriff über SSH (Secure Shell) von einer anderen Maschine aus tun.

2

Öffne mit folgendem Befehl die Enginsight Konfigurationsdatei:

sudo nano /opt/enginsight/enterprise/conf/services/config.json

Bestätige deine Eingabe mit der Enter-Taste.

3

Navigiere zum Abschnitt email und passe ihn wie folgt an:

"email": {
    "sender": "'<Firmenname>' <AbsenderMailAdresse>",
    "host": "<HostnameMailServer>",
    "port": "<PortMailServer>",
    "sslTls": true,
    "user": "<BenutzernameMailServer>",
    "pass": "<PasswortMailServer>",
    "maxConnections": 5,
    "rateDelta": 1000,
    "rateLimit": 5
  },

Vergiss dabei nicht, die folgenden Platzhalter in <> entsprechend zu ersetzen:

• <Firmenname>

• <AbsenderMailAdresse>

• <HostnameMailServer>

• <PortMailServer>

• <BenutzernameMailServer>

• <PasswortMailServer>

Bitte beachte: Wenn du einen SPF-Eintrag (Sender Policy Framework) in deinem DNS hinterlegt hast, ist die Angabe eines Senders zwingend notwendig!

Bitte beachte: In manchen Fällen bedarf es einer abweichenden Konfiguration. Beispielkonfigurationen findest du im Abschnitt Abweichende Konfigurationen.

4

Speichere die Änderungen in der Konfigurationsdatei (Strg + o) und bestätige den Speicherprozess. Schließe die Datei (Strg + x).

5

Nun musst du das Setup-Skript für den Applikationsserver noch einmal ausführen, um deine Anpassungen zu übernehmen.

Navigiere dazu mit folgendem Befehl ins Enginsight Installationsverzeichnis:

cd /opt/enginsight/enterprise

Bestätige deine Eingabe mit der Enter-Taste.

6

Führe mit folgendem Befehl das Setup-Skript neu aus und und bestätige alle Abfragen mit der Enter-Taste:

sudo ./setup.sh

Abweichende Konfigurationen

In manchen Fällen bedarf es einer vom Standard abweichenden Konfiguration des Mailservers. Im Folgenden findest du drei Beispielkonfigurationen für einen Microsoft 365-Mailserver, einen lokalen Microsoft Exchange-Server und einen Mailserver ohne TLS:

Beispielkonfiguration für einen Microsoft 365-Mailserver

"email":{
  "sender": "'<Firmenname>' <AbsenderMailAdresse>",
  "unqueued": true,
  "host": "smtp.office365.com",
  "requireTLS": false, 
  "ignoreTLS": false, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "port": 587,
  "user": "<BenutzernameMailServer>",
  "pass": "<PasswortMailServer>",
  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5,
  "service": "Outlook365"
}, 

Vergiss dabei nicht, die folgenden Platzhalter in <> entsprechend zu ersetzen:

• <Firmenname>

• <AbsenderMailAdresse>

• <BenutzernameMailServer>

• <PasswortMailServer>

Beispielkonfiguration für einen lokalen Microsoft Exchange-Server

"email":{
  "sender": "'<Firmenname>' <AbsenderMailAdresse>",
  "unqueued": true,
  "host": "<HostnameMailServer>",
  "requireTLS": false, 
  "ignoreTLS": false, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "port": 587,
  "user": "<BenutzernameMailServer>",
  "pass": "<PasswortMailServer>",
  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5
}, 

Vergiss dabei nicht, die folgenden Platzhalter in <> entsprechend zu ersetzen:

• <Firmenname>

• <AbsenderMailAdresse>

• <HostnameMailServer>

• <BenutzernameMailServer>

• <PasswortMailServer>

Beispielkonfiguration für einen Mailserver ohne TLS

"email":{
  "sender": "'<Firmenname>' <AbsenderMailAdresse>",
  "unqueued": true,
  "host": "<HostnameMailServer>",
  "requireTLS": false, 
  "ignoreTLS": true, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "user": "<BenutzernameMailServer>",
  "pass": "<PasswortMailServer>",
  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5
},

Vergiss dabei nicht, die folgenden Platzhalter in <> entsprechend zu ersetzen:

• <Firmenname>

• <AbsenderMailAdresse>

• <HostnameMailServer>

• <BenutzernameMailServer>

• <PasswortMailServer>

---

Mailserver testen

Nachdem du den Mailserver eingerichtet hast, kannst du über die Konsole auf dem Applikationsserver testen, ob die Konfiguration erfolgreich war.

Nimm dazu folgende Schritte vor:

1

Nutze folgenden Befehl, um die ID des Sentinel-Containers zu erhalten, der auf dem Applikationsserver installiert ist:

sudo docker ps --filter "name=sentinel" --format "{{.ID}}"

Bestätige deine Eingabe mit der Enter-Taste.

Bitte beachte: Dieser Schritt ist zwingend notwendig, da bei der Ausführung des Setup-Skripts für den Applikationsserver alle Container-IDs neu erzeugt werden!

2

Nutze folgenden Befehl, um eine Test-E-Mail zu versenden, und bestätige deine Eingabe mit der Enter-Taste:

Vergiss dabei nicht, <SentinelContainerID> und <EmpfängerMailAdresse> entsprechend zu ersetzen.

sudo docker exec <SentinelContainerID> ./sendTestMail --to <EmpfängerMailAdresse>

3

Wenn die Konfiguration wie gewünscht funktioniert hat, wird dir in der Konsole folgendes angezeigt:

Zudem solltest du eine Test-Email an der angegebenen Empfänger-Email-Adresse erhalten haben:

---