ibm.com/redbooks

IBM WebSphere Front cover

WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

Fabio AlbertoniTanja Baumann

Yogesh BhatiaEduardo Monich Fronza

Marcio da Ros GomesSebastian Kapciak

Catalin MierleaSergio Pinto

Anoop RamachandraLiang Rui

Miguel Troncoso

Learn about Websphere Application Server V8.5.5

Configure and administer a WebSphere system

Deploy applications in a WebSphere environment

http://www.redbooks.ibm.com/ http://www.redbooks.ibm.com/

International Technical Support Organization

WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

July 2013

SG24-8056-01

Copyright International Business Machines Corporation 2012, 2013. All rights reserved.Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP ScheduleContract with IBM Corp.

Second Edition (July 2013)

This edition applies to WebSphere Application Server V8.5, including the features in V8.5.5.

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

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xixTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xx

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiAuthors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiNow you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxivComments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxivStay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv

Part 1. Installation and profile management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 1. System management: Technical overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.1 WebSphere Application Server profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 System management overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.2.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2.2 Directory conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2.3 Core concepts of system management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2.4 System management tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.3 New features for administrators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.4 Java Management Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.4.1 JMX architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.4.2 JMX MBeans. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.5 System management in a stand-alone server environment . . . . . . . . . . . . . . . . . . . . . 111.6 System management in a distributed server environment . . . . . . . . . . . . . . . . . . . . . . 12

1.6.1 Centralized changes to configuration and application data. . . . . . . . . . . . . . . . . . 141.6.2 Rules for process startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181.6.3 Distributed process discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181.6.4 File synchronization in distributed server environments . . . . . . . . . . . . . . . . . . . . 20

1.7 Advanced system management of multiple stand-alone servers . . . . . . . . . . . . . . . . . 251.8 Advanced management of distributed and stand-alone servers . . . . . . . . . . . . . . . . . . 28

Chapter 2. Installing WebSphere Application Server on distributed systems . . . . . . 312.1 IBM Installation Manager overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322.1.2 Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.2 Installation Manager installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342.2.1 Using the GUI installer to install Installation Manager. . . . . . . . . . . . . . . . . . . . . . 342.2.2 Using console mode to install Installation Manager . . . . . . . . . . . . . . . . . . . . . . . 352.2.3 Using the command line to install Installation Manager . . . . . . . . . . . . . . . . . . . . 362.2.4 Using the silent installer to install Installation Manager. . . . . . . . . . . . . . . . . . . . . 372.2.5 Uninstalling Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

2.3 Using Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382.3.1 Wizard mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382.3.2 Command-line mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392.3.3 Console mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392.3.4 Silent mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.4 Customizing Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412.4.1 Installation Manager preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412.4.2 Repositories overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Copyright IBM Corp. 2012, 2013. All rights reserved. iii

2.4.3 Repository configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432.4.4 Updating Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452.4.5 Managing packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452.4.6 Examining log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.5 Installing WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462.5.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472.5.2 Using GUI mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472.5.3 Using silent mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

2.6 Installing additional software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522.6.1 WebSphere Customization Toolbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522.6.2 Application Client for WebSphere Application Server V8.5. . . . . . . . . . . . . . . . . . 56

Chapter 3. Working with profiles on distributed systems . . . . . . . . . . . . . . . . . . . . . . . 593.1 Types of profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

3.1.1 Application server profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603.1.2 Deployment manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603.1.3 Custom profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613.1.4 Cell profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613.1.5 Administrative agent profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613.1.6 Job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

3.2 Planning for profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633.3 Building systems with profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

3.3.1 Starting the WebSphere Customization Toolbox Profile Management Tool . . . . . 643.3.2 Common steps for all profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653.3.3 Creating an application server profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743.3.4 Creating a deployment manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783.3.5 Creating a cell profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803.3.6 Creating a custom profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 813.3.7 Federating nodes to a cell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833.3.8 Creating a job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883.3.9 Creating an administrative agent profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 893.3.10 Registering nodes to an administrative agent . . . . . . . . . . . . . . . . . . . . . . . . . . . 903.3.11 Deregistering a node from the administrative agent . . . . . . . . . . . . . . . . . . . . . . 923.3.12 Registering administrative nodes with a job manager. . . . . . . . . . . . . . . . . . . . . 92

3.4 Managing profiles with the command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953.4.1 Listing profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953.4.2 Creating profiles from templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953.4.3 Creating profiles with non-default ports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 963.4.4 Deleting profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 973.4.5 Using the manageprofiles interactive utility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Chapter 4. Installing WebSphere Application Server on z/OS systems. . . . . . . . . . . 1014.1 IBM Installation Manager overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024.2 Installing Installation Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

4.2.1 Checking prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044.2.2 Obtaining an Installation Manager installation kit . . . . . . . . . . . . . . . . . . . . . . . . 1044.2.3 Installing Installation Manager on the system . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

