Apache Geronimo provides several tools for administering the server. These tools are available via command line and some via a Web based console. The Web based Geronimo console is explained in detail in the following section Geronimo Administration Console. The currently available command line tools are located in the <geronimo_home>/bin directory and are enumerated in the following list:
Although the tools name is self-explanatory, it may not be the same case with the tool's parameters. The following sections explain more in detail these tools and commands usage.
This command is certainly used to start the Apache Geronimo server. You can start the Apache Geronimo server in two different ways by running the following commands:
<geronimo_home>/bin/java -jar server.jar
startup command invokes the
In both cases this command accepts the same parameters. The available parameters are:
Suppress the normal startup progress bar. This is typically used when redirecting console output to a file, or starting the server from an IDE or other tool.
Write startup progress to the console in a format that is suitable for redirecting console output to a file, or starting the server from an IDE or other tool (does not use linefeeds to update the progress information that is used by default if you do not specify --quiet or --long).
Sets the console log level to INFO, resulting in more console output than is normally present.
Sets the console log level to DEBUG, resulting in even more console output.
Overrides the configurations in <geronimo_home>/var/config.list such that only the configurations listed on the command line will be started. Note that many J2EE
features depend on certain configs being started, so you should be very careful what you omit. Any arguments after -override are assumed to be configuration names.
When you run this command from a Microsoft Windows command line that window will get locked with the startup results screen. On a Linux based operating system you can run this command in background getting back the control for this window terminal.
If you run the startup command without any parameters you will see a screen similar to this one.
startup command starts the Apache Geronimo server,
shutdown will definitively stop it. This command has the following syntax:
The available options are:
Specifies the user name with the authority to stop the server. By default you would normally use system as the user name.
Specifies the password for the user name you just entered. By default you would normally use manager as the password.
Specifies the RMI naming port to connect to the server (for example JMX connection port). By default you would normally use port 1099.
If you do not specify any parameters, this command will prompt you for a user name and password and will assume port 1099 by default and will not prompt for any port.
The geronimo command lets you perform the previous two actions, that is start and stop the server in different modes depending on the parameters you specify. This command has the following syntax:
The available options are:
This option will start the server in JDB debugger.
This option will start the server in foreground under JPDA debugger
This option will start the server in background under JPDA debugger.
This option will start the server in the current window.
This option will start the server in a separate window just like the #startup command.
This option will stop the server.
The deployer tool is used for installing, uninstalling, reinstalling, starting and stopping applications and modules and for installing and uninstalling configurations (for example some configuration specific deployment plans, security realms, database connection pools, etc.). Due to the number of options in this case, this tool is covered in detail in the Deployer tool section.
This is a powerful tool with many parameters and options but it is not hard to use at all.
As with the startup command, the deployment tool can also be invoked in two different ways:
java -jar deployer.jar [general_options] <command> [command_options]
deploy [general_options] <command> [command_options]
Please refer to Deployer tool for a fully detailed description of this tool options and usage.
The client.jar launches the client application container. This command has the following syntax:
java -jar client.jar config-name [app arg] [app arg] ...
The first argument identifies the Geronimo configuration that contains the application client you want to run. The rest of the arguments will be passed as arguments to the client application when it is started.
This tools helps you to migrate deployment plans from Apache Geronimo v1.0, refer to Migrating applications from Geronimo v1.0 for details.