From owner-svn-doc-all@freebsd.org Sat Jun 4 12:09:52 2016 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id C23A9B697E3; Sat, 4 Jun 2016 12:09:52 +0000 (UTC) (envelope-from bhd@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 89B0D1160; Sat, 4 Jun 2016 12:09:52 +0000 (UTC) (envelope-from bhd@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id u54C9p3G034721; Sat, 4 Jun 2016 12:09:51 GMT (envelope-from bhd@FreeBSD.org) Received: (from bhd@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id u54C9p6m034720; Sat, 4 Jun 2016 12:09:51 GMT (envelope-from bhd@FreeBSD.org) Message-Id: <201606041209.u54C9p6m034720@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bhd set sender to bhd@FreeBSD.org using -f From: Bjoern Heidotting Date: Sat, 4 Jun 2016 12:09:51 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48894 - head/de_DE.ISO8859-1/books/handbook/network-servers X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 04 Jun 2016 12:09:52 -0000 Author: bhd Date: Sat Jun 4 12:09:51 2016 New Revision: 48894 URL: https://svnweb.freebsd.org/changeset/doc/48894 Log: Update to r44578: Editorial review of first half of Apache chapter. Some reshuffling to improve flow. Add descriptions for virtual hosting and modules. Add URLs to module config docs. Reviewed by: bcr Differential Revision: https://reviews.freebsd.org/D6724 Modified: head/de_DE.ISO8859-1/books/handbook/network-servers/chapter.xml Modified: head/de_DE.ISO8859-1/books/handbook/network-servers/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/handbook/network-servers/chapter.xml Sat Jun 4 11:47:58 2016 (r48893) +++ head/de_DE.ISO8859-1/books/handbook/network-servers/chapter.xml Sat Jun 4 12:09:51 2016 (r48894) @@ -5,7 +5,7 @@ $FreeBSD$ $FreeBSDde: de-docproj/books/handbook/network-servers/chapter.xml,v 1.103 2011/12/24 15:51:18 bcr Exp $ - basiert auf: r44567 + basiert auf: r44578 --> - Der Apache HTTP-Server Webserver @@ -4476,14 +4481,14 @@ $include Kexample.com.+005+nnnnn.ZSK.key bin und sbin unterhalb des Serverwurzelverzeichnisses installiert, während sich - Konfigurationsdateien im Verzeichnis + Konfigurationsdateien im Unterverzeichnis etc/apache2x befinden. - ServerAdmin you@your.address + ServerAdmin you@example.com Die E-Mail-Adresse, an die Mitteilungen über @@ -4494,13 +4499,18 @@ $include Kexample.com.+005+nnnnn.ZSK.key - ServerName www.example.com + ServerName www.example.com:80 Erlaubt dem Administrator, einen Rechnernamen festzulegen, den der Server an die Clients sendet. Beispielsweise könnte www statt - des richtigen Rechnernamens verwendet werden. + des richtigen Rechnernamens verwendet werden. Wenn das + System keinen eingetragenen DNS-Namen + hat, kann stattdessen die IP-Adresse + eingetragen werden. Lauscht der Server auf einem + anderen Port, tauschen Sie die 80 + gegen eine entsprechende Portnummer. @@ -4522,41 +4532,48 @@ $include Kexample.com.+005+nnnnn.ZSK.key anzulegen, bevor Änderungen durchgeführt werden. Wenn die Konfiguration von Apache abgeschlossen ist, speichern Sie die Datei und überprüfen Sie - die Konfiguration mit apachectl. Geben Sie dazu - apachectl configtest ein. Dieser Befehl - sollte Syntax OK zurückgeben. + die Konfiguration mit apachectl. Der + Befehl apachectl configtest sollte + Syntax OK zurückgeben. Apache Starten oder Beenden - Der www/apache24 Port - installiert ein &man.rc.8; Skript, welches zum - starten, stoppen und neustarten von - Apache benutzt werden kann. - Das Skript befindet sich in - /usr/local/etc/rc.d/. - Um den Apache beim Systemstart zu starten, fügen Sie folgende Zeile in /etc/rc.conf ein: - apache24_enable="YES" + apache24_enable="YES" Wenn Sie während des Systemstarts weitere Parameter an den Apache übergeben wollen, können Sie diese durch eine zusätzliche Zeile in rc.conf angeben: - apache24_flags="" + apache24_flags="" + + Wenn apachectl keine + Konfigurationsfehler meldet, starten Sie + httpd: + + &prompt.root; service apache24 start + + Sie können den httpd-Dienst testen, + indem Sie + http://localhost + in einen Browser eingeben, wobei Sie + localhost durch den + vollqualifizierten Domainnamen der Maschine ersetzen, auf dem + der httpd läuft. Die Standard Webseite, + die angezeigt wird, ist + /usr/local/www/apache24/data/index.html. Die Konfiguration von Apache kann bei nachfolgenden Änderungen an der Konfigurationsdatei bei laufendem httpd, auf Fehler überprüft - werden. Dies kann durch das &man.rc.8;-Skript direkt , oder - über das Dienstprogramm &man.service.8; geschehen, indem Sie - eines der folgenden Kommandos ausführen: + werden. Geben Sie dazu folgendes Kommando ein: - &prompt.root; service apache24 configtest + &prompt.root; service apache24 configtest Es ist wichitg zu beachten, dass @@ -4564,65 +4581,49 @@ $include Kexample.com.+005+nnnnn.ZSK.key und somit nicht zwingend mit anderen &man.rc.8;-Startskripten funktioniert. - - Wenn der Apache keine Fehler in - der Konfiguration meldet, starten Sie httpd - mithilfe von &man.service.8;: - - &prompt.root; service apache24 start - - Sie können den httpd-Dienst testen, - indem Sie - http://localhost - in einen Browser eingeben, wobei Sie - localhost durch den - vollqualifizierten Domainnamen der Machine ersetzen, auf dem - der httpd läuft. Die Standard Webseite, - die angezeigt wird, ist - /usr/local/www/apache24/data/index.html. - Virtual Hosting - Der Apache unterstützt zwei - Formen des Virtual Hostings. Die - erste Möglichkeit bezeichnet man als namenbasiertes - virtuelles Hosting. Dabei wird der HTTP/1.1-Header der Clients - dazu verwendet, den Rechnernamen zu bestimmen. Dadurch wird es - möglich, mehrere Domains unter der gleichen - IP-Adresse zu betreiben. - - Damit der Apache namenbasierte - virtuelle Domains verwalten kann, fügen Sie die folgende - Zeile in httpd.conf ein: - - NameVirtualHost * - - Wenn der Webserver - www.domain.tld - heißt und die virtuelle Domain - Virtual Hosting ermöglicht + es, mehrere Webseiten auf einem + Apache-Server laufen zu lassen. + Die virtuellen Hosts können IP-basiert + oder namensbasiert sein. + IP-basiertes virtual Hosting verwendet + eine IP-Adresse für jede Webseite. Beim + namensbasierten virtual Hosting wird der HTTP/1.1-Header der + Clients dazu verwendet, den Rechnernamen zu bestimmen. + Dadurch wird es möglich, mehrere Domains unter der gleichen + IP-Adresse zu betreiben. + + Damit der Apache namenbasierte + virtuelle Domains verwalten kann, fügen Sie für jede Webseite + einen separaten VirtualHost-Block ein. + Wenn der Webserver beispielsweise www.domain.tld heißt und + die virtuelle Domain www.someotherdomain.tld einrichtet werden soll, ergänzen Sie httpd.conf um folgende Einträge: - <VirtualHost *> -ServerName www.domain.tld -DocumentRoot /www/domain.tld + <VirtualHost *> + ServerName www.domain.tld + DocumentRoot /www/domain.tld </VirtualHost> <VirtualHost *> -ServerName www.someotherdomain.tld -DocumentRoot /www/someotherdomain.tld -</VirtualHost> - - Ersetzen Sie dabei die Adressen sowie den Pfad zu den - Dokumenten durch Ihre eigenen Einstellungen. + ServerName www.someotherdomain.tld + DocumentRoot /www/someotherdomain.tld +</VirtualHost> + + Setzen Sie für jeden virtuellen Host die entsprechenden + Werte für ServerName und + DocumentRoot. Ausführliche Informationen zum Einrichten von - virtuellen Domains finden Sie in der offiziellen + virtuellen Hosts finden Sie in der offiziellen Apache-Dokumentation unter http://httpd.apache.org/docs/vhosts/. @@ -4634,15 +4635,25 @@ DocumentRoot /www/someotherdomain.tld Apache Module - Es gibt viele verschiedene - Apache-Module, die den Server - um zusätzliche Funktionen erweitern. Die - &os; Ports-Sammlung ermöglicht es Ihnen, den - Apache gemeinsam mit einigen der - beliebtesten Zusatzmodule zu installieren. + Apache verwendet Module, die + den Server um zusätzliche Funktionen erweitern. Eine + vollständige Auflistung der zur Verfügung stehenden Module + und Konfigurationsdetails finden Sie unter + http://httpd.apache.org/docs/current/mod/. + + In &os; können einige Module mit dem Port + www/apache24 kompiliert werden. Geben Sie + in /usr/ports/www/apache24 + make config ein, um zu sehen, welche Module + zur Verfügung stehen und welche Module in der Voreinstellung + aktiviert sind. Wenn ein Modul nicht zusammen mit dem Port + kompiliert wird, bietet die Ports-Sammlung die Möglichkeit + viele Module zu installieren. Dieser Abschnitt beschreibt + drei der am häufigsten verwendeten Module. - <application>mod_ssl</application> + <filename>mod_ssl</filename> Webserver @@ -4657,157 +4668,61 @@ DocumentRoot /www/someotherdomain.tld Verschlüsselung - Das Modul mod_ssl verwendet die - OpenSSL-Bibliothek, um, unter Nutzung der Protokolle Secure - Sockets Layer (SSL v2/v3) sowie Transport Layer Security - (TLS v1) starke Verschlüsselung zu ermöglichen. - Durch dieses Modul können Sie ein signiertes Zertifikat - von einer Zertifizierungsstelle anfordern, damit Sie einen - sicheren Webserver unter &os; betreiben können. - - Das Modul mod_ssl wird - standardmäßig kompiliert, kann aber auch noch - nachträglich durch die Angabe von - -DWITH_SSL zur Kompilierzeit aktiviert - werden. - - - - Skriptsprachen - - Für die wichtigsten Skriptsprachen existieren Module, - die es erlauben, Apache-Module - nahezu vollständig in einer Skriptsprache zu programmieren. - Derartige Module dienen oft dazu, einen Sprach-Interpreter in - den Webserver einzubetten. Dadurch wird ein zusätzlicher - externer Interpreter überflüssig, was die Startzeit - von dynamischen Internetseiten deutlich verringert. + Das Modul mod_ssl verwendet die + OpenSSL-Bibliothek, um über die + Protokolle Secure Sockets Layer (SSLv3) + sowie Transport Layer Security (TLSv1) + eine starke Verschlüsselung zu ermöglichen. Mit diesem + Modul können Sie ein signiertes Zertifikat von einer + Zertifizierungsstelle anfordern, damit Sie einen sicheren + Webserver unter &os; betreiben können. + + Unter &os; wird das Modul mod_ssl + standardmäßig im Port und auch im Paket aktiviert. Die + verfügbaren Konfigurationsanweisungen werden in + http://httpd.apache.org/docs/current/mod/mod_ssl.html + beschrieben. - - - - Dynamische Webseiten - - Webserver - dynamisch - - In den vergangenen Jahren haben immer mehr Unternehmen - das Internet als Mittel für die Steigerung ihrer - Einnahmen sowie für die Erhöhung ihrer Reichweite - entdeckt. Dadurch stieg auch die Nachfrage nach interaktiven - Internetinhalten. Neben einigen Unternehmen, darunter - µsoft;, die dafür proprietäre Produkte - entwickelt haben, hat auch die Open Source Community auf - diesen Umstand reagiert und unter anderem mit Django, - Ruby on Rails, mod_perl2, und - mod_php Möglichkeiten zur - Generierung dynamischer Internetseiten geschaffen. - Django - - Python - Django - - Bei Django handelt es - sich um ein unter der BSD-Lizenz verfügbares - Framework zur schnellen Erstellung von mächtigen - Internet-Applikationen. Es beinhaltet einen - objekt-relationalen Mapper (wodurch Datentypen als - Phyton-Objekte entwickelt werden können) sowie eine - API für den dynamischen Datenbankzugriff auf diese - Objekte, ohne dass Entwickler jemals SQL-Code schreiben - müssen. Zusätzlich existiert ein umfangreiches - Template-System, wodurch die Programmlogik von der - HTML-Präsentation getrennt werden kann. - - Django setzt das Modul - mod_python, - den Apache-Webserver sowie eine - SQL-Datenbank voraus. Der &os;-Port wird alle - Abhängigkeiten mit sinnvollen Optionen konfigurieren und - installieren. - - - Django mit <application>Apache2</application>, - <application>mod_python3</application>, und - <application>PostgreSQL</application> installieren - - &prompt.root; cd /usr/ports/www/py-django; make all install clean -DWITH_MOD_PYTHON3 -DWITH_POSTGRESQL - - - Nachdem Django und die abhängigen Pakete installiert - sind, benötigt die Anwendung ein Projektverzeichnis und die - Apache-Konfiguration, um den eingebetteten - Python-Interpreter zu nutzen. Dieser wird spezifische URLs - der Seite aufrufen. - - - Apache-Konfiguration für Django/mod_python - - Sie müssen httpd.conf anpassen, - damit Apache Anfragen für bestimmte URLs an die - Internet-Applikation übergibt: - - <Location "/"> - SetHandler python-program - PythonPath "['/dir/to/the/django/packages/'] + sys.path" - PythonHandler django.core.handlers.modpython - SetEnv DJANGO_SETTINGS_MODULE mysite.settings - PythonAutoReload On - PythonDebug On -</Location> - - - - - Ruby on Rails - - Ruby on Rails - - Bei Ruby on Rails handelt - es sich um ein weiteres, als Open Source verfügbares - Webframework. Es bietet einen kompletten Entwicklungsstack - und erlaubt es Webentwicklern, umfangreiche und mächtige - Applikationen in kurzer Zeit zu programmieren. Das - Framework kann über die Ports-Sammlung installiert - werden. - - &prompt.root; cd /usr/ports/www/rubygem-rails; make all install clean - - - - <application>mod_perl2</application> + <filename>mod_perl2</filename> mod_perl2 Perl - Die Kombination Apache/Perl - vereinigt die Vorteile der Programmiersprache Perl und des - Apache HTTP-Servers. Durch - das Modul mod_perl2 ist es - möglich, vollständig in Perl geschriebene - Apache-Module zu erzeugen. - Da der Perl-Interpreter in den Server eingebettet wird, - müssen Sie weder einen externen Interpreter noch - Perl zusätzlich aufrufen. - - mod_perl2 ist über den Port - www/mod_perl2 - erhältlich. + mod_perl2 macht es + möglich, vollständig in Perl + geschriebene Apache-Module zu + erzeugen. Da der + Perl-Interpreter in den Server + eingebettet wird, muss weder ein externer Interpreter noch + Perl zusätzlich aufgerufen + werden. + + mod_perl2 wird über den Port + oder das Paket www/mod_perl2 installiert. + Dokumentation für dieses Modul finden Sie unter + http://perl.apache.org/docs/2.0/index.html. - - <application>mod_php</application> mod_php @@ -4918,6 +4833,100 @@ DocumentRoot /www/someotherdomain.tld PHP unterstützt. + + + Dynamische Webseiten + + + Webserver + dynamisch + + + In den vergangenen Jahren haben immer mehr Unternehmen + das Internet als Mittel für die Steigerung ihrer + Einnahmen sowie für die Erhöhung ihrer Reichweite + entdeckt. Dadurch stieg auch die Nachfrage nach interaktiven + Internetinhalten. Neben einigen Unternehmen, darunter + µsoft;, die dafür proprietäre Produkte + entwickelt haben, hat auch die Open Source Community auf + diesen Umstand reagiert und unter anderem mit Django, + Ruby on Rails, mod_perl2, und + mod_php Möglichkeiten zur + Generierung dynamischer Internetseiten geschaffen. + + + Django + + Python + Django + + Bei Django handelt es + sich um ein unter der BSD-Lizenz verfügbares + Framework zur schnellen Erstellung von mächtigen + Internet-Applikationen. Es beinhaltet einen + objekt-relationalen Mapper (wodurch Datentypen als + Phyton-Objekte entwickelt werden können) sowie eine + API für den dynamischen Datenbankzugriff auf diese + Objekte, ohne dass Entwickler jemals SQL-Code schreiben + müssen. Zusätzlich existiert ein umfangreiches + Template-System, wodurch die Programmlogik von der + HTML-Präsentation getrennt werden kann. + + Django setzt das Modul + mod_python, + den Apache-Webserver sowie eine + SQL-Datenbank voraus. Der &os;-Port wird alle + Abhängigkeiten mit sinnvollen Optionen konfigurieren und + installieren. + + + Django mit <application>Apache2</application>, + <application>mod_python3</application>, und + <application>PostgreSQL</application> installieren + + &prompt.root; cd /usr/ports/www/py-django; make all install clean -DWITH_MOD_PYTHON3 -DWITH_POSTGRESQL + + + Nachdem Django und die abhängigen Pakete installiert + sind, benötigt die Anwendung ein Projektverzeichnis und die + Apache-Konfiguration, um den eingebetteten + Python-Interpreter zu nutzen. Dieser wird spezifische URLs + der Seite aufrufen. + + + Apache-Konfiguration für Django/mod_python + + Sie müssen httpd.conf anpassen, + damit Apache Anfragen für bestimmte URLs an die + Internet-Applikation übergibt: + + <Location "/"> + SetHandler python-program + PythonPath "['/dir/to/the/django/packages/'] + sys.path" + PythonHandler django.core.handlers.modpython + SetEnv DJANGO_SETTINGS_MODULE mysite.settings + PythonAutoReload On + PythonDebug On +</Location> + + + + + Ruby on Rails + + Ruby on Rails + + Bei Ruby on Rails handelt + es sich um ein weiteres, als Open Source verfügbares + Webframework. Es bietet einen kompletten Entwicklungsstack + und erlaubt es Webentwicklern, umfangreiche und mächtige + Applikationen in kurzer Zeit zu programmieren. Das + Framework kann über die Ports-Sammlung installiert + werden. + + &prompt.root; cd /usr/ports/www/rubygem-rails; make all install clean + +