Deployment

Diese Seite ist eine aktuelle Anleitung zum Deployment von rnp-olev. Damit diese Seite auch wirklich aktuell ist, Änderung bitte immer gleich festhalten.

Da die ganze Sache ein bisschen kompliziert ist, hier erst mal eine Übersicht. Das cvs-Repository liegt im Lehrstuhlnetz unter /proj/rnpadm/Web/cvsroot und ist damit z.B. über die pcheger3 ansprechbar. Tomcat läuft auf dem RNP-Server pcrnp10. Damit man während dem Erstellen der Inhalte auch im kontrollieren kann, ob's läuft, sollte man auch auf der pcrnp10 arbeiten. Zusätzlich bietet sich die Möglichkeit zu Hause zu arbeiten und von dort auf das Repository zuzugreifen.

Um das komplette System auch auf einem Webserver zur Verfügung zu stellen, auf dem Tomcat nicht läuft, kann die Exportfunktion von olev verwendet werden. Diese exportiert das komplette System nach statischen html-Seiten, die man dann per scp auf den Webserver kopieren kann. Dafür sollte am Besten ein eigener Benutzer eingerichtet werden, der immer einen sauberen checkout macht, alles exportiert und dann kopiert. Das kann natürlich auch ein cron-Job machen.

Dieser Abschnitt beschreibt Schritt für Schritt, wie man einen neuen Editor korrekt anlegt (Leute, die olev-Inhalte bearbeiten sind im Sinne des Manuals Editoren). Im Beispiel soll die neue rnp-Tutorin Alice als neue Editorin angelegt werden. Es wird davon ausgegangen, dass bereits ein Login für Alice besteht.

1. Der User alice muss in die Gruppe rnpwww aufgenommen werden, damit sie Zugriff auf das Repository hat.
2. Auf der pcrnp10 muss der user alice angelegt werden und in die dort existierende Gruppe rnpwww aufgenommen werden.
3. Jetzt kann Alice sich auf der pcrnp10 einloggen…
4. … und erstmal folgende Umgebungsvariablen setzen:

   export JAVA_HOME=/usr/java/j2sdk1.4.1_01
   export PATH=$PATH:$JAVA_HOME/bin
   export CVSROOT=:ext:<username>@pcheger3:/proj/rnpadm/Web/cvsroot
   export ANT_HOME=/usr/java/jakarta-ant-1.5.1
   export XSLDOC_HOME=/usr/java/xsldoc
   export PATH=$PATH:$ANT_HOME/bin
   export CATALINA_HOME=/usr/java/jakarta-tomcat-4.1.12
   export CVS_RSH=ssh

5. Der Zugang zur pcheger3 muss per Public Key-Verfahren so konfiguriert sein, dass man sich ohne Passwort einloggen kann (Lehrstuhl-Experten fragen), sonst nervt's ohne Ende.
6. Im Homeverzeichnis des Users muss ein Verzeichnis cvs_local o.Ä. angelegt werden.

Nach diesen Schritten ist alles für die Arbeit mit olev vorbereitet.

Die Arbeit mit olev folgt immer folgenden Zyklus.

1. Auf der pcrnp10 einloggen.
2. Im Homeverzeichnis in das cvs_local-Verzeichnis wechseln.
3. Aktuellen Stand aus dem Repository auschecken mit
   cvs checkout olev_rnp
4. In das Verzeichnis olev_rnp wechseln.
5. Inhalte bearbeiten bzw. hinzufügen.
6. Neuen Stand auf den Tomcat kopieren mit
   ant -Dapp.name=rnp -Dcontent.dir=rnp update
   und das Ergebnis kontrollieren.
7. Schritte 5 und 6 wiederholen bis man fertig ist oder keine Lust mehr hat.
8. Änderungen ins Repository comitten. Dies sollte nach Möglichkeit Datei für Datei mit aussagekräftigen Kommentaren geschehen. Also z.B.
   cvs commit -m "Rechnernamen aktualisiert" prax_ip1.xml

Die olev-Dokumentation ist ebenfalls auf dem pcrnp10 installiert und über http://pcrnp10.rnp:8080/olev zu erreichen. Insbesondere findet man dort auch die olevML-Referenz.

Bei Problem, Fehlern, Vorschlägen,… die mit olev selbst zu tun haben schickt die Beschwerdemails bitte an contact@olev.org, dann kann einer der Verantwortlichen sich direkt darum kümmern.