Quelltext der Seite SVN-Server installieren

== SVN (Subversion) auf der DS ==
Subversion ist eine Codeverwaltung, die das gemeinsame Arbeiten an gleichen Codes wesentlich vereinfacht. Subversion übernimmt hierbei das Versionsmanagement der Codes.
== Installation ==
=== Voraussetzungen ===
* [[Die_Kommandozeile|Zugang auf die Kommandozeile (Shell)]]
* [[Der_Editor_vi|Umgang mit einem Editor z.B. vi]]
* [[IPKG|Paketverwaltung ipkg muss installiert sein]]
* Login auf die Shell als '''root''' mit Administrator Passwort

== Netzwerkfreigabe und Synology-Benutzer anlegen==
Im Disk Station Manager (Web GUI) mit Hilfe von Volume Managers eine neue Netzwerkfreigabe Namens "'''svn'''" erstellen.

Einen neuen Synology Benutzer Namens "'''svnowner'''" ohne Passwort anlegen und ihm Schreib-Leserechte für das Verzeichnis "'''svn'''" freigeben. Für den Benutzer sollen am besten alle weiteren Freigaben versperrt bleiben. Zur Not müssen die Rechte nachträglich angepasst werden. Oft sind die falschen Rechte bei den Dateien und Verzeichnissen ein Grund dafür, dass der Server nicht startet.

== Neus SVN Repository anlegen und konfigurieren ==

