WebSphere Portal content publishing and IBM Content Manager Workflow By Stephen Knaus (knaus@us.ibm.com) Software Engineer, IBM Corp. May 2003 Abstract WebSphere Portal content publishing (WPCP) uses a Workflow server for routing web content management tasks. WPCP connects to different workflow servers, including IBM Content Manager Document Routing. This paper describes how to configure IBM Content Manager and WPCP in order to enable IBM Content Manager Workflow. Installing and Configuring IBM Content Manager Workflow After you have IBM Content Manager installed, you must follow these steps to install and configure IBM Content Manager Workflow: 1. Configure IBM Content Manager Open the EIP System Administration Client, and make the following changes: a. Change the Library Server Configuration by clicking Library Service Parameters > Configurations. Make sure the Allow trusted logon check box is selected. b. Verify the properties for ICMCONCT user by clicking Authentication > Users. Make sure it has UserDB2TrustedConnect privilege sets.
2. Install WPCP, specifying IBM Content Manager as the workflow and data source a. Install WPCP if it is not already installed. b. Make sure that you specify IBM Content Manager as the data source and as the Workflow engine. 3. Create the WCM Process Model a. Open an EIP Development window and invoke: %WAS_HOME%\wcp\author\workflow\CMProcessModelEnv.bat to set up the Java CLASSPATH. b. From the EIP Development window, invoke CMProcessModel to create the WCM Process Model in IBM Content Manager: java CMProcessModel %WAS_HOME%\wcp\author\workflow\liteWF.xml icmnlsdb icmadmin password -n c. Restart WebSphere Admin Server. LDAP Configuration and Import By default, CMProcessModel creates the sample users in IBM Content Manager and will work with WPCP without any additional LDAP configuration. Follow these steps if you
want to connect IBM Content Manager to an LDAP server and import the users from LDAP. 1. Install IBM Content Manager and EIP When prompted, select the three check boxes for importing LDAP user information. Do not select the option to import the datasource information from LDAP. If you have already installed without LDAP, follow the instructions below to set up an LDAP import. 2. Verify LDAP Configuration Open the EIP System Administration Client, and make the following changes: a. Select LDAP Configuration from the Tools menu. b. On the LDAP tab, make sure the Enable LDAP User import and authentication check box is selected. Make sure Enable importing of Datasources from LDAP is not selected. c. Fill in the LDAP server settings on the Server tab. Make sure you specify uid for the User attribute.
d. Click OK. 3. Import the LDAP users a. In the EIP System Administration Client, click Authentication > Users, and create a new user by right-clicking and selecting New. b. Click the LDAP button to display the Import Users from LDAP window. c. Click Show All to show all users. Click Yes at the warning message window. d. Select tara and click OK. e. Change tara's privilege sets (Privilege Set and Grant Privilege Set) to WCMPrivilegeSet. f. Click the Assign to Groups tab, and select the following groups: WORKFLOW PARTICIPANTS CONTENT PUBLISHER g. Click OK. h. Repeat for the following users (with groups): rob (WORKFLOW PARTICIPANTS, DOMAIN EXPERT, PROJECT LEAD) dave (WORKFLOW PARTICIPANTS, CONTENT CONTRIBUTOR) greg (WORKFLOW PARTICIPANTS, CONTENT CONTRIBUTOR) WPCPAdmin (WORKFLOW PARTICIPANTS)
CMProcessModel.java This program integrates with the WPCP process XML reader to generate the process information based on the XML file. Building and executing CMProcessModel requires litewf.jar to also be in the class path. For execution, set the class path to the following (from an EIP Development Window): classpath=.;%was_home%\wcp\author\workflow\cmprocessmodel.jar; %WAS_HOME%\wcp\author\workflow\liteWF.jar;%classpath% Make sure CMProcessModel.jar is ahead of litewf.jar in the class path. CMProcessModel.jar and litewf.jar are shipped with WPCP and are installed at: %WAS_HOME%\wcp\author\workflow. CMProcessModel takes the following arguments: java CMProcessModel <XMLFile> <database> <userid> <password> <mode> <XMLFile> is the name of the XML file containing the process information, such as litewf.xml. <database> is the name of the database, such as icmnlsdb. <userid> and <password> are the names of the administrator user ID and password, respectively, such as icmadmin password. Possible values for <mode> are: -i: Interactive Mode The application will check for the prerequisites such as the privilegeset and ACLs before creating the default process models used in WPCP application. (User interactive is required to create the prerequisites). -n: Non-Interactive mode The application will check for the prerequisites such as the privilegeset and ACLs before creating the default process models used in WPCP application. The application will automatically create all of the prerequisites. Example: java CMProcessModel litewf.xml icmnlsdb icmadmin password I L IBM Enterprise Information Portal Version 8.1 Workflow JavaBeans For more information on IBM Enterprise Information Portal Version 8.1 Workflow JavaBeans that you can use to connect to an IBM Content Manager Version 8.1 server, see http://www- 1.ibm.com/support/docview.wss?rs=75&context=SSCQTKQ&uid=swg27002476
Trademarks Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Microsoft Word, ActiveX, Microsoft, Windows, Windows NT(R), and the Windows logo are trademarks or registered trademarks of Microsoft Corporation in the United States, or other countries, or both. UNIX is a registered trademark of The Open Group. Other company, product, and service names, which may be denoted by a double asterisk (**), may be trademarks or service marks of others. Notices The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AND ANY ASSOCIATED CODE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON- INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Copyright International Business Machines Corporation 2003. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.