bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Deploying Solutions

Deploying Resource Adapters

This section describes how to deploy resource adapters after you start the servers in your cluster. For information about how to set up and start your clustered deployment, and which adapters are deployed by default in your WebLogic Integration domains, see Configuring a Clustered Deployment.

After you start the servers in your cluster, you can deploy resource adapters by using one of the following methods:

- Using the weblogic.Deployer Command-Line Utility

- Using the WebLogic Server Administration Console

Using the weblogic.Deployer Command-Line Utility

The weblogic.Deployer utility is a Java-based deployment tool that provides a command-line interface to the WebLogic Server deployment API. For information, see "Deployment Tools and Procedures" in WebLogic Server Deployment in BEA WebLogic Server Developers Guide, which is available at the following URL:

http://e-docs.bea.com/wls/docs70/programming/deploying.html

Deploying the Sample DBMS Adapter

The following example demonstrates how to deploy the sample DBMS adapter, which you received with your WebLogic Integration software, into a cluster named MyCluster. The cluster contains two managed servers: MyServer1 and MyServer2. The following table describes the cluster configuration.

Server Name | Server Type | Listen Address:Port
--- | --- | ---
MyAdmin | Administration Server | 127.0.0.5:7005
MyServer1 | Managed Server | 127.0.0.1:7001
MyServer2 | Managed Server | 127.0.0.1:7002

Use the following command to deploy the DBMS adapter in this example cluster.

Note: The following code listing represents a single command. It is shown here on multiple lines for the sake of readability. On your command line, however, it must be entered as one physical line.

Listing B-1 weblogic.Deployer Command Line to Deploy the DBMS Adapter

>     java -classpath WL_HOME\lib\weblogic.jar weblogic.Deployer
>     -adminurl t3://127.0.0.5:7005 -user username -password password
>     -upload -stage
>     -source WLI_HOME\adapters\dbms\lib\BEA_WLS_DBMS_ADK.ear
>     -name BEA_WLS_DBMS_ADK
>     -targets BEA_WLS_DBMS_ADK.rar@MyCluster,
>     BEA_WLS_DBMS_ADK_Web.war@MyCluster,
>     BEA_WLS_DBMS_ADK_EventRouter.war@MyServer1
>     -activate

In the preceding command line:

- -adminurl—Specifies the URL for the administration server in the cluster.

- -user—Specifies the username used for authentication by the administration server.

- -password—Specifies the username used for authentication by the administration server.

- -upload—Uploads the EAR file to the administration server. You can omit this option when you run the weblogic.Deployer utility on the administration server. However, it is required when you are not running the weblogic.Deployer utility on the administration server.

- -stage—Instructs the WebLogic Server deployment facility to stage the EAR file to all managed servers prior to activation.

- -source—Specifies the location of the EAR file for the resource adapter. (WLI_HOME represents the directory in which you installed WebLogic Integration, for example C:\bea\weblogic700\integration.)

- -name—Specifies the name of the enterprise application for the resource adapter, which should be the same as the logical name for the adapter. This is a unique identifier for a resource adapter.

- -targets—Specifies the subcomponents contained in the previously specified EAR file for the adapter.

This is a comma-separated list of subcomponents. (Note that there are no spaces between the items in the list.) As described in Deploying Adapters, the event router WAR files for sample adapters are targeted to a single node in a cluster. This sample command specifies that the RAR and design-time Web application are deployed to the cluster, and that the EventRouter Web application is deployed to a specific managed server.

- -activate—Activates the application in the domain.

Using the WebLogic Server Administration Console

1. Start the administration server and the Administration Console:

   1. To start the administration server, see "Starting WebLogic Integration" in Getting Started in Starting, Stopping, and Customizing BEA WebLogic Integration.

   2. To start the console, see "Starting the WebLogic Server Administration Console" in WebLogic Integration Administration and Design Tools in Starting, Stopping, and Customizing BEA WebLogic Integration.

2. In the Administration Console navigation tree, select the Applications node in the domain in which you want to deploy an adapter:

   Domain_Name—>Deployments—>Applications

3. Click Configure a New Application.

   The WebLogic Server wizard is displayed in the main console window. It guides you through the process of configuring and deploying your adapter.

4. Locate the EAR, WAR, JAR, or RAR file you would like to configure for use with WebLogic Server. For example, to deploy the sample DBMS adapter, which you received with your WebLogic Integration software, select the BEA_WLS_DBMS_ADK.ear file in the following directory:

   >      WLI_HOME\adapters\dbms\lib\BEA_WLS_DBMS_ADK.ear

   In the preceding line, WLI_HOME represents the directory in which you installed WebLogic Integration, for example, C:\bea\weblogic700\integration.

   Note: When you configure an exploded application or component directory, WebLogic Server deploys all components it finds in and below the specified directory.

5. Complete the configuration and deployment by responding to the prompts in the wizard. For example, you must specify the targets and the staging mode. For more information, see the -targets and -stage options in Using the weblogic.Deployer Command-Line Utility.

For information about using the WebLogic Server Administration Console to deploy applications, see "Configuration and Deployment Tasks" in Applications in the Adminstration Console Online Help, which is available at the following URL:

>      http://edocs.bea.com/wls/docs70/ConsoleHelp/applications.html