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. Der Beitrag basiert auf diesem Thread im Forum von Toscman

Installation

Voraussetzungen

• Zugang auf die Kommandozeile (Shell)
• Umgang mit einem Editor z.B. vi
• Paketverwaltung ipkg muss installiert sein
• Login auf die Shell als root mit Administrator Passwort

Pakete installieren

Wie bei ipkg Pakete üblich geht das mit dem gewohnten "Zweisatz" bei den DS

$ ipkg update
$ ipkg install svn

Verzeichnis und Benutzer anlegen

Im Disk Station Manager (Web GUI) mit Hilfe von Volume Managers eine neue Netzwerkfreigbe svn erstellen. Einen neuen Benutzer svnowner ohne Passwort anlegen und ihm Schreib- Leserechte für das Verzeichnis svn freigeben.

Konfiguration + Einrichten

1. Einloggen mit Putty als root (wirklich Namen mit "root" angeben und Adminpasswort, Putty ist ein kleines Tool, mit dem man sich komfortabel auf die DS verbinden kann.)

2. Wechseln ins Verzeichnis /volume1/svn

cd /volume1/svn

3. Benutzer wechseln. User ist der entsprechende Synology Adminbenutzer, kein root! Das wechseln der Identität funktioniert nicht: Wechseln des login für einen Benutzer

su %user%

4. Mit diesem Benutzer das SVN-Verzeichnis erstellen. 'unser_svn_repo' ist der Name des Repository.

svnadmin create /volume1/svn/unser_svn_repo

1. cd unser_svn_repo/conf (In das Verzeichnis '/conf' wechseln)
2. vi passwd (In die Datei 'passwd' neuen SVN-Benutzer eintragen)
3. mein_svn_user = testpw123 (Im Klartext User und Passwort der Benutzer für das Repository eingeben)
4. "ESC" (Editiermodus verlassen, in den befehlsmodus wechseln.)
5. :wq (write & quite - Datei speichern und VI-Editor verlassen.)
6. chmod 600 passwd (Für Schreib/Leserechte für die Datei 'passwd' sorgen.)
7. vi svnserve.conf
8. i (Editor VI in den Editiermodus umschalten.)
9. anon-access = none # Rechte für anonyme Benutzer einschrenken.
10. auth-access = write # Angemeldeten benutzern den zugang erlauben.
11. password-db = passwd (Bezeichnung der Passwortdatei in der die Benutzer aufgelistet sind.)
12. realm = Mein Repository (Bezeichnung des Repository - optional.)
13. "ESC" (Editiermodus verlassen, in den befehlsmodus wechseln.)
14. :wq (write & quite - Datei speichern und VI-Editor verlassen.)

Start des Servers

Einmalig (geht verloren bei reboot)

Auf Konsole aufrufen: svnserve -d -r %repos_ordner%

Start des SVN-Servers bei Systemstart

Nach dieser Anleitung vorgehen und in das eigene Bootscript obigen Code einfügen.

Einbinden des Servers auf "elegante" Weise

siehe Originaleintrag im englischen Wiki hier

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 under Linux/Unix mit dem inet-Daemon.

Einrichtung inet-Daemon

1. Mit vi inetd.conf bearbeiten:
   

   vi /etc/inetd.conf

2. Folgende Zeile einfügen (zwischen den Wörtern sind Tabs):
   

   svn stream tcp nowait %svnowner% /opt/bin/svnserve svnserve -i -r %repo_ordner%

3. Speichern und schließen:
   

   : wq

Bearbeitung services- File

1. Mit vi services bearbeiten:
   

   vi /etc/services

2. z.B. am Ende folgende Zeilen einfügen (zwischen den Blöcken sind Tabs):
   

   svn             3690/tcp                        #Subversion

   svn             3690/udp                        #Subversion

3. Speichern und schließen:
   

   : wq

Neustart

reboot

Probleme

Bei mir funktionierte der Start mittels inetd nicht auf Anhieb. Das Problem wurde anscheinend auch hier beschrieben. Es half den inet-Daemon neu zu starten:

/usr/syno/etc/rc.d/S03inetd.sh stop

/usr/syno/etc/rc.d/S03inetd.sh start

SVN auf Clienten aufrufen

Das geht am besten mit dem Programm Tortoise. Ist kostenlos im Internet erhältlich. Einfach runterladen und installieren. Anschließend kann man per Rechtsklick das Kontextmenü aufrufen und dort den Punkt "SVN Checkout" aufrufen.

Der SVN-Pfad den man eingeben muss lautet folgendermaßen:

svn://%ip_von_DS%/%repos_ordner%

Anschließend wird der Ordner an der entsprechenden Stelle erzeugt und ihr könnt damit arbeiten.

Links

• Beitrag im Forum
• Projekt Homepage von Subversion
• Beispiele von Clients für svn