4.3 Working with Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1074.3.1 Installation Manager preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1074.3.2 Repository overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1074.3.3 Updating Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1084.3.4 Installing the WebSphere Application Server initial repository . . . . . . . . . . . . . . 108

4.4 Using Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

iv WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

4.4.1 Key features of Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1094.4.2 Uninstalling Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

4.5 Installing WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1124.5.1 Installing using the command line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1124.5.2 Installing additional packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1134.5.3 Creating response files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1144.5.4 Installing silently . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1154.5.5 The post-installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1164.5.6 Service information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1164.5.7 Uninstalling packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1174.5.8 Preparing the base z/OS operating system . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

4.6 WebSphere Customization Toolbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1184.7 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

4.7.1 Error message overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1194.7.2 Collecting Installation Manager information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Chapter 5. Working with profiles on z/OS systems . . . . . . . . . . . . . . . . . . . . . . . . . . . 1215.1 Creating WebSphere environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

5.1.1 WebSphere Application Server for z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1245.1.2 WebSphere DMZ secure proxy server for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . 124

5.2 Getting started with the Profile Management tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1245.3 Creating a sample z/OS Network Deployment cell . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

5.3.1 Creating a deployment manager definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1285.3.2 Creating the base application server definition . . . . . . . . . . . . . . . . . . . . . . . . . . 1485.3.3 Uploading jobs and associated instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1615.3.4 Federating an application server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1625.3.5 Uploading jobs and associated instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

5.4 Creating a job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1665.4.1 Creating the customization definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1675.4.2 Uploading the jobs and the associated instructions . . . . . . . . . . . . . . . . . . . . . . 174

5.5 Creating an administrative agent profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1745.5.1 Creating the customization definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1755.5.2 Uploading jobs and the associated instructions . . . . . . . . . . . . . . . . . . . . . . . . . 182

Chapter 6. Administration consoles and commands . . . . . . . . . . . . . . . . . . . . . . . . . 1836.1 Introducing the WebSphere administrative consoles . . . . . . . . . . . . . . . . . . . . . . . . . 184

6.1.1 Starting and accessing the consoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1856.1.2 Logging into an administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1876.1.3 Changing the administrative console session timeout . . . . . . . . . . . . . . . . . . . . 1926.1.4 The graphical interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1926.1.5 Administrative console resources scopes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1986.1.6 Updating existing items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2036.1.7 Adding new items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2046.1.8 Removing items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2046.1.9 Starting and stopping items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2056.1.10 Using variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2056.1.11 Saving work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2076.1.12 Getting help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2076.1.13 New options in version 8.5 deployment manager administrative console. . . . . 208

6.2 Securing the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2116.2.1 Enabling security after profile creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2116.2.2 Administrative security roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

6.3 Job manager console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

Contents v

6.3.1 Submitting a job with the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186.3.2 Distributing files using the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

6.4 Using command-line tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2276.4.1 Command location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2276.4.2 Key usage parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286.4.3 Entering commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

Part 2. Administration and configuration techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Chapter 7. Administration of WebSphere processes. . . . . . . . . . . . . . . . . . . . . . . . . . 2337.1 Working with deployment manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

7.1.1 Deployment manager configuration settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2347.1.2 Starting and stopping the deployment manager . . . . . . . . . . . . . . . . . . . . . . . . . 2387.1.3 The high-availability deployment manager function . . . . . . . . . . . . . . . . . . . . . . 240

7.2 Working with the administrative agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2417.2.1 Starting and stopping the administrative agent . . . . . . . . . . . . . . . . . . . . . . . . . . 2417.2.2 Administrative agent configuration settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

7.3 Working with the job manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2447.3.1 Starting and stopping the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2447.3.2 Job manager configuration settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

7.4 Working with application servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2487.4.1 Creating an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2487.4.2 Viewing the status of an application server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2587.4.3 Starting an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2617.4.4 Stopping an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2667.4.5 Viewing runtime attributes of an application server. . . . . . . . . . . . . . . . . . . . . . . 2687.4.6 Customizing application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2707.4.7 Repository checkpoints service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

7.5 Working with nodes in a Network Deployment environment . . . . . . . . . . . . . . . . . . . . 2827.5.1 Starting and stopping nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2827.5.2 Node agent synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2857.5.3 Removing a node from a cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2877.5.4 Renaming a node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2897.5.5 Recovering an existing node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2897.5.6 Node groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

7.6 Working with clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2927.6.1 Creating application server clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2927.6.2 Viewing the cluster topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3017.6.3 Managing clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

7.7 Working with virtual hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3037.8 Creating and updating virtual hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3047.9 Managing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

7.9.1 Managing enterprise applications: Administrative console . . . . . . . . . . . . . . . . . 3067.9.2 Preventing an enterprise application from starting on a server. . . . . . . . . . . . . . 3077.9.3 Viewing application details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3077.9.4 Finding a URL for a servlet or JSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

