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
IPKG SVN Pakete installieren
Wie bei ipkg Pakete üblich geht das mit dem gewohnten "Zweisatz" bei den DS
$ ipkg update $ ipkg install svn
Verzeichnis und Synology-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.
Neus SVN Repository anlegen und konfigurieren
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.)
Wechseln ins Verzeichnis /volume1/svn
cd /volume1/svn
Benutzer wechseln. "Meinuser" ist der Synology-Benutzer mit Administratorrechten jedoch kein root! Das wechseln der Identität funktioniert nicht: Wechseln des login für einen Benutzer
su meinuser
Mit diesem Benutzer das SVN-Verzeichnis erstellen. 'unser_svn_repo' ist der Name des Repository.
svnadmin create /volume1/svn/unser_svn_repo
In das Unterverzeichnis "/conf" im neu erstellten SVN-Repository wechseln.
cd unser_svn_repo/conf
Datei mit der Benutzerdatenbank mit dem Editor VI öffnen.
vi passwd
In die Datei 'passwd' zukünftige SVN-Benutzer eintragen. Im Klartext User und Passwort der Benutzer für das Repository eingeben.
mein_svn_user1 = testpw123 mein_svn_user2 = testpw123 ...
Editiermodus verlassen, in den befehlsmodus wechseln.
Taste "ESC"
Datei speichern und VI-Editor verlassen (write & quite).
:wq
Für begrenzte Schreib/Leserechte der Datei "passwd" sorgen.
chmod 600 passwd
Konfigurationsdatei des neuen SVN Repository mit dem Editor VI anpassen.
vi svnserve.conf</pre< Editor VI in den Editiermodus umschalten. <pre>i
Folgendes auskommentieren bzw. ergänzen:
- Rechte für anonyme Benutzer einschrenken.
- Angemeldeten benutzern den zugang erlauben.
- Bezeichnung der Passwortdatei in der die Benutzer aufgelistet sind.
- Bezeichnung des Repository - optional
anon-access = none auth-access = write password-db = passwd realm = Mein Repository
Editiermodus verlassen, in den befehlsmodus wechseln.
Taste "ESC"
Datei speichern und VI-Editor verlassen (write & quite).
:wq
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
- Mit vi inetd.conf bearbeiten:
vi /etc/inetd.conf
- Folgende Zeile einfügen (zwischen den Wörtern sind Tabs):
svn stream tcp nowait %svnowner% /opt/bin/svnserve svnserve -i -r %repo_ordner%
- Speichern und schließen:
: wq
Bearbeitung services- File
- Mit vi services bearbeiten:
vi /etc/services
- z.B. am Ende folgende Zeilen einfügen (zwischen den Blöcken sind Tabs):
svn 3690/tcp #Subversion
svn 3690/udp #Subversion
- 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.
