Welche Anpassungen muss ich vornehmen, wenn sich die IP-Adresse meiner Enginsight Datenbank ändert?

Wenn sich die IP-Adresse deiner Enginsight Datenbank ändert, musst du in deiner Datenbankkonfiguration verschiedene Änderungen vornehmen. Im Folgenden zeigen wir dir, welche dies sind und welche Anpassungen du sonst noch vornehmen musst.

1

Enginsight Applikationsserver stoppen

Bitte beachte: Dieser Schritt ist vor allen Änderungen an der Datenbank zwingend notwendig!

1. Logge dich auf dem Enginsight Applikationsserver ein und navigiere mit folgendem Befehl in das Enginsight Installationsverzeichnis:

cd /opt/enginsight/enterprise

1. Stoppe nun den Applikationsserver mit folgendem Befehl:

sudo docker-compose down

2

Datenbank-Backup erstellen

Logge dich auf dem Enginsight Datenbankserver ein und führe einen sogenannten MongoDB-Dump aus.

Bitte beachte: Die benötigten Befehle für einen MongoDB-Dump können variieren, z.B. wenn deine Datenbank per SSL/TLS verschlüsselt ist.

Mehr Informationen, welche Optionen es für einen MongoDB-Dump gibt, findest du in der Knowledge Base: Wie erstelle ich ein Backup meiner Enginsight Instanz?

3

Konfiguration des Replica-Sets auskommentieren

Die Konfiguration des Replica-Sets basiert bei Enginsight auf IP-Adressen. Da sich die IP-Adresse der Datenbank ändern wird, muss das Replica-Set nach Änderung der IP-Adresse neu initialisiert werden.

Die Neuinitialisierung erfordert eine vorherige Deaktivierung des Replica-Sets, die am besten gleich am Anfang vorgenommen wird. So kannst du in folgenden Schritten Inkonsistenzen wegen fehlerhafter Replikation vermeiden.

1. Öffne dazu mit folgendem Befehl die MongoDB-Konfigurationsdatei mongod.conf:

sudo nano /etc/mongod.conf

1. Navigiere zum Abschnitt replication:

replication:
  replSetName: "rs0"

1. Setze ein Raute-Zeichen # vor die entsprechenden Zeilen, um diese auszukommentieren:

# replication:
#   replSetName: "rs0"

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

4

Replica-Set in lokaler Datenbank löschen

Da die Konfiguration des Replica-Sets sowohl in /etc/mongod.conf als auch datenbankintern in der local-Datenbank existiert, muss nach der Deaktivierung in der MongoDB-Konfigurationsdatei mongod.conf nun auch die bestehende, datenbankinterne Konfiguration des Replica-Set zurückgesetzt werden.

1. Navigiere dazu mit folgenden Befehlen in die MongoDB-Shell mongosh und von dort zur lokalen Datenbank local:

sudo mongosh
use local

1. Setze nun mit folgendem Befehl die lokale Datenbank zurück (hierbei wird nicht die Enginsight Datenbank gelöscht!):

db.dropDatabase()

5

MongoDB neu starten

Starte MongoDB mit folgendem Befehl neu, um die Änderungen zu übernehmen:

sudo systemctl restart mongodb

6

Neue IP-Adresse zuweisen

1. Öffne mit folgendem Befehl die Netzwerk-Konfigurationsdatei:

sudo nano /etc/network/interfaces

1. Trage die neue IP-Adresse der Datenbank ein.

iface ens19 inet static
	address <IPAdresse>
	netmask <Netzmaske>

Bitte beachte: Der Interface-Name (hier ens19) ist nur ein Beispiel und kann abweichen. Zudem müssen neben den Parametern address und netmask eventuell noch weitere Parameter gesetzt werden, z.B. gateway. Eine vollständige Dokumentation findest du im Debian-Wiki und auf der man-Page.

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

7

Datenbankserver neu starten

Starte den Datenbankserver mit folgendem Befehl neu, um die neue Netzwerkkonfiguration zu aktivieren:

sudo reboot

8

Auskommentierung des Replica-Sets rückgängig machen

Nun muss die Auskommentierung des Replica-Sets, die in Schritt 3 vorgenommen wurde, wieder rückgängig gemacht werden.

1. Öffne dazu mit folgendem Befehl die MongoDB-Konfigurationsdatei mongodb.conf:

sudo nano /etc/mongod.conf

1. Navigiere zum Abschnitt # replication und entferne beide #-Zeichen:

replication:
  replSetName: "rs0"

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

9

MongoDB neu starten

Starte MongoDB mit folgendem Befehl neu, um die Änderungen zu übernehmen:

sudo systemctl restart mongodb

10

Replica-Set neu initialisieren

1. Navigiere mit folgendem Befehl in die MongoDB-Shell:

sudo mongosh

1. Initialisiere das Replica-Set mit folgendem Befehl neu:

rs.initiate( {
   _id : "rs0",
   members: [
      { _id: 0, host: "<IPAdresseDatenbankserver>:27017" }
   ]
})

Vergiss dabei nicht, <IPAdresseDatenbankserver> mit der IP-Adresse des Datenbankservers zu ersetzen, die vom Applikationsserver aus erreichbar ist.

1. Prüfe nun mit folgendem Befehl, ob das Replica-Set aktiv ist:

rs.status()

Bei korrekter Konfiguration wird dir nach Ausführung des Befehls folgender Prompt angezeigt:

rs0:PRIMARY>

11

IP-Tables-Datei anpassen

1. Öffne mit folgendem Befehl die IP-Tables-Datei:

sudo nano /etc/iptables/rules.v4

1. Ändere die IP-Adressen entsprechend der neuen Netzwerkanforderungen, z.B.:

-A INPUT -s <NeueIPAdresseDatenbankserver>/32 -p tcp -m tcp --dport 27017 -j ACCEPT

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

12

Änderungen auf dem Applikationsserver übernehmen

1. Gehe zurück zum Applikationsserver und navigiere mit folgendem Befehl in das Enginsight Installationsverzeichnis:

cd /opt/enginsight/enterprise

1. Führe mit folgendem Befehl das Setup-Skript für den Applikationsserver neu aus:

sudo ./setup.sh

1. Gib bei der Abfrage der URIs und URLs die MongoDB URI wie folgt an: mongodb://mongoDefaultUser:<PasswortMongoDB>@<NeueIPAdresseDatenbankserver>:27017/enginsight?authSource=enginsight&replicaSet=rs0

Vergiss nicht, <PasswortMongoDB> und <NeueIPAdresseDatenbankserver> entsprechend zu ersetzen. Das Passwort für die MongoDB findest du auch im Verzeichnis /home/ngsapp/mongoDefaultUserPassword.

---