7.10 Enabling process restart on failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3137.10.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3157.10.2 UNIX and Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3167.10.3 z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

Chapter 8. Administration with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3198.1 Overview of WebSphere scripting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3208.2 Launching wsadmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

vi WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

8.2.1 Scripting environment properties file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3228.2.2 Script profile file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3238.2.3 Connected versus local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

8.3 Command and script invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3248.3.1 Invoking a single command (-c) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3248.3.2 Running script files (-f) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3248.3.3 Invoking commands interactively . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

8.4 The wsadmin tool management objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3258.4.1 Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3268.4.2 AdminControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3278.4.3 AdminConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3278.4.4 AdminApp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3278.4.5 AdminTask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

8.5 Properties file based configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3288.6 Managing WebSphere using script libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

8.6.1 Invoking script libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3308.6.2 Displaying help for script libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3318.6.3 Application script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3328.6.4 Resource script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3348.6.5 Security script library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3358.6.6 Server script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3368.6.7 System management script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3388.6.8 Applying performance tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

8.7 Assistance with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3398.7.1 Enabling command assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3398.7.2 Building script files using command assist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

8.8 Example: Using scripts with the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3438.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3438.8.2 Creating the customized script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3458.8.3 Submitting the job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3488.8.4 Verifying the results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

8.9 Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

Chapter 9. Accessing relational databases from WebSphere. . . . . . . . . . . . . . . . . . . 3519.1 JDBC resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

9.1.1 JDBC providers and data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3529.1.2 WebSphere support for data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

9.2 Steps to define access to a database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3559.3 Creating an authentication alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3569.4 Connecting to an IBM DB2 database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

9.4.1 Creating the JDBC provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3579.4.2 Creating the data source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

9.5 Connecting to an Oracle database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3639.5.1 Creating the JDBC provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3639.5.2 Creating the data source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

9.6 Connecting to an SQL Server database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3679.6.1 Creating the JDBC provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3689.6.2 Creating the data source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

9.7 Configuring connection pooling properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3739.8 WebSphere Application Server data source properties . . . . . . . . . . . . . . . . . . . . . . . 3769.9 Shared and unshared connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

9.9.1 Factors that determine sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3789.9.2 Configuring Shared and Unshared Connections. . . . . . . . . . . . . . . . . . . . . . . . . 379

Contents vii

9.10 Troubleshooting database access problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3799.10.1 Enabling JDBC tracing for database problems . . . . . . . . . . . . . . . . . . . . . . . . . 3809.10.2 Enabling ConnLeakLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3809.10.3 Dumping connection pool information using wsadmin . . . . . . . . . . . . . . . . . . . 3819.10.4 Tool to debug Database Access problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Chapter 10. Accessing EIS applications from WebSphere . . . . . . . . . . . . . . . . . . . . . 38310.1 JCA resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38410.2 WebSphere Application ServerJCA support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

10.2.1 Resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38610.2.2 Connection factories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

10.3 Installing and configuring resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38710.4 Configuring J2C connection factories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39110.5 Resource authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

10.5.1 Container-managed authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39410.5.2 Component-managed authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

Chapter 11. Configuring messaging providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39711.1 Messaging providers introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39811.2 Configuring resources for the default messaging provider . . . . . . . . . . . . . . . . . . . . 398

11.2.1 Configuring JMS connection factories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39811.2.2 Configuring JMS destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40011.2.3 Configuring JMS queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40111.2.4 Configuring JMS activation specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

11.3 Configuring resources for the WebSphere MQ messaging provider. . . . . . . . . . . . . 40311.3.1 Configuring WebSphere MQ messaging provider connection factories . . . . . . 40411.3.2 Configuring WebSphere MQ messaging provider destinations . . . . . . . . . . . . 40611.3.3 Configuring WebSphere MQ messaging provider activation specifications . . . 409

11.4 Configuring resources for third-party messaging providers. . . . . . . . . . . . . . . . . . . . 41211.4.1 Configuring JMS messaging providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41311.4.2 Configuring JMS connection factories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41311.4.3 Configuring JMS destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414

Chapter 12. Configuring and managing web servers . . . . . . . . . . . . . . . . . . . . . . . . . 41712.1 Web server overview and basic concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418

12.1.1 Request routing using the plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41912.1.2 Web server and plug-in management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

12.2 Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42412.3 Web server configuration using the WebSphere Customization Toolbox . . . . . . . . . 425

12.3.1 Configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42612.3.2 Stand-alone server environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42612.3.3 Distributed server environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42812.3.4 Configuring a remote web server in a distributed environment. . . . . . . . . . . . . 431

