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.


20 Kommentare »

  1. Hello,

    First, thank you very much for this interface. It made Open-Xchange a viable option for my client. They are not very technical and require everything to be GUI based (no command lines and absolutely no Linux ;-). I was wondering if you could be encouraged to modify the application to work as a Webmin module?

    Thank you,

    Kommentar von Tim Foley — November 17, 2010 @ 9:08 pm

  2. Hi

    Thank you for the gui. It has made OX a lot more useable.

    I have one error when creating a context…

    „java.lang.Exception: com.openexchange.admin.rmi.exceptions.StorageException: com.openexchange.admin.plugins.PluginException: com.openexchange.admin.rmi.exceptions.StorageException: Table ‚configdb.sequence_context‘ doesn’t exist at at.sciencesoft.controller.CreateContext.process( at at.sciencesoft.controller.Main.process( at …..“

    What can be done – new table or edit code?

    many thanks

    Kommentar von David — Dezember 10, 2010 @ 10:06 am

  3. File broken?

    I tried to install the version 0.1.16 but got the following message:

    server: /tmp > tar xfz psoxgui.0.1.16.tar.gz
    tar: A lone zero block at 2471

    I cannot install the version tar unpacked 😦 I think, the file is broken. Can you upload a correct file?



    Kommentar von Max — Dezember 27, 2012 @ 10:57 am

    • Hi!

      I re-tested the archive – and the file is OK. No other user reports any error. Perhaps your local file is corrupted. Please delete the old one and reload the archive from server.

      with best regards

      Kommentar von oxgui — Dezember 28, 2012 @ 8:31 am

      • Hi,
        I’ve tried it on my laptop and on the server – both times the same:
        tar: A lone zero block at 2471

        Can you generate a MD5-sum to check the donwloaded archive


        Kommentar von Max — Januar 5, 2013 @ 7:27 pm

      • Hi!

        md5sum psoxgui.0.1.16.tar.gz
        780f5f044ab9e0367f38930e33a9cc15 psoxgui.0.1.16.tar.gz

        Kommentar von oxgui — Januar 24, 2013 @ 8:09 am

    • Hi,

      it seemed to be a problem caused by tar. I got the same md5sum but had always the zero-block. So I tried it on a virtual machine with wind-os and got it unpacked. Afterwards I packed it local with a linux-tar (of course with a different md5-sum 😉 ) an uploaded it on the server. Now it works!



      Kommentar von Max — Januar 24, 2013 @ 10:55 am

      • Hi!
        You are right, the tar was re-packed unter windows with the tool windows commander. But I haven’t any problem to untar this archive unter debian. Which linux distibution us used?

        Kommentar von oxgui — Januar 25, 2013 @ 7:03 am

  4. openSuSE 12.1 and 12.2

    Kommentar von Max — Januar 25, 2013 @ 9:23 am

  5. I just loaded up version 1.16 on my server – and I got the zero break error as well, though everything seemed to unpack okay. The only issue I have is when I try to log in it tells me incorrect username/password – any thoughts?

    Kommentar von Jake Daynes — März 8, 2013 @ 8:08 pm

    • Hi! You should use following account data for the first login:
      oxadminmaster + password
      After the first login – the GUI supports context logins.

      Kommentar von oxgui — März 8, 2013 @ 8:19 pm

      • I feel like an idiot – it’s working now (I thought I had made the context admin the same as the oxadminmaster (we’re only using one context)) Thanks so much – this is great!

        Kommentar von Jake Daynes — März 8, 2013 @ 10:18 pm

  6. One further thing – when I try to make a change to a user, I just get thrown out to a white screen when I save the changes (URL is )

    Kommentar von Jake Daynes — März 11, 2013 @ 8:44 pm

    • Hi!
      increase this value

      A User reported for a new installation this file can be found at
      Restart groupware

      Kommentar von oxgui — März 11, 2013 @ 9:48 pm

      • Danke nachmittags! That worked and I can now pass this over to my boss (I have no problem with CLI, but he wanted a GUI)! I will confirm the location of was under the groupware folder for a new install.

        Kommentar von Jake Daynes — März 11, 2013 @ 10:56 pm

  7. FYI, in 6.22.2/7.2.0, the AJP max parameters option is now in:
    With the variable name:

    Kommentar von pdf — April 13, 2013 @ 1:14 am

    • Thanks for this hint!

      Kommentar von oxgui — April 13, 2013 @ 9:18 am

  8. Does it work with AppSuite grizzly backend…? I cannot get it work…
    I get something like this in Open-xchange log:

    Registering servlet: com.openexchange.http.deferrer.servlet.DeferrerServlet@7df6a4ec, under: /ajax/defer with context: null
    Aug 05, 2013 4:48:28 PM at.sciencesoft.osgi.OXAdminGuiServletActivator startBundle
    SEVERE: Invalid alias ’servlet/webserver/*‘, have to start with ‚/‘.

    Kommentar von aivarsolins — August 5, 2013 @ 3:08 pm

    • Hi! An old OX installaion including OXGUI migrated to AppSuite works fine. This problem seems to exist for new installation. I will investigate this problem.

      Kommentar von oxgui — August 14, 2013 @ 7:47 am

      • The thing is that if the old OX installation is migrated to AppSuite „as is“ it most probably use the ajp backend (grizzly was not available for v6.X). AppSuite has an option to run either on ajp backend or grizzly backend. The grizzly backend is mandatory if you want to use the new document viewing and editing features, and it is default for the new installations.

        Kommentar von aivarsolins — August 15, 2013 @ 6:05 pm

RSS feed for comments on this post. TrackBack URI

Kommentar verfassen

Trage deine Daten unten ein oder klicke ein Icon um dich einzuloggen:

Du kommentierst mit Deinem Abmelden /  Ändern )

Google+ Foto

Du kommentierst mit Deinem Google+-Konto. Abmelden /  Ändern )


Du kommentierst mit Deinem Twitter-Konto. Abmelden /  Ändern )


Du kommentierst mit Deinem Facebook-Konto. Abmelden /  Ändern )


Verbinde mit %s

Bloggen auf

%d Bloggern gefällt das: