Programmes apachectl - L'interface de contrôle du serveur HTTP Apache

apachectl est un frontal pour le serveur HTTP Apache. Il a été conçu pour aider l'administrateur à contrôler le fonctionnement du démon Apache httpd.

Le script apachectl possède deux modes de fonctionnement. Il peut fonctionner en tant que simple frontal de la commande httpd et ne fait alors que définir toute variable d'environnement nécessaire, puis invoque httpd en lui passant tout argument de ligne de commande souhaité. Il peut aussi fonctionner en tant que script d'initialisation SysV n'acceptant qu'un seul argument tel que start, restart et stop, et traduisant ce dernier en signaux appropriés pour le démon httpd.

Si votre installation d'Apache utilise des chemins non standards, vous devrez éditer le script apachectl afin de définir les chemins appropriés pour le binaire httpd. Vous pouvez aussi spécifier tout argument de ligne de commande de httpd nécessaire. Voir les commentaires dans le script pour plus de détails.

Le script apachectl renvoie une valeur égale à 0 en cas de succès, et une valeur supérieure à 0 en cas de problème. Voir les commentaires dans le script pour plus de détails.

 Démarrer Apache Arrêter Apache Fichiers de configuration Documentation spécifique aux plates-formes httpd
Résumé

En mode frontal (pass-through), apachectl peut spécifier tous les arguments qu'accepte le binaire httpd.

apachectl [ argument-httpd ]

En mode script d'initialisation SysV, apachectl n'accepte qu'un seul des arguments définis ci-dessous.

apachectl commande

Options

Seules les options du style initialisation SysV sont décrites ici. Les autres arguments sont décrits dans la page de manuel de httpd.

start
Démarre le démon Apache httpd. Renvoie une erreur s'il est déjà en cours d'exécution. Équivalent à apachectl -k start.
stop
Arrête le démon Apache httpd. Équivalent à apachectl -k stop.
restart
Redémarre le démon Apache httpd. Si le démon n'est pas en cours d'exécution, il est démarré. Cette option vérifie automatiquement les fichiers de configuration (de la même manière que l'option configtest ) avant de lancer le redémarrage, afin d'être sûr que le fonctionnement du démon ne sera pas compromis. Equivalent à apachectl -k restart.
fullstatus
Affiche le rapport d'état complet du module mod_status. Pour que ceci fonctionne, mod_status doit être activé dans votre serveur et vous devez disposer d'un navigateur en mode texte tel que lynx sur votre système. L'URL utilisée pour accéder au rapport d'état peut être modifiée en définissant la variable STATUSURL dans le script.
status
Affiche un rapport d'état succinct. Similaire à l'option fullstatus, excepté que la liste des requêtes en cours de traitement est omise.
graceful
Redémarre le démon Apache httpd en douceur. Si le démon n'est pas en cours d'exécution, il est démarré. À la différence d'un redémarrage normal, les connexions en cours ne sont pas fermées. Comme effet de bord, les anciens fichiers journaux ne seront pas fermés immédiatement. Cela signifie que si l'on utilise un script de rotation des journaux, un délai suffisant sera nécessaire afin d'être sûr que les fichiers journaux seront bien fermés avant leur traitement par le script de rotation. Cette option vérifie automatiquement les fichiers de configuration (de la même manière que l'option configtest ) avant de lancer le redémarrage, afin d'être sûr que le fonctionnement du démon ne sera pas compromis. Équivalent à apachectl -k graceful.
graceful-stop
Arrête le démon Apache httpd en douceur. À la différence d'un arrêt normal, les connexions en cours ne sont pas fermées. Comme effet de bord, les anciens fichiers journaux ne seront pas fermés immédiatement. Équivalent à apachectl -k graceful-stop.
configtest
Effectue une vérification de la syntaxe du fichier de configuration. Avec cette option, le script parcourt le fichier de configuration et renvoie soit Syntax Ok, soit des informations détaillées à propos des éventuelles erreurs de syntaxe. Equivalent à apachectl -t.

Les options suivantes étaient disponibles dans les anciennes versions et ont été supprimées.

startssl
Pour démarrer httpd avec le support SSL, vous devez éditer votre fichier de configuration et y inclure les directives appropriées, puis utiliser la commande de démarrage normale apachectl start.