12.4 Working with web servers and plug-ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43912.4.1 Manually defining nodes and web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43912.4.2 Viewing the status of a web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44312.4.3 Starting and stopping a web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44412.4.4 IBM HTTP Server remote administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44512.4.5 Mapping modules to servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

12.5 Working with the plug-in configuration file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45012.5.1 Regenerating the plug-in configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45212.5.2 Propagating the plug-in configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45712.5.3 Modifying the plug-in request routing options . . . . . . . . . . . . . . . . . . . . . . . . . . 458

12.6 IBM HTTP Server and Web Server Plug-ins for IBM WebSphere Application Server for

viii WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46112.6.1 IBM HTTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46112.6.2 Web Server Plug-ins for IBM WebSphere Application Server for z/OS . . . . . . 461

12.7 Troubleshooting some common errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46612.7.1 Troubleshooting Error 404 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46612.7.2 Troubleshooting Error 500 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

Chapter 13. Intelligent management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46913.1 Introduction to Intelligent Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47013.2 Configuring dynamic operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

13.2.1 Creating the ODR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47313.2.2 Service policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47513.2.3 Creating service policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47813.2.4 Associating service policies with an application . . . . . . . . . . . . . . . . . . . . . . . . 481

13.3 Configuring health management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48413.3.1 Health conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48413.3.2 Enabling and disabling health management . . . . . . . . . . . . . . . . . . . . . . . . . . . 48513.3.3 Health policy actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48613.3.4 Reaction mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48713.3.5 Creating health policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487

Part 3. Managing distributed systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491

Chapter 14. Performance tuning on distributed environments. . . . . . . . . . . . . . . . . . 49314.1 Performance tuning overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49414.2 Using the queue analogy to tune WebSphere resource pools . . . . . . . . . . . . . . . . . 494

14.2.1 Upstream queuing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49614.2.2 Data source tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49714.2.3 EJB container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49914.2.4 Web container tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50014.2.5 Web server tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50114.2.6 Estimating web container and ORB thread pool initial sizes. . . . . . . . . . . . . . . 50414.2.7 WebSphere Plug-in tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504

14.3 JVM tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50614.3.1 Garbage collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50714.3.2 Sizing the JVM heap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50914.3.3 Sizing the nursery and tenured space when using the gencon policy . . . . . . . 51014.3.4 Using compressed references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

14.4 Other tuning considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51214.4.1 Dynamic caching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51214.4.2 The pass by reference parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51214.4.3 Large page support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51314.4.4 Application tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513

14.5 Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51414.5.1 Tivoli Performance Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51414.5.2 Collecting Java dumps and core files using the administrative console . . . . . . 51414.5.3 IBM Pattern Modelling and Analysis Tool for Java Garbage Collector . . . . . . . 51414.5.4 IBM Monitoring and Diagnostic tools for Java. . . . . . . . . . . . . . . . . . . . . . . . . . 51514.5.5 IBM HTTP server status monitoring page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51514.5.6 WebSphere performance advisors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516

14.6 Case Study . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

Chapter 15. Clustering, workload management, and high availability. . . . . . . . . . . . 51915.1 Clustering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

Contents ix

15.1.1 Clustering for scalability and failover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52015.1.2 Intelligent Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52115.1.3 Dynamic cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52215.1.4 Static cluster versus dynamic cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52315.1.5 Creating a static application server cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52415.1.6 Creating a dynamic application server cluster . . . . . . . . . . . . . . . . . . . . . . . . . 52715.1.7 Setting the operational mode for dynamic clusters . . . . . . . . . . . . . . . . . . . . . . 532

15.2 Workload management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53215.2.1 Dynamic workload management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53315.2.2 Components that can be workload managed . . . . . . . . . . . . . . . . . . . . . . . . . . 53315.2.3 Workload management benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538

15.3 High availability and failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53815.3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53815.3.2 WebSphere Application Server high availability and failover . . . . . . . . . . . . . . 53915.3.3 How high availability features work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545

15.4 ODR server considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54915.4.1 Web server plug-in when using the ODR server. . . . . . . . . . . . . . . . . . . . . . . . 55115.4.2 Configuring the ODR proxy plug-in configuration policy . . . . . . . . . . . . . . . . . . 551

Chapter 16. Monitoring distributed systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55316.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55416.2 Enabling monitoring infrastructures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

16.2.1 PMI defaults and monitoring settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55516.2.2 Enabling request metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

16.3 Viewing the monitoring data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56716.3.1 Starting TPV monitoring and configuring settings. . . . . . . . . . . . . . . . . . . . . . . 56716.3.2 Exploring Tivoli Performance Viewer data views . . . . . . . . . . . . . . . . . . . . . . . 571

16.4 Monitoring examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57516.4.1 JVM memory and CPU usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57616.4.2 Threading resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57816.4.3 Database interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58016.4.4 Request level details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

