Skip to main content

KeyHelp Installation

NachUm AusführungKeyHelp deszu Befehlsinstallieren, wirdreicht der Aufruf eines einzelnen Befehls, anschließend werden Sie KeyHelpvom Assistenten durch die Installation führen.geführt. DanachWährend der Installation werden alle notwendigen Dienste installiert und konfiguriert, so dass Sie sich um nichts weiter kümmern müssen. Nach Abschluss der Installation können Sie Ihr neues Server-Management-Tool sofort uneingeschränktmit nutzen.der Administration ihres Servers beginnen.


 

Systemvoraussetzungen

  • Betriebssystem: Ubuntu LTS oder Debian
  • Arbeitsspeicher: Mindestens 1 GB RAM
  • Architektur: 64-Bit Betriebssystem (amd64 oder arm64)
  • Die Installation muss auf einem sauberen System (Minimal-Image), frei von installierter / vorkonfigurierter Software erfolgen. Sämtliche benötigten Dienste werden durch KeyHelp installiert und konfiguriert.
  • Die Installation muss als root-Benutzer erfolgen.


Installation von KeyHelp

  1. Verbinden Sie sich über SSH als Benutzer root mit ihrem Server.
  2. Führen Sie den folgenden Befehl über die Kommandozeile aus

    wget https://install.keyhelp.de/get_keyhelp.php -O install_keyhelp.sh ;
bash install_keyhelp.sh ;

  3. preinstallerDie ....Installation wird nun vorbereitet und der Installationsassistent gestartet.
    Hier haben Sie nun die Möglichkeit diverse Installationsparameter anzupassen.
  4. Bestätigen Sie den Beginn der Installation über den Menüpunkt Installation starten.
  5. ScreenshotNach vomAbschluss Menü mit einstellungsmöglichkeiten
  6. Installation läuft... 
  7. Im Anschluss an dieder Installation wird ihr System neu gestartet,gestartet. anschließend
    Jetzt sind alle Arbeiten abgeschlossen und sie können Sie sofort mit der Administration ihres KeyHelp serversKeyHelp-Servers beginnen.

Sie finden die Zugangsdaten für ihren primären Administrator-Account und der Datenbank-Administrationssoftware in der Datei /root/keyhelp_login_data_*.

Wenn Sie die Meldung FEHLER: Dem Zertifikat von »install.keyhelp.de« wird nicht vertraut. erhalten, stehen Ihnen verschiedene Möglichkeiten der Problemlösung zur Verfügung:

- Fügen Sie dem wget Befehl den Parameter --no-check-certificate hinzu.
- Installieren Sie das Paket ca-certificates mit dem Befehl apt install ca-certificates.
- Führen Sie den folgenden Befehl aus apt update && apt upgrade.

KeyHelp bietet keinen Uninstaller an.
Wenn Sie KeyHelp und die im Zuge der Installation konfigurierten Dienste entfernen möchten, müssen Sie Ihren Server manuell zurücksetzen.


Installation von KeyHelp automatisieren

Für eine Nicht-interaktive Steuerung der Installation über Scripte, bietet die KeyHelp-Installation folgende Parameter.

Parameter Bedeutung
--non-interactive Führt die Installation ohne Rückfragen und Benutzerinteraktion durch.
--no-reboot   Unterbindet den Reboot im Anschluss an die Installation.
--notification=<EMAIL ADDRESS> Sendet nach Abschluss der Installation eine E-Mail an die angegebene E-Mail-Adresse.
--language=<LANGUAGE_CODE> Legt die Standardsprache von KeyHelp und seiner Komponenten fest.
--extended-log  Protokolliert alles, auch sensible Daten wie Passwörter etc.
--preferred-protocol=<PROTOCOL>

Legt das bevorzugte Protokoll bei der Kommunikation mit den Installationsservern fest.

[ipv4 / ipv6 / none]
--hostname-fqdn=<SERVER_DOMAIN>

Der vollständig qualifizierte Domainname (FQDN).

Beispiel: 'keyhelp.example.com'
--server-fqdn=<SERVER_DOMAIN> Alias für --hostname-fqdn [Veraltet]
--admin-username=<USERNAME>

Login-Name für das KeyHelp-Administrator-Konto.
--admin-password=<PASSWORD> 

Passwort für das KeyHelp-Administrator-Konto.

Mindestens 6 Zeichen.
--admin-email=<EMAIL_ADDRESS> E-Mail-Adresse für das KeyHelp-Administrator-Konto.

 

Mit folgendem Befehl wird KeyHelp ohne Benutzerinteraktion installiert. Es wird darüber hinaus ein Administratorkonto mit dem Namen my-admin und dem Passwort my-password-123 angelegt. Im Anschluss an die Installation wird eine Email an info@example.com gesendet um über den Abschluss der Installation zu informieren.

wget https://install.keyhelp.de/get_keyhelp.php -O install_keyhelp.sh ;
bash install_keyhelp.sh --non-interactive --admin-username="my-admin" --admin-password="my-password-123" --notification="info@example.com";


Fehlersuche & FehlerbehebungInstallationsprotokoll

Alle Aktionen während der Installation werden im Installationsprotokoll unter /var/log/keyhelp/install.log protokolliert.
Sollten wärendhrend der Installation Fehler auftreten, werdenkann dieseder imFehler-verursachende InstlallationsprotokollBefehl, untersowie

etwaige

/var/log/keyhelp/install.log

Ursachen

hinterlegt.anhand

dieses

Protokolls ermittelt werden. Durchsuchen Sie hierzu die genannte Datei nach dem Schlüsselwort ERROR DETECTED. 

Dort sehen Sie mit SKIPPED DUE PREVIOUS ERRORS] nicht ausgeführte Befehle.
Durch beheben der fehlerursache und anschließendem ausführen der mittels SKIPPED markeierten Einträgen können Sie somit KeyHelp installation korrigieren.

Back to top