granicus.if.org Git - apache/blob - docs/manual/upgrading.xml.de

   1 <?xml version='1.0' encoding='UTF-8' ?>
   2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="./style/manual.de.xsl"?>
   4 <!-- English Revision: 151408 -->
   5
   6 <!--
   7  Copyright 2002-2005 The Apache Software Foundation or its licensors,
   8                      as applicable.
   9
  10  Licensed under the Apache License, Version 2.0 (the "License");
  11  you may not use this file except in compliance with the License.
  12  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <manualpage metafile="upgrading.xml.meta">
  24
  25 <title>Upgrade von 1.3 auf 2.0</title>
  26
  27 <summary>
  28     <p>Dieses Dokument dient der Unterst&#252;tzung beim Upgrade. Es
  29     enth&#228;lt die entscheidenden Informationen f&#252;r bisherige
  30     Apache-Nutzer. Diese sind als kurze Anmerkungen
  31     gedacht. Weitere Informationen finden Sie entweder unter
  32     <a href="new_features_2_0.html">Neue Funktionen</a> oder in
  33     den <code>src/CHANGES</code>-Dateien.</p>
  34 </summary>
  35 <seealso><a href="new_features_2_0.html">&Uuml;bersicht der neuen Funktionen
  36   in Apache 2.0</a></seealso>
  37
  38   <section id="compile-time">
  39     <title>&#196;nderungen der Konfiguration bei der Kompilierung</title>
  40
  41     <ul>
  42       <li>Der Apache benutzt jetzt ein <code>autoconf</code>- und
  43       <code>libtool</code>-System zur <a
  44       href="install.html">Konfiguration des
  45       Erstellungsverfahrens</a>. Die Verwendung dieses Systems ist
  46       &#228;hnlich, aber nicht identisch mit dem APACI-System des
  47           Apache 1.3.</li>
  48
  49       <li>Zus&#228;tzlich zu der &#252;blichen Auswahl von Modulen, die
  50       kompiliert werden sollen, wurde der Hauptteil der
  51       Request-Verarbeitung im Apache 2.0 in die <a href="mpm.html">
  52       Multi-Processing-Module</a> (MPMs) verschoben.</li>
  53     </ul>
  54   </section>
  55
  56   <section id="run-time">
  57     <title>&#196;nderungen der Laufzeit-Konfiguration</title>
  58
  59     <ul>
  60       <li>Viele Anweisungen aus dem Serverkern des Apache 1.3 sind
  61       jetzt in den MPMs enthalten. Wenn Sie ein Serververhalten
  62       w&#252;nschen, das demjenigen des Apache 1.3 m&#246;glichst
  63       &#228;hnlich ist, sollten Sie das <module>prefork</module>-MPM
  64       ausw&#228;hlen. Andere MPMs verwenden abweichende Anweisungen
  65       f&#252;r die Prozess-Erstellung und Request-Verarbeitung.</li>
  66
  67       <li>Das <a href="mod/mod_proxy.html">Proxy-Modul</a> wurde
  68       umgearbeitet, um es auf den Stand von HTTP/1.1 zu bringen. Eine
  69       der bedeutendsten &#196;nderungen ist die Platzierung der
  70       Proxy-Zugriffskontrolle innerhalb eines <directive type="section"
  71       module="mod_proxy">Proxy</directive>-Blocks, statt innerhalb eines
  72       <code>&lt;Directory proxy:&gt;</code>-Blocks.</li>
  73
  74       <li>Die Behandlung von <code>PATH_INFO</code> (hinter dem
  75       tats&#228;chlichen Dateinamen angef&#252;gte Pfadangaben) wurde
  76       f&#252;r einige Module ge&#228;ndert. Module, die bisher als Handler
  77       implementiert waren, jetzt aber als Filter implementiert sind,
  78       akzeptieren m&#246;glicherweise keine Requests mit
  79       <code>PATH_INFO</code> mehr. Filter wie <a
  80       href="mod/mod_include.html">INCLUDES</a> oder <a
  81       href="http://www.php.net/">PHP</a> sind gleich oben im
  82       Core-Handler implementiert und weisen deshalb Requests mit
  83       <code>PATH_INFO</code> ab. Sie k&#246;nnen die <directive
  84       module="core">AcceptPathInfo</directive>-Direktive
  85       verwenden, um den Core-Handler zu zwingen, Requests mit
  86       <code>PATH_INFO</code> zu akzeptieren, und dadurch die F&#228;higkeit
  87       wiederherstellen, <code>PATH_INFO</code> in Server Side Includes zu
  88       benutzen.</li>
  89
  90       <li>Die <directive
  91       module="mod_negotiation">CacheNegotiatedDocs</directive>-Direktive
  92       hat jetzt das Argument an (<code>on</code>) oder aus
  93       (<code>off</code>). Die vorhandenen Anweisungen <directive
  94       >CacheNegotiatedDocs</directive> sollten durch
  95       <code>CacheNegotiatedDocs on</code> ersetzt werden.</li>
  96
  97       <li>
  98         Die <directive module="core">ErrorDocument</directive>-Direktive
  99         verwendet kein Anf&#252;hrungszeichen mehr am Anfang des
 100         Arguments, um eine
 101         Textnachricht anzuzeigen. Stattdessen sollten Sie die
 102         Nachricht in doppelte Anf&#252;hrungszeichen einschlie&#223;en.
 103         Zum Beispiel sollten existierende Angaben wie
 104
 105         <example>
 106           ErrorDocument 403 "Eine Nachricht
 107         </example>
 108         durch
 109
 110         <example>
 111           ErrorDocument 403 "Eine Nachricht"
 112         </example>
 113
 114         ersetzt werden.
 115         Solange das zweite Argument kein g&#252;ltiger URL oder
 116         Pfadname ist, wird es als Textnachricht behandelt.
 117       </li>
 118
 119       <li>Die Direktiven <code>AccessConfig</code> und
 120       <code>ResourceConfig</code> sind entfallen.
 121       Diese Direktiven k&#246;nnen durch die <directive
 122       module="core">Include</directive>-Direktive
 123       ersetzt werden, die eine &#228;quivalente Funktionalit&#228;t besitzt.
 124       Wenn Sie die Defaultwerte dieser Direktiven verwendet haben,
 125       ohne sie in die Konfigurationsdateien einzuf&#252;gen, m&#252;ssen Sie
 126       m&#246;glicherweise <code>Include conf/access.conf</code> und
 127       <code>Include conf/srm.conf</code> zu Ihrer <code>httpd.conf</code>
 128       hinzuf&#252;gen. Um sicherzustellen, da&#223; der Apache die
 129       Konfigurationsdateien in der gleichen Reihenfolge liest, wie sie von
 130       den &#228;lteren Direktiven impliziert wurde, sollten die <directive
 131       module="core">Include</directive>-Direktiven ans Ende der
 132       <code>httpd.conf</code> gestellt werden, wobei die Direktive f&#252;r
 133       <code>srm.conf</code> derjenigen f&#252;r <code>access.conf</code>
 134       vorangeht.</li>
 135
 136       <li>Die Direktiven <code>BindAddress</code> und <code>Port</code>
 137       sind entfallen. Eine &#228;quivalente Funktionalit&#228;t wird von der
 138       flexibleren Direktive  <directive
 139       module="mpm_common">Listen</directive> bereitgestellt.</li>
 140
 141       <li>Im Apache 1.3 wurde die <code>Port</code>-Direktive au&#223;erdem
 142       dazu verwendet, die Portnummer f&#252;r
 143       selbstreferenzierende URLs festzulegen.
 144       Die neue <directive module="core">ServerName</directive>-Syntax
 145       stellt das Apache-2.0-&#196;quivalent dar:
 146       sie wurde dahingehend ver&#228;ndert, sowohl den Hostnamen
 147       <em>als auch</em> die Portnummer f&#252;r selbstreferenzierende URLs
 148       in einer Direktive angeben zu k&#246;nnen.</li>
 149
 150       <li>Die <code>ServerType</code>-Direktive entf&#228;llt.
 151       Die Methode zum Bedienen der Requests wird nun durch die Auswahl
 152       des MPM ermittelt. Derzeit ist kein MPM daf&#252;r bestimmt, von inetd
 153       gestartet zu werden.</li>
 154
 155       <li>Die Module <code>mod_log_agent</code> und <code>
 156       mod_log_referer</code>, welche die Direktiven <code>AgentLog</code>,
 157       <code>RefererLog</code> und <code>RefererIgnore</code> bereitgestellt
 158       hatten, wurden entfernt. Durch Verwendung der Direktive <directive
 159       module="mod_log_config">CustomLog</directive> aus mod_log_config
 160       sind die Agent- und Refererlogs auch weiterhin verf&#252;gbar.</li>
 161
 162       <li>Die Direktiven <code>AddModule</code> und
 163       <code>ClearModuleList</code> sind entfallen.
 164       Diese Direktiven wurden benutzt, um sicherzustellen, da&#223; die
 165       Module in der richtigen Reihenfolge aktiviert werden k&#246;nnen.
 166       Die neue Apache 2.0 API erlaubt es Modulen, ihre Reihenfolge
 167       explizit anzugeben, und macht diese Direktiven damit
 168       &#252;berfl&#252;ssig.</li>
 169
 170       <li>Die Direktive <code>FancyIndexing</code> wurde entfernt.
 171       Die gleiche Funktionalit&#228;t ist nun mit der Option
 172       <code>FancyIndexing</code> der Direktive <directive
 173       module="mod_autoindex">IndexOptions</directive> verf&#252;gbar.</li>
 174
 175       <li>Die von <module>mod_negotiation</module> bereitgestellte
 176       Content-Negotiation-Technik MultiViews f&#252;hrt nun eine strengere
 177       Dateierkennung durch. Es wird ausschlie&#223;lich unter den
 178       <em>aushandelbaren</em> Dateien gew&#228;hlt. Das bisherige Verhalten
 179       kann jedoch mit der Direktive <directive
 180       module="mod_mime">MultiviewsMatch</directive> wiederhergestellt
 181       werden.</li>
 182
 183       <li>(<em>Ab Version 2.0.51</em>)
 184         <p><code>ErrorHeader</code> war eine Fehlbenennung, weshalb die
 185           Funktionalit&auml;t dieser Direktive mit der
 186           <directive module="mod_headers">Header</directive>-Anweisung
 187           zusammengelegt wurde. Verwenden Sie stattdessen</p>
 188
 189       <example>
 190         Header always set foo bar
 191       </example>
 192
 193       <p>um den gleichen Effekt zu erzielen.</p></li>
 194 </ul>
 195   </section>
 196
 197   <section id="misc">
 198     <title>Sonstige &#196;nderungen</title>
 199
 200     <ul>
 201       <li>Das Modul <module>mod_auth_digest</module>, das im Apache 1.3
 202       experimentellen Status hatte, ist nun ein Standardmodul.</li>
 203
 204       <li>Das Modul <code>mod_mmap_static</code>, das im Apache 1.3
 205       experimentellen Status hatte, wurde durch das Modul <module
 206       >mod_file_cache</module> ersetzt.</li>
 207
 208       <li>Die Distribution wurde komplett reorganisiert und enth&#228;lt kein
 209       unabh&#228;ngiges <code>src</code>-Verzeichnis mehr. Stattdessen wurden
 210       die Quellcodes logisch unterhalb des Hauptverzeichnisses der
 211       Distribution angeordnet. Installationen des kompilierten Servers
 212       sollten in ein separates Verzeichnis erfolgen.</li>
 213     </ul>
 214   </section>
 215
 216   <section id="third-party">
 217     <title>Module von Drittanbietern</title>
 218
 219     <p>An der API des Apache 2.0 wurden umfassende &#196;nderungen
 220     vorgenommen. Bestehende Module, die f&#252;r die Apache 1.3 API
 221     entwickelt wurden, werden <strong>nicht</strong> ohne Modifikationen mit
 222     der Version 2.0 des Apache zusammenarbeiten. Details sind in der <a
 223     href="developer/">Dokumentation f&#252;r Entwickler</a> beschrieben.</p>
 224   </section>
 225 </manualpage>