Automatische Installation
Last updated
Last updated
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.
Laden Sie das Enginsight Debian-Image herunter.
Erstellen Sie drei virtuelle Maschinen mit den in den Anforderungen definierten Werten für CPU, RAM und Massenspeicher.
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.
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.
Booten Sie den Datenbank-Server mit dem Enginsight Debian-Image und wählen Sie auf der Startseite den entsprechenden Server aus.
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.
Wählen Sie die gewünschte Sprache, Ihren Standort und das Layout Ihrer Tastatur aus.
Das Setup beginnt nun automatische Informationen über das Netzwerk abzurufen. Dies kann kurz dauern, warten Sie bis alles geladen hat.
Vergeben Sie einen Rechnername, wir empfehlen „ngs-db“ für den Datenbankserver und „ngs-app“ für den App Server.
Richten Sie anschließend Ihr Netzwerk ein. Geben Sie hierfür Ihren vollständigen Domain-Namen an, bspw. firma.de.
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.
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.
Richten Sie nun Ihren neuen Benutzer ein.
Geben Sie den Namen Ihres Kontos an.
Speichern Sie sich Ihre Eingaben in einem Passwortmanager.
Vergeben Sie anschließend ein Passwort für den neu angelegten Benutzer.
Bestätigen Sie Ihr zuvor gewähltes Passwort durch erneute Eingabe.
Wählen Sie die zu partitionierende Festplatte.
Vergewissern Sie sich hier noch einmal, dass die von Ihnen gewählte Festplatte den Anforderungen entsprechend ausreichend groß ist.
Das Basissystem und weitere Komponenten werden installiert, haben sie einen kurzen Moment Geduld.
Nach Abschluss der Installationen und Konfiguration erhalten Sie diese Info. Starten Sie anschließend Ihr System neu.
Achten Sie darauf, dass nicht erneut das Installations-Image geladen wird, sondern Debian.
Ab diesem Punkt der Installation können Sie die Installation optional über SSH fortsetzen.
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.
Legen Sie nun fest, ob Sie TLS und rollenbasierte Zugangskontrollen aktivieren wollen. Wir empfehlen dies ausdrücklich.
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.
Ü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.
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.
Damit ist die Installation und Konfiguration Ihres Datenbank-Servers abgeschlossen.
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.
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.
Melden Sie sich mit Ihren Zugangsdaten in der Docker Registry an.
Die Zugangsdaten für die Docker Registry erhalten Sie von uns.
Nachdem Sie sich in der Docker Registry angemeldet haben, haben Sie bitte etwas Geduld in der die Enginsight Images heruntergeladen werden.
Lesen Sie den Endbenutzer Lizenzvertrag und bestätigen Sie anschließend Ihre Zustimmung mit einem: "y".
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.
Nachdem alle Eingaben korrekt eingegeben wurden, startet die Initialisierung. Beachten Sie, dass dies etwas Zeit in Anspruch nehmen kann.
Folgen Sie abschließend unserer Empfehlung und passen Sie die Konfiguration, wie angegeben an, um den Zugriff per HTTPS zu aktivieren.
Sobald die Installation abgeschlossen ist, können Sie mit den vorläufigen Login-Daten anmelden. Diese erhalten Sie folgendermaßen:
Kopieren Sie die ID des Moduls server-m2
Die Anmeldedaten für die Erstanmeldung werden Ihnen nun ausgegeben. Speichern Sie sich den initialen Login ab!
Ä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.
ACHTUNG!
Ohne abgeändertes und gespeichertes Passwort bzw. gespeichertes Initialpasswort verlieren Sie den Zugriff auf die Enginsight Plattform. Nutzen Sie einen Passwortmanager.
Damit ist die Installation und Konfiguration Ihres App-Servers abgeschlossen.
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:
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.
Um Enginsight OnPremises nutzen zu können, benötigen Sie ein Lizenzfile. Nehmen Sie mit uns Kontakt auf, um ein Lizenzpaket zu erwerben: hello@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, was Sie bezüglich der Lizenz beachten müssen.
