LiteSpeed Web Server logo LiteSpeed Web Server-Benutzerhandbuch
Startseite

Installation/Deinstallation


Minimale Systemanforderungen

  • Betriebssystem:
    • Linux: Kernel 3.0+
    • CentOS: 7+
    • Ubuntu: 18.04+
    • Debian: 9+
    • FreeBSD: 12.0+
  • CPU:
    • Intel: x86-64
    • ARM: aarch64 (nur Linux)
  • Speicher: 512MB und mehr
  • Festplatte:
    • Installation: 200MB
    • Laufzeit: 300MB und mehr, Auslagerungsspeicher hangt von der Nutzung ab.

Hinweis: LSWS-Lizenzen mit RAM-Begrenzung werden bei der Verwendung eines LXC-Containers (einschliesslich Proxmox) nicht empfohlen. LiteSpeed verwendet sysinfo(), um die Speichergrusse zu erkennen. Daher kann die RAM-Grenze bei der Verwendung eines LXC-Containers erreicht werden, da dieser die Speichergrusse des Hosts zuruckgibt. Bei Lizenzen mit unbegrenztem RAM besteht dieses Problem nicht.


Installation


Die Installation muss in einem Befehlszeilenterminal durchgefuhrt werden. Zu Testzwecken kann LiteSpeed Web Server von einem nicht privilegierten Benutzer in einem Home-Verzeichnis installiert werden. Fur den Produktionseinsatz sollte es in einem Systemverzeichnis installiert werden.


Unter Mac OS X ist der Root-Benutzer standardmassig deaktiviert. Er kann uber eine Reihe von Schritten aktiviert werden, die auf der Apple-Website beschrieben sind. Sie konnen auch den sudo-Befehl verwenden, um LSWS in ein Systemverzeichnis zu installieren, ohne den Root-Benutzer zu aktivieren. Systemordner bleiben jedoch weiterhin nur fur den Root-Benutzer beschreibbar. Das bedeutet, dass Sie jedes Mal, wenn Sie LSWS uber die Befehlszeile steuern mochten (zum Beispiel beim Starten oder Stoppen von LSWS), den sudo-Befehl verwenden mussen.


Installationsschritte

  1. Paket an einen passenden Ort entpacken:
    tar xvfz lsws-xxxx.tar.gz oder gunzip -c lsws-xxxx.tar.gz | tar xvf -
  2. Testlizenzschlussel oder Seriennummer installieren:
    • Testlizenz:

      Eine Testlizenz dient nur Evaluierungszwecken und ist nur 15 Tage nach dem Download gultig. Eine Testlizenz kann uber die Download-Seite angefordert werden.

      Ein Testlizenzschlussel wird Ihnen als Anhang in einer Bestatigungs-E-Mail zugesandt. Speichern Sie den Anhang als trial.key und kopieren Sie ihn in das Installationsverzeichnis.

      Wenn Sie von einer Testlizenz auf eine Produktivlizenz wechseln, konnen Sie das Installationsskript nach den folgenden Schritten zur Aktualisierung der Lizenz einfach erneut ausfuhren.

    • Produktivlizenz:
      1. Lizenzen konnen im LiteSpeed-Store gemietet oder gekauft werden.
      2. Eine Seriennummer wird Ihnen per Bestatigungs-E-Mail zugesandt, sobald Ihre Bestellung erfolgreich bearbeitet wurde. Jede Seriennummer erlaubt eine Installation auf einem Server.
      3. Speichern Sie die Seriennummer als serial.no im Installationsverzeichnis (wo sich install.sh befindet). Der LiteSpeed-Produktregistrierungsserver verwendet diese Datei, um wahrend des Installationsvorgangs Ihren Lizenzschlussel abzurufen.

  3. Wechseln Sie in das Installationsverzeichnis cd lsws-xxxx und fuhren Sie den Befehl ./install.sh aus. Dadurch wird das LiteSpeed-Installationsprogramm gestartet.

    Beachten Sie, dass Sie den Server nur dann in ein Systemverzeichnis installieren konnen, wenn Sie diesen Befehl als Benutzer "root" ausfuhren. Andere Benutzer sollten ihn an einem Ort innerhalb ihres Home-Verzeichnisses installieren.

    Mac-OS-X-Benutzer konnen den Server mit dem Befehl sudo ./install.sh in ein Systemverzeichnis installieren.

  4. Lesen Sie die Endbenutzer-Lizenzvereinbarung und geben Sie "Yes" ein, um Ihre Zustimmung zu bestatigen.
  5. Geben Sie das Verzeichnis an, in dem Sie LiteSpeed Web Server installieren mochten. Fur den Root-Benutzer ist der Standardwert /usr/local/lsws. Fur nicht privilegierte Benutzer ist der Standardwert ihr Home-Verzeichnis. Denken Sie daran, dass nicht privilegierte Benutzer den Server nicht in ein Systemverzeichnis installieren konnen.
  6. Lizenzanforderung erzeugen.

    Wenn das Installationsprogramm nur eine Seriennummer, aber keinen gultigen Lizenzschlussel findet, fordert es Sie auf, eine Lizenzanforderung zu erzeugen. Das Installationsprogramm kommuniziert mit dem LiteSpeed-Produktregistrierungsserver und ruft automatisch einen gultigen Lizenzschlussel ab. Nach Erhalt des Lizenzschlussels geht es zum nachsten Schritt weiter. Falls dies fehlschlagt, beendet sich das Installationsprogramm und hinterlasst eine Lizenzanforderungsdatei.

    Falls der automatische Vorgang fehlschlagt, konnen Sie im Kundenbereich des Online-Shops ein Ticket bei der Lizenzabteilung erstellen.

    Hinweis: Die Installation wird nur fortgesetzt, wenn eine gultige Testlizenz oder ein gultiger Lizenzschlussel vorhanden ist.

  7. Folgen Sie den Anweisungen auf dem Bildschirm. Das Installationsprogramm fordert Sie auf, Folgendes festzulegen:
    1. Wenn bereits eine vorherige Installation vorhanden ist, fordert das Installationsprogramm Sie auf, zwischen Upgrade, Neuinstallation oder Verzeichniswechsel zu wahlen. Bei einem Upgrade bleiben Ihre aktuellen Konfigurationen erhalten.
    2. Administrator-Benutzername und -Passwort fur die WebAdmin-Konsole.
    3. Welches Control Panel Sie gegebenenfalls mit LSWS verwenden werden.
    4. Benutzer und Gruppe, unter denen der Serverprozess ausgefuhrt wird.
    5. TCP-Port fur den normalen Webdienst.
    6. TCP-Port fur die WebAdmin-Konsole.
    7. Ob LiteSpeed PHP eingerichtet werden soll.
    8. Der Root-Benutzer hat die Moglichkeit, chroot zu aktivieren. Das Installationsprogramm richtet die anfngliche chroot-Umgebung automatisch ein. Chroot ist eine erweiterte Funktion, und Ihr CGI kann ohne Anpassung der Konfiguration fehlschlagen. Wir empfehlen dringend, chroot nicht zu aktivieren, wenn Sie damit nicht vertraut sind. Sie konnen es spater jederzeit durch ein Upgrade aktivieren.

    Abschliessend fragt das Installationsprogramm, ob Sie das AWStats-Zusatzmodul installieren mochten, um Ihre Webstatistiken zu verfolgen. Der Root-Benutzer kann ausserdem auswahlen, LiteSpeed Web Server beim Systemstart automatisch als Dienst auszufuhren. Danach ist die Installation abgeschlossen, und das Installationsprogramm kann den Server starten.


