Apache2ctl: Unterschied zwischen den Versionen

Versionsgeschichte interaktiv durchsuchen

VisuellWikitext

Aktuelle Version vom 3. Mai 2024, 21:37 Uhr

apache2ctl - Funktion des Apache-Webservers (httpd-Daemon) kontrollieren

Beschreibung[Bearbeiten | Quelltext bearbeiten]

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

Siehe auch

Kommentare des Skripts

Syntax[Bearbeiten | Quelltext bearbeiten]

Pass-Through-Modus

apachectl übernimmt alle für die httpd-Binärdateiverfügbaren Argumente

# apachectl [httpd-argument]

SysV-Init-Modus

Im SysV-Init-Modus nimmt apachectl einfache Ein-Wort-Befehle entgegen

Optionen[Bearbeiten | Quelltext bearbeiten]

Hier werden nur die Optionen im Stil von SysV init definiert (siehe httpd-Handbuchseite)

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 mitapachectl -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 lynxauf 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 Optionfullstatus, 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 mitapachectl -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 Okoder 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

Parameter[Bearbeiten | Quelltext bearbeiten]

Umgebungsvariablen[Bearbeiten | Quelltext bearbeiten]

The behaviour of apache2ctl can be influenced with these environment variables:

APACHE_HTTPD
APACHE_LYNX
APACHE_STATUSURL
APACHE_ULIMIT_MAX_FILES
APACHE_RUN_DIR
APACHE_LOCK_DIR
APACHE_RUN_USER
APACHE_ARGUMENTS
APACHE_ENVVARS

See the comments in the script for details. These variables (except APACHE_ENVVARS) can be set in /etc/apache2/envvars.

Exit-Status[Bearbeiten | Quelltext bearbeiten]

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

Anwendung[Bearbeiten | Quelltext bearbeiten]

Fehlerbehebung[Bearbeiten | Quelltext bearbeiten]

Konfiguration[Bearbeiten | Quelltext bearbeiten]

Dateien[Bearbeiten | Quelltext bearbeiten]

Anhang[Bearbeiten | Quelltext bearbeiten]

Siehe auch[Bearbeiten | Quelltext bearbeiten]

Apache2ctl

Apache starten
Apache stoppen
Konfigurationsdateien
Plattform-Dokumente
httpd
Kommentare

Dokumentation[Bearbeiten | Quelltext bearbeiten]

/usr/share/doc/apache2/README.Debian.gz

Man-Pages[Bearbeiten | Quelltext bearbeiten]

apache2ctl(8)
apache2(8)

Links[Bearbeiten | Quelltext bearbeiten]

Weblinks[Bearbeiten | Quelltext bearbeiten]

