Dear Wiki user, You have subscribed to a wiki page or wiki category on "James Wiki" for change notification.
The following page has been changed by BerndFondermann: http://wiki.apache.org/james/ConfigureJmx ------------------------------------------------------------------------------ = Environment = - To enable JMX you will need a running James instance (TBD: link to installation page). + To enable JMX you will need a running James instance (see JamesQuickstart). = Configuring James = - TBD + go to the home directory of your James installation and edit conf/kernel.xml + + change + + {{{ + <component role="org.apache.avalon.phoenix.interfaces.SystemManager" + class="org.apache.avalon.phoenix.components.manager.NoopSystemManager" + logger="manager" /> + + <!-- + <component role="org.apache.avalon.phoenix.interfaces.SystemManager" + class="org.apache.avalon.phoenix.components.manager.MX4JSystemManager" + logger="manager"> + --> + + }}} + + into + + {{{ + <!-- + <component role="org.apache.avalon.phoenix.interfaces.SystemManager" + class="org.apache.avalon.phoenix.components.manager.NoopSystemManager" + logger="manager" /> + --> + + <component role="org.apache.avalon.phoenix.interfaces.SystemManager" + class="org.apache.avalon.phoenix.components.manager.MX4JSystemManager" + logger="manager"> + }}} + + Then, change + + {{{ + <!-- + <enable-rmi-adaptor>true</enable-rmi-adaptor> + <rmi-naming-factory>com.sun.jndi.rmi.registry.RegistryContextFactory</rmi-naming-factory> + <rmi-registry-port>1099</rmi-registry-port> + --> + }}} + + into + + {{{ + <enable-rmi-adaptor>true</enable-rmi-adaptor> + <rmi-naming-factory>com.sun.jndi.rmi.registry.RegistryContextFactory</rmi-naming-factory> + <rmi-registry-port>1099</rmi-registry-port> + }}} + + + Finally, change + + {{{ + <!-- + </component> + --> + }}} + + into + + {{{ + </component> + }}} + + Restart James now, it should come up like always, only now in addition to the other ports also binding to port 1099. = Connecting using MC4J = MC4J is a GUI application able to connect to and manage any JMX enabled application. You can download it from [http://mc4j.sourceforge.net]. - Please follow the instructions given there to run the installer and start it up. + Please follow the instructions given there to run the installer and start the application up afterwards. - TBD + Choose "Connect to server..." from the menu to activate the Connection Wizzard. + On panel 1, choose "MX4J 1.x" from the drop-down list. Enter a name into the edit field: e.g. ''James''. Click "next". + + Panel 2 is magically skipped. + + On panel 3, click "next". + + On panel 4, click "finish". + + MC4J now connects and tells you it is loading some MBeans. + + = Call management attributes and operations = + + MC4J offers you to browse all exposed management functions. + + Browse to James/MBeans/Phoenix/application=james + + There you will find all the components, ready to be managed by introspecting attributes or executing operations. +
