BEA Logo BEA WebLogic Process Integrator Release 1.2.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

   http://www.oracle.com/technology/documentation/index.html   |   Search   |   PDF Files   |   Contact   |  

 

   WebLogic Process Integrator Doc Home   |   Installation and Configuration Guide   |   Previous Topic   |   Next Topic   |   Contents   |  

Installing BEA WebLogic Process Integrator

 

This section provides the information you need to run the WebLogic Process Integrator installation program on a Windows or UNIX system. It includes the following topics:

 

About the WebLogic Process Integrator Installation Program

The WebLogic Process Integrator installation program guides you through the process of installing either WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1 or WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0.

Note: If you intend to upgrade to WebLogic Server 6.0 in the near future, we recommend that you do so before installing WebLogic Process Integrator.

The installation detects whether WebLogic Server 6.0 is installed and prompts you to specify an installation location and other information required to perform basic WebLogic Process Integrator configuration. It then unpacks and installs the appropriate version of the software. The installation program requires a graphics (windowing) terminal or workstation. To install WebLogic Process Integrator on a UNIX system that does not support a graphics terminal or workstation, see BEA WebLogic Process Integrator Console-Mode Installation.

After you verify that the Installation Prerequisites have been met, complete the following steps, which make up the installation procedure:

Step 1. Starting the Installation Program

Step 2. Reviewing the License Agreement

Step 3. Selecting Components

Step 4. Selecting the Version of WebLogic Process Integrator

Step 5. Specifying the BEA Home and Installation Location

Step 6. Configuring the JDBC Connection Pool

Step 7. Completing the Installation

Step 8. Installing Your Software License

Step 9. Creating the WebLogic Process Integrator Tables

Step 10. Verifying the WebLogic Process Integrator Installation

Detailed instructions for each step are provided in the following sections.

 

Step 1. Starting the Installation Program

You can install WebLogic Process Integrator from the CD-ROM included in the product package, or you can download the software from the BEA Web site as described in Downloading the Software.

The following section provides instructions for Windows platforms. If you are installing WebLogic Process Integrator on a UNIX system, skip the following section and go to Starting the Installation Program on a UNIX System.

Starting the Installation Program on a Windows System

To start the BEA WebLogic Process Integrator installation program on a Windows system:

  1. Do one of the following:

  2. Choose Start—>Programs—>Windows NT (or 2000) Explorer, then do one of the following:

  3. Click Next.

    The License Agreement dialog box is displayed.

  4. Go to Step 2. Reviewing the License Agreement.

Starting the Installation Program on a UNIX System

To start the BEA WebLogic Process Integrator installation program on a UNIX system:

  1. Do one of the following:

  2. Do one of the following:

  3. Start the installation by entering wlpi_121_unix.bin at the prompt:

    The BEA WebLogic Process Integrator Splash screen is displayed briefly followed by the Introduction dialog box.

  4. Click Next.

    The License Agreement dialog box is displayed.

  5. Go to Step 2. Reviewing the License Agreement.

 

Step 2. Reviewing the License Agreement

After you have clicked Next in the Introduction dialog box, the License Agreement is displayed as shown in the following figure.

Figure 2-1 License Agreement Dialog Box

Complete the following procedure:

  1. Review the license agreement, using the scroll bar to display the text.

  2. Click the Yes option button to accept the license agreement.

  3. Click Next.

    The Important Information dialog box is displayed as shown in the following figure.

    Figure 2-2 Important Information Dialog Box

  4. Review the installation requirements, using the scroll bar to display the text.

    Note: You must scroll down to view the installation prerequisites for WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1.

  5. Click Next to acknowledge that you have read and understood the requirements for WebLogic Process Integrator.

    The Choose Install Set dialog box is displayed.

  6. Go to Step 3. Selecting Components.

 

Step 3. Selecting Components

By default, BEA WebLogic Process Integrator installation program installs the following components:

It is not necessary, however, to install all components on the same system. Although the WebLogic Process Integrator Server must be installed on a system hosting WebLogic Server, the other WebLogic Process Integrator components, Studio and Worklist, can be installed on the same system or on another system that can connect to the WebLogic Process Integrator Server over the network.

The components to be installed are selected in the Choose Install Set dialog box as shown in the following figure.

Figure 2-3 Choose Install Set Dialog Box

To install all components on the same system:

  1. Click Next.

    The Select the Version of the WebLogic Process Integrator dialog box is displayed.

  2. Go to Step 4. Selecting the Version of WebLogic Process Integrator.

