Version vom 3. Mai 2024, 19:38 Uhr

topic - Kurzbeschreibung

Beschreibung

apachectl ist ein Frontend für den Apache HyperText Transfer Protocol (HTTP)-Server

Es soll dem Administrator helfen, die Funktion des Apache httpd-Daemons zu kontrollieren

Arbeitsweisen

apachectl kennt zwei Modi

Erstens kann es als einfaches Frontend für den httpd-Befehlfungieren, das einfach alle notwendigen Umgebungsvariablen setzt und dann httpd aufruft, wobei es alle Befehlszeilenargumente weitergibt.
Zweitens kann apachectl als SysV-Init-Skript fungieren, das einfache Ein-Wort-Argumente wie start, restart und stop entgegennimmt und sie in entsprechende Signale an httpd übersetzt.

Anpassung

Wenn Ihre Apache-Installation nicht standardisierte Pfade verwendet, müssen Sie das apachectl-Skript bearbeiten, um die entsprechenden Pfade für das httpd-Binary festzulegen. Sie können auch alle notwendigen httpd-Befehlszeilenargumente angeben. Einzelheiten finden Sie in den Kommentaren im Skript.

Das Skript apachectl gibt bei Erfolg den Wert 0 zurück, bei einem Fehler >0.

Weitere Einzelheiten finden Sie in den Kommentaren des Skripts.

Installation

Syntax

Optionen

Parameter

Umgebungsvariablen

Exit-Status

Anwendung

Fehlerbehebung

Konfiguration

Dateien

Anhang

Siehe auch

Apache2ctl

Apache starten
Apache stoppen
Konfigurationsdateien
Plattform-Dokumente
httpd
Kommentare

Dokumentation

RFC

RFC	Titel
0000

Man-Pages

Info-Pages

Links

Weblinks

TMP

Synopse

Im Pass-Through-Modus kann apachectl alle für die httpd-Binärdateiverfügbaren Argumente übernehmen.

# apachectl [ httpd-argument ]

Im SysV-Init-Modus nimmt apachectl einfache Ein-Wort-Befehle entgegen, die im Folgenden definiert sind.

apachectl-Befehl

Optionen

Hier werden nur die Optionen im Stil von SysV init definiert. Andere Argumente sind in der httpd-Handbuchseite definiert.

Option	Beschreibung
`start`	Startet den Apache `httpd-Daemon`. Gibt eine Fehlermeldung aus, wenn er bereits läuft. Dies ist gleichbedeutend mit `apachectl -k start`.
`stop`	Hält den Apache `httpd-Daemon` an. Dies ist gleichbedeutend mit`apachectl -k stop`.
`restart`	Startet den Apache `httpd-Daemon` neu. Wenn der Daemon nicht läuft, wird er gestartet. Dieser Befehl überprüft automatisch die Konfigurationsdateien wie in `configtest`, bevor der Neustart eingeleitet wird, um sicherzustellen, dass der Daemon nicht stirbt. Dies ist gleichbedeutend mit `apachectl -k restart`.
`fullstatus`	Zeigt einen vollständigen Statusbericht von `mod_status` an. Damit dies funktioniert, müssen Sie `mod_status` auf Ihrem Server aktiviert haben und einen textbasierten Browser wie `lynx`auf Ihrem System verfügbar haben. Die URL, die für den Zugriff auf den Statusbericht verwendet wird, kann durch Bearbeiten der Variablen `STATUSURL` im Skript festgelegt werden.
`status`	Zeigt einen kurzen Statusbericht an. Ähnlich wie die Option`fullstatus`, mit dem Unterschied, dass die Liste der Anfragen, die gerade bedient werden, weggelassen wird.
`graceful`	Startet den Apache `httpd-Daemon` ordnungsgemäß neu. Wenn der Daemon nicht läuft, wird er gestartet. Der Unterschied zu einem normalen Neustart besteht darin, dass derzeit offene Verbindungen nicht abgebrochen werden. Ein Nebeneffekt ist, dass alte Protokolldateien nicht sofort geschlossen werden. Das bedeutet, dass bei Verwendung in einem Skript zur Protokollrotation eine erhebliche Verzögerung erforderlich sein kann, um sicherzustellen, dass die alten Protokolldateien geschlossen werden, bevor sie verarbeitet werden. Dieser Befehl überprüft automatisch die Konfigurationsdateien wie in `configtest`, bevor der Neustart eingeleitet wird, um sicherzustellen, dass der Apache nicht stirbt. Dies ist gleichbedeutend mit`apachectl -k graceful`.
`graceful-stop`	Beendet den Apache `httpd-Daemon`. Der Unterschied zu einem normalen Stopp besteht darin, dass aktuell offene Verbindungen nicht abgebrochen werden. Ein Nebeneffekt ist, dass alte Protokolldateien nicht sofort geschlossen werden. Dies ist gleichbedeutend mit `apachectl -k graceful-stop`.
`configtest`	Führt einen Syntaxtest für Konfigurationsdateien durch. Er analysiert die Konfigurationsdateien und meldet entweder `Syntax Ok`oder detaillierte Informationen über den jeweiligen Syntaxfehler. Dies ist gleichbedeutend mit `apachectl -t`. Die folgende Option war in früheren Versionen verfügbar, wurde aber entfernt.
`startssl`	Um `httpd` mit SSL-Unterstützung zu starten, sollten Sie Ihre Konfigurationsdatei so bearbeiten, dass sie die entsprechenden Direktiven enthält, und dann den normalen `apachectl-Start` verwenden.

