WebSphere Application Server - Express for Distributed Platforms, Version 7.0

sPhere. Application Server-Express for Distributed Platforms, Version 7.0 Administering applications and their environment

WebSphere® Application Server - Express for Distributed Platforms, Version 7.0 Administering applications and their environment

Note Before using this information, be sure to read the general information under "Notices" on page 513 Compilation date: September 11, 2008 Copyright International Business Machines Corporation 2008. US Government Users Restricted Rights- Use, duplication or disclosure restricted by GSA ADP Schedule Contract ith IBM Corp

Note Before using this information, be sure to read the general information under “Notices” on page 513. Compilation date: September 11, 2008 © Copyright International Business Machines Corporation 2008. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp

Contents How to send your comments Changes to serve you more quickly Chapter 1. Overview and new features for administering applications and their environments ..1 Web applications Client modules Web services Data access resources Messaging resources Mail, URLs, and other j2EE resources 337789 Security 17 Introduction: Administrative console 18 Introduction: Administrative scripting(wsadmin) 18 Introduction: Administrative commands Introduction: Administrative programs 19 Introduction: Administrative configuration data 20 Introduction: Application servers Introduction: Application servers 20 Introduction: Web servers Introduction: Environment 23 What is new for scripted administration( wsadmin) Introduction: Variables Language versions offered by this product Chapter 2. Using the administrative clients Using the administrative console 599四 Installing and uninstalling the administrative console Starting and logging off the administrative console 30 Administrative console buttons Administrative console page features Console layout 3678 Console navigation Administrative console browser support 40 Console accessibility Welcome 2 My tasks Specifying console preferences 43 Accessing help and product information from the administrative console Administrative console: Resources for learning Console identity 74 Changing the console session expiration Changing the class loader order of the console module deployed in Integrated Solutions Console 75 Console identity string Developing console modules 78 Overview of Integrated Solutions Console 79 Example: Console module samples Setting up the development environment 82 Developing your first console module Adding advanced API features Console module schemas Copyright IBM Corp. 2008

Contents How to send your comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Changes to serve you more quickly . . . . . . . . . . . . . . . . . . . . . . . . . xi Chapter 1. Overview and new features for administering applications and their environments . . 1 Web applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 EJB applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Client modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Data access resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Messaging resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Mail, URLs, and other J2EE resources . . . . . . . . . . . . . . . . . . . . . . . . . 8 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Introduction: System administration . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Introduction: Administrative console . . . . . . . . . . . . . . . . . . . . . . . . . 18 Introduction: Administrative scripting (wsadmin) . . . . . . . . . . . . . . . . . . . . 18 Introduction: Administrative commands . . . . . . . . . . . . . . . . . . . . . . . 19 Introduction: Administrative programs . . . . . . . . . . . . . . . . . . . . . . . . 19 Introduction: Administrative configuration data . . . . . . . . . . . . . . . . . . . . . 20 Introduction: Application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Introduction: Application servers . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Introduction: Web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Introduction: Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 What is new for scripted administration (wsadmin) . . . . . . . . . . . . . . . . . . . . 23 Introduction: Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Language versions offered by this product . . . . . . . . . . . . . . . . . . . . . . . 26 Chapter 2. Using the administrative clients . . . . . . . . . . . . . . . . . . . . . . 29 Using the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Installing and uninstalling the administrative console . . . . . . . . . . . . . . . . . . 29 Starting and logging off the administrative console . . . . . . . . . . . . . . . . . . . 30 Administrative console buttons . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Administrative console page features . . . . . . . . . . . . . . . . . . . . . . . . 36 Console layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Console navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Administrative console browser support . . . . . . . . . . . . . . . . . . . . . . . 40 Console accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 My tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Specifying console preferences . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Accessing help and product information from the administrative console . . . . . . . . . . . 47 Administrative console: Resources for learning. . . . . . . . . . . . . . . . . . . . . 73 Console identity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Changing the console session expiration . . . . . . . . . . . . . . . . . . . . . . . 75 Changing the class loader order of the console module deployed in Integrated Solutions Console 75 Console identity string. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Developing console modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Overview of Integrated Solutions Console . . . . . . . . . . . . . . . . . . . . . . 79 Example: Console module samples . . . . . . . . . . . . . . . . . . . . . . . . . 81 Setting up the development environment . . . . . . . . . . . . . . . . . . . . . . . 82 Developing your first console module . . . . . . . . . . . . . . . . . . . . . . . . 82 Adding advanced API features. . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Console module schemas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 © Copyright IBM Corp. 2008 iii

