Diese Dokumentation wurde zur Beschreibung der Serie 1.7.x von Apache™ Subversion® erstellt. Falls Sie eine unterschiedliche Version von Subversion einsetzen, sei Ihnen dringend angeraten, bei http://www.svnbook.com/ vorbeizuschauen und stattdessen die zu Ihrer Version von Subversion passende Version dieser Dokumentation heranzzuiehen.

Name

mod_dav_svn-Konfigurationsanweisungen — Apache Konfigurationsanweisungen, um Subversion-Projektarchive über den Apache-HTTP-Server bereitzustellen.

Beschreibung

Dieser Abschnitt beschreibt kurz jede Apache-Konfigurationsanweisung für Subversion. Für eine tiefer gehende Beschreibung zur Konfigurierung von Apache für Subversion, siehe „httpd, der Apache HTTP-Server“.

Anweisungen

Das sind die Anweisungen für httpd.conf, die sich auf mod_dav_svn beziehen:

DAV svn

Muss in jedem Directory- oder Location-Abschnitt für ein Subversion-Projektarchiv enthalten sein. Sie fordert httpd auf, das Subversion-Backend von mod_dav zur Auftragsabwicklung zu verwenden.

SVNActivitiesDB directory-path

Bestimmt den Ort im Dateisystem, an dem die Datenbank für Aktivitäten abgelegt werden soll. Standardmäßig erzeugt und verwendet mod_dav_svn ein Verzeichnis im Projektarchiv namens dav/activities.d. Der durch diese Option angegebene Pfad muss absolut sein.

Falls ein SVNParentPath-Bereich angegeben wurde, hängt mod_dav_svn den Basisnamen des Projektarchivs an diesen Pfad an, beispielsweise:

<Location /svn>
  DAV svn


  # jeder "/svn/foo" URL wird auf ein Projektarchiv in
  # /net/svn.nfs/repositories/foo abgebildet
  SVNParentPath         "/net/svn.nfs/repositories"


  # jeder "/svn/foo" URL wird auf eine Aktivitäten-Datenbank in
  #  /var/db/svn/activities/foo abgebildet
  SVNActivitiesDB       "/var/db/svn/activities"
</Location>
SVNAdvertiseV2Protocol On|Off

Neu in Subversion 1.7. Schaltet die Benachrichtigung ein oder aus, dass mod_dav_svn die neue Version seines ebenfalls in dieser Version vorgestellten HTTP-Protokolls unterstützt. Die meisten Administratoren werden diese Direktive nicht verwenden wollen (deren Standardwert On ist), da sie lieber die Leistungsverbesserung des neuen Protokolls nutzen möchten. Falls jedoch ein Server als Durchschreib-Proxy für einen anderen Server, der das neue Protokoll nicht unterstützt, eingerichtet werden soll, ist der Wert dieser Direktive auf Off zu setzen.

SVNAllowBulkUpdates On|Off

Ändert die Unterstützung für vollständige Antworten auf REPORT-Anfragen im Stil von Aktualisierungen. Subversion-Clients verwenden REPORT-Anfragen, um von mod_dav_svn Informationen über Checkouts und Aktualisierungen von Verzeichnisbäumen zu erhalten. Dabei kann vom Server verlangt werden, diese Information auf zwei mögliche Weisen zu senden: entweder mit den Informationen zum gesamten Teilbaum in einer umfangreichen Antwort oder als ein Skelta (eine skelettierte Repräsentation eines Baum-Deltas), das dem Client gerade genug Informationen liefert, so dass er weiß, welche zusätzlichen Daten er vom Server abfragen muss. Wird diese Direktive mit dem Wert Off versehen, werden REPORT-Anfragen von mod_dav_svn ausschließlich mit Skeltas beantwortet, egal welche Art der Antwort vom Client verlangt wurde.

Die Meisten werden diese Direktive überhaupt nicht benötigen. Sie existiert hauptsächlich für Administratoren, die – aus Gründen der Sicherheit oder Nachprüfbarkeit – Subversion-Clients dazu zwingen möchten, alle für Checkouts oder Aktualisierungen benötigten Dateien und Verzeichnisse individuell abzurufen, um somit eine Spur aus GET- und PROPFIND-Anfragen in den Protokolldateien von Apache zu hinterlassen. Der Standardwert dieser Direktive ist On.

SVNAutoversioning On|Off

