Serveur HTTP Apache Version 2.4
Ce document explique l'installation, la configuration et le lancement d'Apache 2.0 sous Novell NetWare 6.0 et les versions ultérieures. Si vous trouvez une bogue, ou voulez tout simplement contribuer de quelque manière que ce soit, utilisez s'il vous plait notre page des rapports de bogues.
La page des rapports de bogues et la liste de diffusion dev-httpd ne doivent pas être utilisées pour poser des questions à propos de la configuration ou du lancement d'Apache. Avant de soumettre un rapport de bogue ou une question, consultez ce document, la FAQ ou tout autre sujet de la documentation en rapport avec votre problème. Si vous n'avez toujours pas résolu votre problème, postez votre question dans le newsgroup novell.devsup.webserver, où de nombreux utilisateurs d'Apache sont prêts à répondre à toutes les nouvelles et obscures questions à propos de l'utilisation d'Apache sous Netware.
Dans la majeure partie de ce document, vous êtes sensé avoir installé Apache à partir d'une distribution binaire. Si vous voulez compiler Apache vous-même (par exemple pour aider au développement, ou pour rechercher des bogues), reportez-vous à la section traitant de la Compilation d'Apache pour Netware ci-dessous.
Apache 2.0 nécessite NetWare 6.0 service pack 3 et supérieurs pour fonctionner. Si vous utilisez un service pack antérieur à SP3, vous devez installer les dernières Bibliothèques Netware pour C (LibC).
Vous trouverez les service packs Netware ici.
Apache 2.0 pour NetWare peut aussi fonctionner dans un environnement NetWare 5.1, à partir du moment où le dernier service pack ou la dernière version des Bibliothèques Netware pour C (LibC) ont été installés. ATTENTION : Apache 2.0 pour NetWare n'a pas été testé dans cet environnement car il n'a pas été conçu pour ce dernier.
Les informations à propos de la dernière version d'Apache sont disponibles sur le site web d'Apache à http://www.apache.org/. Vous y trouverez la version courante, des versions alpha ou bêta-test plus récentes, ainsi que des sites miroirs et des sites FTP anonymes. Les distributions binaires des dernières versions d'Apache 2.0 pour NetWare sont disponibles ici.
Il n'existe pas actuellement de programme d'installation d'Apache pour Netware. Si vous installez Apache 2.0 pour NetWare à partir des sources, vous devrez copier les fichiers sur le serveur manuellement.
Suivez ces instructions pour installer Apache sous Netware à
partir de la distribution binaire (en supposant que vous effectuez
l'installation dans sys:/apache2
) :
SYS:
(vous pouvez cependant l'installer dans
tout volume)apache2.conf
et définissez les
directives ServerRoot
et
ServerName
avec les valeurs
correctes des chemins de fichiers qui correspondent à la
configuration de votre serveur.SYS:/APACHE2
au chemin de recherche, par
une commande du style : SEARCH ADD
SYS:\APACHE2
Suivez ces instructions pour installer Apache pour Netware
manuellement à partir de votre propre répertoire de sources (en
supposant que vous effectuez l'installation dans
sys:/apache2
) :
Apache2
dans un volume Netware.APACHE2.NLM
, APRLIB.NLM
dans
SYS:/APACHE2
.BIN
dans
SYS:/APACHE2
.HTDIGEST.NLM
, HTPASSWD.NLM
,
HTDBM.NLM
, LOGRES.NLM
,
ROTLOGS.NLM
dans SYS:/APACHE2/BIN
.CONF
dans
SYS:/APACHE2
.HTTPD-STD.CONF
dans le
répertoire SYS:/APACHE2/CONF
et renommez-le en
HTTPD.CONF
.MIME.TYPES
,
CHARSET.CONV
et MAGIC
dans le répertoire
SYS:/APACHE2/CONF
.\HTTPD-2.0\DOCS\ICONS
dans
SYS:/APACHE2/ICONS
.\HTTPD-2.0\DOCS\MANUAL
dans
SYS:/APACHE2/MANUAL
.\HTTPD-2.0\DOCS\ERROR
dans
SYS:/APACHE2/ERROR
.\HTTPD-2.0\DOCS\DOCROOT
dans
SYS:/APACHE2/HTDOCS
.SYS:/APACHE2/LOGS
sur le
serveur.SYS:/APACHE2/CGI-BIN
sur le
serveur.SYS:/APACHE2/MODULES
et
copiez tous les modules nlm dans le répertoire
modules
.HTTPD.CONF
, et recherchez
toutes les marques @@Value@@
afin de les remplacer
par les valeurs appropriées.SYS:/APACHE2
au chemin de recherche, par
une commande du style : SEARCH ADD
SYS:\APACHE2
Outre le volume par défaut SYS
, Apache peut être
installé dans tout autre volume.
Au cours du processus d'installation, l'ajout du mot-clé
"install" à la ligne de commande du makefile va provoquer la
construction d'une distribution complète sous forme d'un paquetage
dans le sous-répertoire DIST
. Vous pouvez simplement
installer Apache en copiant la distribution créée précédemment à la
racine d'un volume Netware (voir Compilation
d'Apache pour NetWare ci-dessous).
Pour démarrer Apache, tapez simplement apache
dans
la console. Ceci aura pour effet de charger Apache dans l'espace
d'adressage du système d'exploitation. Si vous préférez charger
Apache dans un espace d'adressage protégé, vous pouvez spécifier cet
espace d'adressage à l'aide de l'instruction de chargement suivante
:
load address space = apache2 apache2
Cette instruction va charger Apache dans un espace d'adressage appelé apache2. Il est possible d'exécuter plusieurs instances simultanées d'Apache sous Netware, en chargeant chacune d'entre elles dans son propre espace d'adressage protégé.
Une fois démarré, Apache écoute le port 80 (à moins que vous
n'ayez modifié la directive Listen
dans les fichiers de
configuration). Pour vous connecter au serveur et afficher la page
par défaut, lancez un navigateur et entrez le nom du serveur ou son
adresse IP. Vous devriez voir une page de bienvenue, et un lien vers
le manuel Apache. Si rien ne se produit, ou si vous obtenez un
message d'erreur, consultez le fichier error_log
dans
le répertoire logs
.
Lorsque votre installation de base fonctionne, vous devez la
configurer correctement en éditant les fichiers du répertoire
conf
.
Pour arrêter une instance d'Apache s'exécutant dans l'espace d'adressage du système d'exploitation, entrez simplement dans la console :
unload apache2
ou
apache2 shutdown
Si Apache s'exécute dans un espace d'adressage protégé, spécifiez cet espace d'adressage dans l'instruction d'arrêt :
unload address space = apache2 apache2
Lorsqu'on travaille avec Apache, il est important de savoir comment il trouve ses fichiers de configuration. Vous pouvez spécifier un fichier de configuration sur la ligne de commande de deux manières :
-f
spécifie un chemin vers un fichier de
configuration particulier
apache2 -f "vol:/nom-serveur/conf/fich-conf.conf"
apache -f test/test.conf
Dans ces cas, la directive ServerRoot
doit être correctement définie
dans le fichier de configuration.
Si vous ne spécifiez pas de nom de fichier de configuration avec
l'option -f
, Apache utilisera le nom de fichier codé en
dur dans le serveur, en général conf/apache2.conf
.
L'invocation d'Apache avec l'option -V
indiquera ce nom
comme valeur de l'étiquette SERVER_CONFIG_FILE
. Apache
va ensuite déterminer son ServerRoot
en effectuant les tests
suivants, dans cet ordre
ServerRoot
via une option
-C
switch.-d
.La racine du répertoire d'installation codée en dur dans le
serveur est en général sys:/apache2
. L'invocation
d'Apache avec l'option -V
indiquera ce chemin comme
valeur de l'étiquette HTTPD_ROOT
.
Apache 2.0 pour Netware comporte un jeu d'options de ligne de
commande permettant d'afficher ou de modifier certaines
caractéristiques de l'instance du serveur web en cours d'exécution.
Ces options ne sont disponibles que lorsqu'Apache est en cours
d'exécution. Chacune de ces options doit être précédée du mot-clé
APACHE2
.
Par défaut, ces options sont passées à l'instance d'apache s'exécutant dans l'espace d'adressage du système d'exploitation. Pour passer une option à une instance d'Apache spécifique s'exécutant dans un espace d'adressage protégé, ajouter le paramètre -p suivi du nom de l'espace d'adressage. Pour plus d'informations, tapez "apache2 Help" sur la ligne de commande.
Apache lit en général ses fichiers de configuration dans le
répertoire conf
. Ces fichiers sont les mêmes que ceux
de la version Unix, mais quelques directives sont différentes sous
Netware. Voir la Documentation Apache pour
l'ensemble des directives disponibles.
Les principales différences propres à Apache pour NetWare sont :
Comme Apache pour Netware est une a