Using administrative programs(JMX) Java Management Extensions Creating a custom Java administrative client program using WebSphere Application Server administrative Java APls 115 Creating a Java Management Extensions client program using the Java Management Extensions Remote application programming interface 124 Extending the WebSphere Application Server administrative system with custom MBeans Administrative programs for multiple Java Platform, Enterprise Edition application servers Deploying and managing a custom Java administrative client program with multiple Java Platform, Enterprise Edition application servers Java Management Extensions V1.0 to Java Management EXtensions V1.2 migration Java Management Extensions Using command line tools Example: Security and the command line tools manageprofiles command startserver command stop Server command serverStatus command 167 cleanupNode command backup Config command restore Config command 170 EARExpander command Gen Cfg command versionInfo command 175 gen Report command historylnfo command geoHistory Report command registerNode command deregisterNode command 193 revoke Certificate command requestcertificate command 96 createCertRequest command query Certificate command 200 Chapter 3. Using Ant to automate tasks Chapter 4. Starting and stopping quick reference 205 Chapter 5. Backing up and recovering the application serving environmen 207 Chapter 6 Class loading 209 Class loaders 209 Configuring class loaders of a serve 213 Class loader collection Class loader ID 215 Class loader order 215 Class loader settings 215 Configuring application class loaders 216 Web module class loaders Class loading: Resources for learning 219 Chapter 7. Deploying and administering enterprise applications Enterprise (Java EE) applications 221 Common deployment framework Installing enterprise application files Iv Administering applications and their environment

Using administrative programs (JMX) . . . . . . . . . . . . . . . . . . . . . . . . . 111 Java Management Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Creating a custom Java administrative client program using WebSphere Application Server administrative Java APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Creating a Java Management Extensions client program using the Java Management Extensions Remote application programming interface . . . . . . . . . . . . . . . . . . . . . 124 Extending the WebSphere Application Server administrative system with custom MBeans . . . . 128 Administrative programs for multiple Java Platform, Enterprise Edition application servers . . . . 141 Deploying and managing a custom Java administrative client program with multiple Java Platform, Enterprise Edition application servers . . . . . . . . . . . . . . . . . . . . . . . 142 Java Management Extensions V1.0 to Java Management Extensions V1.2 migration . . . . . . 144 Java Management Extensions interoperability . . . . . . . . . . . . . . . . . . . . 144 Using command line tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Example: Security and the command line tools . . . . . . . . . . . . . . . . . . . . 147 manageprofiles command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 startServer command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 stopServer command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 serverStatus command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 cleanupNode command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 backupConfig command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 restoreConfig command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 EARExpander command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 GenPluginCfg command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 versionInfo command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 genVersionReport command . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 historyInfo command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 genHistoryReport command . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 registerNode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 deregisterNode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 revokeCertificate command . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 requestCertificate command . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 createCertRequest command . . . . . . . . . . . . . . . . . . . . . . . . . . 199 queryCertificate command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 Chapter 3. Using Ant to automate tasks . . . . . . . . . . . . . . . . . . . . . . . 203 Chapter 4. Starting and stopping quick reference . . . . . . . . . . . . . . . . . . . 205 Chapter 5. Backing up and recovering the application serving environment. . . . . . . . . 207 Chapter 6. Class loading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 Class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 Configuring class loaders of a server . . . . . . . . . . . . . . . . . . . . . . . . . 213 Class loader collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Class loader ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Class loader order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Class loader settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Configuring application class loaders . . . . . . . . . . . . . . . . . . . . . . . . . 216 Configuring Web module class loaders . . . . . . . . . . . . . . . . . . . . . . . . 217 Class loading: Resources for learning . . . . . . . . . . . . . . . . . . . . . . . . 219 Chapter 7. Deploying and administering enterprise applications . . . . . . . . . . . . . 221 Enterprise (Java EE) applications . . . . . . . . . . . . . . . . . . . . . . . . . . 221 System applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 Common deployment framework . . . . . . . . . . . . . . . . . . . . . . . . . 222 Installing enterprise application files . . . . . . . . . . . . . . . . . . . . . . . . . 223 iv Administering applications and their environment