To customize the installation:

  1. Click Customize.

    The Custom Install dialog box is displayed as shown in the following figure.

    Figure 2-4 Customize Install Dialog Box

  2. Click the check boxes to deselect or select components as required.

  3. Click Next.

    The Select the Version of WebLogic Process Integrator dialog box is displayed.

  4. Go to Step 4. Selecting the Version of WebLogic Process Integrator.

 

Step 4. Selecting the Version of WebLogic Process Integrator

After you have selected the components, the Select the Version of WebLogic Process Integrator dialog box is displayed as shown in the following figure.

Figure 2-5 Select the Version of WebLogic Process Integrator Dialog Box

If WebLogic Server 6.0 is detected, the Install WLPI 1.2.1 for WebLogic Server 6.0 option is selected.

If WebLogic Server 6.0 is not detected, the Install WLPI 1.2.1 for WebLogic Server 5.1 option is selected.

  1. Verify that the correct version of the software has been selected for the version of WebLogic Server installed on your system. If WebLogic Server 6.0 is installed but is not detected (that is, if Install WLPI 1.2.1 for WebLogic Server 5.1 is selected in this dialog box) go to WebLogic Server 6.0 Not Detected.

  2. Click Next.

    The Choose BEA Home Directory dialog box is displayed.

    Note: If the WebLogic Server 6.0 Not Installed warning is displayed, go to WebLogic Server 6.0 Not Detected.

  3. Go to Step 5. Specifying the BEA Home and Installation Location

 

Step 5. Specifying the BEA Home and Installation Location

After you have selected the version of WebLogic Process Integrator, the Choose BEA Home Directory dialog box is displayed as shown in the following figure.

Figure 2-6 Choose BEA Home Directory Dialog Box

Before responding to the dialog box:

To specify the BEA Home directory and installation location:

  1. Do one of the following:

  2. Click Next.

    If you are installing WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0, one of the following is displayed:

    If you are installing WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1, the Choose Product Directory dialog box is displayed as shown in the following figure.

    Figure 2-7 Choose Product Directory Dialog Box

    Note: If you are installing WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1, it is possible to overwrite an existing installation of WebLogic Process Integrator without warning.

  3. Do one of the following:

  4. Click Next.

  5. Go to Step 6. Configuring the JDBC Connection Pool.

 

Step 6. Configuring the JDBC Connection Pool

As noted in Installation Prerequisites, you must have access to a supported database server and the JDBC driver required for that server must be installed before you can install WebLogic Process Integrator.

To enable WebLogic Process Integrator to communicate with your database server you must define a JDBC connection pool. As part of the installation process, you are prompted for information required to establish access to your database server. Other JDBC pool parameters, such as pool name and maximum connections, are set to default values. If necessary, after completing the installation, you can customize your configuration as described in Starting, Stopping, and Customizing BEA WebLogic Process Integrator.

SQL database definition language files are provided during installation. As described in Step 9. Creating the WebLogic Process Integrator Tables, these files are used by your database administrator to create tables required by WebLogic Process Integrator on your database server. The user name, password, and other identifiers used to access these tables must be chosen by you and your database administrator together, and they must reflect the JDBC connection pool information you provide in this step.

The information required to configure the JDBC connection pool depends on whether you are installing WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1 or for 6.0. The following section provides instructions for WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0. If you are installing WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1, skip the following section and go to Configuring JDBC: WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1.

Configuring JDBC: WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0

After you have selected the Product Directory, the JDBC Connection Pool dialog is displayed as shown in the following figure.

Figure 2-8 JDBC Connection Pool Dialog Box

To configure the JDBC connection pool:

  1. Enter values for the JDBC Connection Pool Driver, User, Password, and URL.

    The required information is summarized in JDBC Connection Pool Parameters at the end of this procedure.

  2. Click Next.

    The Mail Session Configuration dialog box is displayed.

  3. Go to Step 7. Completing the Installation.

JDBC Connection Pool Parameters

The following table summarizes the information required to configure the JDBC connection pool.

Table 2-1 JDBC Connection Pool Parameters

Parameters

Description

JDBC
Connection Pool
Driver

JDBC driver to be used to connect to the database.

JDBC
Connection Pool
User

Account login name required for connecting to the database server.

JDBC
Connection Pool
Password

Password required for connecting to the database server.

JDBC
Connection Pool
URL

URL for the database, as specified in the JDBC driver documentation. The format for the JDBC connection pool URL is discussed in the following section (JDBC Connection Pool URL Format).

JDBC Connection Pool URL Format

The JDBC connection pool URL includes specification of the following:

The following provide sample URLs for each supported database.

