Peter's OX Server Admin GUI

Oktober 11, 2009

Peter’s OX Admin GUI 0.1.17 (en)

Filed under: Einführung — oxgui @ 4:53 am

Welcome to the release (v0.1.17) of Peter’s OX Admin GUI for the Open-Xchange Community Editionn. Some informations to this project can be found at this thread OX-Forums (german). German version of this installation guide.

This release supports the creation and modification of…

  • Contexts
  • Users
  • Resources
  • Groups

Release information:


Install OX according followig installations guides: OX 6.20 or OX 6.22

Important infos for a new installation and a update of the GUI

For OX 6.22.2 and higher following file/value must be changed:
com.openexchange.connector.maxRequestParameters: 30
to the value 300.

For older OX 6.20.x versions following file must be changed – see forum

increase this value

Update from version 0.1.x to 0.1.16 for a  OX server  version lower than 6.22


Replace the existing file


against the new bundle. Restart the OX Server  But be aware – wget doesn’t overwritte existing files. The new file will be stored with slightly other file name.

New: Update  to 0.1.17 / OX-Server Version 6.22

Update the OX sever according following installation guide:


Replace the existing file


against the new OSGI bundle. Copy following file


into the directory


Then restart the OX server

/etc/init.d/open-xchange restart

New installation

OX 6.20

tar -C / -xvzf  psoxgui.0.1.16.tar.gz
chown -R root:open-xchange /opt/open-xchange/etc/psoxgui

Stop the OX server 
/etc/init.d/open-xchange-groupware stop
/etc/init.d/open-xchange-admin stop
Start the OX server
/etc/init.d/open-xchange-groupware start
/etc/init.d/open-xchange-admin start

OX 6.22

tar -C / -xvzf  psoxgui.0.1.17.tar.gz
chown -R open-xchange:open-xchange /opt/open-xchange/etc/psoxgui

Restart the OX server
/etc/init.d/open-xchange restart

Check the installation

Wait some seconds after the start of the OX server. The OX server should be up and running.
Following bundles should be listed:
bundlename: org.eclipse.osgi status: ACTIVE 
bundlename: at.sciencesoft.oxadmingui status: ACTIVE 
bundlename: com.openexchange.authentication.database status: ACTIVE 

If the GUI bundle shows RESOLVED instead ACTIVE or is missing, then there is lib dependency problem, 
which prevents the loading of the bundle. 

Please review following log files for more informations: 

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


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


Start URL of the GUI:


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 like login, default values, etc. are stored according  following schema:


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


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

Report Errors & Problems

Please report any error or problem to following email:


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


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


OX 6.20:

OX 6.22:

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.


Bloggen auf