16.5 Monitoring operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58416.5.1 Runtime operations overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58516.5.2 Creating and managing reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58616.5.3 Configuring the visualization data service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58816.5.4 Task management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58916.5.5 Managing runtime tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

16.6 IBM Tivoli Composite Application Manager for WebSphere Application Server . . . . 59116.6.1 Installing the data collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59116.6.2 Configuring Tivoli Composite Application Manager for WebSphere metrics. . . 59116.6.3 Viewing IBM Tivoli Composite Application Manager for WebSphere data . . . . 593

16.7 Additional resources for monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59516.7.1 Java dump and core files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59516.7.2 Basic logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59616.7.3 Advanced logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59616.7.4 Operating system monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59816.7.5 Summary of monitoring tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

Part 4. Managing z/OS systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

Chapter 17. Performance tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60117.1 Introduction to WebSphere Application Server for z/OS V8.5 performance . . . . . . . 60217.2 External factors and z/OS specifics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602

x WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

17.2.1 Getting the most benefit from collocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60317.2.2 Addressing hardware configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60317.2.3 z/OS tuning tips. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603

17.3 Performance tuning templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60517.4 64-bit considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

17.4.1 Enabling 64-bit mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60717.4.2 Effects of switching to 64-bit mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

17.5 JVM tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61317.5.1 Default garbage collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61317.5.2 General JVM suggestions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613

17.6 Connection pool tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61817.7 Runtime provisioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61817.8 Pass by reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61917.9 Logging and tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620

17.9.1 High Performance Extensible Logging overview. . . . . . . . . . . . . . . . . . . . . . . . 62017.9.2 Enabling HPEL mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62017.9.3 z/OS logging and tracing tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620

17.10 Tuning workload management on z/OS systems . . . . . . . . . . . . . . . . . . . . . . . . . . 62417.10.1 The concept of workload management on z/OS systems. . . . . . . . . . . . . . . . 62417.10.2 Classification rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62517.10.3 Classification XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62617.10.4 Commands and tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627

17.11 Fast response cache accelerator and caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62817.11.1 FRCA overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62917.11.2 Enabling FRCA in WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . 62917.11.3 Cache specification XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63617.11.4 FRCA and RACF integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63717.11.5 Caching enhancements in WebSphere Application Server V8.5 . . . . . . . . . . 63717.11.6 Using IBM Extended Dynamic Cache Monitor to supervise caching . . . . . . . 637

17.12 Using WebSphere for z/OS Optimized Local Adapters. . . . . . . . . . . . . . . . . . . . . . 63817.12.1 Introduction to Optimized Local Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63817.12.2 Enabling WebSphere for z/OS Optimized Local Adapters . . . . . . . . . . . . . . . 640

17.13 IBM HTTP Server Status monitoring page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64317.14 Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643

Chapter 18. Clustering and high availability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64518.1 Clustering on z/OS systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646

18.1.1 Clustering for scalability and failover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64618.1.2 Creating a cluster on a z/OS system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646

18.2 High availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65018.2.1 High availability manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65018.2.2 Core groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65218.2.3 High-availability policies and groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671

18.3 Failover and failback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67418.3.1 High availability and failover of singletons . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67418.3.2 Data replication domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68518.3.3 Session management replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68718.3.4 EJB stateful session bean replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68818.3.5 Cache replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69218.3.6 Resource workload routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69318.3.7 High-availability application update rollout . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697

18.4 Enabling multiple servants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70018.4.1 Balancing workload with WLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702

Contents xi

18.4.2 Balancing workload without WLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70218.5 Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703

Chapter 19. Monitoring z/OS systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70519.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70619.2 Monitoring from the administrative console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707

19.2.1 PMI Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70719.2.2 Monitoring Dynamic Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70819.2.3 Monitoring web services through PMI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708

19.3 IBM Tivoli Composite Application Manager for WebSphere Application Server . . . . 70919.3.1 Installing the data collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71019.3.2 Configuring Tivoli Composite Application Manager for WebSphere metrics. . . 71019.3.3 Viewing IBM Tivoli Composite Application Manager for WebSphere data . . . . 720

19.4 Additional resources for monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72019.4.1 IBM Support Assistant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72019.4.2 Verbose garbage collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72019.4.3 Java dump and core files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72319.4.4 Basic logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72419.4.5 Advanced logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72519.4.6 z/OS monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73119.4.7 Summary of monitoring tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735

Part 5. Working with applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737

Chapter 20. Features for application development and deployment . . . . . . . . . . . . . 73920.1 Java Enterprise Edition 6 support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74020.2 Integrated standards-base programming models and extensions . . . . . . . . . . . . . . 741

20.2.1 Session Initiation Protocol applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74120.2.2 WebSphere Batch programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74220.2.3 OSGi applications programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74420.2.4 Communications enabled applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74520.2.5 Service Component Architecture programming model . . . . . . . . . . . . . . . . . . . 74620.2.6 Extensible Markup Language programming model. . . . . . . . . . . . . . . . . . . . . . 74720.2.7 Integrated Web Services support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74720.2.8 Support for integrated IBM WebSphere Application Server Web 2.0 and Mobile

Toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74720.2.9 Simplified development of server-side REST applications using Java API for

RESTful Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74820.2.10 IBM WebSphere SDK Java Technology Edition Version 7.0 . . . . . . . . . . . . . 748

20.3 Monitored directory support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74820.4 Development and deployment tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748

20.4.1 IBM Assembly and Deploy Tools for WebSphere Administration . . . . . . . . . . . 74820.4.2 WebSphere Application Server Developer Tools for Eclipse . . . . . . . . . . . . . . 74920.4.3 Rational Application Developer for WebSphere Software. . . . . . . . . . . . . . . . . 749

Chapter 21. WebSphere Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75121.1 Overview of WebSphere Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752

21.1.1 Batch jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75221.1.2 Batch applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75221.1.3 Elements of the batch environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753

21.2 Batch programming models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75521.2.1 Transactional batch programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75521.2.2 Compute-intensive programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76121.2.3 Parallel batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762

xii WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

21.2.4 COBOL support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76321.2.5 Batch toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764

21.3 Configuring the batch environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76521.3.1 Configuring the job scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76521.3.2 Securing the job scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76621.3.3 Job scheduler integration with external schedulers . . . . . . . . . . . . . . . . . . . . . 76721.3.4 Configuring grid endpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77021.3.5 Configuring the job scheduler and job management console . . . . . . . . . . . . . . 77021.3.6 Command-line interface for batch jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77121.3.7 Job logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77221.3.8 Job classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773

21.4 Example: Working with batch applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77421.4.1 Enabling the job scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77421.4.2 Verifying the job scheduler installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77521.4.3 Installing the sample batch application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77621.4.4 Securing the job scheduler using Job groups . . . . . . . . . . . . . . . . . . . . . . . . . . 77721.4.5 Using the job management console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78021.4.6 Using the command-line interface for batch jobs . . . . . . . . . . . . . . . . . . . . . . . 78421.4.7 Checking the batch job logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785

Chapter 22. Understanding class loaders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78922.1 JVM class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79022.2 WebSphere Application Server and Java EE application class loaders . . . . . . . . . . 791

22.2.1 WebSphere extensions class loader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79222.2.2 Application and web module class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79322.2.3 Handling Java Native Interface code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794

22.3 Configuring class loaders for Java EE applications . . . . . . . . . . . . . . . . . . . . . . . . . 79522.3.1 Application server class loader policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79522.3.2 Class loading and delegation mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79722.3.3 Shared libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79822.3.4 Class loader viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799

22.4 Learning class loaders for Java EE by example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80022.4.1 Example 1: Simple web module packaging . . . . . . . . . . . . . . . . . . . . . . . . . . . 80022.4.2 Example 2: Adding an EJB module and utility jar . . . . . . . . . . . . . . . . . . . . . . . 80322.4.3 Example 3: Changing the WAR class loader delegation mode. . . . . . . . . . . . . 80422.4.4 Example 4: Sharing utility JAR files using shared libraries . . . . . . . . . . . . . . . . 805

22.5 OSGi class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810

Chapter 23. Packaging and deploying Java EE applications . . . . . . . . . . . . . . . . . . . 81323.1 Java EE applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

23.1.1 Java EE 6 EAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81423.1.2 Development tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81623.1.3 Packaging enterprise applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81723.1.4 Packaging EJB 3.1 modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82023.1.5 Packaging JPA persistence units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82323.1.6 JPA access intent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82323.1.7 Packaging resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82423.1.8 Packaging Web modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82423.1.9 Packaging EJB 3.1 content in Web modules . . . . . . . . . . . . . . . . . . . . . . . . . . 829

23.2 Preparing to use the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83023.2.1 Downloading the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83023.2.2 Importing the application to the development tool. . . . . . . . . . . . . . . . . . . . . . . 83023.2.3 Customizing the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831

Contents xiii

23.2.4 Creating the ITSO Bank DB2 database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83223.2.5 Configuring web module extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833

23.3 Packaging recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83423.4 Creating WebSphere-enhanced EAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835

23.4.1 Configuring a WebSphere enhanced EAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83523.4.2 Configuring application options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83623.4.3 Configuring the JDBC provider and data source for DB2 . . . . . . . . . . . . . . . . . 83723.4.4 Configuring substitution variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84323.4.5 Configuring a virtual host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84323.4.6 Setting the default virtual host for web modules . . . . . . . . . . . . . . . . . . . . . . . . 84423.4.7 Examining the WebSphere-enhanced EAR file . . . . . . . . . . . . . . . . . . . . . . . . 844

23.5 Exporting an application project to an EAR file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84523.6 Preparing the runtime environment for the application . . . . . . . . . . . . . . . . . . . . . . . 846