Installation testen

  1. Ausfuhrliche Informationen zur Steuerung der Serverprozesse finden Sie im Verwaltungshandbuch. Zum Starten des Servers fuhren Sie einfach [your_install_dir]/bin/lswsctrl start aus.

  2. Um auf Ihre Website zuzugreifen, rufen Sie im Browser http://[address]:8088/ auf. Dabei ist [address] die IP-Adresse oder der Domainname Ihres Webserver-Rechners. Verwenden Sie "localhost", wenn der Server auf dem gerade verwendeten Rechner lauft. "8088" ist der Standardport. Wenn Sie den Port wahrend der Installation geandert haben, verwenden Sie den von Ihnen festgelegten Port. Im Browser sollte eine Begrussungsseite geladen werden. Falls nicht, versuchen Sie es mit der WebAdmin-Konsole.

  3. Der Standardport fur die WebAdmin-Konsole ist 7080. Geben Sie https://[address]:7080/ in Ihren Browser ein, um die WebAdmin-Konsole zu offnen. (Wenn Sie den Port fur die WebAdmin-Konsole wahrend der Installation geandert haben, verwenden Sie stattdessen diesen Port.) Denken Sie daran, dass Sie fur [address] "localhost" verwenden konnen, wenn Sie den Rechner benutzen, auf dem der Server lauft. Die Begrussungsseite der WebAdmin-Konsole sollte nun geladen werden. Klicken Sie auf den Link "Log on" und melden Sie sich mit dem bei der Installation angegebenen Administrator-Benutzernamen und Passwort an. Ausfuhrliche Informationen zur Konfiguration finden Sie in unserem Konfigurationshandbuch, oder klicken Sie oben auf einer beliebigen Seite auf den Link "help".

  4. Wenn Ihr Server eine Firewall verwendet, stellen Sie sicher, dass localhost vertrauenswurdig ist. Unter Linux mit IPTables sollte zum Beispiel eine Regel ALLOW INPUT from LO vorhanden sein.

  5. Wenn Ihre Website und die WebAdmin-Konsole nicht erreichbar sind, sehen Sie bitte im Fehlerprotokoll nach: [your_install_dir]/logs/error.log
    • Wenn ein TCP-Portkonflikt mit anderen Serveranwendungen besteht, sollte der Webserver mit einem verfugbaren Port neu installiert werden.
      Mit dem folgenden Befehl kann ein verfugbarer Port ermittelt werden:
      netstat -an | grep XXXX
      XXXX ist eine Portnummer. Wenn der Port verfugbar ist, erzeugt der Befehl keine Ausgabe.
    • Wenn das Auslagerungsverzeichnis nicht beschreibbar ist, konnen Sie dem Benutzer, unter dem der Webserver lauft, Schreibrechte fur das Auslagerungsverzeichnis geben oder das Auslagerungsverzeichnis manuell andern. Das Auslagerungsverzeichnis wird in der XML-Konfigurationsdatei des Servers unter [your_install_dir]/conf/httpd_config.xml konfiguriert, der Standardwert ist /tmp/lshttpd/swap. Suchen Sie nach <swappingDir>.

Wenn Sie weiterhin Probleme mit der Installation haben, lesen Sie bitte in unserem Wiki nach oder veroffentlichen Sie Ihr Problem in unserem Support-Forum.


Upgrade

Es gibt einige Szenarien, in denen Sie den Server aktualisieren oder upgraden mussen:


  • Eine neue Version ist verfugbar
  • Upgrade von einer Testlizenz auf eine Produktivlizenz
  • Upgrade/Downgrade auf eine andere Produktivlizenz.

Es gibt mehrere Moglichkeiten fur ein Upgrade. Eine davon ist, einfach install.sh erneut auszufuhren und bei Aufforderung "Upgrade" auszuwahlen. Ihre aktuelle Konfiguration bleibt erhalten.


Die Versionsverwaltung kann auch uber die WebAdmin-Konsole unter Actions - Version Management erfolgen. Dort werden alle installierten Versionen und verfugbaren neuen Releases aufgelistet. Sie konnen eine neue Version installieren oder durch Klicken auf den entsprechenden Link zwischen verschiedenen Versionen wechseln. LSWS verfugt ausserdem uber einen integrierten Update-Agenten, der regelmassig nach neuen Releases sucht und E-Mail-Benachrichtigungen sendet.


Mit dem Befehlszeilentool lsup.sh konnen Sie auf die neueste Version upgraden, eine Neuinstallation erzwingen oder auf eine alte Version zuruckgehen. Detaillierte Nutzungsinformationen finden Sie unter [your_install_dir]/admin/misc/lsup.sh --help


Es konnen mehrere Versionen von LiteSpeed Web Server installiert werden. Mit dem Dienstprogramm zur Versionsverwaltung konnen Sie einfach zwischen den Versionen wechseln: [your_install_dir]/admin/misc/mgr_ver.sh.


  • Um zu einer bereits installierten Version zu wechseln, zum Beispiel 6.3.5, fuhren Sie einfach [your_install_dir_current_version]/admin/misc/mgr_ver.sh 6.3.5

  • Um zuvor installierte Dateien fur eine bestimmte Version zu entfernen, zum Beispiel 6.3.5, fuhren Sie einfach [your_install_dir_current_version]/admin/misc/mgr_ver.sh -d 6.3.5

Wenn Sie Ihre Lizenz upgraden (zum Beispiel von einer Testlizenz auf eine Produktivlizenz), konnen Sie serial.no manuell in das Verzeichnis [your_install_dir]/conf/ kopieren und anschliessend neu starten.