> 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/applikationsserver.md).

# Applikationsserver

Führe für die Installation und das Setup des Enginsight Applikationsservers 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 Applikationsservers

{% 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 Applikationsserver starten

Starte das Enginsight Debian-Image *auf dem Applikationsserver* und wähle **App-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="/files/5j1i6QdBHQ4ySZTe6R4v" 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 Applikationsserver an. Dies ist der Name, mit dem der Applikationsserver im Netzwerk identifiziert wird.

<figure><img src="/files/WKUiUFWmLKhIYWLbqQO8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Frage bei deinem Netzwerkadministrator nach, wenn du dir unsicher bist, wie der Name für deinen Applikationsserver lauten soll. Der standardmäßig von uns angegebene Rechnername für den Applikationsserver lautet **ngs-app**.
{% 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="/files/wQ32t5k5kEr9DVIarlw4" 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="/files/mZfTHRy2Uj74n0qdUmDS" 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 der **Enter**-Taste.
{% endstep %}

{% step %}

### Benutzerkonto für den Applikationsserver anlegen

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

<figure><img src="/files/ksor6N5jfnpGSEZ3bysb" alt=""><figcaption></figcaption></figure>

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

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

{% step %}

### Benutzername angeben

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

<figure><img src="/files/J2QxXbDpChumFU9QieSe" 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 **ngsapp**.
{% endhint %}
{% endstep %}

{% step %}

### Passwort angeben

1. Gib ein **Passwort** für das neue Applikationsserver-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="/files/4mnTN8KSJvpRAvgTpGzx" 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="/files/3TEapzERASwDSXZH1hge" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Bitte beachte**: Wir empfehlen dringend, Benutzername und Passwort für den Applikationsserver 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="/files/kU8bEaEBlvsuTVHRTypK" 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="/files/61vFZeMeaoje8T5YLQGv" 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 Applikationsservers fortzufahren.

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

***

## Setup des Applikationsservers

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

<div align="left"><figure><img src="/files/clcSeGMiUIoA0oVsvvEJ" alt=""><figcaption></figcaption></figure></div>

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

Du kannst nun entweder in der Konsole des Applikationsservers 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 Applikationsserver anmelden

1. Logge dich nun auf dem Applikationsserver ein, um mit dem Setup fortzufahren.
2. Gib dazu neben `<Rechnername> login:` den Benutzernamen ein, den du für das neue Applikationsserver-Benutzerkonto angelegt hast. Bestätige deine Eingabe mit der **Enter**-Taste.
3. Gib neben `Password:` das Passwort ein, das du für das neue Applikationsserver-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 %}

4. Wiederhole die Passwort-Eingabe neben `[sudo] Passwort für <Benutzername>:` . Bestätige deine Eingabe mit der **Enter**-Taste.

<figure><img src="/files/gAmBJvf07f5u68q8Bjfl" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Bei der Enginsight Docker Registry anmelden

Gib nun deine Zugangsdaten für die Docker Registry an.

{% hint style="warning" %}
**Bitte beachte**: Die Zugangsdaten für die Enginsight Docker Registry erhältst du von uns. Nimm dazu Kontakt mit uns auf unter *<insidesales@enginsight.com>*.
{% endhint %}

<figure><img src="/files/jzex7EexAvcybPkJ4e1w" alt=""><figcaption></figcaption></figure>

1. Gib dazu neben `Username` den Benutzernamen `enginsight` ein und bestätige deine Eingabe mit der **Enter**-Taste.
2. Gib neben `Password` das Passwort ein, das du von uns für die Docker Registry erhalten hast, und 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 das Setup 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 %}
{% endstep %}

{% step %}

### Enginsight Images für die Docker-Container herunterladen

Warte nun ab, bis alle Enginsight Images für die benötigten Docker-Container heruntergeladen wurden.

<figure><img src="/files/3gq9cWTfes90YvuY7t8q" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### TLS und rollenbasierte Zugriffskontrolle (RBAC) aktivieren

Lege nun fest, ob du Verbindungen vom und zum Applikationsserver 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="/files/ib5nYRjj9yaaz0VysOUs" 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 %}

