...

Another way to verify that the application has been successfully installed and started is by checking the Installed Web Applications portlet which is available by selecting Web App WARs on the Console Navigation menu on the left hand side. You should see the application listed as helloworld HelloWorld and with the status running.

...

For our example, access the Installed Web Applications portlet and click on Uninstall for the Component Name listing helloworld HelloWorldApp. This will stop the application first and then uninstall it. The confirmation message " Uninstalled application " should be listed at the bottom of the portlet.

These are the basic steps for installing and uninstalling applications via de Geronimo Administration Console, the following two sections will focus on the command line options.

Deployer tool

The deployer tool will allow you, among other things, install and uninstall applications via a command line. In this section we will focus on just these two tasks for the sample application, this tool is fully covered in the Deployer tool section.

To deploy the HelloWorld.war sample application using the Deployer tool open a command line window and type the following command from the <geronimo_home>\bin directory:

deploy --user system --password manager deploy <app_home>\HelloWorld.war

Once deployed you should see a confirmation message similar to this one:

D:\geronimo-1.1-Tomcat\bin>deploy --user system --password manager deploy \HelloWorld\HelloWorld.war
Using GERONIMO_BASE:   D:\geronimo-1.1-Tomcat
Using GERONIMO_HOME:   D:\geronimo-1.1-Tomcat
Using GERONIMO_TMPDIR: D:\geronimo-1.1-Tomcat\var\temp
Using JRE_HOME:        C:\Java\jdk1.5.0_06\
    Deployed sample.applications/HelloWorldApp/1.1/war @
    http://hc2t60p:8080/hello

As a difference from the deployment via de Geronimo Administration Console, using the command line tool you receive more information in the confirmation message. For instance you receive the Component Name (a.k.a. moduleId) and you also receive the context root where the application was deployed. This is very usefull when isntalling, testing and uninstalling several different applications where it would be hard to remember all these values.

You can also use the Deployer tool to list all the installed applications. The list-modules command allows you to list all the applications, it also lets you narrow down the query by asking for just the started or stopped applications. The list-modules command without additional parameter will list by default all the started applications.

To uninstall an application you may want to list it first to get the right Component Name (or moduleId). Run the following command from the <geronimo_home>\bin directory:

deploy --user system --password manager list-modules

You will receive a list similar as the one shown in the following example.

D:\geronimo-1.1-Tomcat\bin>deploy --user system --password manager list-modules
Using GERONIMO_BASE:   D:\geronimo-1.1-Tomcat
Using GERONIMO_HOME:   D:\geronimo-1.1-Tomcat
Using GERONIMO_TMPDIR: D:\geronimo-1.1-Tomcat\var\temp
Using JRE_HOME:        C:\Java\jdk1.5.0_06\
Found 34 modules
  + console.dbpool/Derby_Test/1.0/rar
  + geronimo/activemq/1.1/car
  + geronimo/activemq-broker/1.1/car
  + geronimo/axis/1.1/car
  + geronimo/axis-deployer/1.1/car
  + geronimo/client-deployer/1.1/car
  + geronimo/geronimo-gbean-deployer/1.1/car
  + geronimo/hot-deployer/1.1/car
  + geronimo/j2ee-deployer/1.1/car
  + geronimo/j2ee-security/1.1/car
  + geronimo/j2ee-server/1.1/car
  + geronimo/j2ee-system/1.1/car
  + geronimo/openejb/1.1/car
  + geronimo/openejb-deployer/1.1/car
  + geronimo/remote-deploy-tomcat/1.1/car @ http://hc2t60p:8080/remote-deploy
  + geronimo/rmi-naming/1.1/car
  + geronimo/sharedlib/1.1/car
  + geronimo/system-database/1.1/car
  + geronimo/tomcat/1.1/car
  + geronimo/tomcat-deployer/1.1/car
  + geronimo/webconsole-tomcat/1.1/car
      `-> standard.war @ http://hc2t60p:8080/console-standard
      `-> framework.war @ http://hc2t60p:8080/console
  + geronimo/welcome-tomcat/1.1/car @ http://hc2t60p:8080/
  + sample.applications/HelloWorldApp/1.1/war @ http://hc2t60p:8080/hello
    geronimo/client/1.1/car
    geronimo/client-corba/1.1/car
    geronimo/client-security/1.1/car
    geronimo/client-system/1.1/car
    geronimo/j2ee-corba/1.1/car
    geronimo/javamail/1.1/car
    geronimo/online-deployer/1.1/car
    geronimo/shutdown/1.1/car
    geronimo/uddi-tomcat/1.1/car
    geronimo/upgrade/1.1/car
    geronimo/upgrade-cli/1.1/car

Look for the sample.applications/HelloWorldApp/1.1/war entry, thas is the value you will have to use when trying to uninstall the application.

To uninstall the application run the following command from the <geronimo_home>\bin diretory using the Component Name you identified while listing the modules.

deploy --user system --password manager undeploy sample.applications/HelloWorldApp/1.1/war

This command will first stop the runnning application and then uninstall it. You should see a confirmation message similar to this:

D:\geronimo-1.1-Tomcat\bin>deploy --user system --password manager undeploy sample.applications/HelloWorldApp/1.1/war
Using GERONIMO_BASE:   D:\geronimo-1.1-Tomcat
Using GERONIMO_HOME:   D:\geronimo-1.1-Tomcat
Using GERONIMO_TMPDIR: D:\geronimo-1.1-Tomcat\var\temp
Using JRE_HOME:        C:\Java\jdk1.5.0_06\
    Module sample.applications/HelloWorldApp/1.1/war unloaded.
    Module sample.applications/HelloWorldApp/1.1/war uninstalled.

    Undeployed sample.applications/HelloWorldApp/1.1/war

In this example you have used the same tool with three different commands:

• deploy
• list-modules
• undeploy

These are not the only options and commands available for this tool, please visit the Deployer tool section for additional details.