Einloggen mit [http://www.putty.org/ Putty] als '''root''' mit Adminpasswort.

Die '''Prozentzeichen (%...%)''' deuten auf eine Variable die Sie entsprechend Ihren Bedürfnissen jedoch ohne Prozentzeichen ersetzen sollen.

<pre>login as: root
password: %Adminpasswort%</pre>

Auf der DiskStation IPKG Pakete aktualisieren und das Paket SVN installieren.
<pre>
$ ipkg update
$ ipkg install svn
</pre>

Wechseln ins Verzeichnis /volume1/svn
<pre>cd /volume1/svn</pre>


Das SVN-Verzeichnis erstellen. "'''unser_svn_repo'''" ist der Name von unserem neuen Repository. Wichtig - vollständigen Pfad angeben.

<pre>svnadmin create /volume1/svn/%unser_svn_repo%</pre>

Benutzerrechte für das Verzeichnis /volume1/svn/%unser_svn_repo% anpassen. Rechte mit dem Befehl "dir" überprüfen. Alle Dateien sollen dem User "svnowner" und der Gruppe "users" gehören.
<pre>chown svnowner:users -R %unser_svn_repo%
dir</pre>

In das Verzeichnis /volume1/svn/%unser_svn_repo% wechseln. Eventuell die Struktur wieder mit dem Befehl "dir" kontrollieren.
<pre>cd %unser_svn_repo%
dir</pre>

In das Unterverzeichnis "'''conf'''" in unserem neu erstellten SVN-Repository wechseln. Wieder mit "dir" die Struktur kontrollieren.
<pre>cd conf
dir</pre>

Datei mit der Benutzerdatenbank "/volume1/svn/%unser_svn_repo%/conf/passwd" mit dem Editor VI öffnen.

'''Bemerkung''': Die Konfigurationsdateien können auch in dem freigegebenen Ordner "svn" mit einem Windows-Editor wie [http://notepad-plus-plus.org/ Notepad++] bearbeitet werden.
<pre>vi passwd</pre>

In die Datei 'passwd' zukünftige SVN-Benutzer eintragen. Im Klartext User und Passwort der Benutzer für das Repository eingeben.
<pre>%mein_svn_user1% = %meinpasswort123%
%mein_svn_user2% = %meinpasswort456%
karlheinz = geheim
...</pre>

Editiermodus verlassen, in den Befehlsmodus wechseln.
<pre>Taste "ESC"</pre>

Datei speichern und VI-Editor verlassen (write & quite). 
<pre>:wq</pre>

Für begrenzte Schreib/Leserechte der Datei "passwd" sorgen.
<pre>chmod 600 passwd</pre>

Konfigurationsdatei des neuen SVN Repository "/volume1/svn/%unser_svn_repo%/conf/svnserve.conf" mit dem Editor VI anpassen.
<pre>vi svnserve.conf</pre>

Editor VI in den Editiermodus umschalten.
<pre>i</pre>

Folgendes auskommentieren bzw. ergänzen:
# Rechte für anonyme Benutzer einschränken.
# Angemeldeten Benutzern den Zugang erlauben.
# Bezeichnung der Passwortdatei in der die Benutzer aufgelistet sind.
# Bezeichnung des Repository - optional
<pre>anon-access = none
auth-access = write
password-db = passwd
realm = Mein Repository</pre>

Editiermodus verlassen, in den Befehlsmodus wechseln.
<pre>Taste "ESC"</pre>

Datei speichern und VI-Editor verlassen (write & quite). 
<pre>:wq</pre>

Das Repository ist nun einsatzbereit. Der Server muss noch konfiguriert werden.

== Konfiguration des Servers ==

=== Einrichtung von inet-Daemon ===
Mit dem Editor VI die Datei /etc/inetd.conf bearbeiten:
<pre>vi /etc/inetd.conf</pre>

Folgende Zeile einfügen
<pre>svn stream tcp nowait svnowner /opt/bin/svnserve svnserve -i -r /volume1/svn</pre>

Speichern und schließen:<br /><pre>: wq</pre>

==== Datei "services" anpassen ====

Mit dem Editor VI die Datei /etc/services bearbeiten:
<pre>vi /etc/services</pre>

Am Ende folgende Zeilen einfügen:
<pre>svn             3690/tcp                        #Subversion
svn             3690/udp                        #Subversion</pre>

Speichern und schließen:<br /><pre>: wq</pre>
==== Neustart ====
Nach der Installation ist ein Neustart der DiskStation erforderlich. Das geht manuell per WebGUI oder mit dem Befehl:
<pre>reboot</pre>

== SVN auf Arbeitscomputer aufrufen ==
Am besten geht das mit dem Programm [http://tortoisesvn.net/ Tortoise]. Es ist ein mächtiges Werkzeug, ist kostenlos und kann einfach runterladen und auf den Arbeitscomputer installieren werden. 

Nach dem '''Tortoise''' auf Ihrem Arbeitscomputer installiert ist kann man per '''Rechtsklick auf dem Desktop oder Datei''' das Kontextmenü aufrufen und dort den Punkt "SVN Checkout" aufrufen. Man wird nach dem Benutzernamen und Passwort gefragt. Hier geben Sie den Benutzernamen denn Sie in der Datei mit der Benutzerdatenbank '''/volume1/svn/%unser_svn_repo%/conf/passwd''' eingetragen haben.

Der SVN-Pfad den man eingeben muss lautet folgendermaßen:
<pre>
svn://%ip_von_DS%/%unser_svn_repo%
</pre>
Anschließend wird der Ordner an der entsprechenden Stelle erzeugt und ihr könnt damit arbeiten.

== SVN Repository löschen ==
Wird ein SVN Repository nicht mehr benötigt kann es mit dem einfachen Befehl "rm -r %unser_svn_repo%" gelöscht werden. Das Löschen über die Netzwerkfreigabe reicht ebenfalls aus.

In das SVN Verzeichnis wechseln. Verzeichnisstruktur mit "dir" kontrollieren. Nicht mehr benötigtes Repository löschen.
<pre>cd /volume1/svn
dir
rm -r %unser_svn_repo%"</pre>

== Mit dem SVN Repository auf einen anderen Ort umziehen ==
Beim Systemwechsel, Neuinstallation der DiskStation OS ist es notwendig das Repository zu sichern und wieder neu einzuspielen.

Mit dem Befehl "svnadmin dump..." wird eine Kopie des SVN Repositorys erstellt. Bei diesem Beispiel wird die Dump-Datei im vorher freigegebenen Ordner "public" gespeichert.
<pre>svnadmin dump /volume1/svn/%unser_svn_repo% > /volume1/public/%unser_svn_repo%.dump</pre>

Wiederherstellen auf dem neuen Ort geht mit dem Befehl "load". Das Ziel SVN Repository "unser_svn_repo" muss bereits existieren.
<pre>svnadmin load /volume1/svn/%unser_svn_repo% < /volume1/public/%unser_svn_repo%.dump</pre>

== Probleme und Bemerkungen der User ==

Einmaliges Starten des Servers, geht bei Neustart verloren. Auf Konsole aufrufen: 
<pre>svnserve -d -r %unser_svn_repo%</pre>

Start des SVN-Servers bei Systemstart:

Nach [http://download.synology.com/download/ds/userguide/Synology%20NAS%20Server%203rd-Party%20Apps%20Integration%20Guide.pdf dieser Anleitung] vorgehen und in das eigene Bootscript obigen Code einfügen.

Vorbemerkung: SVN ist erfahrungsgemäß recht ressourcenhungrig. Darum ist es sinnvoller den SVNserver-Daemon nicht die ganze Zeit am Laufen zu haben, sondern nur zu starten, wenn er benötigt wird. Das funktioniert unter Linux/Unix mit dem [http://de.wikipedia.org/wiki/Inetd inet-Daemon].
(...kann ich nicht bestätigen)

Bei mir funktionierte der Start mittels inetd nicht auf Anhieb. Das Problem wurde anscheinend auch [http://forum.synology.com/enu/viewtopic.php?f=44&t=9556 hier] beschrieben.
Es half den inet-Daemon neu zu starten:
<pre>/usr/syno/etc/rc.d/S03inetd.sh stop</pre>
<pre>/usr/syno/etc/rc.d/S03inetd.sh start</pre>

== Links ==
* [http://forum.synology.com/wiki/index.php/Step-by-step_guide_to_installing_Subversion SVN Installation auf http://forum.synology.com/wiki]
* [http://www.synology-forum.de/showthread.html?t=1151 Beitrag im Forum]
* [http://subversion.tigris.org/ Projekt Homepage von Subversion]
* [http://de.wikipedia.org/wiki/Subversion_(Software)#Grafische_Benutzeroberfl.C3.A4chen Beispiele von Clients für svn]
* [http://www.kf-tech.net/synology-nas/21-svn-auf-synology-diskstation.html Originalbeitrag auf www.kf-tech.net]