...

There are several alternatives available for installing and removing applications:

...

Geronimo Administration Console Anchor GACGAC

To install a new application via the Geronimo Administration Console the Install New Applications portlet is available by selecting Deploy New on the Console Navigation menu on the left hand side. This portlet also allows you to start automatically the application right after it was deployed.

...

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

No FormatbgColor#000000borderStylesolid D:\geronimo-tomcat6-jee5-2.0-M2\bin>deploy --user system --password manager deploy \HelloWorld_2.0\HelloWorld.war Using GERONIMO_BASE: D:\geronimo-tomcat6-jee5-2.1 Using GERONIMO_HOME: D:\geronimo-tomcat6-jee5-2.1 Using GERONIMO_TMPDIR: D:\geronimo-tomcat6-jee5-2.1\var\temp Using JRE_HOME: C:\Java\jdk1.5.0_06\\jre Deployed sample.applications/HelloWorldApp/2.0/war @ http://hcunico:8080/hello

As a difference from the deployment via the 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 and port where the application was deployed. This is very useful when installing, testing and uninstalling several different applications where it would be hard to remember all these values.

...

deploy --user system --password manager deploy --inplace inPlace <app_home>

The Deployer tool can also be used 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.

...

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

#000000borderStylesolid D:\geronimo-tomcat6-jee5-2.0-M2\bin>deploy --user system --password manager list-modules Using GERONIMO_BASE: D:\geronimo-tomcat6-jee5-2.1 Using GERONIMO_HOME: D:\geronimo-tomcat6-jee5-2.1 Using GERONIMO_TMPDIR: D:\geronimo-tomcat6-jee5-2.1\var\temp Using JRE_HOME: C:\Java\jdk1.5.0_06\\jre Found 85 modules + org.apache.geronimo.configs/activemq-broker/2.1-SNAPSHOT/car + org.apache.geronimo.configs/activemq-ra/2.1-SNAPSHOT/car + org.apache.geronimo.configs/axis/2.1-SNAPSHOT/car + org.apache.geronimo.configs/axis-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/axis2/2.1-SNAPSHOT/car + org.apache.geronimo.configs/axis2-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/axis2-ejb/2.1-SNAPSHOT/car + org.apache.geronimo.configs/axis2-ejb-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/ca-helper-tomcat/2.1-SNAPSHOT/car + org.apache.geronimo.configs/client-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/clustering/2.1-SNAPSHOT/car + org.apache.geronimo.configs/connector-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/cxf/2.1-SNAPSHOT/car + org.apache.geronimo.configs/cxf-ejb/2.1-SNAPSHOT/car + org.apache.geronimo.configs/dojo-legacy-tomcat/2.1-SNAPSHOT/car + org.apache.geronimo.configs/dojo-tomcat/2.1-SNAPSHOT/car + org.apache.geronimo.configs/hot-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/j2ee-corba-yoko/2.1-SNAPSHOT/car + org.apache.geronimo.configs/j2ee-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/j2ee-server/2.1-SNAPSHOT/car + org.apache.geronimo.configs/jasper/2.1-SNAPSHOT/car + org.apache.geronimo.configs/jasper-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/javamail/2.1-SNAPSHOT/car + org.apache.geronimo.configs/jaxws-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/jaxws-ejb-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/jsr88-rar-configurer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/mejb/2.1-SNAPSHOT/car + org.apache.geronimo.configs/myfaces/2.1-SNAPSHOT/car + org.apache.geronimo.configs/myfaces-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/openejb/2.1-SNAPSHOT/car + org.apache.geronimo.configs/openejb-corba-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/openejb-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/openjpa/2.1-SNAPSHOT/car + org.apache.geronimo.configs/persistence-jpa10-deployer/2.1-SNAPSHOT/car + org.apache.geronimo.configs/remote-deploy-tomcat/2.1-SNAPSHOT/car + org.apache.geronimo.configs/sharedlib/2.1-SNAPSHOT/car + org.apache.geronimo.configs/spring/2.1-SNAPSHOT/car + org.apache.geronimo.configs/system-database/2.1-SNAPSHOT/car + org.apache.geronimo.configs/tomcat6/2.1-SNAPSHOT/car + org.apache.geronimo.configs/tomcat6-clustering-builder-wadi/2.1-SNAPSHOT/car

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

...

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

#000000borderStylesolid D:\geronimo-tomcat6-jee5-2.0-M2\bin>deploy --user system --password manager undeploy sample.applications/HelloWorldApp/2.0/war Using GERONIMO_BASE: D:\geronimo-tomcat6-jee5-2.1 Using GERONIMO_HOME: D:\geronimo-tomcat6-jee5-2.1 Using GERONIMO_TMPDIR: D:\geronimo-tomcat6-jee5-2.1\var\temp Using JRE_HOME: C:\Java\jdk1.5.0_06\\jre Module sample.applications/HelloWorldApp/2.0/war unloaded. Module sample.applications/HelloWorldApp/2.0/war uninstalled. Undeployed sample.applications/HelloWorldApp/2.0/war

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

...

When you copy an application in the deploy directory, let's say HelloWorld.war, you will see a confirmation message in the console where Geronimo is running stating the application was deployed and the context to access that application.

No FormatbgColor#000000borderStylesolid 11:45:23,500 INFO [DirectoryHotDeployer] Deploying HelloWorld.war 11:45:23,953 INFO [DirectoryHotDeployer] Deployed sample.applications/HelloWorldApp/2.0/war @ http://hcunico:8080/hello

To remove the application, just delete the WAR or EAR file from the deploy directory. When the application has been removed you should see a confirmation message in the console where Geronimo is running stating the application was undeployed.

No FormatbgColor#000000borderStylesolid 11:46:17,953 INFO [DirectoryHotDeployer] Undeploying HelloWorld.war 11:46:18,281 INFO [DirectoryMonitor] Hot deployer notified that an artifact was removed: sample.applications/HelloWorldApp/2.0/war 11:46:18,281 INFO [DirectoryHotDeployer] Undeployed sample.applications/HelloWorldApp/2.0/war

Summary

In this section we has discussed three different methods for installing and uninstalling applications, one graphical, one command line and for the hot deployment you can choose command line or the GUI of your choice.
Visit the Tools and commands section for further details on the available options and parameters.