Ctrlk
WebsiteLoginKostenloser TestzugangCommunity
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Applikationsserver

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

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.

Installation des Applikationsservers

1

Vorbereitende Schritte ausführen

Achte darauf, dass du vor der Installation die vorbereitenden Schritte korrekt ausgeführt hast.

2

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.

Wie du ein virtuelles Informationsmedium startest und auswirfst, hängt von deinem verwendeten Hypervisor ab.

Es erscheint nun für einige Augenblicke ein blauer Bildschirm. Dies ist ein korrektes Verhalten, daher kannst du einfach abwarten.

3

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.

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.

4

Rechnernamen angeben

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

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.

Bestätige deine Eingabe mit Weiter und der Enter-Taste.

5

Domain-Namen angeben

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

Frage bei deinem Netzwerkadministrator nach, wenn du dir unsicher bist, wie der Domain-Name deines Unternehmens lautet.

Bestätige deine Eingabe mit Weiter und der Enter-Taste.

6

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.

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

  • Keine Angabe von Benutzer, Passwort und Port: http://<IPAdresseHost>/

  • Angabe von Benutzer und Passwort, keine Angabe eines Ports: http://<Benutzername>:<Passwort>@<IPAdresseHost>/

  • Angabe von Benutzer, Passwort und Port: http://<Benutzername>:<Passwort>@<IPAdresseHost>:8080/

Bitte beachte: Der letzte Slash / muss zwingend gesetzt werden!

Bestätige deine Eingabe mit der Enter-Taste.

7

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.

Der standardmäßig von uns angegebene Benutzerkonto-Name lautet Enginsight APP.

Bestätige deine Eingabe mit Weiter und der Enter-Taste.

8

Benutzername angeben

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

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

Der standardmäßig von uns angegebene Benutzername lautet ngsapp.

9

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.

  1. Bestätige deine Eingabe mit Weiter und der Enter-Taste.

  2. 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.

Bitte beachte: Wir empfehlen dringend, Benutzername und Passwort für den Applikationsserver in einem Passwort-Manager zu speichern!

10

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.

11

Installation abschließen

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

Bestätige die Information Installation abgeschlossen mit Weiter und der Enter-Taste.

12

Virtuelles Informationsmedium auswerfen

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

Wie du ein virtuelles Informationsmedium startest und auswirfst, hängt von deinem verwendeten Hypervisor ab.

Setup des Applikationsservers

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

ngs-app steht dabei für den Rechnernamen, den du bei der Installation für den Applikationsserver vergeben hast.

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

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.

1

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.

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.

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

2

Bei der Enginsight Docker Registry anmelden

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

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.

  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.

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.

3

Enginsight Images für die Docker-Container herunterladen

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

4

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.

Bitte beachte: Die Aktivierung dieser Einstellung wird von uns ausdrücklich empfohlen!

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.

5

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.

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

6

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.

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:

Option
Beschreibung

Enter MongoDB URI

Gib die URI der MongoDB-Instanz, auf der die Enginsight Datenbank läuft, in folgendem Format an: mongodb://mongoDefaultUser:<PasswortMongoDB>@<IPAdresseDatenbankserver>:27017/enginsight?authSource=enginsight&replicaSet=rs0

Vergiss nicht, <PasswortMongoDB> und <IPAdresseDatenbankserver> entsprechend zu ersetzen.

Das Passwort für die MongoDB findest du auch im Verzeichnis /home/ngsapp/mongoDefaultUserPassword.

Enter Redis URI

Gib die URI des Remote Dictionary Servers (Redis) in folgendem Format an, falls du diesen verwendest: redis://redis:<RedisPortnummer>

Vergiss nicht, <RedisPortnummer> entsprechend zu ersetzen.

Enter APP URL

Gib die URL, unter der die Enginsight Benutzeroberfläche aufgerufen werden kann, in folgendem Format an: http://<IPAdresseApplikationsserver> oder http://<DomainApp>

Vergiss dabei nicht, <IPAdresseApplikationsserver> und <DomainApp> entsprechend zu ersetzen.

Enter API URL

Gib die URL, unter der die Enginsight API erreicht werden kann, in folgendem Format an: http://<IPAdresseApplikationsserver>:8080 oder http://<DomainAPI>:8080

Vergiss dabei nicht, <IPAdresseApplikationsserver> und <DomainAPI> entsprechend zu ersetzen.

7

Initialisierung der Docker-Container starten

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

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

8

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.

Bitte beachte: Wir empfehlen aus Sicherheitsgründen dringend, den Zugriff per HTTPS zu aktivieren!

Nutze die Anleitung in folgendem Kapitel, um eine gesicherte Verbindung per HTTPS zu aktivieren: Verschlüsselung per HTTPS.

9

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.

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.

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:

1

Docker-Container auflisten

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

Bestätige deine Eingabe mit der Enter-Taste.

2

Container-ID einsetzen

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

Bestätige deine Eingabe mit der Enter-Taste.

3

Initiale Login-Daten erhalten

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

Bitte beachte: Wir empfehlen dringend, die initialen Login-Daten an einem sicheren Ort abzuspeichern.

4

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>

Bitte beachte: Solltest du die Verschlüsselung per HTTPS noch nicht durchgeführt haben, muss die App-URL mit http:// beginnen.

  1. Melde dich mit deinen initialen Login-Daten an.

5

Initiale Login-Daten ändern

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!

  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.

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

Bitte beachte: Wir empfehlen, Benutzername und Passwort für die Enginsight Plattform in einem Passwort-Manager zu speichern!

Nächste Schritte

Fahre nun mit der Installation des Komponentenservers fort.

Weitere Ressourcen

Knowledge Base

VorherigeDatenbankserver
NächsteKomponentenserver

Zuletzt aktualisiert

War das hilfreich?