Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Ceci est une ancienne révision du document !


apache2ctl (apachectl) - Interface de contrôle du serveur HTTP Apache

apache2ctl est une interface pour le serveur HTTP Apache.

Il est conçu pour aider l'administrateur à contrôler le fonctionnement du démon Apache2.

La configuration Debian par défaut nécessite que les variables d'environnement APACHE_RUN_USER, APACHE_RUN_GROUP et APACHE_PID_FILE soient définies dans /etc/apache2/envvars.

Pré-requis

Installation

Configuration

Utilisation

Sortie

Le script apache2ctl renvoie une valeur de sortie 0 en cas de succès et >0 en cas d'erreur. Pour plus de détails, consultez les commentaires dans le script.

Syntaxe

  1. En mode SysV init, apache2ctl prend des commandes simples en un mot :

    ...@...:~ $ apachectl commande
    ...@...:~ $ apache2ctl commande

Commandes

  1. start : Démarre Apache. Donne une erreur s'il est déjà en cours d'exécution.
  2. stop : Arrête Apache.
  3. graceful-stop : Arrête Apache en douceur.
    Contrairement à un arrêt normal, les connexions ouvertes ne sont pas interrompues.
    Effet secondaire : les anciens fichiers journaux ne seront pas fermés immédiatement.
  4. restart : Redémarre Apache 1) en lui envoyant un SIGHUP.
    , il est démarré.
    Lance apache2ctl configtest pour vérifier les fichiers de configuration avant le redémarrage. Plantage possible si problème de configuration.
  5. graceful : Redémarre en douceur Apache 2) en lui envoyant un SIGUSR1.
    Contrairement au redémarrage normal, les connexions ouvertes ne sont pas interrompues.
    Effet secondaire : les anciens fichiers journaux ne seront pas fermés immédiatement.
    Cela signifie que s'il est utilisé dans un script de rotation des journaux, un délai important peut être nécessaire pour garantir que les anciens fichiers journaux sont fermés avant de les traiter.
    Lance apache2ctl configtest pour vérifier les fichiers de configuration avant le redémarrage.
    Plantage possible si problème de configuration.
  6. status : Affiche un bref rapport d'état, sans la liste des demandes en cours de traitement.
  7. fullstatus : Affiche un rapport d'état complet.
    Pour que cela fonctionne, vous devez avoir activé mod_status sur votre serveur et disposer d'un navigateur texte tel que lynx sur votre système.
    L'URL utilisée pour accéder au rapport d'état peut être définie par la variable APACHE_STATUSURL dans /etc/apache2/envvars.
  8. configtest : Lance un test de syntaxe du fichier de configuration.
    Il analyse les fichiers de configuration et signale soit syntaxe OK, soit des informations sur l'erreur de syntaxe particulière.
    Ce test ne détecte pas toutes les erreurs.
  9. help : Affiche un court message d'aide.
  1. En mode pass-through, apache2ctl peut prendre tous les arguments disponibles pour le binaire httpd :

    ...@...:~ $ apachectl [argument_httpd]
    ...@...:~ $ apache2ctl [argument_httpd]

Environnement

Le comportement d'apache2ctl peut être influencé par ces variables d'environnement :

  • APACHE_HTTPD,
  • APACHE_LYNX,
  • APACHE_STATUSURL,
  • APACHE_ULIMIT_MAX_FILES,
  • APACHE_RUN_DIR,
  • APACHE_LOCK_DIR,
  • APACHE_RUN_USER,
  • APACHE_ARGUMENTS,
  • APACHE_ENVVARS.

Voir les commentaires dans le script pour plus de détails. Ces variables (sauf APACHE_ENVVARS) peuvent être définies dans /etc/apache2/envvars.

Commandes

Désinstallation

Voir aussi


Basé sur « man apache2ctl(8) » par Auteur.

1) , 2)
S'il n'est pas en cours d'exécution