23.6.1 Creating an environment variable for the application file directory . . . . . . . . . . 84723.6.2 Creating the ITSO Bank application server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 84723.6.3 Defining the ITSO Bank virtual host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85123.6.4 Creating the virtual host for the IBM HTTP Server . . . . . . . . . . . . . . . . . . . . . . 85223.6.5 Creating a DB2 JDBC provider and data source . . . . . . . . . . . . . . . . . . . . . . . 853

23.7 Deploying the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85523.7.1 Deploying using the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . . 85523.7.2 Deploying using the monitored directory support feature . . . . . . . . . . . . . . . . . 86023.7.3 Deploying applications using the job manager . . . . . . . . . . . . . . . . . . . . . . . . . 866

23.8 Deploying business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86823.8.1 Creating a business-level application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 871

23.9 Deploying application clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87423.9.1 Installing application client environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87523.9.2 Preparing the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87523.9.3 Launching the J2EE client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876

Chapter 24. Updating Java EE applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87924.1 Working with applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88024.2 Replacing an entire application EAR file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88024.3 Replacing or adding an application module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882

24.3.1 Replacing or adding single files in an application or module . . . . . . . . . . . . . . 88324.3.2 Removing application content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88324.3.3 Performing multiple updates to an application or module . . . . . . . . . . . . . . . . . 88424.3.4 Rolling out application updates to a cluster. . . . . . . . . . . . . . . . . . . . . . . . . . . . 886

24.4 Application edition management and rollout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88924.4.1 Installing an application edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88924.4.2 Activating an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89024.4.3 Creating routing policies for application editions. . . . . . . . . . . . . . . . . . . . . . . . 89124.4.4 Validating an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89224.4.5 Rolling out an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89424.4.6 Rolling back an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 898

24.5 Hot deployment and dynamic reloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899

Chapter 25. Working with SCA applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90125.1 SCA application introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 902

25.1.1 SCA component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90325.1.2 SCA composite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90325.1.3 SCA contribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905

25.2 Preparing to use the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90625.2.1 Downloading the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 906

xiv WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

25.2.2 Importing the application to the development tool. . . . . . . . . . . . . . . . . . . . . . . 90725.2.3 Completing the service definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907

25.3 Packaging an SCA application for deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90825.3.1 Creating the contribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90925.3.2 Exporting the SCA application for deployment . . . . . . . . . . . . . . . . . . . . . . . . . 911

25.4 Deploying an SCA application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91225.4.1 Importing the SCA archive file as an asset . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91225.4.2 Creating a new business-level application . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91525.4.3 Adding the new asset to the business-level application . . . . . . . . . . . . . . . . . . 91625.4.4 Starting and verifying the business-level application . . . . . . . . . . . . . . . . . . . . 919

25.5 Additional resources for learning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 919

Chapter 26. Working with OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92126.1 OSGi overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922

26.1.1 OSGi application model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92226.1.2 OSGi bundle lifecycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92626.1.3 OSGi Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928

26.2 Enterprise OSGi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92826.3 Using the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 929

26.3.1 Downloading the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92926.3.2 Importing the application to the development tool. . . . . . . . . . . . . . . . . . . . . . . 930

26.4 Packaging OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93226.4.1 Common OSGi patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93326.4.2 Sample application packaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93326.4.3 Exporting OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 935

26.5 Deploying OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93626.5.1 Importing the enterprise bundle archive file as an asset. . . . . . . . . . . . . . . . . . 93626.5.2 Adding the enterprise bundle archive asset to the business-level application . 937

26.6 Administrating OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94026.6.1 Updating OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94026.6.2 Securing OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944

Chapter 27. Working with Service Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94527.1 Service mapping overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946

27.1.1 Service maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94727.2 Local mapping service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950

27.2.1 Creating a local mapping service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95027.2.2 Starting and stopping a local mapping service . . . . . . . . . . . . . . . . . . . . . . . . . 952

27.3 Administration for target service clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95227.3.1 Policy sets and bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95527.3.2 Override target service URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955

27.4 Event emissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95727.4.1 Schema explanation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958

27.5 Securing a service map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959

Chapter 28. Session management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96128.1 Session overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 962

28.1.1 Session identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96228.1.2 Session invalidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96428.1.3 Session listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96428.1.4 Session security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 965

28.2 Session management configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96628.2.1 Session management properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96628.2.2 Accessing session management properties . . . . . . . . . . . . . . . . . . . . . . . . . . . 967

Contents xv

28.2.3 Selecting session tracking options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96928.2.4 Scheduled invalidation configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96928.2.5 Cookie setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970

28.3 Storing session information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97228.3.1 Local sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97228.3.2 Persistent sessions management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97328.3.3 Enabling database persistence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97428.3.4 Memory-to-memory replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976

