[svnbook] r4577 committed - Translation: Recommendations

svnbook at googlecode.com svnbook at googlecode.com
Fri Dec 27 05:07:54 CST 2013


Revision: 4577
Author:   jmfelderhoff at gmx.eu
Date:     Fri Dec 27 10:38:45 2013 UTC
Log:      Translation: Recommendations

http://code.google.com/p/svnbook/source/detail?r=4577

Modified:
  /branches/1.6/de/book/ch06-server-configuration.xml

=======================================
--- /branches/1.6/de/book/ch06-server-configuration.xml	Thu Dec 26 22:04:50  
2013 UTC
+++ /branches/1.6/de/book/ch06-server-configuration.xml	Fri Dec 27 10:38:45  
2013 UTC
@@ -450,205 +450,178 @@

  <!--
        <title>The svnserve Server</title>
+-->
+      <title>Der svnserve-Server</title>

        <variablelist>
          <varlistentry>
+<!--
            <term>Why you might want to use it:</term>
-          <listitem>
-            <itemizedlist>
-
-            <listitem><para>Quick and easy to set
-                up.</para></listitem>
-
-            <listitem><para>Network protocol is stateful and
-                noticeably faster than WebDAV.</para></listitem>
-
-            <listitem><para>No need to create system accounts on
-                server.</para></listitem>
-
-            <listitem><para>Password is not passed over the
-                network.</para></listitem>
-
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>Why you might want to avoid it:</term>
-          <listitem>
-            <itemizedlist>
-
-            <listitem><para>By default, only one authentication method
-                is available, the network protocol is not encrypted,
-                and the server stores clear text passwords.  (All these
-                things can be changed by configuring SASL, but it's a
-                bit more work to do.)</para></listitem>
-
-            <listitem><para>No logging of any kind, not even
-                errors.</para></listitem>
-
-            <listitem><para>No built-in web browsing.  (You'd have to
-                install a separate web server and repository browsing  
software to
-                add this.)</para></listitem>
-
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-
-      </variablelist>
-
-    </sect2>
  -->
-
-      <title>Der svnserve-Server</title>
-
-      <variablelist>
-        <varlistentry>
            <term>Gründe, die für eine Nutzung sprechen:</term>
            <listitem>
              <itemizedlist>
-
-              <listitem><para>Das Aufsetzen geht schnell und
-                  einfach.</para></listitem>
-
-              <listitem><para>Das verwendete Netzwerkprotokoll ist
+              <listitem>
+<!--
+                <para>Quick and easy to set up.</para>
+-->
+                <para>Das Aufsetzen geht schnell und einfach.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>Network protocol is stateful and noticeably
+                  faster than WebDAV.</para>
+-->
+                <para>Das verwendete Netzwerkprotokoll ist
                    zustandsorientiert und merklich schneller als
-                  WebDAV.</para></listitem>
-
-              <listitem><para>Es müssen keine lokalen Anwenderkonten auf
-                  dem Server eingerichtet werden.</para></listitem>
-
-              <listitem><para>Das Passwort wird nicht über das
-                  Netzwerk übertragen.</para></listitem>
-
+                  WebDAV.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>No need to create system accounts on
+                  server.</para>
+-->
+                <para>Es müssen keine lokalen Anwenderkonten auf dem
+                  Server eingerichtet werden.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>Password is not passed over the network.</para>
+-->
+                <para>Das Passwort wird nicht über das Netzwerk
+                  übertragen.</para>
+              </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
-
          <varlistentry>
+<!--
+          <term>Why you might want to avoid it:</term>
+-->
            <term>Gründe, warum Sie svnserve eventuell nicht verwenden
              wollen:</term>
            <listitem>
              <itemizedlist>
