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