Jolokia

From Open-Xchange

How to interact with Jolokia for Open-Xchange

Open-Xchange does support Jolokia as a remote JMX-Bridge over HTTP.

By Version 7.4.0 ongoing, it is located inside Open-Xchange Bundle and configured by jolokia.properties

Additional information can be found at http://www.jolokia.org/ .

jolokia.properties

Key Default value Comment
com.openexchange.jolokia.start false start switch for jolokia
com.openexchange.jolokia.servlet.name /monitoring/jolokia Under what servlet name jolokia will be published, please bear in mind that this should not be forwarded by apache and kept internal
com.openexchange.jolokia.user oxadmin User used for authentication with HTTP Basic Authentication. If not given, no authentication is used.
com.openexchange.jolokia.password secret Password used for authentification, if not set "secret" is used. Only needed if com.openexchange.jolokia.user is used
com.openexchange.jolokia.restrict.to.localhost true This setting will restrict jolokia access to localhost. It is completly ignored when a jolokia-access.xml is present

Things to mention about Jolokia

As Jolokia represents a JMX-Interface it is highly recommended to not forward it to the internet!

Jolokia with Grizzly

When using Grizzly, you can connect to jolokia directly with the servers address, e.g.: http://oxserver1:8009/monitoring/jolokia

Jolokia with AJP

When using AJP, you need to enable forwarding for each server, keep in mind that those should be only accessable inside your intranet.

An Apache proxy_ajp.conf could look like this:

   <Location /internal>
       # restrict access to internal
       Order Deny,Allow
       Deny from all
       Allow from 127.0.0.1
       # you might add more ip addresses / networks here 
       # if the apache is not on the same machine as the OX-server 
       # Allow from 192.168 10 172.16
   </Location>
   ...
   <Proxy /internal/ox1/monitoring>
       ProxyPass ajp://oxhost1:8009/monitoring
   </Proxy>
   ...

Jolokia on oxhost1 is accessable by http://apacheaddress/internal/ox1/monitoring/jolokia .