Apache2ctl: Unterschied zwischen den Versionen

Aus Foxwiki
K Textersetzung - „= Bekannte Probleme =“ durch „= Problembehebung =“
K Textersetzung - „== Syntax ==“ durch „== Aufruf ==“
 
(11 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
'''apache2ctl''' - Funktion des [[Apache-Webserver]]s (httpd-Daemonkontrollieren
'''apache2ctl''' - Funktion des [[Apache-Webserver]]s [[httpd]]-Daemon kontrollieren


== Beschreibung ==
== Beschreibung ==
; 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
{|class="wikitable options big"
* 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
| 1 || Frontend&nbsp;für&nbsp;[[httpd]] || Alle notwendigen Umgebungsvariablen setzt und dann <code>httpd</code> aufruft, wobei es alle Befehlszeilenargumente weitergibt
|-
| 2 || SysV-Init-Skript || 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
; Befehlszeilenargumente
* Sie können auch alle notwendigen <code>httpd-Befehlszeilenargumente</code> angeben
* Sie können auch alle notwendigen <code>httpd-Befehlszeilenargumente</code> angeben
; Details
* Einzelheiten finden Sie in den Kommentaren im Skript
* Einzelheiten finden Sie in den Kommentaren im Skript


; Siehe auch
; Siehe auch
Kommentare des Skripts
* Kommentare des Skripts


== Syntax ==
== Aufruf ==
; Pass-Through-Modus
; Pass-Through-Modus
<code>apachectl</code> übernimmt alle für die <code>httpd-Binärdatei</code>verfügbaren Argumente
<code>apachectl</code> übernimmt alle für die <code>httpd-Binärdatei</code>verfügbaren Argumente
Zeile 23: Zeile 30:
Im SysV-Init-Modus nimmt <code>apachectl</code> einfache Ein-Wort-Befehle entgegen
Im SysV-Init-Modus nimmt <code>apachectl</code> einfache Ein-Wort-Befehle entgegen


=== Optionen ===
; Optionen
Hier werden nur die Optionen im Stil von SysV init definiert (siehe httpd-Handbuchseite)
Hier werden nur die Optionen im Stil von SysV init definiert (siehe httpd-Handbuchseite)
{| class="wikitable sortable options"
{| class="wikitable sortable options"
Zeile 87: Zeile 94:


== Anwendung ==
== Anwendung ==
=== Problembehebung ===


== Konfiguration ==
== Konfiguration ==
Zeile 108: Zeile 113:
# /usr/share/doc/apache2/README.Debian.gz
# /usr/share/doc/apache2/README.Debian.gz


===== Man-Pages =====
===== Man-Page =====
# apache2ctl(8)
# apache2ctl(8)
# apache2(8)
# apache2(8)
Zeile 119: Zeile 124:


[[Kategorie:Apache/HTTP/Befehle]]
[[Kategorie:Apache/HTTP/Befehle]]
[[Kategorie:Linux/Befehl]]


</noinclude>
</noinclude>

Aktuelle Version vom 12. November 2024, 18:41 Uhr

apache2ctl - Funktion des Apache-Webservers httpd-Daemon kontrollieren

Beschreibung

Arbeitsweisen

apachectl kennt zwei Modi

1 Frontend für httpd Alle notwendigen Umgebungsvariablen setzt und dann httpd aufruft, wobei es alle Befehlszeilenargumente weitergibt
2 SysV-Init-Skript 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

Befehlszeilenargumente
  • Sie können auch alle notwendigen httpd-Befehlszeilenargumente angeben
Details
  • Einzelheiten finden Sie in den Kommentaren im Skript
Siehe auch
  • Kommentare des Skripts

Aufruf

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

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

Umgebung

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.

Rückgabewert

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

Anwendung

Konfiguration

Dateien

Anhang

Siehe auch


  • Apache starten
  • Apache stoppen
  • Konfigurationsdateien
  • Plattform-Dokumente
  • httpd
  • Kommentare

Dokumentation

  1. /usr/share/doc/apache2/README.Debian.gz
Man-Page
  1. apache2ctl(8)
  2. apache2(8)

Links

Weblinks