|
|
(7 intermediate revisions by 5 users not shown) |
Line 1: |
Line 1: |
− | = How to interact with Jolokia for Open-Xchange=
| + | {{Migration|title=Jolokia|link=https://documentation.open-xchange.com/7.10.0/middleware/components/monitoring/jolokia.html}} |
− | | |
− | 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 ==
| |
− | {|width="100%" style="table-layout: fixed" class='wikitable sortable' border='1' | |
− | ! scope="col" width="30%" | Key
| |
− | ! scope="col" width="20%" | Default value
| |
− | ! scope="col" width="35%" | Comment
| |
− | |-
| |
− | | com.openexchange.jolokia.start
| |
− | | false
| |
− | | start switch for jolokia
| |
− | |-
| |
− | | com.openexchange.jolokia.servlet.name
| |
− | | /monitoring/jolokia
| |
− | | <nowiki>Under what servlet name jolokia will be published, please bear in mind that this should not be forwarded by apache and kept internal</nowiki>
| |
− | |-
| |
− | | com.openexchange.jolokia.user
| |
− | |
| |
− | | <nowiki>User used for authentication with HTTP Basic Authentication. If not given, Jolokia will not start!</nowiki>
| |
− | |-
| |
− | | com.openexchange.jolokia.password | |
− | |
| |
− | | <nowiki>Password used for authentification, if not set "secret" is used.</nowiki>
| |
− | |-
| |
− | | com.openexchange.jolokia.restrict.to.localhost
| |
− | | true
| |
− | | <nowiki>This setting will restrict jolokia access to localhost. It is completly ignored when a jolokia-access.xml is present</nowiki>
| |
− | |}
| |
− | | |
− | Keep in mind that Jolokia will not start unless you set <code> com.openexchange.jolokia.start = true </code> , <code> com.openexchange.jolokia.user = yourUser</code> and to <code> com.openexchange.jolokia.password = yourPassword</code>.
| |
− | | |
− | When using Munin-Scripts with Jolokia, this user and password also need to be changed.
| |
− | | |
− | == Things to mention about Jolokia ==
| |
− | | |
− | As Jolokia represents a JMX-Interface it is highly recommended '''not''' to forward it to the internet!
| |
− | | |
− | This is by default set through the use of <code>com.openexchange.jolokia.restrict.to.localhost = true</code> and can be changed by either setting it to <code>false</code> or providing a <code>jolokia-access.xml</code> inside <code>/opt/open-xchange/etc/</code>
| |
− | | |
− | For further information how to setup this file, http://www.jolokia.org/reference/html/security.html is a good start as all those settings are usable.
| |
− | | |
− | === Jolokia with Grizzly ===
| |
− | | |
− | When using Grizzly, you can connect to jolokia directly with the servers address, e.g.: <code>http://oxserver1:8009/monitoring/jolokia</code>
| |
− | | |
− | === 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:
| |
− | <code>
| |
− | <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>
| |
− | ...
| |
− | </code>
| |
− | | |
− | Jolokia on oxhost1 is accessable by <code>http://apacheaddress/internal/ox1/monitoring/jolokia</code>.
| |
− | | |
− | [[Category:AppSuite]]
| |
− | [[Category:Server]]
| |
− | [[Category:Administrator]]
| |