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
- 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. Bemerkung: die Konfigurationsdateien konnen auch in dem freigegebenen Ordner mit einem Windows-Editor bearbeitet werden.
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
Editor VI in den Editiermodus umschalten.
i
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
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
Das Repository ist nun einsatzbereit. Der Server muss noch konfiguriert werden.
Konfiguration des Servers
Einrichtung inet-Daemon
Mit vi inetd.conf bearbeiten:
vi /etc/inetd.conf
Folgende Zeile einfügen
svn stream tcp nowait svnowner /opt/bin/svnserve svnserve -i -r /volume1/svn
Speichern und schließen:
: wq
Bearbeitung services- File
Mit vi services bearbeiten:
vi /etc/services
Am Ende folgende Zeilen einfügen:
svn 3690/tcp #Subversion svn 3690/udp #Subversion
Speichern und schließen:
: wq
Neustart
Nach der Installation ist ein Neustart der DiskStation erforderlich.
reboot
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%/%unser_svn_repo%
Anschließend wird der Ordner an der entsprechenden Stelle erzeugt und ihr könnt damit arbeiten.
Probleme
Einmaliges Starten des Servers, geht bei Neustart verloren. Auf Konsole aufrufen:
svnserve -d -r %unser_svn_repo%
Start des SVN-Servers bei Systemstart:
Nach 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 under Linux/Unix mit dem inet-Daemon. (Das kann ich nicht bestättibgen.)
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
