bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Administration Guide

Deploying Applications

The following sections discuss installation and deployment of applications and application components on WebLogic Server:

- Supported Formats for Deployment

- Deploying a Web Application Using the (deprecated) weblogic.deploy Utility

Supported Formats for Deployment

J2EE applications and components can be deployed on WebLogic Servers as Enterprise Application Archive (EAR) files or in exploded directory format. However, if a J2EE application is deployed in exploded format, we recommend that no component other than the Web application component should be in exploded format. If the application is deployed in archived format, then we recommend that all of the components of the application also be in archived format.

Archived components may be EJB archives (JARs), Web Application Archives (WARs), or Resource Adaptor Archives (RAR).

For information about deploying J2EE Applications and an overview of WebLogic Server deployment, see WebLogic Server Application Deployment.

For information about deploying Web Applications see Assembling and Configuring Web Applications.

For information about deploying Resource Adaptors, see Packaging and Deploying Resource Adapters.

For information about deploying EJBs, see Packaging EJBs for the WebLogic Server Container.

Deploying a Web Application Using the (deprecated) weblogic.deploy Utility

The weblogic.Deployer utility is new in WebLogic Server 7.0, and replaces the earlier weblogic.deploy utility, which has been deprecated. Please note that all utilities and APIs using the older, WebLogic Server 6.x deployment protocol are now deprecated. Use the WebLogic Server 7.0 two-phase deployment tools and utilities for all application deployment.

For information about weblogic.Deployer, see weblogic.Deployer Utility/ejb/EJB_packaging.html#1011066.

To deploy a Web Application using the weblogic.deploy utility:

1. Set up your local environment so that WebLogic Server classes are in your system CLASSPATH and the JDK is available. You can use the setEnv script located in the config/mydomain directory to set the CLASSPATH.

2. Enter the following command:

   >     % java weblogic.deploy -port port_number -host host_name
   >        -user username -component application:target deploy
   >        password name application source

   Where:

   - port_number is the port number where WebLogic Server is listening for requests

   - host_name is the name of the machine hosting WebLogic Server

   - username is a user that has permission to complete the request on the server that you specify in the -host argument. The default is the username that you used to start the server that you specify in the -host argument.username is the user account under which WebLogic Server is booted.

     For information about permissions for system administration tasks, refer to Protecting System Administration Operations.

   - application is the name you want to assign to this Web Application.

   - target is the name of a server, cluster or virtual host to be targeted by this Web Application. You can enter multiple targets, separated by a comma.

   - password is your system administration password

   - name is your system administration name

   - source is the full pathname of the .war file you want to deploy, or the full pathname of a directory containing a Web Application in exploded directory format.

     For example:

     >     java weblogic.deploy -port 7001 -host myhost -component
     >        myWebApp:myserver deploy pswd1234 myWebApp d:\myWebApp.war

Deployment Documentation

WebLogic Server Deployment describes Weblogic Server deployment and deployment tools, procedures, and best practices. :

Table 5-1 Deployment Documents

Document | Deployment Topics
--- | ---
WebLogic Builder | How to use WebLogic Builder to edit and generate XML deployment descriptor files for J2EE applications and their components.
Developing WebLogic Server Applications | How to deploy WebLogic Server J2EE applications.
Administration Console Online Help | How to use the Administration Console for deployment tasks.
Programming WebLogic EJBs | How to deploy WebLogic Server EJBs.
Programming WebLogic J2EE Connectors | How to deploy WebLogic Server J2EE Connectors.
Assembling and Configuring Web Applications | How to deploy Weblogic Server Web Applications.
Programming WebLogic JSP | How to deploy applets from JSP.
Understanding Cluster Configuration and Application Deployment | How to deploy to clustered servers.
WebLogic Server Application Packaging and Classloading | How to package WebLogic Server application components.