LiteSpeed Web Server logo Manuel utilisateur LiteSpeed Web Server
Accueil

Installation/Desinstallation


Configuration systeme minimale

  • Systeme d'exploitation :
    • Linux : noyau 3.0+
    • CentOS : 7+
    • Ubuntu : 18.04+
    • Debian : 9+
    • FreeBSD : 12.0+
  • CPU :
    • Intel : x86-64
    • ARM : aarch64 (Linux uniquement)
  • Memoire : 512MB et plus
  • Disque :
    • Installation : 200MB
    • Execution : 300MB et plus, l'espace d'echange depend de l'utilisation.

Remarque : Les licences LSWS limitees en RAM ne sont pas recommandees lors de l'utilisation d'un conteneur LXC (y compris Proxmox). LiteSpeed utilise sysinfo() pour detecter la taille de la memoire. Vous pouvez donc atteindre la limite de RAM lors de l'utilisation d'un conteneur LXC, car celui-ci renvoie la taille de la memoire de l'hote. Ce probleme n'existe pas avec les licences a RAM illimitee.


Installation


L'installation doit etre effectuee dans un terminal en ligne de commande. A des fins de test, LiteSpeed Web Server peut etre installe dans un repertoire personnel par un utilisateur non privilegie. Pour une utilisation en production, il doit etre installe dans un repertoire systeme.


Sous Mac OS X, l'utilisateur root est desactive par defaut. Il peut etre active en suivant une serie d'actions detaillees sur le site Apple. Vous pouvez egalement utiliser la commande sudo pour installer LSWS dans un repertoire systeme sans activer l'utilisateur root, mais les dossiers systeme resteront modifiables uniquement par l'utilisateur root. Cela signifie qu'a chaque fois que vous voudrez controler LSWS depuis le terminal (par exemple pour le demarrer ou l'arreter), vous devrez utiliser la commande sudo.


Etapes d'installation

  1. Decompressez le paquet dans un emplacement approprie :
    tar xvfz lsws-xxxx.tar.gz ou gunzip -c lsws-xxxx.tar.gz | tar xvf -
  2. Installez la cle de licence d'essai ou le numero de serie :
    • Licence d'essai :

      Une licence d'essai est destinee a l'evaluation et n'est valable que pendant 15 jours apres le telechargement. Une licence d'essai peut etre demandee depuis la page de telechargement.

      Une cle de licence d'essai vous sera envoyee en piece jointe dans un e-mail de confirmation. Veuillez enregistrer la piece jointe sous le nom trial.key et la copier dans le repertoire d'installation.

      Lorsque vous passez d'une licence d'essai a une licence de production, vous pouvez simplement relancer le script d'installation apres avoir suivi les etapes ci-dessous pour mettre a jour votre licence.

    • Licence de production :
      1. Les licences peuvent etre louees ou achetees dans la boutique LiteSpeed.
      2. Un numero de serie vous sera envoye dans l'e-mail de confirmation une fois que votre commande aura ete correctement traitee. Chaque numero de serie permet une installation sur un seul serveur.
      3. Enregistrez le numero de serie sous serial.no dans le repertoire d'installation (ou se trouve install.sh). Le serveur d'enregistrement des produits LiteSpeed utilisera ce fichier pour recuperer votre cle de licence pendant le processus d'installation.

  3. Accedez au repertoire d'installation cd lsws-xxxx et executez la commande ./install.sh. Cela demarrera l'installateur LiteSpeed.

    Notez que seul l'utilisateur "root" peut installer le serveur dans un repertoire systeme. Les autres utilisateurs doivent l'installer dans un emplacement situe dans leur repertoire personnel.

    Les utilisateurs de Mac OS X peuvent installer le serveur dans un repertoire systeme avec la commande sudo ./install.sh

  4. Lisez le contrat de licence utilisateur final et saisissez "Yes" pour confirmer votre accord.
  5. Indiquez le repertoire dans lequel vous souhaitez installer LiteSpeed Web Server. Pour l'utilisateur root, la valeur par defaut est /usr/local/lsws. Pour les utilisateurs non privilegies, la valeur par defaut est leur repertoire personnel. N'oubliez pas que les utilisateurs non privilegies ne pourront pas installer le serveur dans un repertoire systeme.
  6. Generer une demande de licence.

    Si l'installateur ne trouve qu'un numero de serie, mais aucune cle de licence valide, il vous proposera de generer une demande de licence. L'installateur communiquera avec le serveur d'enregistrement des produits LiteSpeed et obtiendra automatiquement une cle de licence valide. Une fois la cle obtenue, il passera a l'etape suivante. En cas d'echec, l'installateur quittera et laissera un fichier de demande de licence.

    Si le processus automatique echoue, vous pouvez creer un ticket aupres du service des licences depuis l'espace client de la boutique en ligne.

    Remarque : L'installation ne se poursuivra que si une licence d'essai ou une cle de licence valide est disponible.

  7. Suivez les instructions a l'ecran. L'installateur vous demandera de definir les elements suivants :
    1. Si une copie deja installee existe, l'installateur vous demandera de choisir entre mise a niveau, reinstallation ou changement de repertoire. La mise a niveau conservera vos configurations actuelles.
    2. Nom d'utilisateur et mot de passe de l'administrateur pour la console WebAdmin.
    3. Quel panneau de controle, le cas echeant, vous utiliserez avec LSWS.
    4. Utilisateur et groupe au nom desquels le processus serveur sera execute.
    5. Port TCP pour le service Web normal.
    6. Port TCP pour la console WebAdmin.
    7. Si vous souhaitez configurer LiteSpeed PHP.
    8. L'utilisateur root a la possibilite d'activer chroot. L'installateur configurera automatiquement l'environnement chroot initial. Chroot est une fonctionnalite avancee, et vos CGI peuvent echouer sans ajustements de configuration. Nous vous recommandons fortement de ne pas activer chroot si vous ne maitrisez pas cette fonctionnalite. Vous pourrez toujours l'activer plus tard lors d'une mise a niveau.

    Enfin, l'installateur vous demandera si vous souhaitez installer le module complementaire AWStats afin de suivre vos statistiques Web. L'utilisateur root peut egalement choisir d'executer automatiquement LiteSpeed Web Server en tant que service au demarrage du systeme. L'installation sera alors terminee, et l'installateur pourra demarrer le serveur.


