Configuring and Starting BEA WebLogic Process Integrator

 

The following sections explain how to configure and start the BEA WebLogic Process Integrator Server, Studio client application, and Worklist client application:

• Creating Database Tables

• Customizing and Starting BEA WebLogic Process Integrator

• Stopping BEA WebLogic Process Integrator

 

---

Creating Database Tables

In order to run BEA WebLogic Process Integrator, you must first create the required database tables. The <BEA WebLogic Process Integrator Root>\ddl directory (default is c:\bea\wlprocessintegrator1.2\ddl) contains SQL Data Definition Language (DDL) files to create the required tables. Use your database administrator tool to execute the appropriate DDL file.

• Oracle 8.1.5—use wlpi_oracle.ddl

• Microsoft SQL Server 7.0—use wlpi_mssql.ddl

• Sybase System 11—use wlpi_sybase.ddl

• Cloudscape 3.5.0—use wlpi_cloudscape.ddl

 

---

Customizing and Starting BEA WebLogic Process Integrator

Before you can use BEA WebLogic Process Integrator to define workflows that include send e-mail actions, you need to customize the run-time environment by changing certain settings in BEA WebLogic Process Integrator. The following sections explain how to change these settings and start the BEA WebLogic Process Integrator components:

• Customizing and Starting the BEA WebLogic Process Integrator Server

• Starting the BEA WebLogic Process Integrator Studio and Worklist

Customizing and Starting the BEA WebLogic Process Integrator Server

The following steps explain how to customize the BEA WebLogic Process Integrator Server run-time environment and start the server.

Note: If you need to define workflows that include send e-mail actions, you must perform Step 1. Editing the weblogic.properties File and Step 2. Configuring the Mail Session Properties for the Workflow Processor EJBs. If you do not need to define workflows that include send e-mail actions, you may skip Step 1 and Step 2.

Step 1. Editing the weblogic.properties File

To edit the weblogic.properties file:

1. Navigate to the weblogic.properties file in the root directory of the BEA WebLogic Process Integrator installation.

   • On Windows, navigate to the directory where the BEA WebLogic Process Integrator is installed. The default is c:\bea\wlprocessintegrator1.2

   • On UNIX, change directories to the bea/wlpi directory:

     cd bea/wlpi

2. Use a text editor to open the weblogic.properties file.

3. Scroll down to the "WLPI Specific Settings" section.

4. Edit the MailSession property mail.host using the value shown in Listing 3-1.

   Listing 3-1 Mail Session Property

   ---

   # Mail session
   weblogic.resource.MailSession.com.bea.wlpi.MailSession=\
       mail.from=user@host,\
       mail.host=<smtp or outgoing mail host name>

   ---

   Listing 3-2 provides an example.

   Listing 3-2 Mail Session Property Example

   ---

   # Mail session
   weblogic.resource.MailSession.com.bea.wlpi.MailSession=\
       mail.from=user@host,\
       mail.host=xyz.bea.com

   ---

5. Save your changes and close the file.

Step 2. Configuring the Mail Session Properties for the Workflow Processor EJBs

To configure the mail-session properties:

1. Run the BEA WebLogic EJB Deployer Tool.

   On Windows:

   1. Navigate to the bin directory (default is c:\bea\wlprocessintegrator1.2\bin) using Windows Explorer.

   2. Double-click DeployerTool.cmd to start the BEA WebLogic EJB deployer tool.

   On UNIX:

   1. Change directories to the bea/wlpi/bin directory:

      cd bea/wlpi/bin

   2. Run the BEA WebLogic EJB Deployer Tool:

      . ./deployertool.sh

2. Navigate to Deployer —> BEA WebLogic Process Integrator —> Beans —> WorkflowProcessor —> Environment Entries. The environment entries for the Workflow Processor EJB are displayed in the upper-right panel (see Figure 3-1).

   Figure 3-1 BEA WebLogic EJB Deployer Tool Showing Environment Entries

   