@@ Zeile 1: / Zeile 1: @@
-<code>apachectl</code> ist ein Frontend für den Apache HyperText Transfer Protocol (HTTP)-Server.  Es soll dem Administrator helfen, die Funktion des Apache <code>httpd-Daemons</code> zu kontrollieren.
+'''apache2ctl''' - Funktion des [[Apache-Webserver]]s (httpd-Daemon)  kontrollieren
-Das Skript <code>apachectl</code> kann in zwei Modi arbeiten: Erstens kann es als einfaches Frontend für den <code>httpd-Befehl</code>fungieren, das einfach alle notwendigen Umgebungsvariablen setzt und dann <code>httpd</code> aufruft, wobei es alle Befehlszeilenargumente weitergibt.  Zweitens kann <code>apachectl</code> als SysV-Init-Skript fungieren, das einfache Ein-Wort-Argumente wie <code>start</code>, <code>restart</code> und <code>stop</code> entgegennimmt und sie in entsprechende Signale an <code>httpd</code> übersetzt.
+== Beschreibung ==
+; Arbeitsweisen
+<code>apachectl</code> kennt zwei Modi
+* Erstens kann es als einfaches Frontend für den <code>httpd-Befehl</code>fungieren, das einfach alle notwendigen Umgebungsvariablen setzt und dann <code>httpd</code> aufruft, wobei es alle Befehlszeilenargumente weitergibt
+* Zweitens kann <code>apachectl</code> als SysV-Init-Skript fungieren, das einfache Ein-Wort-Argumente wie <code>start</code>, <code>restart</code> und <code>stop</code> entgegennimmt und sie in entsprechende Signale an <code>httpd</code> übersetzt
-Wenn Ihre Apache-Installation nicht standardisierte Pfade verwendet, müssen Sie das <code>apachectl-Skript</code> bearbeiten, um die entsprechenden Pfade für das <code>httpd-Binary</code> festzulegen.  Sie können auch alle notwendigen <code>httpd-Befehlszeilenargumente</code> angeben. Einzelheiten finden Sie in den Kommentaren im Skript.
+; Anpassung
+Wenn Ihre Apache-Installation nicht standardisierte Pfade verwendet, müssen Sie das <code>apachectl-Skript</code> bearbeiten, um die entsprechenden Pfade für das <code>httpd-Binary</code> festzulegen
+* Sie können auch alle notwendigen <code>httpd-Befehlszeilenargumente</code> angeben
+* Einzelheiten finden Sie in den Kommentaren im Skript
-Das Skript <code>apachectl</code> gibt bei Erfolg den Wert 0 zurück, bei einem Fehler >0.  Weitere Einzelheiten finden Sie in den Kommentaren des Skripts.
+; Siehe auch
+Kommentare des Skripts
-* Synopse
+== Syntax ==
-* Optionen
+; Pass-Through-Modus
+<code>apachectl</code> übernimmt alle für die <code>httpd-Binärdatei</code>verfügbaren Argumente
+ # apachectl [<var>httpd-argument</var>]
+; SysV-Init-Modus
+Im SysV-Init-Modus nimmt <code>apachectl</code> einfache Ein-Wort-Befehle entgegen
+=== Optionen ===
+Hier werden nur die Optionen im Stil von SysV init definiert (siehe httpd-Handbuchseite)
+{| class="wikitable sortable options"
+|-
+! 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 mitapachectl -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 lynxauf 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 Optionfullstatus, 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 mitapachectl -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 Okoder 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
+|}
+=== Parameter ===
+=== Umgebungsvariablen ===
+The behaviour of apache2ctl can be influenced with these environment variables:
+* APACHE_HTTPD
+* APACHE_LYNX
+* APACHE_STATUSURL
+* APACHE_ULIMIT_MAX_FILES
+* APACHE_RUN_DIR
+* APACHE_LOCK_DIR
+* APACHE_RUN_USER
+* APACHE_ARGUMENTS
+* APACHE_ENVVARS
+See the comments in the script for details.  These variables (except APACHE_ENVVARS) can be set in /etc/apache2/envvars.
+=== Exit-Status ===
+<code>apachectl</code> gibt bei Erfolg den Wert 0 zurück, bei einem Fehler > 0
+== Anwendung ==
+=== Fehlerbehebung ===
+== Konfiguration ==
+=== Dateien ===
+<noinclude>
+== Anhang ==
 === Siehe auch ===
+{{Special:PrefixIndex/{{BASEPAGENAME}}}}
+----
 * Apache starten
 * Apache stoppen
@@ Zeile 19: / Zeile 105: @@
 * Kommentare
-== Synopse ==
+==== Dokumentation ====
-Im Pass-Through-Modus kann <code>apachectl</code> alle für die <code>httpd-Binärdatei</code>verfügbaren Argumente übernehmen.
+# /usr/share/doc/apache2/README.Debian.gz
-<code>'''apachectl''' [ <var>httpd-argument</var> ]</code>
-Im SysV-Init-Modus nimmt <code>apachectl</code> einfache Ein-Wort-Befehle entgegen, die im Folgenden definiert sind.
-<code><var>apachectl-Befehl</var></code>
+===== Man-Pages =====
+# apache2ctl(8)
+# apache2(8)
-== Optionen ==
+==== Links ====
-Hier werden nur die Optionen im Stil von SysV init definiert.  Andere Argumente sind in der <code>httpd-Handbuchseite</code> definiert.
+===== Weblinks =====
-; <code>Start</code>
+{{DEFAULTSORT:apache2ctl}}
-: 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>.
+{{DISPLAYTITLE:apache2ctl}}
-; <code>stoppen</code>
-: Hält den Apache <code>httpd-Daemon</code> an.  Dies ist gleichbedeutend mit<code>apachectl -k stop</code>.
-; <code>Neustart</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>Vollstatus</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>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>anmutig</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>konfigtest</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.
+[[Kategorie:Apache/HTTP/Befehle]]
-; <code>startssl</code>
+</noinclude>
-: 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.