You've reached the end of your free preview.
Want to read all 830 pages?
Unformatted text preview: Front cover WebSphere Application
Server V7 Administration
and Configuration Guide
Learn about WebSphere Application
Server V7
Configure and administer a
WebSphere system
Deploy applications Fabio Albertoni
Leonard Blunt
Michael Connolly
Stefan Kwiatkowski
Carla Sadtler
Thayaparan Shanmugaratnam
Henrik Sjostrand
Saori Tanikawa
Margaret Ticknor
Joerg-Ulrich Veser ibm.com/redbooks International Technical Support Organization
WebSphere Application Server V7
Administration and Configuration Guide
March 2010 SG24-7615-01 Note: Before using this information and the product it supports, read the information in
“Notices” on page xiii. Second Edition (March 2010)
This edition applies to WebSphere Application Server V7. © Copyright International Business Machines Corporation 2009-2010. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP
Schedule Contract with IBM Corp. Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
The team who wrote this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Now you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . xviii
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Stay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
March 2010, Second Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Part 1. Basic administration and configuration techniques . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 1. System management: A technical overview . . . . . . . . . . . . . . . 3
1.1 System management overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.2 Directory conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1.3 Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1.4 System management tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2 System management in a standalone server environment . . . . . . . . . . . . . 8
1.3 System management of multiple standalone servers . . . . . . . . . . . . . . . . . 9
1.4 System management in a distributed server environment . . . . . . . . . . . . 12
1.4.1 Centralized changes to configuration and application data. . . . . . . . 14
1.4.2 Rules for process startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.3 Distributed process discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4.4 Configuration and application data repository . . . . . . . . . . . . . . . . . . 18
1.4.5 File synchronization in distributed server environments . . . . . . . . . . 25
1.5 Management of distributed and standalone servers . . . . . . . . . . . . . . . . . 32
1.6 Java Management Extensions (JMX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
1.6.1 JMX MBeans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
1.6.2 JMX usage scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
1.7 Centralized Installation Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.8 IBM Support Assistant V4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Chapter 2. Working with profiles on distributed systems . . . . . . . . . . . . . 41
2.1 Types of profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.1.1 Application server profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.1.2 Deployment manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 © Copyright IBM Corp. 2009-2010. All rights reserved. iii 2.1.3 Custom profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.1.4 Cell profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.1.5 Administrative agent profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.1.6 Job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2.1.7 Profile generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2.2 Planning for profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2.3 Building systems with profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2.3.1 Starting the PMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
2.3.2 Common panels and steps for all profiles . . . . . . . . . . . . . . . . . . . . . 50
2.3.3 Creating an application server profile . . . . . . . . . . . . . . . . . . . . . . . . 62
2.3.4 Creating a deployment manager profile . . . . . . . . . . . . . . . . . . . . . . 72
2.3.5 Creating a cell profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.3.6 Creating a custom profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
2.3.7 Federating nodes to a cell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
2.3.8 Creating an administrative agent profile . . . . . . . . . . . . . . . . . . . . . . 90
2.3.9 Creating a job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
2.3.10 Registering nodes to an administrative agent . . . . . . . . . . . . . . . . . 95
2.3.11 Deregistering a node from the administrative agent . . . . . . . . . . . . 99
2.3.12 Registering an administrative agent node with a job manager . . . . 99
2.3.13 Registering a deployment manager with a job manager . . . . . . . . 103
2.4 Managing profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
2.4.1 Using the manageprofiles command. . . . . . . . . . . . . . . . . . . . . . . . 105
2.4.2 Getting help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
2.4.3 Getting a list of profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
2.4.4 Creating a profile with the manageprofiles command . . . . . . . . . . . 107
2.4.5 Creating a profile in silent mode with PMT . . . . . . . . . . . . . . . . . . . 109
2.4.6 Deleting profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Chapter 3. Working with profiles on z/OS systems . . . . . . . . . . . . . . . . . 113
3.1 Creating WebSphere environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
3.1.1 WebSphere Application Server for z/OS . . . . . . . . . . . . . . . . . . . . . 116
3.1.2 WebSphere DMZ secure proxy server for z/OS . . . . . . . . . . . . . . . 117
3.2 Getting started with the profile management tool . . . . . . . . . . . . . . . . . . 117
3.3 Sample environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
3.4 Creating a deployment manager definition . . . . . . . . . . . . . . . . . . . . . . . 124
3.4.1 Creating the customization definition . . . . . . . . . . . . . . . . . . . . . . . 124
3.4.2 Uploading the jobs to the z/OS system . . . . . . . . . . . . . . . . . . . . . . 150
3.4.3 Executing the jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
3.5 Creating the base application server definition . . . . . . . . . . . . . . . . . . . . 155
3.6 Federating an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
3.7 Creating a job manager profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
3.8 Creating an administrative agent profile . . . . . . . . . . . . . . . . . . . . . . . . . 193 iv WebSphere Application Server V7 Administration and Configuration Guide Chapter 4. Centralized Installation Manager. . . . . . . . . . . . . . . . . . . . . . . 205
4.1 Planning considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
4.1.1 Linux and AIX target requirements . . . . . . . . . . . . . . . . . . . . . . . . . 207
4.1.2 Requirement when using CIM for installing or uninstalling maintenance
on AIX target as non-root user . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
4.1.3 Update Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
4.1.4 Repository directory structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
4.2 Installing CIM and creating the repository . . . . . . . . . . . . . . . . . . . . . . . . 210
4.3 Loading additional product packages into the repository . . . . . . . . . . . . 212
4.3.1 Installing Installation Factory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
4.3.2 Package types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
4.3.3 Adding product packages to the CIM respository . . . . . . . . . . . . . . 213
4.3.4 Adding maintenance when the deployment manager is connected to the
Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
4.3.5 When the deployment manager is not connected to the Internet . . 220
4.4 Using CIM to manage your environment. . . . . . . . . . . . . . . . . . . . . . . . . 222
4.4.1 Adding additional installation targets outside of the cell . . . . . . . . . 222
4.4.2 Installing a Secure Shell (SSH) public key . . . . . . . . . . . . . . . . . . . 224
4.4.3 Removing installation target systems . . . . . . . . . . . . . . . . . . . . . . . 226
4.4.4 Installing packages to the target systems . . . . . . . . . . . . . . . . . . . . 226
4.4.5 Product installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
4.4.6 Installing maintenance to target systems . . . . . . . . . . . . . . . . . . . . 230
4.4.7 Uninstalling packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
4.4.8 CIM AdminTask Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Chapter 5. Administration consoles and commands . . . . . . . . . . . . . . . 239
5.1 Introducing the WebSphere administrative consoles . . . . . . . . . . . . . . . 240
5.1.1 Starting and accessing the consoles. . . . . . . . . . . . . . . . . . . . . . . . 241
5.1.2 Logging in to a console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
5.1.3 Changing the administrative console session timeout . . . . . . . . . . 245
5.1.4 The graphical interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
5.1.5 Finding an item in the console . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
5.1.6 Updating existing items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
5.1.7 Adding new items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
5.1.8 Removing items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
5.1.9 Starting and stopping items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
5.1.10 Using variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
5.1.11 Saving work. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
5.1.12 Getting help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
5.2 Securing the console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
5.2.1 Enabling security after profile creation . . . . . . . . . . . . . . . . . . . . . . 267
5.2.2 Administrative security roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
5.3 Job manager console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 Contents v 5.3.1 Submitting a job with the job manager . . . . . . . . . . . . . . . . . . . . . . 274
5.3.2 Distributing files using the job manager . . . . . . . . . . . . . . . . . . . . . 283
5.4 Using command line tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
5.4.1 Command location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
5.4.2 Key usage parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
5.4.3 Entering commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Chapter 6. Administration of WebSphere processes. . . . . . . . . . . . . . . . 289
6.1 Working with the deployment manager . . . . . . . . . . . . . . . . . . . . . . . . . . 290
6.1.1 Deployment manager configuration settings . . . . . . . . . . . . . . . . . . 290
6.1.2 Starting and stopping the deployment manager . . . . . . . . . . . . . . . 292
6.2 Starting and stopping an administrative agent . . . . . . . . . . . . . . . . . . . . 296
6.3 Starting and stopping the job manager . . . . . . . . . . . . . . . . . . . . . . . . . . 297
6.4 Working with application servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
6.4.1 Creating an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
6.4.2 Viewing the status of an application server . . . . . . . . . . . . . . . . . . . 307
6.4.3 Starting an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
6.4.4 Stopping an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
6.4.5 Viewing runtime attributes of an application server. . . . . . . . . . . . . 315
6.4.6 Customizing application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
6.5 Working with nodes in a distributed environment . . . . . . . . . . . . . . . . . . 325
6.5.1 Starting and stopping nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
6.5.2 Node agent synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
6.5.3 Removing a node from a cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
6.5.4 Renaming a node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
6.5.5 Node groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
6.6 Working with clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
6.6.1 Creating application server clusters . . . . . . . . . . . . . . . . . . . . . . . . 337
6.6.2 Viewing cluster topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
6.6.3 Managing clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
6.7 Working with virtual hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
6.7.1 Creating and updating virtual hosts. . . . . . . . . . . . . . . . . . . . . . . . . 352
6.8 Managing your configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
6.8.1 Backing up a profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
6.8.2 Restoring a profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
6.8.3 Exporting and importing profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
6.9 Managing applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
6.9.1 Managing enterprise applications: Administrative console . . . . . . . 358
6.9.2 Installing an enterprise application . . . . . . . . . . . . . . . . . . . . . . . . . 360
6.9.3 Uninstalling an enterprise application . . . . . . . . . . . . . . . . . . . . . . . 366
6.9.4 Starting an enterprise application . . . . . . . . . . . . . . . . . . . . . . . . . . 367
6.9.5 Stopping an enterprise application . . . . . . . . . . . . . . . . . . . . . . . . . 367
6.9.6 Preventing an enterprise application from starting on a server . . . . 368 vi WebSphere Application Server V7 Administration and Configuration Guide 6.9.7 Viewing application details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
6.9.8 Finding a URL for a servlet or JSP . . . . . . . . . . . . . . . . . . . . . . . . . 371
6.10 Enabling process restart on failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Chapter 7. WebSphere Application Server for z/OS. . . . . . . . . . . . . . . . . 381
7.1 WebSphere Application Server on z/OS Architecture . . . . . . . . . . . . . . . 382
7.1.1 Architecture of a single application server on z/OS . . . . . . . . . . . . 382
7.1.2 Cell architecture of WebSphere Application Server for z/OS . . . . . 389
7.2 WebSphere Application Server for z/OS operations . . . . . . . . . . . . . . . . 392
7.2.1 Structure of the configuration HFS . . . . . . . . . . . . . . . . . . . . . . . . . 392
7.2.2 Load module libraries in the HFS . . . . . . . . . . . . . . . . . . . . . . . . . . 394
7.2.3 Changed start procedure JCLs with V7 . . . . . . . . . . . . . . . . . . . . . 395
7.2.4 Starting and stopping an application server . . . . . . . . . . . . . . . . . . 398
7.2.5 Logging and tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
7.3 Maintenance for the HFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
7.3.1 The process of applying maintenance . . . . . . . . . . . . . . . . . . . . . . 402
7.3.2 The concept of intermediate symbolic links . . . . . . . . . . . . . . . . . . 402
7.4 Workload management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
7.4.1 Workload management overview . . . . . . . . . . . . . . . . . . . . . . . . . . 406
7.4.2 Workload classification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
7.4.3 Transaction classification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
7.4.4 Servant activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
7.4.5 Basic WLM classifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
7.5 What is new in V7 for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
7.5.1 z/OS Fast Response Cache Accelerator (FRCA) . . . . . . . . . . . . . . 415
7.5.2 Thread hang recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
7.5.3 Systems Management Facility (SMF) Subtype 9 . . . . . . . . . . . . . . 428
7.6 Thread management using the workload profile . . . . . . . . . . . . . . . . . . . 429
7.7 Local connectivity to DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
7.7.1 Prerequisites for implementing a JDBC type 2 driver . . . . . . . . . . . 432
7.7.2 Creating a JDBC provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
7.7.3 Defining a type 2 data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
7.8 Migrating to V7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Chapter 8. Administration with scripting . . . . . . . . . . . . . . . . . . . . . . . . . 439
8.1 Overview of WebSphere scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
8.1.1 Script programming languages . . . . . . . . . . . . . . . . . . . ....
View
Full Document
- Fall '19
