Manuel utilisateur
Version 1.9 — Rev. 3

# Serveur - General

Reglages generaux pour l'ensemble du serveur. Lorsqu'un reglage requiert des informations de chemin, celui-ci peut etre absolu ou relatif a $SERVER_ROOT. $SERVER_ROOT est l'emplacement ou le serveur web LiteSpeed a ete installe (par exemple your_home_dir/lsws ou /opt/lsws). L'executable du serveur se trouve sous $SERVER_ROOT/bin.

### Nom du serveur

#### Description

Nom unique pour ce serveur. S’il est vide, le hostname du serveur sera utilise par defaut.

### Nombre de workers

#### Description

Indique le nombre de workers httpd.

#### Syntaxe

Valeur entiere entre 1 et 16.

#### Conseils

Performance Definissez un nombre adapte a vos besoins. Ajouter plus de workers ne signifie pas necessairement de meilleures performances.

### Execute en tant que

#### Description

Indique l’utilisateur/groupe sous lequel le processus serveur s’execute. Cela est defini avec les parametres "--with-user" et "--with-group" lors de l’execution de la commande configure avant l’installation. Pour reinitialiser ces valeurs, vous devez relancer configure et reinstaller.

#### Appliquer

Réinstallation requise.

#### Conseils

Security Le serveur ne doit pas s’executer avec un utilisateur privilegie tel que "root". Il est essentiel que le serveur soit configure pour s’executer avec une combinaison utilisateur/groupe non privilegiee sans acces login/shell. Un utilisateur/groupe nobody est generalement un bon choix.

### Priorite

#### Description

Indique la priorite des processus serveur. La valeur va de -20 a 20. Un nombre plus faible signifie une priorite plus elevee.

#### Syntaxe

Nombre entier

#### Conseils

Performance En general, une priorite plus elevee offre des performances web legerement meilleures sur un serveur charge. Ne definissez pas une priorite superieure a celle des processus de base de donnees.

#### Voir aussi

External App Priorite, Priorité CGI

### Affinite CPU

#### Description

L’affinite CPU lie un processus a un ou plusieurs CPU (coeurs). Il est avantageux qu’un processus utilise toujours le meme CPU, car il peut alors utiliser les donnees restees dans le cache CPU. Si le processus passe a un autre CPU, le cache CPU n’est pas utilise et une surcharge inutile est requise.
Le parametre Affinite CPU controle combien de CPU (coeurs) seront associes a un processus serveur. La valeur minimale est 0, ce qui desactive cette fonction. La valeur maximale est le nombre de coeurs du serveur. En general, 1 est le meilleur parametre, car il cree l’utilisation la plus stricte de l’affinite CPU et exploite donc au mieux le cache CPU.
Valeur par defaut: 0

#### Syntaxe

Valeur entiere de 0 a 64. (0 desactivera cette fonction)

#### Appliquer

Réinstallation requise.

### CloudLinux

#### Description

Indique s’il faut activer Lightweight Virtual Environment (LVE) de CloudLinux lorsqu’il existe. Vous pouvez utiliser LiteSpeed avec LVE pour obtenir une meilleure gestion des ressources. Pour plus d’informations, consultez http://www.cloudlinux.com.

#### Syntaxe

Sélectionner dans la liste déroulante

### Taille du buffer E/S en memoire

#### Description

Indique la taille maximale du buffer utilise pour stocker le corps de requete et sa reponse generee dynamiquement. Lorsque cette limite est atteinte, le serveur commence a creer des fichiers temporaires de swapping sous Repertoire de swapping.

#### Syntaxe

Nombre entier

#### Conseils

Performance Definissez une taille de buffer assez grande pour accueillir toutes les requetes/reponses concurrentes et eviter le swapping de la memoire vers le disque. S’il y a une activite E/S frequente dans le repertoire swap, par defaut /tmp/lshttpd/swap/, cette taille de buffer est trop basse et LiteSpeed swappe vers le disque.

