Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Install an Enterprise application

Installing an Enterprise application refers to making its physical file or directory known to WebLogic Server. An Enterprise application can be installed as an archived EAR file or as an exploded directory. After you have installed the Enterprise application, you can start it so that users can begin using it.

To install an Enterprise application, follow these steps:

1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
2. In the left pane of the Console, click the Deployments folder.
3. In the right pane, click Install.
4. Using the Install Application Assistant, locate the `EAR` file or exploded directory that corresponds to the Enterprise application you want to install. If you specify an exploded directory, WebLogic Server installs all components it finds in and below the specified directory. Click the circle to the left of the application.
5. Click Next.
6. Select `Install this deployment as an application`.

   If you have created additional Managed Servers or clusters, you can also select the `Install this deployment as an application, but target the modules individually` option. Select this option if, for example, you want to target all Web Applications in the Enterprise application to one managed server and all EJBs to different managed server. If you have not created additional managed servers or clusters, you will not see this option.

7. Click Next.
8. If you previously selected the option to target the entire Enterprise application to the same server or cluster, the `Select Deployment Targets` window appears. (NOTE: If you have not created Managed Servers or clusters, other than the current Administration server, you will not see this assistant page). Follow these steps:
   1. Select the managed servers or clusters to which you want to deploy the entire Enterprise application.
   2. Click Next.

   If you previously selected the option to target individual modules of the Enterprise Application to their own server or cluster, then the `Select Modules to Target` window appears with a table that contains a list of all the modules, the type of module (such as EJB or Web Application), and the managed server, cluster, or JMS server (for application-scoped JMS modules) to which it is currently targeted, if any. Follow these steps:

   1. Select the modules which you want to target to a particular managed server, cluster or JMS server.
   2. Click Next.
   3. Select the managed server, cluster, virtual host, and/or JMS server to which you want to target the modules.
   4. Click Next. The install assistant takes you back to the table of modules, but now the Selected Targets column for the modules you just targeted shows the current target.
   5. Repeat the preceding steps until you have targeted all the modules as you wish.
   6. Click Next with no modules selected to proceed to the next assistant page.
9. Optionally update settings about the deployment. These settings include:
   - The deployed name of the Enterprise application. The default deployment name is the name of the Enterprise Application EAR file or exploded directory.
   - For any Web application or EJB modules, the security model that is applied. See Manage security for Web applications and EJBs for detailed information about the models.
   - How the source files (EAR or exploded directory contents) are made available to all targeted Managed Servers and clusters. See Controlling Deployment File Copying with Staging Modes for detailed information about the deployment staging modes.

   Typically, the default values are adequate.

10. Click Next.
11. Review the configuration settings you have chosen, specify whether you want to immediately update the application's configuration after you install it, then click Finish to complete the installation.

    Note: If you install an application that follows the below directory structure and there is no deployment plan in the `/plan` directory, WebLogic server automatically creates a deployment plan for you.

    - app-root
    - /app
    - /plan
12. If you chose to immediately go to the deployment's configuration screen, click on the tabs to set additional configuration settings for the Enterprise application. If you chose to change this information later, the Console returns you to the Deployments table, which should now include your newly-installed Enterprise application.
13. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).