3. Define the following mail-session properties by double-clicking in the text field you want to edit and typing the appropriate value (use the values shown in Figure 3-1 as a guide):

   • mail/sender-name

   • mail/sender-address

   • mail/mail-user

   • mail/mail-transport-protocol

   • mail/mail-host

   • mail/mail-from

   • mail/mail-debug

   • mail/authenticator-password

   • mail/authenticator-id

4. Select File —> Save to save your changes and exit.

   For more information, see Deploying EJBs with the Deployer Tool at

   http://www.weblogic.com/docs51/classdocs/API_ejb/EJB_deploy.html

Step 3. Starting the BEA WebLogic Process Integrator Server

To start the BEA WebLogic Process Integrator Server:

On Windows:

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

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

On UNIX:

1. Change directories to the bea/wlpi/bin directory:

   cd bea/wlpi/bin

2. Run the script wlpi.sh:

   . ./wlpi.sh

Starting the BEA WebLogic Process Integrator Studio and Worklist

The following steps explain how to start the BEA WebLogic Process Integrator Studio and Worklist.

Starting the BEA WebLogic Process Integrator Studio

To start the BEA WebLogic Process Integrator Studio:

On Windows:

1. Choose Start —> Programs —> BEA WebLogic E-Business Platform —> WebLogic Process Integrator 1.2 —> Start Studio from the Windows Start menu. The Logon dialog box shown in Figure 3-2 will be displayed in front of the BEA WebLogic Process Integrator Studio application window.

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

   Figure 3-2 BEA WebLogic Process Integrator Studio Logon Dialog Box

   

2. Enter one of the default database user names with the user name's corresponding password in the appropriate fields. The default users admin, system, wlpisystem, mary, and joe were set up to use your database when your database administrator created the database tables required by BEA WebLogic Process Integrator (see Creating Database Tables for more information). If you do not know how to determine the password for a particular default user, contact your database administrator.

   In the Server [:port] field, enter the computer name or IP address of the system that is running the BEA WebLogic Process Integrator Server application in the position shown as follows:

   t3://<computer name or IP address>:7001

   localhost can be used in place of <computer name or IP address> if the Server is running on the same computer as the Client application.

Starting the BEA WebLogic Process Integrator Worklist

To start the BEA WebLogic Process Integrator Worklist:

On Windows:

1. Choose Start —> Programs —> BEA WebLogic E-Business Platform —> WebLogic Process Integrator 1.2 —> Start Worklist from the Windows Start menu. The Logon dialog shown in Figure 3-3 will be displayed in front of the BEA WebLogic Process Integrator Worklist application window.

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

   Figure 3-3 BEA WebLogic Process Integrator Worklist Logon Dialog Box

   

2. Enter one of the default database user names with the user name's corresponding password in the appropriate fields. The default users admin, system, wlpisystem, mary, and joe were set up to use your database when your database administrator created the database tables required by BEA WebLogic Process Integrator (see Creating Database Tables for more information). If you do not know how to determine the password for a particular default user, contact your database administrator.

   In the Server [:port] field, enter the computer name or IP address of the system that is running the BEA WebLogic Process Integrator Server application in the position shown as follows:

   t3://<computer name or IP address>:7001

   localhost can be used in place of <computer name or IP address> if the Server is running on the same computer as the Client application.

 

---

Stopping BEA WebLogic Process Integrator

The following sections provide instructions in stopping the BEA WebLogic Process Integrator applications.

Stopping the BEA WebLogic Process Integrator Studio or Worklist

To stop the BEA WebLogic Process Integrator Studio or Worklist:

1. Choose File —> Logoff from the application window.

2. Choose File —> Exit from the application window.

Stopping the BEA WebLogic Process Integrator Server Application

To stop the BEA WebLogic Process Integrator Server application:

1. Activate the Server Application (command prompt) window.

2. Press Ctrl+C. The prompt "Terminate batch job (Y/N)?" appears.

3. Press Y in response to prompt. The Server application (command prompt) window disappears, and the Server application stops.