Pakete installieren¶

Die folgenden Pakete sind zusätzlich zu installieren ^[1]:

• subversion

• libapache2-svn (optional für den Webserver nötig)

Subversion zur Installation neuer Software nutzen¶

Viele Entwickler bieten die Möglichkeit, ihre Software über Subversion (SVN) zu nutzen. Dabei wird im Prinzip nichts anderes gemacht, als die Software via SVN herunterzuladen und sie für das Kompilieren abzulegen. Vorteil dabei ist, dass man so ganz einfach den einmal heruntergeladenen Quellcode über SVN aktualisieren kann, um dann eine neue Version der Software zu Kompilieren und zu installieren.

Über

svn checkout http://localhost/svn/projekt1/trunk/ /home/user/projekt1 #checkt trunk-Zweig von projekt1 aus 

wird der Quellcode einer Software (hier Projekt1) heruntergeladen und in ein Verzeichnis "projekt1" im Persönlichen Ordner abgelegt. Alternativ lässt sich dafür auch ein grafisches Programm (siehe weiter unten) nutzen.

Anschließend kann nun dort die Software mit

./configure
make
sudo make install 

kompiliert und installiert werden. Dabei ist ggf. auf zusätzliche Parameter für ./configure zu achten.

Aufsetzen eines Repositories¶

Zur Zeit setzt das Subversion-Paket kein Repository auf, man muss es manuell erzeugen. Eine mögliche Stelle für ein Repository ist in /var/local/svn. Dafür öffnet man ein Root-Terminal ^[3] und führt die folgenden Befehle aus.

mkdir -p /hier/gewünschter/pfad/svn 

svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn 

mkdir -p /var/local/svn 

svnadmin create --fs-type fsfs /var/local/svn 

 chown -R www-data:www-data /var/local/svn 

a2enmod dav_svn 

     <Location /svn>
       DAV svn
       SVNPath /var/local/svn
     </Location>

sudo /etc/init.d/apache2 restart 

mkdir -p /var/local/svn/project1
mkdir -p /var/local/svn/project2 

svnadmin create --fs-type fsfs /var/local/svn/project1
svnadmin create --fs-type fsfs /var/local/svn/project2 

 chown -R www-data:www-data /var/local/svn 

     <Location /svn>
       DAV svn
       SVNParentPath /var/local/svn
     </Location>

sudo /etc/init.d/apache2 restart 

a2enmod dav_svn 

     <Location /svn>
       DAV svn
       SVNPath /var/local/svn
       AuthType Basic
       AuthName "Subversion repository"
       AuthUserFile /etc/apache2/dav_svn.passwd
       <LimitExcept GET PROPFIND OPTIONS REPORT>
         Require valid-user
       </LimitExcept>
     </Location>

sudo htpasswd /etc/apache2/dav_svn.passwd ein-Nutzer 

sudo /etc/init.d/apache2 restart 

mkdir -p /tmp/projekt1/trunk
mkdir -p /tmp/projekt1/tags
mkdir -p /tmp/projekt1/branches 

cp -R /projekt_ohne_svn/* /tmp/projekt1/trunk 

svn import /tmp/projekt1 file:///hier/gewuenschter/pfad/svn/projekt1 -m "initialer Import" 

svn import /tmp/projekt1 http://localhost/svn/projekt1 -m "initialer Import" 

svn import /tmp/projekt1 http://localhost/svn/projekt1 -m "initialer Import" --username ein-Nutzer 

svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn/projekt1
svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn/projekt2
svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn/projekt3 

 <Location /svn>
   ...      
   AuthzSVNAccessFile /etc/apache2/dav_svn.authz
  ...
  </Location>

<LimitExcept GET PROPFIND OPTIONS REPORT>
  ...
</LimitExcept>

<Location /svn>
   ...   
   Require valid-user
   ...
</Location>

<Location /svn>
       DAV svn
       SVNPath /var/svn

       AuthzSVNAccessFile /etc/apache2/dav_svn.authz

       Require valid-user

       AuthType Basic
       AuthName "Subversion repository DESADV"
       AuthUserFile /etc/apache2/dav_svn.passwd
</Location>

      [groups]
      admin = username1,username2, ...
      gruppe2 = username3,username4, ...

      [projekt1:/]
      @admin = rw
      @gruppe2 = r

      [projekt2:/]
      @gruppe2 = rw

      [projekt3:/]
      @admin = rw

      [groups]
      admin = username1,username2, ...
      gruppe2 = username3,username4, ...

      [projekt1:/]
      username1 = r
      @gruppe2 = rw

      ...

      ...
      [projekt1:/]
      * = r
      ...

      ...
      [projekt2:/der/zu/schuetzende/pfad]
      username3 = r
      ...

Subversion-Befehle¶

Die Befehle müssen im Projektverzeichnis ausgeführt werden, sonst weiß Subversion nicht, was gemeint ist.

svn checkout file:///hier/gewuenschter/pfad/svn/projekt1/trunk/ /home/user/projekt1 #checkt trunk-Zweig von projekt1 aus bei lokaler Verwendung
svn checkout http://localhost/svn/projekt1/trunk/ /home/user/projekt1 #checkt trunk-Zweig von projekt1 aus bei Verwendung des Apache
svn diff                  #zeigt die Unterschiede an
svn commit -m "Kommentar" #die Arbeitskopie wird auf den Server übertragen
svn update                #damit wird die Arbeitskopie auf die Version vom Server aktualisiert 
svn help                  #Hilfe 

svnadmin dump /var/local/svn/ > dumpfile
svnadmin load /var/local/svn/ < dumpfile 

Subversion-Keywords¶

Die Keywords von Subversion dienen dazu um bspw. die aktuelle Revision eines Dokumentes anzuzeigen.

Folgende sind verfügbar:

• $Id:$ - Dateiname Revision Letzte-Bearbeitung Ersteller

• $Rev:$ - Gibt die aktuelle Revision aus

• $Author:$ - Gibt den aktuellen Ersteller aus

• $Date:$ - Gibt den Zeitpunkt der letzten Bearbeitung aus

Beispielausgabe

/*
 * $Id: helloworld.c 1 2009-07-04 10:00:00Z mewis $
 * $Rev: 1 $:
 * $Author: mewis $
 * $Date: 2009-07-04 10:00:00Z (Sat, 04 Jul 2009) $
 */

