ActiveBPEL for People Setup
Introduction
Before completing this part of the sample, refer to ActiveBPEL for People Introduction.
This step describes installing and configuring the necessary ActiveBPEL Enterprise Extended Services, configuring the access for the ActiveBPEL Task Inbox application and installing the sample application into ActiveBPEL Designer.
Requirements
- ActiveBPEL Designer with the ActiveBPEL for People plugin installed (New in ActiveBPEL 4.0)
- ActiveBPEL Enterprise with ActiveBPEL for People enabled (New in ActiveBPEL 4.0)
- Strong working knowledge of the WS-BPEL 2.0 specification; building, testing and deploying processes using ActiveBPEL Designer and the functionality of ActiveBPEL Enterprise
Objectives
- Install the ActiveBPEL for People components
- Configure the Identity Service to use a supplied XML file that contains a set of users for the sample application. You can optionally set up the LDAP server and modify the identities used in the sample
- (Advanced) Configure the Email Service
Getting Set Up
Setup is divided into three parts:
- Adding a project and WSDLs to ActiveBPEL Designer
- Installing the Task Inbox on Designer's Development Server (unless your platform is Tomcat)
- Configuring your ActiveBPEL Enterprise server
Designer Setup
The files provided with this article are contained in ActiveBPELforPeople_Intro.zip. You may extract this archive into a directory of your choosing. The archive contains an ActiveBPEL Designer project that includes subdirectories for support, test, configuration and deployment files.
To use the project, start ActiveBPEL Designer, and select File / Import from the main menu. In the Import dialog, select General / Existing Projects into Workspace and navigate to the following project directory:
[path to extracted archive]/ActiveBPELforPeople
The project called ActiveBPELforPeopleSample appears in the Navigator View.
Switch to the Web References view and select the Add a Web Reference icon. Select the Browse Projects... button and navigate to the wsdl directory under the ActiveBPELforPeopleSample project. Add all the WSDL files located in that directory. There should be five WSDL files added to Web References:
- email.wsdl
- LoanApprover.wsdl
- LoanAssessor.wsdl
- LoanProcessor.wsdl
- LoanRules.wsdl
Installing the Task Inbox Application and Setting up Inbox Users
The ActiveBPEL Enterprise Task Inbox is the application that manages tasks and users. Authenticated users sign in to the Inbox and can work on tasks that have been assigned to them. For the purposes of this sample, we will configure the Task Inbox application on an instance of Tomcat. The reason for this is to easily avoid security constraints on application servers that may require additional setup. If you are using ActiveBPEL Enterprise for aplatform other than Tomcat you can use the Tomcat instance that ships with ActiveBPEL Designer. Note: If you want assistance with configuring the identity service to use your in-house LDAP server, please contact Active Endpoints.
To configure Tomcat to use the identity file included with the sample, perform
the following steps.
- Copy the aeworkflow-users.xml file from the sample project support/Conf directory into the /conf directory of Designer's ActiveBPEL_Tomcat directory.
- Copy the aetask.xml file from the sample project support/Conf directory into the /conf/Catalina/localhost directory of ActiveBPEL_Tomcat. Note: This file overrides the default Tomcat security provider for the Task Inbox to use the aeworkflow-users.xml file copied in the previous step. If you want to later use the standard Tomcat security provider you must delete this file and restart the server.
- Navigate to your ActiveBPEL Enterprise installation folder, and from the deploy folder, copy the aetask.war file to the /webapps folder of the ActiveBPEL_Tomcat server. If you are using ActiveBPEL Enterprise for Tomcat, deploy the ActiveBPEL task application using the ActiveBPEL Enterprise Deploy-Config tool.
Configuring ActiveBPEL Enterprise
To complete the configuration follow these steps:
- Start your ActiveBPEL Enterprise server, and if different from Tomcat, also start the ActiveBPEL_Tomcat server where the ActiveBPEL Task Inbox application is running.
- Configure the ActiveBPEL Enterprise Identity Service as follows:
- Open the Administration Console
- Select Identity Service
- Check the Enable checkbox
- Select XML File for the Provider Type
- Enter the full path to the file location of the aeworkflow-users.xml file. Note: you can have multiple copies of the file if servers are on different machines.
- In the User for Test field, enter one of the users from the aeworkflow-users.xml file, such as loanrep1.
- Click the Test Settings button. The message Test successful appears.
- Click Update
Open the Task Inbox Sign In page by typing the following into your Web Browser:
http://[server:port]/aetask
where you replace the [server:port] section with your details.- Sign into the ActiveBPEL Task Inbox application using one of the provided users to ensure that the configuration is working correctly. You can use loanrep1 for both the username and password. (If you can't sign in, check that the Tomcat server is running, that the WAR file and the aeworkflow-users.xml file are in the correct locations and that you have a correct username and password.)
- If Sign In is successful, you will see an Inbox indicating there are no tasks.
Continue to the next part, Using ActiveBPEL for People.