Äîêóìåíò âçÿò èç êýøà ïîèñêîâîé ìàøèíû. Àäðåñ
îðèãèíàëüíîãî äîêóìåíòà
: http://www.arcetri.astro.it/manual/de/install.html
Äàòà èçìåíåíèÿ: Mon Jan 21 19:44:30 2013 Äàòà èíäåêñèðîâàíèÿ: Thu Feb 27 23:54:13 2014 Êîäèðîâêà: |
Apache HTTP Server Version 2.2
Dieses Dokument umfaút nur die Kompilierung und Installation des Apache HTTP Servers auf Unix und Unix-Ähnlichen Systemen. FÝr die Kompilierung und Installation unter Windows lesen Sie bitte Den Apache HTTPd unter Microsoft Windows betreiben. FÝr andere Plattformen lesen Sie bitte die Dokumentation Plattformen.
Der Apache HTTPd verwendet libtool
und
autoconf
, um eine Erstellungsumgebung zu schaffen, die der
vieler anderer Open Source Projekte Ähnlich sieht.
Wenn Sie von einer Unterversion auf die nÄchste aktualisieren (z.B. von 2.2.50 auf 2.2.51), springen Sie bitte zum Abschnitt Upgrade.
Download | $ lynx http://httpd.apache.org/download.cgi
|
Auspacken | $ gzip -d httpd-NN.tar.gz |
Konfigurieren | $ ./configure --prefix=PREFIX
|
Kompilieren | $ make |
Installieren | $ make install |
Anpassen | $ vi PREFIX/conf/httpd.conf |
Testen | $ PREFIX/bin/apachectl -k start
|
NN muss durch die entsprechende Versionsnummer ersetzt
werden und PREFIX durch den Verzeichnispfad,
in dem der Server installiert werden soll. Wenn PREFIX nicht
angegeben ist, wird die Voreinstellung /usr/local/apache2
verwendet.
Beginnend mit den Anforderungen fÝr die Kompilierung und Installation des Apache HTTP Servers ist weiter unten jeder Abschnitt des Kompilierungs- und Installationsvorganges genauer beschrieben.
Folgende Anforderungen gelten fÝr die Erstellung des Apache HTTPd:
PATH
wesentliche Generierungswerkzeuge wie
make
enthalten.ntpdate
oder xntpd
verwendet,
die auf dem Network Time Protocol (NTP) basieren. NÄhere
Informationen Ýber NTP Software und Æffentliche Zeitserver
finden Sie auf der NTP-Homepage.apxs
oder dbmmanage
(die in Perl
geschrieben sind) wird der Perl 5 Interpreter benÆtigt (die
Versionen ab 5.003 sind ausreichend). Wenn Sie mehrere Perl
Interpreter haben (beispielsweise eine systemweite Installation von
Perl 4 und Ihre eigene Perl 5-Installation), dann sollten Sie die
--with-perl
-Option (siehe unten) verwenden, um
sicherzustellen, dass der richtige Interpreter von
configure
ausgewÄhlt wird.
Wenn kein Perl 5-Interpreter vom configure
-Skript
gefunden werden kann, kÆnnen Sie die betroffenen Hilfsskripte nicht
verwenden, sind jedoch selbstverstÄndlich nach wie vor in der Lage,
den Apache HTTPd zu bauen und zu installieren.apr
und apr-util
werden mit den
Quelltext-VerÆffentlichungen des Apache HTTPd gebÝndelt und in
nahezu allen FÄllen ohne Probleme verwendet. Sind jedoch die
apr
- oder apr-util
-Versionen 1.0 oder 1.1 auf
Ihrem System installiert, dann mÝssen Sie diese
apr
-/apr-util
-Installationen entweder
aktualisieren oder httpd separate Kompilate verwenden lassen. Um
hierfÝr die mitgelieferten
apr
-/apr-util
-Quellen zu verwenden,
mÝssen Sie diese manuell installieren:
# apr 1.2 bauen und installieren
cd srclib/apr
./configure --prefix=/usr/local/apr-httpd/
make
make install
# apr-util 1.2 bauen und installieren
cd ../apr-util
./configure --prefix=/usr/local/apr-util-httpd/
--with-apr=/usr/local/apr-httpd/
make
make install
# httpd konfigurieren
cd ../../
./configure --with-apr=/usr/local/apr-httpd/
--with-apr-util=/usr/local/apr-util-httpd/
Der Apache HTTP Server kann von der Apache-HTTP-Server-Downloadseite heruntergeladen werden, auf der
verschiedene Spiegelserver angegeben sind. FÝr die meisten Benutzer
des Apache HTTPd ist es auf Unix-Ähnlichen Systemen am Besten, die
Quellcodeversion herunterzuladen und zu kompilieren. Der
Erstellungsprozess (weiter unten beschrieben) ist einfach und erlaubt es
Ihnen, den Server Ihren BedÝrfnissen anzupassen. Dazu kommt, dass
BinÄrdistributionen gegenÝber der aktuellen Quellcodeversion oft
veraltet sind. Wenn Sie tatsÄchlich ein BinÄrpaket
herunterladen, folgen Sie bitte den Anweisungen in der Datei
INSTALL.bindist
, die der Distribution beiliegt.
Es ist wichtig, dass Sie nach dem Herunterladen ÝberprÝfen, dass es sich um einer vollstÄndige und unverÄnderte Version des Apache HTTP Servers handelt. Das kÆnnen Sie erreichen, indem Sie das heruntergeladene Paket gegen die PGP-Signatur prÝfen. Einzelheiten dazu erfahren Sie auf der Download-Seite. Es ist auch ein erweitertes Beispiel verfÝgbar, dass die Anwendung von PGP beschreibt.
Das Auspacken des Quellcodes aus dem Apache-HTTPd-Tarball besteht aus einem simplen Dekomprimieren und danach "Ent-tarren":
$ gzip -d httpd-NN.tar.gz
$ tar xvf httpd-NN.tar
Dies erstellt unterhalb des aktuellen Verzeichnisses ein neues
Verzeichnis, das den Quellcode fÝr die Distribution enthÄlt.
Sie sollten mit cd
in dieses Verzeichnis wechseln,
bevor Sie mit der Kompilierung des Servers weitermachen.
Der nÄchste Schritt ist die Konfiguration des
Apache-HTTPd-Codebaumes fÝr Ihre spezielle Plattform und Ihre
persÆnlichen BedÝrfnisse. Dies wird mit dem Skript
configure
durchgefÝhrt, das im Wurzelverzeichnis
der Distribution enthalten ist. (Entwickler, welche eine nicht
freigegebene Version des Apache-HTTPd-Codebaumes herunterladen, mÝssen
autoconf
und libtool
installiert haben und mÝssen
buildconf
ausfÝhren, bevor sie mit den
nÄchsten Schritten fortfahren kÆnnen. Dies wird bei
offiziellen Releases nicht notwendig sein.)
Um den Codebaum mit den Standardeinstellungen zu konfigurieren,
geben Sie einfach ./configure
ein. Zur änderung
dieser Voreinstellungen akzeptiert configure
eine
Reihe von Variablen und Kommandozeilenoptionen.
Die wichtigste Option ist --prefix
, der Ablageort, an dem
der Apache HTTP Server spÄter installiert wird, da er fÝr diesen Ort
konfiguriert werden muss, um korrekt zu arbeiten. Eine feinere Einstellung
der Dateiablagen ist mit weiteren configure-Optionen
mÆglich.
Weiterhin kÆnnen Sie zu diesem Zeitpunkt festlegen, welche FunktionalitÄt
Sie in den Apache HTTPd aufnehmen mÆchten, indem Sie Module aktivieren oder deaktivieren. Der Apache HTTP
Server bindet standardmÄúig einen Satz von Basismodulen ein. Andere Module
werden mit Hilfe der Option --enable-module
aktiviert, wobei module den Namen des Moduls ohne das
PrÄfix mod_
darstellt. Ausserdem sind alle Unterstriche
durch Bindestriche zu ersetzen. Sie kÆnnen sich auch entscheiden,
Module als "Shared Objects (DSOs)" zu kompilieren,
welche zur Laufzeit ge- und entladen werden kÆnnen. Dazu verwenden
Sie die Option --enable-module=shared
.
Entsprechend kÆnnen Sie Basismodule mit der Option
--disable-module
deaktivieren. Lassen Sie Vorsicht
walten. wenn Sie diese Optionen verwenden, da configure
Sie nicht warnen kann, wenn die von Ihnen angegebenen Module nicht
existieren; die Option wird dann einfach ignoriert.
ZusÄtzlich ist es zuweilen notwendig, das
configure
-Skript mit Extrainformationen zum Ablageort
Ihres Compilers, Ihrer Bibliotheken oder Header-Dateien zu versorgen. Das
tun Sie, indem Sie entweder Umgebungsvariablen oder Kommandozeilenoptionen
an configure
Ýbergeben. FÝr mehr Informationen
lesen Sie bitte die Hilfeseite zu configure
.
Um einen kurzen Eindruck zu gewinnen, welche MÆglichkeiten Sie
haben, folgt hier ein typisches Beispiel, das den Apache mit einem
speziellen Compiler und Compilerflags fÝr das
Installationsverzeichnis /sk/pkg/apache
kompiliert, sowie
die beiden zusÄtzlichen Module mod_rewrite
und
mod_speling
fÝr spÄteres Laden durch den
DSO-Mechanismus:
$ CC="pgcc" CFLAGS="-O2" \
./configure --prefix=/sw/pkg/apache \
--enable-rewrite=shared \
--enable-speling=shared
Wenn configure
startet, benÆtigt es mehrere
Minuten, um die VerfÝgbarkeit von Features auf Ihrem System zu
prÝfen und ein Makefile zu generieren, das spÄter zur
Kompilierung des Servers verwendet wird.
Einzelheiten zu den vielen verschiedenen configure
-Optionen finden Sie auf der Hilfeseite zu
configure
.
Nun kÆnnen Sie die verschiedenen Teile, die das Apache-HTTPd-Paket bilden, einfach durch AusfÝhren des folgenden Befehls erstellen:
$ make
Seien Sie hierbei bitte geduldig, denn eine Basiskonfiguration benÆtigt mehrere Minuten zum Kompilieren. Die Zeit kann jedoch abhÄngig von Ihrer Hardware und der Anzahl der Module, die Sie aktiviert haben, sehr stark variieren.
Nun endlich installieren Sie das Package unter dem konfigurierten
Installations-PREFIX (siehe oben: Option --prefix
durch Aufrufen von:
$ make install
Wenn Sie upgraden, wird die Installation Ihre Konfigurationsdateien oder Dokumente nicht Ýberschrieben.
Als nÄchstes kÆnnen Sie Ihren Apache HTTP Server anpassen,
indem Sie die Konfigurationsdateien
unterhalb von PREFIX/conf/
editieren.
$ vi PREFIX/conf/httpd.conf
Werfen Sie auch einen Blick in das Apache-HTTP-Server-Handbuch unter docs/manual/. Die aktuellste Version dieses Handbuchs sowie eine komplette Referenz der verfÝgbaren Konfigurationsanweisungen finden Sie unter http://httpd.apache.org/docs/2.2/.
Sie kÆnnen nun Ihren Apache HTTP Server starten, indem Sie einfach
$ PREFIX/bin/apachectl -k start
ausfÝhren.
Danach sollten Sie Ihr erstes Dokument unter dem URL
http://localhost/
anfordern kÆnnen. Die Webseite,
die Sie sehen, ist im DocumentRoot
abgelegt, welches Ýblicherweise PREFIX/htdocs/
ist. Den Server stoppen Sie wieder durch
AusfÝhren von:
$ PREFIX/bin/apachectl -k stop
Der erste Schritt beim Aktualisieren besteht darin, die
VersionsankÝndigung sowie die CHANGES
-Datei in der
Quelltextdistribution zu lesen, um änderungen zu finden, die Ihr
System mÆglicherweise betreffen. Wenn Sie einen grÆúeren
Versionssprung durchfÝhren (z.B. vom 1.3 auf 2.0 oder von 2.0 auf
2.2), wird es wahrscheinlich auch grÆúere Unterschiede in der
Kompilier- und Laufzeitkonfiguration geben, die manuelle Nacharbeiten
erfordern. Auúerdem mÝssen alle Module aktualisiert
werden, um den änderungen der Modul-API gerecht zu werden.
Die Aktualisierung einer Unterversion auf eine andere (z.B. von 2.2.55
auf 2.2.57) ist einfacher. make install
Ýberschreibt
keine der bereits existierenden Dokumente, Log- und Konfigurationsdateien.
Ausserdem bemÝhen sich die Entwickler, inkompatible änderungen
der configure
-Optionen, der Laufzeitkonfiguration sowie
der Modul-API zu vermeiden. In den meisten FÄllen sollten Sie in der
Lage sein, den gleichen configure
-Befehl, die gleiche
Konfiguration und die gleichen Module wieder zu verwenden.
Um auf eine neue Unterversion zu aktualisieren, suchen Sie zunÄchst
die Datei config.nice
im build
-Verzeichnis
Ihrer Serverinstallation oder im Wurzelverzeichnis des Quelltextbaums
der alten Installation. Die Datei enthÄlt den genauen
configure
-Befehl, der verwendet wurde, um den
Quellcode zu konfigurieren. Um jetzt von einer Version auf die
nÄchste zu aktualisieren, kopieren Sie einfach die
config.nice
in das Verzeichnis der neuen Version,
passen sie bei Bedarf an, und fÝhren Sie sie aus:
$ ./config.nice
$ make
$ make install
$ PREFIX/bin/apachectl -k graceful-stop
$ PREFIX/bin/apachectl -k start
--prefix
und einen anderen Port wÄhlen (durch Anpassen der
Listen
-Direktive). So
kÆnnen Sie auf eventuelle InkompatibilitÄten testen, bevor Sie
endgÝltig die neue Version verwenden.