Configuring JDBC: WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1

After you have selected the Product Directory, the Database Selection dialog is displayed as shown in the following figure.

Figure 2-9 Database Selection Dialog Box

To configure the JDBC connection pool:

  1. Select a database.

    Oracle, Microsoft SQL Server, Sybase, and Cloudscape are the only database platforms that are currently certified with BEA WebLogic Process Integrator release 1.2.1. If you select Other, you must configure the Driver and JDBC connection pool manually. For information about how these files might be modified, see the configuration files listed in BEA WebLogic Process Integrator Sample Configuration Files.

  2. Click Next.

    The database configuration dialog box is displayed.

    For example, the following figure shows the database configuration dialog box displayed when you select Oracle.

    Figure 2-10 Oracle Configuration Dialog Box

  3. Enter values for the Host Name, Database Name, User, Password, and Port in the appropriate fields.

  4. Click Next.

    The Confirm Selection of Base WebLogic Server Version dialog box is displayed.

  5. Go to Step 7. Completing the Installation.

 

Step 7. Completing the Installation

After you have provided the information required to configure the JDBC connection pool, the dialog box displayed depends on the version of WebLogic Process Integrator you are installing:

These dialog boxes are shown in the following figures.

Figure 2-11 Mail Session Configuration Dialog Box

Figure 2-12 Confirm Selection of Base WebLogic Server Version Dialog Box

To complete the installation:

  1. Do one of the following

  2. Click Next to begin installation.

    The Installation Status dialog box is displayed as shown in the following figure.

    Figure 2-13 Installation Status Dialog Box

    When installation is complete, the Installation Complete dialog box is displayed as shown in the following figure.

    Figure 2-14 Install Complete Dialog Box

  3. Click Done to dismiss the Installation Complete dialog box.

  4. Go to Step 8. Installing Your Software License.

 

Step 8. Installing Your Software License

BEA WebLogic Process Integrator cannot be used without a valid software license. If you purchased the software on CD-ROM, the license is provided on a diskette in the product box. If you purchased a license for a product downloaded from the BEA Web site, you receive the license as an e-mail attachment.

The method used to install the software license depends on which version of the product you have installed: Release 1.2.1 for WebLogic Server 6.0 or Release 1.2.1 for WebLogic Server 5.1. This section provides procedures for installing a license for both versions.

Installing the License: WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0

To install your software license:

  1. Save the license file from the appropriate diskette or e-mail attachment with a name other than license.bea, in the BEA Home directory. For example, save the file as wpli_license.bea. Use this file as the license_update_file in step 4.

    Warning: Do not overwrite the existing license.bea file.

  2. Do one of the following:

  3. Add the JDK to your PATH variable by entering one of the following commands:

  4. Enter one of the following commands:

  5. Save a copy of your updated license.bea file in a safe place outside the WebLogic Server and application installation directories.

    Although no one else can use your license file, you should save this information in a place protected from either malicious or innocent tampering by others.

Installing the License: WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1

To install the software license, copy the license.bea file from the diskette or e-mail attachment to the directory you designated as the BEA Home directory during installation.

 

Step 9. Creating the WebLogic Process Integrator Tables

Before you can run BEA WebLogic Process Integrator, you must first create the required database tables on the database server. The ddl subdirectory of the WebLogic Process Integrator product directory (for example, c:\bea\wlprocessintegrator1.2.1\ddl) contains SQL Data Definition Language (DDL) files that are used to create the required tables. Use the database administrator tool to execute the appropriate DDL file.

The procedure for using the DDL file to create the tables in Cloudscape are provided in the following section. For other supported databases, consult your database administrator for the procedure.

To create tables for this database . . .

Use this DDL file . . .

Oracle 8.1.5 or 8.1.6

wlpi_oracle.ddl

Microsoft SQL Server 7.0

wlpi_mssql.ddl

Sybase System 11

wlpi_sybase.ddl

Cloudscape 3.5.x

wlpi_cloudscape.ddl

Note: If you have installed WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0 and you are using a Cloudscape database, in addition using the DDL file to create the required tables, you must update the server.cmd file as described in the following section.

Creating Tables and Updating Settings for Cloudscape

This section describes how to create the database tables and update configuration settings for a Cloudscape database.