#### Voir aussi

Repertoire de swapping

### Repertoire de swapping

#### Description

Indique le repertoire ou les fichiers de swapping doivent etre places. Lorsque le serveur demarre en mode chroot, ce repertoire est relatif au nouveau repertoire racine; sinon il est relatif au repertoire racine reel.
Le serveur utilise sa propre memoire virtuelle pour reduire l’utilisation de la memoire systeme. La memoire virtuelle et le disk swapping servent a stocker de grands corps de requete et des reponses generees dynamiquement. Le repertoire de swapping doit etre place sur un disque avec assez d’espace.
Valeur par defaut: /tmp/lshttpd/swap

#### Syntaxe

Chemin absolu

#### Conseils

Performance Placez le repertoire de swapping sur un disque separe ou augmentez la taille du buffer E/S en memoire pour eliminer le swapping.

#### Voir aussi

Taille du buffer E/S en memoire

### Corriger automatiquement l’erreur 503

#### Description

Indique s’il faut essayer de corriger l’erreur "503 Service Unavailable" en redemarrant le serveur de facon graceful. Une erreur "503" est generalement causee par des applications externes defectueuses et un redemarrage du serveur web peut souvent corriger temporairement l’erreur. Si cette option est activee, le serveur redemarrera automatiquement lorsqu’il y aura plus de 30 erreurs "503" en 30 secondes.
Valeur par defaut: No

#### Syntaxe

Sélectionner avec les boutons radio

### Activer HTTP/2 sur TCP non chiffre

#### Description

Indique s’il faut activer HTTP/2 sur les connexions TCP non chiffrees. La valeur par defaut est desactivee.

#### Syntaxe

Sélectionner avec les boutons radio

### Timeout de redemarrage graceful (s)

#### Description

Pendant un redemarrage graceful, meme apres le demarrage de la nouvelle instance serveur, l’ancienne instance continuera a traiter les requetes existantes. Ce timeout definit combien de temps l’instance precedente attend avant de sortir. La valeur par defaut est 300 secondes. -1 signifie attendre indefiniment. 0 signifie ne pas attendre et abandonner immediatement.

#### Syntaxe

Nombre entier

### Repertoire de sortie des statistiques

#### Description

Le repertoire ou le fichier de rapport Real-Time Stats sera ecrit. Le repertoire par defaut est /tmp/lshttpd/ .

#### Syntaxe

Chemin absolu

#### Conseils

Information Pendant le fonctionnement du serveur, le fichier .rtreport sera ecrit chaque seconde. Pour eviter les ecritures disque inutiles, definissez ceci sur un RAM Disk.
Le fichier .rtreport peut etre utilise avec des logiciels de surveillance tiers pour suivre la sante du serveur.

### Produire des rapports JSON

#### Description

Produit des fichiers de rapport supplementaires au format JSON, avec l’extension .json, dans le repertoire /tmp/lshttpd.
Valeur par defaut: No

#### Syntaxe

Sélectionner avec les boutons radio

#### Exemple

Lorsque la valeur est Yes, des fichiers .status.json et .rtreport.json, .rtreport.2.json, etc. seront crees en plus des fichiers habituels .status et .rtreport, .rtreport.2, etc.

#### Conseils

Information C’est utile pour les developpeurs d’applications qui souhaitent integrer les rapports d’etat et temps reel LiteSpeed dans leurs applications avec les outils standard de traitement JSON integres a la plupart des langages de programmation.

### Parametres MIME

#### Description

Indique le fichier contenant les parametres MIME pour ce serveur. Il est toujours relatif a la racine reelle lorsqu’un chemin absolu est donne en mode chroot. Cliquez sur le nom du fichier pour afficher/modifier les entrees MIME detaillees.

#### Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT.

#### Conseils

Information Cliquez sur le nom du fichier pour modifier les parametres MIME.