Um den gewünschten Effekt in einem Dokument zu erreichen gibt man im Terminal^[3] folgendes ein:

svn propset svn:keywords "Id Rev Author Date" helloworld.c 

enable-auto-props = yes
[auto-props]
*.c = svn:eol-style=native;svn:keywords=Date Author Id Revision HeadURL
*.css = svn:eol-style=native;svn:keywords=Date Author Id Revision HeadURL
*.java = svn:eol-style=native; svn:keywords=Id Author Date Revision
*.properties = svn:eol-style=native
*.sh = svn:eol-style=native;svn:executable
*.txt = svn:eol-style=native
*.xml = svn:eol-style=native
*.php = svn:eol-style=native; svn:keywords=Id Author Date Revision

sudo /etc/init.d/apache2 restart 

Subversion komfortabel - kdesvn¶

Das folgende Paket ist zusätzlich zu installieren ^[1]:

• kdesvn (universe ^[2])

Kdesvn ist ein Programm der Desktopumgebung KDE. Es werden daher über die Abhängigkeiten weitere Pakete der KDE installiert.

Das Programm wird gestartet über:

• "K-Menü -> Entwicklung -> Graphische Oberfläche für SVN (kdesvn)"

Falls die Fehlermeldung "PROPFIND Anfrage fehlgeschlagen" erscheint, muss ein SSL-Zertifikat eingerichtet werden. Das folgende Paket ist zusätzlich zu installieren ^[1]:

• ssl-cert

Dann kann das Zertifikat hiermit erstellt werden:

sudo mkdir /etc/apache/ssl
sudo /usr/sbin/make-ssl-cert /usr/share/ssl-cert/ssleay.cnf /etc/apache2/ssl/apache.pem 

svnserve¶

Svnserve mit einem init-Skript automatisch starten. Im folgenden init-Skript müssen mit einem Editor ^[4] noch die Variablen "SVN_USER", "SVN_GROUP" und "SVN_REPO_PATH" angepasst werden. Das Script sollte dann unter dem Namen svnserve im Verzeichnis /etc/init.d/ gespeichert werden.

#!/bin/sh -e
#
# svnserve - brings up the svn server so anonymous users
# can access svn
#

# Get LSB functions
. /lib/lsb/init-functions
. /etc/default/rcS

SVNSERVE=/usr/bin/svnserve
SVN_USER=<benutzername>
SVN_GROUP=<gruppe>
SVN_REPO_PATH=/var/local/svn
# Check that the package is still installed
[ -x $SVNSERVE ] || exit 0;

case "$1" in
    start)
        log_begin_msg "Starting svnserve..."
        umask 002
        if start-stop-daemon --start      \
            --chuid $SVN_USER:$SVN_GROUP  \
            --exec $SVNSERVE              \
            -- -d -r $SVN_REPO_PATH; then
            log_end_msg 0
        else
            log_end_msg $?
        fi
        ;;

    stop)
        log_begin_msg "Stopping svnserve..."
        if start-stop-daemon --stop --exec $SVNSERVE; then
                log_end_msg 0
        else
                log_end_msg $?
        fi
        ;;

    restart|force-reload)
        "$0" stop && "$0" start
        ;;

    *)
        echo "Usage: /etc/init.d/svnserve {start|stop|restart|force-reload}"
        exit 1
        ;;
esac

exit 0

Das script kann auch mit folgendem Befehl direkt in das richtige Verzeichnis heruntergeladen werden.

sudo wget -P /etc/init.d -O svnserve http://media.ubuntuusers.de/wiki/attachments/46/28/svnserve__.init 

Nachdem das Script nun am richtigen Platz ist muss Dieses noch ausführbar gemacht und als Dienst eingetragen werden. Hierfür sind die folgenden Befehle auszuführen

sudo chmod +x /etc/init.d/svnserve
sudo update-rc.d svnserve defaults
sudo /etc/init.d/svnserve start 

Subversion kompilieren¶

Benötigt werden die Pakete

• build-essential

• libapr1-dev

• libaprutil1-dev

• libneon27-dev

sudo apt-get install build-essential libapr1-dev libaprutil1-dev libneon27-dev 

sudo aptitude install build-essential libapr1-dev libaprutil1-dev libneon27-dev 

Subversion herunterladen und in entsprechendes Verzeichnis wechseln:

./configure --with-ssl --enable-javahl --with-jdk=/usr/lib/jvm/java-6-sun
make
make javahl
sudo make install install-javahl 

Links¶

• Version Control with Subversion - freies Buch über Subversion

• Subversion_(Software)

• Subversion software project

• Nautilus-Plugin RabbitVCS

• Subversion (SVN) einrichten von A bis Z - Blogbeitrag 01/2011