### Endbenutzer-Lizenzvertrag lesen und bestätigen

Nachdem der Download abgeschlossen ist, wirst du aufgefordert, dem **Endbenutzer-Lizenzvertrag** (End User License Agreement; EULA) von Enginsight zuzustimmen.

<figure><img src="/files/AmmxN1XYznIyeedNCP9o" alt=""><figcaption></figcaption></figure>

Lies dir den Lizenzvertrag durch und gib deine Zustimmung mit **y** für Yes, um fortzufahren. Bestätige deine Eingabe mit der **Enter**-Taste.
{% endstep %}

{% step %}

### URIs und URLs überprüfen und bestätigen

Nun wirst du aufgefordert, verschiedene URIs (Uniform Resource Identifier) und URLs zu überprüfen und zu bestätigen.

<div align="left"><figure><img src="/files/Me92MbL75Vqs7Z6gh9Pm" alt=""><figcaption></figcaption></figure></div>

Die entsprechenden URIs und URLs sind *bereits vorausgefüllt* und müssen nur überprüft und jeweils mit der **Enter**-Taste bestätigt werden.

Wenn du bestimmte Angaben ändern möchtest, gib die Änderungen wie folgt ein und bestätige sie jeweils mit der **Enter**-Taste:

<table><thead><tr><th width="202.171875">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Enter MongoDB URI</td><td><p>Gib die URI der MongoDB-Instanz, auf der die Enginsight Datenbank läuft, in folgendem Format an:<br><br><code>mongodb://mongoDefaultUser:&#x3C;PasswortMongoDB>@&#x3C;IPAdresseDatenbankserver>:27017/enginsight?authSource=enginsight&#x26;replicaSet=rs0</code></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Vergiss nicht, <code>&#x3C;PasswortMongoDB></code> und <code>&#x3C;IPAdresseDatenbankserver></code> entsprechend zu ersetzen.</p><p>Das Passwort für die MongoDB findest du auch im Verzeichnis <code>/home/ngsapp/mongoDefaultUserPassword</code>.</p></div></td></tr><tr><td>Enter Redis URI</td><td><p>Gib die URI des Remote Dictionary Servers (Redis) in folgendem Format an, falls du diesen verwendest:<br><br><code>redis://redis:&#x3C;RedisPortnummer></code></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Vergiss nicht, <code>&#x3C;RedisPortnummer></code> entsprechend zu ersetzen.</p></div></td></tr><tr><td>Enter APP URL</td><td><p>Gib die URL, unter der die Enginsight Benutzeroberfläche aufgerufen werden kann, in folgendem Format an:<br><br><code>http://&#x3C;IPAdresseApplikationsserver></code> <strong>oder</strong> <code>http://&#x3C;DomainApp></code></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Vergiss dabei nicht, <code>&#x3C;IPAdresseApplikationsserver></code> und <code>&#x3C;DomainApp></code> entsprechend zu ersetzen.</p></div></td></tr><tr><td>Enter API URL</td><td><p>Gib die URL, unter der die Enginsight API erreicht werden kann, in folgendem Format an:<br><br><code>http://&#x3C;IPAdresseApplikationsserver>:8080</code> <strong>oder</strong> <code>http://&#x3C;DomainAPI>:8080</code></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Vergiss dabei nicht, <code>&#x3C;IPAdresseApplikationsserver></code> und <code>&#x3C;DomainAPI></code> entsprechend zu ersetzen.</p></div></td></tr></tbody></table>
{% endstep %}

{% step %}

### Initialisierung der Docker-Container starten

Nachdem du alle URIs und URLs überprüft und bestätigt hast, startet die Initialisierung der Docker-Container.

<figure><img src="/files/qm9DPedKBtYTRJNwysgd" alt=""><figcaption></figcaption></figure>

Dies kann einige Zeit in Anspruch nehmen. Warte ab, bis die Initialisierung abgeschlossen ist.
{% endstep %}

{% step %}

### Zugriff auf Enginsight Benutzeroberfläche und API per HTTPS absichern

Nach Installation und erstem Setup des Applikationsservers ist der Zugriff per HTTPS auf die Enginsight Benutzeroberfläche und API noch deaktiviert.