Installable enterprise module versions Ways to install enterprise applications or modules Installing enterprise application files with the console Example: Installing an EAR file using the default bindings 252 Example: Installing a Web Services Sample with the console Installing enterprise modules with JSR-88 Customizing modules using DConfigl Enterprise application collection Name 258 Application Status 259 Startup order 259 Enterprise application settings Configuring enterprise application files 260 Application bindings 261 Configuring application startup Configuring binary location and use Configuring the use of class loaders by an application Manage modules setti 277 Mapping modules to servers 279 Mapping virtual hosts for Web modules Mapping properties for a custom login or trusted connection configuration 282 Viewing deployment descriptors Metadata for module settings Starting or stopping enterprise applications 286 Disabling automatic starting of applications 28 Target specific application status Exporting enterprise applications Exporting enterprise application files 291 Exporting DDL files Updating enterprise application files Ways to update enterprise application files Updating enterprise applications with the console Preparing for application update settings Hot deployment and dynamic reloading 300 Uninstalling enterprise applications 308 Removing enterprise files 308 Deploying and administering applications: Resources for learning Chapter 8. Managing applications through programming 311 Application management 312 Accessing the application management function 313 Installing an application through programming Starting an application through programming 317 Uninstalling an application through programming Manipulating additional attributes for a deployed application Sharing sessions for application management Updating an application through programming Adding to, updating, or deleting part of an application through programming 326 Editing applications Preparing a module and adding it to an existing application through programming Preparing and updating a module through programming Deleting a module through programming Adding a file through programming 338 plating a file through programming Deleting a file through programming Extending application management operations through programming 345 Contents v

Installable enterprise module versions . . . . . . . . . . . . . . . . . . . . . . . 224 Ways to install enterprise applications or modules . . . . . . . . . . . . . . . . . . . 225 Installing enterprise application files with the console . . . . . . . . . . . . . . . . . . 228 Example: Installing an EAR file using the default bindings . . . . . . . . . . . . . . . . 252 Example: Installing a Web Services Sample with the console . . . . . . . . . . . . . . . 253 Installing enterprise modules with JSR-88 . . . . . . . . . . . . . . . . . . . . . . 255 Customizing modules using DConfigBeans . . . . . . . . . . . . . . . . . . . . . 256 Enterprise application collection. . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Application Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 Startup order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 Enterprise application settings . . . . . . . . . . . . . . . . . . . . . . . . . . 259 Configuring enterprise application files . . . . . . . . . . . . . . . . . . . . . . . . 260 Application bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Configuring application startup . . . . . . . . . . . . . . . . . . . . . . . . . . 266 Configuring binary location and use . . . . . . . . . . . . . . . . . . . . . . . . 268 Configuring the use of class loaders by an application . . . . . . . . . . . . . . . . . 274 Manage modules settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Mapping modules to servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 Mapping virtual hosts for Web modules . . . . . . . . . . . . . . . . . . . . . . . 280 Mapping properties for a custom login or trusted connection configuration . . . . . . . . . . 282 Viewing deployment descriptors. . . . . . . . . . . . . . . . . . . . . . . . . . . 283 Metadata for module settings. . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Starting or stopping enterprise applications . . . . . . . . . . . . . . . . . . . . . . 286 Disabling automatic starting of applications . . . . . . . . . . . . . . . . . . . . . 287 Target specific application status . . . . . . . . . . . . . . . . . . . . . . . . . 288 Exporting enterprise applications . . . . . . . . . . . . . . . . . . . . . . . . . . 290 Exporting enterprise application files . . . . . . . . . . . . . . . . . . . . . . . . . 291 Exporting DDL files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 Updating enterprise application files . . . . . . . . . . . . . . . . . . . . . . . . . 292 Ways to update enterprise application files. . . . . . . . . . . . . . . . . . . . . . 293 Updating enterprise applications with the console . . . . . . . . . . . . . . . . . . . 295 Preparing for application update settings . . . . . . . . . . . . . . . . . . . . . . 296 Hot deployment and dynamic reloading . . . . . . . . . . . . . . . . . . . . . . . 300 Uninstalling enterprise applications . . . . . . . . . . . . . . . . . . . . . . . . . 308 Removing enterprise files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Deploying and administering applications: Resources for learning . . . . . . . . . . . . . . 309 Chapter 8. Managing applications through programming . . . . . . . . . . . . . . . . 311 Application management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 Accessing the application management function. . . . . . . . . . . . . . . . . . . . . 313 Installing an application through programming . . . . . . . . . . . . . . . . . . . . . 314 Starting an application through programming . . . . . . . . . . . . . . . . . . . . . 317 Uninstalling an application through programming . . . . . . . . . . . . . . . . . . . . 318 Manipulating additional attributes for a deployed application . . . . . . . . . . . . . . . . 321 Sharing sessions for application management . . . . . . . . . . . . . . . . . . . . . 323 Updating an application through programming . . . . . . . . . . . . . . . . . . . . . 324 Adding to, updating, or deleting part of an application through programming . . . . . . . . . . 326 Editing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 Preparing a module and adding it to an existing application through programming . . . . . . . . 331 Preparing and updating a module through programming . . . . . . . . . . . . . . . . . . 334 Deleting a module through programming . . . . . . . . . . . . . . . . . . . . . . . 336 Adding a file through programming . . . . . . . . . . . . . . . . . . . . . . . . . 338 Updating a file through programming . . . . . . . . . . . . . . . . . . . . . . . . . 341 Deleting a file through programming . . . . . . . . . . . . . . . . . . . . . . . . . 343 Extending application management operations through programming . . . . . . . . . . . . . 345 Contents v