@@ Zeile 63: / Zeile 63: @@
 == Optionen ==
-Hier werden nur die Optionen im Stil von SysV init definiert.  Andere Argumente sind in der <code>httpd-Handbuchseite</code> definiert.
+Hier werden nur die Optionen im Stil von SysV init definiert. Andere Argumente sind in der <code>httpd-Handbuchseite</code> definiert.
+{| class="wikitable sortable options"
-; <code>start</code>
+|-
-: Startet den Apache <code>httpd-Daemon</code>.  Gibt eine Fehlermeldung aus, wenn er bereits läuft.  Dies ist gleichbedeutend mit <code>apachectl -k start</code>.
+! Option !! Beschreibung
-; <code>stop</code>
+|-
-: Hält den Apache <code>httpd-Daemon</code> an.  Dies ist gleichbedeutend mit<code>apachectl -k stop</code>.
+|  <code>start</code> ||
-; <code>restart</code>
+: Startet den Apache <code>httpd-Daemon</code>. Gibt eine Fehlermeldung aus, wenn er bereits läuft. Dies ist gleichbedeutend mit <code>apachectl -k start</code>.
-: Startet den Apache <code>httpd-Daemon</code> neu.  Wenn der Daemon nicht läuft, wird er gestartet.  Dieser Befehl überprüft automatisch die Konfigurationsdateien wie in <code>configtest</code>, bevor der Neustart eingeleitet wird, um sicherzustellen, dass der Daemon nicht stirbt.  Dies ist gleichbedeutend mit <code>apachectl -k restart</code>.
+|-
-; <code>fullstatus</code>
+|  <code>stop</code> ||
-: Zeigt einen vollständigen Statusbericht von <code>mod_status</code> an. Damit dies funktioniert, müssen Sie <code>mod_status</code> auf Ihrem Server aktiviert haben und einen textbasierten Browser wie <code>lynx</code>auf Ihrem System verfügbar haben.  Die URL, die für den Zugriff auf den Statusbericht verwendet wird, kann durch Bearbeiten der Variablen <code>STATUSURL</code> im Skript festgelegt werden.
+: Hält den Apache <code>httpd-Daemon</code> an. Dies ist gleichbedeutend mit<code>apachectl -k stop</code>.
-; <code>status</code>
+|-
-: Zeigt einen kurzen Statusbericht an.  Ähnlich wie die Option<code>fullstatus</code>, mit dem Unterschied, dass die Liste der Anfragen, die gerade bedient werden, weggelassen wird.
+|  <code>restart</code> ||
-; <code>graceful</code>
+: Startet den Apache <code>httpd-Daemon</code> neu. Wenn der Daemon nicht läuft, wird er gestartet. Dieser Befehl überprüft automatisch die Konfigurationsdateien wie in <code>configtest</code>, bevor der Neustart eingeleitet wird, um sicherzustellen, dass der Daemon nicht stirbt. Dies ist gleichbedeutend mit <code>apachectl -k restart</code>.
-: Startet den Apache <code>httpd-Daemon</code> ordnungsgemäß neu.  Wenn der Daemon nicht läuft, wird er gestartet.  Der Unterschied zu einem normalen Neustart besteht darin, dass derzeit offene Verbindungen nicht abgebrochen werden.  Ein Nebeneffekt ist, dass alte Protokolldateien nicht sofort geschlossen werden.  Das bedeutet, dass bei Verwendung in einem Skript zur Protokollrotation eine erhebliche Verzögerung erforderlich sein kann, um sicherzustellen, dass die alten Protokolldateien geschlossen werden, bevor sie verarbeitet werden.  Dieser Befehl überprüft automatisch die Konfigurationsdateien wie in <code>configtest</code>, bevor der Neustart eingeleitet wird, um sicherzustellen, dass der Apache nicht stirbt.  Dies ist gleichbedeutend mit<code>apachectl -k graceful</code>.
+|-
-; <code>graceful-stop</code>
+|  <code>fullstatus</code> ||
-: Beendet den Apache <code>httpd-Daemon</code>. Der Unterschied zu einem normalen Stopp besteht darin, dass aktuell offene Verbindungen nicht abgebrochen werden.  Ein Nebeneffekt ist, dass alte Protokolldateien nicht sofort geschlossen werden. Dies ist gleichbedeutend mit <code>apachectl -k graceful-stop</code>.
+: Zeigt einen vollständigen Statusbericht von <code>mod_status</code> an. Damit dies funktioniert, müssen Sie <code>mod_status</code> auf Ihrem Server aktiviert haben und einen textbasierten Browser wie <code>lynx</code>auf Ihrem System verfügbar haben. Die URL, die für den Zugriff auf den Statusbericht verwendet wird, kann durch Bearbeiten der Variablen <code>STATUSURL</code> im Skript festgelegt werden.
-; <code>configtest</code>
+|-
-: Führt einen Syntaxtest für Konfigurationsdateien durch. Er analysiert die Konfigurationsdateien und meldet entweder <code>Syntax Ok</code>oder detaillierte Informationen über den jeweiligen Syntaxfehler.  Dies ist gleichbedeutend mit <code>apachectl -t</code>.
+|  <code>status</code> ||
+: Zeigt einen kurzen Statusbericht an. Ähnlich wie die Option<code>fullstatus</code>, mit dem Unterschied, dass die Liste der Anfragen, die gerade bedient werden, weggelassen wird.
+|-
+|  <code>graceful</code> ||
+: Startet den Apache <code>httpd-Daemon</code> ordnungsgemäß neu. Wenn der Daemon nicht läuft, wird er gestartet. Der Unterschied zu einem normalen Neustart besteht darin, dass derzeit offene Verbindungen nicht abgebrochen werden. Ein Nebeneffekt ist, dass alte Protokolldateien nicht sofort geschlossen werden. Das bedeutet, dass bei Verwendung in einem Skript zur Protokollrotation eine erhebliche Verzögerung erforderlich sein kann, um sicherzustellen, dass die alten Protokolldateien geschlossen werden, bevor sie verarbeitet werden. Dieser Befehl überprüft automatisch die Konfigurationsdateien wie in <code>configtest</code>, bevor der Neustart eingeleitet wird, um sicherzustellen, dass der Apache nicht stirbt. Dies ist gleichbedeutend mit<code>apachectl -k graceful</code>.
+|-
+|  <code>graceful-stop</code> ||
+: Beendet den Apache <code>httpd-Daemon</code>. Der Unterschied zu einem normalen Stopp besteht darin, dass aktuell offene Verbindungen nicht abgebrochen werden. Ein Nebeneffekt ist, dass alte Protokolldateien nicht sofort geschlossen werden. Dies ist gleichbedeutend mit <code>apachectl -k graceful-stop</code>.
+|-
+|  <code>configtest</code> ||
+: Führt einen Syntaxtest für Konfigurationsdateien durch. Er analysiert die Konfigurationsdateien und meldet entweder <code>Syntax Ok</code>oder detaillierte Informationen über den jeweiligen Syntaxfehler. Dies ist gleichbedeutend mit <code>apachectl -t</code>.
 Die folgende Option war in früheren Versionen verfügbar, wurde aber entfernt.
-; <code>startssl</code>
+|-
+|  <code>startssl</code> ||
 : Um <code>httpd</code> mit SSL-Unterstützung zu starten, sollten Sie Ihre Konfigurationsdatei so bearbeiten, dass sie die entsprechenden Direktiven enthält, und dann den normalen <code>apachectl-Start</code> verwenden.
+|}
 </noinclude>