Apache2ctl: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
Zeile 6: | Zeile 6: | ||
; Arbeitsweisen | ; Arbeitsweisen | ||
<code>apachectl</code> kennt zwei Modi | <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 | * 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 | * 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 | ||
; Anpassung | ; 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 | 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 | * Sie können auch alle notwendigen <code>httpd-Befehlszeilenargumente</code> angeben | ||
* Einzelheiten finden Sie in den Kommentaren im Skript | * Einzelheiten finden Sie in den Kommentaren im Skript | ||
Weitere Einzelheiten finden Sie in den Kommentaren des Skripts | Weitere Einzelheiten finden Sie in den Kommentaren des Skripts | ||
== Syntax == | == Syntax == | ||
Im Pass-Through-Modus kann <code>apachectl</code> alle für die <code>httpd-Binärdatei</code>verfügbaren Argumente übernehmen | Im Pass-Through-Modus kann <code>apachectl</code> alle für die <code>httpd-Binärdatei</code>verfügbaren Argumente übernehmen | ||
# apachectl [<var>httpd-argument</var>] | # apachectl [<var>httpd-argument</var>] | ||
Zeile 23: | Zeile 23: | ||
=== Optionen === | === Optionen === | ||
Hier werden nur die Optionen im Stil von SysV init definiert | Hier werden nur die Optionen im Stil von SysV init definiert | ||
* Andere Argumente sind in der httpd-Handbuchseite definiert | * Andere Argumente sind in der httpd-Handbuchseite definiert | ||
{| class="wikitable sortable options" | {| class="wikitable sortable options" | ||
|- | |- | ||
! Option !! Beschreibung | ! Option !! Beschreibung | ||
|- | |- | ||
| start || Startet den Apache httpd-Daemon | | start || Startet den Apache httpd-Daemon | ||
* Gibt eine Fehlermeldung aus, wenn er bereits läuft | * Gibt eine Fehlermeldung aus, wenn er bereits läuft | ||
* Dies ist gleichbedeutend mit apachectl -k start | * Dies ist gleichbedeutend mit apachectl -k start | ||
|- | |- | ||
| stop || Hält den Apache httpd-Daemon an | | stop || Hält den Apache httpd-Daemon an | ||
* Dies ist gleichbedeutend mitapachectl -k stop | * Dies ist gleichbedeutend mitapachectl -k stop | ||
|- | |- | ||
| restart || Startet den Apache httpd-Daemon neu | | restart || Startet den Apache httpd-Daemon neu | ||
* Wenn der Daemon nicht läuft, wird er gestartet | * 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 | * 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 | * Dies ist gleichbedeutend mit apachectl -k restart | ||
|- | |- | ||
| fullstatus || Zeigt einen vollständigen Statusbericht von mod_status an | | 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 | * 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 | * 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 | | 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 | | graceful || Startet den Apache httpd-Daemon ordnungsgemäß neu | ||
* Wenn der Daemon nicht läuft, wird er gestartet | * Wenn der Daemon nicht läuft, wird er gestartet | ||
* Der Unterschied zu einem normalen Neustart besteht darin, dass derzeit offene Verbindungen nicht abgebrochen werden | * 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 | * 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 | * 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 | * 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 | * Dies ist gleichbedeutend mitapachectl -k graceful | ||
|- | |- | ||
| graceful-stop || Beendet den Apache httpd-Daemon | | graceful-stop || Beendet den Apache httpd-Daemon | ||
* Der Unterschied zu einem normalen Stopp besteht darin, dass aktuell offene Verbindungen nicht abgebrochen werden | * 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 | * Ein Nebeneffekt ist, dass alte Protokolldateien nicht sofort geschlossen werden | ||
* Dies ist gleichbedeutend mit apachectl -k graceful-stop | * Dies ist gleichbedeutend mit apachectl -k graceful-stop | ||
|- | |- | ||
| configtest || Führt einen Syntaxtest für Konfigurationsdateien durch | | configtest || Führt einen Syntaxtest für Konfigurationsdateien durch | ||
* Er analysiert die Konfigurationsdateien und meldet entweder Syntax Okoder detaillierte Informationen über den jeweiligen Syntaxfehler | * Er analysiert die Konfigurationsdateien und meldet entweder Syntax Okoder detaillierte Informationen über den jeweiligen Syntaxfehler | ||
* Dies ist gleichbedeutend mit apachectl -t | * Dies ist gleichbedeutend mit apachectl -t | ||
* Die folgende Option war in früheren Versionen verfügbar, wurde aber entfernt | * Die folgende Option war in früheren Versionen verfügbar, wurde aber entfernt | ||
|- | |- | ||
| startssl || | | 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 | 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 | ||
|} | |} | ||
Version vom 3. Mai 2024, 19:58 Uhr
apache2ctl - Frontend für den Apache Web-Server
Beschreibung
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-Befehl
fungieren, das einfach alle notwendigen Umgebungsvariablen setzt und dannhttpd
aufruft, wobei es alle Befehlszeilenargumente weitergibt - Zweitens kann
apachectl
als SysV-Init-Skript fungieren, das einfache Ein-Wort-Argumente wiestart
,restart
undstop
entgegennimmt und sie in entsprechende Signale anhttpd
ü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
Weitere Einzelheiten finden Sie in den Kommentaren des Skripts
Syntax
Im Pass-Through-Modus kann apachectl
alle für die httpd-Binärdatei
verfügbaren Argumente übernehmen
# apachectl [httpd-argument]
Im SysV-Init-Modus nimmt apachectl
einfache Ein-Wort-Befehle entgegen
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
|
stop | Hält den Apache httpd-Daemon an
|
restart | Startet den Apache httpd-Daemon neu
|
fullstatus | Zeigt einen vollständigen Statusbericht von mod_status an
|
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
|
graceful-stop | Beendet den Apache httpd-Daemon
|
configtest | Führt einen Syntaxtest für Konfigurationsdateien durch
|
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
Exit-Status
apachectl
gibt bei Erfolg den Wert 0 zurück, bei einem Fehler > 0
Anwendung
Fehlerbehebung
Konfiguration
Dateien
Anhang
Siehe auch
- Apache starten
- Apache stoppen
- Konfigurationsdateien
- Plattform-Dokumente
httpd
- Kommentare
Dokumentation
Man-Pages
- apache2ctl(8)