Chapter 9. Deploying and administering business-level applications 349 Business-level applications 349 Assets 352 Composition units Importing assets Upload asset settings Asset settings Managing assets 359 Asset collection 359 Updating assets Deleting assets Exporting assets Creating business-level applications 364 Creating business-level applications with the console 365 Business-level application settings Composition unit settings Example: Creating a business-level application Starting business-level applications 379 Stopping business-level applications 379 Updating business-level applications 380 Deleting business-level applications Chapter 10. Administering business-level applications using programming 383 Creating an empty business-level application using programming Importing an asset using programming Adding a composition unit using programming Starting a business-level application using programming Stopping a business-level application using programming Checking the status of a business-level application using programming 407 Deleting a business-level application using programming Deleting an asset using programming 414 Deleting a composition unit using programming 418 ing programming 422 Listing assets using programming 425 Listing composition units using programming 429 Listing business-level applications using programming Editing a composition unit using programming Editing an asset using programming 442 Editing a business-level application using programming 446 Updating an asset using programming Viewing a composition unit using programming 454 Viewing an asset using programming Viewing a business-level application using programming Listing control operations using programming Chapter 11. Troubleshooting deployment 471 Application deployment problems Application deployment troubleshooting tips 76 A client program does not work Application startup errors Application startup problems Web resource is not displayed Application uninstallation problems 487 Chapter 12. Troubleshooting administration Administration and administrative console troubleshooting VI Administering applications and their environment

Chapter 9. Deploying and administering business-level applications . . . . . . . . . . . 349 Business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 Composition units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 Importing assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Upload asset settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 Asset settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Managing assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 Asset collection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 Updating assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 Deleting assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Exporting assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Creating business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . 364 Creating business-level applications with the console . . . . . . . . . . . . . . . . . . 365 Business-level application settings . . . . . . . . . . . . . . . . . . . . . . . . . 375 Composition unit settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 Example: Creating a business-level application . . . . . . . . . . . . . . . . . . . . 377 Starting business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . 379 Stopping business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . 379 Updating business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . 380 Deleting business-level applications . . . . . . . . . . . . . . . . . . . . . . . . . 381 Chapter 10. Administering business-level applications using programming . . . . . . . . . 383 Creating an empty business-level application using programming . . . . . . . . . . . . . . 385 Importing an asset using programming . . . . . . . . . . . . . . . . . . . . . . . . 388 Adding a composition unit using programming . . . . . . . . . . . . . . . . . . . . . 394 Starting a business-level application using programming. . . . . . . . . . . . . . . . . . 400 Stopping a business-level application using programming . . . . . . . . . . . . . . . . . 403 Checking the status of a business-level application using programming . . . . . . . . . . . . 407 Deleting a business-level application using programming . . . . . . . . . . . . . . . . . 411 Deleting an asset using programming . . . . . . . . . . . . . . . . . . . . . . . . 414 Deleting a composition unit using programming . . . . . . . . . . . . . . . . . . . . . 418 Exporting an asset using programming . . . . . . . . . . . . . . . . . . . . . . . . 422 Listing assets using programming . . . . . . . . . . . . . . . . . . . . . . . . . . 425 Listing composition units using programming . . . . . . . . . . . . . . . . . . . . . . 429 Listing business-level applications using programming . . . . . . . . . . . . . . . . . . 433 Editing a composition unit using programming . . . . . . . . . . . . . . . . . . . . . 436 Editing an asset using programming . . . . . . . . . . . . . . . . . . . . . . . . . 442 Editing a business-level application using programming . . . . . . . . . . . . . . . . . . 446 Updating an asset using programming . . . . . . . . . . . . . . . . . . . . . . . . 450 Viewing a composition unit using programming . . . . . . . . . . . . . . . . . . . . . 454 Viewing an asset using programming. . . . . . . . . . . . . . . . . . . . . . . . . 458 Viewing a business-level application using programming. . . . . . . . . . . . . . . . . . 461 Listing control operations using programming. . . . . . . . . . . . . . . . . . . . . . 465 Chapter 11. Troubleshooting deployment . . . . . . . . . . . . . . . . . . . . . . 471 Application deployment problems . . . . . . . . . . . . . . . . . . . . . . . . . . 471 Application deployment troubleshooting tips . . . . . . . . . . . . . . . . . . . . . . 476 A client program does not work . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 Application startup errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 Application startup problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 Web resource is not displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . 485 Application uninstallation problems. . . . . . . . . . . . . . . . . . . . . . . . . . 487 Chapter 12. Troubleshooting administration . . . . . . . . . . . . . . . . . . . . . 489 Administration and administrative console troubleshooting . . . . . . . . . . . . . . . . . 489 vi Administering applications and their environment