### Suffixes

#### Description

Vous pouvez lister plusieurs suffixes pour le meme type MIME, en les separant par des virgules.

### Type MIME

#### Description

Un type MIME se compose d’un type et d’un sous-type au format "type/subtype".

### Desactiver la rotation initiale des logs

#### Description

Indique s’il faut activer/desactiver la rotation du fichier journal d’erreurs du serveur au demarrage. La rotation initiale des logs est activee par defaut lorsque la valeur "Not Set" est utilisee.

#### Syntaxe

Sélectionner avec les boutons radio

### Signature du serveur

#### Description

Indique s’il faut afficher la signature du serveur et le numero de version dans la valeur "Server" de l’en-tete de reponse. Il y a trois options: avec Hide Version, seul LiteSpeed est affiche. Avec Show Version, LiteSpeed et le numero de version sont affiches. Avec Hide Full Header, l’en-tete Server complet ne sera pas affiche dans l’en-tete de reponse.

#### Syntaxe

Sélectionner dans la liste déroulante

#### Conseils

Security Definissez sur Hide Version si vous ne voulez pas exposer le numero de version du serveur.

### Activer la recherche GeoLocation

#### Description

Indique s’il faut activer/desactiver la recherche IP Geolocation. Peut etre defini aux niveaux serveur, hote virtuel ou contexte. IP Geolocation est desactivee par defaut lorsque la valeur "Not Set" est utilisee.

#### Syntaxe

Sélectionner avec les boutons radio

#### Voir aussi

Utiliser l’IP client dans l’en-tete, Chemin du fichier DB,

### Utiliser l’IP client dans l’en-tete

#### Description

Indique s’il faut utiliser la premiere adresse IP la plus valide listee dans l’en-tete de requete HTTP "X-Forwarded-For" pour toutes les fonctions liees aux adresses IP, y compris le throttling de connexion/bande passante, le controle d’acces et la geolocalisation IP.
Cette fonction est utile si votre serveur web se trouve derriere un load balancer ou un serveur proxy. Si vous selectionnez Trusted IP Only, l’IP X-Forwarded-For sera utilisee uniquement lorsque la requete provient d’IPs de confiance definies dans Liste autorisée au niveau serveur.
Keep Header from Trusted IP est identique a Trusted IP Only, mais l’en-tete X-Forwarded-For utilise pour le backend ne sera pas modifie pour inclure l’adresse du pair connecte.
Use Last IP (for AWS ELB) utilisera la derniere adresse IP de la liste "X-Forwarded-For". Selectionnez cette option si vous utilisez AWS Elastic Load Balancer ou si vous vous attendez a ce que l’IP reelle soit ajoutee a la fin de la liste "X-Forwarded-For".

#### Syntaxe

Sélectionner dans la liste déroulante

### Email administrateur

#### Description

Indique la ou les adresses email de l’administrateur du serveur. Si elles sont indiquees, les administrateurs seront avertis par email des evenements importants, par exemple lorsque le service LiteSpeed est redemarre automatiquement a cause d’une detection de crash ou lorsque la licence expire.

#### Syntaxe

Liste d’adresses email separees par des virgules.

#### Conseils

Information La fonction d’alerte email ne fonctionnera que si le serveur dispose d’un serveur MX actif tel que postfix, exim ou sendmail.

### Fichiers index

#### Description

Indique les noms des fichiers index qui seront recherches sequentiellement lorsqu’une URL est mappee vers un repertoire. Vous pouvez le personnaliser aux niveaux serveur, hote virtuel et contexte.

#### Syntaxe

Liste de noms de fichiers index separes par des virgules.

#### Conseils

Performance Ne definissez que les fichiers index dont vous avez besoin.

### Index automatique

#### Description

Indique s’il faut générer à la volée un index de répertoire lorsque les fichiers d’index listés dans Fichiers index ne sont pas disponibles dans un répertoire. Cette option est personnalisable au niveau hôte virtuel et contexte, et elle est héritée le long de l’arborescence de répertoires jusqu’à être explicitement remplacée. Vous pouvez personnaliser la page d’index générée. Consultez les How-tos du wiki en ligne.

#### Syntaxe

Sélectionner avec les boutons radio

#### Conseils

Security Il est recommandé de désactiver Index automatique partout où c’est possible afin d’éviter de révéler des données confidentielles.

#### Voir aussi

Fichiers index, URI d'index automatique

### URI d'index automatique

#### Description

Indique l’URI qui sera utilisée pour générer la page d’index lorsque les fichiers d’index listés dans Fichiers index ne sont pas disponibles dans un répertoire. LiteSpeed web server utilise un script externe pour générer la page d’index, ce qui offre une flexibilité de personnalisation maximale. Le script par défaut produit une page d’index ayant la même apparence que celle d’Apache. Pour personnaliser la page d’index générée, consultez les How-tos du wiki en ligne. Le répertoire à indexer est transmis au script via une variable d’environnement "LS_AI_PATH".

#### Syntaxe

URI

#### Voir aussi

Fichiers index, Index automatique

### Activer Expires

#### Description

Indique s’il faut generer un en-tete Expires pour les fichiers statiques. Si active, un en-tete Expires sera genere selon Expires par defaut et Expires par type.
Cela peut etre defini aux niveaux serveur, hote virtuel et contexte. Les parametres de niveau inferieur remplaceront ceux de niveau superieur, c’est-a-dire que les parametres de contexte remplaceront ceux de l’hote virtuel et les parametres de l’hote virtuel remplaceront ceux du serveur.

#### Syntaxe

Sélectionner avec les boutons radio

### Expires par defaut

#### Description

Indique les parametres par defaut pour la generation de l’en-tete Expires. Ce parametre prend effet lorsque Activer Expires est defini sur "Yes". Il peut etre remplace par Expires par type. Ne definissez pas ce defaut au niveau serveur ou hote virtuel sauf si necessaire, car il generera des en-tetes Expires pour toutes les pages. La plupart du temps, cela doit etre defini au niveau contexte pour certains repertoires qui ne changent pas souvent. S’il n’y a pas de parametre par defaut, aucun en-tete Expires ne sera genere pour les types non indiques dans Expires par type.

#### Syntaxe

A|Mseconds
Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees. Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier.

### Expires par type

#### Description

Indique les parametres d’en-tete Expires pour des types MIME individuels.

#### Syntaxe

