Die gesamte Administration der Centaurus-Platform soll extern erfolgen können. Der zugrundeliegende Tomcat 5 basiert auf dem JMX API und seinen MBeanServer kann auch Remote verfügbar gemacht werden. Die Tomcat Admin-Anwendung beruht auf einem entsprechenden MBean API.

Die Admin-Anwendung hat leider einige Einschänkungen in der Pflege und Manipulation der MBeans. Leider arbeitet die Anwendung nicht generisch und ist auch nicht in der Lage eigene Erweiterungen zu integrieren. Der Standard Http-Adaptor der sich in der Datei jk2.properties aktivieren läßt, ist vollständig ungesichert und damit problematisch im Interneteinsatz.

Das von der Centaurus-Platform genutze MX4J-Projekt bringt einen Http-Adaptor und einen Remote-Connector auf der Basis des JSR 160 mit. Wir haben uns erstmal zur Unterstützung des Http-Adators entschlossen. Mit diesem Adaptor kommt man aktuell durch die meisten Firewalls und kann somit eine erweitertet Remote-Administration der Centaurus-Platform ermöglichen. Folgende Eigenschaften sind mit dem JmxAdaptor realisiert:

Klicken Sie auf das Bild für die Vollansicht

Wir nutzen die JMX-Bibliotheken des MX4J-Projekts. Der JmxAdaptor hat sehr viele Parameter, die Sie für Ihre Bedürfnisse anpassen können. Es ist sogar möglich, gleichzeitig verschiedene JmxAdaptoren in einem Server mit unterschiedlichen Konfigurationen zu betreiben. Die Integration in den Tomcat erfolgt über die Datei ${centaurus.base}/conf/server.xml.
Suchen Sie dort den entsprechenden Listener-Eintrag:
<Listener className="de.centaurus.platform.plugins.jmxadaptor.MX4JHttpAdaptorLifecycleListener" ... />
Nach der Standardinstallation steht der JmxAdaptor unter dem Port 9000 bereit. Als Autorisierung gilt Ihr Admin-Account und die HTML-Ausgabe ist aktiv.

Klicken Sie auf das Bild für die Vollansicht

Für die Konfiguration einer SSL-Verbindung generieren Sie einen eigenen Java-Keystore oder importieren bitte ein offizielles Zertifikat. Ein Testzertifikat können Sie mit dem Skript $centaurus.base/scripts/jmxadaptor/genkey.xml erstellen. Die Parameterisierung kann direkt im Skript oder besser in einer eigenen Datei build.properties erfolgen.

scripts/jmxadaptor/build.properties

mx4j.storepass=changeit
mx4j.keypass=changeit
mx4j.keystore=mx4j.keystore
mx4j.host=localhost
mx4j.unit=Software Deveploment
mx4j.org=Centaurus-Platform 
mx4j.city=Bochum
mx4j.code=DE
                

Leider muss sich das Zertifikat für den MX4J Http-Adaptor im System-ClassPath befinden. Mit dem Aufruf des folgenden Ant-Skript wird Ihr Testzertifikat generiert und in ein Java Archiv (JAR) gepackt: ant -f genkey.xml serverkey.jar . Die Konfiguration des System-ClassPath erfolgt, nach der Kopie des Testzertifikat-Jars nach $centaurus.base/bin, in der Datei $centaurus.base/conf/wrapper.xml.

<property name="wrapper.java.classpath.7"
    value="${centaurus.base}/bin/mx4j.keystore.jar"></property>
                

Als letzten Schritt erfolgt nun die Konfiguration der SSL-Parameter im Listener:

<Listener
    className="de.centaurus.platform.plugins.jmxadaptor.MX4JHttpAdaptorLifecycleListener"
    enabled="true"
    mx4jDomain="MX4JHttp" 
    httpPort="9000"
    httpHost="localhost"
    xslProcessor="true"
    xslPathInJar="mx4j/tools/adaptor/http/xsl"
    adaptorClassName="de.centaurus.platform.plugins.jmxadaptor.CentaurusHttpAdaptor"
    processorClassName="mx4j.tools.adaptor.http.XSLTProcessor"
    user="manager"
    password="tomcat"
    realmMode="true"
    realmMBeanName="Catalina:type=Realm,host=localhost"
    realmAllowedRole="admin"
    ssl="true"
    keyStoreType="JKS"
    keyStoreName="mx4j.keystore"
    keyStorePassword="changeit"
    keyManagerAlgorithm="SunX509"
    keyManagerPassword="changeit"
    sslProtocol="TLS"
    factoryClassName="mx4j.tools.adaptor.ssl.SSLAdaptorServerSocketFactory"
   >
 </Listener>
            

