JOnAS provides two tools to perform some administration tasks on a
running JOnAS Server.
These tools allow to administrate several JOnAS Servers.
Each JOnAS Server is identified by a name which is the value of the
JOnAS property jonas.name
(default name is jonas
).
The administration tools are:
JonasAdmin
, which is a command line
tool, andJadmin
, which is a graphical tool.The target audience of this guide is the JOnAS server administrator.
JonasAdmin is described in the JOnAS Commands chapter.
Server-side component model and middleware services are about to become a major stake today. That is why an application server such as JOnAS has to provide management and monitoring features.
This chapter provides information for installing, configuring and using the Java Management Extensions features of JOnAS called Jadmin for JOnAS administrator.
Jadmin is an administration tool developed with the Java servlets technology, so it is accessible with a web browser.
As since JOnAS2.4.4 there is a new JOnAS servicetomcat
that allows to launch
the Tomcat servlet container in the same JVM as JOnAS, you only have to launch
JOnAS with the tomcat
service configured to have access to Jadmin.
Since the tool consists of servlets, you have to install a servlet server. In the following, it will be considered that you use Tomcat (either version 3.3.x or 4.0.x). Tomcat installation and configuration are documented in the Tomcat user's guide. You may fin a quick installation guide for Tomcat with JOnAS in the Use Tomcat with JOnAS howto document.
The steps for installing Jadmin are described below:
$JONAS_ROOT/webapps/jadmin.war
file in the
$TOMCAT_HOME/webapps
directory, or modify the
$TOMCAT_HOME/conf/server.xml
file in order to make Tomcat load the
jadmin.war
file on startup.
tomcat-users.xml
file in the $TOMCAT_HOME/conf/users
directory
for Tomcat 3.3.x or in the $TOMCAT_HOME/conf/
directory for Tomcat 4.0.x:
<tomcat-users> <user name="jadmin" password="jonas" roles="jadmin,tomcat" /> ... </tomcat-users>Of course, you can set another password.
Be sure you have set tomcat
in the jonas.services
property
in the jonas.properties
file. Your TOMCAT_HOME
environment
variable must be set to the root directory of a Tomcat3.3.x, or your
CATALINA_HOME
environment variable to the root directory of a Tomcat4.0.x.
Once you have launched JOnAS, Jadmin is accessible at this URL:
http://<hostname>:<portnumber>/jadmin/
on your
favorite web browser.
<hostname> is the name of the host where Tomcat is running and <portnumber> is the Tomcat http port number (default is 8080).
The first page you see after clicking on the entering page is the following:
The registry URL corresponding to your JOnAS configuration is displayed in the "Registry URL" text area. Note that if you have several EJB servers running and using different registries, you have the possibility to set the registry URL in order to manage the corresponding EJB servers.
If you have several JOnAS servers running on the same registry, they will appear
in this page, and you will be able to choose which one you intend to manage (check button).
The management information appearing in the different Jadmin pages will be related
to the selected JOnAS server. For example in the figure above, two JOnAS servers are
running, one is named jonas
, the other one is named jonas_srv2
,
and the first one is selected. The name of a JOnAS server is specified in its
jonas.properties
configuration file, in the property jonas.name
.
The following of this section explains the general principles of the graphical user interface of Jadmin.
The interface is divided in thumb indexes: one index for each service (container, database, resource, transaction, log, JMS, and security), one index for the EJB server monitoring and a last one for the MBeans. Note that on each page you will always find the Choose another JOnAS server or change the Registry link that will allow you to come back to the Jadmin entering page, and thus to change the registry, to change the managed server or to stop a server.
Since most of the management operations are not idempotent, the user should not use the browser reload button, but the Refresh link in the top banner.
Some thumb indexes are organized as tree structures. For example:
The JOnAS administration interface consists of JMX attributes and operations. Attributes could be readable and/or writable. When an attribute is writable, it is displayed in a text input area and there are two buttons beside it (the reset button reset the text input with its initial value, the submit button sends the new value to the server).
Sometimes, writables attributes are presented with a check box or a radio box, it depends on the attribute type (if it is a boolean for example).
Operations are presented as boldface characters links. When an operation needs a parameter, it is presented with an input text area and a button.
The All MBeans index thumb displays the exhaustive list of all MBeans.
One management operation is especially important, it is the possiblility to load a container from the Jadmin console. This is available in the Container index, via the "ejb-jar deployment descriptor or jar file" text input area:
In the text area, you should put