Peter’s OX Server Admin GUI Release v0.1.15 (Stand: 2011/05/25

English version of this text.

Willkommen zu der Release (v0.1.15) von meiner Administrations-Oberfläche für die Open-Xchange Community Edition. Hintergründe zu diesem Projekt sind im folgenden Thread des OX-Forums zu finden.

Diese Release beinhaltet folgende Funktionalität – Verwaltung von

• Kontexten
• Benutzern
• Ressourcen
• Gruppen

Release-Information: http://oxgui.sciencesoft.at/oxversioninfo.txt

Installation

Voraussetzungen: Der OX-Server muss den Wiki-Anleitungen entsprechend bis zu dem Punkt Creating contexts and users aufgesetzt worden sein: SQL-Server, Apache, OXadmin, Filestore, etc. müssen entsprechend der Anleitung konfiguriert worden sein.
Wichtig: Diese Version wurde gegen  OX6.10,6.12 ,6.14,6.18.0 getestet & entwickelt. Auf keinen Fall diese GUI unter OX6.8 installieren, da sich  OSGI-INI-Dateien von OX6.8 auf OX6.10 geändert haben.

Update von Version 0.1.x auf 0.1.15:

wget http://oxgui.sciencesoft.at/patch/v0.1.15/at.sciencesoft.oxadmingui.jar

existierendes Bundle

/opt/open-xchange/bundles/at.sciencesoft.oxadmingui.jar

gegen neues Bundle austauschen, und OX Server neu starten.  Aber Achtung – wget überschreibt keine existierende Dateien, sondern legt die neuere Datei unter anderem Namen ab.

Neuinstallation:

wget http://oxgui.sciencesoft.at/psoxgui.0.1.15.tar.gz
tar -C / -xvzf  psoxgui.0.1.15.tar.gz
chown -R open-xchange:open-xchange /opt/open-xchange/etc/psoxgui

OX beenden
/etc/init.d/open-xchange-groupware stop
/etc/init.d/open-xchange-admin stop
 OX neustarten /etc/init.d/open-xchange-groupware start
/etc/init.d/open-xchange-admin start

Einige Sekunden warten, bis alle Komponeten des OX-Servers laufen...
/opt/open-xchange/sbin/listbundles
 Sollte folgende Ausgabe auf dem Bildschirm bewirken:
bundlename: org.eclipse.osgi status: ACTIVE
bundlename: at.sciencesoft.oxadmingui status: ACTIVE
bundlename: com.openexchange.authentication.database status: ACTIVE
...

Wenn beim oxadmingui Bundle RESOLVED statt ACTIVE steht, dann besteht ein Problem bezüglich der Java-Abhängigkeiten. Folgender Befehl zeigt an, welche Java-Abhängigkeit das erfolgreiche Laden des Bundles verhindert hat.

tail -f -n200 /var/log/open-xchange/open-xchange.log.0

Es sollten aber keine Probleme bezüglich Abhängigkeiten auftreten. Unter OX 6.8.0 gab es Probleme mit globalen Imports bezüglich Java Swing Komponenten, die seitens der Template-Engine freemarker referenziert wurden.

Deinstallation

rm /opt/open-xchange/bundles/at.sciencesoft.oxadmingui.jar
rm /opt/open-xchange/lib/freemarker.jar
rm -r /opt/open-xchange/etc/psoxgui/
rm /opt/open-xchange/etc/groupware/osgi/bundle.d/at.sciencesoft.oxadmingui.ini

Anleitung

Folgender Link öffnet die Login-Seite:

http://oxserver/servlet/webserver/index.html

Nach dem Anmelden das Menü Kontext auswählen, das alle bestehende Kontexte auflistet.

Wichtig: Für schon bestehende Kontexte muss nachträglich einmalig der ContextAdmin (=Login) gesetzt werden. Kontext auswählen und das Menü ContextAdmin aufrufen, das Benutzer und Passwort abfragt. Für Kontexte, die über die GUI erzeugt wurden, ist dieser Vorgang nicht von Nöten. Die Kontext-Daten – Login, Default-Values – werden im Verzeichnis nach dem Schema

/opt/open-xchange/etc/psoxgui/context/1.properties

gespeichert, wobei der Property-Name gleich der internen Kontext ID ist.

Um Benutzer bearbeiten zu können, muss ein aktueller Kontext gesetzt werden.

Die restliche Funktionalität sollte eigentlich selbsterklärend sein

Konfigurationsdateien

/opt/open-xchange/etc/psoxgui/

z.B. psoxgui.properties – beinhaltet globale Einstellungen für Sprache, Zeitzone etc.

Fehler melden/Wünsche/Beschwerden..

Das Servlet versucht alle auftretenden Fehler entsprechend zu behandeln – inklusive Ausgabe der Fehlermeldung auf dem Bildschirm. Dies triff auch auf  die Initialisierungphase des Servlets zu.
Fehler während dieser Phase werden auch in die Datei /tmp/psoxgui/psoxgui_stacktrace.txt geschrieben.

Bitte diese Fehlermeldungen an folgende E-Mail-Adresse melden:

oxgui@sciencesoft.at

Oder alternativ per Antwort in der Kategorie Bug-Report. In dieser Kategorie werden auch alle akutell bekannten Fehler aufgelistet.

Bekannte Probleme

Gleichzeitiges Arbeiten in der Admin-GUI und als OX-Benutzer in der gleichen Browserinstanz ist nicht zu empfehlen, da sich beide die gleiche Servlet-Session teilen. z.B Logge ich mich als Benutzer aus, so wird auch die Admin-GUI Session beendet.

 

 

Sourcen

http://oxgui.sciencesoft.at/psoxgui.0.1.15.src.zip

Dies ist ein Netbeans-Projekt, das alle Sourcen & Libs beinhaltet. Ich entwickle dieses Projekt unter Windows. RMI Aufrufe werden mit Hilfe von PuTTY und einem SSH- Tunnel an den OX-Server durchgereicht. Zu einem späteren Zeitpunkt werde ich die Entwicklungsumgebung genauer erläutern.

Sourcen der Java ISPconfig3 Library: (JAVA->SOAP->ISPconfig3)

http://oxgui.sciencesoft.at/ISPconfig3.zip