To create the tables for Cloudscape

  1. Start Cloudview, the Cloudscape administrative tool, by executing the following command (enter as a single line): 

    java -classpath C:\bea_home\weblogic_server_dir\samples\eval\cloudscape\lib\
    tools.jar;C:\bea\wlserver6.0\samples\eval\cloudscape\lib\
    cloudscape.jar COM.cloudscape.tools.cview

  2. In Cloudview, choose File—>New—>Database. Create a database called wlpi.

  3. Click the Database tab, then click on the Script icon to open wlpi_cloudscape.ddl.

  4. Click the Execute icon to run the script.

  5. Close Cloudview.

If you have installed WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0, you must modify the server.cmd (Windows) or server.sh (UNIX) file for Cloudscape. The required settings are shown in server.cmd/server.sh in Appendix A.

If you entered the appropriate settings for Cloudscape in the Step 6. Configuring the JDBC Connection Pool, settings in the config.xml (WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0) or weblogic.properties (WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1) file have been updated as required.

If you are configuring a Cloudscape database after installation, refer to the sections appropriate to your installation.

 

Step 10. Verifying the WebLogic Process Integrator Installation

To verify the installation, start each application as described in Starting and Stopping BEA WebLogic Process Integrator Components.

 

Uninstalling BEA WebLogic Process Integrator

This section provides platform-specific procedures for uninstalling WebLogic Process Integrator. See the section appropriate for your platform:

Uninstalling WebLogic Process Integrator on a Windows system

To uninstall BEA WebLogic Process Integrator on Windows:

  1. Do one of the following:

  2. Click Uninstall to remove WebLogic Process Integrator. When the program has been removed, the Uninstall Complete dialog box is displayed, as shown in the following figure.

    Figure 2-16 Uninstall Complete Dialog Box

  3. Click Exit to dismiss the dialog box.

Uninstalling WebLogic Process Integrator on a UNIX System

To uninstall BEA WebLogic Process Integrator on a UNIX system:

  1. Do one of the following:

    If you are uninstalling WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0, go to the uninstaller directory. (The default pathname for the directory is /bea/wlprocessintegrator1.2.1/uninstaller.).

    If you are uninstalling WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0, go to the UninstallerData directory. (The default pathname for the directory is /bea/wlprocessintegrator1.2.1/UninstallerData.)

  2. Type Uninstall WebLogic Process Integrator then press Enter.

    When the uninstallation process is complete, the message Uninstall Complete is displayed.

 

Troubleshooting the Installation

This section describes the problems that may occur during installation, and the symptoms, possible causes, and solutions for those problems: The following problems are described:

Previous Installation Found

Symptom

You have selected a BEA Home directory in the Choose BEA Home Directory Dialog Box and clicked Next. The Previous Installation Found warning is displayed as shown in the following figure.

Figure 2-17 Previous Installation Found Warning

Note: This warning is only displayed if you are installing WebLogic Server Process Integrator 1.2.1 for WebLogic Server 6.0. If you are installing WebLogic Process Integrator 1.2.1 for WebLogic Server 5.1, it is possible to overwrite a previous installation without warning.

Solution

The warning dialog presents three options: Continue, Cancel and Exit:

If you select this option...

The results are as follows...

Continue

The installation continues and the product is installed in the same directory as the previous installation. overwriting previously installed BEA WebLogic Process Integrator files. Therefore, any changes that you made to these files on the previous installation are lost. If you have changed any of the BEA WebLogic Process Integrator files, you may want to copy them into a temporary directory before proceeding with this option.

Cancel

You are returned to the Choose BEA Home Directory Dialog Box. Select another BEA Home directory (or create a new BEA Home directory) in which to install.

Exit

The installation process is stopped and no changes are made to the system.

WebLogic Server 6.0 Not Detected

Symptom

You have installed WebLogic Server 6.0 but one of the following occurs:

Possible Cause 1

Your WebLogic Server 6.0 installation has an evaluation license.

Solution 1

You must purchase WebLogic Server and update the license. Information about purchasing licenses for BEA software can be found at http://www.beasys.com/buy.

Possible Cause 2

You have more than one BEA Home directory configured and the selected directory does not correspond to a valid installation.

Solution 2

Click Cancel to dismiss the dialog box, then click Previous in the Select the Version of WebLogic Process Integrator dialog box to return to the Choose BEA Home Directory dialog box. Select a valid BEA Home directory. For information about the BEA Home directory, see "BEA Home Directory" at http://download.oracle.com/docs/cd/E13222_01/wls/docs60/install/instpre.html#1026378.

Possible Cause 3

You have not installed WebLogic Server 6.0.

Solution 3

Click Exit to dismiss the dialog box and exit the installation. Install WebLogic Server 6.0 before installing WebLogic Process Integrator 1.2.1 for WebLogic Server 6.0

 

 

Copyright © 2001 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.