> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-plattform/automatische-installation/datenbankserver.md).

# Datenbankserver

Führe für die Installation und das Setup des Datenbankservers die nachfolgenden Schritte aus.

{% hint style="warning" %}
**Bitte beachte**: Die Navigation durch die Installations- und Setup-Schritte erfolgt ausschließlich mit dem Keyboard. Die Verwendung einer Maus ist leider nicht möglich.
{% endhint %}

***

## Installation des Datenbankservers

{% stepper %}
{% step %}

### Vorbereitende Schritte ausführen

Achte darauf, dass du vor der Installation die [vorbereitenden Schritte](/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-plattform/automatische-installation.md#vorbereitung) korrekt ausgeführt hast.
{% endstep %}

{% step %}

### Debian-Image auf dem Datenbankserver starten

Starte das Enginsight Debian-Image *auf dem Datenbankserver* und wähle **DB-Server (auto)**. Bestätige deine Eingabe mit der **Enter**-Taste.

{% hint style="info" %}
Wie du ein virtuelles Informationsmedium startest und auswirfst, hängt von deinem verwendeten Hypervisor ab.
{% endhint %}

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FJVQpEo76shLDxMonn4Bn%2FEnginsight-Installation-DB%20Server.jpg?alt=media&amp;token=c8af0fda-77cf-4be6-9555-7bc2da29fa87" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Es erscheint nun für einige Augenblicke ein blauer Bildschirm. Dies ist ein korrektes Verhalten, daher kannst du einfach abwarten.
{% endhint %}
{% endstep %}

{% step %}

### Sprache, Standort und Tastaturlayout angeben

Im Folgenden werden die gewünschte Sprache für die Installation, der Standort der Installation sowie das Tastaturlayout abgefragt.

Wähle eine **Sprache**, deinen **Standort** sowie das passende **Tastaturlayout** aus und bestätige deine Eingaben jeweils mit **Weiter** und der **Enter**-Taste.

{% hint style="info" %}
Das Setup beginnt nun automatische Informationen über dein Netzwerk abzurufen. Dies kann einen kurzen Moment dauern, du kannst daher einfach abwarten, bis alles geladen wurde.
{% endhint %}
{% endstep %}

{% step %}

### Rechnernamen angeben

Gib nun einen **Rechnernamen** für den Datenbankserver an. Dies ist der Name, mit dem der Datenbankserver im Netzwerk identifiziert wird.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FGxvmOsCQQDBDzoZ8NgNv%2Fimage.png?alt=media&amp;token=5cb0c032-47eb-4632-a5bf-1bd11f4ceb2a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Frage bei deinem Netzwerkadministrator nach, wenn du dir unsicher bist, wie der Name für deinen Datenbankserver lauten soll. Der standardmäßig von uns angegebene Rechnername für den Datenbankserver lautet **ngs-db**.
{% endhint %}

Bestätige deine Eingabe mit **Weiter** und der **Enter**-Taste.
{% endstep %}

{% step %}

### Domain-Namen angeben

Gib den **Domain-Namen** deines Unternehmens an, z.B. *beispielfirma.de*.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FPMREIKc1AQhobAIzRfsT%2Fimage.png?alt=media&amp;token=4f7df998-d9df-4fec-972f-04b6eedf65e9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Frage bei deinem Netzwerkadministrator nach, wenn du dir unsicher bist, wie der Domain-Name deines Unternehmens lautet.
{% endhint %}

Bestätige deine Eingabe mit **Weiter** und der **Enter**-Taste.
{% endstep %}

{% step %}

### Optional: HTTP-Proxy-Daten angeben

Wenn du einen HTTP-Proxy einsetzt, um das Internet zu erreichen, gib die entsprechenden Proxy-Daten an.

Wenn du keinen HTTP-Proxy einsetzt, lasse das Feld einfach leer und bestätige mit der **Enter**-Taste.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FkmcNE4GU1IvnsbWPINRu%2Fimage.png?alt=media&amp;token=82ea3a39-4bed-4845-b300-413d2e5cf261" alt=""><figcaption></figcaption></figure>

Die Angabe der Proxy-Daten kann folgendermaßen aussehen:

* Keine Angabe von Benutzer, Passwort und Port: `http://`<mark style="color:$primary;">`<IPAdresseHost>`</mark>`/`
* Angabe von Benutzer und Passwort, keine Angabe eines Ports: `http://`<mark style="color:$success;">`<Benutzername>`</mark>`:`<mark style="color:$warning;">`<Passwort>`</mark>`@`<mark style="color:$primary;">`<IPAdresseHost>`</mark>`/`
* Angabe von Benutzer, Passwort und Port:\
  `http://`<mark style="color:$success;">`<Benutzername>`</mark>`:`<mark style="color:$warning;">`<Passwort>`</mark>`@`<mark style="color:$primary;">`<IPAdresseHost>`</mark>`:8080/`

{% hint style="danger" %}
**Bitte beachte**: Der letzte Slash `/` muss zwingend gesetzt werden!
{% endhint %}

Bestätige deine Eingabe mit **Weiter** und der **Enter**-Taste.
{% endstep %}

{% step %}

### Benutzerkonto für den Datenbankserver anlegen

Gib nun einen Namen für das Benutzerkonto für den Datenbankserver an, das du statt des root-Kontos verwenden kannst.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FM0KJasjyoNSJKTGpSY3b%2Fimage.png?alt=media&amp;token=ab2f9be7-ee1f-45a9-b86a-abf84382c510" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Der standardmäßig von uns angegebene Benutzerkonto-Name lautet **Enginsight DB**.
{% endhint %}

Bestätige deine Eingabe mit **Weiter** und der **Enter**-Taste.
{% endstep %}

{% step %}

### Benutzername angeben

Gib nun einen **Benutzernamen** für das neue Datenbankserver-Benutzerkonto an.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FH9VIn9im4n3jAa87aK0N%2Fimage.png?alt=media&amp;token=6b9cd7c4-dc4b-4f3d-b284-0f4b556c5b3b" alt=""><figcaption></figcaption></figure>

Der Benutzername sollte mit einem Kleinbuchstaben beginnen. Bestätige deine Eingabe mit **Weiter** und der **Enter**-Taste.

{% hint style="info" %}
Der standardmäßig von uns angegebene Benutzername lautet **ngsdb**.
{% endhint %}
{% endstep %}

{% step %}

### Passwort angeben

1. Gib ein **Passwort** für das neue Datenbankserver-Benutzerkonto an. Aktiviere **Passwort im Klartext anzeigen**, wenn du dies benötigst, indem du mit der Tastatur zu der Option navigierst und die **Enter**-Taste drückst.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FiX8BCToDHpw2wxEcuFoO%2Fimage.png?alt=media&amp;token=2ec66fc4-7b28-466d-942f-dd38be35c7db" alt=""><figcaption></figcaption></figure>

2. Bestätige deine Eingabe mit **Weiter** und der **Enter**-Taste.
3. Gib das Passwort zur Sicherheit erneut ein. Aktiviere **Passwort im Klartext anzeigen**, wenn du dies benötigst. Bestätige deine Eingabe mit **Weiter** und der **Enter**-Taste.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FgZdRHW2zblBJuVGF52n2%2Fimage.png?alt=media&amp;token=d7c85e56-b120-4223-8d29-989da7b4b09e" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Bitte beachte**: Wir empfehlen dringend, Benutzername und Passwort für den Datenbankserver in einem Passwort-Manager zu speichern!
{% endhint %}
{% endstep %}

{% step %}

### Festplatte wählen

Wähle die **Festplatte** aus, auf der eine Partition angelegt wird, auf der Daten gespeichert werden sollen. Bestätige deine Eingabe mit der **Enter**-Taste.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FIT02bxE8TkUtdlBjjs09%2Fimage.png?alt=media&amp;token=3addf97a-53a9-4c32-9cd8-7e8f3b8499f9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Installation abschließen

Nun startet die eigentliche Installation. Warte darauf, bis die Installation abgeschlossen ist und eine entsprechende Meldung erscheint.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FemYBzxou8OVh2kTzxeZa%2Fimage.png?alt=media&amp;token=5dc332c8-8c95-4ce5-b1dc-601343c49135" alt=""><figcaption></figcaption></figure>

Bestätige die Information **Installation abgeschlossen** mit **Weiter** und der **Enter**-Taste.
{% endstep %}

{% step %}

### Virtuelles Informationsmedium auswerfen

Wirf nun das virtuelle Informationsmedium mit dem Debian-Image aus, um mit dem Setup des Datenbankservers fortzufahren.

{% hint style="info" %}
Wie du ein virtuelles Informationsmedium startest und auswirfst, hängt von deinem verwendeten Hypervisor ab.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Setup des Datenbankservers

Wenn die Installation abgeschlossen ist und das virtuelle Installationsmedium ausgeworfen wurde, wird dir in der Konsole deiner Datenbankserver-VM folgendes angezeigt:

<div align="left"><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2Fx5qpfmu7iOlXeC3e9SMf%2Fimage.png?alt=media&amp;token=81218b0b-c056-403d-aa2e-8118876d466f" alt=""></div>

{% hint style="info" %}
`ngs-db` steht dabei für den Rechnernamen, den du bei der Installation für den Datenbankserver vergeben hast.
{% endhint %}

Du kannst nun entweder in der Konsole des Datenbankservers selbst oder per Fernzugriff über SSH (Secure Shell) von einer anderen Maschine aus fortfahren.

{% hint style="warning" %}
**Bitte beachte**: Solltest du eine Einstellung während des Konfigurationsprozesses aus Versehen falsch vornehmen, kannst du das Setup-Skript jederzeit mit dem Befehl `initial-setup` neu starten.
{% endhint %}

{% stepper %}
{% step %}

### Auf dem Datenbankserver anmelden

Logge dich nun auf dem Datenbankserver ein, um mit dem Setup fortzufahren.

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FsITAfT3ARmslqkcrrI88%2FDB%2013.png?alt=media&amp;token=b99f48d7-9a7b-4b4e-ae83-7a2df43eab38" alt=""><figcaption></figcaption></figure></div>

1. Gib dazu neben `<Rechnername> login` den Benutzernamen ein, den du für das neue Datenbankserver-Benutzerkonto angelegt hast. Bestätige deine Eingabe mit der **Enter**-Taste.
2. Gib neben `Password` das Passwort ein, das du für das neue Datenbankserver-Benutzerkonto angelegt hast. Bestätige deine Eingabe mit der **Enter**-Taste.

{% hint style="danger" %}
**Bitte beachte**: Das eingegebene Passwort wird ***nicht*** angezeigt, auch nicht mit einem Sternchen-Platzhalter. Solltest du dich vertippen, musst du den Login nach einer bestimmten Anzahl von Fehleingaben erneut starten. In der VM-Konsole sind 3 Fehleingaben möglich. Verwendest du SSH, ist nur eine Fehleingabe möglich.
{% endhint %}

3. Wiederhole die Passwort-Eingabe neben `[sudo] Passwort für <Benutzername>` . Bestätige deine Eingabe mit der **Enter**-Taste.
   {% endstep %}

{% step %}

### TLS und rollenbasierte Zugriffskontrolle (RBAC) aktivieren

Lege nun fest, ob du die Verbindung vom Applikationsserver zur Datenbank per TLS (Transport-Layer Security) verschlüsseln und eine rollenbasierte Zugriffskontrolle aktivieren möchtest.

{% hint style="warning" %}
**Bitte beachte**: Die Aktivierung dieser Einstellung wird von uns ausdrücklich empfohlen!
{% endhint %}

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FxmzZaBy8n0Tqzw17rYxq%2Fimage.png?alt=media&amp;token=6fe9685c-bef7-4901-9038-07622799cb75" alt=""><figcaption></figcaption></figure>

Bestätige die Frage **TLS und rollenbasierte Zugangskontrolle aktivieren (empfohlen)? (j/n)** entsprechend mit **j** für Ja oder mit **n** für Nein. Bestätige deine Eingabe mit der **Enter**-Taste.
{% endstep %}

{% step %}

### IP-Adresse des Applikationsservers angeben

Nun wirst du aufgefordert, die IP-Adresse des Applikationsservers anzugeben.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FxK4fdgjdzlRDfA8c93eR%2Fimage.png?alt=media&amp;token=b64902b6-af5e-4b04-b81c-1af074e0719a" alt=""><figcaption></figcaption></figure>

1. Starte dazu parallel die [Installation des Applikationsservers](/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-plattform/automatische-installation/applikationsserver.md#installation-des-applikationsservers), sofern du dies noch nicht getan hast.
2. Gib die IP-Adresse des Applikationsservers an, sobald du sie vorliegen hast. Bestätige deine Eingabe mit der **Enter**-Taste.
   {% endstep %}

{% step %}

### IP-Adresse des Datenbankservers angeben

Nun wirst du aufgefordert, die IP-Adresse des Datenbankservers (auf dem du dich gerade befindest) einzugeben.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FAfkcQgF4qgDOV629XH9F%2Fimage.png?alt=media&amp;token=49649a12-1c11-430f-9c86-94d318c9bf9b" alt=""><figcaption></figcaption></figure>

Die IP-Adresse des Datenbankservers wird in der Regel bereits *automatisch ausgelesen und angezeigt*.

Überprüfe die angezeigte IP-Adresse und ändere sie gegebenenfalls ab, falls sie nicht korrekt sein sollte. Bestätige deine Eingabe mit der **Enter**-Taste.
{% endstep %}

{% step %}

### SSL/TLS-Zertifikate und Passwort für Zugriffskontrolle auf den Applikationsserver kopieren

Bevor der Kopiervorgang gestartet werden kann, bei dem die generierten TLS-Zertifikate und das Passwort für die rollenbasierte Zugangskontrolle auf den Applikationsserver kopiert werden, musst du die Anmeldedaten für den Applikationsserver eingeben.

Dafür benötigst du den Benutzernamen sowie das Passwort, die du bei der Installation des Applikationsservers festgelegt hast.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2F2rq0ClsUPhYURAGTuKbI%2Fimage.png?alt=media&amp;token=b59febb4-6d0f-4260-9dd7-ea362ce510d3" alt=""><figcaption></figcaption></figure>

1. Gib den **Benutzernamen für den Applikationsserver** ein und bestätige deine Eingabe mit der **Enter**-Taste.
2. Du wirst während des Kopiervorgangs mehrmals dazu aufgefordert, das **Passwort für den Applikationsserver** einzugeben. Bestätige deine Eingabe jeweils mit der **Enter**-Taste.

{% hint style="danger" %}
**Bitte beachte**: Du hast nach einer Aufforderung, dein Passwort einzugeben, an dieser Stelle nur jeweils **20 Sekunden** Zeit, um dies zu tun, anderenfalls musst du das Setup-Skript erneut starten und von vorne beginnen!
{% endhint %}
{% endstep %}

{% step %}

### Datenbankserver-Setup abschließen

Nach Abschluss des Datenbankserver-Setups wirst du gefragt, ob du SSH deaktivieren möchtest. Standardmäßig ist hier **j** für Ja ausgewählt.

Da du noch weitere Server-Konfigurationen durchführen musst, wähle **n** für Nein. Bestätige deine Eingabe mit der **Enter**-Taste.

{% hint style="danger" %}
**Bitte beachte**: Wir empfehlen, das Authentifizierungsverfahren für den SSH-Zugriff auf die Datenbankserver-VM abzuändern, sobald du den Server produktiv einsetzt. Nutze eine Authentifizierung per Public-Key anstatt der Anmeldung über Benutzernamen und Passwort.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Nächste Schritte

Nachdem du den Applikationsserver bereits parallel installiert hast, kannst du nun mit dem [Setup des Applikationsservers](/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-plattform/automatische-installation/applikationsserver.md#setup-des-applikationsservers) fortfahren.

***

## Weitere Ressourcen

**Knowledge Base**

* [Wie richte ich für die Enginsight Datenbank ein Passwort ein?](https://docs.enginsight.com/docs/knowledge-base/datenbank/wie-richte-ich-fur-die-enginsight-datenbank-ein-passwort-ein)
* [Welche Anpassungen muss ich vornehmen, wenn sich die IP-Adresse meiner Enginsight Datenbank ändert?](https://docs.enginsight.com/docs/knowledge-base/datenbank/welche-anpassungen-muss-ich-vornehmen-wenn-sich-die-ip-adresse-meiner-enginsight-datenbank-andert)
* [Wie aktualisiere ich die Enginsight Datenbank von MongoDB 5.0 auf MongoDB 8.0?](https://docs.enginsight.com/docs/knowledge-base/datenbank/wie-aktualisiere-ich-die-enginsight-datenbank-von-mongodb-5.0-auf-mongodb-8.0)
* [Wie erstelle ich ein Backup meiner Enginsight Instanz?](https://docs.enginsight.com/docs/knowledge-base/datenbank/wie-erstelle-ich-ein-backup-meiner-enginsight-instanz)
* [Wie erstelle ich in Enginsight ein Backup einer oder mehrerer Organisationen?](https://docs.enginsight.com/docs/knowledge-base/datenbank/wie-erstelle-ich-in-enginsight-ein-backup-einer-oder-mehrerer-organisationen)

***
