Ibm ws-as

3,495 views

Published on

IBM Websphere Admin

Published in: Education, Technology
0 Comments
2 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
3,495
On SlideShare
0
From Embeds
0
Number of Embeds
6
Actions
Shares
0
Downloads
159
Comments
0
Likes
2
Embeds 0
No embeds

No notes for slide

Ibm ws-as

  1. 1. ibm.com/redbooks IBM® WebSphere® Front cover WebSphere Application ServerV8.5Administration and Configuration Guide Yogesh Bhatia Tanja Baumann Eduardo Monich Fronza Marcio da Ros Gomes Sebastian Kapciak Catalin Mierlea Anoop Ramachandra Liang Rui Miguel Troncoso Learn about Websphere Application Server V8.5 Configure and administer a WebSphere system Deploy applications in a WebSphere environment
  2. 2. International Technical Support Organization WebSphere Application Server V8.5 Administration and Configuration Guide November 2012 SG24-8056-00
  3. 3. © Copyright International Business Machines Corporation 2012. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. First Edition (November 2012) This edition applies to WebSphere Application Server V8.5. Note: Before using this information and the product it supports, read the information in “Notices” on page xix.
  4. 4. © Copyright IBM Corp. 2012. All rights reserved. iii Contents Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xx Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi The team who wrote this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi Now you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Stay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Part 1. Installation and profile management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 1. System management: Technical overview. . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1 System management overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.1.2 Directory conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.1.3 Core concepts of system management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.1.4 System management tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.2 System management features in WebSphere Application Server V8.5 . . . . . . . . . . . . . 6 1.2.1 Faster delivery of new applications and services . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1.2.2 Improved operational efficiency and reliability . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.2.3 Enhanced administrative control and troubleshooting . . . . . . . . . . . . . . . . . . . . . . 8 1.3 Java Management Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 1.3.1 JMX architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1.3.2 JMX MBeans. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1.4 System management in a stand-alone server environment . . . . . . . . . . . . . . . . . . . . . 10 1.5 System management in a distributed server environment . . . . . . . . . . . . . . . . . . . . . . 11 1.5.1 Centralized changes to configuration and application data. . . . . . . . . . . . . . . . . . 12 1.5.2 Rules for process startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 1.5.3 Distributed process discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 1.5.4 File synchronization in distributed server environments . . . . . . . . . . . . . . . . . . . . 18 1.6 Advanced system management of multiple stand-alone servers . . . . . . . . . . . . . . . . . 23 1.7 Advanced management of distributed and stand-alone servers . . . . . . . . . . . . . . . . . . 26 1.8 Liberty profile management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Chapter 2. Installing WebSphere Application Server on distributed systems . . . . . . 31 2.1 IBM Installation Manager overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 2.1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 2.1.2 Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 2.2 Installation Manager installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 2.2.1 Using the GUI installer to install Installation Manager. . . . . . . . . . . . . . . . . . . . . . 35 2.2.2 Using console mode to install Installation Manager . . . . . . . . . . . . . . . . . . . . . . . 35 2.2.3 Using the command line to install Installation Manager . . . . . . . . . . . . . . . . . . . . 36 2.2.4 Using the silent installer to install Installation Manager. . . . . . . . . . . . . . . . . . . . . 37 2.2.5 Uninstalling Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 2.3 Using Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 2.3.1 Wizard mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 2.3.2 Command-line mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 2.3.3 Console mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 2.3.4 Silent mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
  5. 5. iv WebSphere Application Server V8.5 Administration and Configuration Guide 2.4 Customizing Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 2.4.1 Installation Manager preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 2.4.2 Repositories overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 2.4.3 Repository configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 2.4.4 Updating Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 2.4.5 Managing packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 2.4.6 Examining log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 2.5 Installing WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 2.5.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 2.5.2 Using GUI mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 2.5.3 Using silent mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 2.6 Installing additional software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 2.6.1 WebSphere Customization Toolbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 2.6.2 Application Client for WebSphere Application Server V8.5. . . . . . . . . . . . . . . . . . 56 Chapter 3. Working with profiles on distributed systems . . . . . . . . . . . . . . . . . . . . . . . 59 3.1 Types of profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 3.1.1 Application server profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 3.1.2 Deployment manager profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 3.1.3 Custom profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 3.1.4 Cell profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 3.1.5 Administrative agent profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 3.1.6 Job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 3.1.7 Liberty profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 3.2 Planning for profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 3.3 Building systems with profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 3.3.1 Starting the WebSphere Customization Toolbox Profile Management Tool. . . . . 65 3.3.2 Common steps for all profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 3.3.3 Creating an application server profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 3.3.4 Creating a deployment manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 3.3.5 Creating a cell profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 3.3.6 Creating a custom profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 3.3.7 Federating nodes to a cell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 3.3.8 Creating a job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 3.3.9 Creating an administrative agent profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 3.3.10 Registering nodes to an administrative agent. . . . . . . . . . . . . . . . . . . . . . . . . . . 91 3.3.11 Deregistering a node from the administrative agent . . . . . . . . . . . . . . . . . . . . . . 93 3.3.12 Registering administrative nodes with a job manager. . . . . . . . . . . . . . . . . . . . . 93 3.4 Managing profiles with the command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 3.4.1 Listing profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 3.4.2 Creating profiles from templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 3.4.3 Creating profiles with non-default ports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 3.4.4 Deleting profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 3.4.5 Using the manageprofiles interactive utility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Chapter 4. Installing WebSphere Application Server on z/OS systems. . . . . . . . . . . 101 4.1 IBM Installation Manager overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 4.2 Installing Installation Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 4.2.1 Checking prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 4.2.2 Obtaining an Installation Manager installation kit . . . . . . . . . . . . . . . . . . . . . . . . 104 4.2.3 Installing Installation Manager on the system . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 4.3 Working with Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 4.3.1 Installation Manager preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
  6. 6. Contents v 4.3.2 Repository overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 4.3.3 Updating Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 4.3.4 Installing the WebSphere Application Server initial repository . . . . . . . . . . . . . . 108 4.4 Using Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 4.4.1 Key features of Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 4.4.2 Uninstalling Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 4.5 Installing WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 4.5.1 Installing using the command line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 4.5.2 Installing additional packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 4.5.3 Creating response files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 4.5.4 Installing silently . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 4.5.5 The post-installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 4.5.6 Service information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 4.5.7 Uninstalling packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 4.5.8 Preparing the base z/OS operating system . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 4.6 WebSphere Customization Toolbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 4.7 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 4.7.1 Error message overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 4.7.2 Collecting Installation Manager information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Chapter 5. Working with profiles on z/OS systems . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 5.1 Creating WebSphere environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 5.1.1 WebSphere Application Server for z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 5.1.2 WebSphere DMZ secure proxy server for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . 124 5.2 Getting started with the Profile Management tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 5.3 Creating a sample z/OS Network Deployment cell . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 5.3.1 Creating a deployment manager definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 5.3.2 Creating the base application server definition . . . . . . . . . . . . . . . . . . . . . . . . . . 148 5.3.3 Uploading jobs and associated instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 5.3.4 Federating an application server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 5.3.5 Uploading jobs and associated instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 5.4 Creating a job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 5.4.1 Creating the customization definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 5.4.2 Uploading the jobs and the associated instructions . . . . . . . . . . . . . . . . . . . . . . 174 5.5 Creating an administrative agent profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 5.5.1 Creating the customization definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 5.5.2 Uploading jobs and the associated instructions . . . . . . . . . . . . . . . . . . . . . . . . . 182 Chapter 6. WebSphere Application Server Liberty Profile . . . . . . . . . . . . . . . . . . . . . 183 6.1 Overview of the Liberty profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 6.1.1 Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 6.1.2 Feature management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 6.1.3 Directory structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 6.1.4 Configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 6.2 Installing the Liberty profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 6.2.1 Configuring the Java Runtime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 6.2.2 Extracting the archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 6.2.3 Using the IBM Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 6.2.4 Using WebSphere Developer Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 6.2.5 Using the job manager console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 6.2.6 Installing on z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 6.3 Working with the Liberty profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 6.3.1 Scenario 1: Setting up the Liberty profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
  7. 7. vi WebSphere Application Server V8.5 Administration and Configuration Guide 6.3.2 Scenario 2: Deploying the Liberty profile on production server. . . . . . . . . . . . . . 207 6.4 Updating the Liberty profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 6.4.1 Destructive update method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 6.4.2 Non-destructive update method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 6.5 Common Liberty profile environment topologies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 6.5.1 Using multiple Liberty profile servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 6.5.2 Using eXtreme Scale for session persistence. . . . . . . . . . . . . . . . . . . . . . . . . . . 216 6.5.3 Using Liberty as the runtime for eXtreme Scale Grid . . . . . . . . . . . . . . . . . . . . . 217 6.5.4 Managing a multiple Liberty profile servers configuration. . . . . . . . . . . . . . . . . . 219 6.6 Other Liberty profile capabilities and features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 6.6.1 Working with JDBC datasources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 6.6.2 Classloaders and shared libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 6.6.3 Configuring dynamic updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 6.6.4 Creating a dump of a Liberty profile server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 6.6.5 Monitoring the Liberty profile runtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 Chapter 7. Administration consoles and commands . . . . . . . . . . . . . . . . . . . . . . . . . 227 7.1 Introducing the WebSphere administrative consoles . . . . . . . . . . . . . . . . . . . . . . . . . 228 7.1.1 Starting and accessing the consoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 7.1.2 Logging into an administrative console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 7.1.3 Changing the administrative console session timeout . . . . . . . . . . . . . . . . . . . . 236 7.1.4 The graphical interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 7.1.5 Administrative console resources scopes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 7.1.6 Updating existing items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 7.1.7 Adding new items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 7.1.8 Removing items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 7.1.9 Starting and stopping items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 7.1.10 Using variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 7.1.11 Saving work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 7.1.12 Getting help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 7.1.13 New options in version 8.5 deployment manager administrative console. . . . . 252 7.2 Securing the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 7.2.1 Enabling security after profile creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 7.2.2 Administrative security roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 7.3 Job manager console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 7.3.1 Submitting a job with the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 7.3.2 Distributing files using the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 7.4 Using command-line tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 7.4.1 Command location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 7.4.2 Key usage parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 7.4.3 Entering commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 Part 2. Administration and configuration techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Chapter 8. Administration of WebSphere processes. . . . . . . . . . . . . . . . . . . . . . . . . . 277 8.1 Working with deployment manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 8.1.1 Deployment manager configuration settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 8.1.2 Starting and stopping the deployment manager . . . . . . . . . . . . . . . . . . . . . . . . . 282 8.1.3 The high-availability deployment manager function . . . . . . . . . . . . . . . . . . . . . . 284 8.2 Working with the administrative agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 8.2.1 Starting and stopping the administrative agent. . . . . . . . . . . . . . . . . . . . . . . . . . 285 8.2.2 Administrative agent configuration settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 8.3 Working with the job manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 8.3.1 Starting and stopping the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
  8. 8. Contents vii 8.3.2 Job manager configuration settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 8.4 Working with application servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 8.4.1 Creating an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 8.4.2 Viewing the status of an application server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 8.4.3 Starting an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 8.4.4 Stopping an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 8.4.5 Viewing runtime attributes of an application server. . . . . . . . . . . . . . . . . . . . . . . 312 8.4.6 Customizing application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 8.4.7 Repository checkpoints service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 8.5 Working with nodes in a Network Deployment environment. . . . . . . . . . . . . . . . . . . . 326 8.5.1 Starting and stopping nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 8.5.2 Node agent synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 8.5.3 Removing a node from a cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 8.5.4 Renaming a node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 8.5.5 Recovering an existing node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 8.5.6 Node groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 8.6 Working with clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 8.6.1 Creating application server clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 8.6.2 Viewing the cluster topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 8.6.3 Managing clusters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 8.7 Working with virtual hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 8.8 Creating and updating virtual hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 8.9 Managing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 8.9.1 Managing enterprise applications: Administrative console . . . . . . . . . . . . . . . . . 350 8.9.2 Preventing an enterprise application from starting on a server. . . . . . . . . . . . . . 351 8.9.3 Viewing application details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 8.9.4 Finding a URL for a servlet or JSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 8.10 Enabling process restart on failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 8.10.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 8.10.2 UNIX and Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 8.10.3 z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 Chapter 9. Administration with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 9.1 Overview of WebSphere scripting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 9.2 Launching wsadmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 9.2.1 Scripting environment properties file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 9.2.2 Script profile file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 9.2.3 Connected versus local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 9.3 Command and script invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 9.3.1 Invoking a single command (-c) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 9.3.2 Running script files (-f) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 9.3.3 Invoking commands interactively . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 9.4 The wsadmin tool management objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 9.4.1 Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 9.4.2 AdminControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 9.4.3 AdminConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 9.4.4 AdminApp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 9.4.5 AdminTask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 9.5 Properties file based configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 9.6 Managing WebSphere using script libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 9.6.1 Invoking script libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 9.6.2 Displaying help for script libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 9.6.3 Application script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
  9. 9. viii WebSphere Application Server V8.5 Administration and Configuration Guide 9.6.4 Resource script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 9.6.5 Security script library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 9.6.6 Server script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 9.6.7 System management script library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 9.6.8 Applying performance tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 9.7 Assistance with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 9.7.1 Enabling command assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 9.7.2 Building script files using command assist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 9.8 Example: Using scripts with the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 9.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 9.8.2 Creating the customized script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 9.8.3 Submitting the job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 9.8.4 Verifying the results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 9.9 Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 Chapter 10. Accessing relational databases from WebSphere. . . . . . . . . . . . . . . . . . 395 10.1 JDBC resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 10.1.1 JDBC providers and data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 10.1.2 WebSphere support for data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 10.2 Steps to define access to a database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 10.3 Creating an authentication alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 10.4 Connecting to an IBM DB2 database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 10.4.1 Creating the JDBC provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 10.4.2 Creating the data source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 10.5 Connecting to an Oracle database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 10.5.1 Creating the JDBC provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 10.5.2 Creating the data source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 10.6 Connecting to an SQL Server database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 10.6.1 Creating the JDBC provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 10.6.2 Creating the data source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 10.7 Configuring connection pooling properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 10.8 WebSphere Application Server data source properties . . . . . . . . . . . . . . . . . . . . . . 420 10.9 Shared and unshared connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 10.9.1 Factors that determine sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 10.9.2 Configuring Shared and Unshared Connections. . . . . . . . . . . . . . . . . . . . . . . . 423 10.10 Configuring data sources in the Liberty profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 10.10.1 Configuring third-party data sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 10.10.2 Adding a data source using developer tools . . . . . . . . . . . . . . . . . . . . . . . . . . 425 10.10.3 Application-defined data sources in the Liberty profile . . . . . . . . . . . . . . . . . . 426 10.10.4 Runtime data source configuration update in the Liberty profile. . . . . . . . . . . 427 10.11 Configuring connection pooling properties in the Liberty profile . . . . . . . . . . . . . . . 428 10.12 Updating connection pooling configuration at runtime in Liberty profile . . . . . . . . . 428 10.13 Troubleshooting database access problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 10.13.1 Enabling JDBC tracing for database problems . . . . . . . . . . . . . . . . . . . . . . . . 429 10.13.2 Enabling ConnLeakLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 10.13.3 Dumping connection pool information using wsadmin . . . . . . . . . . . . . . . . . . 430 10.13.4 Tool to debug Database Access problems . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 Chapter 11. Accessing EIS applications from WebSphere . . . . . . . . . . . . . . . . . . . . . 433 11.1 JCA resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 11.2 WebSphere Application ServerJCA support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 11.2.1 Resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 11.2.2 Connection factories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
  10. 10. Contents ix 11.3 Installing and configuring resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 11.4 Configuring J2C connection factories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441 11.5 Resource authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 11.5.1 Container-managed authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 11.5.2 Component-managed authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 Chapter 12. Configuring messaging providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 12.1 Messaging providers introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 12.2 Configuring resources for the default messaging provider . . . . . . . . . . . . . . . . . . . . 448 12.2.1 Configuring JMS connection factories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 12.2.2 Configuring JMS destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 12.2.3 Configuring JMS queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 12.2.4 Configuring JMS activation specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 12.3 Configuring resources for the WebSphere MQ messaging provider. . . . . . . . . . . . . 453 12.3.1 Configuring WebSphere MQ messaging provider connection factories . . . . . . 454 12.3.2 Configuring WebSphere MQ messaging provider destinations . . . . . . . . . . . . 456 12.3.3 Configuring WebSphere MQ messaging provider activation specifications . . . 459 12.4 Configuring resources for third-party messaging providers. . . . . . . . . . . . . . . . . . . . 462 12.4.1 Configuring JMS messaging providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 12.4.2 Configuring JMS connection factories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 12.4.3 Configuring JMS destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 Chapter 13. Configuring and managing web servers . . . . . . . . . . . . . . . . . . . . . . . . . 467 13.1 Web server overview and basic concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 13.1.1 Request routing using the plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 13.1.2 Web server and plug-in management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 13.2 Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 13.3 Web server configuration using the WebSphere Customization Toolbox . . . . . . . . . 475 13.3.1 Configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476 13.3.2 Stand-alone server environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476 13.3.3 Distributed server environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 13.3.4 Configuring a remote web server in a distributed environment. . . . . . . . . . . . . 481 13.4 Working with web servers and plug-ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 13.4.1 Manually defining nodes and web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 13.4.2 Viewing the status of a web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493 13.4.3 Starting and stopping a web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 13.4.4 IBM HTTP Server remote administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 13.4.5 Mapping modules to servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 13.5 Working with the plug-in configuration file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500 13.5.1 Regenerating the plug-in configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 13.5.2 Propagating the plug-in configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 13.5.3 Modifying the plug-in request routing options . . . . . . . . . . . . . . . . . . . . . . . . . . 508 13.6 IBM HTTP Server and Web Server Plug-ins for IBM WebSphere Application Server for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511 13.6.1 IBM HTTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511 13.6.2 Web Server Plug-ins for IBM WebSphere Application Server for z/OS . . . . . . 511 13.7 Troubleshooting some common errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 13.7.1 Troubleshooting Error 404 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 13.7.2 Troubleshooting Error 500 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 Chapter 14. Intelligent management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 14.1 Introduction to Intelligent Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520 14.2 Sample topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522 14.3 Configuring dynamic operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
  11. 11. x WebSphere Application Server V8.5 Administration and Configuration Guide 14.3.1 Creating ODRs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 14.3.2 Service policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 14.3.3 Creating service policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 14.3.4 Associating service policies with an application . . . . . . . . . . . . . . . . . . . . . . . . 530 14.4 Configuring health management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 14.4.1 Health conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 14.4.2 Enabling and disabling health management . . . . . . . . . . . . . . . . . . . . . . . . . . . 534 14.4.3 Health policy actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535 14.4.4 Reaction mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 14.4.5 Creating health policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 Part 3. Managing distributed systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 Chapter 15. Performance tuning on distributed environments. . . . . . . . . . . . . . . . . . 543 15.1 Performance tuning overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544 15.2 Using the queue analogy to tune WebSphere resource pools . . . . . . . . . . . . . . . . . 544 15.2.1 Upstream queuing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546 15.2.2 Data source tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 15.2.3 EJB container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549 15.2.4 Web container tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550 15.2.5 Web server tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551 15.2.6 Estimating web container and ORB thread pool initial sizes. . . . . . . . . . . . . . . 554 15.2.7 WebSphere Plug-in tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554 15.3 JVM tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556 15.3.1 Garbage collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557 15.3.2 Sizing the JVM heap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559 15.3.3 Sizing the nursery and tenured space when using the gencon policy . . . . . . . 560 15.3.4 Using compressed references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561 15.4 Other tuning considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 15.4.1 Dynamic caching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 15.4.2 The pass by reference parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 15.4.3 Large page support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563 15.4.4 Application tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563 15.5 Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564 15.5.1 Tivoli Performance Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564 15.5.2 Collecting Java dumps and core files using the administrative console . . . . . . 564 15.5.3 IBM Pattern Modelling and Analysis Tool for Java Garbage Collector . . . . . . . 564 15.5.4 IBM Monitoring and Diagnostic tools for Java. . . . . . . . . . . . . . . . . . . . . . . . . . 565 15.5.5 IBM HTTP server status monitoring page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565 15.5.6 WebSphere performance advisors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566 15.6 Case Study . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 Chapter 16. Clustering, workload management, and high availability. . . . . . . . . . . . 569 16.1 Clustering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 16.1.1 Clustering for scalability and failover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 16.1.2 Intelligent Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571 16.1.3 Dynamic cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572 16.1.4 Static cluster versus dynamic cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573 16.1.5 Creating a static cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 16.1.6 Creating a dynamic cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577 16.1.7 Setting the operational mode for dynamic clusters . . . . . . . . . . . . . . . . . . . . . . 584 16.1.8 Web server plug-in when using on demand router . . . . . . . . . . . . . . . . . . . . . . 584 16.2 Workload management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585 16.2.1 Dynamic workload management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
  12. 12. Contents xi 16.2.2 Components that can be workload managed . . . . . . . . . . . . . . . . . . . . . . . . . . 586 16.2.3 Workload management benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590 16.3 High availability and failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590 16.3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590 16.3.2 WebSphere Application Server high availability and failover . . . . . . . . . . . . . . 591 16.3.3 How high availability features work. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 Chapter 17. Monitoring distributed systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603 17.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604 17.2 Enabling monitoring infrastructures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605 17.2.1 PMI defaults and monitoring settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605 17.2.2 Enabling request metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 17.3 Viewing the monitoring data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617 17.3.1 Starting TPV monitoring and configuring settings. . . . . . . . . . . . . . . . . . . . . . . 617 17.3.2 Exploring Tivoli Performance Viewer data views . . . . . . . . . . . . . . . . . . . . . . . 621 17.4 Monitoring examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625 17.4.1 JVM memory and CPU usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626 17.4.2 Threading resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628 17.4.3 Database interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630 17.4.4 Request level details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631 17.5 Monitoring operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634 17.5.1 Runtime operations overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635 17.5.2 Creating and managing reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636 17.5.3 Configuring the visualization data service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638 17.5.4 Task management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639 17.5.5 Managing runtime tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639 17.6 IBM Tivoli Composite Application Manager for WebSphere Application Server . . . . 641 17.6.1 Installing the data collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641 17.6.2 Configuring IBM Tivoli Composite Application Manager for WebSphere metrics . . 641 17.6.3 Viewing IBM Tivoli Composite Application Manager for WebSphere data . . . . 643 17.7 Additional resources for monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645 17.7.1 Java dump and core files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645 17.7.2 Basic logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646 17.7.3 Advanced logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646 17.7.4 Operating system monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648 17.7.5 Summary of monitoring tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648 Part 4. Managing z/OS systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649 Chapter 18. Performance tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651 18.1 Introduction to WebSphere Application Server for z/OS V8.5 performance . . . . . . . 652 18.2 External factors and z/OS specifics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653 18.2.1 Getting the most benefit from collocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653 18.2.2 Addressing hardware configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653 18.2.3 z/OS tuning tips. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653 18.3 Performance tuning templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655 18.4 64-bit considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657 18.4.1 Enabling 64-bit mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657 18.4.2 Effects of switching to 64-bit mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658 18.5 JVM tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 18.5.1 Default garbage collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 18.5.2 General JVM suggestions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 18.6 Connection pool tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668
  13. 13. xii WebSphere Application Server V8.5 Administration and Configuration Guide 18.7 Runtime provisioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668 18.8 Pass by reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669 18.9 Logging and tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670 18.9.1 High Performance Extensible Logging overview. . . . . . . . . . . . . . . . . . . . . . . . 670 18.9.2 Enabling HPEL mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670 18.9.3 z/OS logging and tracing tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670 18.10 Tuning workload management on z/OS systems . . . . . . . . . . . . . . . . . . . . . . . . . . 674 18.10.1 The concept of workload management on z/OS systems. . . . . . . . . . . . . . . . 674 18.10.2 Classification rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675 18.10.3 Classification XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676 18.10.4 Commands and tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677 18.11 Fast response cache accelerator and caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678 18.11.1 FRCA overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679 18.11.2 Enabling FRCA in WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . 679 18.11.3 Cache specification XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686 18.11.4 FRCA and RACF integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687 18.11.5 Caching enhancements in WebSphere Application Server V8.5 . . . . . . . . . . 687 18.11.6 Using IBM Extended Dynamic Cache Monitor to supervise caching . . . . . . . 687 18.12 Using WebSphere for z/OS Optimized Local Adapters. . . . . . . . . . . . . . . . . . . . . . 688 18.12.1 Introduction to Optimized Local Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688 18.12.2 Enabling WebSphere for z/OS Optimized Local Adapters . . . . . . . . . . . . . . . 690 18.13 IBM HTTP Server Status monitoring page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693 18.14 Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693 Chapter 19. Clustering and high availability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695 19.1 Clustering on z/OS systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696 19.1.1 Clustering for scalability and failover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696 19.1.2 Creating a cluster on a z/OS system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696 19.2 High availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700 19.2.1 High availability manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700 19.2.2 Core groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702 19.2.3 High-availability policies and groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721 19.3 Failover and failback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724 19.3.1 High availability and failover of singletons . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724 19.3.2 Data replication domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735 19.3.3 Session management replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737 19.3.4 EJB stateful session bean replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738 19.3.5 Cache replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742 19.3.6 Resource workload routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743 19.3.7 High-availability application update rollout . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747 19.4 Enabling multiple servants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751 19.4.1 Balancing workload with WLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752 19.4.2 Balancing workload without WLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752 19.5 Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753 Chapter 20. Monitoring z/OS systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 20.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756 20.2 Monitoring from the administrative console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 20.2.1 PMI Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 20.2.2 Monitoring Dynamic Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758 20.2.3 Monitoring web services through PMI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758 20.3 IBM Tivoli Composite Application Manager for WebSphere Application Server . . . . 759 20.3.1 Installing the data collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
  14. 14. Contents xiii 20.3.2 Configuring IBM Tivoli Composite Application Manager for WebSphere metrics . . 760 20.3.3 Viewing IBM Tivoli Composite Application Manager for WebSphere data . . . . 770 20.4 Additional resources for monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770 20.4.1 IBM Support Assistant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770 20.4.2 Verbose garbage collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770 20.4.3 Java dump and core files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773 20.4.4 Basic logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774 20.4.5 Advanced logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775 20.4.6 z/OS monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781 20.4.7 Summary of monitoring tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785 Part 5. Working with applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787 Chapter 21. Features for application development and deployment . . . . . . . . . . . . . 789 21.1 Java Enterprise Edition 6 support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 790 21.2 Integrated standards-base programming models and extensions . . . . . . . . . . . . . . 791 21.2.1 Session Initiation Protocol applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791 21.2.2 WebSphere Batch programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792 21.2.3 OSGi applications programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794 21.2.4 Communications enabled applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795 21.2.5 Service Component Architecture programming model . . . . . . . . . . . . . . . . . . . 796 21.2.6 Extensible Markup Language programming model. . . . . . . . . . . . . . . . . . . . . . 797 21.2.7 Integrated Web Services support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797 21.2.8 Integrated WebSphere Application Server Web 2.0 and Mobile Toolkit support 797 21.2.9 Simplified development of server-side REST applications using Java API for RESTful Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 798 21.2.10 IBM WebSphere SDK Java Technology Edition Version 7.0 . . . . . . . . . . . . . 798 21.3 Monitored directory support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 798 21.4 The Liberty profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 798 21.5 Development and deployment tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799 21.5.1 IBM Assembly and Deploy Tools for WebSphere Administration . . . . . . . . . . . 799 21.5.2 WebSphere Application Server Developer Tools for Eclipse, V8.5. . . . . . . . . . 799 21.5.3 Rational Application Developer for WebSphere Software V8.5 . . . . . . . . . . . . 800 Chapter 22. WebSphere Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 801 22.1 Overview of WebSphere Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802 22.1.1 Batch jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802 22.1.2 Batch applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802 22.1.3 Elements of the batch environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803 22.2 Batch programming models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805 22.2.1 Transactional batch programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805 22.2.2 Compute-intensive programming model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 811 22.2.3 Parallel batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 812 22.2.4 COBOL support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 813 22.2.5 Batch toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814 22.3 Configuring the batch environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815 22.3.1 Configuring the job scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815 22.3.2 Securing the job scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 816 22.3.3 Job scheduler integration with external schedulers . . . . . . . . . . . . . . . . . . . . . 817 22.3.4 Configuring grid endpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820 22.3.5 Configuring the job scheduler and job management console . . . . . . . . . . . . . . 820 22.3.6 Command-line interface for batch jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821 22.3.7 Job logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822
  15. 15. xiv WebSphere Application Server V8.5 Administration and Configuration Guide 22.3.8 Job classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823 22.4 Example: Working with batch applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824 22.4.1 Enabling the job scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824 22.4.2 Verifying the job scheduler installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825 22.4.3 Installing the sample batch application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826 22.4.4 Securing the job scheduler using Job groups . . . . . . . . . . . . . . . . . . . . . . . . . . 827 22.4.5 Using the job management console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 830 22.4.6 Using the command-line interface for batch jobs . . . . . . . . . . . . . . . . . . . . . . . 834 22.4.7 Checking the batch job logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835 Chapter 23. Understanding class loaders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839 23.1 JVM class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 840 23.2 WebSphere Application Server and Java EE application class loaders . . . . . . . . . . 841 23.2.1 WebSphere extensions class loader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842 23.2.2 Application and web module class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843 23.2.3 Handling Java Native Interface code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844 23.3 Configuring class loaders for Java EE applications . . . . . . . . . . . . . . . . . . . . . . . . . 845 23.3.1 Application server class loader policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845 23.3.2 Class loading and delegation mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847 23.3.3 TShared libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848 23.3.4 Class loader viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 849 23.4 Learning class loaders for Java EE by example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 850 23.4.1 Example 1: Simple web module packaging . . . . . . . . . . . . . . . . . . . . . . . . . . . 850 23.4.2 Example 2: Adding an EJB module and utility jar . . . . . . . . . . . . . . . . . . . . . . . 853 23.4.3 Example 3: Changing the WAR class loader delegation mode. . . . . . . . . . . . . 854 23.4.4 Example 4: Sharing utility JAR files using shared libraries . . . . . . . . . . . . . . . . 855 23.5 OSGi class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 860 Chapter 24. Packaging and deploying Java EE applications . . . . . . . . . . . . . . . . . . . 863 24.1 Java EE applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864 24.1.1 Java EE 6 EAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864 24.1.2 Development tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865 24.1.3 Packaging enterprise applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866 24.1.4 Packaging EJB 3.1 modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869 24.1.5 Packaging JPA persistence units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872 24.1.6 JPA access intent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872 24.1.7 Packaging resource adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 873 24.1.8 Packaging Web modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 873 24.1.9 Packaging EJB 3.1 content in Web modules . . . . . . . . . . . . . . . . . . . . . . . . . . 878 24.2 Preparing to use the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 879 24.2.1 Downloading the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 879 24.2.2 Importing the application to the development tool. . . . . . . . . . . . . . . . . . . . . . . 879 24.2.3 Customizing the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880 24.2.4 Creating the ITSO Bank DB2 database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 881 24.2.5 Configuring web module extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882 24.3 Packaging recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883 24.4 Creating WebSphere-enhanced EAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 884 24.4.1 Configuring a WebSphere enhanced EAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . 884 24.4.2 Configuring application options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885 24.4.3 Configuring the JDBC provider and data source for DB2 . . . . . . . . . . . . . . . . . 886 24.4.4 Configuring substitution variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892 24.4.5 Configuring a virtual host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892 24.4.6 Setting the default virtual host for web modules . . . . . . . . . . . . . . . . . . . . . . . . 893
  16. 16. Contents xv 24.4.7 Examining the WebSphere-enhanced EAR file . . . . . . . . . . . . . . . . . . . . . . . . 893 24.5 Exporting an application project to an EAR file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 894 24.6 Preparing the runtime environment for the application . . . . . . . . . . . . . . . . . . . . . . . 895 24.6.1 Creating an environment variable for the application file directory . . . . . . . . . . 896 24.6.2 Creating the ITSO Bank application server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 896 24.6.3 Defining the ITSO Bank virtual host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 900 24.6.4 Creating the virtual host for the IBM HTTP Server . . . . . . . . . . . . . . . . . . . . . . 901 24.6.5 Creating a DB2 JDBC provider and data source . . . . . . . . . . . . . . . . . . . . . . . 902 24.7 Deploying the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 904 24.7.1 Deploying using the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . . 904 24.7.2 Deploying using the monitored directory support feature . . . . . . . . . . . . . . . . . 909 24.7.3 Deploying applications using the job manager . . . . . . . . . . . . . . . . . . . . . . . . . 915 24.8 Deploying business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 917 24.8.1 Creating a business-level application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 920 24.9 Deploying application clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 923 24.9.1 Installing application client environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 924 24.9.2 Preparing the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 924 24.9.3 Launching the J2EE client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925 Chapter 25. Updating Java EE applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 929 25.1 Working with applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 930 25.2 Replacing an entire application EAR file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 930 25.3 Replacing or adding an application module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 932 25.3.1 Replacing or adding single files in an application or module . . . . . . . . . . . . . . 933 25.3.2 Removing application content. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933 25.3.3 Performing multiple updates to an application or module . . . . . . . . . . . . . . . . . 934 25.3.4 Rolling out application updates to a cluster. . . . . . . . . . . . . . . . . . . . . . . . . . . . 936 25.4 Application edition management and rollout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 939 25.4.1 Installing an application edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 939 25.4.2 Activating an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 940 25.4.3 Creating routing policies for application editions. . . . . . . . . . . . . . . . . . . . . . . . 941 25.4.4 Validating an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 25.4.5 Rolling out an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944 25.4.6 Rolling back an edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948 25.5 Hot deployment and dynamic reloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949 Chapter 26. Working with SCA applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951 26.1 SCA application introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952 26.1.1 SCA component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953 26.1.2 SCA composite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953 26.1.3 SCA contribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955 26.2 Preparing to use the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 956 26.2.1 Downloading the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 956 26.2.2 Importing the application to the development tool. . . . . . . . . . . . . . . . . . . . . . . 957 26.2.3 Completing the service definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957 26.3 Packaging an SCA application for deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958 26.3.1 Creating the contribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959 26.3.2 Exporting the SCA application for deployment . . . . . . . . . . . . . . . . . . . . . . . . . 961 26.4 Deploying an SCA application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 962 26.4.1 Importing the SCA archive file as an asset . . . . . . . . . . . . . . . . . . . . . . . . . . . . 962 26.4.2 Creating a new business-level application . . . . . . . . . . . . . . . . . . . . . . . . . . . . 965 26.4.3 Adding the new asset to the business-level application . . . . . . . . . . . . . . . . . . 966 26.4.4 Starting and verifying the business-level application . . . . . . . . . . . . . . . . . . . . 969
  17. 17. xvi WebSphere Application Server V8.5 Administration and Configuration Guide 26.5 Additional resources for learning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 969 Chapter 27. Working with OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971 27.1 OSGi overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972 27.1.1 OSGi application model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972 27.1.2 OSGi bundle lifecycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976 27.1.3 OSGi Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 978 27.2 Enterprise OSGi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 978 27.3 Using the sample application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979 27.3.1 Downloading the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979 27.3.2 Importing the application to the development tool. . . . . . . . . . . . . . . . . . . . . . . 980 27.4 Packaging OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 982 27.4.1 Common OSGi patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 983 27.4.2 Sample application packaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 983 27.4.3 Exporting OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 985 27.5 Deploying OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986 27.5.1 Importing the enterprise bundle archive file as an asset. . . . . . . . . . . . . . . . . . 986 27.5.2 Adding the enterprise bundle archive asset to the business-level application . 987 27.6 Administrating OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990 27.6.1 Updating OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990 27.6.2 Securing OSGi applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994 Chapter 28. Session management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 995 28.1 Session overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 996 28.1.1 Session identifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 996 28.1.2 Sessions invalidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998 28.1.3 Session listeners. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998 28.1.4 Session security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 999 28.2 Session management configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1000 28.2.1 Session management properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1000 28.2.2 Accessing session management properties . . . . . . . . . . . . . . . . . . . . . . . . . . 1001 28.2.3 Selecting session tracking options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003 28.2.4 Scheduled invalidation configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003 28.2.5 Cookie setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 28.3 Storing session information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006 28.3.1 Local sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006 28.3.2 Persistent sessions management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1007 28.3.3 Enabling database persistence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008 28.3.4 Memory-to-memory replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010 28.4 Session affinity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017 28.4.1 What is the session affinity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017 28.4.2 Session affinity and failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018 28.5 Session management tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1020 28.5.1 Session performance considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1020 28.5.2 Session management tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1021 28.5.3 Session database tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028 28.6 Stateful session bean failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029 28.6.1 Enabling stateful session bean failover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029 28.6.2 Stateful session bean failover consideration. . . . . . . . . . . . . . . . . . . . . . . . . . 1032 Part 6. Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1033 Chapter 29. Managing your environment with the centralized installation manager . . . 1035
  18. 18. Contents xvii 29.1 The centralized installation manager prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . 1036 29.1.1 Linux and UNIX target requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036 29.1.2 Windows target requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037 29.1.3 IBM i targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037 29.1.4 Additional requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037 29.2 Planning considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038 29.2.1 WebSphere Application Server V8 and V8.5 . . . . . . . . . . . . . . . . . . . . . . . . . 1038 29.2.2 WebSphere Application Server V6.1 and V7 . . . . . . . . . . . . . . . . . . . . . . . . . 1039 29.3 Working with the centralized installation manager and WebSphere Application Server Version 8 and V8.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039 29.3.1 Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1040 29.3.2 Accessing the centralized installation manager . . . . . . . . . . . . . . . . . . . . . . . 1041 29.4 Working with the centralized installation manager and WebSphere Application Server V6.1 and V7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042 29.4.1 IBM Update Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042 29.4.2 The centralized installation manager repository structure. . . . . . . . . . . . . . . . 1043 29.4.3 Package types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044 29.4.4 Accessing the central installation manager. . . . . . . . . . . . . . . . . . . . . . . . . . . 1045 29.5 Managing WebSphere Application Server V8 and V8.5 environment with the centralized installation manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1047 29.5.1 Adding new targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1047 29.5.2 Installing Installation Manager on remote targets . . . . . . . . . . . . . . . . . . . . . . 1051 29.5.3 Installing a Secure Shell (SSH) public key . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056 29.5.4 Installing WebSphere Application Server binaries on remote hosts . . . . . . . . 1057 29.5.5 Creating a WebSphere Application Server profile on a remote target . . . . . . 1059 29.5.6 Registering and unregistering the profile with the Job Manager. . . . . . . . . . . 1062 29.5.7 Working with remote targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1064 29.5.8 Installing maintenance to remote targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1069 29.5.9 Using the centralized installation manager with a command line . . . . . . . . . . 1070 29.6 Managing WebSphere Application Server V6.1 and V7 with the centralized installation manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071 29.6.1 Installing the IBM Installation Factory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1072 29.6.2 Creating the centralized installation manager repository . . . . . . . . . . . . . . . . 1072 29.6.3 Adding packages when deployment manager is connected to the Internet . . 1073 29.6.4 Adding packages when deployment manager is not connected to the Internet1078 29.6.5 Adding and removing additional installation targets . . . . . . . . . . . . . . . . . . . . 1080 29.6.6 Installing a Secure Shell public key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1081 29.6.7 Installing packages to the target systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1083 29.6.8 Installing a software package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1084 29.6.9 Installing maintenance to a target system. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1086 29.6.10 Uninstalling packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1088 29.6.11 The centralized installation manager AdminTask commands. . . . . . . . . . . . 1088 29.7 Managing the Liberty profile with the centralized installation manager. . . . . . . . . . 1089 29.7.1 Installing the Liberty Profile using the job manager console. . . . . . . . . . . . . . 1090 29.7.2 Deploying a packaged Liberty Profile on a production server using the job manager console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093 29.7.3 Starting and stopping a Liberty profile server using the job manager console 1094 29.7.4 Generating a merged plug-in for liberty profiles using the job manager console . . 1096 Chapter 30. System recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1099 30.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1100 30.2 Configuring for backup and restore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1100
  19. 19. xviii WebSphere Application Server V8.5 Administration and Configuration Guide 30.2.1 Backing up a profile configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1100 30.2.2 Restoring a profile configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1101 30.2.3 Exporting and importing a configuration archive. . . . . . . . . . . . . . . . . . . . . . . 1103 30.3 Configuring checkpoints service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1105 30.3.1 Creating repository checkpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1106 30.3.2 Archiving or deleting checkpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107 30.3.3 Restoring checkpoints. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108 30.3.4 Configuring change audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108 30.4 Restoring transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108 30.4.1 Restarting an application server in recovery mode. . . . . . . . . . . . . . . . . . . . . 1109 30.4.2 Administering the transaction service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1109 30.4.3 Transactional high availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110 30.5 Recovery node with addNode -asExistingNode command . . . . . . . . . . . . . . . . . . . 1111 30.5.1 Considerations when using the -asExistingNode command . . . . . . . . . . . . . 1111 30.5.2 Recovering a failed managed node of deployment manager . . . . . . . . . . . . . 1111 30.5.3 Moving a node to a different system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1113 30.5.4 Recreating a cell from a template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1117 Chapter 31. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119 31.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120 31.2 WebSphere Application Server Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120 31.2.1 Server log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1121 31.2.2 JVM log interpretation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1123 31.2.3 Logging modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1126 31.2.4 High Performance Extensible Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1127 31.2.5 Cross Component Trace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1135 31.2.6 Sensitive log and trace guard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1140 31.2.7 Javacores and Heapdumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1140 31.2.8 HTTP Plug-in Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1141 31.3 Tools for collecting and analyzing diagnostic data . . . . . . . . . . . . . . . . . . . . . . . . . 1141 31.3.1 Hang detection policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1141 31.3.2 Memory leak detection policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1143 31.3.3 MustGather for troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1144 31.3.4 IBM Support Assistant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1145 31.4 Troubleshooting scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1147 31.4.1 Hung threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1147 31.4.2 High CPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1150 31.4.3 Out of Memory exceptions in WebSphere Application Server . . . . . . . . . . . . 1153 Appendix A. Additional material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1159 Locating the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1159 Using the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1159 Downloading and extracting the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1160 Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1161 IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1161 Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1161 Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1164
  20. 20. © Copyright IBM Corp. 2012. All rights reserved. xix Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785 U.S.A. The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
  21. 21. xx WebSphere Application Server V8.5 Administration and Configuration Guide Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol (® or ™), indicating US registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml The following terms are trademarks of the International Business Machines Corporation in the United States, other countries, or both: AIX® CICS® ClearCase® DataPower® DB2® developerWorks® Domino® eServer™ Global Technology Services® GPFS™ i5/OS® IBM® IMS™ Informix® Language Environment® Lotus® MVS™ OS/400® Parallel Sysplex® Passport Advantage® POWER® RACF® Rational Team Concert™ Rational® Redbooks® Redpaper™ Redpapers™ Redbooks (logo) ® Resource Measurement Facility™ RMF™ System z10® System z9® System z® SystemPac® Tivoli® VTAM® WebSphere® z/Architecture® z/OS® z10™ z9® zSeries® The following terms are trademarks of other companies: ITIL is a registered trademark, and a registered community trademark of The Minister for the Cabinet Office, and is registered in the U.S. Patent and Trademark Office. Linux is a trademark of Linus Torvalds 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. Java, and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others.

×