Das Concurrent Versions System (CVS) dient zur zentralen Verwaltung von Dokumenten in Verzeichnisstrukturen. Eclipse besitzt eine sehr komfortable CVS Integration, daher folgt hier eine kurze Anleitung zur Einrichtung und Bedienung von CVS innerhalb von Eclipse.

Eine Bedienung außerhalb von Eclipse ist über die Kommandozeile möglich. Für die verschiedenen Betriebssysteme werden weitere CVS-Clients mit graphischen Oberflächen angeboten (WinCVS, CVSGui, MacCVS, ...). Weitere Hinweise und Tipps zu CVS sind auf einer separaten Seite zu finden.

Eclipse bietet zwei Verbindungsmethoden

:ext: verwendet einen "externen" SSH-Client, d.h. unter Unix den dort installierten SSH-Client unter Windows muß putty (mit plink) oder OpenSSH installiert sein.
:extssh: ist ein "interner" SSH-Client, der mit Eclipse ausgeliefert wird. Dieser wird über die Einstellungen (Team -> CVS -> SSH2 Connection Method) konfiguriert.

Eine Alternative zu CVS ist das etwas modernere SVN, welches mit Hilfe eines Plugins auch innerhalb von Eclipse verwendet werden kann. Hierfür können wir jedoch keinen weiteren Support bieten. Wir möchten an dieser Stelle jedoch auf "Setting up TortoiseSVN on Windows" von Steffen Kilb hinweisen, welches die Einrichtung spezifisch für die RBG beschreibt.

CVS einrichten

.bashrc ergänzen (im RBG-Pool) Nur relevant, wenn der SSH-Client das CVS-Binary auf dem Server nicht ausführen kann.	Unter dem eigenen Account bei der RBG einloggen. In der Datei .bashrc den Pfad ergänzen, beispielsweise: `export PATH=.:/usr/ncd/bin:/usr/ncd/man:/usr/local/bin:/bin:/usr/bin/X11: /usr/bin:/usr/contrib/bin:/usr/public/bin:/usr/local/bin/X11:/usr/local/bin/X11MIT: /users/iti/bin:/etc:/users/bs/bin/X11:/usr/openwin/bin:/usr/sbin:/usr/ccs/bin:` Alles in einer Zeile! Wichtig ist, daß /usr/local/bin enthalten ist. Wenn nun per ssh ein Kommando ausgeführt wird, wird dieses im obigen Pfad gesucht (was für das CVS-Binary der Fall ist). Man muß .bashrc ergänzen, da .profile und .bash_profile nur von interaktiven Shells ausgewertet werden. Achtung: Dies muß jeder Benutzer machen, der auf das Repository zugreifen will!
SSH einrichten (nur Windows) Falls der "interne" SSH-Client von Eclipse nicht funktioniert.	Aus dem Internet den SSH command line client plink herunterladen (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) und abspeichern. Dann in Eclipse im Menü Window/Preferences wählen und unter Team/CVS/ExtConnectionMethod Plink als CVS_RSH eintragen.
Eclipse: Perspektive wechseln
CVS Repository Exploring wählen
Neue Repository Location anlegen
Verbindungsdaten eingeben Hostname: ultra18.rbg.informatik.tu-darmstadt.de Directory: /home/teammate/cvsrep Wobei teammate ein Gruppenmitglied ist, auf dessen Account das CVS-Repository abgelegt wird. Der gemeinsame Zugriff wird über ACLs umgesetzt. Mehr dazu in der ACL-Anleitung. Dort wird auch beschrieben, wie man das Repository initialisiert. Dies muß vorher geschehen! Connection type: extssh Username: Eigener Username im RBG Password: Eigenes Passwort
Gruppen-Modul auschecken (bzw. natürlich zuerst mal eines einchecken)

Fertig

CVS benutzen

In der JAVA-Ansicht ist nun das Projekt zu finden.

Alle Funktionen des CVS erreicht ihr über das Kontextmenü (rechte Maustaste) unter "Team".

Ihr solltet sämtliche Abgleiche über "Synchronize with repository..." vornehmen.

In der Synchronize-Ansicht seht ihr nun die Dateien, die für euch neu sind (blauer Pfeil nach links) und diejenigen, die ihr verändert habt (schwarzer Pfeil nach rechts). Ihr habt nun die Möglichkeit entweder Dateien aus dem CVS auf euren Rechner zu laden oder eure veränderten Dateien hochzuladen.

Das Hochladen geschieht mit dem Befehl "Commit", das Herunterladen mit "Update" im Kontextmenü

Sollte ein roter Pfeil auftauchen, bedeutet dass, das mehrere Personen an einer Datei gearbeitet haben und per Hand die unterschiedlichen Dateien zusammengefügt werden müssen. Dies geschieht mit dem Menüpunkt "merge"

Erfahrungsgemäß gehen beim "mergen" oft Sachen verloren. Vermeidet daher möglichst dass mehrere Leute gleichzeitig an einer Datei arbeiten.