28.4 Session affinity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98328.4.1 What is the session affinity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98328.4.2 Session affinity and failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984

28.5 Session management tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98628.5.1 Session performance considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98628.5.2 Session management tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98728.5.3 Session database tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994

28.6 Stateful session bean failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99528.6.1 Enabling stateful session bean failover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99528.6.2 Stateful session bean failover consideration. . . . . . . . . . . . . . . . . . . . . . . . . . . 998

Part 6. Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 999

Chapter 29. Managing an environment with the centralized installation manager . 100129.1 The centralized installation manager prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . 1002

29.1.1 Linux and UNIX target requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100229.1.2 Windows target requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100329.1.3 IBM i targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100329.1.4 Additional requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003

29.2 Planning considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100429.2.1 WebSphere Application Server V8 releases. . . . . . . . . . . . . . . . . . . . . . . . . . 100429.2.2 WebSphere Application Server V6.1 and V7 . . . . . . . . . . . . . . . . . . . . . . . . . 1005

29.3 Using centralized installation manager with V8 releases . . . . . . . . . . . . . . . . . . . . 100529.3.1 Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100529.3.2 Accessing the centralized installation manager . . . . . . . . . . . . . . . . . . . . . . . 1007

29.4 Using centralized installation manager with prior releases . . . . . . . . . . . . . . . . . . . 100729.4.1 IBM Update Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100829.4.2 The centralized installation manager repository structure. . . . . . . . . . . . . . . . 100829.4.3 Package types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100929.4.4 Accessing the central installation manager. . . . . . . . . . . . . . . . . . . . . . . . . . . 1010

29.5 Managing V8 release environments with the centralized installation manager. . . . 101229.5.1 Adding new targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101229.5.2 Installing Installation Manager on remote targets . . . . . . . . . . . . . . . . . . . . . . 101629.5.3 Installing a Secure Shell (SSH) public key . . . . . . . . . . . . . . . . . . . . . . . . . . . 102129.5.4 Installing WebSphere Application Server binaries on remote hosts . . . . . . . . 102229.5.5 Creating a WebSphere Application Server profile on a remote target . . . . . . 102429.5.6 Registering and unregistering the profile with the Job Manager . . . . . . . . . . . 102729.5.7 Working with remote targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102929.5.8 Installing maintenance to remote targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103429.5.9 Using the centralized installation manager with a command line . . . . . . . . . . 1035

29.6 Managing V6.1 and V7 with the centralized installation manager. . . . . . . . . . . . . . 103629.6.1 Installing the IBM Installation Factory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103729.6.2 Creating the centralized installation manager repository . . . . . . . . . . . . . . . . 103729.6.3 Adding packages when deployment manager is connected to the Internet . . 103829.6.4 Adding packages when the deployment manager does not have access to the

xvi WebSphere Application Server V8.5 Administration and Configuration Guide for the Full Profile

Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104329.6.5 Adding and removing additional installation targets . . . . . . . . . . . . . . . . . . . . 104529.6.6 Installing a Secure Shell public key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104629.6.7 Installing packages to the target systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104829.6.8 Installing a software package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104929.6.9 Installing maintenance to a target system. . . . . . . . . . . . . . . . . . . . . . . . . . . . 105129.6.10 Uninstalling packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105329.6.11 The centralized installation manager AdminTask commands. . . . . . . . . . . . 1053

Chapter 30. System recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105530.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105630.2 Configuring for backup and restore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056

30.2.1 Backing up a profile configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105630.2.2 Restoring a profile configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105730.2.3 Exporting and importing a configuration archive . . . . . . . . . . . . . . . . . . . . . . . 1059

30.3 Configuring checkpoints service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106130.3.1 Creating repository checkpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106230.3.2 Archiving or deleting checkpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106330.3.3 Restoring checkpoints. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106430.3.4 Configuring change audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1064

30.4 Restoring transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106430.4.1 Restarting an application server in recovery mode. . . . . . . . . . . . . . . . . . . . . 106530.4.2 Administering the transaction service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106530.4.3 Transactional high availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066

30.5 Recovery node with addNode -asExistingNode command . . . . . . . . . . . . . . . . . . . 106730.5.1 Considerations when using the -asExistingNode command . . . . . . . . . . . . . 106730.5.2 Recovering a failed managed node of deployment manager . . . . . . . . . . . . . 106730.5.3 Moving a node to a different system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106930.5.4 Recreating a cell from a template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1073

Chapter 31. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107531.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107631.2 WebSphere Application Server logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1076

31.2.1 Server log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107731.2.2 JVM log interpretation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107931.2.3 Logging modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108231.2.4 High Performance Extensible Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108331.2.5 Cross Component Trace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109131.2.6 Sensitive log and trace guard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109631.2.7 Javacores and Heapdumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109631.2.8 HTTP Plug-in Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1097

31.3 Tools for collecting and analyzi