Die XML-Ausgabe wird folgendermaßen aktiviert:

 <Listener
     className="de.centaurus.platform.plugins.jmxadaptor.MX4JHttpAdaptorLifecycleListener"
     ...
     xslProcessor="false" 
     processorClassName="mx4j.tools.adaptor.http.DefaultProcessor"
     ...
    >
</Listener> 
                 

Klicken Sie auf das Bild für die Vollansicht

Folgende Parameter können Sie konfigurieren:

Allgemeine Parameter

Parameter für Filterung der Ausgabe

Autorisierungsinformationen

SSL-Parameter

Die exakte Dokumentation aller MX4J-Befehle mit weiteren Beispielen finden Sie aktuell in der MX4-HttpAdaptor- Dokumentation.

JMX-Informationen erfragen

Ausgabe sortiert nach der JMX-Domain

Syntax des Befehls
http://host:port/serverbydomain

• Ausgabe aller MBeans eines Types:
  http://localhost:9000/serverbydomain?instanceof=org.apache.catalina.mbeans.UserMBean
• Ausgabe aller MBeans aller Domains:
  http://localhost:9000/serverbydomain?querynames=*:*
• Ausgabe aller MBeans der Centaurus-Public Domain:
  http://localhost:9000/serverbydomain?querynames=Centaurus-Public:*
• Ausgabe aller MBeans der Plugins:
  http://localhost:9000/serverbydomain?querynames=Centaurus-Platform:*

Note

Die meisten MBeans basieren auf dem generischen Typ org.apache.commons.modeler.BaseModelMBean.

Ausgabe aller MBeans eines Types

Syntax des Befehls
http://host:port/server

• Ausgabe des Http-Adaptors:
  http://localhost:9000/server?instanceof=mx4j.tools.adaptor.http.HttpAdaptor

Ausgabe eines MBeans mit allen Informationen

Syntax des Befehls
http://host:port/mbean?
objectname=XXX

• Ausgabe des UserDatabase-MBeans:
  http://localhost:9000/mbean?
  objectname=Catalina:type=Resource,resourcetype=Global,
  class=org.apache.catalina.UserDatabase,name=UserDatabase
• Ausgabe des MX4J HttpAdaptor-MBeans:
  http://localhost:9000/mbean?
  objectname=MX4JHttp:type=MX4JHttpAdaptor,host=localhost,port=9000

Ausgabe eines bestimmte MBean-Attributes

Syntax des Befehls
http://host:port/getattribute?objectname=XXX&attribute=XXX&format=ZZZ

• Ausgabe des UserDatabase MBean-Attribute auth:
  http://localhost:9000/getattribute?
  objectname=Catalina:type=Resource,resourcetype=Global,
  class=org.apache.catalina.UserDatabase,name=UserDatabase&attribute=auth

Ausgabe von Collections können mit dem format-Parameter gesteuert werden.
format=array|collection|map

Ping für den Server

Syntax des Befehls
http://host:port/empty

Senden einer Alive-Nachricht

JMX-Informationen manipulieren

Setzen gleich mehrer Attribute eines MBeans

Syntax des Befehls
http://host:port/setattributes?
objectname=XXX&value_YYY=XXX&value_YYY2=XXX2&[set_XXX=Set | setall]

Aufrufen einer JMX-Operation

Syntax des Befehls
http://host:port/invoke?
objectname=XXX&operation=XXX&type0=XXX&value0=XXX...

Mit diesem Befehl können Sie einen gesamten Host samt aller Anwendung stoppen oder den Connector kurzzeitig außer Betrieb nehmen.

Löschen eines MBeans

Syntax des Befehls
http://host:port/delete?objectname=XXX

Warnung Das Löschen eines MBeans sollten Sie sich sehr gut überlegen und nur durchführen, wenn vorher das Objekt gestoppt wurde.

Ausgabe des Construtors Metainformationen eines MBeans

Syntax des Befehls
http://host:port/constructors?
classname=mx4j.tools.adaptor.http.HttpAdaptor

Information über die Verfügbarkeit und Parameter der Konstruktoren eines MBeans.

Erzeugen eines neue MBeans

Syntax des Befehls
http://host:port/create?
class=XXX&objectname=XXX&type0=XXX&value0=XXX...

Selbstverständlich können Sie auch neue MBeans erzeugen. Sehr interessant ist in diesem Zusammenhang die MBeanFactory (Objectname Catalina:type=MBeanFactory). Dieses MBean können Sie zur kontrollierten Erzeugung von Tomcat MBeans heranziehen. In der Regel gibt es aber leider Probleme solche MBeans durch entsprechenden Operationen an die jeweiligen Laufzeitinstanzen des Tomcats zu binden.