Subversion - FHEM Installation versionieren

2014-05-23T11:54:09Z

Phil: Die Seite wurde neu angelegt: „Die eigene FHEM-installation mit [http://subversion.apache.org/ '''Subversion'''] versionieren. Der Vorteil, man kann jegliche Änderungen, ob Update oder Änd…“

Die eigene FHEM-installation mit [http://subversion.apache.org/ '''Subversion'''] versionieren. Der Vorteil, man kann jegliche Änderungen, ob Update oder Änderungen in den .cfgs, in den Logs nachvollziehen und zu beliebigen Versionsständen aller Files zurück springen.

<div id="Begrüßung" style="float:right; width:400px;">
{| cellspacing="5" cellpadding="5" style="width:100%;font-size:100%;border:2px solid #EE7F00;background-color:#eeeeee;position:relative;{{{style|{{{1|}}}}}}"
| ACHTUNG - Seite noch im Aufbau!!!
* Wünsche & Vorschläge bitte [http://forum.fhem.de/index.php/topic,23890.0.html hier im Forum]
|}
</div>

== Installation / Konfiguration unter Ubuntu & Debian ==
Hier soll aufgezeigt werden, wie man relativ einfach seine FHEM-Installation versioniert.

'''Vorteil:'''
* zu beliebigen Versionen aller Files zurück springen
* im Log des Repository jede Änderung nachvollziehbar
* Files von entfernten Clients auschecken, bearbeiten und wieder einchecken

== Benötigte Software ==
* als Betriebssystem ein Linux (zB. Ubuntu oder Debian)
* einen installierten FHEM Server
* Subversion
* ggf. [http://www.websvn.info/ Websvn]
* ggf. [http://tortoisesvn.net/ Tortoisesvn als Windows Client]

== Subversion installieren ==

=== Installation ===

<nowiki>
root@hostname:~# apt-get update
root@hostname:~# apt-get install subversion
</nowiki>

=== Autostart svnserve Deamon ===

<nowiki>
root@hostname:~# cd /etc/init.d/
root@hostname:~# vi svnserve
</nowiki>

kopiere folgendes in die Datei "svnserve":

<nowiki>
svnserve -d
</nowiki>

Datei ausführbar machen und zu autostart defaults hinzufügen:
<nowiki>
root@hostname:~# cd /etc/init.d/
root@hostname:~# chmod +x svnserve
root@hostname:~# update-rc.d svnserve defaults
</nowiki>

== Konfiguration / Versionieren der FHEM-Installation ==

=== Repository erstellen ===

<nowiki>
root@hostname:~# mkdir /meinpfad/subversion/fhem
root@hostname:~# svnadmin create /meinpfad/subversion/fhem
</nowiki>

=== Benutzerrechte für Repository einrichten ===

<nowiki>
root@hostname:~# vi /meinpfad/subversion/fhem/conf/svnserve.conf
</nowiki>

folgende Zeilen einkomentieren:
<nowiki>
anon-access = none
auth-access = write
password-db = passwd
</nowiki>

Benutzernamen und Passwörter erstellen:
<nowiki>
root@hostname:~# vi /meinpfad/subversion/fhem/conf/passwd
</nowiki>

folgendes Zeilen ergänzen:
<nowiki>
meinbenutzername = meinpasswort
</nowiki>

=== Versionierung der FHEM-Installation ===

<nowiki>
root@hostname:~# service fhem stop
root@hostname:~# mkdir /tmp/fhemcheckouttmp
root@hostname:~# cd /tmp/fhemtmp
##auschecken des FHEM-Repositorys in ein tmp-Verzeichnis
root@hostname:~# svn co file:///meinpfad/subversion/fhem/
##kopieren aller FHEM-Dateien in das ausgecheckte FHEM Repository
root@hostname:~# cp -Rap /opt/fhem/* /tmp/fhemtmp/fhem/.
##svn Status überprüfen alle nicht versionierten Dateien werden mit "?" gekennzeichnet
root@hostname:~# svn status
## alle mit "?" gekennzeichnetten Dateien dem Repository hinzufügen
root@hostname:~# svn add *
## alle hinzugefügten Dateien in das Repository einchecken und ein Kommentar ergänzen
root@hostname:~# svn commit *
root@hostname:~# svn update
## svn status überprüfen, wird nichts mehr angezeigt sind alle Dateien eingecheckt
root@hostname:~# svn status
</nowiki>

FHEM-Verzeichnis durch die Versionierten Dateien ersetzen:

<nowiki>
root@hostname:~# cd /opt
##Backup des FHEM Verzeichnisses, falls etwas schief geht ;-)
root@hostname:~# cp -Rap /opt/fhem/* /opt/fhem.bak/.
##FHEM Verzeichnis löschen
root@hostname:~# rm -r /opt/fhem
##Versionierte FHEM-Installation nach /opt/ auschecken
root@hostname:~# svn co file:///meinpfad/subversion/fhem/
##svn update
root@hostname:~# svn update
##svn status, wird nichts angezeigt ist alles eingecheckt
root@hostname:~# svn status
##FHEM wieder starten, nun sollte alles funktionieren wie vorher
root@hostname:~# service fhem start
</nowiki>

Hat alles funktioniert und FHEM läuft wieder einwandfrei, wird jetzt noch ein wenig aufgeräumt:

<nowiki>
root@hostname:~# rm -r /opt/fhem.bak
root@hostname:~# rm -r /tmp/fhemtmp
</nowiki>

== "wichtigste" Syntax für SVN ==

* svn status
* svn commit
* svn add
* svn checkout

== Anwendungsszenarien ==

=== von entferntem Client z.B. .cfgs bearbeiten: ===
Auf ClientPC (evtl. Windows) wird mit einem SVN-Client (zB. [http://tortoisesvn.net/ Tortoisesvn]) das FHEM Repository ausgecheckt.
Es werden beispielsweise an einigen .cfgs Änderungen vorgenommen und wieder in das Repository eingecheckt.

SVN-Pfad auf entferntem Server:
<nowiki>
svn://server-ip/meinpfad/subversion/fhem
</nowiki>

Nun wieder auf der Shell des FHEM Servers einloggen und folgendes ausführen um dort die Dateien zu aktuallisieren:
<nowiki>
root@hostname:~# cd /opt/fhem
##svn update ausführen um die lokalen Dateien durch die neusten Versionen aus dem Repository zu ersetzen
root@hostname:~# svn update
##Sollten Dateirechte nicht ordnungsgemäß übernommen werden bei den geupdateten Dateien, schafft folgendes abhilfe:
root@hostname:~# chown -r fhem:root /opt/fhem
</nowiki>

=== in FHEMWEB geänderte Dateien z.B. .cfgs in das Repository einchecken ===

Nun wieder auf der Shell des FHEM Servers einloggen und folgendes ausführen um die aktuallisierten Dateien in das Repository einzuchecken:
<nowiki>
root@hostname:~# cd /opt/fhem
##svn status ausführen, die geänderten Dateien werden mit einem vorangestellten M markiert
root@hostname:~# svn status
##svn commit ausführen, um die geänderten Dateien in das Repository einzuchecken
root@hostname:~# svn commit
</nowiki>

=== neu erstellte Dateien oder über ein fhem update erhaltenne neue Dateien dem Repository hinzufügen: ===

Nun wieder auf der Shell des FHEM Servers einloggen und folgendes ausführen um die neuen Dateien dem Repository hinzuzufügen:
<nowiki>
root@hostname:~# cd /opt/fhem
##svn status ausführen, die neuen Dateien werden mit einem vorangestellten ? markiert
root@hostname:~# svn status
##svn add ausführen, um die neuen Dateien in das Repository einzuchecken
root@hostname:~# svn add filename
##svn commit ausführen, um die neu hinzugefügten Dateien in das Repository einzuchecken
root@hostname:~# svn commit
</nowiki>

== Ein- und Auschecken aus der FHEM Oberfläche (FHEMWEB) ==

=== mittels cmdalias ===

TEXT

[[Kategorie:HOWTOS]]

FHEMWiki - Benutzerbeiträge [de]

Subversion - FHEM Installation versionieren