unit 3 - network deployment process server …© 2012, 2013 ibm corporation ibm business process...

© 2012, 2013 IBM Corporation

IBM Business Process Management V 8.5 - Draft

1

Unit 3 - Network Deployment Process Server ConfigurationIBM Business Process Manager for z/OS V8.5

'Advanced-Only'

John Hutchinson, IBM Advanced Technical Support

[email protected]

To retrieve the latest copy of this slide set, go to the following url:

http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/PRS5204

Updated Nov. 28, 2013

What you Will build

B#CellDB

47 DB2Tables

B#SR01DB

368 DB2

Tables

DMgr

Cluster (DE) SR01 AdvOnly

Server SR01A

B#Cell

B#DMnode

B#nodeA



2

IBM Process Server Components

� Cluster (1)

� Database (8+ data sources) – Common WPS & ESB – Business Process Container – Business Space– Process Server **– Data Warehouse **– Messaging Engine

� SI Buses & ME (1)– BPM ME

� IBM BPM Applications (21+)

– Business Flow Manager, Human Task Manager, BPE Container, ...

– BPC Explorer & Observer, Business Rules Manager

– Business Space, IBM BPM Teamworks **

– Process Portal, Process Admin, Performance Data Warehouse **

– Hiring Sample, WPS Echo, WPS Human Task

** Advanced – Not “AdvancedOnly” configurations

One WebSphere z/OS Server

Controller Region

Servant Regions

Adjunct Region

Messaging Engines

Em

be

dd

ed

HT

TP

Se

rve

rM

es

sa

gin

g

zWLM

HTTP

SIB

Web container EJB container

Servlets JSPs EJBs

Web Services Engine

WebSphere PlatformMessaging dispatch

Data replication

Name server

Dynamic cache

Security

Business Process Container

Human Task Container

Messaging Engines

Messaging EnginesMessaging

Engines

Servant Regions


Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security



Servant Regions


Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security



Servant Regions (JVM each)


Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security



SC

A.A

PP

LIC

AT

ION

Bu

s

One WebSphere z/OS Server

Controller Region

Servant Regions

Adjunct Region

Messaging Engines

Em

be

dd

ed

HT

TP

Se

rve

rM

es

sa

gin

g

zWLM

HTTP

SIB


Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security




Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security



Messaging Engines

Messaging EnginesMessaging

Engines

Servant Regions


Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security




Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security



Servant Regions


Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security




Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security



Servant Regions (JVM each)


Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security




Servlets JSPs EJBs

Web Services Engine


Data replication

Name server

Dynamic cache

Security



SC

A.A

PP

LIC

AT

ION

Bu

s

SC

A.A

PP

LIC

AT

ION

Bu

s

Adjunct Region

BPM Messaging Engine



3

Installing a BPM V8.5 Product Suite – The Pieces?

● z/OS Version 1.12 or later● WebSphere Application Server for z/OS Version 8.5.0.2 or later● IBM Business Process Manager Advanced for z/OS V8.5. ● zPMT (WebSphere Customization Toolbox) V8.5

– Requires Installation Manager (IM) V1.6.2 – See link below● DB2 for z/OS Version 9.1 or later

● IBM Integration Designer (IID) 8.5 ● IBM Process Designer (PD) 8.5 ● IBM Process Center (PC) 8.5

Obtain Installation Manager from http://www.ibm.com/support/docview.wss?uid=swg24032641

Software Prerequisites: http://www.ibm.com/software/integration/wps/sysreqs



4

Configuration Outline - Similar for both AdvancedOnly & Advanced

1. Planning & Prep: use the Spreadsheet to create response files

– Use Installation Manager to lay down the WAS, WCT & BPM code.

2. Use WCT/zPMT to create Configuration Jobs

3. Configure Security Profiles (TSO)

4. Create & Augment Deployment Manager (TSO)

5. Create Database & DB2 Tables (USS Telnet)

6. Create, Augment & Federate Empty Node (TSO)

7. Create Cluster w/ Deployment Environment (TSO)

8. Bootstrap ProcessServer Database (TSO - only for Advanced)

9. Validate Configuration & Run Sample Jobs (Browser: ISC, BPE)

