# Automatische Installation

Der einfachste Weg zur erfolgreichen Installation einer eigenen Enginsight On-Premises-Instanz funktioniert über das von uns vorbereitete Debian-Image. Im Installationsprozess werden bereits wichtige Konfigurationen automatisch vorgenommen oder interaktiv abgefragt.Im Anschluss wird die MongoDB initialisiert und der Datenbankzugriff automatisch abgesichert.

## Vorbereitungen

1. Laden Sie das [Enginsight Debian-Image](https://get.enginsight.com/isos/ngs-debian-amd64.iso) herunter.
2. Erstellen Sie drei virtuelle Maschinen mit den in den [Anforderungen](https://docs.enginsight.com/docs/on-premises/anforderungen) definierten Werten für CPU, RAM und Massenspeicher.

{% hint style="warning" %}
Für eine reibungslose automatische Installation ist es entscheidend, dass die Datenbank (DB) zuerst installiert wird! Es ist Ihnen möglich den App-Server bereits zu starten, um dessen IP-Adresse zu erhalten, danach sollten Sie jedoch das Skript erst weiter ausführen, nachdem die DB-Installation abgeschlossen ist.
{% endhint %}

## Erste Schritte

Die folgenden Schritte stimmen für die Installation der Datenbank und den App Server überein. Führen Sie diese aus und fahren Sie danach mit der passenden Anleitung fort.

1. Booten Sie den Datenbank-Server mit dem Enginsight Debian-Image und wählen Sie auf der Startseite den entsprechenden Server aus.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2F5MTsHtt3XKpckIhdH3ej%2Fimage.png?alt=media&#x26;token=fde19a02-19cd-46b0-a009-ae00c24cb941" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Nachdem Sie den DB-Server gewählt haben, erscheint für einige Augenblicke ein blauer Bildschirm. Dies ist ein korrektes Verhalten, **warten Sie einfach ab**.
{% endhint %}

2. Wählen Sie die gewünschte Sprache, Ihren Standort und das Layout Ihrer Tastatur aus.

{% hint style="info" %}
Das Setup beginnt nun automatische Informationen über das Netzwerk abzurufen. Dies kann kurz dauern, warten Sie bis alles geladen hat.
{% endhint %}

3. Vergeben Sie einen Rechnername, wir empfehlen „**ngs-db**“ für den Datenbankserver und „**ngs-app**“ für den App Server.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FElnteVVtuuDIW7v3FsCU%2Fimage.png?alt=media&#x26;token=e6a93952-c07d-4a72-b116-506dc5d46580" alt=""><figcaption></figcaption></figure>

4. Richten Sie anschließend Ihr Netzwerk ein. Geben Sie hierfür Ihren vollständigen Domain-Namen an, bspw. firma.de.&#x20;

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2F0Wr0MKZOn2qUuxhYeruO%2Fimage.png?alt=media&#x26;token=cfc35c63-a25f-4c59-b7d5-7e1cf5173682" alt=""><figcaption></figcaption></figure>

5. Sollten Sie einen HTTP-Proxy einsetzen, konfigurieren Sie die Proxy-Daten im Standardformat. Sollten Sie keinen Proxy benötigen, um das Internet zu erreichen, können Sie die Eingabe leer lassen.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FGnI0Xm19AfdKsD8wU7y6%2Fimage.png?alt=media&#x26;token=c54033ab-c574-4ca0-b8df-b5ce6b9a1b92" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Zum Beispiel:

* <http://1.2.3.4/>
* kein Nutzer / Passwort, kein Port
* <http://user:secret@1.2.3.4/>
* Nutzer / Passwort, kein Port
* <http://user:secret@1.2.3.4:8080/>
* Nutzer / Passwort und Port
* Der letzte Slash "/" muss zwingend gesetzt werden.
  {% endhint %}

6. Richten Sie nun Ihren neuen Benutzer ein.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FagXMkK3Ez7phGSlJHbie%2Fimage.png?alt=media&#x26;token=00322bc5-c3a4-45f6-aad6-6b3a4b697dea" alt=""><figcaption></figcaption></figure>

7. Geben Sie den Namen Ihres Kontos an.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FlC8LWl1sTFtZM3YVLRs2%2Fimage.png?alt=media&#x26;token=e7012e39-4ecf-4c9d-aa5c-ae71c696674b" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Speichern Sie sich Ihre Eingaben in einem Passwortmanager.
{% endhint %}

8. Vergeben Sie anschließend ein Passwort für den neu angelegten Benutzer.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FEEJ3Lavd15AyfEFOCwfk%2Fimage.png?alt=media&#x26;token=3b12aa3f-efc0-4bab-ac05-377f93999f6e" alt=""><figcaption></figcaption></figure>

9. Bestätigen Sie Ihr zuvor gewähltes Passwort durch erneute Eingabe.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FKQh2eDaDw1BFWjkfbasu%2Fimage.png?alt=media&#x26;token=0d236779-a08a-4e02-b17e-caab46a76b84" alt=""><figcaption></figcaption></figure>

10. Wählen Sie die zu partitionierende Festplatte.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FVl8TAKvJiWRhEwD0IDI2%2Fimage.png?alt=media&#x26;token=9b6e0e86-a971-4aba-913c-574022013b75" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Vergewissern Sie sich hier noch einmal, dass die von Ihnen gewählte Festplatte den [Anforderungen](https://docs.enginsight.com/docs/on-premises/anforderungen) entsprechend ausreichend groß ist.
{% endhint %}

**Das Basissystem und weitere Komponenten werden installiert, haben sie einen kurzen Moment Geduld.**

11. Nach Abschluss der Installationen und Konfiguration erhalten Sie diese Info. Starten Sie anschließend Ihr System neu.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2Fy34PAzm4qbkd1X52nmfu%2Fimage.png?alt=media&#x26;token=3db4a552-a002-4657-9a4d-d52ce8eb98fe" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Achten Sie darauf, dass **nicht erneut das Installations-Image** geladen wird, sondern Debian.
{% endhint %}

{% hint style="info" %}
Ab diesem Punkt der Installation können Sie die Installation optional über SSH fortsetzen.
{% endhint %}

## DB Server

1. Loggen Sie sich anschließend auf Ihrer VM neu ein. Nutzen Sie dafür den zuvor vergegebenen Rechnernamen und das festgelegte Passwort. Da das Skript Root-Rechte benötigt, müssen Sie Ihr Passwort zwei Mal eingeben.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2F5idO3IEQq6KLiln5Mz4A%2FDB%2013.png?alt=media&#x26;token=9a597cbb-84df-4f15-8aa9-086e377650b8" alt=""><figcaption></figcaption></figure>

2. Legen Sie nun fest, ob Sie TLS und rollenbasierte Zugangskontrollen aktivieren wollen. Wir empfehlen dies ausdrücklich.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2F7jBy15oeGXdnBtvn0LUD%2Fimage.png?alt=media&#x26;token=e035ad07-567f-4115-bef2-bc3cab20f8e3" alt=""><figcaption></figcaption></figure>

3. Jetzt werden Sie aufgefordert die IP-Adresse Ihres App-Servers einzugeben. Starten Sie nun parallel die Einrichtung Ihres App Servers, um seine IP-Adresse abzufragen.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2F9y6r924pa0cJ9YlQfxoo%2Fimage.png?alt=media&#x26;token=ed7c3a2c-8ee4-414e-b542-a4cf6c4cbba1" alt=""><figcaption></figcaption></figure>

4. Überprüfen Sie anschließend, ob die richtige IP-Adresse des Datenbankservers erkannt wurde, die vom App-Server erreichbar ist. Akzeptieren Sie die IP-Adresse oder geben Sie bei einer Abweichung die entsprechende IP-Adresse ein.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FoIslPc8rVDivyMUgsqW4%2Fimage.png?alt=media&#x26;token=d71ed051-cec7-4e8c-8ec8-0c5e9ead5811" alt=""><figcaption></figcaption></figure>

5. Anschließend werden Ihre TLS-Zertifikate ausgestelt, TLS aktiviert, die MongoDB initialisiert, ein neuer Nutzer erstellt sowie Ihr Datenbankzugriff abgesichert.

   Nun werden Zertifikate auf den App-Server kopiert. Geben Sie hierfür den Benutzernamen Ihres App-Servers an und bestätigen Sie die Verbindung zum Host. Anschließend werden Sie mehrmals dazu aufgefordert das Passwort des App-Servers einzugeben.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2Fatv3ydD4rXVQZWViV5B3%2Fimage.png?alt=media&#x26;token=2df7718c-23ed-4fab-8e82-f10fac752f67" alt=""><figcaption></figcaption></figure>

**Damit ist die Installation und Konfiguration Ihres Datenbank-Servers abgeschlossen.**

{% hint style="warning" %}
Wir empfehlen Ihnen, das Authentifizierungsverfahren für den SSH-Zugriff abzuändern, sobald Sie Enginsight produktiv einsetzen. Nutzen Sie eine Public-Key-Authentifizierung anstatt der Anmeldung über Benutzernamen und Passwort.
{% endhint %}

## App Server

1. Loggen Sie sich anschließend auf Ihrer VM neu ein. Nutzen Sie dafür den zuvor vergegebenen Rechnernamen und das festgelegte Passwort. Da das Skript Root-Rechte benötigt, müssen Sie Ihr Passwort zwei Mal eingeben.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2Feocw30uyqulqk0uo9Cr1%2FApp%2014.png?alt=media&#x26;token=3b8e67dc-ab19-4ba8-84f9-9d60f83efde3" alt=""><figcaption></figcaption></figure>

2. Melden Sie sich mit Ihren Zugangsdaten in der Docker Registry an.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FI6OeB4LrsQs8KX03Gdre%2Fimage.png?alt=media&#x26;token=1785fa69-ec6d-4665-a35d-3277bbfb75a5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Die Zugangsdaten für die Docker Registry erhalten Sie von uns.
{% endhint %}

3. Nachdem Sie sich in der Docker Registry angemeldet haben, haben Sie bitte etwas Geduld in der die Enginsight Images heruntergeladen werden.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FaQhDxAedlENDWmGldPNH%2Fimage.png?alt=media&#x26;token=f1526de4-6c2b-45d3-9380-d5ef21990ded" alt=""><figcaption></figcaption></figure>

4. Lesen Sie den Endbenutzer Lizenzvertrag und bestätigen Sie anschließend Ihre Zustimmung mit einem: "**y**".

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FsQS33emloZwrAAQHdmNG%2Fimage.png?alt=media&#x26;token=62073fb4-9a48-4461-b7a7-2960a452e102" alt=""><figcaption></figcaption></figure>

5. In den folgenden Schritten werden Sie aufgefordert die MongoDB URI, Redis URI, App URL und die API URL einzugeben. Hier finden Sie bereits eine Eingabe, prüfen Sie diese und bestätigen Sie dies für jede Abfrage.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2F87rjqIDCJUCt1472OSUe%2F7.png?alt=media&#x26;token=55e8012a-db9d-4e3d-901b-26e6d3318cf7" alt=""><figcaption></figcaption></figure>

6. Nachdem alle Eingaben korrekt eingegeben wurden, startet die Initialisierung. Beachten Sie, dass dies etwas Zeit in Anspruch nehmen kann.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2Fe0UkHfAd3CIC98IBbePx%2Fimage.png?alt=media&#x26;token=8cc52324-d34e-4fde-b5e7-8767276a1e91" alt=""><figcaption></figcaption></figure>

7. Folgen Sie abschließend unserer Empfehlung und passen Sie die Konfiguration, wie angegeben an, um den Zugriff per HTTPS zu aktivieren.

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FLSs7M250nJyACXndfU8V%2Fimage.png?alt=media&#x26;token=f8811f1c-d4af-40ca-bee5-3ea8896c6e8c" alt=""><figcaption></figcaption></figure>

8. Sobald die Installation abgeschlossen ist, können Sie mit den vorläufigen Login-Daten anmelden. Diese erhalten Sie folgendermaßen:

   ```
   sudo docker ps
   ```

   \
   Kopieren Sie die ID des Moduls server-m2

   ```
   sudo docker logs <ID einsetzen>
   ```

   \
   Die Anmeldedaten für die Erstanmeldung werden Ihnen nun ausgegeben. **Speichern Sie sich den initialen Login ab!**

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FuvkgtDTLYqS4hODtzaOO%2Fimage%20(11).png?alt=media&#x26;token=0b1ebf45-91f0-4ecb-b49b-d1e9c7952fa4" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Ändern Sie den initialen Login-Daten unmittelbar, nachdem Sie sich das erste Mal angemeldet haben.**

Gehen Sie dazu unter *Einstellungen* → *Benutzerkonto*. Passen Sie in den *persönlichen Angaben* Ihre E-Mail-Adresse an und vergeben Sie unter *Passwort* ein neues Passwort.
{% endhint %}

{% hint style="danger" %}
**ACHTUNG!**&#x20;

Ohne *abgeändertes und gespeichertes Passwort* bzw. *gespeichertes Initialpasswort* verlieren Sie den Zugriff auf die Enginsight Plattform. Nutzen Sie einen Passwortmanager.
{% endhint %}

**Damit ist die Installation und Konfiguration Ihres App-Servers abgeschlossen.**

## Component Server

Folgen Sie den Anleitungen der Basisinstallation und installieren Sie die Softwarekomponenten Observer, Watchdog und Hacktor. Dazu brauchen Sie nichts weiter tun, als die entsprechenden Installationsskripte auszuführen, die Sie in der Enginsight Plattform finden.

Eine detaillierte Anleitung erhalten Sie hier:

* [Observer installieren](https://docs.enginsight.com/docs/bedienung/plattform/endpunkte#observer-hinzufuegen)
* [Watchdog installieren](https://docs.enginsight.com/docs/bedienung/plattform/discoveries#watchdog-hinzufuegen)
* [Hacktor installieren](https://docs.enginsight.com/docs/bedienung/plattform/penetrationstests#hacktors)

{% hint style="warning" %}
Wir empfehlen Ihnen, das Authentifizierungsverfahren für den SSH-Zugriff abzuändern, sobald Sie den Server produktiv einsetzen. Nutzen Sie eine Public-Key-Authentifizierung anstatt der Anmeldung über Benutzernamen und Passwort.
{% endhint %}

## Lizenzfile kaufen und einspielen

Um Enginsight OnPremises nutzen zu können, benötigen Sie ein Lizenzfile. Nehmen Sie mit uns Kontakt auf, um ein Lizenzpaket zu erwerben: <insidesales@enginsight.com>

Das Lizenzfile können Sie unter *Einstellungen* → *Lizenz* einspielen.

Wollen Sie mit Enginsight mehrere Organisationen verwalten und die Mandantenfähigkeit nutzen? [Hier erfahren Sie,](https://docs.enginsight.com/docs/on-premises/konfiguration/lizenzen-und-organisationen) was Sie bezüglich der Lizenz beachten müssen.