gettingstarted with wps&esb part3

Upload: karthickmsit

Post on 29-May-2018

218 views

Category:

Documents


0 download

TRANSCRIPT

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    1/256

    ibm.com/redbooks

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

    Getting Started with WebSphereProcessServer and WebSphereEnterprise Service Bus

    Part 3: Runtime

    Carla Sadtler

    Srinivasa R Borusu

    Sergiy Fastovets

    Thalia Hooker

    Ernese Norelus

    Fabio Paone

    Dong Yu

    Install WebSphere Process Server

    Build topologies based on

    patterns

    Prepare for deployment

    Front cover

    http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    2/256

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    3/256

    Getting Started with WebSphere Process Serverand WebSphere ESB Part 3: Runtime

    June 2008

    International Technical Support Organization

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

    SG24-7643-00

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    4/256

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

    Copyright International Business Machines Corporation 2008. All rights reserved.

    Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADPSchedule Contract with IBM Corp.

    First Edition (June 2008)

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

    This document created or updated on June 3, 2008.

    Note: Before using this information and the product it supports, read the information inNotices on page vii.

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    5/256

    Copyright IBM Corp. 2008. All rights reserved. iii

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

    Contents

    Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

    Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixThe team that wrote this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

    Become a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiComments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

    Chapter 1. Planning for installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1 WebSphere Application Server concepts . . . . . . . . . . . . . . . . . . . . . . . . . . 2

    1.1.1 Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.1.2 Application server environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.1.3 WebSphere Application Server for z/OS. . . . . . . . . . . . . . . . . . . . . . . 7

    1.2 Selecting a topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

    1.2.1 Stand-alone server topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.2.2 Deployment environment patterns . . . . . . . . . . . . . . . . . . . . . . . . . . 111.2.3 Single cluster pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

    1.2.4 Remote messaging pattern. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.2.5 Remote messaging and remote support pattern. . . . . . . . . . . . . . . . 141.2.6 Web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

    1.3 Planning for installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181.3.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191.3.2 User ID authorities for installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

    1.3.3 Installation methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201.3.4 Installation type (distributed and i5/OS) . . . . . . . . . . . . . . . . . . . . . . 211.3.5 Selecting additional features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

    1.3.6 Root directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231.3.7 Creating profiles during installation. . . . . . . . . . . . . . . . . . . . . . . . . . 23

    1.3.8 Installing recommended maintenance . . . . . . . . . . . . . . . . . . . . . . . 231.4 Planning for profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

    1.4.1 Planning for databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

    1.4.2 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301.4.3 Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

    1.5 Planning for the Profile Management Tool . . . . . . . . . . . . . . . . . . . . . . . . 33

    1.5.1 Profile environment and type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    6/256

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

    iv Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    Chapter 2. Installation on distributed and i5/OS systems . . . . . . . . . . . . . 372.1 Installation overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382.2 Typical installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382.3 Installation on i5/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

    2.3.1 Installing remotely from a Windows workstation . . . . . . . . . . . . . . . . 432.3.2 Installing WebSphere Process Server on i5/OS silently . . . . . . . . . . 472.4 Install the IBM Update Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482.5 Download and install maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

    Chapter 3. Creating profiles on distributed and i5/OS systems . . . . . . . . 513.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. . . . . . . . . . . . . . . . . . . . . . . . . . 563.3 Building a deployment environment using a pattern . . . . . . . . . . . . . . . . . 663.3.1 Summary of steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683.3.2 Build the Web server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693.3.3 Building the deployment manager. . . . . . . . . . . . . . . . . . . . . . . . . . . 71

    3.3.4 Building Node1 and the first process server of the cluster . . . . . . . . 753.3.5 Building Node2 and the second process server of the cluster . . . . . 793.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 . . . . . . . . . . . . . . . . . 934.1 Methods of creating profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944.2 Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954.3 Creating a deployment manager node . . . . . . . . . . . . . . . . . . . . . . . . . . . 964.4 Creating a custom node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1104.5 Configuring the deployment manager node . . . . . . . . . . . . . . . . . . . . . . 127

    4.5.1 Run the zSMPInstall.sh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

    4.5.2 Preparing DmgrDB2.rsp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1284.5.3 Run the zWPSConfig.sh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1304.5.4 Creating DB2 database objects using the createDB.sh script . . . . 1314.5.5 Back up the WebSphere configuration HFS datasets. . . . . . . . . . . 133

    4.6 Configuring a custom node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1334.6.1 Running the zSMPInstall script . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1334.6.2 Preparing ManagedDB2.rsp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

    4.6.3 Running zWPSConfig.sh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

    4.6.4 Federating a custom node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1374.6.5 Configure and federate secondary custom node . . . . . . . . . . . . . . 1394.6.6 Back up the WebSphere configuration HFS datasets. . . . . . . . . . . 139

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    7/256

    Contents v

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

    4.7 Creating a WebSphere Process Server cluster. . . . . . . . . . . . . . . . . . . . 1394.7.1 Add DB2 libraries to the Servant and Adjunct JCL . . . . . . . . . . . . . 140

    4.7.2 creating a cluster/server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1404.7.3 Configure Service Component Architecture . . . . . . . . . . . . . . . . . . 145

    4.7.4 Configure Common Event Infrastructure. . . . . . . . . . . . . . . . . . . . . 1494.7.5 Configuring the Business Flow and Human Task Managers . . . . . 152

    Chapter 5. Managing the runtime environment . . . . . . . . . . . . . . . . . . . . 1575.1 Administrative tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

    5.1.1 Using commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1595.1.2 Using the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . 1615.1.3 Using IBM Web Administration for i5/OS . . . . . . . . . . . . . . . . . . . . 1645.1.4 WebSphere scripting client (wsadmin) . . . . . . . . . . . . . . . . . . . . . . 168

    5.2 Managing stand-alone server environments . . . . . . . . . . . . . . . . . . . . . . 1695.2.1 Managing application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

    5.3 Managing distributed environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1715.3.1 Managing the deployment manager . . . . . . . . . . . . . . . . . . . . . . . . 1715.3.2 Managing nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1735.3.3 Managing servers and clusters from the administrative console . . 175

    5.4 Managing the Web server plug-in configuration . . . . . . . . . . . . . . . . . . . 1775.4.1 Generating the plug-in with administrative console. . . . . . . . . . . . . 1775.4.2 Enabling automated plug-in regeneration . . . . . . . . . . . . . . . . . . . . 178

    5.4.3 Propagating the plug-in configuration file . . . . . . . . . . . . . . . . . . . . 1785.4.4 Activating the new plug-in configuration . . . . . . . . . . . . . . . . . . . . . 1795.4.5 Enable automated plug-in propagation . . . . . . . . . . . . . . . . . . . . . . 180

    5.5 Viewing the JVM logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

    Chapter 6. Managing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1836.1 Scenario: Order Management System . . . . . . . . . . . . . . . . . . . . . . . . . . 1846.2 Planning for deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

    6.2.1 Setting up the prerequisites for Order Management System . . . . . 189

    6.3 Defining application resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1916.3.1 Setting the resource scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1916.3.2 Defining security credentials to access a resource. . . . . . . . . . . . . 1926.3.3 Defining JDBC resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1936.3.4 Defining users and groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2006.3.5 JMS resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

    6.4 Deploying applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2086.4.1 Exporting applications for deployment . . . . . . . . . . . . . . . . . . . . . . 209

    6.4.2 Installing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2106.4.3 Configure and test Web service URLs . . . . . . . . . . . . . . . . . . . . . . 2126.4.4 Updating endpoint URLs in Web service bindings . . . . . . . . . . . . . 2146.4.5 Example: installing the Order Management System applications. . 215

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    8/256

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

    vi Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    6.5 Generate the Web server plug-in configuration. . . . . . . . . . . . . . . . . . . . 2206.6 Testing the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

    6.6.1 Starting and preparing your test clients. . . . . . . . . . . . . . . . . . . . . . 2216.6.2 Testing the mediation modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

    6.6.3 Test the business integration modules . . . . . . . . . . . . . . . . . . . . . . 225

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

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

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    9/256

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

    Copyright IBM Corp. 2008. All rights reserved. vii

    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. Consultyour 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 IBMproduct, program, or service may be used. Any functionally equivalent product, program, or service thatdoes not infringe any IBM intellectual property right may be used instead. However, it is the user'sresponsibility 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 suchprovisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATIONPROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS ORIMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimerof 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 madeto 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 atany time without notice.

    Any references in this information to non-IBM Web sites are provided for convenience only and do not in anymanner serve as an endorsement of those Web sites. The materials at those Web sites are not part of thematerials 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 withoutincurring any obligation to you.

    Information concerning non-IBM products was obtained from the suppliers of those products, their publishedannouncements 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 onthe 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 themas 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 businessenterprise is entirely coincidental.

    COPYRIGHT LICENSE:

    This information contains sample application programs in source language, which illustrate programmingtechniques 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 applicationprograms conforming to the application programming interface for the operating platform for which thesample 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.

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    10/256

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

    viii Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    Trademarks

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

    Redbooks (logo) iSeriesi5/OSz/OSDB2

    InformixIBMMVSOS/390Rational

    RedbooksRACFSystem zWebSphere

    The following terms are trademarks of other companies:

    Oracle, JD Edwards, PeopleSoft, Siebel, and TopLink are registered trademarks of Oracle Corporationand/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.

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    11/256

    Copyright IBM Corp. 2008. All rights reserved. ix

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

    Preface

    This book provides new users with information on installing and configuring aWebSphere Process Server and WebSphere Enterprise Service Bus runtimeenvironment. It includes installation examples on distributed, i5/OS, and z/OSplatforms. It also provides basic configuration information for deployingapplications.

    Some knowledge of WebSphere Application Server Network Deployment isassumed.

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

    Getting Started with WebSphere Process Server and WebSphere EnterpriseService 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 workingat the International Technical Support Organization, Raleigh Center.

    Carla Sadtler is a Consulting IT Specialist at the ITSO, Raleigh Center. Shewrites extensively about WebSphere and Patterns for e-business areas. Before

    joining the ITSO in 1985, Carla worked in the Raleigh branch office as a ProgramSupport Representative, supporting MVS customers. She holds a degree inmathematics from the University of North Carolina at Greensboro.

    Srinivasa Borusu is a Senior IT Specialist at IBM IndiaSoftware Labs, Bangalore. He is currently working as aWebSphere Consultant with IBM Business Partner TechnicalStrategy and Enablement (BPTSE) Developer Services team,enabling and supporting worldwide business partners on

    WebSphere products. Since he joined IBM in 2000, he hasplayed various roles, including Tech Lead for the IBM JavaVirtual Machine Support, during his tenure at OS/2 worldwide

    support center. His technical portfolio also includes one FILE rated patent, 4 IBM

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    12/256

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

    x Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    SOA and WebSphere product certifications and several published articles. Heholds 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, andsales support in the Host Integration area. In 2006 Sergiytransferred to the IBM UK where he is an IT Consultant forWebSphere Software Services. He holds a degree inmathematics from the University of Saint Petersburg, Russia.His native town is Poltava, Ukraine.

    Thalia Hooker Ph.D., is a Consulting IT Specialist andmember of the WebSphere Americas iPoC Team. She

    executes proof-of-concepts using the WebSphere platform toshow customers how IBM solutions and products can helpthem meet their integration requirements. These solutions andproducts include Service Oriented Architecture (SOA) andWebSphere Business Process Management products such as,WebSphere Process Server and WebSphere EnterpriseService Bus.

    Ernese Norelus is an IBM Certified Consulting IT Specialist

    with the ASEAN Software Services team in Singapore. He hasbeen in IT for ten years, with eight years of experiencepresenting, teaching, and proposing solution architectures tocustomers using the WebSphere business integration portfolio.He is also a well-known conference speaker, and he holdscertifications in IM/DB2, Lotus, Rational, Tivoli andWebSphere. He holds degrees in Biochemistry and Computer

    Science and Information Technology Management from the Universit duQubec Montral, (Qubec, Canada).

    Fabio Paone is WebSphere technical sales supporting theChannel (Business Partners) in Italy. He has four yearsexperience as a developer in the Rome Tivoli Lab, primarily inJ2EE development. He is certified as a WebSphere ApplicationServer Administrator (versions 5, 6, and 6.1), and hasparticipated in WebSphere Application Server certification testreviews.

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    13/256

    Preface xi

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

    Dong Yu is a Staff Software Engineer at IBM ChinaDevelopment Lab. He has four years of experience in theWebSphere Business Integration Field.His areas of expertiseinclude WebSphere Process Server installation andConfiguration.Dong holds a master degree in Software

    Engineering from Northwestern Polytechnical University.

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

    Rich ConwayInternational Technical Support Organization, Raleigh Center

    Margaret TicknorInternational Technical Support Organization, Raleigh Center

    Stephen CocksIBM UK

    Andrew MeadIBM UK

    Sharuff MorsaIBM UK

    Dean BarkerIBM UK

    Become a published author

    Join us for a two- to six-week residency program! Help write a book dealing withspecific products or solutions, while getting hands-on experience with

    leading-edge technologies. You will have the opportunity to team with IBMtechnical professionals, Business Partners, and Clients.

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

    Find out more about the residency program, browse the residency index, andapply online at:

    ibm.com/redbooks/residencies.html

    http://www.redbooks.ibm.com/residencies.htmlhttp://www.redbooks.ibm.com/residencies.htmlhttp://www.redbooks.ibm.com/residencies.htmlhttp://www.redbooks.ibm.com/residencies.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    14/256

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

    xii Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    Comments welcome

    Your comments are important to us!

    We want our books to be as helpful as possible. Send us your comments aboutthis 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 OrganizationDept. HYTD Mail Station P0992455 South RoadPoughkeepsie, NY 12601-5400

    http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/contacts.htmlhttp://www.redbooks.ibm.com/contacts.htmlhttp://www.redbooks.ibm.com/http://www.redbooks.ibm.com/
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    15/256

    Copyright IBM Corp. 2008. All rights reserved. 1

    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 Serverinstallations. 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 WebSphereApplication Server base, this chapter will assume WebSphere Application ServerNetwork Deployment as a base product.

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

    1

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    16/256

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

    2 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    1.1 WebSphere Application Server concepts

    WebSphere Process Server and WebSphere ESB are built on top of WebSphereApplication Server technology and inherit its runtime structure and configuration

    characteristics. The concepts associated with WebSphere Application Server arecommon for all of these products and are important to understand in order to planfor 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 eachconfiguration, cells and nodes do not play an important role until you takeadvantage of the features provided with Network Deployment.

    The following concepts are key to understanding topologies based onWebSphere Application Server.

    The application serveris the primary runtime component in all configurationsand is where an application executes. Application servers have levels ofcapability tailored to the applications they will host. These levels are:

    WebSphere Application Server and WebSphere Application ServerNetwork 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 WebSphereESB servers and can host business integration modules.

    In a WebSphere Process Server installation, which includes WebSphereESB, it is common to create all application servers with the WebSphereProcess Server template.

    A node is a grouping of application servers for configuration and operationalmanagement on one machine. Nodes are generally associated with aphysical machine. It is possible to have multiple nodes on a single machinebut nodes cannot span machines. A node agent in the node is the contactpoint for the deployment manager during cell administration.

    As with application servers, nodes also have levels of capability that supporttheir environment.

    Acellis a grouping of nodes into a single administrative domain. A cell canconsist of multiple nodes, which are all administered from a single point (thedeployment manager).

    f f 7643R Pl f

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    17/256

    Chapter 1. Planning for installation 3

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

    1.1.1 Profiles

    Runtime environments are built by creatingprofiles. Each profile contains filesspecific to that runtime such as logs and configuration files. Profiles can becreated during installation and after. After a profile is created, further

    configuration to the runtime environment is done using WebSphereadministrative tools that include scripting, commands, and the administrativeconsole.

    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 installationdirectory, but they can be located anywhere. All profiles share the productbinaries.

    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 areactually profiles built for WebSphere Application Server Network Deployment andaugmented with the process server or ESB function.

    Profile typesThere are three profile types used to define server environments:

    Stand-alone server: This type of profile creates an application server that ismanaged from its own administrative console. It functions independently fromall other servers and deployment managers.

    When the tool your are using to create profiles offers the choice of creating aprofile for multiple environments, the stand-alone server option is associated

    with a WebSphere Application Server Network Deployment profile. Theprofiles augmented for additional function are referred to as:

    Stand-alone process server profile: A stand-alone server profile thathas been augmented for WebSphere Process Server.

    Stand-alone enterprise service bus profile: A stand-alone service busprofile that has been augmented for WebSphere ESB.

    Deployment manager: This type of profile creates a deployment managerthat is used to administer nodes that are federated into its cell.

    Custom: A custom profile contains an empty node. No application server ordeployment manager is defined by this profile. The typical use for a customprofile is to federate its node to a deployment manager. After federating the

    7643RunPlan fm Draft Doc ment for Re ie J ne 3 2008 1 55 pm

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    18/256

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

    4 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

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

    Augmenting profiles

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

    On distributed and i5/OS systems, augmentation to stand-alone servers orunfederated custom nodes can be done using the Profile Management Tool orthe 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, thenaugmented. Removing the node from the deployment manager will restore thenode to the configuration saved prior to using addNode command. Data might belost. The deployment manager profile must also be federated. Then the customprofile can be federated back to the cell. The deployment manager must also beaugmented 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.ibm.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.ibm.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 serversIn astand-alone serverenvironment, each application server acts as a uniqueentity. 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 throughindependent installations of the WebSphere Process Server code or by creating

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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/tins_aug_profiles.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/tins_aug_profiles.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/rins_zos_configscript.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/rins_zos_configscript.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/rins_zos_configscript.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/tins_aug_profiles.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    19/256

    Chapter 1. Planning for installation 5

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

    multiple application server profiles within one installation. However, WebSphereProcess Server does not provide centralized management or administration formultiple stand-alone application servers. Stand-alone application servers do notprovide workload management or failover capabilities.

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

    Profiles

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

    Distributed application serversA distributed serverconfiguration enables central administration, workloadmanagement, and failover. In this environment, you integrate one or more nodesinto a cell that is managed by a deployment manager. Administration andmanagement is handled centrally from the deployment manager.

    Each node has one or more application servers. The nodes can reside on thesame machine as the deployment manager or on multiple separate machines.Each node has a node agentthat works with the deployment manager to manageadministration 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 twoapplication servers.

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    20/256

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

    6 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    Figure 1-1 Distributed servers

    With a distributed server configuration, you can create multiple applicationservers to run unique sets of applications and then manage those applicationsfrom a central location. However, more importantly, you can clusterapplication

    servers to allow for workload management and failover capabilities. Applicationsthat you install in the cluster are replicated across the application servers. Whenone server fails, another server in the cluster continues processing. Workload isdistributed among Web and EJB containers in a cluster using a weightedround-robin scheme.

    Profiles

    A distributed server environment consists of one deployment manager profileand one or more custom node profiles.

    The easiest way to build a new WebSphere Process Server distributedenvironment is to use the deployment environment patterns. Each cell can havemultiple deployment environments configured.

    A typical process for creating a new non-productionWebSphere Process Serverenvironment 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 deploymentmanager option. This will build a deployment manager profile and will prepare

    Cell

    Server B

    DeploymentManager

    Server A

    Node

    Application

    ServerApplication

    Server

    NodeAgent

    Server C

    Node

    Application

    ServerApplication

    Server

    NodeAgent

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    21/256

    Chapter 1. Planning for installation 7

    a ocu e o e e Ju e 3, 008 55 p 7643RunPlan.fm

    the environment, including creating the databases required for WebSphereProcess Server.

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

    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 deploymentmanager first, then use the administrative console to create the deploymentenvironment. This gives you the ability to use multiple databases for the

    WebSphere Process Server components.

    A typical process for creating a new productionWebSphere Process Serverenvironment would be:

    1. Install WebSphere Process Server on the deployment manager host andcreate 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 greatercontrol over the database configuration options.

    Examples of building topologies based on deployment environment patterns canbe found in Chapter 3, Creating profiles on distributed and i5/OS systems onpage 51.

    1.1.3 WebSphere Application Server for z/OS

    While WebSphere Application Server for z/OS has the same basic conceptspreviously discussed, it contains a unique process model that enables theproduct 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 ina different process that together represents a single server instance. A server iscomposed 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/OSenvironment.

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    22/256

    p

    8 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    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 spaceAn address space is the area of successive virtual addresses that z/OS assignsto a user (or separately running program) for executing instructions and storingdata. It is equivalent to a process on distributed platforms.

    Control regionThe control region (CR) is basically the only public interface to this collection ofJVMs 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 servantcontrollers for processing. In short, a CR is like a router or even an addressspace that binds the TCP ports used by the server. A CR does have anembedded JVM, which is the only JVM allowed to receive connections fromthe outside world. Each server has only one CR that is started through a JCLstart procedure.

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

    MVS ITSO SYS B

    Daemon

    CR

    Node Agent

    CR

    DMGR

    CR A

    Daemon

    CR

    Node Agent

    CR

    AppServer

    CR SR

    AppServer

    CR SR

    MVS ITSO SYS A

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    23/256

    Chapter 1. Planning for installation 9

    Figure 1-3 Inside the application server

    Control region adjunctThe control region adjunct is a specialized servant that interfaces with newservice integration buses to provide messaging services.

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

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

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

    JCL startprocedure

    System console

    Controllerregion

    zWLM

    Servant region #1

    JVM

    Application

    Servant region #n

    JVM

    Application

    JCL start

    procedure

    J2EE application server

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    24/256

    10 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    DaemonA daemon server provides the location name service for external clients. There isone daemon per cell per MVS image. If your cell consists of multiple MVSimages, a daemon will be created for each MVS image where your cell exists. Ifthere 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 onthat MVS image is started. If you kill a daemon, all the servers for that cell on thatMVS 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 highavailability, scalability, and performance. The topology selected will determine thenumber of systems you need to install the product on, the profiles you will needto create, and your path through the installation and profile creation process.

    This section will describe common topologies, starting with a simple stand-aloneserver topology, and progressing to more complex topologies that have been

    identified as common deployment patterns.

    1.2.1 Stand-alone server topology

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

    With this topology, there is no central configuration management. The applicationserver has its own administrative console. There are no workload managementor high availability features with this topology.

    Note: For a more in-depth discussion of topologies for WebSphere ProcessServer and WebSphere Enterprise Service Bus topologies, see:

    Production Topologies for WebSphere Process Server and WebSphereESB V6, SG24-7413

    z/OS Getting Started: WebSphere Process Server and WebSphereEnterprise Service Bus V6, SG24-7378

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    25/256

    Chapter 1. Planning for installation 11

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

    Figure 1-4 Stand-alone server topology

    1.2.2 Deployment environment patterns

    A set of deployment environment patterns have been identified that representcommon deployment scenarios. WebSphere Process Server provides built-insupport for these patterns in the installation process, the profile creation tools,and administrative console. These patterns assist in creating the profiles andconfiguration settings that define complex deployment environments, includingthe 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. Thepatterns defined by this support are also legitimate patterns for a z/OSenvironment, but at the time of this publication, the use of the deployment

    Example: For an example of this topology, see 3.2, Standalone WebSphereProcess Server on page 56.

    Node1

    WebSphere Process Server

    Application

    Modules

    Mediation modules

    Support

    Messaging

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    26/256

    12 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

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

    Cluster pattern componentsThe patterns use application server clustering to provide failover and loadbalancing for components in the topology. The support for these components hasbeen broken down into the following categories:

    Messaging components that support the WebSphere Process Server andWebSphere ESB environment:

    Service Component Architecture (SCA) application bus. This bus exists asa 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 WebSphereESB environment:

    CEI server

    Business Rules Manager

    BPC Explorer and BPC Observer

    Application components

    Application deployment target

    1.2.3 Single cluster pattern

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

    Using patterns for WebSphere Process Server and WebSphere ESB:

    When used to create a WebSphere Process Server environment, theapplication 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 complexdeployment environments, see Chapter 3, Creating profiles on distributedand i5/OS systems on page 51

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    27/256

    Chapter 1. Planning for installation 13

    This pattern is recommended for the scenarios where most invocations aresynchronous. Messaging use should be minimal and applications role shoulddominate 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 hostboth business integration and mediation applications. Applications are installedto the cluster.

    Figure 1-5 Single cluster pattern

    1.2.4 Remote messaging pattern

    The remote messaging pattern defines one cluster for application deploymentand one remote cluster for the messaging infrastructure. The common eventinfrastructure and other support applications are configured on the applicationdeployment cluster. This pattern is recommended for scenarios involving heavyasynchronous invocations. However, this is not ideal when other supportingruntime components are actively involved.

    Applications are installed to the application deployment cluster.

    Example: For an example of this topology, see 3.3, Building a deploymentenvironment using a pattern on page 66.

    Node1

    WebSphere

    ProcessServer

    Node2

    WebSphere

    ProcessServer

    WebSphereProcessServer

    WebSphereProcessServer

    Cluster1

    Application

    Modules

    Mediation modules

    Support

    Messaging

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    28/256

    14 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    In this pattern, the messaging cluster is assigned as a member of the serviceintegration buses that provide support for the WebSphere Process Server andWebSphere ESB infrastructure. The SCA.Application bus has one bus member(the messaging cluster) by default.

    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, andone remote cluster for the common event infrastructure and other supportapplications.This pattern performs well, providing the most scalable, flexible andversatile topology pattern. If in doubt, select this pattern.

    Node1

    WebSphereProcessServer

    Node2

    WebSphereProcessServer

    Cluster1

    WebSphereProcessServer

    WebSphereProcessServer

    Cluster2

    Messaging

    Application

    Modules

    Mediation modules

    Support

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    29/256

    Chapter 1. Planning for installation 15

    Figure 1-7 Remote messaging and remote support pattern

    1.2.6 Web servers

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

    A plug-in configuration file generated on the application server and placed on theWeb server is used for routing information. In order to manage the generationand propagation of these plug-in configuration files, Web servers are defined to

    the WebSphere configuration repository. In some cases, Web serverconfiguration and management features are also available from the WebSphereadministrative tools.

    Example: For an example of this topology, see 3.3, Building a deploymentenvironment using a pattern on page 66.

    Node1

    WebSphereProcessServer

    Node2

    WebSphereProcessServer

    WebSphereProcessServer

    WebSphereProcessServer

    Cluster1

    Cluster2

    WebSphereProcessServer

    WebSphereProcessServer

    Cluster3

    Messaging

    Support

    Application

    Modules

    Mediation modules

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    30/256

    16 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    Figure 1-8 Remote messaging and remote support pattern

    Managed Web servers versus unmanagedA 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 administrativetools for all supported Web servers. For example, generation of a plug-inconfiguration can be performed for all Web servers. If the Web server is definedon a managed node, automatic propagation of the plug-in configuration can beperformed using node synchronization. If the Web server is defined on an

    unmanaged node, automatic propagation of a plug-in configuration is onlysupported for IBM HTTP Servers.

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

    Unmanaged nodes

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

    Node1

    WebSphere

    ProcessServer

    WebServer

    Node2

    WebSphere

    ProcessServer

    WebSphereProcessServer

    WebSphereProcessServer

    Cluster1

    Cluster2

    WebSphereProcessServer

    WebSphereProcessServer

    Cluster3

    Messaging

    Support

    ApplicationModules

    Mediation modules

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    31/256

    Chapter 1. Planning for installation 17

    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 Webserver that is defined to an unmanaged node. You must install an updated plug-inconfiguration file manually to a Web server that is defined to an unmanagednode.

    Managed nodes

    In a distributed server environment, you can define multiple Web servers. TheseWeb servers can be defined on managed or unmanaged nodes. A managed nodehas 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 Administrationserver 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 aWeb server configuration script named configure. Thisconfiguration 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

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

  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    32/256

    18 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    application server can have only one Web server definition. A distributed serverenvironment, on the other hand, can have multiple Web server definitions. Thescript creates a new Web server definition unless the Web server name is thesame.

    The Plug-ins installation wizard stores the script in the /bindirectory on the Web server machine. If the plug-in is installed locally (on thesame machine as the application server), the configuration script will be runautomatically.

    For remote installations, you must copy the script from the Web server machineto the WPS_install_root/bin directory on the application server machine forexecution. The script runs against the default profile. If one machine is runningunder Linux or UNIX and the other machine is running under Windows, use

    the script created in the /bin/crossPlatformScripts directory.

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

    For more information about the installation of Web server plug-ins and how theWeb server definitions scripts are generated and executed, see WebSphereApplication 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 creationscenarios. However, this is not intended to be a comprehensive planning guide.

    Please refer to the WebSphere Process Server V6.1.0 information center formore 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.ibm.websphere.wps.610.doc/doc/cpln_plancons.html

    Note: Always open a new command window in which to execute theconfigurescript. There is a potential conflict between ashell environment variable, the WAS_USER_SCRIPT variable, and the realdefault profile. The script always works against the default profile. However, ifthe WAS_USER_SCRIPT environment variable is set, a conflict arises as thescript attempts to work on the profile identified by the variable.

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

    Pl i f W bS h P S ( /OS)

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cpln_plancons.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cpln_plancons.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cpln_plancons.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cpln_plancons.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    33/256

    Chapter 1. Planning for installation 19

    Planning for WebSphere Process Server (z/OS)

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.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/WP100653

    1.3.1 Prerequisites

    Before starting the installation process, check the following Web site to makesure 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 allowsyou 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 toreview 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.ibm.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 thatsystem. 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.

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

    1 3 3 Installation methods

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/cpln_plancons.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/cpln_plancons.htmlhttp://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP100653http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP100653http://www-1.ibm.com/support/docview.wss?uid=swg2700620http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/rins_nonroot.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/rins_nonroot.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/iins_nonrootprofile.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/iins_nonrootprofile.htmlhttp://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP100653http://www-1.ibm.com/support/docview.wss?uid=swg2700620http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/cpln_plancons.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/iins_nonrootprofile.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/rins_nonroot.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    34/256

    20 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    1.3.3 Installation methods

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

    Distributed systemsInstallation on distributed systems can be done interactively or silently. Interactiveinstallation is initiated by executing the launchpad interface and selecting theoption to install WebSphere Process Server. An example of this can be found inChapter 2, Installation on distributed and i5/OS systems on page 37.

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

    Both installation methods install the binary files and (optionally) allow you tocreate one profile. Additional profiles can be created after installation using thePMT ormanageprofiles 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.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.html

    i5/OSInstallation 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 beChapter 2, Installation on distributed and i5/OS systems on page 37.

    The installation installs the binary files and optionally, allows you to create oneprofile. Additional profiles can be created after installation using the PMT on aWindows workstation or themanageprofiles 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.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.html

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

    z/OS

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/welcome_wps_ins.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    35/256

    Chapter 1. Planning for installation 21

    z/OSInstallation 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 eachWebSphere Application Server profile directory.

    5. Create the appropriate databases and storage groups required byWebSphere Process Server.

    6. Run the zWPSConfig.sh to configure the server as a process server, enablingthe server to handle business processes and mediations.

    For information on these steps, see the information center, starting with thisarticle:

    Installing and configuring WebSphere Process Server (z/OS)

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.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. Thisinstallation path allows you to define a WebSphere Enterprise Service Bus orWebSphere Process Server environment consisting of one stand-aloneserver, a deployment manager, or a custom profile during the installation

    process. The common database is created using the default for the operatingsystem. You may also elect to create no profiles during installation.

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

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

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

    Deployment Environment Installation: A full installation of WebSphere

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/iins_zos_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/iins_zos_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/iins_zos_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/iins_zos_welcome.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    36/256

    22 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    Deployment Environment Installation: A full installation of WebSphereProcess Server. This installation choice guides you through the process ofsetting up a deployment environment. You can choose a deployment managerbased on a deployment environment pattern or continue to define adeployment environment that you have already created. This option allows

    you to select from a limited list of database providers for the commondatabase. After installation, you create additional profiles using the ProfileManagement Tool or manageprofiles command.

    Client Installation: A partial installation of WebSphere Process Server thatallows you to run a client application that interacts with a WebSphereEnterprise 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 thatare 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 IntegrationServer Foundation, version 5.1.1. It will not be supported in future versions ofWebSphere 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/com.ibm.websphere.wps.610.doc/doc/cadm_busiru_overview.html

    Deprecated features

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.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 IntegrationServer Foundation, version 5.1.1. It will not be supported in future versions ofWebSphere Process Server. Instead of using the Extended MessagingService and its associated tools, the standard JMS APIs, or equivalent

    messaging technologies should be used.

    For more information, see:

    Deprecated features

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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/co

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cadm_busiru_overview.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cadm_busiru_overview.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cadm_busiru_overview.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    37/256

    Chapter 1. Planning for installation 23

    p //p / / p/ / p /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 developmentenvironments, 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/com.ibm.websphere.wps.610.doc/doc/covw_sample_tutorial.html

    1.3.6 Root directoryYou will need to specify a location for the installation. The default root directoriescan 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 torun. With the exception of stand-alone topologies, every topology will needmultiple profiles. With distributed and i5/OS installations, you have the option ofcreating a profile during installation. After installation, you can create additionalprofiles 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 Softwareand install all recommended fixes. The Update Installer can be installed from thelaunchpad.

    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

    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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/covw_sample_tutorial.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/covw_sample_tutorial.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/rins_installation_paths.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/rins_installation_paths.htmlhttp://www-1.ibm.com/support/docview.wss?rs=2307&uid=swg27006649http://www-1.ibm.com/support/docview.wss?rs=2307&uid=swg27006649http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/rins_installation_paths.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/rins_installation_paths.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/gmig_deprecationlist.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/covw_sample_tutorial.htmlhttp://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&q1=PK59140&uid=swg27011675&loc=en_US&cs=utf-8&lang=enhttp://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&q1=PK59140&uid=swg27011675&loc=en_US&cs=utf-8&lang=en
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    38/256

    24 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    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 andruntime environment. These decisions are logically separate from those made forinstallation. However, since you can create profiles during installation, thesetopics should be considered during your initial planning.

    Profiles on distributed and i5/OS systems can be created in one of the followingways:

    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 NetworkDeployment profiles.

    2. Augment the profiles for WebSphere Process Server or WebSphere ESB.

    Configuring WebSphere Application Server for z/OS requires a fair amount ofplanning and coordination. For example, when defining multiple deploymentmanagers or application servers on a single machine or LPAR, you need toensure that the ports and names you select for each are unique and the z/OSenvironment variables, generated jobs, and so on, were all set up properly. Westrongly 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 theexecution of business processes and mediations. The set of tables that make upeach database can be stored in a separate physical database, or can be acombined with others in a larger common database. The database configurationyou choose will depend on the features that you use and performanceconsiderations. 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 beforeit is started.

    The following is the list of logical databases:

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

    WebSphere Process Server components and the enterprise service bus use

    http://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&q1=PK59140&uid=swg27011675&loc=en_US&cs=utf-8&lang=enhttp://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&q1=PK59140&uid=swg27011675&loc=en_US&cs=utf-8&lang=enhttp://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&q1=PK59140&uid=swg27011675&loc=en_US&cs=utf-8&lang=en
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    39/256

    Chapter 1. Planning for installation 25

    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 BusinessProcess Execution database. The default name for this database is BPEDB.

    A Business Process Execution Observer database, referred to as theobserver database. The default name for this database is OBSRVDB.

    A database for the messaging engines. The default name for this database isMEDB.

    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 databasesThe minimal configuration for a WebSphere Process Server or WebSphere ESB

    configuration is the common database that contains all the database tables. Thisis not recommended for a production system. This is the configuration you willget if you use the Profile Management Tool to create the databases. In this seriesof books, we will use this configuration.

    For production systems, it is recommended that you create the databases andupdate the appropriate data sources manually. This gives you maximum controlover the location and grouping of database tables. To do this, you choose theoption 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 eventdatabases, and will create the data sources based on information you provideduring profile creation. Create the databases using the scripts or your owncommands and update the appropriate data sources.

    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 schemanames are unique within the logical partition (LPAR).

    There are also unique considerations for selecting the driver needed toconnect remotely to an i5/OS database server. For more information, see:

    Database specifications

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

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

    Finding the database scripts and specifications

    http://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&uid=swg27006205http://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&uid=swg27006205http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cins_db_specs.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cins_db_specs.htmlhttp://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&uid=swg27006205http://www-1.ibm.com/support/docview.wss?rs=2307&context=SSQH9M&uid=swg27006205http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cins_db_specs.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cins_db_specs.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    40/256

    26 Getting Started with WebSphere Process Server and WebSphere ESB Part 3: Runtime

    You can find scripts for the common database, the BPEDB and the OBSRVDB inWPS_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 commondatabase with the attributes you specified during profile creation.

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

    For the messaging engines you can use the sibDDLGenerator script to generatethe database scripts. Information about the messaging engine databases can befound at:

    Messaging engine database specifications

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.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 acommon 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 thedatabase 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

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

    DB2 for z/OS v9 Oracle 9i and 10g

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cins_messaging_engine_db_specs.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cins_messaging_engine_db_specs.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/cins_messaging_engine_db_specs.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/cins_messaging_engine_db_specs.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.z.610.doc/doc/cins_messaging_engine_db_specs.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.websphere.wps.610.doc/doc/cins_messaging_engine_db_specs.html
  • 8/9/2019 Gettingstarted With WPS&ESB Part3

    41/256

    Chapter 1. Planning for installation 27

    Oracle 9i and 10g

    If you elect to defer the database creation, scripts will be created for your use indefining 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 tocreate the data source and the scripts. The scripts are located inprofile_root/dbscripts/CommonDB/dbType/dbName.

    For more information, see:

    Common database specifications

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r1mx/topic/com.ibm.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.ibm.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

    DerbyEmbedded

    Install (typical) - standalone profile (the default - no option) 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 (