Admi inistrative console does not start even though installation completes ministrative console- browser connection problems When a single user that uses multiple instances of the Mozilla browser logs into the administrative console, the first user id that logs into the administrative console is the current user. 494 A user on Mozilla browser Version 1.4 selects a check box on a collection table, presses Enter, and receives an erro A user on Mozilla browser Version 1. 4 enters an invalid ID or password, presses Enter, and eceives an error message Web server plug-in troubleshooting tips 495 Administrative scripting problems Tracing and logging facilities- troubleshooting tips Server startup problems Server hangs during shutdown if it creates a Java core dump(Red Hat Linux Command line tool problems 506 Appendix Directory conventions Notices 513 Trademarks and service marks 515

Administrative console does not start even though installation completes . . . . . . . . . . . 492 Administrative console - browser connection problems . . . . . . . . . . . . . . . . . . 494 When a single user that uses multiple instances of the Mozilla browser logs into the administrative console, the first user ID that logs into the administrative console is the current user. . . . . . 494 A user on Mozilla browser Version 1.4 selects a check box on a collection table, presses Enter, and receives an error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 A user on Mozilla browser Version 1.4 enters an invalid ID or password, presses Enter, and receives an error message. . . . . . . . . . . . . . . . . . . . . . . . . . . 494 Web server plug-in troubleshooting tips . . . . . . . . . . . . . . . . . . . . . . . . 495 Administrative scripting problems . . . . . . . . . . . . . . . . . . . . . . . . . . 497 Tracing and logging facilities - troubleshooting tips . . . . . . . . . . . . . . . . . . . . 504 Server startup problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 Server hangs during shutdown if it creates a Java core dump (Red Hat Linux) . . . . . . . . . 506 Command line tool problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 Appendix. Directory conventions . . . . . . . . . . . . . . . . . . . . . . . . . 509 Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 Trademarks and service marks . . . . . . . . . . . . . . . . . . . . . . . . . . 515 Contents vii

VIll Administering applications and their environment

viii Administering applications and their environment

How to send your comments Your feedback is important in helping to provide the most accurate and highest quality information. To send comments on articles in the Web Sphere Application Server Information Center 1. Display the article in your Web browser and scroll to the end of the article 2. Click on the Feedback link at the bottom of the article, and a separate window containing an e-mail form 3. Fill out the e-mail form as instructed, and click on submit feedback TosendcommentsonPDFbooks,youcane-mailyourcommentsto:wasdoc@us.ibm.comorfax them to919-2545250. Be sure to include the document name and number, the WebSphere Application Server version you are using, and, if applicable, the specific page, table, or figure number on which you are commenting When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you Copyright IBM Corp. 2008

How to send your comments Your feedback is important in helping to provide the most accurate and highest quality information. v To send comments on articles in the WebSphere Application Server Information Center 1. Display the article in your Web browser and scroll to the end of the article. 2. Click on the Feedback link at the bottom of the article, and a separate window containing an e-mail form appears. 3. Fill out the e-mail form as instructed, and click on Submit feedback . v To send comments on PDF books, you can e-mail your comments to: wasdoc@us.ibm.com or fax them to 919-254-5250. Be sure to include the document name and number, the WebSphere Application Server version you are using, and, if applicable, the specific page, table, or figure number on which you are commenting. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corp. 2008 ix

x Administering applications and their environment

x Administering applications and their environment