IBM WebSphere Application Server - Express for IBM i, Version 8.0 Administering applications and their environment Note Before using this information, be sure to read the general information under “Notices” on page 539. Compilation date: July 15, 2011 © Copyright IBM Corporation 2011. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 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 Chapter 2. How do I administer applications and their environments? ............3 Chapter 3. Using the administrative clients ......................5 Using the administrative console ...........................5 Administrative console ..............................5 Installing and uninstalling the administrative console ..................18 Starting and logging off the administrative console ...................18 Specifying console preferences ..........................21 Accessing help and product information from the administrative console ...........27 Changing the console session expiration .......................48 Changing the class loader order of the console module deployed in Integrated Solutions Console 49 Getting started with wsadmin scripting .........................50 What is new for scripted administration (wsadmin) ...................51 Overview and new features for scripting the application serving environment..........52 Using administrative programs (JMX) .........................53 Java Management Extensions (JMX) for WebSphere Application Server ...........54 Creating a custom Java administrative client program using WebSphere Application Server administrative Java APIs ............................56 Creating a Java Management Extensions client program using the Java Management Extensions Remote application programming interface .....................67 Extending the WebSphere Application Server administrative system with custom MBeans .....71 Administrative programs for multiple Java Platform, Enterprise Edition application servers .....84 Deploying and managing a custom Java administrative client program with multiple Java Platform, Enterprise Edition application servers .......................85 Java Management Extensions V1.0 to Java Management Extensions V1.2 migration ......87 Java Management Extensions (JMX) interoperability ..................87 Using command-line tools .............................88 manageprofiles command .............................89 startServer command ..............................101 stopServer command ..............................104 serverStatus command ..............................106 cleanupNode command..............................107 registerNode command ..............................107 deregisterNode command .............................109 backupConfig command..............................111 restoreConfig command..............................113 checkprereqs command..............................115 prerequisite validator tool .............................116 versionInfo command ..............................117 Location of the command file ...........................117 Syntax for the versionInfo command ........................117 Parameters .................................117 Report description ...............................118 genVersionReport command ............................119 Location of the command file...........................120 Syntax for the genVersionReport command .....................120 Report description ...............................120 © Copyright IBM Corp. 2011 iii historyInfo command ...............................121 Location of the command file...........................121 Syntax for the historyInfo command ........................121 Parameters .................................122 Report description ...............................122 genHistoryReport command ............................123 Location of the command file...........................123 Syntax for the genHistoryReport command .....................123 Report description ...............................123 ivt command ..................................124 port validator tool ................................124 Directory conventions .............................126 managesdk command ..............................127 GenPluginCfg command .............................131 Configuring Qshell to run WebSphere Application Server scripts using wsadmin scripting .....133 Qshell environment variables............................134 Granting authority to a profile using the IBM i command line using wsadmin scripting .......134 Revoking authority to a profile using the IBM i command line using wsadmin scripting.......135 enbprfwas command ...............................136 configureOs400WebServerDefinition command .....................137 removeOs400WebServerDefinition command ......................139 chgwassvr command...............................140 dspwasinst command ..............................142 enablejvm command (deprecated) ..........................143 heapMonitor command ..............................144 rvkwasaut command ...............................145 servicetools command ..............................146 updwashost command using wsadmin scripting .....................147 grtwasaut command ...............................148 EARExpander command .............................149 revokeCertificate command ............................150 requestCertificate command ............................152 createCertRequest command ...........................154 queryCertificate command .............................155 Example: Security and the command line tools .....................157 Chapter 4. Using Ant to automate tasks .......................159 Chapter 5. Starting and stopping quick reference ...................161 Chapter 6. Backing up and recovering the application serving environment.........163 Chapter 7. Class loading.............................165 Class loaders .................................165 Configuring class loaders of a server .........................170 Class loader collection ..............................171 Class loader ID ................................171 Class loader order...............................171 Class loader settings..............................171 Configuring application class loaders .........................172 Configuring web module class loaders ........................174 Class loading: Resources for learning ........................175 Chapter 8. Deploying and administering enterprise applications .............177 Enterprise (Java EE) applications ..........................177 System applications ..............................178 iv Administering applications and their environment Common deployment framework .........................178 Installing enterprise application files .........................179 Installable enterprise module versions .......................180 Ways to install enterprise applications or modules ...................182 Installing enterprise application files with the console ...................183 Example: Installing an EAR file using the default bindings ................190 Example: Installing a web services sample with the console ...............191 Preparing for application installation settings .....................192 Preparing for application installation binding settings ..................193 Select installation options settings .........................198 Manage modules settings ............................208 Client module settings .............................209 Client module property settings ..........................210 Provide options to compile JavaServer Pages settings .................210 EJB JNDI names for beans ...........................211 Bind EJB business settings ...........................212 Map default data sources for modules containing 1.x entity beans .............213 EJB references ................................214 Resource references ..............................215 Virtual hosts settings ..............................218 Security role to user or group mapping .......................219 JASPI authentication enablement for applications ...................220 User RunAs collection .............................220 Ensure all unprotected 1.x methods have the correct level of protection ...........221 Bind listeners for message-driven beans settings ...................221 Map data sources for all 2.x CMP beans ......................223 Map data sources for all 2.x CMP beans settings ...................225 Ensure all unprotected 2.x methods have the correct level of protection ...........227 Provide options to perform the EJB Deploy settings ..................228 Shared library reference and mapping settings ....................231 Shared library relationship and mapping settings ...................232 JSP and JSF option settings ...........................233 Context root for web modules settings .......................234 Initial parameters for servlets settings .......................234 Environment entries for client modules settings ....................235 Environment entries for EJB modules settings ....................236 Environment entries for web modules settings ....................237 Environment entries for application settings .....................237 Resource environment references .........................238 Message destination reference