Installing BEA WebLogic Process Integrator

 

The following sections describe installing BEA WebLogic Process Integrator on Windows and UNIX:

• Installing the BEA WebLogic Process Integrator Software Package

• Installing Your Software License

• Uninstalling BEA WebLogic Process Integrator

 

---

Installing the BEA WebLogic Process Integrator Software Package

The following procedures explain how to install BEA WebLogic Process Integrator on Windows and UNIX. After installation, you must perform certain configuration tasks before certain features of the product can work properly. For instructions, refer to Configuring and Starting BEA WebLogic Process Integrator.

On Windows:

To install BEA WebLogic Process Integrator on Windows:

1. Insert the BEA WebLogic Process Integrator CD in the CD tray.

2. Choose Start—>Programs—>Windows NT (or 2000) Explorer from the Start menu.

3. Click on the CD drive and navigate to the NT folder.

4. Double-click Setup.exe to start the installation process. The BEA WebLogic Process Integrator Splash screen is displayed (see Figure 2-1) for a few seconds. Then, the Introduction screen (see Figure 2-2) is displayed. Proceed to Step 5.

On UNIX:

To install the BEA WebLogic Process Integrator on UNIX:

1. Insert the BEA WebLogic Process Integrator CD in the CD tray. If the daemon /usr/sbin/vold is running, the CD should be mounted in the /cdrom directory. If vold is not running, consult your UNIX administration documentation to mount the CD.

2. Change directories to unix:

   > cd unix

3. Start the installation by typing setup.bin at the prompt:

   unix> setup.bin

4. Press the ENTER key. The BEA WebLogic Process Integrator Splash screen is displayed (see Figure 2-1) for a few seconds. Then, the Introduction screen (see Figure 2-2) is displayed.

   Figure 2-1 BEA WebLogic Process Integrator Splash Screen

   

   Figure 2-2 Introduction Screen

   

5. Click Next on the Introduction screen to display the License Agreement screen (Figure 2-3).

   Figure 2-3 License Agreement Screen

   

6. Click the Yes radio button to accept the license agreement, then click Next to proceed to the Important Information (Application Requirements) screen (Figure 2-4).

   Figure 2-4 Important Information (Application Requirements) Screen

   

7. Click Next to acknowledge that you have read and understood the requirements for BEA WebLogic Process Integrator and display the Target Program Group screen (Figure 2-5).

   Note: The Target Program Group screen (Figure 2-5) and the Choose Install screen (Figure 2-6) will only be displayed during Windows installations. They do not apply to UNIX installations.

   Figure 2-5 Target Program Group Screen

   

8. Select the location where you would like to create shortcuts to the BEA WebLogic Process Integrator software, then click Next. You can select from the following option buttons (NOTE: This step only applies to Windows installations):

   • In a new program group. You can enter a name of your choice in the text box or use the default. The shortcut icons are created in the selected Program group accessible from the Start menu.

   • In an existing program group. To add the BEA WebLogic Process Integrator shortcuts to an existing program group, select the desired Program group from the drop-down list.

   • In the Start Menu. The BEA WebLogic Process Integrator shortcuts are added directly to the Start Menu and are not included in a Program group.

   • On the Desktop. The BEA WebLogic Process Integrator shortcuts are added to your Desktop and are not accessible from the Start Menu.

   • Other. You can enter a folder name in the text box or click Choose and select an existing folder on your system. The shortcuts are placed in the specified folder. You can access them through My Computer or using the Windows Explorer.

   • Don't create shortcut icons. If you choose this option, you will only be able to access the software using scripts or commands.

     The screen in Figure 2-6 displays.

     Figure 2-6 Choose Install Set Screen

     

9. Select the components that you want to install on your system. You can select from the following options (NOTE: This step only applies to Windows installations):

   • Client Install: This option installs both BEA WebLogic Process Integrator client applications, Studio and Worklist.

   • Server Install: This option installs the BEA WebLogic Process Integrator Server application.

   • Full Install: This option installs both the client and server applications.

   • Customize: This option installs any combination of BEA WebLogic Process Integrator Server, Studio, or Worklist that you choose.

     Note: If you chose the Client (only) install set or install a customized install set that does not include the Server application, you will still perform Step 10 (see Figure 2-7), where you choose a BEA Home directory and Step 11 (if applicable, see Figure 2-8), where you deal with previous installations of BEA WebLogic Process Integrator. However, you will bypass Step 12, where you select and configure your database (see Figure 2-9 and Figure 2-10) and proceed directly to the installation of the product (Figure 2-11).

     Click Next to proceed to the Choose BEA Home Directory screen (see Figure 2-7).

     Figure 2-7 Choose BEA Home Directory Screen

     

