Oracle DBA Tips Corner      Return to the Oracle DBA Tips Corner.

Undeploying Applications

by Jeff Hunter, Sr. Database Administrator

Introduction

You can remove a J2EE Web application from the OC4J Web server using either the -undeploy option with the admin.jar command line tool or by manually deleting the appropriate directories.

Undeploying Application Using admin.jar -undeploy

Syntax

  % java -jar admin.jar ormi://<oc4j_host>:<oc4j_ormi_port>
    admin <adminpassword>
    -undeploy <applicationName> -keepFiles

Example

  % cd $OC4J_HOME/j2ee/home
  % java -jar admin.jar ormi://localhost admin manager -undeploy chapter5 

This command removes the deployed J2EE application known as <applicationName> and results in the following:

• The application is removed from the OC4J runtime.
• All bindings for the Web modules are removed from all the Web sites to which the Web modules were bound.
• The application files are removed from both the $OC4J_HOME/j2ee/home/applications/ and $OC4J_HOME/j2ee/home/application-deployments/ directories. If you do not want these files to be removed, use the -keepFiles switch.

Undeploying Application by Manually Deleting Directories

If you want a clean deployment of an application deployed to OC4J, you can perform the following tasks. In this example, I will delete an application title chapter5. The EAR file was deployed to $OC4J_HOME/j2ee/home/applications/chapter05.

• Stop the OC4J Instance.

    % cd $OC4J_HOME/j2ee/home
    % java -jar admin.jar ormi://localhost admin manager -shutdown

• Delete the application directories under applications and application-deployments:

    % cd $OC4J_HOME/j2ee/home/applications
    % rm chapter05.ear
    % rm -rf chapter05
  
    % cd $OC4J_HOME/j2ee/home/application-deployments
    % rm -rf chapter5

• Edit the file $OC4J_HOME/j2ee/home/config/server.xml and remove the element that describes the chapter5 application:

  <application
      name="chapter5" 
      path="../applications/chapter05.ear" 
      root="/chapter5" 
      auto-start="true" />

• Edit the file $OC4J_HOME/j2ee/home/config/http-web-site.xml and remove the element that describes the chapter5 application:

  <web-app
      application="chapter5"
      name="chapter05-web"
      root="/chapter5"
      load-on-startup="true" />

• Start OC4J again:

    % cd $OC4J_HOME/j2ee/home
    % java -jar oc4j.jar