-
-              <listitem><para>Es gibt standardmäßig nur eine
-                Authentifikationsmethode, das Netzwerkprotokoll ist
-                unverschlüsselt und das Passwort wird vom Server im
-                Klartext gespeichert. (Mit SASL können diese Probleme
-                zwar umgangen werden, dies erfordert aber eine etwas
-                aufwendigere Konfiguration.)</para></listitem>
-
-              <listitem><para>Es wird nichts protokolliert, auch keine
-                Fehler.</para></listitem>
-
-              <listitem><para>Keinen eingebauten Web-Browser-gestützten
-                Lesezugriff. (Wenn Sie dies wünschen, müssen Sie einen
-                eigenständigen Webserver sowie
-                Projektarchiv-Browser-Software
-                installieren.)</para></listitem>
-
+              <listitem>
+<!--
+                <para>By default, only one authentication method is
+                  available, the network protocol is not encrypted,
+                  and the server stores clear text passwords.  (All
+                  these things can be changed by configuring SASL, but
+                  it's a bit more work to do.)</para>
+-->
+                <para>Es gibt standardmäßig nur eine
+                  Authentifikationsmethode, das Netzwerkprotokoll ist
+                  unverschlüsselt und das Passwort wird vom Server im
+                  Klartext gespeichert. (Mit SASL können diese
+                  Probleme zwar umgangen werden, dies erfordert aber
+                  eine etwas aufwendigere Konfiguration.)</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>No advanced logging facilities.</para>
+-->
+                <para>Keine erweiterte Protokollierung.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>No built-in web browsing.  (You'd have to
+                  install a separate web server and repository
+                  browsing software to add this.)</para>
+-->
+                <para>Keinen eingebauten Web-Browser-gestützten
+                  Lesezugriff. (Wenn Sie dies wünschen, müssen Sie einen
+                  eigenständigen Webserver sowie
+                  Projektarchiv-Browser-Software installieren.)</para>
+              </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
-
        </variablelist>

      </sect2>

-
-
-
      <sect2 id="svn.serverconfig.choosing.svn-ssh">
  <!--
        <title>svnserve over SSH</title>
+-->
+      <title>svnserve über SSH</title>

        <variablelist>
          <varlistentry>
+<!--
            <term>Why you might want to use it:</term>
+-->
+          <term>Gründe, die für eine Nutzung sprechen:</term>
            <listitem>
              <itemizedlist>
-
-            <listitem><para>The network protocol is stateful and
-                noticeably faster than WebDAV.</para></listitem>
-
-            <listitem><para>You can take advantage of existing SSH
-                accounts and user infrastructure.</para></listitem>
-
-            <listitem><para>All network traffic is
-                encrypted.</para></listitem>
-
+              <listitem>
+<!--
+                <para>The network protocol is stateful and noticeably
+                  faster than WebDAV.</para>
+-->
+                <para>Das verwendete Netzwerkprotokoll ist
+                  zustandsorientiert und merklich schneller als
+                  WebDAV.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>You can take advantage of existing SSH accounts
+                  and user infrastructure.</para>
+-->
+                <para>Sie können  bestehende Anwenderzugänge des
+                  SSH-Servers verwenden.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>All network traffic is encrypted.</para>
+-->
+                <para>Der gesamte Netzwerkverkehr ist
+                  verschlüsselt.</para>
+              </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
-
          <varlistentry>
+<!--
            <term>Why you might want to avoid it:</term>
-          <listitem>
-            <itemizedlist>
-
-            <listitem><para>Only one choice of authentication
-                method is available.</para></listitem>
-
-            <listitem><para>There is no logging of any kind, not even
-                errors.</para></listitem>
-
-            <listitem><para>It requires users to be in the same system  
group, or
-                use a shared SSH key.</para></listitem>
-
-            <listitem><para>If used improperly, it can lead to file  
permission
-                problems.</para></listitem>
-
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-
-      </variablelist>
-
-    </sect2>
  -->
-
-      <title>svnserve über SSH</title>
-
-      <variablelist>
-        <varlistentry>
-          <term>Gründe, die für eine Nutzung sprechen:</term>
-          <listitem>
-            <itemizedlist>
-
-            <listitem><para>Das verwendete Netzwerkprotokoll ist
-              zustandsorientiert und merklich schneller als
-              WebDAV.</para></listitem>
-
-            <listitem><para>Sie können  bestehende Anwenderzugänge des
-              SSH-Servers verwenden.</para></listitem>
-
-            <listitem><para>Der gesamte Netzwerkverkehr ist
-              verschlüsselt.</para></listitem>
-
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
            <term>Gründe, warum Sie auf diese Konstellation eventuell
              verzichten wollen:</term>
            <listitem>
              <itemizedlist>
-
-            <listitem><para>Es steht nur eine
-              Authentifikationsmöglichkeit zur
-              Verfügung.</para></listitem>
-
-            <listitem><para>Es wird nichts protokolliert, auch keine
-              Fehler.</para></listitem>
-
-            <listitem><para>Die verwendeten Nutzer müssen in derselben
-              Anwendergruppe (auf dem Server) sein, oder sich einen
-              SSH-Schlüssel teilen.</para></listitem>
-
-            <listitem><para>Bei unsachgemäßer Verwendung kann es zu
-              Problemen mit den Dateirechten kommen.</para></listitem>
-
+              <listitem>
+<!--
+                <para>Only one choice of authentication method is
+                  available.</para>
+-->
+                <para>Es steht nur eine Authentifikationsmöglichkeit
+                  zur Verfügung.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>No advanced logging facilities.</para>
+-->
+                <para>Keine erweiterten
+                  Protokollierungsmöglichkeiten.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>It requires users to be in the same system
+                  group, or use a shared SSH key.</para>
+-->
+                <para>Die verwendeten Nutzer müssen in derselben
+                  Anwendergruppe (auf dem Server) sein, oder sich
+                  einen SSH-Schlüssel teilen.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>If used improperly, it can lead to file
+                  permission problems.</para>
+-->
+                <para>Bei unsachgemäßer Verwendung kann es zu
+                  Problemen mit den Dateirechten kommen.</para>
+              </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
@@ -661,121 +634,114 @@

  <!--
        <title>The Apache HTTP Server</title>
+-->
+      <title>Der Apache HTTP Server</title>

        <variablelist>
          <varlistentry>
+<!--
            <term>Why you might want to use it:</term>
+-->
+          <term>Gründe, die für eine Nutzung sprechen:</term>
            <listitem>
              <itemizedlist>
-
-              <listitem><para>It allows Subversion to use any of the
+              <listitem>
+<!--
+                <para>It allows Subversion to use any of the
                    numerous authentication systems already integrated
-                  with Apache.</para></listitem>
-
-              <listitem><para>There is no need to create system accounts on
-                  the server.</para></listitem>
-
-              <listitem><para>Full Apache logging is  
available.</para></listitem>
-
-              <listitem><para>Network traffic can be encrypted via
-                  SSL.</para></listitem>
-
-              <listitem><para>HTTP(S) can usually go through corporate
-                  firewalls.</para></listitem>
-
-              <listitem><para>Built-in repository browsing is
-                  available via web browser.</para></listitem>
-
-              <listitem><para>The repository can be mounted as a network
-                  drive for transparent version control (see
-                  <xref
-                  linkend="svn.webdav.autoversioning"/>).</para></listitem>
-
+                  with Apache.</para>
+-->
+                <para>Subversion hat damit Zugriff auf alle für den
+                  Apache verfügbaren Authentifikationsmethode (und das
+                  sind viele).</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>There is no need to create system accounts on
+                  the server.</para>
+-->
+                <para>Es müssen auf dem Server keine Anwenderkonten
+                  angelegt werden.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>Full Apache logging is available.</para>
+-->
+                <para>Apache protokolliert nach Wunsch (fast)
+                  alles.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>Network traffic can be encrypted via SSL.</para>
+-->
+                <para>Der Netzwerkverkehr kann mittels SSL
+                  verschlüsselt werden.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>HTTP(S) can usually go through corporate
+                  firewalls.</para>
+-->
+                <para>In der Regel lässt sich das HTTP(S)-Protokoll
+                  problemlos durch Firewalls routen.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>Built-in repository browsing is available via
+                  web browser.</para>
+-->
+                <para>Auf das Projektarchiv kann lesend auch via
+                  Web-Browser zugegriffen werden.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>The repository can be mounted as a network
+                  drive for transparent version control (see <xref
+                  linkend="svn.webdav.autoversioning"/>).</para>
+-->
+                <para>Das Projektarchiv lässt sich als Netzlaufwerk
+                  einhängen (mounten). Änderungen an den Dateien
+                  unterliegen trotzdem der Versionskontrolle.  (siehe
+                  <xref linkend="svn.webdav.autoversioning"/>.)</para>
+              </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
-
          <varlistentry>
+<!--
            <term>Why you might want to avoid it:</term>
-          <listitem>
-            <itemizedlist>
-
-            <listitem><para>Noticeably slower than
-                <command>svnserve</command>, because HTTP is a
-                stateless protocol and requires more network
-                turnarounds.</para></listitem>
-
-            <listitem><para>Initial setup can be complex.</para></listitem>
-
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-
-      </variablelist>
-
-    </sect2>
  -->
-     <title>Der Apache HTTP Server</title>
-
-      <variablelist>
-        <varlistentry>
-          <term>Gründe, die für eine Nutzung sprechen:</term>
-          <listitem>
-            <itemizedlist>
-
-              <listitem><para>Subversion hat damit Zugriff auf alle
-                für den Apache verfügbaren Authentifikationsmethode
-                (und das sind viele).</para></listitem>
-
-              <listitem><para>Es müssen auf dem Server keine
-                Anwenderkonten angelegt werden.</para></listitem>
-
-              <listitem><para>Apache protokolliert nach Wunsch (fast)
-                alles.</para></listitem>
-
-              <listitem><para>Der Netzwerkverkehr kann mittels SSL
-                verschlüsselt werden.</para></listitem>
-
-              <listitem><para>In der Regel lässt sich das
-                HTTP(S)-Protokoll problemlos durch Firewalls
-                routen.</para></listitem>
-
-              <listitem><para>Auf das Projektarchiv kann lesend auch
-                via Web-Browser zugegriffen werden.</para></listitem>
-
-              <listitem><para>Das Projektarchiv lässt sich als
-                Netzlaufwerk einhängen (mounten). Änderungen an den
-                Dateien unterliegen trotzdem der Versionskontrolle.
-                (siehe <xref
-                  linkend="svn.webdav.autoversioning"/>.)</para></listitem>
-
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
            <term>Was gegen den Apache Webserver spricht:</term>
            <listitem>
              <itemizedlist>
-
-            <listitem><para>Er ist merklich langsamer als
-              <command>svnserve</command>, da HTTP als zustandsloses
-              Protokoll eine höhere Netzwerklast
-              verursacht.</para></listitem>
-
-            <listitem><para>Die Ersteinrichtung kann etwas schwierig
-              sein.</para></listitem>
-
+              <listitem>
+<!--
+                <para>Noticeably slower than <command>svnserve</command>,
+                  because HTTP is a stateless protocol and requires
+                  more network turnarounds.</para>
+-->
+                <para>Er ist merklich langsamer als
+                  <command>svnserve</command>, da HTTP als
+                  zustandsloses Protokoll eine höhere Netzwerklast
+                  verursacht.</para>
+              </listitem>
+              <listitem>
+<!--
+                <para>Initial setup can be complex.</para>
+-->
+                <para>Die Ersteinrichtung kann etwas schwierig
+                  sein.</para>
+              </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>

        </variablelist>
-  </sect2>
-

+    </sect2>

-  <sect2 id="svn.serverconfig.choosing.recommendations">
+    <!-- ===============================================================  
-->
+    <sect2 id="svn.serverconfig.choosing.recommendations">

  <!--
        <title>Recommendations</title>
@@ -792,17 +758,16 @@

        <itemizedlist>
          <listitem>
-          <para>If you're trying to set up the simplest possible
-            server for your group, a
-            vanilla <command>svnserve</command> installation is the
-            easiest, fastest route.  Note, however, that your
-            repository data will be transmitted in the clear over the
-            network.  If your deployment is entirely within your
-            company's LAN or VPN, this isn't an issue.  If the
-            repository is exposed to the wide-open Internet, you
-            might want to make sure that either the repository's
-            contents aren't sensitive (e.g., it contains only
-            open source code), or that you go the extra mile in
+          <para>If you're trying to set up the simplest possible server
+            for your group, a vanilla <command>svnserve</command>
+            installation is the easiest, fastest route.  Note,
+            however, that your repository data will be transmitted in
+            the clear over the network.  If your deployment is
+            entirely within your company's LAN or VPN, this isn't an
+            issue.  If the repository is exposed to the wide-open
+            Internet, you might want to make sure that either the
+            repository's contents aren't sensitive (e.g., it contains
+            only open source code), or that you go the extra mile in
              configuring SASL to encrypt network communications.</para>
          </listitem>

