Front cover

Draft Document for Review June 3, 2008 1:55 pm SG24-7643-00

Getting Started with WebSphere

Process Server and WebSphere
Enterprise Service Bus
Part 3: Runtime
Install WebSphere Process Server

Build topologies based on

patterns

Prepare for deployment

Carla Sadtler
Srinivasa R Borusu
Sergiy Fastovets
Thalia Hooker
Ernese Norelus
Fabio Paone
Dong Yu

ibm.com/redbooks
Draft Document for Review June 3, 2008 1:55 pm 7643edno.fm

International Technical Support Organization

Getting Started with WebSphere Process Server

and WebSphere ESB Part 3: Runtime

June 2008

SG24-7643-00
7643edno.fm Draft Document for Review June 3, 2008 1:55 pm

Note: Before using this information and the product it supports, read the information in
“Notices” on page vii.

First Edition (June 2008)

This edition applies to WebSphere Process Server V6.1 and WebSphere Enterprise Service Bus
V6.1.

This document created or updated on June 3, 2008.

© Copyright International Business Machines Corporation 2008. All rights reserved.

Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP
Schedule Contract with IBM Corp.
Draft Document for Review June 3, 2008 1:55 pm 7643TOC.fm

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
The team that wrote this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Become a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Chapter 1. Planning for installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.1 WebSphere Application Server concepts . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.1 Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1.2 Application server environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.3 WebSphere Application Server for z/OS . . . . . . . . . . . . . . . . . . . . . . . 7
1.2 Selecting a topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.1 Stand-alone server topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.2 Deployment environment patterns . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2.3 Single cluster pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.2.4 Remote messaging pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2.5 Remote messaging and remote support pattern . . . . . . . . . . . . . . . . 14
1.2.6 Web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.3 Planning for installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.3.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.3.2 User ID authorities for installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.3.3 Installation methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
1.3.4 Installation type (distributed and i5/OS) . . . . . . . . . . . . . . . . . . . . . . 21
1.3.5 Selecting additional features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
1.3.6 Root directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
1.3.7 Creating profiles during installation . . . . . . . . . . . . . . . . . . . . . . . . . . 23
1.3.8 Installing recommended maintenance . . . . . . . . . . . . . . . . . . . . . . . 23
1.4 Planning for profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
1.4.1 Planning for databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
1.4.2 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
1.4.3 Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.5 Planning for the Profile Management Tool . . . . . . . . . . . . . . . . . . . . . . . . 33
1.5.1 Profile environment and type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

© Copyright IBM Corp. 2008. All rights reserved. iii

7643TOC.fm Draft Document for Review June 3, 2008 1:55 pm

Chapter 2. Installation on distributed and i5/OS systems . . . . . . . . . . . . . 37

2.1 Installation overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
2.2 Typical installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
2.3 Installation on i5/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.3.1 Installing remotely from a Windows workstation . . . . . . . . . . . . . . . . 43
2.3.2 Installing WebSphere Process Server on i5/OS silently . . . . . . . . . . 47
2.4 Install the IBM Update Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
2.5 Download and install maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Chapter 3. Creating profiles on distributed and i5/OS systems . . . . . . . . 51

3.1 Methods used to build the profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.1.1 Profile Management Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.1.2 The manageprofiles command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
3.2 Standalone WebSphere Process Server. . . . . . . . . . . . . . . . . . . . . . . . . . 56
3.3 Building a deployment environment using a pattern . . . . . . . . . . . . . . . . . 66
3.3.1 Summary of steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
3.3.2 Build the Web server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
3.3.3 Building the deployment manager. . . . . . . . . . . . . . . . . . . . . . . . . . . 71
3.3.4 Building Node1 and the first process server of the cluster . . . . . . . . 75
3.3.5 Building Node2 and the second process server of the cluster . . . . . 79
3.3.6 Creating the cluster for mediation modules. . . . . . . . . . . . . . . . . . . . 81
3.3.7 Define the Web server to the cell . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
3.4 Augmenting a WebSphere ESB profile to WebSphere Process Server . . 90

Chapter 4. Creating and managing profiles on z/OS . . . . . . . . . . . . . . . . . 93

4.1 Methods of creating profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
4.2 Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
4.3 Creating a deployment manager node . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
4.4 Creating a custom node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
4.5 Configuring the deployment manager node . . . . . . . . . . . . . . . . . . . . . . 127
4.5.1 Run the zSMPInstall.sh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.5.2 Preparing DmgrDB2.rsp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.5.3 Run the zWPSConfig.sh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
4.5.4 Creating DB2 database objects using the createDB.sh script . . . . 131
4.5.5 Back up the WebSphere configuration HFS datasets . . . . . . . . . . . 133
4.6 Configuring a custom node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.6.1 Running the zSMPInstall script . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.6.2 Preparing ManagedDB2.rsp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.6.3 Running zWPSConfig.sh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4.6.4 Federating a custom node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4.6.5 Configure and federate secondary custom node . . . . . . . . . . . . . . 139
4.6.6 Back up the WebSphere configuration HFS datasets . . . . . . . . . . . 139

iv Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643TOC.fm

4.7 Creating a WebSphere Process Server cluster. . . . . . . . . . . . . . . . . . . . 139

4.7.1 Add DB2 libraries to the Servant and Adjunct JCL . . . . . . . . . . . . . 140
4.7.2 creating a cluster/server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
4.7.3 Configure Service Component Architecture . . . . . . . . . . . . . . . . . . 145
4.7.4 Configure Common Event Infrastructure. . . . . . . . . . . . . . . . . . . . . 149
4.7.5 Configuring the Business Flow and Human Task Managers . . . . . 152

Chapter 5. Managing the runtime environment . . . . . . . . . . . . . . . . . . . . 157

5.1 Administrative tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
5.1.1 Using commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
5.1.2 Using the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . 161
5.1.3 Using IBM Web Administration for i5/OS . . . . . . . . . . . . . . . . . . . . 164
5.1.4 WebSphere scripting client (wsadmin) . . . . . . . . . . . . . . . . . . . . . . 168
5.2 Managing stand-alone server environments . . . . . . . . . . . . . . . . . . . . . . 169
5.2.1 Managing application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
5.3 Managing distributed environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
5.3.1 Managing the deployment manager . . . . . . . . . . . . . . . . . . . . . . . . 171
5.3.2 Managing nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
5.3.3 Managing servers and clusters from the administrative console . . 175
5.4 Managing the Web server plug-in configuration . . . . . . . . . . . . . . . . . . . 177
5.4.1 Generating the plug-in with administrative console. . . . . . . . . . . . . 177
5.4.2 Enabling automated plug-in regeneration . . . . . . . . . . . . . . . . . . . . 178
5.4.3 Propagating the plug-in configuration file . . . . . . . . . . . . . . . . . . . . 178
5.4.4 Activating the new plug-in configuration . . . . . . . . . . . . . . . . . . . . . 179
5.4.5 Enable automated plug-in propagation . . . . . . . . . . . . . . . . . . . . . . 180
5.5 Viewing the JVM logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

Chapter 6. Managing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

6.1 Scenario: Order Management System . . . . . . . . . . . . . . . . . . . . . . . . . . 184
6.2 Planning for deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
6.2.1 Setting up the prerequisites for Order Management System . . . . . 189
6.3 Defining application resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
6.3.1 Setting the resource scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
6.3.2 Defining security credentials to access a resource . . . . . . . . . . . . . 192
6.3.3 Defining JDBC resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
6.3.4 Defining users and groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
6.3.5 JMS resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
6.4 Deploying applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
6.4.1 Exporting applications for deployment . . . . . . . . . . . . . . . . . . . . . . 209
6.4.2 Installing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
6.4.3 Configure and test Web service URLs . . . . . . . . . . . . . . . . . . . . . . 212
6.4.4 Updating endpoint URLs in Web service bindings . . . . . . . . . . . . . 214
6.4.5 Example: installing the Order Management System applications . . 215

Contents v
7643TOC.fm Draft Document for Review June 3, 2008 1:55 pm

6.5 Generate the Web server plug-in configuration. . . . . . . . . . . . . . . . . . . . 220

6.6 Testing the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.6.1 Starting and preparing your test clients. . . . . . . . . . . . . . . . . . . . . . 221
6.6.2 Testing the mediation modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.6.3 Test the business integration modules . . . . . . . . . . . . . . . . . . . . . . 225

Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
How to get Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

vi Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643spec.fm

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult
your local IBM representative for information on the products and services currently available in your area.
Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product, program, or service that
does not infringe any IBM intellectual property right may be used instead. However, it is the user's
responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document.
The furnishing of this document does not give you any license to these patents. You can send license
inquiries, in writing, to:
IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785 U.S.A.

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 "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 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.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any
manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the
materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.

Information concerning non-IBM products was obtained from the suppliers of those products, their published
announcements or other publicly available sources. IBM has not tested those products and cannot confirm
the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on
the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them
as completely as possible, the examples include the names of individuals, companies, brands, and products.
All of these names are fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating platform for which the
sample programs are written. These examples have not been thoroughly tested under all conditions. IBM,
therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.

© Copyright IBM Corp. 2008. All rights reserved. vii

7643spec.fm Draft Document for Review June 3, 2008 1:55 pm

Trademarks
The following terms are trademarks of the International Business Machines Corporation in the United States,
other countries, or both:

Redbooks (logo) ® Informix® Redbooks®

iSeries® IBM® RACF®
i5/OS® MVS™ System z™
z/OS® OS/390® WebSphere®
DB2® Rational®

The following terms are trademarks of other companies:

Oracle, JD Edwards, PeopleSoft, Siebel, and TopLink are registered trademarks of Oracle Corporation
and/or its affiliates.

EJB, Java, JDBC, JMX, JVM, J2EE, and all Java-based trademarks are trademarks of Sun Microsystems,
Inc. in the United States, other countries, or both.

Microsoft, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States,
other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

viii Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643pref.fm

Preface

This book provides new users with information on installing and configuring a
WebSphere® Process Server and WebSphere Enterprise Service Bus runtime
environment. It includes installation examples on distributed, i5/OS®, and z/OS®
platforms. It also provides basic configuration information for deploying
applications.

Some knowledge of WebSphere Application Server Network Deployment is

assumed.

This is the third book of a three-part series:

Getting Started with WebSphere Process Server and WebSphere Enterprise

Service Bus:
򐂰 Part 1: Development, SG24-7608
򐂰 Part 2: Scenario, SG24-7642
򐂰 Part 3: Runtime, SG24-7643

The team that wrote this book

This book was produced by a team of specialists from around the world working
at the International Technical Support Organization, Raleigh Center.

Carla Sadtler is a Consulting IT Specialist at the ITSO, Raleigh Center. She

writes extensively about WebSphere and Patterns for e-business areas. Before
joining the ITSO in 1985, Carla worked in the Raleigh branch office as a Program
Support Representative, supporting MVS customers. She holds a degree in
mathematics from the University of North Carolina at Greensboro.

Srinivasa Borusu is a Senior IT Specialist at IBM India

Software Labs, Bangalore. He is currently working as a
WebSphere Consultant with IBM Business Partner Technical
Strategy and Enablement (BPTSE) Developer Services team,
enabling and supporting worldwide business partners on
WebSphere products. Since he joined IBM in 2000, he has
played various roles, including Tech Lead for the IBM Java
Virtual Machine Support, during his tenure at OS/2 worldwide
support center. His technical portfolio also includes one FILE rated patent, 4 IBM

© Copyright IBM Corp. 2008. All rights reserved. ix

7643pref.fm Draft Document for Review June 3, 2008 1:55 pm

SOA and WebSphere product certifications and several published articles. He

holds a masters degree in Computer Applications from the Andhra University,
Visakhapatnam, India.

Sergiy Fastovets joined IBM in 1996 in the Research Triangle

Park. He has ten years experience in design, development, and
sales support in the Host Integration area. In 2006 Sergiy
transferred to the IBM UK where he is an IT Consultant for
WebSphere® Software Services. He holds a degree in
mathematics from the University of Saint Petersburg, Russia.
His native town is Poltava, Ukraine.

Thalia Hooker Ph.D., is a Consulting IT Specialist and

member of the WebSphere Americas iPoC Team. She
executes proof-of-concepts using the WebSphere platform to
show customers how IBM solutions and products can help
them meet their integration requirements. These solutions and
products include Service Oriented Architecture (SOA) and
WebSphere Business Process Management products such as,
WebSphere Process Server and WebSphere Enterprise
Service Bus.

Ernese Norelus is an IBM Certified Consulting IT Specialist

with the ASEAN Software Services team in Singapore. He has
been in IT for ten years, with eight years of experience
presenting, teaching, and proposing solution architectures to
customers using the WebSphere business integration portfolio.
He is also a well-known conference speaker, and he holds
certifications in IM/DB2®, Lotus®, Rational®, Tivoli® and
WebSphere. He holds degrees in Biochemistry and Computer
Science and Information Technology Management from the Université du
Québec à Montréal, (Québec, Canada).

Fabio Paone is WebSphere technical sales supporting the

Channel (Business Partners) in Italy. He has four years
experience as a developer in the Rome Tivoli Lab, primarily in
J2EE development. He is certified as a WebSphere Application
Server Administrator (versions 5, 6, and 6.1), and has
participated in WebSphere Application Server certification test
reviews.

x Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643pref.fm

Dong Yu is a Staff Software Engineer at IBM China

Development Lab. He has four years of experience in the
WebSphere Business Integration Field.His areas of expertise
include WebSphere Process Server installation and
Configuration.Dong holds a master degree in Software
Engineering from Northwestern Polytechnical University.

Thanks to the following people for their contributions to this project:

Rich Conway
International Technical Support Organization, Raleigh Center

Margaret Ticknor
International Technical Support Organization, Raleigh Center

Stephen Cocks
IBM UK

Andrew Mead
IBM UK

Sharuff Morsa
IBM UK

Dean Barker
IBM UK

Become a published author

Join us for a two- to six-week residency program! Help write a book dealing with
specific products or solutions, while getting hands-on experience with
leading-edge technologies. You will have the opportunity to team with IBM
technical professionals, Business Partners, and Clients.

Your efforts will help increase product acceptance and customer satisfaction. As
a bonus, you will develop a network of contacts in IBM development labs, and
increase your productivity and marketability.

Find out more about the residency program, browse the residency index, and
apply online at:
ibm.com/redbooks/residencies.html

Preface xi
7643pref.fm Draft Document for Review June 3, 2008 1:55 pm

Comments welcome
Your comments are important to us!

We want our books to be as helpful as possible. Send us your comments about

this book or other IBM Redbooks® in one of the following ways:
򐂰 Use the online Contact us review Redbooks form found at:
ibm.com/redbooks
򐂰 Send your comments in an e-mail to:
[email protected]
򐂰 Mail your comments to:
IBM Corporation, International Technical Support Organization
Dept. HYTD Mail Station P099
2455 South Road
Poughkeepsie, NY 12601-5400

xii Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

Chapter 1. Planning for installation

This chapter discusses installation planning for WebSphere Process Server
installations. This chapter is intended to provide the you with the concepts and
primary considerations for installation.

Although it is possible to install WebSphere Process Server on a WebSphere

Application Server base, this chapter will assume WebSphere Application Server
Network Deployment as a base product.

This chapter will also provide concepts for WebSphere ESB within the context of
a WebSphere Process Server installation.

© Copyright IBM Corp. 2008. All rights reserved. 1

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

1.1 WebSphere Application Server concepts

WebSphere Process Server and WebSphere ESB are built on top of WebSphere
Application Server technology and inherit its runtime structure and configuration
characteristics. The concepts associated with WebSphere Application Server are
common for all of these products and are important to understand in order to plan
for a WebSphere Process Server or WebSphere ESB environment.

WebSphere Application Server is organized based on the concept of cells,

nodes, and servers. While all of these elements are present in each
configuration, cells and nodes do not play an important role until you take
advantage of the features provided with Network Deployment.

The following concepts are key to understanding topologies based on

WebSphere Application Server.
򐂰 The application server is the primary runtime component in all configurations
and is where an application executes. Application servers have levels of
capability tailored to the applications they will host. These levels are:
– WebSphere Application Server and WebSphere Application Server
Network Deployment - designed to run J2EE applications.
– WebSphere ESB - includes the functionality of WebSphere Application
Server and can host mediation modules.
– WebSphere Process Server - includes the functionality of WebSphere
ESB servers and can host business integration modules.
In a WebSphere Process Server installation, which includes WebSphere
ESB, it is common to create all application servers with the WebSphere
Process Server template.
򐂰 A node is a grouping of application servers for configuration and operational
management on one machine. Nodes are generally associated with a
physical machine. It is possible to have multiple nodes on a single machine
but nodes cannot span machines. A node agent in the node is the contact
point for the deployment manager during cell administration.
As with application servers, nodes also have levels of capability that support
their environment.
򐂰 A cell is a grouping of nodes into a single administrative domain. A cell can
consist of multiple nodes, which are all administered from a single point (the
deployment manager).

2 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

1.1.1 Profiles
Runtime environments are built by creating profiles. Each profile contains files
specific to that runtime such as logs and configuration files. Profiles can be
created during installation and after. After a profile is created, further
configuration to the runtime environment is done using WebSphere
administrative tools that include scripting, commands, and the administrative
console.

Each profile is stored in a unique directory path selected at profile creation time.
The default is for the profiles to be stored in a subdirectory of the installation
directory, but they can be located anywhere. All profiles share the product
binaries.

A profile is created with one of the following levels of function:

򐂰 WebSphere Application Server Network Deployment
򐂰 WebSphere Enterprise Service Bus
򐂰 WebSphere Process Server

Profiles for WebSphere Process Server and WebSphere Enterprise Bus are
actually profiles built for WebSphere Application Server Network Deployment and
augmented with the process server or ESB function.

Profile types
There are three profile types used to define server environments:
򐂰 Stand-alone server: This type of profile creates an application server that is
managed from its own administrative console. It functions independently from
all other servers and deployment managers.
When the tool your are using to create profiles offers the choice of creating a
profile for multiple environments, the stand-alone server option is associated
with a WebSphere Application Server Network Deployment profile. The
profiles augmented for additional function are referred to as:
– Stand-alone process server profile: A stand-alone server profile that
has been augmented for WebSphere Process Server.
– Stand-alone enterprise service bus profile: A stand-alone service bus
profile that has been augmented for WebSphere ESB.
򐂰 Deployment manager: This type of profile creates a deployment manager
that is used to administer nodes that are federated into its cell.
򐂰 Custom: A custom profile contains an empty node. No application server or
deployment manager is defined by this profile. The typical use for a custom
profile is to federate its node to a deployment manager. After federating the

Chapter 1. Planning for installation 3

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

node, use the deployment manager to create a server or a cluster of servers

within the node.

Augmenting profiles
WebSphere Application Server profiles (both base and Network Deployment)
can be augmented to have WebSphere ESB or WebSphere Process Server
function. Likewise, WebSphere ESB profiles can be augmented to have
WebSphere Process Server function. However, the profile to be augmented must
exist on a system with a WebSphere Process Server installation.

On distributed and i5/OS systems, augmentation to stand-alone servers or

unfederated custom nodes can be done using the Profile Management Tool or
the manageprofiles command.

Custom profiles that have been federated to a cell must be augmented manually.
A federated profile must be removed from the deployment manager first, then
augmented. Removing the node from the deployment manager will restore the
node to the configuration saved prior to using addNode command. Data might be
lost. The deployment manager profile must also be federated. Then the custom
profile can be federated back to the cell. The deployment manager must also be
augmented before federating the node back to the cell. For more information,
see:
򐂰 Augmenting existing profiles (distributed and i5/OS platforms)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/tins_aug_profiles.html

For information on augmenting profiles on z/OS systems, see

򐂰 zWPSConfig.sh and zWESBConfig.sh (z/OS platforms)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/rins_zos_configscript.html

1.1.2 Application server environments

There are two basic topology types for WebSphere environments.

Stand-alone application servers

In a stand-alone server environment, each application server acts as a unique
entity. The cell consists of one node and one application server. The
administration is managed through the application server.

Multiple stand-alone application servers can exist on a machine, either through

independent installations of the WebSphere Process Server code or by creating

4 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

multiple application server profiles within one installation. However, WebSphere

Process Server does not provide centralized management or administration for
multiple stand-alone application servers. Stand-alone application servers do not
provide workload management or failover capabilities.

Standalone servers are most often used for test environment and for
non-production applications.

Profiles
A stand-alone server for WebSphere Process Server is created by defining an
stand-alone process server profile. A stand-alone server for WebSphere ESB is
created by defining an stand-alone enterprise service bus profile.

Distributed application servers

A distributed server configuration enables central administration, workload
management, and failover. In this environment, you integrate one or more nodes
into a cell that is managed by a deployment manager. Administration and
management is handled centrally from the deployment manager.

Each node has one or more application servers. The nodes can reside on the
same machine as the deployment manager or on multiple separate machines.
Each node has a node agent that works with the deployment manager to manage
administration processes.

Figure 1-1 on page 6 shows a runtime environment that consists of a single cell,
a deployment manager that manages that cell, and two nodes each with two
application servers.

Chapter 1. Planning for installation 5

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

Server A Cell
Deployment
Manager

Node Node Node Node

Agent Agent

Application Application Application

Application
Server Server Server
Server

Server B Server C

Figure 1-1 Distributed servers

With a distributed server configuration, you can create multiple application

servers to run unique sets of applications and then manage those applications
from a central location. However, more importantly, you can cluster application
servers to allow for workload management and failover capabilities. Applications
that you install in the cluster are replicated across the application servers. When
one server fails, another server in the cluster continues processing. Workload is
distributed among Web and EJB™ containers in a cluster using a weighted
round-robin scheme.

Profiles
A distributed server environment consists of one deployment manager profile
and one or more custom node profiles.

The easiest way to build a new WebSphere Process Server distributed

environment is to use the deployment environment patterns. Each cell can have
multiple deployment environments configured.

A typical process for creating a new non-production WebSphere Process Server

environment would be:
1. Select a topology based on one of the available deployment environments.
2. Install WebSphere Process Server on the deployment manager host,
selecting the deployment environment you want to build and the deployment
manager option. This will build a deployment manager profile and will prepare

6 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

the environment, including creating the databases required for WebSphere

Process Server.
3. Install WebSphere Process Server on additional hosts (nodes), selecting the
deployment environment and the custom profile option. This will create a
custom profile for each node, federate it to the cell, define the application
servers on the node, and add the application servers to the appropriate
cluster.

The result will be fully functional WebSphere Process Server environment,

however, this process gives you limited control over the database configuration.

In a production environment, it is recommended that you create the deployment

manager first, then use the administrative console to create the deployment
environment. This gives you the ability to use multiple databases for the
WebSphere Process Server components.

A typical process for creating a new production WebSphere Process Server

environment would be:
1. Install WebSphere Process Server on the deployment manager host and
create a deployment manager profile.
2. Install WebSphere Process Server and create a custom profile on each node,
allowing the federation to the deployment mangaer to occur during profile
creation.
3. Use the administrative console to create a deployment environment. This
allows you to select the nodes to add to each cluster and provides greater
control over the database configuration options.

Examples of building topologies based on deployment environment patterns can

be found in Chapter 3, “Creating profiles on distributed and i5/OS systems” on
page 51.

1.1.3 WebSphere Application Server for z/OS

While WebSphere Application Server for z/OS has the same basic concepts
previously discussed, it contains a unique process model that enables the
product to manage many z/OS unique services and provides Quality of Service
(QoS). On z/OS, an application server is built using a federation of JVMs, each in
a different process that together represents a single server instance. A server is
composed of address spaces that actually run the code. WebSphere Process
Server is built on this environment and takes advantage of this structure.

Figure 1-2 illustrates how WebSphere processes are structured in a z/OS

environment.

Chapter 1. Planning for installation 7

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

MVS ITSO SYS A MVS ITSO SYS B

Daemon DMGR Daemon

CR CR A CR

Node Agent Node Agent

CR CR

AppServer AppServer

CR SR CR SR

Figure 1-2 One cell, deployment manager, node on same LPAR, node separated

To understand how WebSphere on z/OS is unique from the distributed platforms,

we briefly discuss some of the z/OS-specific concepts.

Address space
An address space is the area of successive virtual addresses that z/OS assigns
to a user (or separately running program) for executing instructions and storing
data. It is equivalent to a process on distributed platforms.

Control region
The control region (CR) is basically the only public interface to this collection of
JVMs that, all together, represent a single application server. All requests go
through the CR and the CR forwards them to one of the potentially many servant
controllers for processing. In short, a CR is like a router or even an address
space that binds the TCP ports used by the server. A CR does have an
embedded JVM™, which is the only JVM allowed to receive connections from
the outside world. Each server has only one CR that is started through a JCL
start procedure.

The requests arrive in the CR process, which then works with the z/OS workload
manager (WLM) to dispatch the work to the servant regions (Figure 1-3).

8 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

J2EE application server

System console
Servant region #1

JCL start Controller JVM

zWLM
procedure region
Application

JCL start
procedure
Servant region #n

JVM

Application

Figure 1-3 Inside the application server

Control region adjunct

The control region adjunct is a specialized servant that interfaces with new
service integration buses to provide messaging services.

Servant region
The servant region (SR) is where the requests are actually processed and is
equivalent to the application server on a distributed environment platform. All the
SRs are identical and have the same J2EE level. The SR depends on the CR for
many services such as communication, security and transaction control.

When multiple SRs are created, a copy of each application is found in each SR
and the CR will forward the requests to the appropriate SR.

zWLM
The z/OS workload manager manages resources to ensure that performance
goals are met. It is a part of z/OS. To differentiate this from the workload
management of WebSphere, we refer to this as zWLM. As the CR receives
incoming requests, it works with zWLM to ensure that these requests are
classified according to organization-defined rules and dispatched appropriately
to servant regions that can handle the load. zWLM can alter factors to ensure
that performance goals are met, for example, by updating importance levels of
services classes and starting additional servant regions.

Chapter 1. Planning for installation 9

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

Daemon
A daemon server provides the location name service for external clients. There is
one daemon per cell per MVS™ image. If your cell consists of multiple MVS
images, a daemon will be created for each MVS image where your cell exists. If
there are two cells on the same MVS image, two daemons will be created. Each
daemon server consists of a single CR.

Daemon servers are started automatically when the first server for the cell on
that MVS image is started. If you kill a daemon, all the servers for that cell on that
MVS image come down.

1.2 Selecting a topology

In order to plan an installation, you need to design the topology you want to build.
Choosing the right topology is important regarding future requirements for high
availability, scalability, and performance. The topology selected will determine the
number of systems you need to install the product on, the profiles you will need
to create, and your path through the installation and profile creation process.

This section will describe common topologies, starting with a simple stand-alone
server topology, and progressing to more complex topologies that have been
identified as common deployment patterns.

Note: For a more in-depth discussion of topologies for WebSphere Process

Server and WebSphere Enterprise Service Bus topologies, see:
򐂰 Production Topologies for WebSphere Process Server and WebSphere
ESB V6, SG24-7413
򐂰 z/OS Getting Started: WebSphere Process Server and WebSphere
Enterprise Service Bus V6, SG24-7378

1.2.1 Stand-alone server topology

The simplest topology is one that consists of a stand-alone server for
WebSphere Process Server and WebSphere Enterprise Service Bus. All
components run on a single server and both modules and mediation modules
run in the application server.

With this topology, there is no central configuration management. The application

server has its own administrative console. There are no workload management
or high availability features with this topology.

10 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

This topology is most often seen for non-critical applications and in test
environments.

Node1

W ebSphere Process Server

Application
Modules
Mediation m odules
Support
Messaging

Figure 1-4 Stand-alone server topology

Example: For an example of this topology, see 3.2, “Standalone WebSphere

Process Server” on page 56.

1.2.2 Deployment environment patterns

A set of deployment environment patterns have been identified that represent
common deployment scenarios. WebSphere Process Server provides built-in
support for these patterns in the installation process, the profile creation tools,
and administrative console. These patterns assist in creating the profiles and
configuration settings that define complex deployment environments, including
the creation of the supporting databases and clusters.

The three patterns are:

򐂰 Single cluster pattern
򐂰 Remote messaging pattern
򐂰 Remote messaging and remote support pattern

Using this support is recommended on distributed and i5/OS systems. The

patterns defined by this support are also legitimate patterns for a z/OS
environment, but at the time of this publication, the use of the deployment

Chapter 1. Planning for installation 11

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

environment options in the profile creation tool and the administrative console
were not recommended.

Cluster pattern components

The patterns use application server clustering to provide failover and load
balancing for components in the topology. The support for these components has
been broken down into the following categories:
򐂰 Messaging components that support the WebSphere Process Server and
WebSphere ESB environment:
– Service Component Architecture (SCA) application bus. This bus exists as
a default location for the queues that are used by JMS export components.
– SCA system bus
– Business Process Choreographer bus
– Common Event Interface (CEI) bus
򐂰 Support components for the WebSphere Process Server and WebSphere
ESB environment:
– CEI server
– Business Rules Manager
– BPC Explorer and BPC Observer
򐂰 Application components
– Application deployment target

Using patterns for WebSphere Process Server and WebSphere ESB:

When used to create a WebSphere Process Server environment, the

application deployment target can host modules, mediation modules or both.
When used to create a WebSphere ESB environment, the application
deployment target can host mediation modules only.

For examples of combining these patterns to create more complex

deployment environments, see Chapter 3, “Creating profiles on distributed
and i5/OS systems” on page 51

1.2.3 Single cluster pattern

The single cluster pattern is the simplest of the clustering patterns. It defines one
cluster that supports applications, messaging, and the support components.

12 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

This pattern is recommended for the scenarios where most invocations are
synchronous. Messaging use should be minimal and applications role should
dominate the use cases.

The cluster can consist of multiple nodes and multiple servers on each node. A
cluster consisting of WebSphere Process Server nodes and servers can host
both business integration and mediation applications. Applications are installed
to the cluster.

Node1 Node2

WebSphere WebSphere Cluster1

Process Process
Server Server
Application
Modules
Mediation modules
WebSphere WebSphere
Support
Process Process
Messaging
Server Server

Figure 1-5 Single cluster pattern

Example: For an example of this topology, see 3.3, “Building a deployment

environment using a pattern” on page 66.

1.2.4 Remote messaging pattern

The remote messaging pattern defines one cluster for application deployment
and one remote cluster for the messaging infrastructure. The common event
infrastructure and other support applications are configured on the application
deployment cluster. This pattern is recommended for scenarios involving heavy
asynchronous invocations. However, this is not ideal when other supporting
runtime components are actively involved.

Applications are installed to the application deployment cluster.

Chapter 1. Planning for installation 13

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

In this pattern, the messaging cluster is assigned as a member of the service

integration buses that provide support for the WebSphere Process Server and
WebSphere ESB infrastructure. The SCA.Application bus has one bus member
(the messaging cluster) by default.

