The target audience of this guide is the system administrator
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.
JonasAdmin
JonasAdmin -n jonasName
JonasAdmin [-n jonasName ] [options]
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.
- -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.xmlwhere bean1.xml and bean2.xml identify deployment descriptors of the beans to be added.
- -s
- Stops the EJB server.
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 thejonas.beans.descriptors
property inmyfile
file.