{% hint style="danger" %}
**Bitte beachte**: Wir empfehlen aus Sicherheitsgründen dringend, den Zugriff per HTTPS zu aktivieren!
{% endhint %}

Nutze die Anleitung in folgendem Kapitel, um eine gesicherte Verbindung per HTTPS zu aktivieren: [Verschlüsselung per HTTPS](/docs/manual/installation-und-konfiguration/installation-und-konfiguration/weitere-konfigurationen/verschlusselung-per-https.md).

<figure><img src="/files/Y5Gs5kN7VRaXTTJIK6OB" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Applikationsserver-Setup abschließen

Nach Abschluss des Applikationsserver-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 möchtest, 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 Applikationsserver-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 %}

***

## Vorläufige Login-Daten für die Benutzeroberfläche

Nachdem du die Installation und das Setup des Applikationsservers abgeschlossen hast, kannst du dich mit vorläufigen Login-Daten anmelden, um zu testen, ob deine Enginsight Instanz wie gewünscht funktioniert. Passe danach die Login-Daten an.

Nimm dazu folgende Schritte vor:

{% stepper %}
{% step %}

### Docker-Container auflisten

Liste mit folgendem Befehl alle Docker-Container auf, um die ID des Containers `server-m2` zu erhalten:

```
sudo docker ps
```

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

{% step %}

### Container-ID einsetzen

Kopiere die ID des Docker-Containers `server-m2` und setze sie in folgenden Befehl ein:

```
sudo docker logs <ContainerID>
```

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

{% step %}

### Initiale Login-Daten erhalten

Nun werden dir die Login-Daten für die Erstanmeldung an der Enginsight Plattform angegeben.

<div align="left"><figure><img src="/files/LqJdLeCOrazCr3dr69ei" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
**Bitte beachte**: Wir empfehlen dringend, die initialen Login-Daten an einem sicheren Ort abzuspeichern.
{% endhint %}
{% endstep %}

{% step %}

### An der Enginsight Plattform anmelden

1. Rufe die Enginsight Benutzeroberfläche mit der App-URL auf, die du auch im Setup-Skript angegeben hast: `https://<DomainApp>`

{% hint style="warning" %}
**Bitte beachte**: Solltest du die [Verschlüsselung per HTTPS](/docs/manual/installation-und-konfiguration/installation-und-konfiguration/weitere-konfigurationen/verschlusselung-per-https.md) noch nicht durchgeführt haben, muss die App-URL mit `http://` beginnen.
{% endhint %}

2. Melde dich mit deinen initialen Login-Daten an.
   {% endstep %}

{% step %}

### Initiale Login-Daten ändern

{% hint style="danger" %}
**Bitte beachte**: Aus Sicherheitsgründen ist es unabdingbar, dass du die initialen Anmeldedaten direkt änderst, nachdem du dich das erste Mal an der Enginsight Plattform angemeldet hast!
{% endhint %}

1. Navigiere dazu in der Enginsight Plattform zu **Einstellungen** → **Benutzerkonto**.
2. Passe im Feld **E-Mail** die angegebene E-Mail-Adresse an und bestätige deine Eingabe mit **Änderungen speichern**.

<div align="left"><figure><img src="/files/kSbPXaBom6JZLWU8DMSO" alt="" width="563"><figcaption></figcaption></figure></div>

3. Erstelle im Bereich **Passwort** ein neues Passwort und bestätige deine Eingaben mit **Änderungen speichern**.

<div align="left"><figure><img src="/files/GnloPzhYNNNU9yxrMdVy" alt="" width="563"><figcaption></figcaption></figure></div>

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

***

## Nächste Schritte

Fahre nun mit der [Installation des Komponentenservers](/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-plattform/automatische-installation/komponentenserver.md) fort.

***

## Weitere Ressourcen

**Knowledge Base**

* [Wie setze ich die initialen Login-Daten für die Enginsight Plattform zurück?](https://docs.enginsight.com/docs/knowledge-base/datenbank/wie-setze-ich-die-initialen-login-daten-der-enginsight-plattform-zuruck)

***