Websphere V7 Reference guide.pdf - Front cover WebSphere Application Server V7 Administration and Configuration Guide Learn about WebSphere Application

Websphere V7 Reference guide.pdf - Front cover WebSphere...

This preview shows page 1 out of 830 pages.

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

  • Left Quote Icon

    Student Picture

  • Left Quote Icon

    Student Picture

  • Left Quote Icon

    Student Picture