Node1 Node2

Cluster1

WebSphere WebSphere Application

Process Process Modules
Server Server Mediation modules
Support

Cluster2
WebSphere WebSphere
Process Process Messaging
Server Server

Figure 1-6 Remote messaging pattern

1.2.5 Remote messaging and remote support pattern

The Remote messaging and remote support pattern defines one cluster for
application deployment, one remote cluster for the messaging infrastructure, and
one remote cluster for the common event infrastructure and other support
applications.This pattern performs well, providing the most scalable, flexible and
versatile topology pattern. If in doubt, select this pattern.

14 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

Node1 Node2

Cluster1
WebSphere WebSphere
Process Process Application
Server Server Modules
Mediation modules

WebSphere Cluster2
WebSphere
Process Process Messaging
Server Server

Cluster3
WebSphere WebSphere
Process Process
Support
Server Server

Figure 1-7 Remote messaging and remote support pattern

Example: For an example of this topology, see 3.3, “Building a deployment

environment using a pattern” on page 66.

1.2.6 Web servers

WebSphere Application Server provides Web server plug-ins that work with a
Web server to route requests from the Web server to the proper application
server. A Web server plug-in is specific to the type of Web server. It is installed
on the Web server machine and configured in the Web server configuration.

A plug-in configuration file generated on the application server and placed on the
Web server is used for routing information. In order to manage the generation
and propagation of these plug-in configuration files, Web servers are defined to
the WebSphere configuration repository. In some cases, Web server
configuration and management features are also available from the WebSphere
administrative tools.

Chapter 1. Planning for installation 15

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

Node1 Node2

Cluster1
WebSphere WebSphere
Web Process Process Application
Server Server Server Modules
Mediation modules

WebSphere Cluster2
WebSphere
Process Process Messaging
Server Server

Cluster3
WebSphere WebSphere
Process Process
Support
Server Server

Figure 1-8 Remote messaging and remote support pattern

Managed Web servers versus unmanaged

A supported Web server can be on a managed node or an unmanaged node,
depending on the environment on which you are running the Web server.

Basic administrative functions are provided in the WebSphere administrative

tools for all supported Web servers. For example, generation of a plug-in
configuration can be performed for all Web servers. If the Web server is defined
on a managed node, automatic propagation of the plug-in configuration can be
performed using node synchronization. If the Web server is defined on an
unmanaged node, automatic propagation of a plug-in configuration is only
supported for IBM HTTP Servers.

Some additional administrative console tasks are supported for IBM HTTP
Servers on managed and unmanaged nodes. For example, you can start IBM
HTTP Servers, stop them, terminate them, display their log files, and edit their
configuration files.

Unmanaged nodes
An unmanaged node does not have a node agent to manage its servers. In a
stand-alone server environment, you can define one Web server and it, by
necessity, resides on an unmanaged node. In a distributed server environment,
Web servers defined to an unmanaged node are typically remote Web servers.

16 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

If the Web server is defined to an unmanaged node, you can do the following:
1. Check the status of the Web server.
2. Generate a plug-in configuration file for that Web server.
If the Web server is an IBM HTTP Server and the IHS Administration server is
installed and properly configured, you can also:
a. Display the IBM HTTP Server Error log (error.log) and Access log
(access.log) files.
b. Start and stop the server.
c. Display and edit the IBM HTTP Server configuration file (httpd.conf).
d. Propagate the plug-in configuration file after it is generated.

You cannot propagate an updated plug-in configuration file to a non-IHS Web

server that is defined to an unmanaged node. You must install an updated plug-in
configuration file manually to a Web server that is defined to an unmanaged
node.

Managed nodes
In a distributed server environment, you can define multiple Web servers. These
Web servers can be defined on managed or unmanaged nodes. A managed node
has a node agent. If the Web server is defined to a managed node, you can do
the following:
1. Check the status of the Web server.
2. Generate a plug-in configuration file for that Web server.
3. Propagate the plug-in configuration file after it is generated.
If the Web server is an IBM HTTP Server (IHS) and the IHS Administration
server is installed and properly configured, you can also:
a. Display the IBM HTTP Server Error log (error.log) and Access log
(access.log) files.
b. Start and stop the server.
c. Display and edit the IBM HTTP Server configuration file (httpd.conf).

How are nodes and servers defined?

During the installation of the plug-in, the Plug-ins installation wizard creates a
Web server configuration script named configure<Web_server_name>. This
configuration script is used to define the Web server definition and, if necessary,
the node definition to WebSphere.

If a Web server definition already exists for a stand-alone application server,

running the script does not add a new Web server definition. Each stand-alone

Chapter 1. Planning for installation 17

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

application server can have only one Web server definition. A distributed server
environment, on the other hand, can have multiple Web server definitions. The
script creates a new Web server definition unless the Web server name is the
same.

The Plug-ins installation wizard stores the script in the <plug-in_home>/bin

directory on the Web server machine. If the plug-in is installed locally (on the
same machine as the application server), the configuration script will be run
automatically.

For remote installations, you must copy the script from the Web server machine
to the WPS_install_root/bin directory on the application server machine for
execution. The script runs against the default profile. If one machine is running
under Linux® or UNIX® and the other machine is running under Windows®, use
the script created in the <plug-in_home>/bin/crossPlatformScripts directory.

Note: Always open a new command window in which to execute the

configure<Web_server_name> script. There is a potential conflict between a
shell environment variable, the WAS_USER_SCRIPT variable, and the real
default profile. The script always works against the default profile. However, if
the WAS_USER_SCRIPT environment variable is set, a conflict arises as the
script attempts to work on the profile identified by the variable.

If you are federating a stand-alone application server into a cell, any Web server
definitions created for a stand-alone application server will be lost when they are
federated. If you are creating a distributed server environment this way, wait until
after federating your application servers to create Web server definitions.

For more information about the installation of Web server plug-ins and how the
Web server definitions scripts are generated and executed, see WebSphere
Application Server V6.1: Planning and Design, SG24-7305.

1.3 Planning for installation

In this book, we will show examples of various installation and profile creation
scenarios. However, this is not intended to be a comprehensive planning guide.

