Return-Path: Mailing-List: contact apache-docs-help@apache.org; run by ezmlm Delivered-To: mailing list apache-docs@apache.org Received: (qmail 11392 invoked from network); 18 Feb 2001 14:49:05 -0000 Received: from front4m.grolier.fr (195.36.216.54) by h31.sny.collab.net with SMTP; 18 Feb 2001 14:49:05 -0000 Received: from hd (nas20-4.kdl.club-internet.fr [213.44.18.4]) by front4m.grolier.fr (8.9.3/No_Relay+No_Spam_MGC990224) with SMTP id PAA01116 for ; Sun, 18 Feb 2001 15:48:19 +0100 (MET) Message-ID: <003101c099bb$13374fe0$04122cd5@hd> From: "Herve Dumont" To: References: <167000000.982502417@antigone.dyn.logilune.com> Subject: Re: Invoking.html.fr and server-wide.html.fr Date: Sun, 18 Feb 2001 15:57:03 +0100 MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_NextPart_000_002A_01C099C3.6FE93200" X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.00.2919.6600 X-Mimeole: Produced By Microsoft MimeOLE V5.00.2919.6600 X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N ------=_NextPart_000_002A_01C099C3.6FE93200 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 8bit Maybe invoking.html should be renamed to invoking.html.en and added an invoking.html.html. Here is again : httpd-docs-2.0/manual/upgrading.html.fr, httpd-docs-1.3/manual/install.html.fr and httpd-docs-1.3/manual/index.html.fr Thanks Herv� ----- Message d'origine ----- De : "Eric Cholet" � : Envoy� : dimanche 18 f�vrier 2001 14:20 Objet : Re: Invoking.html.fr and server-wide.html.fr > On 02/18/01 10:52:19 +0100 Herve Dumont mumbled: > > Two new submissions > > httpd-docs-1.3/htdocs/manual/invoking.html.fr and > > httpd-docs-1.3/htdocs/manual/server-wide.html.fr > > Hi Herv�, great work, I just committed them with minor editing (a few > spelling mistakes). > > > Maybe someone could commit my previous submissions if there is > > no comments about htem. > > AFAIK they've all been committed, if that's not the case can you > resubmit them and I'll commit them asap. > > Thanks, > -- > Eric > B995 E519 1594 10D0 4271 1EA5 8DF3 8004 > > --------------------------------------------------------------------- > To unsubscribe, e-mail: apache-docs-unsubscribe@apache.org > For additional commands, e-mail: apache-docs-help@apache.org > ------=_NextPart_000_002A_01C099C3.6FE93200 Content-Type: text/html; name="index.html.fr" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="index.html.fr" Documentation du serveur HTTP Apache version = 1.3

FAQ

Directives

Modules

Rechercher

Serveur HTTP Apache version 1.3

Notes sur cette version

Nouvelles fonctionnalités de la = version 1.3

Migrer vers la version 1.3

License Apache

Manuel de référence

Compilation et installation

Démarrage

Arr=EAt et redémarrage

Directives de configuration de = l'exécution

Modules: par type or=20 par ordre alphabétique

Support des Objets partagés dynamiques = (DSO)

L'API Apache

Notes liées aux plates-formes

TPF

=09

Utilisation du serveur HTTP Apache

Fichiers de configuration

Configuration globale du serveur

H=F4tes virtuels

Inclusion côté serveur (SSI)

Contenu dynamique avec les CGI

Handlers

Négotiation de contenu

Variables d'environnement

Using SetUserID Execution for CGI

Aides sur les performances = générales

Trucs sur la = sécurité

Guide de réécriture = d'URLs

Autres sujets

Foires aux questions

Tutoriels

Autres notes

------=_NextPart_000_002A_01C099C3.6FE93200 Content-Type: text/html; name="install.html.fr" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="install.html.fr" Compilation et installation d'Apache

Compilation et installation d'Apache 1.3

Ce document décrit la compilation et l'installation d'Apache = sur les systèmes Unix, en employant la compilation et l'installation = manuelle. Si vous souhaitez utiliser l'interface de configuration semblable = à autoconf, il est conseillé de lire plutot le fichier INSTALL situé = dans la racine des fichiers sources de la distribution d'Apache. Pour compiler et = installer Apache sur d'autres plates-formes, consultez

Téléchargement d'Apache

Les informations sur la dernière version d'Apache se trouvent sur = le serveur web d'Apache à l'adresse=20 http://www.apache.org/. =20 Ce site réunit la version actuelle, les récentes versions beta, ainsi que la liste des sites miroirs web et ftp anonymes.