Liste separee par des virgules de "MIME-type=A|Mseconds". Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees.
Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier. MIME-type accepte le caractere generique "*", comme image/*.

### Chargement automatique depuis .htaccess

#### Description

Charge automatiquement les regles rewrite contenues dans le fichier .htaccess d’un repertoire lors du premier acces a ce repertoire si aucun HttpContext utilisant la directive rewritefile n’existe deja pour ce repertoire. Une fois charge initialement, un redemarrage graceful doit etre effectue pour que tout changement ulterieur de ce fichier .htaccess prenne effet.
Le parametre de niveau Hote virtuel remplace le parametre de niveau Serveur. Valeurs par defaut:
Niveau serveur: No
Niveau VH: heriter du parametre de niveau Serveur

#### Syntaxe

Sélectionner avec les boutons radio

### Televersement de fichiers

#### Description

Fournit des fonctions de securite supplementaires lors du televersement de fichiers en utilisant un Request Body Parser pour analyser les fichiers vers un repertoire local du serveur, ou des modules tiers peuvent les analyser facilement a la recherche d'une intention malveillante. Request Body Parser est utilise lorsque Passer les donnees d’upload par chemin de fichier est active ou lorsqu'un module appelle set_parse_req_body de LSIAPI au niveau LSI_HKPT_HTTP_BEGIN. Des exemples d'API sont fournis dans le paquet source.

#### Voir aussi

Priorité Hook::HTTP_BEGIN

### Chemin des fichiers temporaires

#### Description

Répertoire temporaire où les fichiers envoyés au serveur seront stockés pendant que l’analyseur du corps de requête fonctionne. La valeur par défaut est /tmp/lshttpd/.

#### Syntaxe

Chemin absolu ou chemin commençant par $SERVER_ROOT (pour les niveaux serveur et VHost) ou $VH_ROOT (pour les niveaux VHost).

### Permission de fichier temporaire

#### Description

Détermine les permissions de fichier utilisées pour les fichiers stockés dans le répertoire temporaire. Le réglage au niveau serveur est global et peut être remplacé au niveau VHost.

#### Syntaxe

Nombre octal à 3 chiffres. La valeur par défaut est 666.

### Passer les donnees d’upload par chemin de fichier

#### Description

Indique s’il faut ou non transmettre les donnees du fichier upload par chemin. Si active, le chemin du fichier avec d’autres informations est envoye au backend handler au lieu du fichier lui-meme lors de l’upload. Cela economise des ressources CPU et du temps de transfert, mais demande des mises a jour cote backend pour l’implementation. Si desactive, le contenu du fichier sera transfere au backend handler; le corps de requete reste parse en fichiers.

#### Syntaxe

Sélectionner avec les boutons radio

#### Conseils

Performance Activez ceci pour accelerer le traitement des uploads de fichiers si la compatibilite ascendante n’est pas un probleme.

### Base de donnees GeoIP MaxMind

#### Description

Plusieurs bases de donnees de geolocalisation MaxMind peuvent etre specifiees ici. MaxMind propose les types de DB suivants: Country, Region, City, Organization, ISP et Netspeed. Si plusieurs bases de donnees de types "Country", "Region" et "City" sont configurees, la derniere configuration sera effective.

### Chemin du fichier DB

#### Description

Indique le chemin vers la base de donnees GeoIP MaxMind.

#### Syntaxe

Chemin absolu

#### Exemple

/usr/local/share/GeoIP/GeoLite2-Country.mmdb

### Nom de DB

#### Description

Nom de la base de donnees GeoIP MaxMind. Depuis GeoIP2, ce parametre est requis.
Lors d’une mise a niveau de GeoIP vers GeoIP2, utiliser les valeurs "COUNTRY_DB", "CITY_DB" ou "ASN_DB" pour ce parametre remplira automatiquement la variable PHP $_SERVER avec certaines entrees compatibles GeoIP (listees ci-dessous par valeur DB Name) afin de faciliter cette transition.
CITY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', 'GEOIP_COUNTRY_CONTINENT', 'GEOIP_DMA_CODE', 'GEOIP_METRO_CODE', 'GEOIP_LATITUDE', 'GEOIP_LONGITUDE', 'GEOIP_POSTAL_CODE' et 'GEOIP_CITY'.
COUNTRY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', et 'GEOIP_COUNTRY_CONTINENT'.
ASN_DB: 'GEOIP_ORGANIZATION' et 'GEOIP_ISP'.

#### Exemple

COUNTRY_DB

### Variables d’environnement

#### Description

Assigne les resultats des recherches de base de donnees a des variables d’environnement.

#### Syntaxe

Variable_Name mapped_DB_data
Une entree par ligne. Le chemin vers les donnees peut utiliser des cles de map ou des index de tableau bases sur 0, separes par /.

#### Exemple

COUNTRY_CODE COUNTRY_DB/country/iso_code
REGION_CODE CITY_DB/subdivisions/0/iso_code

### Chemin du fichier DB IP2Location

#### Description

Emplacement d’un fichier de base de donnees valide.

#### Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT.

### Type de cache DB

#### Description

La methode de cache utilisee. La valeur par defaut est Memory.

#### Syntaxe

Sélectionner dans la liste déroulante