@@ -810,23 +775,20 @@
            <para>If you need to integrate with existing legacy identity
              systems (LDAP, Active Directory, NTLM, X.509, etc.),
              you must use either the Apache-based server
-            or <command>svnserve</command> configured with SASL.  If
-            you absolutely need server-side logs of either server
-            errors or client activities, an Apache-based server
-            is your only option.</para>
+            or <command>svnserve</command> configured with SASL.</para>
          </listitem>

          <listitem>
-           <para>If you've decided to use either Apache or stock
-             <command>svnserve</command>, create a single
-             <command>svn</command> user on your system and run the
-             server process as that user.  Be sure to make the
-             repository directory wholly owned by the
-             <command>svn</command> user as well.  From a security
-             point of view, this keeps the repository data nicely
-             siloed and protected by operating system filesystem
-             permissions, changeable by only the Subversion server
-             process itself.</para> </listitem>
+          <para>If you've decided to use either Apache or stock
+            <command>svnserve</command>, create a single
+            <command>svn</command> user on your system and run the
+            server process as that user.  Be sure to make the
+            repository directory wholly owned by the
+            <command>svn</command> user as well.  From a security
+            point of view, this keeps the repository data nicely
+            siloed and protected by operating system filesystem
+            permissions, changeable by only the Subversion server
+            process itself.</para> </listitem>

          <listitem>
            <para>If you have an existing infrastructure that is heavily  
based
@@ -900,9 +862,7 @@
            Subversion in diese integrieren möchten, so  bleibt Ihnen
            die Wahl zwischen einer Apache-gestützten Variante oder
            eines mit SASL vermählten <command>svnserve</command>.
-          Stehen serverseitige Protokolldateien zur Aufzeichnung von
-          Client-Aktivitäten und Serverfehlern auf Ihrer Wunschliste,
-          dann ist Apache die einzige Option.</para>
+        </para>
        </listitem>

        <listitem>
@@ -950,7 +910,7 @@
            Projektarchiv offline zu nehmen um eine Inspektion oder ein
            Upgrade durchzuführen.  Zudem kann es Ihnen eine Menge
            Probleme mit den Dateirechten einbringen (siehe <xref
-            linkend="svn.serverconfig.multimethod"/>).  Beachten Sie
+          linkend="svn.serverconfig.multimethod"/>).  Beachten Sie
            bitte auch, dass dies einer der Gründe ist, warum wir vor
            der Verwendung der <literal>svn+ssh://</literal>-Methode für
            den Projektarchiv-Zugriff warnen. Vom Standpunkt der


More information about the svnbook-dev mailing list