Si vous avez téléchargé une distribution = composée des binaires, passez directement à l'installation d'Apache.=20 Sinon lisez la section suivante afin de savoir comment compiler le = serveur.

Compilation d'Apache

La compilation d'Apache se compose de trois =E9tapes : la s=E9lection = des modules que vous souhaitez inclure dans le serveur;=20 la cr=E9ation de la configuration pour votre système = d'exploitation;=20 la compilation les sources pour créer les exécutables.

La configuration d'Apache s'effectue dans le répertoire = src de la distribution. Entrez dans ce répertoire.

Sélection des modules à compiler dans Apache d=E9finis = dans le=20 fichier Configuration. Décommentez les lignes = correspondant aux modules que vous souhaitez inclure (parmi les lignes = commençant par AddModule situées à la fin du fichier), ou ajoutez de = nouvelles lignes correspondant à des modules additionnels que vous avez=20 téléchargés ou écrits. (Voir API.html comme documentation = préliminaire à l'écriture de modules Apache). Des utilisateurs avertis peuvent commenter certains des modules actifs = par défaut si ils sont surs qu'ils n'en ont pas besoin (il faut néanmoins = faire attention, car la plupart des modules actifs par défaut sont vitaux au bon fonctionnement et à la sécurité du serveur).
Vous pouvez également lire les instructions contenues dans le = fichier Configuration afin de savoir si devez activer certaines = lignes commençant par Rule.
Cr=E9ation de la configuration pour votre système = d'exploitation.=20 Normalement vous n'avez qu'à exécuter le script = Configure comme décrit ci-dessous. Cependant si le script échoue ou = si vous avez des besoins particuliers (par exemple inclure une librairie = nécessaire à un module optionnel) vous devrez modifier une ou plusieurs de = options contenues dans le fichier Configuration : =20 EXTRA_CFLAGS, LIBS, LDFLAGS, INCLUDES.
Lancement du script Configure :
```
    % Configure
    Using 'Configuration' as config file
     + configured for <whatever> platform
     + setting C compiler to <whatever> *
     + setting C compiler optimization-level to <whatever> *
     + Adding selected modules
     + doing sanity check on compiler and options
    Creating Makefile in support
    Creating Makefile in main
    Creating Makefile in os/unix
    Creating Makefile in modules/standard
   
```
(*: selon le fichier Configuration et votre système, Configure peut ne pas afficher ces lignes).
Ceci crée un fichier Makefile qui sera utilisé lors de = l'étape=20 trois. Il crée également un fichier Makefile dans le = répertoire=20 support, pour compiler les programmes optionnels d'assistance.=20
(Si vous souhaitez maintenir différentes configurations, = Configure accepte une option lui disant de lire un autre fichier de = configuration, comme : Configure -file Configuration.ai).
Compilation des sources.=20 Tapez :
```
make
```

Les modules contenus dans la distribution Apache sont ceux que nous = avons=20 testés et qui ont été utilisés par = plusieurs membres de l'équipe de d=E9veloppement d'Apache. Les modules additionnels proposés par les membres ou d'autres parties = correspondant à des besoins ou des fonctions spécifiques sont = disponibles à l'adresse <http://www.apache.org/dist/contrib/modules/>. Des instructions sont fournis sur cette page pour lier ces modules au = noyau=20 d'Apache.

Installation d'Apache

Vous devez avoir un exécutable appelé httpd = dans le répertoire src. Une distribution des binaires doit = fournir ce fichier.

La prochaine =E9tape est d'installer le programme et de le configurer. = Apache est conçu pour être configuré et lancé à = partir du même groupe de répertoires où il a = été=20 compilé. Si vous souhaitez le lancer d'un autre emplacement,=20 créer un répertoire et copiez y les répertoires conf, logs et icons. Dans tous les cas lisez le document=20 trucs sur la = sécurité qui décrit comment affecter les droits sur le r=E9pertoire racine = du serveur.

L'étape suivante est la modification des fichiers de = configuration du serveur. Cela consiste à définir différentes directives dans les trois fichiers centraux de = configuration. Par défaut ces fichiers sont situés dans le = répertoire=20 conf et s'appellent srm.conf, access.conf et httpd.conf.=20 Pour vous aider, les mêmes fichiers existent dans le = répertoire conf de la distribution et sont appelés = srm.conf-dist, access.conf-dist et httpd.conf-dist.=20 Copiez ou renommez ces fichiers en supprimant le -dist pour = le nouveau nom. Ensuite éditez chacun de ces fichiers. Lisez attentivement = les=20 commentaires de chacun de ces fichiers. Une mauvaise configuration de = ces=20 fichiers empêcherait votre serveur de démarrer ou de ne pas = être sur. Vous devez =E9galement trouver dans le répertoire = conf un fichier mime.types. Généralement, ce fichier n'a pas besoin d'être = modifié.

Premièrement éditez le fichier httpd.conf. =20 Celui ci fixe les paramètres généraux du serveur :=20 le numéro de port, l'utilisateur qui l'exécute, etc.=20 Ensuite éditez le fichier srm.conf. Ce fichier = définit la racine de l'arborescence des documents, les fonctions = spéciales telles que les pages HTML dynamiques, l'analyse des imagemap, etc. Enfin, = éditez le fichier access.conf pour au moins définir les = schémas=20 d'accès de base.

En plus de ces trois fichiers, le comportement du serveur peut = être configuré dans chaque répertoire en utilisant les fichiers .htaccess pour les répertoires accédés = par=20 le serveur.

Définissez l'heure du système correctement!

Un bon fonctionnement d'un site web public nécessite une heure = juste, car des éléments du protocole HTTP sont exprimés en = temps du jour. =20 Il est donc temps de chercher comment configurer NTP ou un autre produit de synchronisation temporelle sur votre système UNIX, ou=20 un équivalent sous NT.

Démarrage et arrêt du serveur

Pour démarrer le serveur, exécutez httpd. Il = cherchera le fichier httpd.conf à l'emplacement = spécifié lors de la compilation (par défaut=20 /usr/local/apache/conf/httpd.conf). Si ce fichier est = situé=20 autre part, vous pouvez indiqué son emplacement en utilisant = l'option -f.=20 Par exemple :

    /usr/local/apache/httpd -f /usr/local/apache/conf/httpd.conf

Si tout ce passe bien, vous devez vous retrouvez de nouveau sur l'invite = de commande. Ceci indique que le serveur est actif et s'exécute. Si quelque = chose se=20 passe mal durant l'initialisation du serveur, un message d'erreur = s'affichera=20 à l'écran. Si le serveur démarre correctement, vous pouvez utiliser votre = butineur,=20 vous connecter au serveur et lire la documentation. Si vous lancez le = butineur à partir de la machine où s'exécute le serveur et = que vous=20 utilisez le port par d=E9faut 80, une URL valide à taper dans = votre butineur est :=20

    http://localhost/

Notez que lors du démarrage du serveur un certain nombre de = processus=20 fils sont créés afin de traiter les = requêtes. =20 Si vous démarrez le serveur en étant root, le processus = père s'exécutera avec les droits de root, tandis que les processus = fils s'exécuteront avec les droits de l'utilisateur défini dans = le=20 fichier httpd.conf.

Si au lancement de httpd celui ci indique qu'il n'arrive = pas à=20 s'attacher à une adresse, cela signifie soit qu'un autre = processus s'exécute déjà en utilisant le numéro de = port défini dans la configuration d'Apache, soit que vous essayez de = lancer httpd en tant qu'utilisateur normal et que vous essayez d'utiliser un port=20 inférieur à 1024 (comme le port 80 par exemple).=20

Si le serveur ne s'exécute pas, lisez le message affiché = quand vous lancez httpd. Vous devez également vérifier le fichier error_log pour plus d'informations (dans la configuration par = défaut=20 ce fichier est situé dans le fichier error_log du=20 répertoire logs).

Si vous voulez que votre serveur continue à s'exécuter = après une relance du système, vous devez ajouter un appel à = httpd dans vos fichiers de démarrage du syst=E8me (typiquement = rc.local=20 ou un fichier dans un répertoire rc.N).=20 Ceci lancera le serveur Apache avec les droits de root. Avant de le faire, vérifiez que votre serveur est correctement = configuré au niveau de la sécurité et des restrictions = d'accès.=20

Pour arrêter Apache, envoyez au processus parent un signal TERM. Le pID de ce processus est écrit dans le fichier = httpd.pid situé dans le répertoire logs (à moins = qu'Apache soit configuré autrement). N'essayez pas de supprimer les = processus fils car d'autres seront créés par le processus père. Une = commande typique pour arrêter le serveur est :

    kill -TERM `cat /usr/local/apache/logs/httpd.pid`

Pour plus d'information sur les options en ligne de commande, sur les fichiers de configuration et le fichiers de trace, voir Démarrage d'Apache. Pour un guide = de=20 référence de toutes les directives Apache = autorisées par les modules distribués, voir les directives Apache .

Compilation des programmes d'assistance

En plus du serveur httpd qui est compil=E9 et configur=E9 = comme ci dessus, Apache inclut un certain nombre de programmes d'assistance.=20 Ceux ci ne sont pas compilés par défaut. Les programmes = d'assistance sont situés dans le répertoire support de la = distribution. Pour les compiler, allez dans ce répertoire et tapez :=20

    make

------=_NextPart_000_002A_01C099C3.6FE93200 Content-Type: text/html; name="upgrading.html.fr" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="upgrading.html.fr" Mise à de la version 1.3 à la version 2.0

Mise à de la version 1.3 à la version = 2.0

Afin d'aider les personnes souhaitant se mettre à jour, nous=20 maintenons un document décrivant les informations critiques = concernant les utilisateurs d'Apache. Ces informations sont sous la forme de = brèves=20 notes, et vous pouvez trouver plus d'informations soit dans le document=20 Nouvelles fonctionnalités=20 ou dans le fichier src/CHANGES.

Changement de la configuration à la compilation

Apache utilise maintenant autoconf et = libtool afin de configurer la compilation. L'utilisation de ces outils est similaire, mais pas tout à fait identique, au système = APACI de configuration existant dans la version 1.3 d'Apache.=20
En plus de l'habituelle sélection de modules que vous pouvez = choisir de compiler, Apache 2.0 a déplacé la majeure partie du = traitement des requêtes dans le modules = multi-traitements (MPMs).

Changement de la configuration =E0 l'ex=E9cution

La directive CacheNegotiatedDocs prend maintenant un=20 paramètre qui est soit on soit off. Les = configurations existantes utilisant la directive CacheNegotiatedDocs = doivent la remplacer par CacheNegotiatedDocs on.
La directive ErrorDocument n'utilise plus de guillemets = ou d'apostrophes au début du paramètre indiquant le = message.=20 Dorénavant, le message devra être entre guillemets. Par = exemple, la directive
ErrorDocument 403 "Some = Message
=20 devra être remplacé par
ErrorDocument 403 = "Some Message"
Si le second argument n'est pas une URL ou = un chemin valide, il sera traité comme un message.
Les directives AccessConfig et = ResourceConfig n'existent plus. Ces directives peuvent être remplacées de = manière équivalente par la directive Include. Si vous utilisiez ces directives en utilisant les valeurs par = défaut sans les définir explicitement, vous devez ajouter les lignes Include conf/access.conf et Include conf/srm.conf dans votre fichier httpd.conf. =20 Afin de garantir qu'Apache lit les différents fichiers de = configuration dans le même ordre que celui pour les anciennes directives, Les = directives Include doivent être situées à la fin = du fichier=20 httpd.conf, celle représentant srm.conf avant celle = pour=20 access.conf.
La directive BindAddress n'existe plus. La même fonctionnalité est fournie par la directive=20 Listen.
La directive ExtendedStatus n'existe plus. Le suivi des statuts a été entièrement = réécrit afin de bénéficier du nouveau système MPM.
La directive ServerType n'existe plus.=20 La méthode utilisée pour servir les requêtes est=20 déterminée maintenant par la sélection d'un MPM. Il n'existe pas actuellement de MPM conçu pour être = lancé par inetd.
Beaucoup de directives qui étaient situées dans le = noyau=20 du serveur pour la version 1.3 se trouvent maintenant dans les = MPMs.
Les modules mod_log_agent et mod_log_referer qui traitaient les = directives AgentLog, RefererLog et RefererIgnore ont été supprimés.=20 Le traçage des agents et référants et toujours = disponible en utilisant la directive=20 CustomLog du module mod_log_config.

Changements divers

Le red=E9marrage en douceur du serveur est maintenant traité = en envoyant au processus père le signal WINCH à la place = du=20 signal USR1.
L'option -S du programme httpd qui servait à afficher la configuration des hôtes virtuels = est=20 remplacé par -t -D DUMP_VHOSTS.
L'option -X du programme httpd=20 est supprime. La majorité des MPM permettent la même = fonctionnalité en définissant les variables d'environnement = ONE_PROCESS et NO_DETACH avant de lancer httpd.
Le module mod_auth_digest, qui =E9tait exp=E9rimental dans la = version 1.3, est maintenant un module standard.
Le module mod_mmap_static, qui =E9tait exp=E9rimental dans la = version 1.3 a été remplacé par le module mod_file_cache.

Modules tiers

D'énormes changements ont été = réalisés sur l'API du serveur Apache 2.0. Les modules conçus à = l'aide de=20 l'API Apache 1.3 ne fonctionneront pas sur Apache 2.0 = sans=20 modifications. Plus de d=E9tails sont fournis dans la documentation du développeur.

------=_NextPart_000_002A_01C099C3.6FE93200--