Wenn der Wert On ist, führen Schreibanfragen von WebDAV-Clients zu automatischen Übergaben ins Projektarchiv. Eine automatisch erzeugte, generische Protokollnachricht wird mit jeder Revision verknüpft. Falls Sie automatische Versionierung ermöglichen, werden Sie sicherlich auch ModMimeUsePathInfo On setzen wollen, so dass mod_mime svn:mime-type automatisch auf den richtigen MIME-Typen setzen kann (natürlich nur so gut, wie es mod_mime kann). Für weitere Informationen, siehe Anhang C, WebDAV und Autoversionierung. Der Standardwert dieser Direktive ist Off.

SVNCacheFullTexts On|Off

Der Wert On teilt Subversion mit, Volltextinhalt zwischenzuspeichern, sofern ausreichend Zwischenspeicherplatz vorhanden ist, was dem Server einen deutlichen Leistungsvorteil bescheren könnte. (Siehe hierzu auch die Direktive SVNInMemoryCacheSize.) Der Standardwert dieser Direktive ist Off.

SVNCacheTextDeltas On|Off

Der Wert On teilt Subversion mit, Deltas von Inhalten zwischenzuspeichern, sofern ausreichend Zwischenspeicherplatz vorhanden ist, was dem Server einen deutlichen Leistungsvorteil bescheren könnte. (Siehe hierzu auch die Direktive SVNInMemoryCacheSize.) Der Standardwert dieser Direktive ist Off.

SVNCompressionLevel level

Spezifiziert den Kompressionsgrad wenn Dateiinhalte über das Netz gesendet werden. Der Wert 0 unterbindet die Kompression vollständig und 9 ist der Maximalwert. 5 ist der Standardwert.

SVNIndexXSLT directory-path

Spezifiziert den URI einer XSL-Transformation für Verzeichnisindexe. Diese Direktive ist optional.

SVNInMemoryCacheSize size

Spezifiziert die Maximalgröße des Zwischenspeichers von Subversion (in kBytes) pro Prozess. Der Standardwert ist 16384; verwenden Sie den Wert 0, um die Zwischenspeicherung vollständig zu unterbinden.

SVNListParentPath On|Off

Wenn sie auf On gesetzt ist, wird ein GET von SVNParentPath erlaubt, was zu einer Auflistung aller Projektarchive unter diesem Pfad führt. Der Standardwert ist Off.

SVNMasterURI url

Der URI des Master-Subversion-Projektarchivs (verwendet für einen Proxy, über den geschrieben wird).

SVNParentPath directory-path

Spezifiziert den Ort im Dateisystem, an dem ein Elternverzeichnis liegt, dessen Kindverzeichnisse Subversion-Projektarchive sind. In einem Konfigurationsblock für ein Subversion-Projektarchiv muss entweder diese Direktive oder SVNPath vorhanden sein, jedoch nicht beide.

SVNPath directory-path

Gibt den Ort im Dateisystem an, an dem die Dateien eines Subversion-Projektarchivs liegen. In einem Konfigurationsblock für ein Subversion-Projektarchiv muss entweder diese Direktive oder SVNParentPath vorhanden sein, jedoch nicht beide.

SVNPathAuthz On|Off|short_circuit

Kontrolliert pfadbasierte Autorisierung, indem Unteranfragen ermöglicht (On) oder abgeschaltet (Off; siehe „Abstellen pfadbasierter Prüfungen“) werden oder bei mod_authz_svn direkt nachgefragt wird (short_circuit). Der Standardwert dieser Direktive ist On.

SVNReposName name

Spezifiziert den Namen eines Subversion-Projektarchivs zur Verwendung für HTTP GET-Antworten. Dieser Wert wird dem Titel aller Verzeichnisauflistungen vorangestellt (die übertragen werden, wenn Sie mit einem Browser zu einem Subversion-Projektarchiv navigieren). Diese Direktive ist optional.

SVNSpecialURI component

Spezifiziert die URI-Komponente (Namensraum) für besondere Subversion-Ressourcen. Der Standardwert ist !svn, und die meisten Administratoren werden diese Direktive nie verwenden. Setzen Sie sie nur, falls die dringende Notwendigkeit besteht, eine Datei namens !svn in Ihrem Projektarchiv zu haben. Falls Sie diese Direktive auf einem Server ändern, der bereits in Gebrauch ist, werden alle offenstehenden Arbeitskopien unbrauchbar gemacht, und Ihre Benutzer werden Sie mit Mistgabeln und Fackeln zur Strecke bringen.