Peter’s OX Admin GUI 0.1.15 (en)

Welcome to the release (v0.1.15) of Peter’s OX Admin GUI for the Open-Xchange Community Edition. Some informations to this project can be found at this thread OX-Forums (german).

This release supports the creation and modification of…

• Contexts
• Users
• Resources
• Groups

Release information: http://oxgui.sciencesoft.at/oxversioninfo.txt

Installation

Important: This version was developed and tested  under  OX6.10,6.12,6.14,6.18.0

Update from 0.1.x to 0.1.15:

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

update the existing bundle

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

and restart the server.

Installation:

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

Add following line
defaultOXguiLang = en_EN to the config file
/opt/open-xchange/etc/psoxgui/psoxgui.properties
to set the default GUI language.

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

Wait some seconds until all components are running...
/opt/open-xchange/sbin/listbundles
Following output should be displayed:

bundlename: org.eclipse.osgi status: ACTIVE bundlename: at.sciencesoft.oxadmingui status: ACTIVE
bundlename: com.openexchange.authentication.database status: ACTIVE
... 

The entry RESOLVED instead of ACTIV indicates a Java library dependency problem. Following command shows the Java dependency which prevents the loading of the bundle. tail -f -n200 /var/log/open-xchange/open-xchange.log.0

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

Manual

Start URL of the GUI:

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

After login please select the menu Context, which displays all existing contexts.

Hint: For existing contexts you must set user and password of the ContextAdmin (Login). Select the context and and apply the menu  ‘Set ContextAdmin’  which asks you for the login data. This addional step isn’t necessary for contexts, which were created by the GUI. Context data – login, default values – are stored according  following schema.

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

Property name is equals OX context ID.

To create/modify a context related user, group or resource you must set an actual context.

The rest of this admin GUI should be self-explanatory 

Configuration files

/opt/open-xchange/etc/psoxgui/

e.g. psoxgui.properties – contains gloabl settings like language, time zone etc

Report Errors & Problems

This version is still beta. Please report any error or problem to following email:

oxgui@sciencesoft.at

Translation

Please help me to improve the translation of the englisch version. Please report any incorrect translation to oxgui@sciencesoft.at.
You can test easily any text change on the fly. Following XML file

/tmp/psoxgui/content.xml

contains all text messages. But be aware, this temporary file will be rewritten after each restart of the OSGI  bundle at.sciencesoft.oxadmingui.jar.

Known Issues

Don’t work with  the admin GUI and an OX user at the same time in the same browser. Both instances share the same JAVA session. Logging of the OX user will also invalidate all session data of the admin GUI.

 

 

Source

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

This is a Netbeans project which contains all necessary sources and libraries. The development enviroment ist Windows. OX  RMI calls are passed with the help of PuTTY and a SSH tunnel through the OX server.