Administration Guide

Target audience

The target audience of this guide is the system administrator

General Description

When the EJB server is running, it is possible to perform some administration tasks using the administration tool AdmServer. This tool is started by the command

    AdmServer

The fonctions performed by the AdmServer tool are summarized in the table below :

Lists the types of beans currently loaded by the EJB server -l
Lists the registered JNDI names -L
Lists the properties of the EJB server -E
Dynamically adds types of beans to the EJB server -a BeansFileName
Stops the EJB server -s
Shows the usage of the AdmServer command -? or -h

The detailed usage of this tool is provided in the following.

The AdmServer Tool

Synopsis

AdmServer [options]

Description

The AdmServer tool performs some administration tasks on the EJB server. The task performed depends on the selected option.

Options

-h or -?
Gives the summary of the options.

-l
Lists the types of beans currently loaded by the EJB server. A type of bean corresponds to a Deployment Descriptor.

-L
Lists the registered JNDI names.

-E
Lists the properties of the EJB server.

If the EJB server is not running, launching the AdmServer with this option will result in an error; if you still want to consult the current properties, you may run the command :

   java -Dinstall.root=$JONAS_ROOT com.bull.frec.util.Prop

where JONAS_ROOT is the installation directory of your JOnAS environment.

-a BeansFileName
Dynamically adds types of beans to the EJB server. The BeansFileName should be the name of a file containing the following line :
bullejb.beans.descriptors         bean1.ser, bean2.ser

where bean1.ser and bean2.ser are the serialized Deployment Descriptor to be added.

-s
Stops the EJB server.

Example

AdmServer -L
Lists the JNDI names currently registered by the EJB server.