Administration Guide

Target audience

The target audience of this guide is the system administrator

General Description

JonasAdmin is a tool that performs some administration tasks on a JOnAS EJB server running.
There are two modes to use this tool a command mode and an interactive one
This tool is started by the command:

    JonasAdmin

The command JonasAdmin without argument (or with -n jonasName) run the tool in interactive mode.

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

Functionnalities Command Mode Interactive Mode
Shows the usage of the JonasAdmin command -? or -h help
Lists the types of beans currently loaded by the EJB server -l list
Lists the registered JNDI names -j jndi
Lists the properties of the EJB server -e env
Dynamically adds types of beans to the EJB server -a BeansFileName add
Identify an EJBServer -n jonasName name
Set traces in EJBServer -t flag1,flag2 trace
Stops the EJB server -s stop

By default (without -n option) JonasAdmin access to the EJBServer whose name is jonas (jonas.name property in server's jonas.properties file)

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

The JonasAdmin Tool

Synopsis

JonasAdmin

JonasAdmin -n jonasName

JonasAdmin [-n jonasName ] [options]

Description

The first, run JonasAdmin in interactive mode, on EJBServer whose name is jonas .

The second, run JonasAdmin in interactive mode, on EJBServer whose name is jonasName.

The third, run JonasAdmin in command mode, 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.
-j
Lists the registered JNDI names.
-e
Lists the properties of the EJB server.
 
-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.xml, bean2.xml

where bean1.xml and bean2.xml identify deployment descriptors of the beans to be added.

-s
Stops the EJB server.

Examples

JonasAdmin -j
Lists the JNDI names currently registered by the EJB server.
JonasAdmin -n myserver -a myfile
Make available in the EJBServer identified by the jonas.name, myserver, the EJBs indentified by the jonas.beans.descriptors property in myfile file.