Please refer to the WebSphere Process Server V6.1.0 information center for
more in-depth planning and installation topics:
򐂰 Planning for WebSphere Process Server (distributed and i5/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/cpln_plancons.html

18 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

򐂰 Planning for WebSphere Process Server (z/OS)

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/cpln_plancons.html

In addition, the following document provides valuable guidance in planning for a

WebSphere for z/OS installation
򐂰 WebSphere z/OS V6 -- WSC Sample ND Configuration
http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP10065
3

1.3.1 Prerequisites
Before starting the installation process, check the following Web site to make
sure you have met the prerequisites:
򐂰 WebSphere Process Server detailed system requirements
http://www-1.ibm.com/support/docview.wss?uid=swg27006205

1.3.2 User ID authorities for installation

The user ID used for installation is preferably one with Administrator authorities.
However, it is possible to use a “non-root” user ID. Non-root installation allows
you to perform the install as a non-root user on Linux or UNIX operating systems,
or as a non-administrator on Windows.

If you decide to use a non-root user ID to perform the installation, be sure to

review the following information center articles:
򐂰 Limitations of non-root installers
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.
websphere.nd.multiplatform.doc/info/ae/ae/rins_nonroot.html
򐂰 Granting write permission of files and directories to a non-root user for profile
creation
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/iins_nonrootprofile.html

To install on an i5/OS system, you must use a valid i5/OS user profile for that
system. The user profile must have *ALLOBJ and *SECADM authorities. Without
these authorities, the installation will fail.

To install on z/OS, you must have administrator authority.

Chapter 1. Planning for installation 19

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

1.3.3 Installation methods

Before starting the install, you should be aware of the options you have for the
method of installation.

Distributed systems
Installation on distributed systems can be done interactively or silently. Interactive
installation is initiated by executing the launchpad interface and selecting the
option to install WebSphere Process Server. An example of this can be found in
Chapter 2, “Installation on distributed and i5/OS systems” on page 37.

To perform a silent install, you build a response file and execute the install
command.

Both installation methods install the binary files and (optionally) allow you to
create one profile. Additional profiles can be created after installation using the
PMT or manageprofiles command.

For more information about installation, see:

򐂰 Installing and configuring WebSphere Process Server (distributed and i5/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/welcome_wps_ins.html

i5/OS
Installation on i5/OS can be done using one of the following methods:
򐂰 Interactively from a Windows workstation
򐂰 Silently from a Windows workstation
򐂰 Silently on the i5/OS system

Examples of an interactive installation and a silent installation on i5/OS can be

Chapter 2, “Installation on distributed and i5/OS systems” on page 37.

The installation installs the binary files and optionally, allows you to create one
profile. Additional profiles can be created after installation using the PMT on a
Windows workstation or the manageprofiles command on i5/OS.

For more information about installation, see:

򐂰 Installing and configuring WebSphere Process Server (distributed and i5/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/welcome_wps_ins.html

20 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

z/OS
Installation on z/OS is done in phases.
1. Use SMPE to install and configure WebSphere Application Server for z/OS.
2. Use SMP/E to install the WebSphere Process Server product binaries into an
HFS or zFS file system.
3. Create the WebSphere Application Server profiles required for the topology
you select using the customization dialog or zPMT.
4. Run the zSMPInstall.sh script to install WebSphere Process Server to each
WebSphere Application Server profile directory.
5. Create the appropriate databases and storage groups required by
WebSphere Process Server.
6. Run the zWPSConfig.sh to configure the server as a process server, enabling
the server to handle business processes and mediations.

Note: When you order WebSphere Process Server for z/OS you get the
WebSphere ESB runtime that allows you to run mediations in a
WebSphere Process Server configured server. You can't build an ESB-only
server. There is a zWESBConfig.sh script shipped with WebSphere
Process Server, but it doesn't work.

In order to build an ESB-only server you have to order, SMP/E install and
configure the WebSphere ESB for z/OS product separately.

For information on these steps, see the information center, starting with this
article:
򐂰 Installing and configuring WebSphere Process Server (z/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/iins_zos_welcome.html

1.3.4 Installation type (distributed and i5/OS)

On distributed and i5/OS systems, you have three options for installation.
򐂰 Typical Installation: A full installation of WebSphere Process Server. This
installation path allows you to define a WebSphere Enterprise Service Bus or
WebSphere Process Server environment consisting of one stand-alone
server, a deployment manager, or a custom profile during the installation
process. The common database is created using the default for the operating
system. You may also elect to create no profiles during installation.

Chapter 1. Planning for installation 21

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

򐂰 Deployment Environment Installation: A full installation of WebSphere

Process Server. This installation choice guides you through the process of
setting up a deployment environment. You can choose a deployment manager
based on a deployment environment pattern or continue to define a
deployment environment that you have already created. This option allows
you to select from a limited list of database providers for the common
database. After installation, you create additional profiles using the Profile
Management Tool or manageprofiles command.
򐂰 Client Installation: A partial installation of WebSphere Process Server that
allows you to run a client application that interacts with a WebSphere
Enterprise Server Bus and WebSphere Process Server within the same cell.

1.3.5 Selecting additional features

During the install, you will have the option of selecting the following features that
are not installed by default:
򐂰 Business rule beans (deprecated)
This option is available on all platforms with the exception of i5/OS.
This function has been carried forward from WebSphere Business Integration
Server Foundation, version 5.1.1. It will not be supported in future versions of
WebSphere Process Server.
Business rule beans has been replaced by business rules.
For more information, see:
– Overview of business rules
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/co
m.ibm.websphere.wps.610.doc/doc/cadm_busiru_overview.html
– Deprecated features
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/co
m.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.html
򐂰 Extended messaging service (deprecated)
This option is available on all platforms with the exception of i5/OS.
This function has been carried forward from WebSphere Business Integration
Server Foundation, version 5.1.1. It will not be supported in future versions of
WebSphere Process Server. Instead of using the Extended Messaging
Service and its associated tools, the standard JMS APIs, or equivalent
messaging technologies should be used.
For more information, see:
– Deprecated features

22 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/co
m.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.html
򐂰 WebSphere Process Server samples
The Samples Gallery contains sample that demonstrate WebSphere
technology. They are appropriate for demonstration and development
environments, but are not recommended for production environments.
For more information on educational material, see:
– Samples and tutorials
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/co
m.ibm.websphere.wps.610.doc/doc/covw_sample_tutorial.html

1.3.6 Root directory

You will need to specify a location for the installation. The default root directories
can be found in:

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.
websphere.wps.610.doc/doc/rins_installation_paths.html

1.3.7 Creating profiles during installation

Determining the profiles you will need will depend on the topology you plan to
run. With the exception of stand-alone topologies, every topology will need
multiple profiles. With distributed and i5/OS installations, you have the option of
creating a profile during installation. After installation, you can create additional
profiles using the manageprofiles command or the Profile Management Tool.

Creating the first profile during installation is simply a shortcut to get you started.

1.3.8 Installing recommended maintenance

After installation, you should install the Update Installer for WebSphere Software
and install all recommended fixes. The Update Installer can be installed from the
launchpad.

Recommended fixes can be found at:

򐂰 Recommended Fixes for WebSphere Process Server
http://www-1.ibm.com/support/docview.wss?rs=2307&uid=swg27006649
򐂰 Mandatory critical fixes for WebSphere Process Server for z/OS V6.1

Chapter 1. Planning for installation 23

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

http://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&q1=P
K59140&uid=swg27011675&loc=en_US&cs=utf-8&lang=en

1.4 Planning for profiles

Decisions to be made before creating a profile are related to the topology and
runtime environment. These decisions are logically separate from those made for
installation. However, since you can create profiles during installation, these
topics should be considered during your initial planning.

Profiles on distributed and i5/OS systems can be created in one of the following
ways:
򐂰 Using the Profile Management Tool (a wizard-driven tool)
򐂰 During installation
򐂰 Using the manageprofiles command

On z/OS systems, the following path is recommended for creating:

1. Use the zPMT to build JCL required to create the WebSphere Network
Deployment profiles.
2. Augment the profiles for WebSphere Process Server or WebSphere ESB.

Configuring WebSphere Application Server for z/OS requires a fair amount of

planning and coordination. For example, when defining multiple deployment
managers or application servers on a single machine or LPAR, you need to
ensure that the ports and names you select for each are unique and the z/OS
environment variables, generated jobs, and so on, were all set up properly. We
strongly recommend you spend time planning the installation and if possible,
practice by configuring a stand-alone application server using the default options.

1.4.1 Planning for databases

WebSphere Process Server uses databases during runtime to support the
execution of business processes and mediations. The set of tables that make up
each database can be stored in a separate physical database, or can be a
combined with others in a larger common database. The database configuration
you choose will depend on the features that you use and performance
considerations. The databases can be created as part of the profile creation, or
you can choose to delay creating them until after the profile is created but before
it is started.

The following is the list of logical databases:

24 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

򐂰 WebSphere Process Server components and the enterprise service bus use
a common database. The default name for this database is WPRCSDB.
򐂰 A Common Event Infrastructure database, referred to as the CEI database.
The default name for this database is EVENT.
򐂰 A Business Process Choreographer database, referred to as the Business
Process Execution database. The default name for this database is BPEDB.
򐂰 A Business Process Execution Observer database, referred to as the
observer database. The default name for this database is OBSRVDB.
򐂰 A database for the messaging engines. The default name for this database is
MEDB.

i5/OS: On series®, there is a single global database in which you define all
schemas for all functional components. You must make sure that all schema
names are unique within the logical partition (LPAR).

There are also unique considerations for selecting the driver needed to
connect remotely to an i5/OS database server. For more information, see:
򐂰 Database specifications
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/co
m.ibm.websphere.wps.610.doc/doc/cins_db_specs.html

Detailed requirements for database products can be found in:

򐂰 WebSphere Process Server detailed system requirements
http://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&uid=
swg27006205

Deciding when and how to create the databases

The minimal configuration for a WebSphere Process Server or WebSphere ESB
configuration is the common database that contains all the database tables. This
is not recommended for a production system. This is the configuration you will
get if you use the Profile Management Tool to create the databases. In this series
of books, we will use this configuration.

For production systems, it is recommended that you create the databases and
update the appropriate data sources manually. This gives you maximum control
over the location and grouping of database tables. To do this, you choose the
option to delay the creation of the databases when you create the profiles. This
will cause scripts to be generated to help you create the common and event
databases, and will create the data sources based on information you provide
during profile creation. Create the databases using the scripts or your own
commands and update the appropriate data sources.

Chapter 1. Planning for installation 25

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

Finding the database scripts and specifications

You can find scripts for the common database, the BPEDB and the OBSRVDB in
WPS_install_root/dbscripts. These scripts are available after install.

During the profile creation with the Profile Management Tool, a new set of scripts
is generated into profile_root/dbscripts. These scripts create the common
database with the attributes you specified during profile creation.

Scripts to create the Business Process Choreographer tables and schema are
generated when you configure BPC. This can be during or after profile creation
or as part of the deployment environment configuration. These are also stored in
profile_root/dbscripts. You will need to create the BPEDB database and then run
these scripts.

For the messaging engines you can use the sibDDLGenerator script to generate
the database scripts. Information about the messaging engine databases can be
found at:
򐂰 Messaging engine database specifications
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/cins_messaging_engine_db_specs.html
򐂰 Messaging engine database specifications (z/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/cins_messaging_engine_db_specs.html

Common database (WPRCSDB)

WebSphere Process Server components and the enterprise service bus use a
common database. The default name for this database is WPRCSDB.

The common database is used by the following product components:

򐂰 Recovery
򐂰 Relationship service
򐂰 Mediation
򐂰 Application scheduler
򐂰 Customization (selector and business rule group)
򐂰 EventSequencing (LockManager)
򐂰 WebSphere ESB Message Logger primitive

Depending on the database provider you select, you have the option to have the
database created automatically during profile creation. The option to create a
new database is disabled for the following database types:
򐂰 DB2 for z/OS and OS/390 v7
򐂰 DB2 for z/OS v8

26 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

򐂰 DB2 for z/OS v9

򐂰 Oracle 9i and 10g

If you elect to defer the database creation, scripts will be created for your use in
defining the database. The information you enter for the existing database
(whether it actually exists yet or not) must be correct since it will be used to
create the data source and the scripts. The scripts are located in
profile_root/dbscripts/CommonDB/dbType/dbName.

For more information, see:

򐂰 Common database specifications
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/cins_common_db_specs.html
򐂰 Common database specifications (z/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/cins_common_db_specs.html

Table 1-1 shows the database provider options for the Common database.

Table 1-1 Options for common database on distributed systems

Database
product

Derby 򐂰 Install (typical) - standalone profile (the default - no option)

Embedded 򐂰 PMT (typical)- standalone profile (the default - no option)
򐂰 PMT (advanced)- standalone profile
򐂰 Administrative console (deployment environment)

Derby Network 򐂰 Install (typical) - deployment manager (the default - no option)

򐂰 Install (Deployment Environment) - deployment manager
򐂰 PMT (advanced)- all profiles
򐂰 Administrative console (deployment environment)

DB2® UDB 򐂰 Install (Deployment Environment) - deployment manager

򐂰 PMT (advanced)- all profiles
򐂰 Administrative console (deployment environment)

DB2 for i5/OS 򐂰 Install and PMT Standalone profiles

Native Driver 򐂰 Administrative console (deployment environment)

DB2 for i5/OS 򐂰 PMT (advanced)- all profiles

Toolbox Driver 򐂰 Administrative console (deployment environment)

DB2 for z/OS1 򐂰 PMT (advanced)- all profiles

򐂰 Administrative console (deployment environment)

Chapter 1. Planning for installation 27

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

Database
product

DB2 Call-Level 򐂰 PMT (advanced)- all profiles

Interface 򐂰 Administrative console (deployment environment)
Provider (CLI),
DB2 Universal
Runtime Client

Oracle® 9i and 򐂰 Install (Deployment Environment) - deployment manager

10g 򐂰 PMT (advanced)- all profiles
򐂰 Administrative console (deployment environment)

Informix® 򐂰 PMT (advanced)- all profiles

Dynamic 򐂰 Administrative console (deployment environment)
Server

Microsoft® 򐂰 PMT (advanced)- all profiles

SQLServer 򐂰 Administrative console (deployment environment)
(Embedded
Driver and
DataDirect)

If you elect to create the common database outside of installation or profile

creation, see the following article:
򐂰 Creating the Common database and tables after profile creation or
augmentation
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/tins_new_dbcreate.html

Business Process Choreographer databases

The Business Process Execution database (BPEDB) is used by the Business
Flow Manager and the Human Task Manager.

In a non-production system, the BPEDB, OBSRVDB, and messaging engine

databases can all use the common database (WPRCSDB). This is the
configuration you will get as a result of using the install wizard or PMT to create a
deployment environment.

In a production system, you can use the common database for all three
databases, but you may see better performance by using separate databases for
the functions you plan to use.

For each deployment target where the Business Process Choreographer is used,
create a BPEDB database that is separate from the common database. If you will

28 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

use the Business Process Choreographer Observer, this can use the same
BPEDB or, for better performance, can be a separate database.

The Business Process Choreographer messaging engines can either share the
database used by the SCA messaging engines, or have their own BPEMEDB
database.

For information on planning for the Business Process Choreographer databases,

including BPEDB, OBSRVDB, and BPEMEDB databases, see:
򐂰 Planning the databases for Business Process Choreographer
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.bpc.610.doc/doc/bpc/t1pl_database.html
򐂰 Planning the databases for Business Process Choreographer (z/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.bpc.z.610.doc/doc/bpc/t1pl_database.html

Common event database

The event database is used by the Common Event Infrastructure to capture
events as they occur.
򐂰 When you create a stand-alone profile, the event database is created for you.
򐂰 In distributed environments, the event database is not created when you
create a deployment manager profile or managed profile. You must create
and configure the database.
򐂰 When you create a deployment environment, you can specify a database to
use for the event database. You have the option to have the tables created as
part of the deployment environment creation process or you can choose to
run the scripts later to create the tables.

For more information on creating and configuring an event database, see the
following:
򐂰 Common Event Infrastructure database specifications for distributed and
i5/OS systems
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/cins_cei_db_specs.html
򐂰 Common Event Infrastructure database specifications for z/OS systems
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/cins_cei_db_specs.html

Chapter 1. Planning for installation 29

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

1.4.2 Security
Security for WebSphere Process Server is provided by the WebSphere
Application Server infrastructure. Security is a topic that can’t be adequately
addressed in a single section of this chapter. However, it is important that you
understand the concepts of administrative security and application security in
order to adequately install and set up your installation.

Administrative security
Administrative security requires a user ID and password to be provided to log in
to the administrative console and to enter WebSphere administrative commands
from a command line.

When you create a standalone application server or deployment manager you

are given the option to enable security. If you are creating a deployment manager
in a deployment environment, administrative security is not optional. It is enabled
when the profile is created.

If you intend to create a profile during installation and want to secure your
administrative environment at the same time, you need to identify one user ID to
be used for administration. The user ID and password specified during profile
creation will be created in the repository and assigned the Administrator role.
This ID can be used to access the administration tools and to add additional user
IDs for administration.

When you enable security during profile creation, LTPA is used as the
authentication mechanism.

On distributed systems, a file-based user repository is created and populated

with the administrator ID. This file-based system can be federated with other
repository types to form an overall repository system. If you do not want to use
the file-based repository, do not enable administrative security during profile
creation. In WebSphere for z/OS, you can choose to use the file-based repository
or use the z/OS system SAF-compliant security database.

Whether you choose to enable administration security during profile creation or

after, it is important that you do it before going into production.

Application security
Application security enables security for the applications in the cell. This type of
security is disabled by default in WebSphere Application Server profiles, but is
enabled by default in WebSphere Process Server profiles. Before deploying
applications that implement security, you must review and configure the
application security settings for your environment.

30 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

For information about securing applications, see:

򐂰 IBM WebSphere Application Server V6.1 Security Handbook, SG24-6316

1.4.3 Ports
Each WebSphere process uses a set of TCP/IP ports. These must be unique to
the system. Ports used for WebSphere Process Server and WebSphere ESB
servers are the same as those used for WebSphere Application Server.

The default ports for i5/OS and distributed platforms are listed in the following
Information Center article:

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.web
sphere.nd.multiplatform.doc/info/ae/ae/rmig_portnumber.html

The default ports for z/OS are listed in the following article:

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.web
sphere.zseries.doc/info/zseries/ae/rrun_ports.html

Selecting ports using the Profile Management Tool

When you create a profile using the Profile Management Tool, a set of ports will
be automatically selected for you. These ports will be unique to the WebSphere
installation on your system, but will not necessarily be unique to the system.
Before creating a profile, you should review the ports in use on the system to
ensure there are no conflicts with the WebSphere process.

If you anticipate a port conflict with another process running on your system, be
sure to take the Advanced profile creation configuration path. You will be given
the opportunity to review or change the ports selected.

Chapter 1. Planning for installation 31

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

32 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

1.5 Planning for the Profile Management Tool

When you create profiles using the Profile Management Tool, there are some
basic decisions you will need to make. This section discusses those decision
points.

Note: You cannot use the Profile Management Tool to create or augment
profiles on 64-bit platforms (with the exception of i5/OS) or the Linux on
System z™ platform.

1.5.1 Profile environment and type

Profiles used for WebSphere Process Server and WebSphere ESB are Network
Deployment profiles that have been augmented to include features for these
products. When using the Profile Management Tool to create a profile, you will
see the screen shown in Figure 1-9 on page 33.

Figure 1-9 Select the profile environment

Selecting one of the first four options will create a Network Deployment profile. To
create a profile for WebSphere Process Server or WebSphere ESB, select the
appropriate option from the last two options.
򐂰 When you select WebSphere Process Server as the environment, you get a
profile that includes all the functions of WebSphere Process Server,
WebSphere ESB and WebSphere Application Server.
򐂰 When you select WebSphere Enterprise Service Bus, you get a profile that
include the functions of WebSphere ESB and WebSphere Application Server.
Select this environment if you only have a licensed WebSphere Enterprise
Server Bus installation or if you intentionally want to narrow the scope of the
server capabilities.

Chapter 1. Planning for installation 33

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

The next panel of the wizard will give you the opportunity to select the type of
augmented profile you want to create. The options are a deployment manager
profile, a stand-alone application server profile of the type you selected in the
environment selection panel, or a custom node profile.
򐂰 If you selected WebSphere Process Server, your options will be those shown
in Figure 1-10 on page 34.

Figure 1-10 Profile Type Selection for WebSphere Process Server

򐂰 If you selected WebSphere Enterprise Service Bus, your options will be those
shown in Figure 1-10 on page 34.

Figure 1-11 Profile Type Selection for WebSphere Enterprise Service Bus

Depending on your selection, you will have two or three options for the
configuration path as shown in Figure 1-12.

34 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPlan.fm

Figure 1-12 Profile creation options

򐂰 The Typical profile creation option uses defaults to create the profile. The
input requires is kept to a minimum, but you have few options.
򐂰 The Advanced profile creation option gives you more control over settings
used for profile creation. Default values will be provided, as with the Typical
option, but you will have the option to change them.
򐂰 The Deployment environment profile creation option (not applicable to
stand-alone profiles) will give you the option of creating a new deployment
environment and deployment manager, or to add a custom node to an
existing deployment environment.

If you choose the deployment environment path and are creating a deployment
manager, you will be able to select from the list of patterns shown in Figure 1-13.

Chapter 1. Planning for installation 35

7643RunPlan.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 1-13 Deployment environment patterns

36 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstDistributed.fm

Chapter 2. Installation on distributed

and i5/OS systems
This chapter shows how to install WebSphere Process Server server on
distributed and i5/OS platforms. There are a combination of options available to
you when you install. This chapter will illustrate the installation using one set of
options. The intent is to help you understand the install process. Further
examples can be found in Chapter 3, “Creating profiles on distributed and i5/OS
systems” on page 51.

For complete planning and installation information, see:

򐂰 Installing and configuring WebSphere Process Server
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/welcome_wps_ins.html

© Copyright IBM Corp. 2008. All rights reserved. 37

7643RunInstDistributed.fm Draft Document for Review June 3, 2008 1:55 pm

2.1 Installation overview

The following steps are used to install and configure WebSphere Process
Server:
1. Ensure you have the proper pre-requisites by checking the system
requirements listed at the following Web site:
http://www-306.ibm.com/software/integration/wps/sysreqs/
2. Install WebSphere Process Server on each system. The installation will
process will install WebSphere Application Server Network Deployment, and
WebSphere Process Server, including WebSphere ESB functionality.
3. Install recommended maintenance.
4. Build your topology by creating profiles.

2.2 Typical installation

This section will take you through the steps of installing WebSphere Process
Server. You must install WebSphere Process Server on every system that will
host a stand-alone server, deployment manager, or custom node profile.

Note: In the installation examples in this book, we do not create profiles during
installation. We preferred to separate the tasks so that installation concepts
will not be confused with profile concepts. However, if you want to create your
first profile during installation, the same concepts for creating profiles exists.
See Chapter 3, “Creating profiles on distributed and i5/OS systems” on
page 51.

1. Start the launchpad.

The launchpad for WebSphere Process Server contains a menu with options
for installing the products that are packaged with WebSphere Process Server.
It is located on Disk1 of the installation materials or in the root directory of
downloaded installation materials.
For example, we downloaded the product. The launchpad was found at:
C:\tmp\C177TML\launchpad.bat

38 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstDistributed.fm

Figure 2-1 Launchpad

2. Select WebSphere Process Server installation.

3. Select Launch the installation wizard for WebSphere Process Server for
Multiplatforms.
4. On the Welcome page, click Next.
5. Read and accept the license agreement. Click Next.
6. The wizard checks your operating system to ensure it meets the requirements
for the installation. If your system passes the check, you can proceed. The
wizard also checks for the existence of another WebSphere Application
Server, WebSphere Process Server, or WebSphere ESB installation. If one is

Chapter 2. Installation on distributed and i5/OS systems 39

7643RunInstDistributed.fm Draft Document for Review June 3, 2008 1:55 pm

found you will have the choice of adding features to it, installing a new copy, or
creating a new profile. To proceed with the install, click Next.
7. For a new installation, you will be given the three options shown in Figure 2-2
for the installation type.

Figure 2-2 Installation type selection

The Deployment Environment Installation option creates a profile and

performs the configuration required for a selected pattern. In this example, we
are planning to delay profile creation until after installation, so we select
Typical Installation. This option allows you to create a profile or to skip that
step.
For more information, see 1.3.4, “Installation type (distributed and i5/OS)” on
page 21.
8. The next screen allows you to select from the additional features:

40 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstDistributed.fm

– Business rule beans

– Extended messaging
– Samples
The first two features are deprecated and should not be used in new
applications. The samples are appropriate for education purposes and are
most appropriate in test environments.
For more information, see 1.3.5, “Selecting additional features” on page 22.
Click Next.
9. The next screen allows you to select the directory to be used as the
installation root directory.
On Windows systems, the default is:
C:\Program Files\IBM\WebSphere\ProcServer
To avoid any potential problems with file names greater than 256 characters,
we suggest that you select something shorter.
From here on, the root directory chosen will be referred to as
WPS_install_root.
10.Profiles can be created as part of the installation process. Profile types are
discussed in “Profile types” on page 3. Note that in this case, the assumption
is that the profile will be a WebSphere Process Server capable profile.
Select one of the options shown in Figure 2-3:

Chapter 2. Installation on distributed and i5/OS systems 41

7643RunInstDistributed.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 2-3 Select an environment

If you select a profile type to install, the next series of panels will lead you
through the options for the profile type.
In this example, we select None. We will create the profiles after installation.
11.The next screen shows a summary of your installation options. Click Next to
start the install.
12.At the completion of the installation, make sure the install was successful and
click Finish.

2.3 Installation on i5/OS

Beginning with V6.1, WebSphere Process Server and WebSphere Enterprise
Bus support the iSeries platform. This section will illustrate two methods you can
use to install WebSphere Process Server and WebSphere Enterprise Bus on
iSeries:
򐂰 Install remotely from a Windows workstation.

42 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstDistributed.fm

򐂰 Install silently from the i5/OS server

2.3.1 Installing remotely from a Windows workstation

The GUI installation method is the easiest way to install WebSphere Process
Server. We recommend that you use this method if you are going to install a
simple environment. Do not use it, however, if you have a slow network
connection between your server and workstation or if there is a firewall that does
not permit access to the hosts servers’ ports.

To install WebSphere Process Server V6.1 from a workstation using the

graphical installation method, use the following procedure:
1. Start a 5250 emulator session and sign on.
2. Start hosts servers. From a i5/OS command line type:
STRHOSTSVR SERVER(*ALL)
Click Enter.
3. Insert the WebSphere Process Server for i5/OS CD, and insert it into a CD or
DVD drive on your Windows workstation. If your workstation has autostart
configured, the launchpad starts. If the autostart program is not executed,
locate the launchpad.exe file on the CD, and execute it.

Chapter 2. Installation on distributed and i5/OS systems 43

7643RunInstDistributed.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 2-4 Launchpad for WebSphere Process Server for i5/OS platforms

4. Select WebSphere Process Server Installation to start the installation

wizard for WebSphere Process Server.
5. A pop-up window will appear asking for the login information for the remote
i5/OS system.

Note: Make sure the user ID on the i5/OS system has the *ALLOBJ and
*SECADM special authorities.

44 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstDistributed.fm

Figure 2-5 Log in to the i5/OS system

6. Select an installation type:

– Typical Installation
– Deployment Environment Installation
– Client Installation
In this example, we are planning to delay profile creation until after
installation, so we select Typical Installation. This option allows you to
create a profile or to skip that step.
For more information, see 1.3.4, “Installation type (distributed and i5/OS)” on
page 21.
7. Specify the installation root directory for WebSphere Process Server.

Chapter 2. Installation on distributed and i5/OS systems 45

7643RunInstDistributed.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 2-6 Select the installation root directory

8. Profiles can be created as part of the installation process. Profile types are
discussed in “Profile types” on page 3. Select one of the following options:
– Stand-alone server
– Deployment manager
– Custom
– None
In this example, we select None. The profiles will be built after installation.
9. The next screen shows a summary of your installation options. Click Next to
start the install.
10.At the completion of the installation, make sure the install was successful and
click Finish.

46 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstDistributed.fm

2.3.2 Installing WebSphere Process Server on i5/OS silently

The following process explains how to install WebSphere Process Server on an
i5/OS system in silent mode.
1. Sign on to the i5/OS server with a user profile that has *ALLOBJ and
*SECADM special authorities.
2. Edit file responsefile.wbis.txt, located in $BUILD_HOME/WBI where
$BUILD_HOME is the directory where you unzipped WebSphere Process
Server install image. The following values usually need to be changed:
– Change the value for -OPT silentInstallLicenseAcceptance from false to
true. A value of true indicates that you have read and accept the terms of
the license agreement. This change is required to run the installation.
– Change the value -OPT wpsInstallType according to installation type you
want, using one of the following values:
• Typical - this is a full installation. It allows you to define an initial
environment consisting of a stand-alone process server, a deployment
manager, or a custom node.
• Client - this is a partial installation. It allows you to run client
applications that interact with a WebSphere Process Server within the
same cell.
• ndGuided - this is a full installation that guides you through setting up
a Network Deployment topology. You can choose to create a new
topology based on a topology pattern or continue to define a topology
that you have already created.
ndGuided cannot be selected if you are installing using an existing
base WebSphere Application Server V6.1
In this example, we use Typical.
– Change the value for -OPT useExistingWAS from true to false,
indicating you will install a new WebSphere Application server. If you
intend to use an existing installation of WebSphere Application Server,
then you keep the value as true.
– Uncomment the value for -OPT defaultProfileLocation.
3. On the Command entry of i System, issue qsh to start the Qshell command
shell.
4. Then issue the INSTALL command from the $BUILD_HOME/WBI directory to
start the installation program.
INSTALL -options $BUILD_HOME/WBI/responsefile.wbis.txt -silent

Chapter 2. Installation on distributed and i5/OS systems 47

7643RunInstDistributed.fm Draft Document for Review June 3, 2008 1:55 pm

2.4 Install the IBM Update Installer

Maintenance for products based on WebSphere Application Server is installed
using the IBM Update Installer for WebSphere Software.
1. From the Launchpad, select IBM Update Installer for WebSphere Software
installation.
2. Select Launch the installation wizard for IBM Update Installer.
3. Click Next on the Welcome page.
4. Read and accept the software license agreement. Click Next.
5. When the prerequisite check completes successfully, click Next.
6. Select the root directory for the installation. For example, on our system,
WebSphere Process Server was installed at:
C:\WebSphere\ProcServer
So we selected the following for the Update Installer installation root directory:
C:\WebSphere\UpdateInstaller
Click Next.
7. Review your settings and click Next.
8. When the installation completes successfully, click Finish.

2.5 Download and install maintenance

The next step is to install any maintenance required. For the latest information,
see:
򐂰 Recommended Fixes for WebSphere Process Server
http://www-1.ibm.com/support/docview.wss?rs=2307&uid=swg27006649
1. Download the maintenance to a temporary location.
2. Unzip the maintenance to the updater_root/maintenance directory, for
example:
C:\WebSphere\UpdateInstaller\maintenance
3. Start the Update Installer using the updater_root/update command.
4. Follow the instructions in the Update Installer wizard to select and install the
maintenance.

For more information on using the Update Installer, see:

48 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstDistributed.fm

򐂰 Installing fix packs and refresh packs with the Update Installer
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/tins_apply_service.html

Chapter 2. Installation on distributed and i5/OS systems 49

7643RunInstDistributed.fm Draft Document for Review June 3, 2008 1:55 pm

50 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Chapter 3. Creating profiles on

distributed and i5/OS
systems
This section take you through examples of creating a variety of topologies,
including those defined by the deployment environment patterns. While all the
topologies are shown are applicable to distributed, i5/OS, and z/OS systems, the
methods we use to create them are specific to distributed and i5/OS. For an
example of building a z/OS topology, see Chapter 4, “Creating and managing
profiles on z/OS” on page 93.

© Copyright IBM Corp. 2008. All rights reserved. 51

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

3.1 Methods used to build the profiles

The two methods we will use to build profiles in these topology examples are the
Profile Management Tool and the profile creation options during installation. A
third option, using the manageprofiles command, exists for creating profiles on
distributed and i5/OS systems. We will show you an example of using this
command but did not use it to build the example topologies.

On z/OS systems, profiles are created by generating a series of jobs using the
zPMT or ISPF customization dialog and running each job. An example of
creating profiles in z/OS can be found in Chapter 4, “Creating and managing
profiles on z/OS” on page 93.

3.1.1 Profile Management Tool

The Profile Management Tool can run on i5/OS and distributed platforms.

Note: Restriction: You cannot use the Profile Management Tool to create or
augment profiles on 64-bit platforms (except for i5/OS) or on the Linux on
System z platform. To create profiles on these platforms, you must use the
manageprofiles command.

To start the Profile Management Tool, use one of the following methods:
򐂰 From the First steps console. This console starts at the end of an installation if
you select the check box to start the Profile Management Tool.
򐂰 (Windows) From the Start menu, select Start → All Programs → IBM
WebSphere → Process Server 6.1 → Profile Management Tool.
򐂰 (UNIX, Linux) Run WPS_install_root/bin/ProfileManagement/pmt.sh.
򐂰 (Windows) Run WPS_install_root/bin/ProfileManagement/pmt.bat.
򐂰 (i5/OS) Start the Profile Management Tool client on a Windows system

Profile Management Tool Client for i5/OS

The Profile Management Tool client for i5/OS is installed from the WebSphere
Process Server V6.1 installation launchpad. You will need to move the
installation files to the Windows server, start the launchpad, and then select the
WebSphere Profile Management Tool Client for i5 installation.
1. Start the PMT client on a Windows system using one of the following
methods:

52 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

– From the Start menu, select Start → All Programs → IBM WebSphere →
Profile Management Tool Client for i5/OS.
– Run PMT_client_install\PMT\pmt.bat.
2. Enter the host name, user ID, and password required to login to the i5/OS
system.

Figure 3-1 Log in to the i5/OS system

3. Select the WebSphere Process Server installation location that you want to
work with and click Launch Profile Management Tool.
The default port number is 1099. If that port number is busy, you receive an
error message, in which case, you can select a different port number to
continue.

Chapter 3. Creating profiles on distributed and i5/OS systems 53

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-2 Select the installation

3.1.2 The manageprofiles command

Profiles can be created i5/OS and distributed platforms using the manageprofiles
command located in the WPS_install_root/bin directory. The Profile Management
Tool is the GUI interface to this command for creating and augmenting profiles,
but the manageprofiles command has additional function not exposed by the
PMT. For example, listing and deleting profiles.

For information about using the manageprofiles command and its parameters,
see:
򐂰 manageprofiles command
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/rins_manageprofiles.html

The type of profile created depends on the template you select in the
-templatePath parameter:

54 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

򐂰 default.wbiserver: WebSphere Process Server stand-alone server profile.

򐂰 dmgr.wbiserver: WebSphere Process Server deployment manager profile
򐂰 managed.wbiserver: WebSphere Process Server custom profile
򐂰 default.esbserver: WebSphere ESB stand-alone server profile.
򐂰 dmgr.esbserver: WebSphere ESB deployment manager profile
򐂰 managed.esbserver: WebSphere ESB custom profile.

Example 3-1 shows an example of using the manageprofiles command on an

i5/OS system to create a stand-alone WebSphere Process Server profile. The
command is issued from the command from Qshell command shell.

Note that in the example, we have formatted it so that each parameter is on a

separate line for readability. When you enter the command it is entered as a
continuous line.

Example 3-1 example of using manageprofiles

/qibm/proddata/websphere/appserver/v61/nd/manageprofiles -create
-templatePath
/QIBM/ProdData/WebSphere/AppServer/V61/ND/profileTemplates/default.wbis
erver -ceiOutputScriptDir
/QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/ProcSrv01/dbscripts/
CEI_LOCAL
-dbPassword ${password} -dbHostName ${hostname}
-profilePath /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/pat
-nodeName ${nodename}
-enableAdminSecurity false
-dbSchemaName ${commondb}
-dbName *SYSBAS
-dbCreateNew true
-ndtopology false
-dbUserId ${username}
-dbJDBCClasspath /QIBM/ProdData/HTTP/Public/jt400/lib
-ceiNativeJdbcClassPath /QIBM/ProdData/Java400/ext
-ceiDbPassword ${password} -omitAction samplesInstallAndConfig
-ceiDbExecuteScripts true
-dbCommonForME false
-dbType DB2UDBISERIES_TOOLBOX
-configureBRM false
-profileName pat
-hostName ${hostname}
-ceiDbName *LOCAL
-ceiDbUser ${username}
-configureBPC false

Chapter 3. Creating profiles on distributed and i5/OS systems 55

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

-cellName WBIRTPCell
-ceiDbProduct CEI_DB_ISERIES_NATIVE
-dbDelayConfig false -ceiCollection ${ceidb}
-bpcmqPassword ${password} -bpcmqUser ${username}
-configureBPC true
-fileStoreForME true

3.2 Standalone WebSphere Process Server

This section take you through the steps of creating WebSphere Process Server
stand-alone server.
1. Start the Profile Management Tool.
2. Select Create.
3. Click Next on the Welcome page.
4. Select WebSphere Process Server as the environment selection and click
Next.

Figure 3-3 Profile environment selection

5. Select Stand-alone process server profile click Next.

56 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-4 Profile type selection

6. The next screen allows you to select one of two paths through the rest of the
profile creation process: Typical or Advanced.
Take the Advanced path click Next.
7. Check the selections to deploy the administrative console and the default
application and click Next.

Figure 3-5 Selection optional applications

Chapter 3. Creating profiles on distributed and i5/OS systems 57

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

8. Enter a unique name for the profile or accept the default. It is helpful to use
the same name for the profile and the directory location. From here on, this
directory is referred to as profile_root. There are two checkbox options:
– Create the server using the development template: If you want to use
this server in a development environment, select this to optimize the
configuration settings. But don’t choose this option for production
environment.
– Make this profile the default: Select this option to make this profile the
new default profile. Commands (startServer, stopServer, etc.) that run
without referring to a specific profile are run against the default profile.
– Create the server using the development template: If this is a test
environment, consider using this option. Not only does it reduce startup
time, it also populate the user repository with the same sample
organization users and groups that are automatically defined in the
integrated test environment.

Figure 3-6 Profile options

58 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Click Next.
9. Enter a node name, a cell name, and the system host name. The node name
and cell name will default based on the host name of your system.
The names you select for the node and cell should be meaningful and unique
within the installation.
Click Next.

Figure 3-7 Select node, cell, and host

10.Choose whether to enable administrative security. If you enable security here,

you will be asked for a user ID and password that will be added to a file-base
user registry with the Administrative role. Administrative security is discussed
in “Administrative security” on page 30.
In this example, we enable administrative security.
Click Next.

Chapter 3. Creating profiles on distributed and i5/OS systems 59

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

11.The wizard will present a list of TCP/IP ports for use by the application server,
If you already have existing profiles on the system (within this installation), this
will be taken into account when the wizard selects the port assignments, but
you should verify that these ports will be unique on the system.
Click Next.
12.Windows only: On Windows systems, you have the option of running the
application server as a service. This provides you a simple way of
automatically starting the application server when the system starts. If you
are installing on a Windows system, the next screen will give you the option of
running the server process as a Windows service. If you elect to do this, enter
the values for the logon and startup type.
In this example, we specify that the server will run as a Windows service and
will start automatically.
Click Next.
13.The wizard will allow you to create an optional Web server definition. Web
server definitions define an external Web server to the cell configuration. This
allows you to manage Web server plug-in configuration files for the Web
server and in some cases to manage the Web server. If you have not installed
a Web server or wish to do this later, you can easily do this from the
administrative console.
In this example, we do not define an external Web server.
Click Next.
14.Select a database product and a name for the Common Event Infrastructure
database. The database you choose here will be created for you.
Alternatively, you can elect to generate the database scripts and execute
them manually later.
In this example, we are creating a test server on a Windows system and elect
to use Derby.
Click Next.

60 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-8 Select a database provider for the Event database

15.Depending on your selection, the next screen may ask for information
required to access the database, such as the user ID with authority to operate
database. Enter the required information and click Next.
16.The next step gives you the option to create a sample Business Process
Choreographer. Because this is not a production server, we select this option.
Click Next.

Chapter 3. Creating profiles on distributed and i5/OS systems 61

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-9 Configure a sample Business Process Choreographer

17.The next step allows you to have the business rules manager configured. Our
application uses rules, so we select this option.
Click Next.

Figure 3-10 Configure the business rules manager

18.The next step is to configure a common database for WebSphere Process

Server. Once again, we take the Derby Embedded database since this is a
standalone server used for testing. Click Next.

62 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-11 Common database

Messaging engines can use a data store or file store for persistent messages.
By default, data stores are used, however, using the file store may improve
performance. This option is only valid in a stand-alone server configuration.
19.Review the options you selected. Click Create to create the new standalone
server.
20.The last panel shows the status of the profile creation. Ensure the profile was
created successfully. Select the Launch the First Steps console option and
click Finish.

Chapter 3. Creating profiles on distributed and i5/OS systems 63

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-12 Success

21.The First Steps console will give you options you can use to verify the
installation, start and stop the server, and access the administrative console
for the server.

64 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-13 First Steps console for a stand-alone server

Creating a WebSphere ESB standalone server: If you select WebSphere

Enterprise Service Bus as the environment (see Figure 3-3 on page 56), the
process is basically the same except you will not see the options to create the
sample Business Process Choreographer and to configure the business rules
manager.

Chapter 3. Creating profiles on distributed and i5/OS systems 65

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

3.3 Building a deployment environment using a pattern

This example shows how to create a deployment environment that consists two
nodes. The process is the same, regardless of the pattern you choose. You
should be able to take this process and easily extend it to include additional
nodes.

The overall topology that we will build has the following characteristics:
򐂰 A Web server performs load balancing among the clusters that host the
applications.
򐂰 Each deployment environment will have one cluster that hosts the
applications. Depending on the pattern chosen, additional clusters will exist to
host the messaging and support functions.
򐂰 A single common DB2 database, WPRCSDB, is used to host all the required
tables for the WebSphere Process Server and WebSphere ESB functions.
򐂰 The cluster that hosts the business integration modules will consist of
WebSphere Process Server capable nodes and servers.
򐂰 The cluster that hosts the mediation modules will consist of WebSphere
Process Server capable nodes and WebSphere ESB capable servers.

Figure 3-14 shows the topology that uses the single cluster pattern to build both
the WebSphere Process Server and WebSphere ESB clusters.

Application
Messaging
Node1 Node2 Support

WebSphere WebSphere Cluster1

Process Process
Server Server

Web
WPRCSDB
Server host1Node01 host2Node01

WebSphere WebSphere
Dmgr ESB ESB
Mediations

Figure 3-14 Single cluster for processes and single cluster for mediations

66 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-14 shows the topology that uses the remote messaging pattern to build
the WebSphere Process Server clusters and the single cluster pattern to build
the WebSphere ESB cluster.

Node1 Node2

Cluster1
WebSphere WebSphere
Process Process Application
Server Server Support

WebSphere Cluster2
Web WebSphere
Server Process Process
Server Messaging
Server

WebSphere WebSphere Cluster3

Dmgr ESB ESB Mediations

Figure 3-15 Remote messaging pattern

Figure 3-16 shows the topology that uses the remote messaging and remote
support pattern to build the WebSphere Process Server clusters and the single
cluster pattern to build the WebSphere ESB cluster.

Chapter 3. Creating profiles on distributed and i5/OS systems 67

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

System 2

Node1 Node2

Cluster1
WebSphere WebSphere
Process Process Application
Server Server

WebSphere Cluster2
WebSphere
Process Process
Server Messaging
Server
IBM HTTP
Server
Cluster3
WebSphere WebSphere
Process Process Support
Server Server

WebSphere WebSphere Cluster4

Dmgr ESB ESB Mediations

System 1

Figure 3-16 Remote messaging and remote support

3.3.1 Summary of steps

The following steps were used to create a test environment for our business
integration and mediation modules.

Note: The following steps will create a deployment environment with one
database. For a prodution environment it is recommended that you use
multiple databases. See “Planning for databases” on page 24.

1. Install a database server product on one server and database clients on any
additional servers you will use.
2. Install and configure the IBM HTTP Server.
3. Install WebSphere Process Server on System 1. Use the Deployment
Environment installation option to create the deployment manager during the
install process. This will also create the common database.
4. Install the Update Installer and recommended maintenance on System1.

68 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

5. Verify and start the deployment manager.

6. Ensure that each additional node you will add to the environment can access
the new common database.
7. Install WebSphere Process Server on System 2. Use the Deployment
Environment installation option to create a custom node (Node1) and add it to
the deployment environment during the install process.
This step creates the clusters defined by the pattern you select and the
deployment targets you choose. Each cluster created will have one server on
Node1. The process installs the applications necessary for WebSphere
Process Server and defines the system integration buses.
8. Use the PMT to create a second custom node on System 2. Use the
Deployment environment profile creation option to create the node and add it
to the deployment environment.
This creates a new node and will create an additional server in each cluster
you select.
9. Use the PMT to create additional nodes if required.
10.Use the administrative console to create a new deployment environment and
cluster for the WebSphere ESB servers. Add two servers to the cluster, one
on Node1 and one on Node2.
11.Define the Web server to the deployment manager.

3.3.2 Build the Web server

The IBM HTTP Server is shipped with WebSphere Process Server. This is the
Web server that will be used in this example. The following steps were used to
install the IBM HTTP Server and the Web server plug-in.
1. Execute launchpad.exe.
2. Select HTTP Server Installation under Additional Software on the left, and
then select Launch the installation wizard for IBM HTTP Server.
3. Click Next on the Welcome screen.
4. Read and accept the license agreement.
5. The wizard will check the system for prereqs. If you pass, continue by clicking
Next.
6. Select an install location. For example:
C:\HTTPServer
Click Next.

Chapter 3. Creating profiles on distributed and i5/OS systems 69

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

7. Select the HTTP ports for the Web server and for the administration server.
The defaults are:
– HTTP Port: 80
– HTTP Administration port: 8008
Click Next.
8. On Windows systems you have the option to run the server as a Windows
server. Select the appropriate options for your system and click Next.
9. The next screen allows you to create the user ID and password for HTTP
administration authentication. The user ID and password you enter will be
encrypted in the HTTP_install_root/conf/admin.passwd file.
Click Next.
10.The next screen gives you the option to install the Web server plug-in for the
IBM HTTP Server.
Select the option to install the plug-in and provide a name for the Web server
definition. The default is webserver1.
You will also need to provide the host name or IP address of the application
server you will route requests to. If you have more than one application
server, select only one.
Click Next.
11.Review the summary of the installation options you selected and click Next to
start the install.
12.When the installation completes, click Finish.
13.Start the IBM HTTP Server and the HTTP Administration server. On
Windows, if you elected to run these processes as Windows services, start
the services. On other systems, issue the apachectl start command:
HTTPServer_root/bin/apachectl start
14.Verify that the HTTP Server is running by opening a Web browser and going
to the URL for the server. Note that port 80 is the default port for HTTP. If you
used a port other than 80, you will need to specify that on the URL.
http://localhost

70 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

3.3.3 Building the deployment manager

Preparation: You will need to select a database server during this process to
host the common database. In our environment, we installed DB2 UDB V9.1
on the deployment manager system before starting the WebSphere Process
Server installation.

On the system where the deployment manager will be hosted, do the following
actions:
1. Execute launchpad.exe.
2. Select WebSphere Process Server installation in the left panel, and select
Launch the installation wizard for WebSphere Process Server for
Multiplatforms on the right.
3. Click Next at the Welcome screen.
4. Read and accept the license agreement. Click Next.
5. The wizard will perform a prerequisite check. If the check is successful, click
Next.
6. Select Deployment Environment Installation as the installation type and
click Next.

Figure 3-17 Installation type

7. Leave the optional features unselected, and click Next.

8. Select an installation location. For example:
C:\WebSphere\ProcServer
Click Next.

Chapter 3. Creating profiles on distributed and i5/OS systems 71

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

9. Select Create a deployment manager and choose a deployment

environment pattern.

Figure 3-18 Deployment environment installation

Click Next.
10.Enter a user ID and password to have administrative authority. Click Next.
11.Select the deployment environment pattern. The response to this step will
vary depending on the pattern you select.

Figure 3-19 Select the deployment pattern

Click Next.
12.Select a database product and database name for the common database
(WPRCSDB). The database will be created automatically in this case.

72 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-20 Select a database product

Click Next.
13.Depending on your selection for database product, your next screen may ask
for additional information to define the location of the database server.

Chapter 3. Creating profiles on distributed and i5/OS systems 73

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-21 Additional database information

Click Next.
14.Review the installation selections you made and click Next to begin the
installation and profile creation.
15.When the installation completes, check the Launch the First steps console
box and click Finish.
16.In the First steps console, select Installation verification. This will start the
deployment manager and verify that it was installed correctly.
17.Stop the deployment manager from the First Steps window.
18.Install the Update Installer from the Launchpad.
19.Download the recommended maintenance install it.
20.Start the deployment manager.

74 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

21.Login to the administrative console and determine the SOAP port used by the
deployment manager. You will need this information when you create the
remaining nodes.
In the console, select System administration → Deployment manager. The
SOAP port is the value listed in the Ports section for
SOAP_CONNECTOR_ADDRESS.

3.3.4 Building Node1 and the first process server of the cluster

Preparation: The profile creation process will need to access the common
database created during the deployment manager creation. In this example,
we installed the DB2 UDB client on this node and defined the DB2 server on
the deployment manager system to it. Then we defined the WPRCSDB
database to the client and tested the connection.

On the system where the first node of your cluster will be hosted, do the following
actions:
1. Execute launchpad.exe.
2. Select WebSphere Process Server installation in the left panel, and select
Launch the installation wizard for WebSphere Process Server for
Multiplatforms on the right.
3. Click Next at the Welcome screen.
4. Read and accept the license agreement. Click Next.
5. The wizard will perform a prerequisite check. If the check is successful, click
Next.
6. Select Deployment Environment Installation as the installation type.
7. Leave the feature selections unselected, and click Next.
8. Select an installation location. For example:
C:\WebSphere\ProcServer
Click Next.
9. Select Create a custom profile and choose the cluster members within
the deployment environment.

Chapter 3. Creating profiles on distributed and i5/OS systems 75

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-22 Select the custom profile option for the deployment environment

Click Next.
10.The custom node you are creating will be federated to the deployment
manager. This requires that the deployment manager is running and that you
have network connectivity between the two nodes.
– Enter the host name and SOAP port for the deployment manager.
– Enter the user ID and password you specified as having administrative
authority when you created the deployment manager.
Click Next.
11.Select the clusters defined by the deployment environment pattern to assign
this node to. This step will vary depending on the pattern you selected.
– Single cluster pattern: You will only have one choice, Application
Deployment Target. Select this option.
– Remote messaging pattern: You can select Application deployment target,
messaging infrastructure, or both.
– Remote messaging and remote support pattern: You can select
Application deployment target, Messaging infrastructure, Support
infrastructure, or any combination of these.
To complete the deployment environment, you need at least one node with a
server in each cluster. In our examples, we have two nodes, each with a
server in each cluster. In Figure 3-23 on page 77 you see the selection for the
remote messaging and remote support pattern, matching our configuration in
Figure 3-16 on page 68. We select all three cluster types, meaning, this node
will have three servers, each server in one of the selected clusters. Later, we
will add a second node and make the same selection.

76 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-23 Cluster and database configuration

Click Next.
12.Select the database product used for the common database and provide the
location of the JDBC driver classpath on the system that will host the new
node.

Figure 3-24 Select the database product and driver

Click Next.
13.Review the installation selections you made and click Next to begin the
installation and profile creation.
14.When the installation completes, uncheck the Launch the First steps
console box and click Finish.

Chapter 3. Creating profiles on distributed and i5/OS systems 77

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

15.Stop the node from the First Steps menu.

16.Install the Update Installer from the Launchpad.
17.Install recommended maintenance.
18.Start the node from the First Steps menu, or using the following command:
profile_root/bin/startNode(.bat/.sh)
19.Login to the administrative console to see the new cluster and servers.
To see the cluster, select Servers → Clusters. Figure 3-25 shows the
clusters created for the remote messaging and remote support pattern.

Figure 3-25 New clusters

To see the new application servers, select Servers → Application servers.

Figure 3-26 shows the new servers created on Node1 and the clusters they
are assigned to.

78 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-26 New servers on node 1

3.3.5 Building Node2 and the second process server of the cluster
The code has been installed on the system for Node2, so we will use the PMT to
create the profile.
1. Start the Profile Management Tool from the First Steps console.
2. Click Create.
3. Click Next on the Welcome screen.
4. Select WebSphere Process Server as the environment type. Click Next.
5. Select Custom profile as the profile type. Click Next.
6. Select Deployment environment profile creation as the profile creation
option. Click Next.
7. Provide a name for the profile and a directory name to use to create the
profile in. Click Next.
8. Provide a node name and the host name for the node. Click Next.
9. The custom node you are creating will be federated to the deployment
manager. This requires that the deployment manager is running and that you
have network connectivity between the two nodes.
– Enter the host name and SOAP port for the deployment manager.
– Enter the user ID and password you specified as having administrative
authority when you created the deployment manager.
Click Next.

Chapter 3. Creating profiles on distributed and i5/OS systems 79

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

10.Review the port selection and update them if necessary. Click Next.
11.Select the clusters defined by the deployment environment pattern to assign
this node to. This step will vary depending on the pattern you selected.
– Single cluster pattern: You will only have one choice, Application
Deployment Target. Select this option.
– Remote messaging pattern: You can select Application deployment target,
messaging infrastructure, or both.
– Remote messaging and remote support pattern: You can select
Application deployment target, Messaging infrastructure, Support
infrastructure, or any combination of these.
To complete the deployment environment, you need at least one node with a
server in each cluster. In our examples, we have two nodes, each with a
server in each cluster. In this example, we select all three cluster types,
meaning, this node will have three servers, each server in one of the selected
clusters.
Click Next.
12.Select the database product used on the deployment manager and provide
the location of the JDBC driver classpath on the system that will host the new
node. Click Next.
13.Review the installation selections you made and click Create to begin the
installation and profile creation.
14.When the installation completes, uncheck the Launch the First steps
console box and click Finish.
15.Login to the administrative console to see the new servers.
Select Servers → Application servers. You can see the new servers and
their clusters. Each cluster now has two servers, one on each node.

80 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-27 New servers on Node2

16.Start the new servers by selecting Deployment environments. Check the

box to the left of the new deployment environment and click Start.

3.3.6 Creating the cluster for mediation modules

The mediation modules will be deployed to a cluster that consists of WebSphere
ESB capable servers. Note that mediation modules can also be deployed to
WebSphere Process Server capable servers.

This process will show how to create a deployment environment from the
administrative console. The nodes to be included in the new environment must
already exist.
1. Determine the number of nodes you will need. If the nodes you will include
don’t exist, create a custom profile for each node using the Profile

Chapter 3. Creating profiles on distributed and i5/OS systems 81

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Management Tool or through the WebSphere Process Server installation

process with the following options:
– WebSphere Enterprise Service Bus or WebSphere Process Server profile
environment
– Custom profile type
– Advanced profile creation
– Federate the profile.
Complete the profile creation and start the new node.
2. In the administrative console, navigate to Servers → Deployment
environments. Click New.
3. Select the option to create a new deployment environment. Enter a name for
the deployment environment and select WPS or WESB as the runtime
capability.
Click Next.

Figure 3-28 Create a new deployment environment

4. Select the deployment environment type. Note that when you create a
deployment environment using the administrative console, you have an
additional option that allows you to build a custom deployment environment.

82 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-29 Select the environment type

5. Select the nodes to include in the new deployment environment. Note that the
nodes that exist are WebSphere Process Server (WPS) capable. WPS
capable nodes have the highest capability and can host application servers
with WebSphere ESB or WebSphere Application Server capability.
Click Next.

Chapter 3. Creating profiles on distributed and i5/OS systems 83

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-30 Select the nodes

6. Map the nodes to the target cluster type. In a single cluster environment, the
only option is the application deployment target.

Figure 3-31 Map the nodes to the cluster

84 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

7. The next step allows you to manage the database table configuration required
for the new environment.
In order to support several CEI server configurations, you need to configure a
different event database instance for each additional CEI server.
a. Using the database product, create a new database for the event
database. In this example, we created a database called WESBEVT.
b. Edit the WBI_CEI_EVENT configuration by selecting the checkbox to the
left of it and clicking Edit. Change the database name and update the user
ID and password required to access the new database.
Alternatively, you can set up different event database users for each CEI
server configuration for databases that map user IDs to schemas.

Figure 3-32 Specify the databases and schema

c. Click Next.
8. Enter the user ID and password to be used to create the authentication alias
for the event database.

Chapter 3. Creating profiles on distributed and i5/OS systems 85

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-33 Enter the user name and password that can access the event database

9. Review the selections and click Finish and Generate Environment.

10.If there are no errors, save click Save Changes.

3.3.7 Define the Web server to the cell

The last step in setting up the deployment environment is to define the Web
server to the cell. In this scenario, the Web server is on a system that does not
have a WebSphere node, and so is an unmanaged server. In this example, we
will use the administrative console to create the definitions, vs. using the scripts
generated when the plug-in was installed.

Adding an unmanaged node to the cell

To add an unmanaged node using the administrative console:
1. Select System Administration → Nodes in the console navigation tree.
2. Click Add Node.
3. Select Unmanaged node.
4. Click Next.
5. Enter the following values in the General Properties page. See Figure 3-34 on
page 87:
a. Name
Type a logical name for the node. The name must be unique within the
cell. A node name usually is identical to the host name for the computer.
However, you can make the node name different than the host name.
b. Host name
Enter the host name of the unmanaged node that is added to the
configuration.
c. Platform Type

86 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-34 General properties for an unmanaged node

6. Click OK. The node is added and the name is displayed in the collection on
the Nodes page.

Adding a Web server

Once the node for the Web server has been defined, you can add the Web server
definition. To add a Web server definition, do the following:
1. Select Servers → Web servers.
2. Click New. See Figure 3-35.
3. Select the node, enter the server name, and its type.

Figure 3-35 Defining a Web server: Step 1

Chapter 3. Creating profiles on distributed and i5/OS systems 87

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Click Next.
4. Select the template for Web server specification. Initially, this template will be
one supplied with WebSphere specific to the Web server type. Once you have
defined a Web server, you can make it a template for use the next time. See
Figure 3-36 on page 88.

Figure 3-36 Defining a Web server: Step 2

Click Next.
5. Enter the properties for the Web server. See Figure 3-37 on page 89.

88 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-37 Defining a Web server: Step 3

When defining a Web server hosted on a Windows operating system, use the
real service name instead of the display name. The service name does not
contain spaces. If you do not use the service name, you might have problems
starting and stopping the service.
6. Review the options and click Finish.
7. Save your changes.
8. View the status of the new server by selecting Servers → Web servers. If a
Web server is started or stopped using a native command, you might need to
refresh the view by clicking on the icon to see the new status. See
Figure 3-38.

Chapter 3. Creating profiles on distributed and i5/OS systems 89

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-38 Web server status

3.4 Augmenting a WebSphere ESB profile to WebSphere

Process Server
In the event that you create a WebSphere Application Server or WebSphere ESB
profile and discover that you need that profile to have additional function, you can
augment the profile.

This section shows an example of augmenting a WebSphere Enterprise Service

Bus stand-alone profile to a WebSphere Process Server stand-alone profile.
1. Start Profile Management Tool and click Augment.
2. The profiles that exist in your installation will be listed. Select the WebSphere
ESB stand-alone profile you want to augment.

Figure 3-39 Select the profile to augment

3. Select WebSphere Process Server as the profile type to augment the

existing profile to.

90 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunPattern.fm

Figure 3-40 Select the augmentation type

4. Select whether to take the typical or advanced path through the augmentation
process. The following table shows the options and results you will see
depending on which path you take.

Typical Advanced

Does not Configure sample Business Allow to choose whether to configure sample
Process Choreographer Business Process Choreographer

Does not Configure Business Rule Manager Allow to choose whether to configure
Business Rule Manager

Chapter 3. Creating profiles on distributed and i5/OS systems 91

7643RunPattern.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 3-41 Profile Management Tool

5. Review your selections and click Augment to complete the process.

92 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Chapter 4. Creating and managing

profiles on z/OS
The process for installation and profile creation on z/OS platforms differs from
those actions on distributed and i5/OS platforms. WebSphere Application Server
for z/OS serves as the base for WebSphere Process Server and is installed first.
The Network Deployment profiles are created next. Then WebSphere Process
Server is installed and the existing profiles are augmented for WebSphere
Process Server.

In this chapter we take you through the steps of creating a single cluster
WebSphere Process Server configuration on z/OS. This chapter assumes that
WebSphere Process Server has been installed using the instructions in the
WebSphere Information Center:
򐂰 Installing and configuring WebSphere Process Server
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/iins_zos_welcome.html

© Copyright IBM Corp. 2008. All rights reserved. 93

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

4.1 Methods of creating profiles

There are three main ways to create profiles on z/OS:
򐂰 Using the WebSphere Application Server for z/OS Profile Management Tool
(zPMT) available with the Application Server Toolkit (new with V6.1)
zPMT is a dialog tool that runs in the Application Server Toolkit. It is an
Eclipse plug-in that allows you to do the initial setup of WebSphere
Application Server for z/OS cells and nodes. It provides the same functionality
as the ISPF dialogs plus additional features to help you.
The zPMT itself does not create the cells and nodes; however, it creates
batch jobs, scripts, and data files that you can use to perform WebSphere
Application Server for z/OS customization tasks. These jobs, scripts, and data
files form a customization definition on your workstation, which is then
uploaded to z/OS where you submit the jobs. The zPMT is used to create
profiles and cannot be used to perform functions like delete or list profiles.
Only the manageprofiles command-line script interface can perform these
functions.
򐂰 Using the ISPF dialogs
The ISPF customization dialogs are deprecated and will be removed in a
future release, although you can still set up your profile through ISPF dialogs
in V6.1.
򐂰 Using the manageprofiles script interface

In the examples in this chapter, we are going to use the zPMT to create profiles.

Using zPMT requires that you have the Application Server Toolkit for V6.1
installed. For more information about how to download and install the Application
Server Toolkit, see the following URL:
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/
com.ibm.websphere.zseries.doc/info/zseries/ae/tins_astinstall.html

With zPMT, you have the following options:

򐂰 Create an application server profile
Generates the customization jobs to create a z/OS stand alone application
server.
򐂰 Create a cell profile (deployment manager profile and federated application
server)
Generates the customization jobs to create a z/OS deployment manager and
a federated node that contains an application server. This option only exists in
the zPMT.

94 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

򐂰 Create a deployment manager profile

Generates the customization jobs to create a z/OS deployment manager cell
without a federated application server.
򐂰 Federate an application server to a cell
Generates the customization jobs to federate an existing stand alone z/OS
application server into an existing network deployment cell.
򐂰 Create a managed (custom) node
Generates the customization jobs to create a z/OS managed node and
federate it into an existing network deployment cell.

All these options are also available through the ISPF Dialogs except the z/OS cell
(deploy manager and application server) that is unique to zPMT.

4.2 Topology
This chapter will build the topology shown in Figure 4-1.

CELL

csnodea csnodeb

WebSphere WebSphere Applications, including mediations

Process Process Messaging
Server Server Support

SC61 SC62 Cluster1

Dmgr

SC61

Figure 4-1 WebSphere Process Server topology on z/OS

The topology consists of a single cluster spread over two nodes for WebSphere
Process Server. You can configure the cluster for both business integration
modules and mediations.

Chapter 4. Creating and managing profiles on z/OS 95

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

4.3 Creating a deployment manager node

In this section, we are going to show how to use zPMT to create a deployment
manager. To create the profile, do the following:
1. Open the Application Server Toolkit and select Window → Preferences.
2. From the Preferences window, expand Server category and select
WebSphere for z/OS Customization.
3. Click on the Create button (on the top right corner).
The Welcome window for the Profile Management Tool will open. Note that
this window contains a link to the WebSphere Application Server V6.1
Information Center.
Click Next.
4. Select the appropriate configuration in the next panel, in this case, select
z/OS deployment manager and click Next.

Figure 4-2 Creating a profile: Environment selection window

5. The next window contains the following fields:

– Customization definition name: Used to specify the customization profile
you are about to create. This name is not transported to your host system.
– Customization definition directory: The location on your workstation where
the CNTL and DATA files will be stored, and from which they will be
uploaded to your host system.
– Response file path name: Allows you to specify a saved file with values
from a previously created configuration. Doing this populates the fields
throughout the windows with the values that are contained in the response
file. This field is optional. Since it is the first time you will be creating a
profile, you probably do not have this file. A response file is written each
time a z/OS customization definition is created and its name is the
customization definition name.responseFile. It is created under the root
directory for the customization definition. Normally, you should specify a

96 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

response file from a customization definition of the same type as you are
about to define. However, a response file from a similar customization type
can be used to pre-load most of the default values.

Figure 4-3 Customization name and location

After completing the required fields, click Next.

6. The next window asks you to specify a high level qualifier for the target z/OS
data sets that will contain the generated jobs and instructions.

Figure 4-4 Define target data sets

The high level qualifier can be composed of multiple qualifiers up to 39

characters. When a customization profile is uploaded on the target z/OS
system, the generated jobs and files are written on a pair of data sets. The
same data sets can be reused for a future installation; however, we strongly
recommend you create a new pair of data sets for every new profile
installation. A good planning and naming convention is crucial when defining
this type of information. For example, set the high level qualifier according to
the version and release of WebSphere Application Server for z/OS, the task
you are performing, and the cell (and, in some cases, the node name) you are
configuring.

Chapter 4. Creating and managing profiles on z/OS 97

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

The CNTL data set is a partitioned data set with a fixed block 80-byte records
that keeps the customization jobs. The DATA data set is a partitioned data set
as well, but with variable length data to contain the other customization data.

Note: Once the customization profile is created, the data set names cannot be
changed, since all jobs are based on these data set names.

After completing the HLQ field, click Next.

7. The next window contains the fields to configure common groups and users.

Figure 4-5 Configure common groups and users

You will find five main sections that you need to fill out on this window:
– WebSphere Application Server Configuration Group Information: Used to
specify the group name for the WebSphere Application Server
administrator user ID and all server user IDs.
– WebSphere Application Server file system owner Information: Specify the
user ID that owns the file system.

98 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

– WebSphere Application Server Servant Group Information: Used to

connect all servant user IDs to this group. You can use it to assign
subsystem permissions, such as DB2 authorizations, to all servants in the
security domain.
– WebSphere Application Server Local User Group Information: Specify the
local client group and unauthorized user IDs.This group provides minimal
access to the cell.
– WebSphere Application Server user ID home directory: Specify a new or
existing z/OS file system directory in which home directories for
WebSphere Application Server for z/OS user IDs will be created by the
customization process. Note that this directory does not need to be shared
among z/OS systems in a WebSphere Application Server cell.
After completing the required fields, click Next.
8. The next window asks for information about the z/OS system.

Figure 4-6 System Locations: Names and data set qualifier

– System name: The system name of the target z/OS system.

– Sysplex name: The sysplex name of the target z/OS system. If you are not
sure of the System and Sysplex names for your target z/OS system, you
can use the console command D SYMBOLS on the target z/OS system to
display them.
– PROCLIB data set name: The PROCLIB data set where the WebSphere
Application Server for z/OS cataloged procedures are to be added.

Chapter 4. Creating and managing profiles on z/OS 99

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

– WebSphere product data set high level qualifier: This name prepends your
system libraries, A multi-level high level qualifier can be specified as the
WebSphere product data set high level qualifier.

After completing the required fields, click Next.

100 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

9. The next window asks for the product data set location information. In this
window, you specify the product file system directory and the data sets.

In Version 6.1, most LPA-resident modules are merged into a single member in
SBBOLOAD, which is loaded into common storage for each node if SBBOLOAD
is not in LPA. The remaining module in SBBOLPA is BBORTS61, the CTRACE
support module for WebSphere Application Server Version 6.1, which should
always be loaded into LPA.

Figure 4-7 System Locations: Product data sets

– The SBBOLD2 data set is the WebSphere Application Server for z/OS
load module library that you installed through SMP/E. It has members that
should go into the link list, or into STEPLIB. Do not place them in LPA.
– The SBBOEXEC data set contains the WebSphere Application Server for
z/OS CLIST library.

Chapter 4. Creating and managing profiles on z/OS 101

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

– The SBBOMSG data set contains the WebSphere Application Server for
z/OS message skeletons for language translation.
– The WebSphere Application Server product file system directory is the
name of the directory where WebSphere Application Server for z/OS
product files reside after installation.
– The “run WebSphere Application Server from STEPLIB” check box
specifies whether to load WebSphere Application Server for z/OS load
modules from STEPLIB or from the link pack area and link list. The load
modules must be loaded from STEPLIB if you have another instance of
WebSphere Application Server for z/OS (Version 4 or later) in the system
link pack area or link list.
After completing the required fields, click Next.
10.The next window allows you to specify the long and short names to use for the
components of the profile.

Figure 4-8 Specify long and short names

– Cell short name: Identifies the cell to z/OS facilities, such as SAF.
– Cell long name: Specifies the primary external identification of this
WebSphere Application Server for this z/OS cell. This name identifies the
cell as displayed through the administrative console.
– Node short name: Specifies a name that identifies the node to z/OS
facilities, such as SAF.

102 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

– Node long name: Specifies the primary external identification of this

WebSphere Application Server for the z/OS node. This name identifies the
node as displayed through the administrative console.
– Cluster transition name: The WLM application environment (WLM
APPLENV) name for the deployment manager. If this is a server that is
converted into a clustered server, this name becomes the cluster short
name. The cluster short name is the WLM APPLENV name for all servers
that are of the same cluster.
After completing the required fields, click Next.
11.The next window contains the file system information for your z/OS system.
The file system can be either HFS or zFS.

Figure 4-9 System environment: configuration file system

– Mount point: The read/write HFS directory where application data and
environment files are written. The customization process creates this
mount point if it does not already exist.
– Name: The file system data set you will create and mount at the specified
mount point above.
– Volume, or '*' for SMS: Specify either the DASD volume serial number to
contain the above data set or "*" to let SMS select a volume. Using "*"
requires that SMS automatic class selection (ACS) routines be in place to

Chapter 4. Creating and managing profiles on z/OS 103

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

select the volume. If you do not have SMS set up to handle data set
allocation automatically, list the volume explicitly.
– Primary allocation in cylinders: The initial size allocation for the
configuration file system data set. In the application server, the total space
needed for this data set increases with the size and number of the
installed applications.The minimum suggested size is 250 cylinders
(3390).
– Secondary allocation in cylinders: The size of each secondary extent. The
minimum suggested size is 100 cylinders.
– File System type: Select to allocate and mount your configuration file
system data set using HFS or zFS.
After completing the required fields for the deploy manager configuration file
system, click Next.
12.The next window contains the following fields. Complete the required
information to set up the log stream.
– Error log stream name: The name of the WebSphere error log stream you
will create.
– Trace Parmlib member suffix: The value that is appended to CTIBBO to
form the member name for the CTRACE parmlib member.
After completing the required fields, click Next.
13.The next window allows you to enter the required information for the
deployment manager home directory.

Figure 4-10 Defining App_Server_Root

– Configuration file system mount point: Specifies the read/write file system
directory where the application data and environment files are written. This
field is not writable here, but was specified earlier on the configuration file
system information window (see Figure 4-9 on page 103).
– Deployment path name relative to mount point: Specifies the relative path
name of the directory within the configuration file system in which the
deployment manager configuration resides.

104 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

After completing the required fields, click Next.

14.The next window allows you to select the administrative console.We
recommend you select it.
After selecting the applications, click Next.
15.The next window allows you to define the job names, procedure names, and
user IDs to use for each process.
– Deploy manager controller process: The job name is specified in the MVS
START command JOBNAME parameter, associated with the control
region. This is the same as the server short name and it cannot be
changed during customization. The procedure name is the member name
in your procedure library to start the control region. The User ID is the user
ID associated with the control region.
– Deploy manager servant process: Specify the job name used by WLM to
start the servant regions. This is set to the server short name, followed by
the letter "S", and it cannot be changed during customization. The
procedure name is the member name in your procedure library to start the
servant regions. The User ID is the user ID associated with the servant
regions.
After completing the required fields, click Next.
16.The next window allows you to specify the ports to use for each process.
Once again, good planning is very important to avoid port conflicts, so be sure
you have all values you need in order to fill out this window. The required
fields for a deployment manager are:
– Node host name
– SOAP JMX connector port
– Cell Discovery Address port
– ORB Listener host name
– ORB port
– ORB SSL port
– HTTP transport host name
– Administrative console port
– Administrative secure console port
– High availability manager communication port

After completing the required ports, click Next.

17.The next window allows you to specify the location daemon settings. The
location daemon service is the initial point of client contact in WebSphere
Application Server for z/OS. The server contains the CORBA-based location
service agent which places sessions in a cell. All RMI/IIOP IORs (for example,
enterprise beans) establish connections to the location service daemon first,
then forward them to the target application server.

Chapter 4. Creating and managing profiles on z/OS 105

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

– Daemon home directory: Specifies the directory in which the location

service daemon resides. This is set to the configuration file system mount
point/Daemon and cannot be changed.
– Daemon job name: Specifies the jobname of the location service daemon,
specified in the JOBNAME parameter of the MVS start command used to
start the location service daemon. When configuring a new cell, be sure to
choose a new daemon jobname value. A server automatically starts the
location service daemon if it is not already running.
– Procedure name: Specifies the member name in your procedure library to
start the location service daemon.
– User ID: Specify the user ID associated with the location service daemon.
– UID: Specifies the user identifier associated with this user ID. UIDs must
be unique numbers within the system.
– IP name: Specifies the fully qualified IP name, registered with the Domain
Name Server (DNS), that the location service daemon uses. The default is
your node host name. In a sysplex, you should consider using a virtual IP
address (VIPA) for the location service daemon IP name. Select the IP
name for the location service daemon carefully. You can choose any name
you want, but, once chosen, it is difficult to change, even in the middle of
customization.
– Listen IP: Specifies the address at which the daemon listens. Select either
* or a dotted IP address for this value.
– Port number: Specify the port number on which the location service
daemon listens.
– SSL port: The port number on which the location service daemon listens
for SSL connections.

Note: Choose the IP name and port number carefully since it is difficult
to change, even in the middle of customization.

– Register daemon with WLM DNS check box: If you use the WLM DNS
(connection optimization), you must register your location service daemon.
Otherwise, do not register your location service daemon. Only one
location service daemon per LPAR can register its domain name with
WLM DNS; if you have multiple cells in the same LPAR and register more
than one location service, it will fail to start.
After completing the required fields, click Next.
18.The next window allows you to enter SSL configuration values.

106 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

– Certificate authority keylabel: Specifies the name that identifies the

certificate authority (CA) to be used in generating server certificates.
– Generate certificate authority (CA) certificate check box: Selected to
generate a new CA certificate. Do not select this option to have an existing
CA certificate generate server certificates.
– Expiration date for certificates: Used for any X509 Certificate Authority
certificates created during customization, as well as the expiration date for
the personal certificates generated for WebSphere Application Server for
z/OS servers. You must specify this even if you have not selected
Generate Certificate Authority (CA) certificate.
– Default SAF keyring name: Specifies the default name given to the
RACF® keyring used by WebSphere Application Server for z/OS. The
keyring names created for repertoires are all the same within a cell.
– Enable SSL on location service daemon check box: Select if you want to
support secure communications using Inter-ORB Request Protocol (IIOP)
to the location service daemon using SSL. If selected, a RACF keyring will
be generated for the location service daemon to use.
After completing the required SSL information, click Next.
19.The next window allows you to select the user registry to be used for
administrative security. You can choose from the following options:
– z/OS security product option: This option uses the z/OS system's SAF
compliant security product, such as IBM RACF or equivalent, to manage
WebSphere Application Server identities and authorization according to
the following:
• The SAF security database will be used as the WebSphere user
repository.
• SAF EJBROLE profiles will be used to control role-based authorization,
including administrative authority.
• Digital certificates will be stored in the SAF security database.

Note: Select the z/OS security product option if you are planning to use
the SAF security database as your WebSphere Application Server
registry or if you plan to set up an LDAP or custom user registry whose
identities will be mapped to SAF user IDs for authorization checking.
For this security option, you must decide whether to set a security
domain name, and choose an administrator user ID and an
unauthenticated (guest) user ID.

Chapter 4. Creating and managing profiles on z/OS 107

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

– WebSphere Application Server security option: The WebSphere

Application Server administrative security option is used to manage the
Application Server identities and authorization according to the following:
• A simple file-based user registry will be built as part of the
customization process.
• Application-specific role binds will be used to control role-based
authorization.
• The WebSphere Application Server console users and groups list will
control administrative authority.
• Digital certificates will be stored in the configuration file system as
keystores.

Note: Choose this option if you plan to use an LDAP or custom user
registry without mapping to SAF user IDs. (The file-based user registry
is not recommend for production use.)

– No security
Although it is not recommended, you may disable administrative security. If
you choose this security option, there are no other choices to make. Your
WebSphere Application Server environment will not be secured until you
configure and enable security manually. You can enable security manually
later via the administrative console or using Jython scripts.
Select an option and click Next.
20.The options in the next window depend on the security option you choose. In
this example, we chose the z/OS product option.
– Security domain identifier: (Optional) Used to distinguish between APPL
or EJBROLE profiles based on security domain name; provides an
alphanumeric security domain name of one to eight characters. Internally,
this sets SecurityDomainType to the string cellQualified.
All servers in the cell will prepend the security domain name you specify to
the application-specific J2EE role name to create the SAF EJBROLE
profile for checking. The security domain name is not used, however, if role
checking is performed using WebSphere Application Server for z/OS
bindings. The security domain name is also used as the APPL profile
name and inserted into the profile name used for CBIND checks. The
RACF jobs that the Customization Dialog generates create and authorize
the appropriate RACF profiles for the created nodes and servers. If you do
not want to use a security domain identifier, leave this field blank.
– WebSphere Application Server administrator user ID: The initial
WebSphere Application Server administrator. It must have the WebSphere

108 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Application Server configuration group as its default UNIX System

Services group. The UNIX System Services UID number for the
administrator user ID is specified here, and must be a unique numeric
value between 1 and 2,147,483,647.
– WebSphere Application Server unauthenticated user ID: Associated with
unauthenticated client requests. It is sometimes referred to as the "guest"
user ID. It should be given the RESTRICTED attribute in RACF, to prevent
it from inheriting UACC-based access privileges. The UNIX System
Services UID number for the user ID is specified here and is associated
with unauthenticated client requests. The UID value must be unique
numeric values between 1 and 2,147,483,647.
Click Next
21.The next window allows you to tailor the JCL for the customization jobs. Enter
a valid job statement for your installation on this window. The profile creation
process will update the job name for you in all the generated jobs, so you
need not be concerned with that portion of the job statement. If continuation
lines are needed, replace the comment lines with continuation lines.
After you are done with this window, click Next.
22.The last window shows a short summary of the customization, including
profile type and where the generated jobs will be stored. To change the
characteristics of this profile, click the Back button; otherwise, click Create to
generate your z/OS Customization jobs and a status window is shown after
clicking Create.
When zPMT is done, it will display a summary window that indicates whether
the jobs were created successfully or not. If the jobs were not created, a log
file containing failure information will be identified. If successful, the next step
in the z/OS customization process is to upload these jobs and the associated
instructions to a pair of z/OS partitioned data sets. To do this, click Finish to
return to the zWebSphere preference window and select Upload.

Chapter 4. Creating and managing profiles on z/OS 109

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-11 Creating a profile: Customization creation summary window

23.Now, on the main window, select the profile you have just create and then
click the Upload... button.
In the upload customization definition window enter the target z/OS system.
This must be fully qualified or the upload will fail.
Use the Allocate target z/OS data sets check box to specify whether to
allocate the data sets if they do not exist (box check). If the data sets exist and
are to be reused, clear the box.
24.You will see a progress information window while the upload is occurring.
Once the customization profile is uploaded, follow the instructions in the
BBOSSINS member of the CNTL data set. You can view this data set on the
host, or select the configuration and use the View... button.These instructions
will help you determine what jobs to run, the order to run them in, and the
expected results. It will also tell you how to start the environment once you are
done. From this point, the process is identical to that you would use with the
ISPF Customization Dialog process.

4.4 Creating a custom node

In this section, we are going to explain how to use the zPMT to generate the jobs,
scripts, and data files you need to create two custom nodes to be augmented for
WebSphere Process Server and then federated to the deployment manager.

Many of the choices you make here are similar to those made for the deployment
manager. This example will take you through the process and will describe
settings unique to a custom node configuration.

To create a custom profile, do the following:

110 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

1. Open the Application Server Toolkit and select Window → Preferences.

2. From the Preferences window, expand Server category and select
WebSphere for z/OS.
3. Click on the Create button (on the top right corner) and then click Next.
4. Select z/OS managed (custom) node and click Next.

Figure 4-12 Creating a profile: Environment selection window

5. Define a name for the customization definition and the location to store the
files.
If using a response file to populate values in the wizard, enter the name of the
response file. Response files created from previous configurations are stored
in customization_root/customization_definition_name.responseFile.

Figure 4-13 Creating a profile: customization name and location window

After completing the required fields, click Next.

6. Review and modify if necessary, the default values for GID, UID, cell and
system identifiers for naming conventions, and a specific port range to use.

Chapter 4. Creating and managing profiles on z/OS 111

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

7. Specify a high level qualifier for the target z/OS data sets that will contain the
generated jobs and instructions and click Next.

Figure 4-14 Creating a profile: target data sets window

8. The next window (Figure 4-15 on page 114) contains the fields to configure
common groups and users.

112 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

You will find five main sections that you need to fill out on this window:
– WebSphere Application Server Configuration Group Information: Used to
specify the group name for the WebSphere Application Server
administrator user ID and all server user IDs.
– WebSphere Application Server file system owner Information: Specify the
user ID that owns the file system.
– WebSphere Application Server Servant Group Information: Used to
connect all servant user IDs to this group. You can use it to assign
subsystem permissions, such as DB2 authorizations, to all servants in the
security domain.
– WebSphere Application Server Local User Group Information: Specify the
local client group and unauthorized user IDs.This group provides minimal
access to the cell.
– WebSphere Application Server user ID home directory: Specify a new or
existing z/OS file system directory in which home directories for
WebSphere Application Server for z/OS user IDs will be created by the
customization process. Note that this directory does not need to be shared
among z/OS systems in a WebSphere Application Server cell.
After completing the required fields, click Next.

Chapter 4. Creating and managing profiles on z/OS 113

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-15 Creating a profile: Configure common groups and users window

9. The next window asks for information about the z/OS system.

114 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Figure 4-16 Creating a profile: System Locations: Names and data set qualifier window

You can use the console command D SYMBOLS on the target z/OS
system to display the system and sysplex name.
After completing the required fields, click Next.
10.The next window asks for the product data set location information (see
Figure 4-17). In this window, you specify the product file system directory and
the data sets. The considerations here are the same as for the deployment
manager profile

Chapter 4. Creating and managing profiles on z/OS 115

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-17 zPMT - System locations

After completing the required fields, click Next.

11.The next window allows you to specify the long and short names for the cell
and the node.

116 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Figure 4-18 Custom node short and long names

– Cell short name: Identifies the cell to z/OS facilities, such as SAF.
– Cell long name: Specifies the primary external identification of this
WebSphere Application Server for this z/OS cell. This name identifies the
cell as displayed through the administrative console.
– Node short name: Specifies a name that identifies the node to z/OS
facilities, such as SAF.
– Node long name: Specifies the primary external identification of this
WebSphere Application Server for the z/OS node. This name identifies the
node as displayed through the administrative console.
After completing the required fields, click Next.
12.The next window (Figure 4-19 on page 118) contains the file system
information for the node configuration files. The file system can be either HFS
or zFS. It is used to hold WebSphere Application Server configuration
information.

Chapter 4. Creating and managing profiles on z/OS 117

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-19 zPMT - Configuration file system

After completing the required fields for the custom node file system, click
Next.
13.The next window contains the following fields. Complete the required
information to set up the log stream.
– Error log stream name: Specifies the name of the WebSphere error log
stream you will create.
– Trace Parmlib member suffix: Specifies the value that is appended to
CTIBBO to form the member name for the CTRACE parmlib member.
After completing the required fields, click Next.
14.The next window (Figure 4-20 on page 119) allows you to enter information
about the node.

118 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Figure 4-20 zPMT - Defining Directory,Host and Procedure Names

– Node host name: It define the host name where custom node locates
– Admin asynch operations procedure name: Specifies the JCL procedure
name of a started task that is launched by way of the START command by
application servers or node agents to perform certain asynchronous
administrative operations.
– Asynchronous Administration Task User ID: This user ID is used to run the
asynchronous administration operations procedure. It must be a member
of the WebSphere Application Server configuration group.
After completing the required fields, click Next.
15.The next window allows you to define the job names, procedure names, and
user IDs to use for each process.
– Controller process: The job name is specified in the MVS START
command JOBNAME parameter, associated with the control region. This
is the same as the server short name and it cannot be changed during
customization. The procedure name is the member name in your

Chapter 4. Creating and managing profiles on z/OS 119

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

procedure library to start the control region. The User ID is the user ID
associated with the control region.
– Controller adjunct process: Specify the name of member in your
procedure library that starts the control region adjunct. The User ID is the
user ID associated with the control region adjunct.
– Servant process: Specify the job name used by WLM to start the servant
regions. This is set to the server short name, followed by the letter "S", and
it cannot be changed during customization. The procedure name is the
member name in your procedure library to start the servant regions. The
User ID is the user ID associated with the servant regions.
After completing the required fields, click Next.
16.The next window allows you to specify the location daemon settings. The
location daemon service is the initial point of client contact in WebSphere
Application Server for z/OS. The server contains the CORBA-based location
service agent which places sessions in a cell. All RMI/IIOP IORs (for example,
enterprise beans) establish connections to the location service daemon first,
then forward them to the target application server.
– Daemon home directory: Specifies the directory in which the location
service daemon resides. This is set to the configuration file system mount
point/Daemon and cannot be changed.
– Daemon job name: Specifies the jobname of the location service daemon,
specified in the JOBNAME parameter of the MVS start command used to
start the location service daemon. When configuring a new cell, be sure to
choose a new daemon jobname value. A server automatically starts the
location service daemon if it is not already running.
– Procedure name: Specifies the member name in your procedure library to
start the location service daemon.
– User ID: Specify the user ID associated with the location service daemon.
– UID: Specifies the user identifier associated with this user ID. UIDs must
be unique numbers within the system.
After completing the required fields, click Next.
17.The next window allows you to enter SSL configuration values.
– Certificate authority keylabel: Specifies the name that identifies the
certificate authority (CA) to be used in generating server certificates.
– Generate certificate authority (CA) certificate check box: Selected to
generate a new CA certificate. Do not select this option to have an existing
CA certificate generate server certificates.
– Expiration date for certificates: Used for any X509 Certificate Authority
certificates created during customization, as well as the expiration date for

120 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

the personal certificates generated for WebSphere Application Server for

z/OS servers. You must specify this even if you have not selected
Generate Certificate Authority (CA) certificate.
After completing the required SSL information, click Next.
18.The next window allows you to select the user registry to be used for
administrative security. You can choose from the following options:
– z/OS security product option: This option uses the z/OS system's SAF
compliant security product, such as IBM RACF or equivalent, to manage
WebSphere Application Server identities and authorization according to
the following:
• The SAF security database will be used as the WebSphere user
repository.
• SAF EJBROLE profiles will be used to control role-based authorization,
including administrative authority.
• Digital certificates will be stored in the SAF security database.

Note: Select the z/OS security product option if you are planning to use
the SAF security database as your WebSphere Application Server
registry or if you plan to set up an LDAP or custom user registry whose
identities will be mapped to SAF user IDs for authorization checking.
For this security option, you must decide whether to set a security
domain name, and choose an administrator user ID and an
unauthenticated (guest) user ID.

– WebSphere Application Server security option: The WebSphere

Application Server administrative security option is used to manage the
Application Server identities and authorization according to the following:
• A simple file-based user registry will be built as part of the
customization process.
• Application-specific role binds will be used to control role-based
authorization.
• The WebSphere Application Server console users and groups list will
control administrative authority.
• Digital certificates will be stored in the configuration file system as
keystores.

Note: Choose this option if you plan to use an LDAP or custom user
registry without mapping to SAF user IDs. (The file-based user registry
is not recommend for production use.)

Chapter 4. Creating and managing profiles on z/OS 121

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

– No security
Although it is not recommended, you may disable administrative security. If
you choose this security option, there are no other choices to make. Your
WebSphere Application Server environment will not be secured until you
configure and enable security manually. You can enable security manually
later via the administrative console or using Jython scripts.
Select an option and click Next.
Click Next.
19.The next window allows you to input the related information about the
deployment manager which the custom node will be federated into:
– Configuration file system mount point: Specifies the read/write file system
directory where the application data and environment files are written. This
field is not writable here, but was specified earlier on the “System
Environment: Configuration file system information” window.
– Directory path name relative to mount point: Specifies the relative path
name of the directory within the configuration file system in which the
deployment manager configuration resides.
– Deployment manager host name: define the host name or IP address of
the deployment manager
– JMX SOAP port: The adding node request use it to connect deployment
manager
– Deployment manager security is enabled: Used to indicate whether
security enable in the deployment manager.If enabled, the user and
password need for federating.
– Node group name: The node group into which the node will be placed.
– ORB Listener IP Address: IP Address which the server’s ORB listen for
incoming IIOP request.
– ORB port: port for IIPO request that acts as the bootstrap port for this
server and also the port through which the ORB accepts IIPO request
– ORB SSL port: Port for secure IIOP requests.
Node agent definitions
– Server short name
– Server long name
– SOAP JMX connector port
– Node Discovery port
– Node Multicast Discovery port
– Node IPV6 Multicast Discovery port
– High availability manager communication port

122 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

20.The next window allows you to tailor the JCL for the customization jobs. Enter
a valid job statement for your installation on this window. The profile creation
process will update the job name for you in all the generated jobs, so you
need not be concerned with that portion of the job statement. If continuation
lines are needed, replace the comment lines with continuation lines.
After you are done with this window, click Next.
21.The last window shows a short summary of the customization, including
profile type and where the generated jobs will be stored. To change the
characteristics of this profile, click the Back button; otherwise, click Create to
generate your z/OS Customization jobs and a status window is shown after
clicking Create.
When zPMT is done, it will display a summary window that indicates whether
the jobs were created successfully or not. If the jobs were not created, a log
file containing failure information will be identified. If successful, the next step
in the z/OS customization process is to upload these jobs and the associated
instructions to a pair of z/OS partitioned data sets. To do this, click Finish to
return to the zWebSphere preference window and select Upload.
22.Now, on the main window, select the profile you have just create and then
click the Upload... button.
In the upload customization definition window (Figure 4-21 on page 124),
enter the target z/OS system. This must be fully qualified or the upload will
fail.
Use the Allocate target z/OS data sets check box to specify whether to
allocate the data sets if they do not exist (box check). If the data sets exist and
are to be reused, clear the box.
You will see a progress information window while the upload is occurring.

Chapter 4. Creating and managing profiles on z/OS 123

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-21 Creating a profile: Upload customization definition window

23.Once the customization profile is uploaded, follow the instructions in the

BBOSSINS member of the CNTL data set. You can view this data set on the
host, or select the configuration and use the View... button.
These instructions will help you determine what jobs to run, the order to run
them in, and the expected results. It will also tell you how to start the
environment once you are done. From this point, the process is identical to
that you would use with the ISPF Customization Dialog process.

Import Note: Don’t run job BBOWMNAN which is used to federate the custom
node into deployment manager. We will federate the custom node after
augmenting it for WebSphere Process Server.

24.Repeat these steps to create additional custom nodes. In our case, we

created two custom nodes. Example 4-1 on page 124 shows the response file
used to create the second node.

Example 4-1 example of 2nd custom node response file

create
cellName=csemptya

124 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

hostName=wtsc61.itso.ibm.com
nodeName=csnodea
profileName=default
profilePath=C:\download\AST\workspace\.metadata\.plugins\com.ibm.ws390.
pmt.config\profiles\csnodea61.1
templatePath=C:\download\AST\workspace\.metadata\.plugins\com.ibm.ws390
.pmt.config\profileTemplates\zos-managed
zAdjunctProcName=CSCRAA
zAdjunctUid=*
zAdjunctUserid=CSASRU
zAdminAsynchProcName=CSADMSH
zAdminAsynchTaskUid=*
zAdminAsynchTaskUserid=CSADMIN
zAdminSecurityType=websphereForZos
zBBOMSGName=BBCS6161.SBBOMSG
zBbgloadName=BBCS6161.SBBGLOAD
zBboexecName=BBCS6161.SBBOEXEC
zBboloadName=BBCS6161.SBBOLOAD
zBbolod2Name=BBCS6161.SBBOLD2
zBbolpaName=BBCS6161.SBBOLPA
zCaAuthorityExpirationDate=2010/12/31
zCaKeylabel=WebSphereCA
zCellShortName=CSEMPTYA
zConfigHfsName=OMVS.WAS61.CSCELL.CSNODEA.HFS
zConfigHfsPrimaryCylinders=450
zConfigHfsSecondaryCylinders=100
zConfigHfsVolume=TSTO34
zConfigMountPoint=/wascsconfig/cscell/csnodea
zConfigurationGroup=CSCFG
zConfigurationGroupGID=*
zControlProcName=CSACRA
zControlUid=*
zControlUserid=CSACRU
zCtraceParmlibSuffix=60
zDaemonHomePath=/wascsconfig/cscell/csnodea/Daemon
zDaemonJobName=CSDEMNA
zDaemonProcName=CSDEMNA
zDaemonUid=*
zDaemonUserid=CSACRU
zDefaultSAFKeyringName=WASKeyring.CSCELL
zErrorLogstreamName=CSCELL.ERROR.LOG
zFederateDmaNodeHostName=wtsc61.itso.ibm.com
zFederateDmaPort=9510
zFederateDmaPortType=SOAP
zFederateDmaSecurity=true

Chapter 4. Creating and managing profiles on z/OS 125

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

zFederateDmaSecurityPassword=csadmin
zFederateDmaSecurityUserID=CSADMIN
zFederateHamCommPort=9525
zFederateJmxSoapConnectorPort=9520
zFederateNodeAgentAfterFederation=true
zFederateNodeDiscoveryPort=9523
zFederateNodeIPv6MulticastDiscoveryPort=9526
zFederateNodeMulticastDiscoveryPort=9524
zFederateOrbListenerHostName=*
zFederateOrbPortName=9521
zFederateOrbSslPortName=9522
zFederateServerName=nodeagent
zFederateServerShortName=CSAGNTA
zFilesystemType=ZFS
zHFSOwnerUID=*
zHFSOwnerUserID=CSOWNER
zJobStatement1=(999,POK),'SC61',CLASS=A,REGION=0M,NOTIFY=&SYSUID
zJobStatement2=/*JOBPARM S=SC61
zJobStatement3=//*
zJobStatement4=//*
zLocalUserGroup=CSGUESTG
zLocalUserGroupGID=*
zNodeGroupName=DefaultNodeGroup
zNodeShortName=CSNODEA
zProclibName=SYS1.PROCLIB
zProductHlq=BBCS6161
zRunWasFromSteplib=true
zServantGroup=CSSRVG
zServantGroupGID=*
zServantProcName=CSASRA
zServantUid=*
zServantUserid=CSASRU
zSmpePath=/usr/lpp/zWebSphereCS/V6R1
zSysplexName=WTSCPLX1
zSystemName=SC61
zTargetHLQ=BBCS6161.EMPTY
zUserIDHomeDirectory=/var/WebSphere/home
zWasServerDir=AppServer

126 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

4.5 Configuring the deployment manager node

In this section you perform the following tasks to configure WebSphere Process
Server to the deployment manager (DMGR):
򐂰 Run the zSMPInstall.sh script against the deployment manager node to
prepare the cell for WebSphere Process Server functionality.
򐂰 Prepare DmgrDB2.rsp.
򐂰 Run the zWPSConfig.sh script to configure WebSphere Process Server in the
deployment manager.
򐂰 Create the necessary DB2 data objects using createDB.sh
򐂰 Take a backup of the configuration HFS datasets.

4.5.1 Run the zSMPInstall.sh

In this step you add the WebSphere Process Server product profiles into the
deployment manager’s configuration HFS using the zSMPInstall command.

The zSMPInstall.sh performs the following tasks:

򐂰 Creates symbolic links from the node’s configuration HFS to files in the
WebSphere Process Server product HFS.
򐂰 Updates the administration console to support WebSphere Process Server.
򐂰 Runs applyPTF to upgrade the configuration HFS if required.
򐂰 Copies the zWPSConfig.sh to dmgr_home/bin.

The zSMPInstall.sh script takes the following arguments:

򐂰 -smproot: The WebSphere Process Server product HFS is mount point, for
example, /usr/lpp/zWPS/V6R1.
򐂰 -runtime: The deployment manager’s config root directory, for example,
/WebSphere/V6R1/DeploymentManager.
򐂰 -install: The keyword to install the various symbolic links associated with
WebSphere Process Server into the WebSphere Application Server profile
directory.

To use zSMPInstall:
1. Stop the deployment manager.
2. Run the shell script wps_smpe_root/zos.config/bin/zSMPInstall.sh, where
wps_smpe_root is the path to WebSphere Process Server product SMP/E
install root. For example:

Chapter 4. Creating and managing profiles on z/OS 127

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

/usr/lpp/zWPSCS/V6R1/zos.config/bin/zSMPInstall.sh -smproot
/usr/lpp/zWPSCS/V6R1 -runtime /WebSphere/V6R1/DeploymentManager
-installs

Example 4-2 on page 128 shows the output you can expect.

Example 4-2 Stdout of zSMPInstall.sh

CWPIZ0253I: parsing command arguments...
CWPIZ0254I: parsing arguments complete
CWPIZ0255I: setting up configuration...
CWPIZ0256I: set up configuration complete
CWPIZ0257I: creating the symbolic links...
CWPIZ0259I: creation of symbolic links complete
CWPIZ0260I: doing post install file updates...
CWPIZ0262I: post install updates complete
CWPIZ0263I: running Configuration Manager update...
CWPIZ0264I: Configuration Manager update complete

4.5.2 Preparing DmgrDB2.rsp

In this step you prepare a response file that contains the input parameters used
by the zWPSConfig.sh script to customize the deployment manager
configuration and generate DB2 Data Definition Language (DDL) statements that
you are used later to define the databases to DB2.
1. Copy the DmgrDB2.rsp from the WebSphere Process Server’s product HFS,
for example, /usr/lpp/zWPSCS/V6R1/zos.config into a work directory, for
example, /u/ericyu/wpswork.
Using an OMVS or Telnet session, the following command will do this:
cp /usr/lpp/zWPSCS/V6R1/zos.config/DmgrDB2.rsp /u/ericyu/wpswork
2. Edit the new copy of DmgrDB2.rsp file to match the environment you are
setting up. Example 4-3 shows the DmgrDB2.rsp file that we used in our cell.

Note: The original version of DmgrDB2.rsp contains extensive comments,

but we have removed these in the example and instead added some notes
to highlight important points. You will need to read the comments and
consult the WebSphere Process Server Information Center in order to
understand the meaning of properties that are not self-evident.

Example 4-3 DmgrDB2.rsp

JMSUSER=csadmin
JMSPASS=csadmin

128 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

CONFIGSERVER=dmgr
DBPRODUCT=DB2UDBOS390_V8_1
DBLOCATION=DB8Q
DBPROPERTIES=/u/db8qu/properties
DBJDBCCLASSPATH=/usr/lpp/db2/d8qg/jcc/classes
DBUSER=csadmin
DBPASS=csadmin
DBHOSTNAME=wtsc61.itso.ibm.com
DBSERVERPORT=38310
SQLID=CSCELL
SQLDB=CSCELLDB
SQLSTO=CSDBSTO
augment
profileName=default
profilePath=/wascsconfig/cscell/dmgr/DeploymentManager/profiles/default
templatePath=/wascsconfig/cscell/dmgr/DeploymentManager/profileTemplate
s/dmgr.wbiserver
cellName=cscell
nodeName=csdm
enableAdminSecurity=true
adminUserName=$JMSUSER
adminPassword=$JMSPASS
serverName=$CONFIGSERVER
dbCreateNew=false
dbDelayConfig=true
configureScaSecurity=true
scaSecurityUserId=$JMSUSER
scaSecurityPassword=$JMSPASS
configureAppScheduler=false
appSchedulerServer=$CONFIGSERVER
dbName=$SQLDB
dbStorageGroup=$SQLSTO
dbType=$DBPRODUCT
dbConnectionLocation=$DBLOCATION
dbJDBCProperties=$DBPROPERTIES
dbJDBCClasspath=$DBJDBCCLASSPATH
dbUserId=$DBUSER
dbPassword=$DBPASS
dbHostName=$DBHOSTNAME
dbServerPort=$DBSERVERPORT
dbSchemaName=$SQLID

The following notes refer to the DmgrDb2.rsp response file in Example 4-3:

Chapter 4. Creating and managing profiles on z/OS 129

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

򐂰 The CONFIGSERVER global variable must be set to the long name of the
Network Deployment server you are configuring (see Figure 4-8 on
page 102).
򐂰 The DBLOCATION global variable is the location name (not the subsystem
name) of your DB2 system.
򐂰 Do not change the profile name from default. Only default is supported in
WebSphere Application Server for z/OS.
򐂰 The profilePath is the path to the /profiles/default directory under dmgr_home.
This property should be coded on one line but has been split across two lines
in order to fit on the page.
򐂰 The cellName, nodeName, and serverName tell the zWPSConfig.sh which
node to configure.You should make sure the cellName and nodeName are
long names you specified when you created the profiles.
򐂰 You must indicate the version of DB2 you are using with DBPRODUCT. Note
that if you are using DB2 V8.1, but it is running in compatibility mode with DB2
7.1,then you need to specify DB2UDBOS390_V7_1.
򐂰 SQLID is the schema name of database. SQLDB is the name of database
and SQLSTO is the storage group name of database.
򐂰 Set dbCreateNew=false because you will manually create the storage group
and databases.
򐂰 Set dbDelayConfig=true to create the database tables later.

Warning: The DmgrDB2.rsp response file contains the minimum number of

properties you need in the response file in order to configure the deployment
manager. Do not delete properties from the sample DmgrDB2.rsp even if you
want to allow them to take default values. Removing properties can cause the
script to fail.

4.5.3 Run the zWPSConfig.sh

Run the configuration script zWPSConfig.sh directly from USS with the absolute
path of your edited response file. For example:
zWPSConfig.sh -augment -response /working_directory_path/DmgrDB2.rsp

Where working_directory_path is the location of the DmgrDB2.rsp file.

When the script has finished running, review the messages that are written to the
console. If the script runs successfully, no error messages are displayed and the
informational messages state "augmenting profile(s) complete" (see
Example 4-4).

130 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Example 4-4 Stdout of zWPSConfig.sh

CWPIZ0253I: parsing command arguments...
CWPIZ0254I: parsing arguments complete
CWPIZ0255I: setting up configuration...
CWPIZ0256I: set up configuration complete
CWPIZ0265I: augmenting profile(s)...
INSTCONFSUCCESS: Profile augmentation succeeded.
CWPIZ0267I: augmenting profile(s) complete

4.5.4 Creating DB2 database objects using the createDB.sh script

Next, use createDB.sh script to create a database and populate it with the DB2
database objects that are required by WebSphere Process Server, including the
database objects used by SCA, Business Process Choreographer, and Common
Event Infrastructure.

The createDB.sh script is located in wps_smpe_root/zos.config/samples. To use

this script, do the following:
1. Copy the sample createDB.sh file to your working directory. For example:
cp /usr/lpp/zWPS/V6R1/zos.config/samples/createDB.sh
/u/ericyu/wpswork
2. Assign the appropriate permissions to the copy of the createDB.sh file:
chmod 755 createDB.sh
3. Customize the parameters in createDB.sh file as required by your system.
Example 4-5 shows the parameters for our installation:

Example 4-5 Customized parameters of createDB.sh

WAS_HOME=/wascsconfig/cscell/dmgr/DeploymentManager
LIBPATH=/usr/lpp/db2/d8qg/jcc/lib:$LIBPATH
export LIBPATH

SCRIPTHOME=`pwd`
export SCRIPTHOME
SKIP=0
INVALIDoption=0;

DBCREATE=true
DBUSESQLID=true

DBWPSCreate=true
DBBPCCreate=true

Chapter 4. Creating and managing profiles on z/OS 131

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

DBCEICreate=true
DBSIBCreate=true
DBGenerate=true

DBPREFIX=CS
DBSCOPE=S61

DBJDBCClasspath=/usr/lpp/db2/d8qg/jcc/classes
DBUSER=csadmin
DBPASSWORD=csadmin
DBJDBCProperties=/u/ericyu/wpswork
DBConnectionLocation=DB8Q
DBDelayConfig=false
DBHostName=wtsc61.itso.ibm.com
DBServerPort=38310
DBVOLUMES=TOTDB9
DBVCAT=DB8QU

CEIBP4K=BP0
CEIBP8K=BP8K0
CEIBP16K=BP16K0
CEISIZE=10

DBSTO=${DBPREFIX}DBSTO
DBSCHEMA=${DBPREFIX}CELL
DBNAME=${DBPREFIX}CELLDB

– WAS_HOME is set to the mount point of deployment manager

configuration system
– The values of DBSTO, DBSCHEMA, and DBNAME must be the same
values you specified for SIBSTO, SIBID, SQLDB in the DmgrDB2.rsp file.
– DBSCHEMA is the schema name of database schema. DBNAME is the
name of database and DBSTO is the storage group name of database.
4. Run the customized createDB.sh script from USS. For example:
createDB.sh +All

Note: For a list of parameters that you must customize and syntax, see

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/rins_zos_createdbscript.html

132 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

4.5.5 Back up the WebSphere configuration HFS datasets

Take a backup of the configuration HFS datasets before proceeding. Back up
both the deployment manager configuration HFS and the custom node
configuration HFS.

4.6 Configuring a custom node

In this section you perform the following tasks to configure WebSphere Process
Server in the un-federated custom node:
1. Run the zSMPInstall.sh script against the custom node to prepare the node
for WebSphere Process Server functionality.
2. Prepare the ManagedDB2.rsp response file.
3. Run the zWPSConfig.sh script to configure WebSphere Process Server in the
custom node.
4. Federate the custom node.
5. Configure and federate any additional custom nodes for the cell.
6. Take a backup of the configuration HFS datasets.

4.6.1 Running the zSMPInstall script

This step is very similar to the step performed against the deployment manager
node. You must execute the zSMPInstall.sh script from the custom node’s
wps_smpe_root/bin directory and you must set the -runtime property to the
custom node’s app_server_root/bin.

Example 4-6 shows an example of running the zSMPInstall script:

Example 4-6 Execute zSMPInstall.sh

/usr/lpp/zWPSCS/V6R1/zos.config/bin/zSMPInstall.sh -smproot
/usr/lpp/zWPSCS/V6R1 -runtime /wascsconfig/cscell/csnodeb/AppServer
-install

The zSMPInstall.sh script takes the following arguments:

򐂰 -smproot: The mount point for the WebSphere Process Server product HFS,
for example, /usr/lpp/zWPSCS/V6R1.
򐂰 -runtime: The custom node configuration root directory, for example,
/wascsconfig/cscell/csnodeb/AppServer.

Chapter 4. Creating and managing profiles on z/OS 133

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

򐂰 -install: The keyword to install the various symbolic links associated with
WebSphere Process Server into the WebSphere Application Server profile
directory.

Run zSMPInstall.sh against the custom node and check the output carefully
before proceeding.

Example 4-7 stdout output from a successful execution of zSMPInstall.sh

CWPIZ0253I: parsing command arguments...
CWPIZ0254I: parsing arguments complete
CWPIZ0255I: setting up configuration...
CWPIZ0256I: set up configuration complete
CWPIZ0257I: creating the symbolic links...
CWPIZ0259I: creation of symbolic links complete
CWPIZ0260I: doing post install file updates...
CWPIZ0262I: post install updates complete
CWPIZ0263I: running Configuration Manager update...
CWPIZ0264I: Configuration Manager update complete

4.6.2 Preparing ManagedDB2.rsp

This step is similar to the step you performed against the deployment manager
node. However, for a custom node, you use the ManagedDB2.rsp response file to
configure the custom node.
1. Copy the ManagedDB2.rsp from the WebSphere Process Server’s product
HFS (for example, /usr/lpp/zWPSCS/V6R1/zos.config) into a work directory,
for example, /u/ericyu/wpswork.
Using an OMVS or Telnet session, the following command will do this:
cp /wps_smpe_root/zos.config/ManagedDB2.rsp /<wpswork>
2. Edit the new copy of ManagedDB2.rsp file to match the environment you are
setting up. Example 4-8 on page 134 shows the ManagedDB2.rsp file that we
used in our custom node.

Example 4-8 ManagedDB2.rsp

####################################################################
####GLOBAL PROPERTIES
####################################################################
JMSUSER=csadmin
JMSPASS=csadmin
DBPRODUCT=DB2UDBOS390_V8_1
DBLOCATION=DB8Q
DBPROPERTIES=/u/db8qu/properties

134 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

DBJDBCCLASSPATH=/usr/lpp/db2/d8qg/jcc/classes
DBUSER=csadmin
DBPASS=csadmin
DBHOSTNAME=wtsc61.itso.ibm.com
DBSERVERPORT=38310
SQLDB=CSCELLDB
SQLSTO=CSDBSTO

####################################################################
# Common Properties
####################################################################
augment
####################################################################
# Profile name
####################################################################
profileName=default

####################################################################
# Profile path
####################################################################
profilePath=/wascsconfig/cscell/csnodeb/AppServer/profiles/default
####################################################################
# Template path
templatePath=/wascsconfig/cscell/csnodeb/AppServer/profileTemplates/
managed.wbiserver

####################################################################
# Cell name
cellName=csemptyb

####################################################################
# Node name
nodeName=csnodeb

####################################################################
# Create new or use existing database
dbCreateNew=false

####################################################################
# Delay Configuration of the database table and data source def
dbDelayConfig=true

####################################################################
# WBI Core Properties

Chapter 4. Creating and managing profiles on z/OS 135

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

####################################################################
configureScaSecurity=true
scaSecurityUserId=$JMSUSER
scaSecurityPassword=$JMSPASS
configureAppScheduler=false
dbName=$SQLDB
dbStorageGroup=$SQLSTO
dbType=$DBPRODUCT
dbConnectionLocation=$DBLOCATION
dbJDBCProperties=$DBPROPERTIES
dbJDBCClasspath=$DBJDBCCLASSPATH
dbPassword=$DBPASS
dbHostName=$DBHOSTNAME
dbServerPort=$DBSERVERPORT

– The DBLOCATION global variable is the location name (not the subsystem
name) of your DB2 system.
– Do not change the profile name from default. Only default is supported in
WebSphere Application Server for z/OS.
– The profilePath is the path to the /profiles/default directory under
app_server_root.
Notice that the cell name in the path is csemptyb rather than cscell
because the node has not yet been federated into the cell.
– These properties tell the zWPSConfig.sh which node to configure. The
cellName is not <xx>cell because you are augmenting the custom node,
which is not yet part of the cell. For our CS cell, the cell name of the
custom node is csnodeb. Similarly, there must not be a serverName
property in this response file because this is a custom node.
– You must indicate the version of DB2 you are using with DBPRODUCT.
Note that if you are using DB2 V8.1, but it is running in compatibility mode
with DB2 7.1,then you need to specify DB2UDBOS390_V7_1.
– Set dbCreateNew=false because you have already manually created the
storage group and databases.

Warning: The ManagedDB2.rsp response file contains the minimum

number of properties you need in the response file in order to configure the
custom node.

Do not delete properties from the sample ManagedDB2.rsp even if you

want to allow them to take default values. Removing properties can cause
the script to fail.

136 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

4.6.3 Running zWPSConfig.sh

You can run zWPSConfig.sh from a command line in OMVS or telnet.
Example 4-9 shows an example of running zWPSConfig.sh on a custom node.

Example 4-9 Running zWPSConfig.sh on a custom node

export LIBPATH=/usr/lpp/db2/d8qg/jcc/lib:$LIBPATH
/wascsconfig/cscell/csnodeb/AppServer/bin/zWPSConfig.sh -response
/u/ericyu/wpswork/ManagedDB2.rsp -augment

Run zWPSConfig.sh from app_server_root/bin, for example

/wascsconfig/cscell/csnodeb/AppServer/bin

Check the output from the zWPSConfig.sh. The zWPSConfig.sh takes anywhere
between 30 and 75 minutes to complete depending on your system’s
performance. The output should look like that in Example 4-10.

Example 4-10 Sample output from the zWPSConfig.sh script. for the custom node
CWPIZ0253I: parsing command arguments...
CWPIZ0254I: parsing arguments complete
CWPIZ0255I: setting up configuration...
CWPIZ0256I: set up configuration complete
CWPIZ0265I: augmenting profile(s)...
INSTCONFSUCCESS: Profile augmentation succeeded.
CWPIZ0267I: augmenting profile(s) complete

4.6.4 Federating a custom node

After the deployment manager and custom node have been augmented for
WebSphere Process Server you can federate the custom node into the cell.
There are two ways of federating a custom node into the deployment manager.
򐂰 Run the BBOWMNAN job created when you defined the profile, or
򐂰 Run addNode.sh

Before you begin to federate, you must make sure the deployment manager is
running.

Example 4-11 shows the addNode command:

Chapter 4. Creating and managing profiles on z/OS 137

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Example 4-11 Run addNode.sh to federate

app_server_root/profiles/deafult/bin/addNode.sh DM_HOST DM_PORT
-includeapps -nodegroupname DefaultNodeGroup -username xxADMIN
-password password -nodeagentshortname xxAGNT1 -repalcelog

򐂰 DM_HOST is the host name of deployment manager.

򐂰 DM_PORT is the soap_connector_address of the deployment manager. If you
don’t know the port number, you can login to the administrative console and
select System Administration → Deployment Manager → Ports.
򐂰 -username and -password are needed if administrative security is enabled.
򐂰 -nodeagentshortname: the short name of node agent.such as CSAGNTB in
this case.

The output should look like Example 4-12:

Example 4-12 Stand output of running addNode.sh

CSADMIN @
SC62:/wascsconfig/cscell/csnodeb/AppServer/profiles/default/bin>ericAdd
Node.sh
ADMU0116I: Tool information is being logged in file
/wascsconfig/cscell/csnodeb/AppServer/profiles/default/logs/addNode.log
CWPKI0309I: All signers from remote keystore already exist in local
keystore.
ADMU0001I: Begin federation of node csnodeb with Deployment Manager at
wtsc61.itso.ibm.com:9510.
ADMU0001I: Begin federation of node csnodeb with Deployment Manager at
wtsc61.itso.ibm.com:9510.
ADMU0009I: Successfully connected to Deployment Manager Server:
wtsc61.itso.ibm.com:9510
ADMU0507I: No servers found in configuration under:

/wascsconfig/cscell/csnodeb/AppServer/profiles/default/config/cells/cse
mptyb/nodes/csnodeb/servers
ADMU2010I: Stopping all server processes for node csnodeb
ADMU0024I: Deleting the old backup directory.
ADMU0015I: Backing up the original cell repository.
ADMU0012I: Creating Node Agent configuration for node: csnodeb
ADMU0014I: Adding node csnodeb configuration to cell: cscell
ADMU0016I: Synchronizing configuration between node and cell.
ADMU0018I: Launching Node Agent process for node: csnodeb
ADMU0020I: Reading configuration for Node Agent process: nodeagent
ADMU0022I: Node Agent launched. Waiting for initialization status.

138 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

ADMU0030I: Node Agent initialization completed successfully. Process id

is:000000800000008b
ADMU0308I: The node csnodeb and associated applications were
successfully added to the cscell cell.

4.6.5 Configure and federate secondary custom node

Depending on your topology, you maybe need to configure more than one
custom node. In our case, we configured and federated two custom nodes.

4.6.6 Back up the WebSphere configuration HFS datasets

Take another backup of the configuration HFS datasets before proceeding. Back
up both the deployment manager’s configuration HFS and the custom node’s
configuration HFS at the same time.

4.7 Creating a WebSphere Process Server cluster

Now that the augmented node has been federated into the cell you must define a
cluster with at least one server, where you will run a WebSphere Process Server
or WebSphere Enterprise Service Bus workload.

Clusters are created from the administrative console. Servers are added to the
cluster when you define it. The names and ports that you use when creating the
server should conform to your naming convention. If you are following the
guidance in WebSphere z/OS V6 -- WSC Sample ND Configuration and using
the spreadsheet provided with that document to plan your naming convention,
the worksheet for the stand-alone server will contain the names and ports you
should use when creating the server.

The following tasks define a WebSphere Process Server-enabled cluster or

server:
1. Add DB2 libraries to the STEPLIB of the servant and Adjunct region JCL
2. Add a cluster with two servers using the WebSphere Process Server
administration console.
3. Configure Service Component Architecture.
4. Configure Business Process Manager and Human Task Manager.
5. Configure Common Event Infrastructure.

Chapter 4. Creating and managing profiles on z/OS 139

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

4.7.1 Add DB2 libraries to the Servant and Adjunct JCL

If your DB2 system does not run with SDSNEXIT, SDSNLOAD, and SDSNLOD2
in LNKLST, update your WebSphere servant and adjunct JCL so that the
STEPLIB includes the customized DB2 SDSNEXIT, the SDSNLOAD, and the
SDSNLOD2.

If you do not have STEPLIB set correctly you will get the error shown in
Example 4-13, i issued in the adjunct caused by the service integration bus
failing during initialization. You can see similar messages in the servant region if
the servant cannot load the DB2 programs in SDSNLOD2.

Example 4-13 DB2 Error message when test data source

error message: BBOO0220E:
[SCA.APPLICATION.mdcell.Bus:mdnodea.mdsr01a-SCA.APPLICATION.mdcell.Bus]
CWSIS0002E: The messaging engine encountered an exception while
starting.
Exception: com.ibm.ws.sib.msgstore.PersistenceException:
Chapter 11. Troubleshooting 431
CWSIS1501E: The data source has produced an unexpected exception:
java.sql.SQLException: Failure in loading T2 native library
db2jcct2zos, reason: java.lang.UnsatisfiedLinkError:
/pp/db2v8/UK14852/jcc/lib/libdb2jcct2zos.so:
EDC5157I An internal error has occurred. (errno2=0x0BDF03B2)DSRA0010E:
SQL State = null, Error Code = -99,999DSRA0010E: SQL State = null,
Error Code = -99,999
com.ibm.ws.sib.utils.ras.SibMessage com.ibm.ws sib.utils.ras.SibMessage

Locate the JCL for your WebSphere cell in your system PROCLIB and change
the members with the Z suffix for the servant and the adjunct. For our CS cell, for
example, we added the STEPLIBs for the DB2 libraries to CSASRBZ (servant)
and CSCRABZ (adjunct) for nodeb and CSDSRZ (servant) for DM.

4.7.2 creating a cluster/server

If you want to create a cluster you start by defining the cluster using the
WebSphere Process Server Administration Console. During this process you
create the first WebSphere Process Server server by adding two cluster member
to the cluster.

Follow the instructions in this task to create a cluster with two cluster member
(server) in it.
1. Log in to the administration console and navigate to Servers → Clusters.
Click New.

140 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

2. Enter a cluster name. It is a very good idea to choose a cluster name that is in
lower case and prefixed by your two-character cell prefix.

Note: The cluster short name is important because RACF profiles in class
CBIND and SERVER control access to the members of a cluster.

You should have defined some RACF CBIND and SERVER profiles for
your cell when you defined your deployment manager.

If you followed the guidance in the WebSphere z/OS V6 -- WSC Sample

ND Configuration you should have created generic RACF profiles in the
form CB.*.MK*, which will be valid provided you used a cluster name that
was prefixed by your two-character cell prefix. If you chose some other
name you will need to define some CBIND and SERVER class profiles that
match the cluster name you have chosen.

Click Next.

Figure 4-22 Choosing a cluster name

3. Enter a name for the new server that will be created in the cluster.
The name that you specify here is the long name for the server. If you follow
the naming convention in WP100653 this will be the same as the short name
for the server but in lower case.

Chapter 4. Creating and managing profiles on z/OS 141

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Click the button for Default application server template and expand the
drop-down list box to select Default process server, as shown in
Figure 4-23.
Use the drop-down list box in the Select node field to choose the node in
which you wish to define the server, as shown in Figure 4-23.
Click Next

Figure 4-23 Setting server name and choosing the process server template

4. You will be given another blank form in which you can add another server to
the cluster. Enter the second server name in the Member name field and
select the node that will host the server.

142 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Click Add member. You should see the new server listed at the bottom of the
screen.
Click Next.

Chapter 4. Creating and managing profiles on z/OS 143

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-24 Create additional cluster members

5. On the Summary screen, check the details and click Next.

144 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

6. Save the configuration changes. You should now see the cluster listed as
shown in Figure 4-25.

Figure 4-25 Click the new cluster to update it

4.7.3 Configure Service Component Architecture

We will configure Service Component Architecture support from administrative
console with following steps:
1. Select Server → Cluster. Click on the cluster name to open the configuration
page. In the Business Integration section, select Service Component
Architecture.

Figure 4-26 Configuration Tab

Chapter 4. Creating and managing profiles on z/OS 145

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

2. Figure 4-27 shows the SCA configuration page.

Figure 4-27 Service Component Architecture Configuration Wizard

a. Check the “Support the Service Component Architecture

components” box. This will activate the Bus Member Location section.
b. Specify whether the SCA system bus (and, optionally, the SCA application
bus) destinations are hosted on the local deployment target or on a remote
target. Bus members are always hosted locally for stand-alone server
profiles.
• Local: Select this radio button if you want to create and host SCA
applications and their required messaging engines and JMS queue
destinations on the current cluster or server.

146 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

• Remote: Select this radio button to host SCA applications on the local
cluster or server while using a remote cluster or server to host the JMS
queue destinations and messaging engines.

Note: If you use the Browse Deployment Target page to add a new target to
the list and navigate away from the Service Component Architecture page
before completing your SCA configuration, that target is removed from the list.

c. If you select a remote deployment target, the appropriate information for

that target is shown in the System Bus Member panel. If the application
bus is enabled on the remote deployment target, the page also updates
the table in the Application Bus Member panel. If the application bus is not
enabled on the deployment target, you can enable it.
Specify the properties of the data source used by the SCA system bus.
This panel is active whenever you are creating a new SCA configuration
for the cluster or server and when you are editing the system bus data
source properties for a previous SCA configuration. Many fields in this
panel contain default values based on the WebSphere Process Server
and WebSphere Enterprise Service Bus Common database (by default,
WPRCSDB) configured on the deployment target you have selected. You
can accept these default values or edit them.
d. Use the Edit button in the System Bus Member section to specify the
database information for SCA. You will have the option to provide the
following information:
• Database Instance: Specifies the database instance used for this data
source. The value must be the name of an existing database instance.
• Schema: Enter the name of the database schema that contains the
tables for the system bus data source. This field is required if you are
creating a new data source with a database that supports schema
names. Each messaging engine stores its resources, such as tables, in
a single schema. Each database schema is used by one messaging
engine only. Although every messaging engine uses the same table
names, its relationship with the schema gives each messaging engine
exclusive use of its own tables.
• Create tables: Do not select this option.

Note: Use the wps_smpe_root/zos.config/samples/createDB.sh to create

these tables.

• User name and password to be used to connect to the system bus data
source.

Chapter 4. Creating and managing profiles on z/OS 147

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

• Server: Specify the name of the database server used by the system
bus.
• Provider: Specify the database provider type used to create the
messaging resources for the system bus.
e. Use the Test Connection button to verify that the data source can contact
and authenticate with the database. If a component manages the data
source, this test also verifies whether the data can be reached from the
configured scope and, if applicable, whether the schema is configured
correctly.
f. Use the Edit button in the System Application Bus Member section to
specify the database information for SCA. The configuration properties are
similar to those for the system bus, but in addition, you have the following
option.
• Select Enable the WebSphere Business Integration Adapter
components if you plan to deploy SCA applications that use
WebSphere Business Integration Adapters.

Note: Use the wps_smpe_root/zos.config/samples/createDB.sh to create

these tables.

3. After you input value, click “OK“ to finish configuring Service component
architecture.

Note: For more details, see the WebSphere Process Server V6.1 Information
Center:

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.web
sphere.wesb610.zseries.doc/doc/clusters/tadm_configscasupport.html

148 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

Note: If you encounter a message engine failure like following error:

“CWSIS0002E: The messaging engine encountered an exception while
starting. Exception:
com.ibm.ws.sib.msgstore.PersistenceException:
CWSIS1501E: The data source has produced an unexpected exception:
com.ibm.db2.jcc.b.SqlException: UNSUCCESSFUL EXECUTION CAUSED BY
AN UNAVAILABLE RESOURCE. REASON 00E7009A, TYPE OF RESOURCE 100,
AND RESOURCE NAME TEMP DATABASE“.

This problem indicates that either the TEMP database is not defined or that
its page size is not suitable for your use. Define a suitable TEMP database
for the DB2 Universal JDBC driver so that it will work correctly with DB2 for
z/OS.Work with the database administrator to ensure the following has
been done:

A TEMP database is created for each member of a data sharing group.

The TEMP database has a 32k page size by defining it in a 32K buffer
pool.

Refer to the following resources for further guidance on this problem:

򐂰 Code 00E7009A
http://publib.boulder.ibm.com/infocenter/dzichelp/v2r2/index.js
p?topic=/com.ibm.db2.doc.mc/msgs/code00e7009a.html

4.7.4 Configure Common Event Infrastructure

In this section, we will take you through the steps of configuring the common
event infrastructure for a cluster.
1. In the Business Integration section of the cluster’s configuration page, expand
Common Event Infrastructure and click on Common Event Infrastructure
Server.

Chapter 4. Creating and managing profiles on z/OS 149

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-28 CEI configuration

1. Select the Enable the event infrastructure server check box.

2. Specify the database you will use to store events emitted by the CEI service
on your server. Use the Edit button to update the configuration.
The following are common event database fields:
– Database Instance: Name of the database you are using for storing
CEI-emitted events.
– Schema: Not supported for the CEI event database. The CEI server does
not support dynamic database schemas for event databases on
distributed platforms.
In order to support several CEI server configurations, you need to
configure a different event database instance for each additional CEI

150 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

server. Alternatively, you can to set up different event database users for
each CEI server configuration for databases that map user IDs to
schemas.
– Create Tables: Do not select this option.

Note: Use the wps_smpe_root/zos.config/samples/createDB.sh to create

these tables.

– User name: User ID required by the database.

– Password: Password for the user ID required by the database.
– Server: Fully qualified IP address or name and, optionally, the port used by
the database
– Provider: the database vendor. If the CEI has not been configured, you
must select the database vendor. Once you configure the CEI, you cannot
edit the provider field.
Use the Test connection button to test the connection.
3. Use the Edit button to update the database configuration for the messaging
infrastructure:
– Database Instance: Name of the database you are using for CEI
messaging infrastructure.
– Schema: Name of the schema you will use with the CEI messaging
infrastructure database.
– Create Tables: Do not select this.

Note: Use the wps_smpe_root/zos.config/samples/createDB.sh to create

these tables.

– User name: User ID required by the database.

– Password: Password for the user ID required by the database.
– Server: Fully qualified IP address or name and, optionally, the port used by
the database
– Provider: The database vendor or file store. You must select a database
vendor from the menu if the CEI has not been configured. Once you
configure the CEI, you cannot edit the provider field.
Use the Test connection button to test the connection.

Chapter 4. Creating and managing profiles on z/OS 151

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

4. After you input value, click “OK“ to finish configuring Common event
infrastructure.

Note: For more details, see the following article in the WebSphere Process
Server Information Center:

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.web
sphere.cei.z.610.doc/doc/tcei_configceiconsole.html

4.7.5 Configuring the Business Flow and Human Task Managers

Note: For more information, see the following article in the WebSphere
Process Server Information Center.
򐂰 Business Process Choreographer configuration
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/co
m.ibm.websphere.bpc.z.610.doc/doc/bpc/help_bpcconfiguration/bpc_c
onfig.html

1. In the Business Integration section of the cluster’s configuration page expand

Business Process Choreographer and select Business Flow Manager.
2. In the containers section of this page, select Business Process
Choreographer Containers.
3. The configuration page contains properties for the databases to be used by
the business flow and human task managers. Use the Edit button to update
the configuration.
The following properties are for the Business Process Choreographer
database:
– Database Instance: The name of the database used by the Business Flow
Manager and Human Task Manager.
– Schema Name: The name of the schema to be used.You only need to
specify a schema name if you want to use your own schema instead of the
default schema.
– Create Tables: Do not select this.

Note: Use the wps_smpe_root/zos.config/samples/createDB.sh to create

these tables.

152 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

– User Name: A user ID that has the authority to connect to the database
and to modify the data.
– Password: The password for the data source user ID.
– Server: The address of the database server.Specify either the host name
or the IP address, and the port number.
– Provider: The JDBC provider for Business Process Choreographer.

Figure 4-29 BPC Data source configuration

Other items that can be configured on this page include:

򐂰 E-mail service for escalation of human tasks. We did not enable this function.
򐂰 Specify the mapping of functional roles to user IDs and groups, and the
authentication credentials necessary for Business Process Choreographer.

Chapter 4. Creating and managing profiles on z/OS 153

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 4-30 Security settings for the Business Process Choreographer

򐂰 Enable audit logging and Common Event Infrastructure (CEI) logging for the
Business Flow Manager and Human Task Manager.

Figure 4-31 Enable audit and CEI logging

򐂰 Set the context root for the Web services API of the SCA bindings.

Figure 4-32 Context root settings

154 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunInstzSeries.fm

򐂰 The data source for the Business Process Choreographer messaging engine.
If Use the default configuration is selected, the current configuration
settings of the SCA messaging engine will be used. To use different settings,
clear the check box to enable the other fields in this section.

Figure 4-33 Messaging engine settings

Chapter 4. Creating and managing profiles on z/OS 155

7643RunInstzSeries.fm Draft Document for Review June 3, 2008 1:55 pm

156 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

Chapter 5. Managing the runtime

environment
WebSphere Process Server administrative tools are provided by the underlying
WebSphere Application Server Network Deployment environment. In this
chapter, we will show common methods of managing the WebSphere Process
Server environment using some of the administrative tools available. It is by no
means, a complete guide to these tasks. Use this information to get started. We
would recommend that you also use the following resources:
򐂰 WebSphere Application Server for i5/OS Handbook: Version 6.1, SG24-7221
򐂰 WebSphere Application Server V6.1: System Management and
Configuration, SG24-7304
򐂰 WebSphere Application Server V6.1 information center.
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp
򐂰 WebSphere Process Server V6.1 information center.
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/welcome_top_wps.htm
򐂰 WebSphere Enterprise Service Bus V6.1 information center
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wesb.61x.root.doc/info/welcome.html

© Copyright IBM Corp. 2008. All rights reserved. 157

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

5.1 Administrative tools

WebSphere Process Server provides a variety of administrative tools for
configuring and managing your runtime environment. The choice of which
combination of administrative tools you will employ ultimately depends on the
size and complexity of your runtime environment. The administrative tools we will
discuss in this chapater are:
򐂰 Administrative console
Use the administrative console to perform the deployment and system
administration tasks through a Web interface.
򐂰 WebSphere scripting client (wsadmin)
The wsadmin tool is intended for production environments and unattended
operations.
򐂰 Command line tools
Using the command line tools, start and stop application servers, check
server status, add or remove nodes, and complete similar tasks.
򐂰 IBM Web Administration for i5/OS

The use of commands, scripting, and the administrative console is common

across the operating system platforms. In addition, there may be other methods
specific to an operating system for starting and stopping processes.

For example, on a Windows system, you have the option of registering a

WebSphere process as a Windows service when you create the profile. You can
start the process (application server, node, deployment manger) by starting the
service. You can also use the Windows Start menu to start or stop processes.
For example, you can start and stop the deployment manager using the Start
menu, for example:
Start → Programs → IBM WebSphere → Process Server 6.1 → Profiles →
profile_name → Start the deployment manager

On z/OS systems, processes can be started or stopped by managing the JCL

procedure for the process.

On i5/OS, you can use the IBM Web Administration for i5/OS to manage
processes.

158 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

5.1.1 Using commands

Command line tools enable you to perform management tasks including starting,
stopping, and checking the status of processes and nodes. These tools only
work on local servers and nodes. They cannot operate on a remote server or
node. To administer a remote server, you need to use the administrative console
or a wsadmin script that connects to the deployment manager for the cell in which
the target server or node is configured.

Command line tools are located in the WPS_install_root/bin directory. In addition,

there is a proxy version of each script that resides in each profile’s bin directory.
All command line tools function relative to a particular profile. If you run a
command from the WPS_install_root/bin directory, the command will run within
the default profile. You can specify a different profile using the -profileName
parameter. If you invoke a script from the bin directory of the profile, you do not
need to specify the -profileName parameter.

Installation and profile directory locations

Variables are used in this book to denote the location of a directory, file or
command. The meaning of these variables can differ based on whether you are
installing the product on a clean server or on one with an existing installation of
WebSphere Application Server, WebSphere Application Server Network
Deployment, WebSphere Process Server or WebSphere Enterprise Service Bus.
They can also differ depending on whether you are performing the installation as
a root (Administrator on a Windows® system) or non-root user.

For information on default directory locations for WebSphere Process Server,

including those used when the Network Deployment installation exists before the
WebSphere Process Server installation, see:
򐂰 Default installation directories for the product, profiles, and tools
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/doc/rins_installation_paths.html
򐂰 WebSphere Process Server file system directories (z/OS)
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.z.610.doc/doc/cins_zos_filesys.html

For information on WebSphere ESB installations, see the following Information

Center articles:
򐂰 Default installation directories for the product, profiles, and tools
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wesb610.doc/doc/rins_installation_paths.html
򐂰 WebSphere ESB file system directories (z/OS)

Chapter 5. Managing the runtime environment 159

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wesb610.zseries.doc/doc/cins_zos_filesys.html

In this book, we will use the following variables to denote the installation and
profile directory locations.
򐂰 WPS_install_root: Location of the WebSphere Process Server installation
򐂰 profile_root: Location of a WebSphere Process Server profile.

For simplicity, we will assume that the installation is a WebSphere Process

Server installation, that WebSphere Process Server and WebSphere Application
Server are intalled at the same time, and that a root user ID was used to perform
the installation. Using these assumptions, the default WPS_install_root
directories are:
򐂰 AIX: /usr/IBM/WebSphere/ProcServer
򐂰 HP-UX and Solaris: /opt/IBM/WebSphere/ProcServer
򐂰 Linux: /opt/ibm/WebSphere/ProcServer
򐂰 Windows: C:\Program Files\IBM\WebSphere\ProcServer
򐂰 i5/OS: /QIBM/ProdData/WebSphere/ProcServer
򐂰 z/OS:
The installation file systems for WebSphere Process Server and the
underlying WebSphere Application Server are stored in two different
locations.
The default location of the WebSphere Process Server installation file system
is /usr/lpp/zWPS/V6R1.
Tthe default location of the WebSphere Application Server installation file
system is /usr/lpp/zWebSphere/V6R1

The default profile_root directories are:

򐂰 AIX: /usr/IBM/WebSphere/ProcServer/profiles/profile_name
򐂰 HP-UX and Solaris: /opt/IBM/WebSphere/ProcServer/profiles/profile_name
򐂰 Linux: /opt/ibm/WebSphere/ProcServer/profiles/profile_name
򐂰 Windows: C:\Program
Files\IBM\WebSphere\ProcServer\profiles\profile_name
򐂰 i5/OS: /QIBM/UserData/WebSphere/ProcServer/profiles/profile_name
򐂰 z/OS: /WebSphere/V6R1/profile_name/config/bin

160 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

Using the QShell environment to enter commands in i5/OS

Qshell is a UNIX®-like environment that is available on i5/OS. There are several
ways to run QShell commands to ensure that you use (from the correct directory)
the correct version.
򐂰 Invoke the fully qualified path name of the script, where script_name is the
name of the script and parameters represents the parameters that are passed
to the script:
/QIBM/ProdData/WebSphere/ProcServer/bin/script_name parameters
򐂰 Invoke the script from the CL command line or from an i5/OS CL program,
where script_name is the name of the script, and parameters represents the
parameters that are passed to the script. To use this method, run the
STRQSH command, and specify the fully qualified path name of the script:
STRQSH CMD('/QIBM/ProdData/WebSphere/ProcServer/bin/script_name
parameters')
򐂰 Use the cd command to change to the bin directory:
cd /QIBM/ProdData/WebSphere/ProcServer/bin
Then run the script:
script_name parameters
In the script:
– script_name is the name of the script.
– parameters represents the parameters that are passed to the script.

To enter commands using the QShell environment, we preferred to issue the

commands from the profile_root/bin location to avoid having to use the
-profileName parameter. The process used to enter commands is:
1. Start a 5250 emulator session and sign on.
2. Start a QShell session with the STRQSH command.
3. Change to the profile home location:
cd profile_root/bin
4. Run the script.

5.1.2 Using the administrative console

The WebSphere administrative console is the graphical, Web-based tool that you
use to configure and manage an entire WebSphere cell. It supports the full range
of product administrative activities, such as creating and managing resources
and applications, viewing logs and traces, and so on.

Chapter 5. Managing the runtime environment 161

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

The administrative console is a WebSphere application, and is hosted on a

WebSphere process. Before using the process, the process hosting the console
application must be active.
򐂰 In a single application server installation, the console is hosted on the
application server, so you must start the server in order to reach the console.
򐂰 If you are working with a deployment manager and its managed nodes, the
console is hosted on the deployment manager. You must start it in order to
use the console.

In a WebSphere Process Server installation, the administrative console contains

additional functionality that allows you to manage WebSphere Process Server
and WebSphere ESB specific tasks.

Figure 5-1 The administrative console graphical interface

Non-secure administration access

If administrative security is not enabled, the console is accessed through a Web
browser through the following URL:
http://hostname:port/ibm/console

For example, http://localhost:9060/ibm/console.

162 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

You can gain access to the console without entering a user name. If you do enter
a name, it is not validated and is used exclusively for logging purposes and to
enable the system to recover the session if it is lost while performing
administrative tasks.

Secure administration access

If administrative security is enabled, the console is accessed through a Web
browser through the following URL (note the use of https:// versus http://):
https://hostname:port/ibm/console

You must enter an authorized user ID and password to log in.The actions that you
can perform within the console are determined by your role assignment.

Finding the administrative console port

This port used to access the console will vary, depending on the ports you
specified when you created the application server profile.

You can find the port numbers for an application server or deployment manager
in profile_root/logs/AboutThisProfile.txt. If the server is in the WebSphere
Integrated Test environment, you can find this in
WID_ROOT\pf\profile_name\logs\AboutThisProfile.txt. The file contains useful
information similar to that shown in Figure 5-2.

Figure 5-2 Find the port for the administrative console

Chapter 5. Managing the runtime environment 163

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

User IDs
The user ID specified during login is used to track configuration changes made
by the user. This allows you to recover from unsaved session changes made
under the same user ID, for example, when a session times out or the user
closes the Web browser without saving. The user ID for login depends on
whether WebSphere administrative security is enabled.
򐂰 WebSphere administrative security is not enabled.
You can enter any user ID, valid or not, to log in to the administrative console.
The user ID is used to track changes to the configuration, but is not
authenticated. You can also simply leave the User ID field blank and click the
Log In button.

Note: Logging in without an ID is not a good idea if you have multiple

administrators.

򐂰 WebSphere administrative security is enabled.

You must enter a valid user ID and password that has been assigned an
administrative security role.

5.1.3 Using IBM Web Administration for i5/OS

The IBM Web Administration for i5/OS interface combines forms, tools, and
wizards to create a simplified environment to set up and manage application
servers WebSphere Application Server that are currently configured on your
i5/OS. You can also view server properties forms, the administrative console, and
problem determination logs through this interface.

Note: Be aware that there are some limitations to managing your application
server environment using IBM Web Administration for i5/OS that include
managing profiles with administrative security enabled, managing deployment
managers, or managing federated nodes.

For detailed information about IBM Web Administration for i5/OS, visit the
following Web site, which is in the i5/OS V5R4 Information Center:
http://publib.boulder.ibm.com/infocenter/iseries/v5r4/index.jsp?topic=/
rzaie/rzaieconadmin.htm

You can start IBM Web Administration for i5/OS by using one of the following two
methods. One method uses the i5/OS command line, where you can type the
following command:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

164 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

The other method is to use iSeries Navigator as explained in the following steps:
1. Start iSeries Navigator.
2. In the iSeries Navigator left panel, expand My Connections → <your i5
host> → Network → Servers, and click TCP/IP.
3. From the list of servers that is displayed in the right panel, right-click HTTP
Administration, and select Start, as we show in Figure 5-3.

Figure 5-3 iSeries Navigator - HTTP Administration TCP/IP job

Chapter 5. Managing the runtime environment 165

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

After HTTP Administration is started, the QHTTPSVR subsystem is active.

Figure 5-4 shows the jobs that are running in this subsystem.

Figure 5-4 QHTTPSVR jobs

The next step is to open the IBM Web Administration for i5/OS GUI:
1. Navigate to the following Web address:
http://hostname:2001/
In the Web address, hostname is the host name or IP address of the i5/OS
server where the HTTP server was started. Port 2001 is the default port for
accessing IBM Web Administration for i5/OS. To view what port is assigned to
this interface on your system, use the WRKSRVTBLE command and find the
as-admin-http entry in the table.
2. When the login window opens, type a valid i5/OS user profile name and
password, and click OK.

Important: To be authorized to log into IBM Web Administration for i5/OS

application, the i5/OS user profile must have *IOSYSCFG special authority.

3. After a successful login, the i5/OS Tasks page is displayed, as shown in

Figure 5-5. To work with HTTP Server (powered by Apache) and the IBM

166 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

WebSphere Application Server profiles, click IBM Web Administration for

i5/OS.

Figure 5-5 i5/OS Tasks page

Important: We recommend that you install the latest HTTP Server for i5/OS
PTFs on your system, prior to using IBM Web Administration for i5/OS. See
the following Web site for more information:
http://www-03.ibm.com/servers/eserver/iseries/software/http/services
/service.html#PTF

Chapter 5. Managing the runtime environment 167

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

The IBM Web Administration for i5/OS start page displays, as shown in
Figure 5-6 on page 168.

Note: After you use IBM Web Administration for i5/OS for the first time, the
state is retained so you are not necessarily returned to the same window when
you next use IBM Web Administration for i5/OS.

Figure 5-6 IBM Web Administration for i5/OS start page

5.1.4 WebSphere scripting client (wsadmin)

The WebSphere administrative (wsadmin) scripting program is a powerful, text
console-based command interpreter environment that enables you to run
scripted administrative operations. The wsadmin administrative scripting program
supports two scripting languages, Jacl (deprecated) and Jython.

You can run the wsadmin tool in interactive and unattended mode. Use the
wsadmin tool to perform the same tasks that you can perform using the
administrative console.

168 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

Command assistance is available in the administrative console to map your

administrative activities to wsadmin scripting commands written in Jython. These
commands can be viewed from the console, and if you want, you can log the
command assistance data to a file. You can also allow command assistance to
emit Java Management Extensions (JMX™) notifications to the Application
Server Toolkit. The Application Server Toolkit has Jython development tools that
help you develop and test Jython scripts.

5.2 Managing stand-alone server environments

In a stand-alone server environment, you have one profile that describes the
runtime for one application server. The adminstrative console runs as an
application on that server.

A typical start-up sequence would be:

1. Start the application server using the startServer command. This will start
the administrative console also.
2. Log on to the administrative console.

5.2.1 Managing application servers

By default, the name of a stand-alone application server is “server1”. The server
must be started before you can access the administrative console.

Starting a server
The startServer command is used to start an application server.
򐂰 On a Windows platform:
cd profile_root
startServer server1 -user username - password password
For example:
cd WebSphere\ProcServer\profiles\SAServer\bin
startServer server1 -user username - password password
If you elected to register the server as a Windows service, you can start the
server by starting the service.
򐂰 On a Unix platform:
cd profile_root
startServer.sh server1 -user username - password password
For example, on an AIX system:

Chapter 5. Managing the runtime environment 169

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

cd /usr/IBM/WebSphere/ProcServer/profiles/SAServer/bin
startServer server1 -user username - password password
򐂰 On an i5/OS system:
STRQSH
cd profile_root/bin
startServer server1 -user username - password password
For example:
STRQSH
cd /QIBM/UserData/WebSphere/ProcServer/profiles/SAServer/bin
startServer server1 -user username - password password
You can also manage servers using the IBM Web Administration for i5/OS
tool.
򐂰 On a z/OS system:
Application servers on an i5/OS system can be managed from a UNIX
System Services (USS) environment.
Select uss (to switch to the USS environment)
cd profile_root/bin
startServer.sh server1 -user username - password password
For example:
cd /wascsconfig/cscell/csnodea/AppServer/profiles/default/bin
startServer.sh CSSR01A -user username - password password
The home directory path for the profile is specified in the zPMT configuration
(see Figure 4-10 on page 104 and Figure 4-20 on page 119).
A server can also be started by starting the JCL procedure:
S procname, JOBNAME=server_shortname,ENV=
cell_shortname.node_shortname.server_shortname

Stopping a server
The stopServer command can be used to stop an application server on
distributed and i5/OS platforms:
stopServer(.sh) server1 -user username - password password

Listing the server status

To list the status of the server:
serverStatus(.sh) server1 -user username - password password

or

170 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

serverStatus -all -user username - password password

On Windows platforms, you can also use the Start menu. You also have the
option when you create the profile to register the server as a Windows service. If
you choose this option, you can start the server by starting the service, or by
having the service start automatically.

5.3 Managing distributed environments

In a distributed environment, you have a deployment manager that acts as the
central administration point for the cell. The administrative console runs as an
application on the deployment manager. Application servers reside on nodes that
are managed by the deployment manager.

A typical start-up sequence would be:

1. Start the deployment manager using the startManager command. This will
start the administrative console also.
2. Start the nodes on each remote system using the startNode command.
3. Log on to the administrative console.
4. Start the application servers, clusters, and deployment environments using
the administrative console.

5.3.1 Managing the deployment manager

The deployment manager can be started and stopped with commands on all
operating systems. As with a stand-alone server, you have other options for
starting the deployment manager based on the operating system.

Starting the deployment manager with startManager

Using the startManager command from the profile_root/bin directory is the most
common way to start the deployment manager, as shown in Example 5-1.

Example 5-1 startManager command

C:\WebSphere\ProcServer\profiles\Dmgr01\bin>startManager -user userID
-password password
ADMU0116I: Tool information is being logged in file

C:\WebSphere\ProcServer\profiles\Dmgr01\logs\dmgr\startServer.log

Chapter 5. Managing the runtime environment 171

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

ADMU7701I: Because dmgr is registered to run as a Windows Service, the

request to start this server will be completed by starting the
associated Windows Service.
ADMU0116I: Tool information is being logged in file

C:\WebSphere\ProcServer\profiles\Dmgr01\logs\dmgr\startServer.log
ADMU0128I: Starting tool with the Dmgr01 profile
ADMU3100I: Reading configuration for server: dmgr
ADMU3200I: Server launched. Waiting for initialization status.
ADMU3000I: Server dmgr open for e-business; process id is 3528

Stopping the deployment manager

The deployment manager is stopped with the stopManager command, as shown
in Example 5-2.

Example 5-2 stopManager command

C:\WebSphere\ProcServer\profiles\Dmgr01\bin>stopManager
ADMU0116I: Tool information is being logged in file

C:\WebSphere\ProcServer\profiles\Dmgr01\logs\dmgr\stopServer.log
ADMU7702I: Because dmgr is registered to run as a Windows Service, the
request to stop this server will be completed by stopping the
associated Windows Service.
ADMU0116I: Tool information is being logged in file

C:\WebSphere\ProcServer\profiles\Dmgr01\logs\dmgr\stopServer.log
ADMU0128I: Starting tool with the Dmgr01 profile
ADMU3100I: Reading configuration for server: dmgr
ADMU3201I: Server stop request issued. Waiting for stop status.
ADMU4000I: Server dmgr stop completed.

Starting the deployment manager on z/OS (START command)

On z/OS, the deployment manager can be started using a JCL start procedure.
The exact command can be found in the BBOCCINS instruction member of the
JCL generated to create the profile.

For example:
START CSDCR,JOBNAME=CSDMGR,ENV=CSCELL.CSDM.CSDMGR

Where:
򐂰 CSDCR is the JCL start procedure.
򐂰 CSDMGR is the Job name.

172 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

򐂰 ENV is the concatenation of the cell short name, node short name, and server
short name.

Starting the deployment manager will start the following:

򐂰 A daemon. In our example, named CSDEMN. There will be one daemon per
cell per MVS image. One of the functions of the daemon server is to provide
the "location name service" for the cell. All daemons in the cell are fully aware
of all the objects in the cell and use the same port values.
򐂰 A controller region. In our example, named CSDMGR. The controller region
serves many functions, including acting as the endpoint for communications.
򐂰 A servant region. In our example, named CSDMGRS. The servant region
contains the JVM where the applications are run.
򐂰 If you are using messaging, you will also see a control region adjunct server
start.

Stopping the deployment manager on z/OS (STOP command)

To stop the deployment manager with a STOP command, use the following
format:
STOP dmgr_JOBNAME

For example:
STOP CSDMGR

Stopping the daemon server will stop all servers for that cell, and all the servers
on that daemon instance’s MVS image will be stopped in an order fashion. For
example:
STOP CSDEMN

5.3.2 Managing nodes

For the deployment manager to be able to manage nodes, the node agent on
each node must be started.

Starting a node agent

When a node agent is stopped, the deployment manager has no way to
communicate with it. Therefore, the node agent has to be started with the
startNode command run from on the profile node system.

Example 5-3 startNode command

C:\WebSphere\ProcServer\profiles\xpxv812Node01\bin>startNode -user
userID -password password

Chapter 5. Managing the runtime environment 173

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

ADMU0116I: Tool information is being logged in file

C:\WebSphere\ProcServer\profiles\xpxv812Node01\logs\nodeagent\startSe
rver.log
ADMU0128I: Starting tool with the xpxv812Node01 profile
ADMU3100I: Reading configuration for server: nodeagent
ADMU3200I: Server launched. Waiting for initialization status.
ADMU3000I: Server nodeagent open for e-business; process id is 6128

Starting a node on z/OS using the START command

To start a node agent on z/OS using the START command, use the following
format:
START nodeagent_procname,JOBNAME=server_shortname,
ENV=cell_shortname.node_shortname.server_shortname

For example:
S CSACRA,JOBNAME=CSAGNTA,ENV=CSCELL.CSNODEA.CSAGNTA

Stopping a node agent

To stop the node agent and leave the servers running, do the following,
depending on your preferred method.

From the administrative console, do the following:

1. From the administrative console, select System Administration →Node
Agents.
2. Check the box beside the node agent for the server and click Stop.

From a command prompt, use the stopNode command.

Example 5-4 stopNode command

C:\WebSphere\ProcServer\profiles\xpxv812Node01\bin>stopNode -user
userID -password password
ADMU0116I: Tool information is being logged in file

C:\WebSphere\ProcServer\profiles\xpxv812Node01\logs\nodeagent\stopSer
ver.log
ADMU0128I: Starting tool with the xpxv812Node01 profile
ADMU3100I: Reading configuration for server: nodeagent
ADMU3201I: Server stop request issued. Waiting for stop status.
ADMU4000I: Server nodeagent stop completed.

174 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

Note: Once you stop the node agent, the deployment manager has no way to
communicate with the servers on that node. The servers might be up and
running, but the administrative console is not able to determine their status.

Stopping a node on z/OS using the STOP command

To stop a node agent on z/OS, you can use the following command:
STOP nodeagent_JOBNAME

For example:
STOP CSAGNTA

Stopping a node (the node agent and servers)

You can use the administrative console to stop a node and its servers with one
action:
1. From the administrative console, select System Administration →Nodes.
2. Check the box beside the node and click Stop.

Restarting a node agent

You can restart a running node agent from the administrative console by doing
the following from the administrative console:
1. Select System Administration →Node Agents.
2. Check the box beside the node agent for the server and click Restart.

5.3.3 Managing servers and clusters from the administrative console

While application servers can be managed using commands, the simplest way is
to use the administrative console.

To manage an application server using the administrative console, navigate to

Servers → Application Servers. Check the box to the left of the servers you
want to manage, then click the appropriate button (Start, Stop, etc.)

Chapter 5. Managing the runtime environment 175

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 5-7 Managing application servers

You can also manage all the servers in a cluster simultaneously. Select
Servers → Clusters.

Figure 5-8 Managing clusters

And finally, you can manage all the clusters in a deployment environment
simultaneously. Select Servers → Deployment Environments.

176 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

Figure 5-9 Managing deployment environments

5.4 Managing the Web server plug-in configuration

The plug-in configuration file needs to be regenerated and propagated to the
Web servers when there are changes to your WebSphere configuration that
affect how requests are routed from the Web server to the application server.
These changes include:
򐂰 Installing an application
򐂰 Creating or changing a virtual host
򐂰 Creating a new server
򐂰 Modifying HTTP transport settings
򐂰 Creating or altering a cluster

The plug-in file can be regenerated manually using the administration tools. You
can also set up the plug-in properties of the Web server to enable automatic
generation of the file whenever a relevant configuration change is made.

To regenerate the plug-in configuration manually, you can either use the
administrative console, or you can issue the GetPluginCfg command.

5.4.1 Generating the plug-in with administrative console

To generate or regenerate the plug-in configuration file, do the following:
1. Select Servers → Web servers.
2. Click the box to the left of your Web server.
3. Click Generate Plug-in.

Chapter 5. Managing the runtime environment 177

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

4. Verify that the generation was successful by looking at the messages. A

success message will be accompanied with the location of the generated
plug-in configuration file:
profile_root/config/cells/<cell_name>/nodes/<web_server_node>/servers/<w
eb_server>/plugin-cfg.xml

To use the new plugin-cfg.xml, file you must propagate it to the Web server
system.

5.4.2 Enabling automated plug-in regeneration

The Web server plug-in configuration service by default regenerates the
plugin-cfg.xml file automatically. You can view or change the configuration
settings for the Web server plug-in configuration service.

To view or change the plug-in generation property, do the following:

1. Select Servers → Web servers.
2. Click your Web server.
3. Select Plug-in properties in the Additional Properties section.
4. View or change the Automatically generate the plug-in configuration file
option.
When selected, the Web server plug-in configuration service automatically
generates the plug-in configuration file whenever the Web server environment
changes. For example, the plug-in configuration file is regenerated whenever
one of the following activities occurs:
– A new application is deployed on an associated application server.
– The Web server definition is saved.
– An application is removed from an associated application server.
– A new virtual host is defined.
Whenever a virtual host definition is updated, the plug-in configuration file
is automatically regenerated for all of the Web servers.

5.4.3 Propagating the plug-in configuration file

After a plug-in configuration file is regenerated, it needs to be propagated to the
Web server.

The configuration service can automatically propagate the plugin-cfg.xml file to a

Web server machine if it is configured on a managed node, and to an IBM HTTP

178 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

Server if it is configured on an unmanaged node. For other scenarios, you must

manually copy the file to the Web server machines.

You can manually propagate the file by copying it from the application server
machine to the Web server machine, or you can do it from the administrative
console.

From a command window

To copy the file from one machine to another, do the following:
1. Copy the file:
profile_root/config/cells/<cell_name>/nodes/<web_server_node>/servers/<w
eb_server>/plugin-cfg.xml
2. Place the copy in this directory on the remote Web server machine:
<plugins_home>/config/<web_server>

From the administrative console

To propagate the plug-in configuration manually from the administrative console,
do the following:
1. Select Servers → Web servers.
2. Click the box to the left of your Web server.
3. Click Propagate plug-in.
4. Verify that the propagation was successful by looking at the messages.
If you are in doubt, check whether the plug-in configuration file has been
propagated to the Web server plug-in location by viewing it.

5.4.4 Activating the new plug-in configuration

The Web server binary plug-in module checks for a new configuration file every
60 seconds. You can wait for the plug-in to find the changes, or you can restart
the Web sever to invoke the changes immediately.

Tip: If you encounter problems restarting your Web server, check the
http_plugin.log file in <plug-ins_home>/config/<web_server> for information
about what portion of the plugin-cfg.xml file contains an error. The log file
states the line number on which the error occurred along with other details that
might help you diagnose why the Web server did not start.

Chapter 5. Managing the runtime environment 179

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

5.4.5 Enable automated plug-in propagation

The Web server plug-in configuration service by default propagates the
plugin-cfg.xml file automatically. To view or change the plug-in propagation
property, do the following steps.
1. Select Servers → Web servers.
2. Click your Web server.
3. Select Plug-in properties in the Additional Properties sub section.
4. View or change the Automatically propagate plug-in configuration file
option.

5.5 Viewing the JVM logs

SystemOut and SystemErr logs are created for every process (application server,
node agent, and deployment manager). These logs are known as JVM logs.
WebSphere Application Server writes to these logs. Applications can also write
to them by using the print(), println(), and printStackTrace() methods.

You can find the logs in the following directory:

profile_root/logs/process_name

You can also view and configure these logs through the administrative console.
To find the JVM logs, select Troubleshooting → Logs and Trace. Select the
process whose logs you want to configure, and then click JVM Logs. This view
has two tabs: Configuration and Runtime.

The Configuration tab allows you to change the location of the logs, the format,
file size, etc.

The Runtime tab allows you to view the logs. Click the View button to the right of
the log.

180 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643ManagingProfiles.fm

Figure 5-10 Viewing the JVM logs in the administrative console.

When applications are running in a cluster, you may not know which server in the
cluster is actually executing the application. In this case, you will need to browse
the log for each server in the cluster until you find what you are looking for.

For more information on WebSphere logs and tracing, see WebSphere

Application Server V6: Diagnostic Data, REDP-4085.

Chapter 5. Managing the runtime environment 181

7643ManagingProfiles.fm Draft Document for Review June 3, 2008 1:55 pm

182 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Chapter 6. Managing applications

This chapter will provide an overview of the basic tasks associated with
preparing WebSphere Process Server V6.1 and WebSphere ESB V6.1
production environments for the execution of modules and mediation modules. A
single cluster topology has been chosen as the example topology.

This chapter includes the following topics:

򐂰 “Scenario: Order Management System” on page 184
򐂰 “Planning for deployment” on page 184
򐂰 “Setting up the prerequisites for Order Management System” on page 189
򐂰 “Defining application resources” on page 191
򐂰 “Deploying applications” on page 208
򐂰 “Testing the application” on page 220

Order Management System scenario:

Much of the discussion in this chapter is based on the Order Management

System scenario discussed in Getting Started with WebSphere Process
Server and WebSphere Enterprise Service Bus Part 2: Scenario, SG24-7642.

© Copyright IBM Corp. 2008. All rights reserved. 183

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

6.1 Scenario: Order Management System

In sg24-7642, we designed and implemented the Order Management System
solution. This chapter will use that solution to illustrate the actions and
techniques used to plan and deploy a solution to a WebSphere Process Server
runtime environment.

6.2 Planning for deployment

In the planning phase, you will need to perform the following evaluation:
򐂰 Determine the various components that make up your application
򐂰 Determine the mutual dependencies of these components
򐂰 Determine the external system dependencies
򐂰 Determine requirements of any kind (operative system, hardware constraints)
򐂰 Determine your available and/or desirable hardware

The result of this exercise should help you build a deployment plan (i.e. in the
form of a UML deployment diagram) that defines where your application
components will be deployed.

Table 6-1 shows the results of this analysis for the Order Management System
scenario.

Table 6-1 Scenario application deployment systems

System name System description Requirements and constraints

Repository System Will host the application database. Apache Derby installed;
ORDERDB database created

Warehouse Availability Systems Three systems that each provide Minimum of WebSphere ESB capability on
warehouse availability information the servers since the Web services have
through a Web service. been implemented as mediation modules

E-mail Server System Provides an SMTP service for An SMTP Server installed
mailing.

DB Access System Provides access to the application WebSphere ESB capable server;
repository. Hosts the Connectivity with the Repository System
DBMSServiceMediation.

184 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

System name System description Requirements and constraints

Warehouse Split System Provides the warehouse order split WebSphere ESB capable server;
service. Hosts the Connectivity with the Warehouse
WarehouseAvailabilityMediation Availability Systems

Order Management System Hosts the core business process WebSphere Process Server capable
application, OrderManagement and server;
the e-mail module, EmailOutbound. Connectivity with the
򐂰 DB Access System
򐂰 Warehouse Split System
򐂰 Email Server System

Special Order Handling System Filters special order requests to be Windows platform (specific to the Flat File
sent to the file system (hosts configuration);
OrderPreProcessingMediation) WebSphere ESB capable server;
Forward regular order requests to the Connectivity with Order Management
OrderManagement System

Figure 6-1 shows a Deployment Diagram with the minimum collapsing systems
possible for deployment, based on Table 6-1. We will look at these requirements
and constraints in more detail in the next sections.

Chapter 6. Managing applications 185

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

<<device>>
:Enterprise Service Bus Special Order
{OS=Windows} Handling System

OrderPreProcessingMediation

Order Management
System
<<device>>
DB Access :Process Server
System
Email Server
System
OrderManagementProcess

<<device>>
:Email server
<<device>> <<device>>
:Enterprise Service Bus To: …
:Enterprise Service Bus From: …

DBMSMediation
WarehouseAvailabilityMediation

Warehouse Split
<<device>>
<<device>> System
<<device>> <<device>>
:Apache Derby :Enterprise :Enterprise
:Enterprise BusService
Service
Service Bus Bus
WarehouseAvailabilitySystem
WarehouseAvailabilitySystem
WarehouseAvailabilitySystem
Warehouses
ORDERDB <<web service>>
<<web<<web
service>>service>> Availability Systems

Figure 6-1 Scenario example deployment diagram, in a “completely remote” fashion

The next step is to lay out the topology we will use for the deployment of these
systems. The target deployment topology you will choose is typically based on
several factors such as:
򐂰 Hardware requirements for any specific system
򐂰 Hardware availability and characteristics
򐂰 Performance, scalability and failover requirements of your application.

The topology we will use is shown in Figure 6-2.

186 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Node1 Node2

WebSphere WebSphere Cluster1

Process Process
Server Server

Web
Server WPRCSDB

WebSphere WebSphere
ESB ESB
Dmgr

Figure 6-2 Single cluster topology pattern

The Web server handles all requests between the two clusters as well as the
initial request from the client. It uses the Web server plug-in to balance requests
among servers in each cluster.
1. When a request for the application comes into the system from a client, the
Web Server plug-in is used to forward the request to one of the servers in the
WebSphere ESB cluster for processing by the OrderPreProcessingMediation
application.
2. When a mediation running in the WebSphere ESB cluster needs to access a
WebSphere Process Server module (i.e. the OrderPreProcessingMediation
needs to access the OrderManagement), the request is routed to one of the
servers in the WebSphere Process Server cluster by the Web server plug-in.
3. When a module executing in the WebSphere Process Server cluster needs to
access a mediation module (i.e. the OrderManagement needs to access the
DBMS Mediation), the request is routed to one of the servers in the
WebSphere ESB cluster by the Web server plug-in.

Figure 6-3 shows the final deployment diagram for the Order Management
System using a single cluster topology. The topology is spread over two systems,
host1 and host2.

Chapter 6. Managing applications 187

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

<<cluster>>
:Process Server

OrderManagementProcess

<<device>> Email system

:Derby NS <<SMTP Server>>
host1
host2
ORDERDB

<<cluster>>
:Enterprise Service Bus

OrderPreProcessingMediation
DBMSMediation WarehouseAvailabilityMediation

WarehouseAvailabilitySystem
WarehouseAvailabilitySystem
WarehouseAvailabilitySystem
<<web service>>
<<web service>>
<<web service>>

Figure 6-3 Scenario example over single cluster pattern deployment diagram

The WebSphere Process Server cluster will host the OrderManagement, while
the WebSphere ESB cluster will host the mediation modules. Each cluster will
span over host1 and host2.

The E-mail system will be on the host1 machine, accessible from the WebSphere
Process Server cluster.

Note: If the e-mail system connectivity properties were set in the application
during development, remember to update the properties using WebSphere
Integration Developer to reflect the production e-mail server address and
repackage the module for deployment.

The properties can be found in the Binding tab in the Properties view for the
import component that calls the e-mail server.

188 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

The Repository system will be on host1 and will be accessed by the WebSphere
ESB cluster through a data source that will be configured in 6.3, “Defining
application resources” on page 191. Because we are deploying to a cluster, the
Derby Embedded provider used in the test environment is no longer feasible for
our deployment. So we must move the repository to a Derby Network Server.
Derby Network Server is available with a WebSphere Process Server and/or
WebSphere ESB installation. It mediates the access to the database through a
server that can be accessed from multiple clients, which is what we need in a
cluster environment. Not that Derby is not intended for production. In a
production system, you would need to plan to use the database product that
provides the function and performance that you require.

6.2.1 Setting up the prerequisites for Order Management System

In most cases a business integration application has some external system
dependencies. General examples include Enterprise Information Systems, Web
services (may be implemented using a wide variety of technologies), and
technologies or applications accessed through adapters.

In this phase, you must ensure these external systems are started, accessible,
working and configured as stated in the planning phase. You must also ensure
the topology required for hosting the modules and mediation modules is in place.
For the Order Management System the outcome of this phase is that host1,
host2, and the external systems are ready for use.

WebSphere runtime topology setup

The runtime topology for the Order Management System is shown in Figure 6-2
on page 187. We will assume that the components in this topology have been
built and are active so we can begin setting up and testing the prerequisite
systems.

External systems setup

We provided a list of the application systems and their requirements in the
Table 6-1 on page 184. We will now go through every system in that list and show
how we completed the preparation of the external systems.

Special Order Handling System setup

The Special Order Handling System hosts the OrderPreProcessingMediation.
This mediation receives the request for an order sent by a client. It filters the
incoming order, placing special order requests on a file system, and forwarding
regular order requests to OrderManagement in the Order Management System.

Chapter 6. Managing applications 189

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

To prepare this system, you must create the file system defined by the flat file
adapter implementation.

Because the decision was made to put the flat files to a local Windows file
system, it is assumed The Special Order Handling System will run on a Windows
platform. The Flat File Adapter is configured to put files to a local folder
C:\ITSOSpecialOrders. Since we know the entire OrderPreProcessingMediation
will be later deployed over a WebSphere ESB cluster, we must ensure this single
folder will be accessible from every cluster member. A possible solution to such a
requirement would be a shared file system or a shared folder with the same
name on every cluster machine. This requirement can be changed by
reconfiguring the Flat File adapter.

Repository System setup

The Repository System must have an Apache Derby Network Server installed
and running. The application repository, the ORDERDB database, must be
created.

Apache Derby is a lightweight database included in every WebSphere Process

Server V6.1 and WebSphere ESB V6.1 installation. We chose this database type
because it is readily available to users of these products. However, Derby is not
intended to be used in a production environment.

The database provider is something that you will want to decide early in the
process. Databases created on one type of provider may not be easily migrated
to another. The database must be created on the selected provider system
before configuring the JDBC adapter.

Changing the database provider type after development is complete will involve
the following steps:
򐂰 The database must be migrated from one type of provider to another.
򐂰 The JDBC adapter configuration must be changed in order to use the new
provider.
򐂰 The runtime resources (JDBC provider and data source) must be configured.

For the Order Management System, using Derby, the repository will be prepared
for the production environment on host1 as follows:
1. Create the database.
The ORDERDB database is created and populated with data in the following
location:
C:\itso\sampleDB\ORDERDB
2. Start the Network Server server:

190 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

derby\bin\networkServer\startNetworkServer.bat

E-mail Server System setup

The E-mail Server System must have an SMTP server installed, configured,
running and working. In our case, we installed an SMTP server on host2.

The E-mail Server location and port is configured within the E-mail Adapter
configuration, which in our case, is in the OrderManagement module.

Setting up the remaining systems

The following systems will host the business integration and mediation modules.
They don’t have any external requirements but must have the following network
connectivity:
򐂰 The Order Management System machines must be able to connect to the
E-mail system.
򐂰 The DB Access System will access the Repository system using a data
source. We will describe data source setup in 6.3, “Defining application
resources” on page 191 and will check the connectivity to the database then.
򐂰 The Warehouse Split Systems machines must be able to connect to
Warehouse Availability Systems.

6.3 Defining application resources

This section will discuss defining resources required by your applications to the
runtime environment. These resources include data sources for access to
databases, a user registry and authentication aliases for security, and JMS
resources for messaging.

6.3.1 Setting the resource scope

Resources are defined at a scope level in the WebSphere Process Server
configuration. The scope can be one of the following:
򐂰 Cell: The resource is available to all servers in the cell
򐂰 Node: The resource is available to all servers in the node
򐂰 Cluster: The resource is available to all servers in the cluster
򐂰 Server: The resource is only available to a specific server
򐂰 Application: The resource is only available to an application and applies only
to enhanced EAR files.

Chapter 6. Managing applications 191

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

When you define a resource you will select the most appropriate scope. For
example, JDBC providers provide the location of the driver classes. If the location
of these files vary between systems, you would define a JDBC provider for each
node that requires access to a database and then define a data source for the
database to each JDBC provider at the node level.

Resources that are defined at more specific scopes override duplicate resources
that are defined at more general scopes. For example, if a JDBC provider is
defined at both the cell and node scope, a server in that node would use the
JDBC provider defined at the node scope. A server that is not in that node would
use the JDBC provider defined at the cell scope.

6.3.2 Defining security credentials to access a resource

An application that accesses a resource will often have to pass credentials to the
resource manager to gain access to the resource. For example, when the JDBC
adapter accesses a database, it will most likely need to provide a user ID and
password with the appropriate authorities to read and write from the database.
The best way to pass these credentials is to define them in a J2C authentication
alias and then have the resource configuration point to the appropriate alias. A
J2C authentication alias simply contains a user name and password.

Example: Authentication alias for ORDERDB

For the Order Management System, we will need an authentication alias defined
with the user ID and password required to access the ORDERDB database.

To define a J2C authentication from the administrative console, do the following:

1. Select Security → Secure administration, applications and
infrastructure. On the right of the security configuration page in the Java
Authentication and Authorization Services section, select J2C
Authentication data.
Note that most resource configuration pages also contain a shortcut to the
J2C authentication alias page. Also note that there is no scope selection
required. J2C aliases are available at the cell scope.
2. Click New to create a new alias.
3. Enter an alias name, and the user ID and password required to access the
resource and click OK. Save the configuration.

192 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-4 J2C Authentication alias properties

When the alias is stored, the name you specify will be appended to the node
name for the deployment manager. For example, in this case, the node name for
the deployment manager is kpmgyw0CellManager01. The name the alias will be
stored under is kpmgyw0CellManager01/OrderManagementAuthAlias.

6.3.3 Defining JDBC resources

JDBC providers and data sources provide access to databases. A JDBC provider
configuration contains a pointer to the implementation classes for a specific
vendor database. Multiple data source configurations can be associated with a
JDBC provider, one for each database of that type that deployed applications will
need to access.

To define a database, you will need to configure the following:

򐂰 A JDBC provider that defines the location of the Derby driver classes and
connection pool properties.
򐂰 A data source that defines the database properties. The configuration
includes a pointer to a J2C authentication alias.

Chapter 6. Managing applications 193

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

򐂰 A J2C authentication alias that contains the credentials needed to access the
database.

Example: JDBC resources for DBMSServiceMediation

The DBMSServiceMediation application in the Order Management System
accesses a Derby database called ORDERDB. Because the mediation will be
deployed to a cluster, we will need an Apache Derby Network Server JDBC
provider. This type of provider is actually configured using a DB2 Universal JDBC
Driver Provider (XA) JDBC provider.

Attention: That’s right, a DB2 JDBC provider is needed for Derby Network
Server. While a Derby JDBC provider is used for accessing a Derby
Embedded database. The DB2 JDBC provider is compatible with Derby
Network Server.

Creating a JDBC provider to access the Derby Network provider

To create a JDBC provider using the administrative console, do the following:
1. Select Resources → JDBC → JDBC Providers.
2. Select the scope and click New.
In the Order Management System environment, conventions have been used
to ensure that products are installed on every system in the same location.
We also have an environment that consists entirely of Windows systems. This
means that the DB2 product is installed in the same location on every system
and we can use the cell scope. If we add new systems later that reside on
different platforms, we can create a new JDBC provider at the node scope for
that system type.

194 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-5 Create a new JDBC provider

3. Select the database type and the provider options. Click Next.

Chapter 6. Managing applications 195

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-6 Select the provider type

4. Enter the information required for the provider to find the driver classes. This
panel will contain default properties based on the selections made in the
previous screen.
Variables are used in the default specifications. Depending on the provider
you selected, you may have the option to set the values for them on this
panel. If there are variables used that you can’t set on this panel, or you aren’t
sure how setting the values here might affect other applications, you can
configure these variables after you have created the JDBC provider. Variables
can be viewed and edited in the console by selecting Environment →
WebSphere variables.
Click Next.

196 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-7 Enter the implementation class information

5. Review your settings and click Finish. The new provider will be displayed in
the list of JDBC providers. Save your configuration.

Chapter 6. Managing applications 197

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-8 JDBC Provider at cell level for the example application

Creating a data source for the ORDERDB database

Now that the provider is in place, a data source must be configured for the
database.

To create a new data source:

1. Select Resources → JDBC → Data sources.
2. Set the scope that you created the JDBC provider at and click New.
3. Enter the basic properties for the data source:
– A name for the data source.
– The JNDI name the applications will use to access the database
– The authentication alias that contains the credentials for the database.
Note that when the authentication alias was created the name you
provided has been prepended with the cell name.
Click Next.

198 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-9 Enter the basic properties for the data source

4. Select the JDBC provider and click Next.

Figure 6-10 Select the JDBC provider

Chapter 6. Managing applications 199

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

5. Enter the database properties:

g. The server address and port must correspond to the database server.
Typically, the port for a DB2 server is 50000. In this case, we specify the
address and port of the Derby Network Server.
h. The database name. For Derby locations, the name corresponds to the file
location of the database. Click Next.

Figure 6-11 Specify the database properties

6. Review your settings and click Finish.

7. Save the configuration and test the connection using the Test connection
button.

6.3.4 Defining users and groups

If your application contains human tasks, you will need to populate the user
registry with the users and groups used by the application.

A user registry, referred to as a repository, contains information about users and

groups. This information is used during runtime to perform security-related
functions, including authentication and authorization. WebSphere Application
Server based runtimes support the following user repository types:
򐂰 Local operating system

200 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

򐂰 Standalone LDAP registry

򐂰 Standalone custom registry
򐂰 Federated repositories, which can include a file-based repository managed by
WebSphere

Federated repositories enable you to use multiple repositories, which can be

file-based repositories, LDAP repositories, or a sub-tree of an LDAP repository.
These repositories are combined under a single realm. All repositories are
active and user IDs must be unique within the federated repositories. You can
add more user registries to the federated repository via the administrative
console. Users and groups in a federated repository can be managed using the
administrative console.

Note that WebSphere Application Server federated repositories do not support a

z/OS LDAP server with an SDBM back-end (resource access control facility
(RACF).

Security repositories can be configured from the administrative console by

selecting Security → Secure administration, applications and infrastructure.

You can use the Security Configuration wizard to assist you in defining your
configuration. Or you can use the options in the User account repository area to
configure and select an active repository.

Note: Enabling administrative security during profile creation automatically

creates a federated repository with one file-based repository and makes this
the active repository.

Once the repository is in place, define the users and groups expected by the
human task.

Chapter 6. Managing applications 201

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-12 Configure repositories

Example: Federated repository for Order Management System

In the Order Management System, the human task will require users and groups
to be added to the repository. Because we are using a federated repository, this
can be done through the administrative console.

Groups
Start by creating groups that will hold users with identical authorities. In the
administrative console, select Users and Groups → Manage groups. This
panel allows you to create new groups, search for existing groups. Figure 6-13 on
page 203 shows the groups used in the Order Management System solution.

202 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-13 Manage groups in the federated repository

Click on a group name to display or add members.

Chapter 6. Managing applications 203

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-14 Group properties

To add users to the repository, select Users and Groups → Manage users.
Figure 6-15 on page 205 shows the users defined for the Order Management
System solution.

204 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-15 Users defined to the federated repository

Click on a user name to display or change the properties for the user.

Chapter 6. Managing applications 205

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-16 User properties

Click on the Groups tab to display the groups the user belongs to and to add or
remove the user from groups.

206 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-17 User properties: Group memberships

6.3.5 JMS resources

When an import or export uses a messaging binding (JMS or MQ), it assumes a
corresponding queues or topics have been created on the underlying messaging
provider.

MQ bindings
When you create an MQ binding, you specify the information required to connect
to the WebSphere MQ queue manager and the queue. These resources must be
defined in the WebSphere MQ installation.

JMS bindings
When you create a JMS binding, you specify the JNDI name of the send and
receive queues and topics. Two types of resources must be defined:
1. The queues or topics must be defined to the messaging provider.
If you are using the WebSphere default messaging provider, queues and
topics are defined as destinations on the service integration bus. You can use
the default SCA application bus that is created with the deployment

Chapter 6. Managing applications 207

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

environment, or you can create a new bus. Buses and destinations are
created from the administrative console:
– Select Service → Integration Buses to view or create new buses.
– Select Service → Integration Buses → bus_name → Destination to
view or create new destinations.
2. JMS queues or topics must be defined as resources to WebSphere Process
Server. The JMS resource points to the queue or topic and specifies the JNDI
name used to access it. This JNDI name must match the one specified in the
binding.
– Select Resources → JMS → JMS providers to view or create JMS
providers.
– Select Resources → JMS → resource_type to view or create JMS
queues and topics.

MQ JMS bindings
The underlying JMS provider must have the queues, topics, and JNDI entries
required by the binding defined.

6.4 Deploying applications

Modules and mediation modules are packaged for deployment by WebSphere
Integration Developer in the form of an enterprise archive (EAR) file. Modules
exported as EAR files can be deployed to a WebSphere Process Server
application server or cluster. Mediation modules exported as EAR files can be
deployed to a WebSphere Process Server or WebSphere ESB application server
or cluster.

A typical sequence for deploying applications is:

1. Export the modules from WebSphere Integration Developer as EAR files
ready for deployment.
2. Deploy the application to the appropriate cluster, also assigning it to the Web
server.
3. Configure the binding properties for the import components in the module
when applicable.
4. Generate the configuration file for the Web server plug-in and propagate it to
the Web server system.

208 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

6.4.1 Exporting applications for deployment

Applications in the workspace can be exported as EAR files for deployment using
the Export wizard.

Example: Exporting Order Management System

1. Open the workspace with all the WebSphere Process Server and WebSphere
ESB components
2. Select File → Export... → Business Integration → Integration module and
click Next.
3. Click Select All.
4. Under Export usage, select EAR files for server deployment.

Figure 6-18 Export projects as EAR files

5. Click Next.
6. Select a Target directory using Browse...
7. Click Finish.

Chapter 6. Managing applications 209

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

The EAR files can now be used to deploy to an external server.

6.4.2 Installing applications

The administrative console provides a wizard that will lead you through the
process of installing an application. To install and EAR file, it must be available to
the deployment manager. The deployment manager has the ability to access an
EAR file on the administrator’s local system (where the Web browser is), or a file
system that resides on a node defined to the cell.

The basic process to deploy an application is as follows:

1. Login to the administrative console for WebSphere Process Server and select
Enterprise Application → Install New Application
2. Select the EAR file to deploy. Note that “Local file system” is relative to the
Web browser. Remote file system allows you to find the EAR file on any of the
nodes defined to the cell. Select the option to Prompt only when additional
information is required. Click Next.

Figure 6-19 Select the EAR file

210 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

3. The next page allows you to select various installation options. We take the
defaults and click Next.

Figure 6-20 Select installation options

4. Select the modules in the application. Map all the modules to the target
deployment cluster. For example, in this case, we are mapping a mediation
module to the WebSphere ESB cluster. Map all the Web modules to both Web
server node as well (it doesn’t hurt to map all the modules).
The simplest way to do this is to use the CTRL key to select both the cluster
and the Web server. Check the boxes to the left of all the modules. Click
Apply.

Chapter 6. Managing applications 211

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-21 Map modules to servers

5. Click Next.
6. Review the summary of your options and click Finish.
7. Save the configuration.
8. Perform any necessary post-installation tasks required to update import
binding attributes to reflect the production environment.
9. Regenerate the plug-in configuration file and propagate it to the Web server.
10.Start the application. Select Applications → Enterprise Applications.
Check the box to the left of the application and click Start.

6.4.3 Configure and test Web service URLs

After you deploy a module with a Web service interface, you can publish the
associated WSDL file from the application server. The WSDL file includes the
information about the service, including the URL to be used by clients to access
the service . You can change the URL prefix of the service (http://host:port)
published with the WSDL through the administrative console:
1. Select Applications → Enterprise Applications →
web_service_application → Provide HTTP endpoint URL information.

212 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

2. Click the Select default HTTP URL prefix check box and select the prefix
from the drop-down. Your options will include URLs with the ports defined for
the server and for the virtual host.

Figure 6-22 Changing the HTTP URL prefix

3. Check the box to the left of the module and click Apply.
4. Click OK and save the configuration.

Now you can publish the WSDL file for the service for distribution to clients and
for testing.
1. Select Applications → Enterprise Applications → application → Web
service properties → Publish WSDL files.
2. Extract the WSDL file from the zip file generated. Note the service port URL in
the WSDL.

Example 6-1 WSDL soap address

<soap:address
location="http://xpxv812.itso.ral.ibm.com:9080/WarehouseAvailabilityServiceAWeb/sca/WarehouseAv
ailabilityServiceIFExport1"/>

3. Test the URL in a Web browser. This will ensure connectivity to the service
directly through the application server.

Chapter 6. Managing applications 213

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-23 Test the Web service interface

4. Regenerate the Web server plug-in and propagate it to the Web server (this is
discussed later in “Generate the Web server plug-in configuration” on
page 220).
5. Test the URL again, this time substituting the address of the Web server for
the URL prefix. This will ensure connectivity to the service through the Web
server.

Note: If you are not able to connect to the Web service, check the virtual host
configuration.
1. Determine the virtual host the Web service application was deployed to.
Select Applications → Enterprise applications. Click on the application
name to open the configuration. Click on Virtual hosts to see the virtual
host name.
2. Check for this virtual host configuration to make sure it includes the port
used to access the Web service.
Select Environment → Virtual Hosts. Click on the virtual host name to
open the configuration. Click on Host Aliases to see a list of ports for this
virtual host.
3. If necessary, update the virtual host configuration to include the port. Save
the configuration and restart the environment (servers, nodes, deployment
manager), then retry.

6.4.4 Updating endpoint URLs in Web service bindings

In a development environment, the URL specified in a Web service binding may
differ from the URL in a production environment. You can update the endpoint
URL for a Web service binding using the following method:

214 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

1. Select Applications → SCA Modules → module_name → Module

components → Imports → import_name → Binding → Web service.
2. Enter the new endpoint URL and save the configuration.

6.4.5 Example: installing the Order Management System applications

In the Order Management System, the following applications were deployed to
the WebSphere ESB cluster.
򐂰 DBMSServiceMediationApp
򐂰 OrderPreProcessingMediationApp
򐂰 WarehouseAvailabilityMediationApp
򐂰 WarehouseAvailabilityServiceAApp
򐂰 WarehouseAvailabilityServiceBApp
򐂰 WarehouseAvailabilityServiceCApp

And, the following applications were deployed to the WebSphere Process Server
cluster.
򐂰 EmailOutboundApp
򐂰 OrderManagementApp

DBMSServiceMediation deployment
The DBMSServiceMediation is deployed to the WebSphere ESB cluster.

To deploy this application from the administrative console:

1. Select Enterprise Application → Install New Application wizard to start
the installation.
2. Take the defaults with the exception of the module mapping:
– Map every module to the WebSphere Enterprise Service Bus cluster,
WESB.AppTarget.
– Map the Web module to the Web server, webserver1. Once again, this is
because the mediation provides its services through a Web service
interface and this access must be managed by the Web server plug-in in
order to apply the cluster workload and routing policies.

Chapter 6. Managing applications 215

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-24 Module to server mapping for the DBMS Mediation

3. Complete the installation and save the configuration.

4. Generate the Web server plug-in and propagate it to the Web server. If you
are deploying multiple applications, wait until they are all deployed and do this
one time.
5. Start the application.
6. Test the Web service URL for the mediation. See “Configure and test Web
service URLs” on page 212.

Warehouse Availability Systems deployment

The Warehouse Availability Systems must host warehouse Web services that
provide the availability status of an item in a warehouse. These Web services in
our test system have been emulated as mediation modules and must run on a
WebSphere ESB capable server. These modules will be deployed to the
WebSphere ESB cluster.

The steps to prepare this system are:

1. Deploy the Warehouse Availability System applications to the WebSphere
ESB cluster using the same method you saw in the previous step.
2. Determine the endpoint URL for each system and test the connectivity.
The mediation that will use these services will need the complete URL from
the port definition in the WSDL file for the service:

216 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

http://xpxv812.itso.ral.ibm.com:9082/WarehouseAvailabilityServiceAWe
b/sca/WarehouseAvailabilityServiceIFExport1

Repeat the deployment, URL/port discovery, and testing from the WebSphere
ESB client machines for every Web service that will be accessed from the
mediation module. In our case they are the three Warehouse Availability Systems
Web services, so this procedure has been repeated three times.

WarehouseAvailabilityMediation deployment
The WarehouseAvailabilityMediation deployment will require additional steps
after deployment to ensure it can access the WarehouseAvailabilitySystems. To
deploy:
1. Deploy WarehouseAvailabilityMediation to the WebSphere ESB cluster. .
2. WarehouseAvailabilityMediation uses the WarehouseAvailabilitySystems
Web services. When those Web services were deployed, you discovered and
tested URLs used to access them. You must make sure these URLs are used
in the import properties for WarehouseAvailabilityMediation.
For example, assume the URL for WarehouseAvailabilitySystemA Web
service URL is:
http://xpxv812.itso.ral.ibm.com:9082/WarehouseAvailabilityServiceAWe
b/sca/WarehouseAvailabilityServiceIFExport1.
Find the URL actually used by WarehouseAvailabilityMediation for the
service:
Select Applications → SCA Modules → WarehouseAvailabilityMediation,
Module components → Imports → GetWarehouseA_Availability →
Binding → Web service.

Figure 6-25 Looking at the WarehouseAvailabilityMediation imports properties

3. Compare the URL for the Web service application with the URL you find here
in the endpoint field. If they are not the same, update the endpoint URL.

Chapter 6. Managing applications 217

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-26 Checking and updating the import endpoint property

This must be repeated for all three Web services imports.

Note: The Web server address here shows the URL of the Web container of a
specific server in a cluster. Remember that this URL is for a Web service
which we emulated with a mediation. So even though we deployed the
WarehouseAvailabilitySystems to a cluster, these are purely to emulate a real
back-end service and we aren’t concerned that no load balancing will occur
here.

4. Finally you must generate and propagate the plug-in for the Web server and
test that the WarehouseAvailabilityMediation module is accessible through
the Web server.

OrderManagement deployment
Deploying the OrderManagement is similar to the process you used to deploy the
mediation modules.
1. Deploy the OrderManagement, mapping the modules to the WebSphere
Process Server cluster. In addition, map the Web module to the Web server.

218 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-27 OrderManagement application modules mapping

2. The OrderManagement application uses the DBMSServiceMediation and

WarehouseAvailabilityMediation applications through imports. Determine the
URL for both mediations, and check that the endpoint properties are updated
in the OrderManagement application. This time, make sure the endpoint uses
the Web server so that load balancing to the mediation modules occurs.
3. Repeat this for every Web service import. (The E-mail import uses an SCA
import so this step isn’t necessary).

Figure 6-28 Checking and updating OrderManagement imports endpoint property

4. Generate and propagate the Web server plug-in and then test the service
availability using a browser.

Chapter 6. Managing applications 219

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

OrderPreProcessingMediation deployment
The last module to deploy is the OrderPreProcessingMediation application.
1. Deploy the module mapping all of the modules to the WebSphere ESB cluster
and the Web module to the Web server.
2. Update the import for the OrderManagement module. The Flat File Adapter
import is not a Web service binding and needs no update.
3. Generate and propagate the plug-in.
4. Test access to the service.

6.5 Generate the Web server plug-in configuration

After a new application is deployed, you need to generate the Web server plug-in
configuration and propagate it to the Web server. This tells the Web server how
to forward requests for the application. To generate the plug-in from the
administrative console, select Servers → Web servers. Click Generate Plug In
to create the plug-in file.

How you propagate the new configuration file depends on the Web server type
and your environment. This can be done manually, or in some cases, by selecting
the Propagate plug in button.

6.6 Testing the application

The last phase you will go through will be testing. This section will provide
general guidance using our OrderManagement scenario as an example.

A logical way to test is to use a “bottom up” method, performing incremental tests
starting with the last service in the chain and working your way to the first
service. In our scenario, looking at the deployment diagram in Figure 6-3 on
page 188, a possible test order is:
1. DBMSServiceMediation
2. WarehouseAvailabilityMediation
3. OrderManagement
4. OrderPreProcessingMediation

DBMSServiceMediation and WarehouseAvailabilityMediation don’t depend on

other modules, while OrderManagement uses imports to access these
mediations. This test order allows you to make sure the DBMSServiceMediation
works as expected before testing a module that uses it.

220 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

The way you test a module depends on several factors such as:
򐂰 How the module is accessed (the export binding)
You must use a client that matches the module access protocols. This may be
JMS, HTTP, Web service (SOAP/HTTP or SOAP/JMS)...
򐂰 The tool you use for developing or emulating the client of the module
You can use any appropriate development tool to create the client of the
application. Rational® Application Developer or WebSphere Integration
Developer can be appropriate in most cases.
򐂰 The module type (business integration vs. mediation)
Business integration modules can be easily tested using the Business
Process Choreographer Explorer. This tool can’t be used to test mediation
modules.
򐂰 The network accessibility and security restrictions
You must ensure your client has network connectivity with the modules and
complies with security constraints (such as message encryption or
credentials to be provided).

We will provide some ideas for testing, based on our testing plan for the Order
Management system.

6.6.1 Starting and preparing your test clients

The scenario application modules are accessible as Web services so we used
Web service clients for testing. With the WSDL files for the services and the
correct endpoint URLs and ports, we are able to build a Web service client for
each service.

Since we developed all of the modules using WebSphere Integration Developer,

we used that also for most of the testing. Our strategy was the following:
1. We created a OrderTestClient mediation module as a client.
This could also be a business integration module, since it will only contain
import components.
2. We added the service interfaces and WSDL files for the modules to be tested
in the OrderTestClient module.
Most of the interfaces for the OrderManagement system are contained in
OrderManagementLib, so we simply made this library a dependency of the
new mediation module. Just to test OrderPreProcessingMediation, we made
a copy of OrderPreProcessingIF and the Web service port in the mediation
module.

Chapter 6. Managing applications 221

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-29 A Mediation Module as test client must contain the to be tested components
interfaces and web service ports

3. We defined an import for each module to be tested:

– OrderPreProcessing mediation
– DBMSServiceMediation. We defined an import for the Customer service
but we could have defined additional imports to test the other services
provided by this module.
– WarehouseAvailabilityMediation.
We added the appropriate interface to these Imports and named them in a
way which makes it easy to recognize their purpose.

Figure 6-30 Imports components for testing the modules

Note: The import for OrderManagement is missing here because we will test
that using the Business Process Choreographer Explorer.

4. Then we bound the imports to the Web service port.

222 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Be sure to use Web server address and port 80 for the Web service endpoint
property in order to have load balancing performed for the cluster. Test the
Web service using a browser to make sure the Web service can be accessed
via the Web server.

Figure 6-31 Binding Address property must target the web server address

6.6.2 Testing the mediation modules

To test the mediation modules using the OrderTestClient, we did the following:
1. Start the WebSphere ESB test environment in WebSphere Integration
Developer.
2. Deploy OrderTestClient to the server.
3. Right click OrderTestClient in the Business Integration view and select
Test → Module to launch the integration test client.
4. DBMSServiceMediation is tested first. The properties used for the test are
shown in Figure 6-32. Since the test is for the customer retrieval operation, we
only need a customer ID value.

Chapter 6. Managing applications 223

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-32 Testing the DBMSServiceMediation Customer Service

Note: In our test environment we found that the first invocation often failed.
Retrying the invocation was successful.

The test is successful if the customer fields are populated.

Figure 6-33 Successful customer service test

224 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

5. The WarehouseAvailabilityMediation module is then tested in the same way.

6.6.3 Test the business integration modules

Next, we moved to OrderManagement testing.

Automatic deletion of processes

By default, business processes are set to delete instances on successful
completion. This may make it difficult to understand if a test run is successful. To
change the setting, open the process. Click in the white space of the canvas to
open the properties for the process. The setting can be found in the Details tab of
the Properties view.

The value you want for this setting may differ between test and production.
During testing, we changed the setting so that processes had to be manually
deleted using the Business Process Choreographer Explorer. When we deployed
to a production environment, we changed the setting so processes were deleted
if they were completed successfully.

Figure 6-34 Automatic process deletion setting

Testing OrderManagementBP
To test the OrderManagementBP process, we opened a Business Process
Choreographer Explorer session, logged in as Administrator and found the
OrderManagementBP templates.

Check the box to the left of the process and click Start Instance.

Chapter 6. Managing applications 225

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Figure 6-35 OrderManagement template in the Business Process Choreographer Explorer

The following test cases can be used ensure the module was working properly:
򐂰 automatic approval
򐂰 automatic refusal
򐂰 human tasks involvement for final decision

The last test case, human tasks, is also the most comprehensive. That is the one
we will show here. The input data for this test is shown in Figure 6-36 on
page 227.

226 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-36 Testing the OrderManagement in the human task activation case

We gave this instance a specific process name (humanTasks) in order to better

recognize it in between the process instances. Enter the data and click Submit.

Once submitted, the instance remained in the running status in the Process
Instances → Started By me list. This is because the process is suspended
waiting for the human tasks to be completed.

Figure 6-37 Process instance keep running until you don’t complete human task

Chapter 6. Managing applications 227

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

We accessed the human task by logging out of Business Process Choreographer

Explorer and logging in again as a member of the Warehouse Office group first,
then Financial Office group. We approved both the tasks (copying input data in
output data for the warehouse human task and approving) and had a successful
completion of the process.

Figure 6-38 shows the Warehouse human task.

Figure 6-38 Approving warehouse human task after having copied the input in the form

228 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-39 on page 229 shows the Financial Office task.

Figure 6-39 Approving the financial human task

Chapter 6. Managing applications 229

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

Verifying the results

There are several ways to verify the results of the test:
򐂰 Log in as the submitter in Business Process Choreographer Explorer and look
at the Process Instance status. If the process was successful, you will only
see the process if you aren’t having the instances automatically deleted.
򐂰 Browse the WebSphere Process Server logs. In a cluster, you will have to
look at the logs for each server in the cluster. The server logs are located in
profile_root/logs/server_name/SystemOut.log.
򐂰 You can look at any external results you may be expecting, such as files
created, database record updates, or e-mail events.

Testing OrderPreProcessingMediation
Last comes the OrderPreProcessingMediation test. This has been again
performed through the OrderTestClient module, selecting the appropriate
component, interface and method from the Integrated test client interface. We
tested the special order management case as first.

Figure 6-40 Testing the OrderPreProcessing in the special order case

The verification in this case is to make sure the new file has been created in the
C:\ITSOSpecialOrders folder.

230 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643RunConf.fm

Figure 6-41 Special Order file sent to the file system by the mediation

Last, we tested the OrderPreProcessingMediation by forwarding a regular

request to the OrderManagement (isSpecial is false) and the values for
automatic approval. This results in the invocation of OrderManagement. Again,
verification is made by looking at the SystemOut logs for the server, and by
ensuring the e-mail was sent to the user.

Figure 6-42 Looking at logs for successful completion of the OrderManagement

Chapter 6. Managing applications 231

7643RunConf.fm Draft Document for Review June 3, 2008 1:55 pm

232 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643bibl.fm

Related publications

The publications listed in this section are considered particularly suitable for a
more detailed discussion of the topics covered in this book.

IBM Redbooks
For information about ordering these publications, see “How to get Redbooks” on
page 234. Note that some of the documents referenced here may be available in
softcopy only.
򐂰 Getting Started with WebSphere Process Server and WebSphere Enterprise
Service Bus: Part 1: Development, SG24-7608
򐂰 Getting Started with WebSphere Process Server and WebSphere Enterprise
Service Bus: Part 3: Runtime, SG24-7643
򐂰 Business Process Management: Modeling through Monitoring Using
WebSphere V6.0.2 Products, SG24-7148
򐂰 WebSphere Application Server for i5/OS Handbook: Version 6.1, SG24-7221
򐂰 WebSphere Application Server V6: Diagnostic Data, REDP-4085

Online resources
These Web sites are also relevant as further information sources:
򐂰 WebSphere Application Server V6.1 information center.
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp
򐂰 WebSphere Process Server V6.1 information center.
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wps.610.doc/welcome_top_wps.htm
򐂰 WebSphere Enterprise Service Bus V6.1 information center
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.websphere.wesb.61x.root.doc/info/welcome.html
򐂰 WebSphere Integration Developer V6.1 information center

© Copyright IBM Corp. 2008. All rights reserved. 233

7643bibl.fm Draft Document for Review June 3, 2008 1:55 pm

http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.i
bm.wbit.610.help.nav.doc/topics/welcome.html
򐂰 WebSphere Integration Developer V6.1 information center: Configuring and
Using Adapters
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/index.jsp?t
opic=/com.ibm.wbit.610.help.adapter.emd.ui.doc/topics/tcreatecmps.ht
ml

How to get Redbooks

You can search for, view, or download Redbooks, Redpapers, Technotes, draft
publications and Additional materials, as well as order hardcopy Redbooks, at
this Web site:
ibm.com/redbooks

Help from IBM

IBM Support and downloads
ibm.com/support

IBM Global Services

ibm.com/services

234 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643IX.fm

Index
control region 105, 119
A control region (CR) 8
AboutThisProfile.txt 163
control region adjunct 9
addNode 137
controller process 105, 119
address space 8
controller region 173
adjunct process 120
CTRACE parmlib member 104, 118
administrative console 158
custom node 4, 6, 34–35, 38, 47, 69, 76, 79, 110,
starting 161
118–119, 122, 124, 133–134, 136–137, 139
administrative domain 2
custom profile 3, 7, 21, 55, 75, 110
administrative security 162–164
custom user registry 108, 121
apachectl start 70
application deployment target 12
application server 2 D
application server profile 94, 163 daemon 106, 120, 173
Application Server Toolkit 94, 96, 111 daemon server 10
augment 3–4, 24, 28, 33–34, 52, 54, 90–91, 93, default profile 18
110, 124, 129–130, 135–137, 139 deployment environment pattern 6–7, 11, 22, 51,
72, 76, 80
Deployment manager 46
B deployment manager 2–8, 21–22, 24, 27–30,
BBOCCINS 172
34–35, 38, 47, 68–69, 71–72, 74–76, 79–80, 94–96,
BBOWMNAN 124
103–105, 110, 122, 124, 127–128, 130, 132–134,
BPEDB 25, 28–29
137–139, 141, 159, 162, 171–173, 175, 193, 210,
BPEODB 25, 28
214
Business Flow Manager 28, 152, 154
starting 158, 171
business integration module 2, 221
starting on z/OS 172
Business Process Choreographer 12, 25, 28–29,
stopping 158, 172
61–62, 131, 152–155, 221
stopping on z/OS 173
Business Process Choreographer Explorer 222,
deployment manager name 102, 117
225–226, 228, 230
deployment manager profile 55, 95
Business Process Manager 139
Derby Embedded 27
Business Rules Manager 12
Derby Network 27
distributed server 5
C distributed server configuration 6
CEI database 25 distributed server environment 17
cell 2, 161 DMGR 127
cell name 102, 117
cell profile 94
certificate 107–108, 121
E
EVENT database 25
certificate authority 107, 120
EventSequencing (LockManager) 26
cluster 175, 230
command line tools 158–159
Common Event Infrastructure 131 F
Common Event Interface (CEI) bus 12 failover 5

© Copyright IBM Corp. 2008. All rights reserved. 235

7643IX.fm Draft Document for Review June 3, 2008 1:55 pm

federate 3–4, 7, 18, 30, 76, 79, 94–95, 110, 122, starting 173
124, 133, 136–137, 139 stopping 174
application server 95 stopping on z/OS 175
federated repositories 201
file-based user registry 108, 121
P
plug-in configuration file
G automated propagation 180
GetPluginCfg 177 automatic regeneration 178
propagating 178
regenerating 177
H port 163
HFS 103–104, 117
ports 105
HLQ field 98
print() 180
human task 153, 200–202, 226–229
println() 180
Human Task Manager 28, 139, 152, 154
printStackTrace() 180
Process Instance status 230
I PROCLIB 99
IBM HTTP Server 68, 70 profile 3
IBM Web Administration 166 profile directory 159
IBM Web Administration for i5/OS 158, 164, 168 Profile Management Tool 4, 22–24, 31, 33, 52–54,
ISPF Customization Dialog 94, 110, 124 56, 79, 81, 90, 94, 96
Profile Management Tool Client 52–53
profile_root 160
J
JMS binding 207
Jython 108, 122 Q
QHTTPSVR 166
QShell 161
L
LDAP 108, 121
log R
HTTP 17 RACF 107–108, 121
long name 102, 117 Redbooks Web site 234
Contact us xii
Relationship service 26
M
managed node 17, 95 remote messaging and remote support pattern 11,
ManagedDB2.rsp 133 14–16, 67, 76, 78, 80
manageprofiles 4, 20, 22–24, 52, 54–55, 94 remote messaging pattern 11, 13–14, 67, 76, 80
manageprofiles script 94 response file 96
mediation module 2, 221 responsefile.wbis.txt 47
Message Logger primitive 26
MQ binding 207 S
MQ JMS binding 208 SAF 107, 121
SAF EJBROLE 107–108, 121
SAF keyring name 107
N
node 2 SBBOEXEC 101
stopping 175 SBBOLD2 101
node agent 2, 5, 119, 122, 138, 173–175 SBBOLOAD 101
restarting 175 SBBOLPA 101

236 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
Draft Document for Review June 3, 2008 1:55 pm 7643IX.fm

SBBOMSG 102 Management Tool (zPMT) 94

SCA application bus 12, 146, 207 WebSphere Application Server Network Deploy-
SCA system bus 12, 146–147 ment 5
scripting client 168 WebSphere Process Server Network Deployment
scripting program 168 Creating a cluster 140
security domain identifier 108 DB2 libraries 140
servant process 105 ManagedDB2.rsp 134
servant region 173 Windows service 158
servant region (SR) 9 WLM 103
serverStatus 170 WLM APPLENV 103
service integration bus 9, 14, 140, 207 workload management 5
short name 102, 117 WPRCSDB 25–26, 28, 66, 72, 75, 147
single cluster pattern 11–12, 66–67, 76, 80, 188 WPS_install_root 160
single cluster topology 183, 187 wsadmin 158–159, 168
SMS 103
SOAP/HTTP 221
SOAP/JMS 221
X
X509 107, 120
SSL 106–107
stand-alone application server 4
stand-alone server 3–5, 10, 21, 38, 46, 56, 65, 139, Z
146 z/OS workload manager 8
stand-alone server profile 55 zFS 103–104, 117
stand-alone service bus profile 3 zPMT 21, 24, 52, 94–96, 109–110, 123
startManager 171 zSMPInstall 21, 127–128, 133–134
startNode 171, 173 zWESBConfig 4, 21
startServer 169–170 zWLM 9
STEPLIB 102 zWPSConfig 4, 21, 127–128, 130–131, 133,
stopManager 172 136–137
stopServer 170
STRQSH 170
STRTCPSVR 164

U
unmanaged node 16, 86
Update Installer 23, 48, 68, 74, 78

W
WAS_USER_SCRIPT 18
Web server
adding 87
Web Server plug-in 187
Web server plug-in 15, 60, 69–70, 178–180, 187,
208, 215–216, 219–220
regenerating 177
Web server plug-in configuration service 178
Web service URL 212, 216
WebSphere Application Server - Express 4
WebSphere Application Server for z/OS Profile

Index 237
7643IX.fm Draft Document for Review June 3, 2008 1:55 pm

238 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime
To determine the spine width of a book, you divide the paper PPI into the number of pages in the book. An example is a 250 page book using Plainfield opaque 50#
smooth which has a PPI of 526. Divided 250 by 526 which equals a spine width of .4752". In this case, you would use the .5” spine. Now select the Spine width for
the book and hide the others: Special>Conditional Text>Show/Hide>SpineSize(-->Hide:)>Set . Move the changed Conditional text settings to all files in your
book by opening the book file with the spine.fm still open and File>Import>Formats the Conditional Text Settings (ONLY!) to the book files.
Draft Document for Review June 3, 2008 1:55 pm 7643spine.fm 239
Getting Started with
WebSphere Process Server
and WebSphere ESB Part 3:
(1.5” spine)
1.5”<-> 1.998”
789 <->1051 pages
Getting Started with WebSphere
Process Server and WebSphere
(1.0” spine)
0.875”<->1.498”
460 <-> 788 pages
Getting Started with WebSphere Process Server and
(0.5” spine)
0.475”<->0.875”
250 <-> 459 pages
Getting Started with WebSphere Process Server and WebSphere ESB
(0.2”spine)
0.17”<->0.473”
90<->249 pages
(0.1”spine)
0.1”<->0.169”
53<->89 pages
To determine the spine width of a book, you divide the paper PPI into the number of pages in the book. An example is a 250 page book using Plainfield opaque 50#
smooth which has a PPI of 526. Divided 250 by 526 which equals a spine width of .4752". In this case, you would use the .5” spine. Now select the Spine width for
the book and hide the others: Special>Conditional Text>Show/Hide>SpineSize(-->Hide:)>Set . Move the changed Conditional text settings to all files in your
book by opening the book file with the spine.fm still open and File>Import>Formats the Conditional Text Settings (ONLY!) to the book files.
Draft Document for Review June 3, 2008 1:55 pm 7643spine.fm 240
Getting Started with
WebSphere Process
Server and WebSphere
(2.5” spine)
2.5”<->nnn.n”
1315<-> nnnn pages
Getting Started with
WebSphere Process
Server and WebSphere
(2.0” spine)
2.0” <-> 2.498”
1052 <-> 1314 pages
 Back cover ®
Draft Document for Review June 3, 2008 1:55 pm

Getting Started with

WebSphere Process
Server and WebSphere ®

Install WebSphere This book provides new users with information on installing
Process Server and configuring a WebSphere® Process Server and INTERNATIONAL
WebSphere Enterprise Service Bus runtime environment. It TECHNICAL
Build topologies includes installation examples on distributed, i5/OS®, and SUPPORT
based on patterns z/OS® platforms. It also provides basic configuration ORGANIZATION
information for deploying applications.
Prepare for Some knowledge of WebSphere Application Server Network
deployment Deployment is assumed. BUILDING TECHNICAL
This is the third book of a three-part series: INFORMATION BASED ON
PRACTICAL EXPERIENCE
Getting Started with WebSphere Process Server and
WebSphere Enterprise Service Bus:
IBM Redbooks are developed by
Part 1: Development, SG24-7608 the IBM International Technical
Part 2: Scenario, SG24-7642 Support Organization. Experts
from IBM, Customers and
Part 3: Runtime, SG24-7643 Partners from around the world
create timely technical
information based on realistic
scenarios. Specific
recommendations are provided
to help you implement IT
solutions more effectively in
your environment.

For more information:

ibm.com/redbooks

SG24-7643-00 ISBN