Tester l'installation

  1. Pour des informations detaillees sur le controle des processus serveur, veuillez consulter le Guide d'administration. Pour demarrer le serveur, executez simplement [your_install_dir]/bin/lswsctrl start.

  2. Pour acceder a votre site, pointez votre navigateur vers http://[address]:8088/, [address] etant l'adresse IP ou le nom de domaine de votre machine serveur Web. Utilisez "localhost" si le serveur se trouve sur la machine que vous utilisez. "8088" est le port par defaut. Si vous avez modifie le port pendant l'installation, utilisez celui que vous avez choisi. Une page de felicitation devrait se charger dans le navigateur. Sinon, essayez la console WebAdmin.

  3. Le port par defaut de la console WebAdmin est 7080. Saisissez https://[address]:7080/ dans votre navigateur pour acceder a la console WebAdmin. (Si vous avez modifie le port de la console WebAdmin pendant l'installation, utilisez ce port.) N'oubliez pas que vous pouvez utiliser "localhost" pour [address] si vous utilisez la machine sur laquelle le serveur se trouve. La page d'accueil de la console WebAdmin devrait maintenant s'afficher. Cliquez sur le lien "Log on" et utilisez le nom d'utilisateur et le mot de passe administrateur indiques pendant l'installation pour vous connecter. Pour des informations detaillees sur la configuration, veuillez consulter notre Guide de configuration, ou cliquez sur le lien "help" en haut de n'importe quelle page.

  4. Si votre serveur utilise un pare-feu, assurez-vous que localhost est approuve. Par exemple, sous Linux avec IPTables, une regle ALLOW INPUT from LO doit etre presente.

  5. Si votre site Web et la console WebAdmin sont inaccessibles, consultez le journal d'erreurs : [your_install_dir]/logs/error.log
    • En cas de conflit de port TCP avec d'autres applications serveur, le serveur Web doit etre reinstalle avec un port disponible.
      La commande suivante peut etre utilisee pour trouver un port disponible :
      netstat -an | grep XXXX
      XXXX est un numero de port. Si le port est disponible, la commande ne produira aucune sortie.
    • Si le repertoire d'echange n'est pas accessible en ecriture, vous pouvez soit accorder les droits d'ecriture sur ce repertoire a l'utilisateur sous lequel le serveur Web s'execute, soit modifier manuellement le repertoire d'echange. Celui-ci est configure dans le fichier de configuration XML du serveur, situe dans [your_install_dir]/conf/httpd_config.xml, avec pour valeur par defaut /tmp/lshttpd/swap. Recherchez <swappingDir>.

Si vous rencontrez encore des problemes d'installation, consultez notre wiki ou publiez votre probleme sur notre forum d'assistance.


Mise a niveau

Plusieurs scenarios peuvent necessiter une mise a jour ou une mise a niveau du serveur :


  • Une nouvelle version est disponible
  • Passage d'une licence d'essai a une licence de production
  • Mise a niveau/retrogradation vers une autre licence de production.

Il existe plusieurs facons d'effectuer une mise a niveau. L'une d'elles consiste simplement a relancer install.sh et a selectionner "Upgrade" lorsqu'on vous le demande. Vos configurations actuelles seront conservees.


La gestion des versions peut egalement etre effectuee depuis la console WebAdmin, sous Actions - Version Management. Toutes les versions installees et les nouvelles versions disponibles y sont listees. Vous pouvez installer une nouvelle version ou passer d'une version a l'autre en cliquant sur le lien approprie. LSWS dispose egalement d'un agent de mise a jour integre qui verifie regulierement la disponibilite de nouvelles versions et envoie des notifications par e-mail.


Vous pouvez mettre a niveau vers la derniere version, forcer une reinstallation ou revenir a une ancienne version a l'aide de l'outil en ligne de commande lsup.sh. Voir les informations d'utilisation detaillees dans [your_install_dir]/admin/misc/lsup.sh --help


Plusieurs versions de LiteSpeed Web Server peuvent etre installees. Vous pouvez facilement passer d'une version a une autre a l'aide de l'utilitaire de gestion des versions : [your_install_dir]/admin/misc/mgr_ver.sh.


  • Pour passer a une version deja installee, par exemple 6.3.5, executez simplement [your_install_dir_current_version]/admin/misc/mgr_ver.sh 6.3.5

  • Pour supprimer les fichiers precedemment installes d'une version specifique, par exemple 6.3.5, executez simplement [your_install_dir_current_version]/admin/misc/mgr_ver.sh -d 6.3.5

Lorsque vous mettez a niveau votre licence (par exemple, d'une licence d'essai a une licence de production), vous pouvez copier manuellement serial.no dans le repertoire [your_install_dir]/conf/, puis redemarrer.