(There’s a reason for this order.

e.g., can't do #5 before #4 or after #6...)



5

1. Planning cannot be over-emphasized� Configuration topologies

– # of Clusters, # of cluster members (Systems)

� Hardware requirements

– CPUs, Memory, (64 bit JVM)

– Disk storage (14,000 cyl = 1.4 x 3390-9)

- 1500 cyl. per Node zFS/HFS (+back-up)

- 2562 - 5768 cyl. for DB2 Tablespaces

� Names for

– Cells, Nodes, Servers, Clusters,

– User & Group IDs, etc.

– z/OS Dataset Aliases, & Space allocations

� UNIX file systems (use zFS)

– Directories & files (ownerships & permissions)

� DB2 components & Names for . . .

– Databases, Storage groups, Schemas, BPs, ..

� Security Identities,

– User Ids, GroupIDs, Auth. Aliases

– EJBROLEs

– Use Federated Repository w/RACF Bridge

(Automated beginning with the Spreadsheet.)

(We will make these decisions for you, but when you get home...)

LPAR A LPAR B

Cluster

Mobile

DMGR

CFShared Data

OSA OSA OSA OSA

Appl Appl

RRS - Res. Recovery Svcs. RRS - Res. Recovery Svcs.

SAF, WLM, IRD, JES, etc. SAF, WLM, IRD, JES, etc.

CICS IMS MQ DB2 CICS IMS MQ DB2

WOLA

LPAR A LPAR B

Cluster

Mobile

DMGR

CFShared Data

OSA OSAOSAOSA OSAOSA OSA OSAOSAOSA OSAOSA

ApplAppl ApplAppl

RRS - Res. Recovery Svcs.RRS - Res. Recovery Svcs. RRS - Res. Recovery Svcs.RRS - Res. Recovery Svcs.

SAF, WLM, IRD, JES, etc.SAF, WLM, IRD, JES, etc. SAF, WLM, IRD, JES, etc.SAF, WLM, IRD, JES, etc.

CICS IMS MQ DB2 CICS IMS MQ DB2CICS IMS MQ DB2CICSCICS IMSIMS MQMQ DB2DB2 CICS IMS MQ DB2CICSCICS IMSIMS MQMQ DB2DB2

WOLA



6

BPZCNFGD

BPMConfig.sh

BPZCNFGD

BPMConfig.sh

Building BPM Runtime – It all starts with the spreadsheet

1. Create WAS DMgr, Node2. Configure BPM3. Create DB Objects4. Create Cluster & Member

PDSTargetJobs

PDSTargetJobs

DB2TablesDB2

Tables

WASConfig

xml

WASConfig

xml

ResponseFiles

ResponseFiles

SpreadsheetSpreadsheet

createDatabase.shcreateDatabase.sh

zPMTzPMT

SQL tabledefinitionsSQL tabledefinitions

BPMproperty File

BPMproperty File

11 22

3344

11

DBADBA

WSAdmin



7

Process Server Configuration Spreadsheet (get it from Techdoc WP102261)

Each team has a unique IP host Addr which will use as its host name to identify it to the Process Center:

Note: Each team will have a unique Cell Prefix: B1, B2, B3, …



8

Spreadsheet Creates 4 Documents:

Dmgr .rsp file for DManager in zPMT:

Schema defs .sql fileFor DBA

(copy to MVSWorking PDS)

Empty Node .rsp File forEmpty Node in zPMT

Click on Tabs, and Buttons to save the Response files

BPMConfig properties file

(copied to DMgrtarget PDS)Save these files in the

C:\wpswork\ Directory



9

2. Create Configuration Jobs for Deployment Manager & Empty Node� Stack Environment including Dmgr, Empty Node for BPM V8.5

– Create BPM V8.5 DMGR

- Import Spreadsheet Response file (DMGR.rsp)- Review Panels & “Process” to Generate & FTP Jobs

– Create BPM V8.5 Custom Node

- Import Spreadsheet Response file (Empty Nodes)

- Review Panels & “Process” to Generate and FTP Jobs



10

3. Setting up Security Profiles

● The standard BBO*BRAK jobs do not include the following:

● -- Administrator's userID password not set

● -- STARTED profiles for servers (because created Empty Nodes)

● The DORAC800 exec from Techdoc WP101427 does both, plus the profiles done by the standard BBOSBRAK, BBODBRAK & BBOMBRAK jobs.

● – Don't run the BBO%BRA% jobs, except for BBODBRAM to create Home directories.

● We provide the following jobs in USER1.WAS.CNTL for WAS:

– B#RAC800 – Define the UserIDs & Profiles for the WAS cell.

– B#RACUID - Define RACF User IDs & Groups for BPM

– B#EJBROL – Define EJBROLE profiles for BPM



11

4. Create / Configure DMGR

�Run Configuration Jobs created by the PMT:

– BBOSBRAK – Define RACF Users & Groups

- (You already ran the B#RAC800 job in USER1.WAS.CNTL)

– BBOSBRAM – Create Home Directories

– BBODBRAK – Create RACF Profiles & Permissions (Replaced with B#RAC800)

– BBODCFS – Create zFS

– BBODHFSA – Populate zFS

– BBOWWPFD – Create Profiles

– BBODPROC – Copy Proclib members

– BPZAUGD – Augment profiles with BPM: ProcessServer

– BPZCNFGD – Generate DB Scripts & run DE Wizard to create Cluster (but no cluster members)

Next: Configure the Cell-scoped Database tables.



12

5. Create DB2 Database Tables

� Create DB2 StoGroup & databases & GRANTs

– Use the b0cell.sql file from the Spreadsheet

� Create Cell-scoped Database Tables (before starting Dmgr)

cd <Profile_Root>/dbscripts/<Cell_Name>DB

createDatabase.sh -DBAlias DSNX -RunSQL

� Create Cluster-scoped database tables (before starting bootstrapProcessSvr)

cd <Profile_Root>/dbscripts/<Cluster_Name>DB

– createDatabase.sh -DBAlias DSNX -RunSQL

---------------------------------------------

Option to run these as Batch Jobs:

BPXBATCH SH +

. /u/user1/db2setup.sh; +

cd /wasv85config/b0cell/b0dmnode/DeploymentManager/profiles/default; +

cd dbscripts/B0SR01/DB2zOS/B0SR01DB; +

./createDatabase.sh -DBAlias DBP2 -RunSQL



13

6. Create Empty (Custom) Node

� Run Custom Node Configuration Jobs

– BBOSBRAK & BBOMBRAK (Replaced with B#RAC800)

– BBOSBRAM – Redundant with same job run for the Dmgr

– BBOMCFS – Create zFS

– BBOMHFSA – Populate zFS

– BBOWWPFM – Create Profiles

– BBOMPROC – Copy Procs

– BPZAUGN – Augment with BPM: PS

< Start DMgr >

– BBOWMNAN – Federate Empty Node (Change JOB card to use Administrator’s UserID)

Next: Create a Cluster with the BPZCNFGD job (BPMConfig.sh + BMP properties file.)



14

7. Create Deployment Environment Cluster Members

� The DE Wizard in the ISC is still available, but the recommended method is this new Job provided with BPM V.8.5 for z/OS:

� BPZCNFGD – Runs the BPMConfig.sh script

– You ran it after the DMgr Augment job (BPZAUGD) to create the D.E. (Cluster) and generate the database scripts

– Run it again after Empty Node is Federated to create the Cluster Member

� Note

– WpsUpdate.sh (used in BPM 8.0) no longer needed nor available.



15

8. Update Deployment Environment

Update other WAS environmental variables

TZ = EST5EDT

ras_time_local = 1

ras_default_msg_dd = DEFALTDD

ras_hardcopy_msg_dd = HRDCPYDD

We provided you with a batch job in USER1.WAS.CNTL(B#ADDVAR).

Full Node Re-synchronization is required

(re-cycle DMgr & Node Agent)



16

BPM V 8.5 – Differences from V. 8.0

For BPM Advanced:

– BPZCNFGD job added for the Dmgr and Empty Node

- Runs BPMConfig.sh which creates the Cluster & Cluster Member

- Replaces the DE Wizard

- DE Wizard is still available, but replaced with the BPZCNFGD job

– NO CEI or CBE

– Only 1 SI Bus Messaging Engine – BPM ME

– No dbDesign file – no DbDesignGenerator,sh script

– createDatabase.sh replaces createDB2.sh (same syntax)

– WpsUpdate.sh no longer needed nor available.

For BPM Advanced-Only (in addition to above changes):

� No Process Center, Process Designer

� No Performance Warehouse database tables

� No BootstrapProcessServerData.sh script



17

9. Installation Verification� Does the Server start, and are all SI Buses active? (See Server Logs.)

� AdminConsole (ISC) – Validate the Applications, SI Buses & Messaging Engines & JDBC Resource Data sources

� Install the WPSHumanTask.ear, Start it and Test it using the url: http://wg31:7547/WPSHumanTaskWeb

� Go to the BPC explorer worklist: http://wg31:7547/bpc

� Select “My To-dos”, then select the work item, and click on “Work on”.



18

Enough Talk – Let's do the lab...