10. Create or select a BEA Home directory. The BEA Home directory is the root directory in which you install all BEA products. If you do not already have a BEA Home directory (default is c:\bea), you will have the option of creating a new BEA Home directory. You can create a new BEA Home directory as follows:

    1. Select the Create a New BEA Home radio button.

    2. Accept the default location for your BEA Home directory or click Browse to specify a different location. If you accept the default location, your BEA Home directory will be c:\bea, and your BEA WebLogic Process Integrator software will be installed in the c:\bea\wlprocessintegrator1.2 directory. Click Next to proceed to the Database Selection screen (see Figure 2-9).

    If you already have one or more BEA Home directories on your system, you can use one of those directories as follows:

    1. Click on the Use Existing BEA Home radio button.

    2. Select a BEA Home directory from the scrolling list displayed to the right of the radio buttons. All of the valid BEA Home directories will be displayed in the scrolling list, and only valid BEA Home directories can be used to install BEA WebLogic Process Integrator 1.2. Valid BEA Home directories are directories where BEA products have been installed using BEA's standard installation program. Click Next to proceed to the Database Selection screen (see Figure 2-9).

       Note: If you already have a version of BEA WebLogic Process Integrator 1.2 installed on your system, the Previous Installation Found dialog box (Figure 2-8) is displayed before the Database Selection screen (Figure 2-9).

       Figure 2-8 Previous Installation Found Dialog Box

       

11. If a previous version of BEA WebLogic Process Integrator 1.2 was found on your system, you must select an option for dealing with it. You will not see this dialog box if you have installed versions previous to Version 1.2 of BEA WebLogic Process Integrator because the BEA Standard Installation, which uses the BEA Home directory as a directory under which all BEA products are to be installed, was introduced with the 1.2 release. The following are the explanations of the options presented in this dialog box and the implications of their use:

    • Continue: If you select this option, all of your BEA WebLogic Process Integrator files will be overwritten, including your license.bea file. Therefore, any changes made to these files on the previous installation will be 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: This option will return you to the Choose BEA Home Directory screen (Figure 2-7). This will allow you to select another BEA Home directory (or create a new BEA Home directory) in which to place your installation.

    • Exit: This option allows you to exit the installation without making any changes to system.

      Click Continue to proceed to the Database Selection screen (see Figure 2-9).

      Figure 2-9 Database Selection Screen

      

12. Select a database, then click Next. A database configuration dialog box will be displayed. For example, the dialog box displayed in Figure 2-10 is the Oracle configuration dialog box. If you select Other, the installation program will not configure your database connections. Also, see the following note:

    Note: Oracle, Microsoft SQL Server, Sybase, and Cloudscape are the only database platforms that are currently certified with BEA WebLogic Process Integrator version 1.2. If you want to use a database platform other than the four listed, you will then have to configure the BEA WebLogic Process Integrator database connections manually and supply the drivers necessary to use the database of your choice. For information on how these files might be modified, see the configuration files listed in BEA WebLogic Process Integrator Sample Configuration Files.

    Figure 2-10 Oracle Configuration Dialog Box

    

    Provide the HostName, Database Name, User, Password, and PortNumber in the appropriate fields to configure the database of your choice. Sample values have been entered into the dialog box shown in Figure 2-10. To see examples of configuration files that display these values, see BEA WebLogic Process Integrator Sample Configuration Files.

    If you do not know the information required by the database configuration dialog box for your particular RDBMS platform, ask the database administrator who set up the database that you will use with BEA WebLogic Process Integrator.

    Click Next to proceed with the installation. The dialog box in Figure 2-11 shows the status of the installation process.

    Figure 2-11 Setup Status Screen

    

    After the installation process has completed, the Install Complete screen displays (see Figure 2-12).

    Figure 2-12 Install Complete Screen

    

13. Click Done to complete the installation.

    If you installed to the default BEA HOME directory (c:\bea), the installation process creates a root directory for BEA WebLogic Process Integrator named c:\bea\wlprocessintegrator1.2.

 

---

Installing Your Software License

The BEA WebLogic Process Integrator requires a software license in order to use the product. To install the software license, copy license.bea to the BEA Home directory (c:\bea is the default).

 

---

Uninstalling BEA WebLogic Process Integrator

To uninstall BEA WebLogic Process Integrator:

On Windows:

To uninstall BEA WebLogic Process Integrator on Windows:

1. Choose Start—>Programs —> BEA WebLogic E-Business Platform —> WebLogic Process Integrator 1.2 —>Uninstall BEA WebLogic Process Integrator 1.2 from the Start menu.

   Note: This is how you would uninstall BEA WebLogic Process Integrator if you used the default program group (BEA WebLogic Process Integrator 1.2) displayed in Figure 2-5.

   The screen in Figure 2-13 is displayed.

   Figure 2-13 BEA WebLogic Process Integrator Uninstall Start Screen

   

2. Click on Uninstall to start uninstalling BEA WebLogic Process Integrator. When the uninstallation of BEA WebLogic Process Integrator is complete, Figure 2-14 is displayed.

   Figure 2-14 BEA WebLogic Process Integrator Uninstallation Complete Screen

   

3. Click Exit to exit the uninstallation program.

On UNIX:

To uninstall BEA WebLogic Process Integrator on UNIX:

1. Change directories to the UninstallerData directory (default is /bea/wlpi/UninstallerData).

2. Type Uninstall WebLogic Process Integrator.

3. Press ENTER.

   When uninstallation is complete, the message Uninstall Complete will be displayed.