Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

To perform these activities you currently have three options availableThere are several alternatives available for installing and removing applicaitons:

When you package your application you may include the deployment plan within the package or not. At deployment time, Geronimo will look for the geronimo-web.xml and web.xml deployment plans (or geronimo-application.xml or geronimo-application-client.xml depending the type of application) in the WEB-INF directory within you packaged application. If Geronimo can not find those descriptors it will attempt to deploy the application using defaults. If using defaults fails you will have to provide a deployment plan either repackaged in the application or providing an external deployment plan, in the following sections we will discuss further these alternatives.

Geronimo Administration Console AnchorGACGAC

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.

...

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

If your application does not include the Geronimo specific deployment plan in the WEB-INF directory you can still, just like with the Geronimo Administration Console, specify it externally. You just need to add to the previous command the path and file name of the deployment plan.

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

Note that when specifying the deployment plan externally you can use any file name to identify that plan, there is no need to use the geronimo-XYZ.xml form.

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

No FormatbgColor#000000borderStylesolid 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 will receive a list similar as the one shown in the following example. No FormatbgColor

#000000borderStylesolid 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.

...

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

No FormatbgColor#000000borderStylesolid 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:

...

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

...

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 16:26:49,453 INFO [Hot Deployer] Deploying HelloWorld.war Deployed sample.applications/HelloWorldApp/1.1/war @ http://hc2t60p: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 16:30:03,796 INFO [Hot Deployer] Undeploying HelloWorld.war 16:30:04,015 INFO [DirectoryMonitor] Hot deployer notified that an artifact was removed: sample.applications/HelloWorldApp/1.1/war Undeployed sample.applications/HelloWorldApp/1.1/war