Using the IBM Business Process Center V.8

with the IBM BPM: Process Server V.8 on z/OS

These instructions assume you have configured the IBM Process Center on Linux for system z, andthe IBM Business Process Manager: Process Server on z/OS. There should be a copy of this PDF in the “ZWPS8” folder on your desktop, which you might finduseful for copying and pasting long commands.Notes: Revision Date: October 17, 2013

• Each team will have it's own unique cell name with the team number in the second characterof the cell prefix. This paper substitutes a '#' character for the team number: B# or b#.

Table of Contents

Using the Process Center..............................................................................................................1Install the Process Designer......................................................................................................2Configure Process Designer......................................................................................................2Test the Hiring Sample in the Process Center using the Process Designer...............................2Test the Hiring Sample in your Process Server on z/OS............................................................4IBM Integration Designer (IID)...................................................................................................9Other screen shots.....................................................................................................................9Login to the Process Center.....................................................................................................10Login to Business Space (Just like the Portal).........................................................................10

Appendix:.....................................................................................................................................10Cross Copying the Certs between the PC & PS Cells..............................................................10IPLing the zLinux machine.......................................................................................................12Re-Starting the Process Center...............................................................................................12Login to the PC ISC.................................................................................................................13Re-Starting the PC Cluster member.........................................................................................13

Using the Process Center� Here's a simple picture of how the Process Center and Process Designer communicate using

HTTP:

� Login to the Process Center http://9.82.34.232:9080/ProcessCenter using the pcadmin UserID.

11/21/13 Unit 7 UsingProcessCenterV8_Lab 1 of 13

Install the Process Designer

� A “Getting Started” panel displays:

� Click on the “Download” button for the Process Designer.

� Find the downloaded file with the name IBM Process Designer.zip and extract it to a folder,such as C:\wpswork\PD\.

� With PD V8.0.1, it appears that you first must install IM, then launch IM to install the PD...

� Go to the extracted folder and double-click on the installProcessDesigner_admin.bat

file. This will install Process Designer to default folder C:\IBM\ProcessDesigner\v8.0.

Configure Process Designer

In the PD install directory (C:\IBM\ProcessDesigner\v8.0) there is a file eclipse.ini

Verify or change the following line to point to your ProcessCenter ip address... the port should bedefaulted to 9080 as follows:

-Dcom.ibm.bpm.processcenter.url=http://192.168.17.232:9094

Also verify or add the following to your hosts file in C:\WINDOWS\system32\drivers\etc\hosts

192.168.17.232 wpspctr.wsclab.washington.ibm.com wpspctr

Test the Hiring Sample in the Process Center using the ProcessDesigner

� Navigate to the install destination folder C:\IBM\ProcessDesigner\v8.0 and double-clickeclipse.exe to start the Process Designer.

� … or go to Start Programs > IBM > IBM Process Designer > IBM Process Designer 8.0

� If you have problems connecting/starting IBM Process Designer, check for any log/trace files inC:\IBM\ProcessDesigner\v8.0\workspace\.metadata\.log.

� Login as pcadmin

� Give "Read" access to the "pcadmin" UserID for the Advanced Hiring Sample processapplication:

11/21/13 Unit 7 UsingProcessCenterV8_Lab 2 of 13

1. Select the Process Apps tab.

2. Select the process application for which you want to manage user access.

3. Select the Manage option.

4. Under Manage Access to Process Library, click Add Users/Groups.

5. In the Add Users and Groups window, enter the name of the user or group that youwant to add in the Search for Name field.

6. Select the check box next to the users and groups that you want to add, and thenclick Add Selected.

7. After you add the users and groups that you want, select the Read, Write, or Adminoption for each.

� Click the “ProcessApps” tab, select the Advanced Hiring Sample and click on “Open inDesigner”: (MODIFY THESE SCREEN SHOTS TO SHOW THE ADVANCED Hiring Sample.)

� Click on the Business Process Diagrams: “Standard HR Open New Position”:

� Click on the Run button:

11/21/13 Unit 7 UsingProcessCenterV8_Lab 3 of 13

� Highlight the “New” line under Status in the upper-right part of the screen and then click on theRun button:

� A browser should pop up with this screen:

� Click “Next”, “Next”, and “Submit” and the browser should close.

� Back in the Process Designer, click the Refresh button:

� … and the Status should change to “Closed”:

11/21/13 Unit 7 UsingProcessCenterV8_Lab 4 of 13

Congratulations! You have successfully run the Advanced Hiring Sampleapplication in the Process Center!

Test the Hiring Sample in your Process Server on z/OS

� Login to the Process Designer if not still logged in.

� Open the “Servers” tab and see if your Server PSENV(B#SR01) (192.168.17.20#) is connected:

� Click on the “Process Apps” Tab, and then select the Hiring Sample and double-click on it:

11/21/13 Unit 7 UsingProcessCenterV8_Lab 5 of 13

� Click on “+ Create New Snapshot”:

� Give the Snapshot a name such as “Team# Wed10AM” and click on “Create”

� Click on “Install” then click on your server:

� Click on “OK”, then click on “Install”

� Click the “ProcessApps” tab, select the Hiring Sample and click on “Open in Designer”:

� Go to the Inspector view, select your server:

� You should see it connect:

11/21/13 Unit 7 UsingProcessCenterV8_Lab 6 of 13

� If you get this pop-up, you may need to set the password for “tw_author” to “tw_author” on yourProcess Server's ISC:

�

� In the ISC for your server, go to Users & Groups > Manage Users then Search for users withthis pattern: “tw*”

• Click on “tw_author” and fill in the password (“tw_author”) twice and click “OK”.

� In the ISC, go to Global Security > Java Authentication and Authorization Service > J2Cauthentication data >

• Click on “BPMAuthor_Auth_Alias” and specify the password (“tw_author “)

� (Recycle your server on z/OS.)

� What's this?

� If Successful, you' ll see this:

� Click on the Business Process Diagrams: “Standard HR Open New Position”:

11/21/13 Unit 7 UsingProcessCenterV8_Lab 7 of 13

� Click on the Run button:

� Highlight the “New” line under Status in the upper-right part of the screen and then click onthe Run button:

� A browser should pop up with this screen:

� Click “Next”, “Next”, and “Submit” and the browser should close.

� Back in the Process Designer, click the Refresh button:

� … and the Status should change to “Closed”:

11/21/13 Unit 7 UsingProcessCenterV8_Lab 8 of 13

Congratulations! You have successfully run the Hiring Sample application on yourz/OS Process Server!

IBM Integration Designer (IID)

(To be completed.)

Other screen shots

� In your web browser, go to Process Administrator: http://wg31:7547/ProcessAdmin and signon with the b#admin user ID.

� Click on “IBM BPM Admin” then on “Task Cleanup” ???????

11/21/13 Unit 7 UsingProcessCenterV8_Lab 9 of 13

Login to the Process Center

� In your web browser, log in to the Process Center on 192.168.17.232

http://wpspctr.wsclab.washington.ibm.com:9080/ProcessCenter and sign on with the“tw_admin” user ID.

� Click on the “Servers” tab, and you should see the B#SR01 servers in the list:

Login to Business Space (Just like the Portal)

� In your browser, login to http://wg31:7547/BusinessSpace

� you will be re-directed to http://wg31:7547/mum/enabler#pid%3DUSER_NAVTREE_ROOT_OID000000000000000%26

Appendix:

Cross Copying the Certs between the PC & PS CellsHere are instructions for cross copying the certs between the B# and PC cells.

� On z/OS Process Server, export the B# CA cert.RACDCERT EXPORT(LABEL('WebSphereCA.B#CELL')) CERTAUTH DSN('USER1.B#CA.DER') FORMAT(CERTDER)

� FTP 'USER1.B#CA.DER' it in binary to a location in the PC cell file system that the DMgr canaccess.

cd /opt/IBM/WebSphere/AppServer

ftp 192.168.17.21#

Connected to 192.168.17.216.

220-FTPSERVE IBM FTP CS V1R13 at WG31.WASHINGTON.IBM.COM, 13:34:14 on

2013-03-21.

220 Connection will close if idle for more than 200 minutes.

Name (192.168.17.216:root): user1

331 Send password please.

Password:

230 USER1 is logged on. Working directory is "USER1.".

Remote system type is MVS.

ftp> bin

200 Representation type is Image

11/21/13 Unit 7 UsingProcessCenterV8_Lab 10 of 13

ftp> get B#CA.DER b#ca.der

local: b6ca.der remote: B#CA.DER

229 Entering Extended Passive Mode (|||63119|)

125 Sending data set USER1.B#CA.DER

250 Transfer completed successfully.

892 bytes received in 00:00 (893.42 KB/s)

ftp> quit

221 Quit command received. Goodbye.

� Logon to the PC cell admin console: http://9.82.31.232:9060/ibm/console as pcadmin

� Security > SSL certificate and key management > Key stores andcertificates > CellDefaultTrustStore > Signer certificates > Add

For Alias: b# ca For File name: the path name of the file you ftp'ed to the PC cell in the step above For Data type: select Binary DER data Click OK save and sync

� Security > SSL certificate and key management > Key stores andcertificates > NodeDefaultTrustStore > Signer certificates > Add

For Alias: b# ca For File name: the path name of the file you ftp'ed to the PC cell in the step above For Data type: select Binary DER data Click OK save and sync

� Security > SSL certificate and key management > Key stores and certificates >NodeDefaultTrustStore > Signer certificates

Check the box next to default and click ExtractFor File name: default.der a new file in the PC file system For Data type: select Binary DER data

� Security > SSL certificate and key management > Key stores and certificates >NodeDefaultTrustStore > Signer certificates

Check the box next to root and click ExtractFor File name: root.der a new file in the PC file system For Data type: select Binary DER data

� Pre-allocate datasets 'USER1.DEFAULT.DER' and 'USER1.ROOT.DER'

Use these DCBs:Organization . . . : PS

Record format . . . : VB

Record length . . . : 84

Block size . . . . : 27998

1st extent tracks . : 5

Secondary tracks . : 1

� FTP default.der and root.der to datasets 'USER1.DEFAULT.DER' and 'USER1.ROOT.DER'

cd /opt/IBM/WebSphere/AppServer

# ftp 192.168.17.216

Connected to 192.168.17.216.

220-FTPSERVE IBM FTP CS V1R13 at WG31.WASHINGTON.IBM.COM, 14:03:52 on 2013-03-21.

220 Connection will close if idle for more than 200 minutes.

Name (192.168.17.216:root): user1

331 Send password please.

Password:

230 USER1 is logged on. Working directory is "USER1.".

11/21/13 Unit 7 UsingProcessCenterV8_Lab 11 of 13

Remote system type is MVS.

ftp> bin

200 Representation type is Image

ftp> put default.der

local: default.der remote: default.der

229 Entering Extended Passive Mode (|||49453|)

125 Storing data set USER1.DEFAULT.DER

100% |******************| 982 15.60 MB/s 00:00 ETA

250 Transfer completed successfully.

982 bytes sent in 00:00 (288.06 KB/s)

ftp> put root.der

local: root.der remote: root.der

229 Entering Extended Passive Mode (|||49458|)

125 Storing data set USER1.ROOT.DER

100% |******************| 993 20.14 MB/s 00:00 ETA

250 Transfer completed successfully.

993 bytes sent in 00:00 (108.94 KB/s)

ftp> quit

� On z/OS, add the default and root CA certs.RACDCERT ADD('USER1.DEFAULT.DER') CERTAUTH TRUST WITHLABEL('pc.default')

RACDCERT ADD('USER1.ROOT.DER') CERTAUTH TRUST WITHLABEL('pc.root')

Got this message: The new profile for DIGTCERT will not be in effect until a SETROPTS REFRESH has been issued. The certificate that you are adding is self-signed. The certificate is added with TRUST status.

� On z/OS, connect them to the B# keyrings.RACDCERT CONNECT(CERTAUTH LABEL('pc.default') RING(WASKeyring.B#CELL)) ID(B#ACRU)

RACDCERT CONNECT(CERTAUTH LABEL('pc.default') RING(WASKeyring.B#CELL)) ID(B#ASRU)

RACDCERT CONNECT(CERTAUTH LABEL('pc.root') RING(WASKeyring.B#CELL)) ID(B#ACRU)

RACDCERT CONNECT(CERTAUTH LABEL('pc.root') RING(WASKeyring.B#CELL)) ID(B#ASRU)

SETROPTS RACLIST(DIGTCERT) REFRESH

� Then recycle cells and test.

IPLing the zLinux machine

� 1) Start PCOMM session to 9.82.24.186 (The VM WebGen machine.)� 2) Logon to "wpspctr" with password "pr0cess"� 3) Reply "y" to the prompt about IPLing Linux� 4) When you get to the login: prompt hit "PA1" and enter #CP DISC HOLD

Re-Starting the Process Center

� We had to increase the ulimit - it is currently 1024, setting it to 9000.

� Go to the :/opt/IBM/WebSphere/AppServer/profiles/PCDmgr01/bin directory and issue thiscommand: startManager.sh

� Alternatively, you can telnet into the zLinux host as 'root' and use these shell script in the root'sdirectory:

start.sh

/opt/IBM/WebSphere/AppServer/profiles/dmgr/bin/startManager.sh

/opt/IBM/WebSphere/AppServer/profiles/pcnodea/bin/startNode.sh

/opt/IBM/WebSphere/AppServer/profiles/pcnodea/bin/startServer.sh pcsr01a

stop.sh

/opt/IBM/WebSphere/AppServer/profiles/pcnodea/bin/stopServer.sh pcsr01a -username

pcadmin -password pcadmin

/opt/IBM/WebSphere/AppServer/profiles/pcnodea/bin/stopNode.sh -username pcadmin

-password pcadmin

/opt/IBM/WebSphere/AppServer/profiles/dmgr/bin/stopManager.sh -username pcadmin

-password pcadmin

11/21/13 Unit 7 UsingProcessCenterV8_Lab 12 of 13

� To run them, type this:~/start.sh or ~/stop.sh

� As the Dmgr is coming up, look for errors in :/opt/IBM/WebSphere/AppServer/profiles/PCDmgr01/logs/dmgr/SystemOut.log

[11/8/11 11:36:23:039 EST] 00000000 WSDL11ToAxisS E

org.apache.axis2.description.WSDL11ToAxisServiceBuilder populateService

org.apache.ws.commons.schema.XmlSchemaException:

/opt/IBM/WebSphere/AppServer/profiles/PCDmgr01/WEB-

INF/classes/wsdl/J2EEManagedObject.xsd

(Too many open files)

Login to the PC ISC

� Use your browser to go to http://9.82.31.232:9060/ibm/console and login pcadmin

� If this fails, examine the following log:

/opt/IBM/WebSphere/AppServer/profiles/dmgr/logs/dmgr/SystemOut.log

Re-Starting the PC Cluster member

� In the Process Center ISC, navigate to Servers -> Clusters. and start the cluster.

� Alternatively, go to the :/opt/IBM/WebSphere/AppServer/profiles/pcnodea/bin directory andissue this command: startServer.sh

� Look in the logs at/opt/IBM/WebSphere/BPM/profiles/PCEMPTYA/logs/pcsr01a/SystemOut.log

11/21/13 Unit 7 UsingProcessCenterV8_Lab 13 of 13