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: http://oxgui.sciencesoft.at/oxversioninfo.txt

Prerequisites

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:
/opt/open-xchange/etc/server.properties
Set
com.openexchange.connector.maxRequestParameters: 30
to the value 300.

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

/opt/open-xchange/etc/ajp.properties
increase this value
AJP_MAX_REQUEST_PARAMETER_COUNT: 30
to
AJP_MAX_REQUEST_PARAMETER_COUNT: 300

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

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

Replace the existing file

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

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: http://oxpedia.org/wiki/index.php?title=Update_to_6_22

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

Replace the existing file

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

against the new OSGI bundle. Copy following file

wget http://oxgui.sciencesoft.at/patch/v0.1.17/at.sciencesoft.oxadmingui.ini

into the directory

/opt/open-xchange/osgi/bundle.d

Then restart the OX server

/etc/init.d/open-xchange restart

New installation

OX 6.20

wget http://oxgui.sciencesoft.at/psoxgui.0.1.16.tar.gz
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

wget http://oxgui.sciencesoft.at/psoxgui.0.1.17.tar.gz
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.
/opt/open-xchange/sbin/listbundles  
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

Deinstallation

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

Manual

Start URL of the GUI:
http://oxserver/servlet/webserver/index.html

login_en

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

context_en

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:

/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.

actual_context_en

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

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.

Sources

OX 6.20: http://oxgui.sciencesoft.at/psoxgui.0.1.16.src.zip

OX 6.22: http://oxgui.sciencesoft.at/psoxgui.0.1.17.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.


Advertisements

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,
    Tim

    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(CreateContext.java:144) at at.sciencesoft.controller.Main.process(Main.java:83) at …..“

    What can be done – new table or edit code?

    many thanks
    david

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

  3. File broken?

    Hi,
    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?

    Regards

    Max

    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
      Peter

      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

        Regards
        Max

        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!

      Great!

      Regards
      Max

      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?
        Peter

        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 http://192.168.1.22/servlet/webserver/index.html?link=modifyuser )

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

    • Hi!
      See: https://oxgui.wordpress.com/2009/10/11/peters-ox-admin-gui-0-1-4-en/
      /opt/open-xchange/etc/ajp.properties
      increase this value
      AJP_MAX_REQUEST_PARAMETER_COUNT: 30
      to
      AJP_MAX_REQUEST_PARAMETER_COUNT: 300

      A User reported for a new installation this file can be found at
      /opt/open-xchange/etc/groupware/ajp.properties
      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 ajp.properties 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:
    /opt/open-xchange/etc/server.properties
    With the variable name:
    com.openexchange.connector.maxRequestParameters

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

    • Thanks for this hint!
      Peter

      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:

WordPress.com-Logo

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

Twitter-Bild

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

Facebook-Foto

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

Google+ Foto

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

Verbinde mit %s

Bloggen auf WordPress.com.

%d Bloggern gefällt das: