gfish

OracleGlassFish Server 3.1AdministrationGuide

Part No: 821241612July 2011

Copyright 2010, 2011, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectualproperty laws. Except as expressly permitted in your license agreement or allowed by law, youmay not use, copy, reproduce, translate, broadcast, modify, license,transmit, distribute, exhibit, perform, publish or display any part, in any form, or by anymeans. Reverse engineering, disassembly, or decompilation of this software,unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice isapplicable:

U.S. GOVERNMENTRIGHTS

Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or"commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication,disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extentapplicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of informationmanagement applications. It is not developed or intended for use in any inherentlydangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shallbe responsible to take all appropriate fail-safe, backup, redundancy, and othermeasures to ensure its safe use. Oracle Corporation and its affiliates disclaim anyliability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other namesmay be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registeredtrademarks of SPARC International, Inc. AMD,Opteron, the AMD logo, and the AMDOpteron logo are trademarks or registered trademarks of AdvancedMicroDevices. UNIX is a registered trademark of TheOpenGroup.

This software or hardware and documentationmay provide access to or information on content, products, and services from third parties. Oracle Corporation andits affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporationand its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

111130@25097

Contents

Preface ...................................................................................................................................................25

1 OverviewofGlassFish ServerAdministration ................................................................................ 33Default Settings and Locations .......................................................................................................... 33Configuration Tasks ............................................................................................................................ 34

Initial Configuration Tasks ......................................................................................................... 35HowDotted NamesWork for Configuration ........................................................................... 37Configuration Files ...................................................................................................................... 38Impact of Configuration Changes ............................................................................................. 38

Administration Tools .......................................................................................................................... 42Administration Console .............................................................................................................. 42asadminUtility ............................................................................................................................. 43REST Interfaces ............................................................................................................................ 43Update Tool .................................................................................................................................. 44keytoolUtility ............................................................................................................................. 44JavaMonitoring andManagement Console (JConsole) ......................................................... 44

Instructions for Administering GlassFish Server ............................................................................ 45

Part I RuntimeAdministration ....................................................................................................................47

2 General Administration ......................................................................................................................49Using the asadminUtility ................................................................................................................... 49

Path to the asadminUtility .......................................................................................................... 50asadminUtility Syntax ................................................................................................................ 50

To Run an asadminUtility Subcommand in SingleMode ...................................................... 51 ToDisplay Help Information for the asadminUtility or a Subcommand ............................ 52 To Start aMultimode Session ..................................................................................................... 53

3

To End aMultimode Session ...................................................................................................... 54 To Run a Set of asadmin Subcommands From a File ............................................................... 55

Administering System Properties ...................................................................................................... 56 ToCreate System Properties ....................................................................................................... 56 To List System Properties ............................................................................................................ 57 ToDelete a System Property ....................................................................................................... 57

Administering Resources ................................................................................................................... 58 ToAdd Resources From an XML File ....................................................................................... 58

Listing Various System Elements ...................................................................................................... 59 ToDisplay the GlassFish Server Version .................................................................................. 59 To List Applications ..................................................................................................................... 59 To List Containers ....................................................................................................................... 60 To ListModules ............................................................................................................................ 61 To List Subcommands ................................................................................................................. 62 To List Timers .............................................................................................................................. 62 To ShowComponent Status ....................................................................................................... 63

Using REST Interfaces to Administer GlassFish Server .................................................................. 63Using RESTURLs to Administer GlassFish Server ................................................................. 64Using REST ResourceMethods to Administer GlassFish Server ........................................... 67Resources for asadmin Subcommands That PerformNon-CRUDOperations .................. 76Securing GlassFish Server REST Interfaces .............................................................................. 77Formats for Resource Representation of ConfigurationObjects ........................................... 78Formats for Resource Representation ofMonitoring Objects ............................................... 88Formats for Resource Representation of Log File Details ....................................................... 96Supported Content Types in Requests to REST Resources ................................................... 100

3 AdministeringDomains ...................................................................................................................101About Administering Domains ....................................................................................................... 101

GlassFish Server Instances ........................................................................................................ 102Domains for Administering GlassFish Server ........................................................................ 102Domain Administration Server (DAS) ................................................................................... 103

Creating, Logging In To, andDeleting a Domain ......................................................................... 103 ToCreate a Domain ................................................................................................................... 103 ToCreate a Domain From a CustomTemplate ..................................................................... 104 To List Domains ......................................................................................................................... 108

Contents

Oracle GlassFish Server 3.1 Administration Guide July 20114

To Log In to a Domain .............................................................................................................. 108 ToDelete a Domain ................................................................................................................... 110

Starting and Stopping a Domain ..................................................................................................... 111 To Start a Domain ...................................................................................................................... 111 To Stop a Domain ...................................................................................................................... 112 To Restart a Domain .................................................................................................................. 112

Configuring a DAS or a GlassFish Server Instance for Automatic Restart ................................. 113 ToConfigure a DAS or an Instance for Automatic Restart onWindows ........................... 114 ToConfigure a DAS or an Instance for Automatic Restart on Linux .................................. 115 ToConfigure a DAS or an Instance for Automatic Restart onOracle Solaris .................... 116 To Prevent Service ShutdownWhen aUser Logs Out onWindows ................................... 118

Suspending and Resuming a Domain ............................................................................................. 118 To Suspend aDomain ............................................................................................................... 119 To Resume aDomain ................................................................................................................ 119

Setting UpAutomatic Backups of a Domain ................................................................................. 120 ToCreate a Backup Configuration .......................................................................................... 121 To List Backup Configurations ................................................................................................ 122 To Enable a Backup Configuration .......................................................................................... 123 ToDisable a Backup Configuration ......................................................................................... 124 ToDelete a Backup Configuration .......................................................................................... 124 ToCreate a Schedule ................................................................................................................. 125 To List Schedules ........................................................................................................................ 126 ToDelete a Schedule .................................................................................................................. 126

Backing Up and Restoring a Domain .............................................................................................. 127 To BackUp aDomain ............................................................................................................... 127 To Restore a Domain ................................................................................................................. 128 To List Domain Backups ........................................................................................................... 129

Re-Creating the Domain Administration Server (DAS) .............................................................. 129 ToMigrate the DAS ................................................................................................................... 130

Additional Domain Tasks ................................................................................................................ 131 ToDisplay DomainUptime ..................................................................................................... 132 To Switch a Domain to Another Supported Java Version .................................................... 132 ToChange the Administration Port of a Domain .................................................................. 133

Contents

5

4 Administering theVirtualMachine for the JavaPlatform ......................................................... 137Administering JVMOptions ........................................................................................................... 137 ToCreate JVMOptions ............................................................................................................ 138 To List JVMOptions ................................................................................................................. 138 ToDelete JVMOptions ............................................................................................................. 139 ToGenerate a JVMReport ....................................................................................................... 140

Administering the Profiler ............................................................................................................... 141 ToCreate a Profiler .................................................................................................................... 141 ToDelete a Profiler .................................................................................................................... 142

5 AdministeringThreadPools ............................................................................................................143About Thread Pools ........................................................................................................................... 143Configuring Thread Pools ................................................................................................................ 144 ToCreate a Thread Pool ............................................................................................................ 144 To List Thread Pools .................................................................................................................. 145 ToUpdate a Thread Pool .......................................................................................................... 145 ToDelete a Thread Pool ............................................................................................................ 146

6 AdministeringWebApplications ....................................................................................................147Invoking a Servlet by AlternateMeans ........................................................................................... 147Changing LogOutput for a Servlet .................................................................................................. 148Defining Global Features forWebApplications ............................................................................ 148 ToUse the default-web.xml File ............................................................................................ 149

Redirecting a URL ............................................................................................................................. 149Administering mod_jk ...................................................................................................................... 150 To Enable mod_jk ....................................................................................................................... 150 To Load Balance Using mod_jk andGlassFish Server ........................................................... 152 To Enable SSL Between the mod_jk Load Balancer and the Browser .................................. 154 To Enable SSL Between the mod_jk Load Balancer andGlassFish Server ........................... 155

7 Administering the Logging Service ................................................................................................157About Logging ................................................................................................................................... 157

Log Files ....................................................................................................................................... 157Logger Namespaces ................................................................................................................... 160

Contents


Logging Targets .......................................................................................................................... 161Logging Properties ..................................................................................................................... 161

Configuring the Logging Service ..................................................................................................... 162Changing the Name and Location of Logging Service Files .................................................. 162Setting Log Levels ....................................................................................................................... 164Setting Log File Rotation ........................................................................................................... 168Adding a Custom LoggingHandler ......................................................................................... 172

Viewing Log Records ........................................................................................................................ 173 ToCollect Log Files into a ZIP Archive ................................................................................... 173

8 Administering theMonitoring Service ..........................................................................................175AboutMonitoring ............................................................................................................................. 175

How theMonitoring Tree StructureWorks ........................................................................... 176AboutMonitoring for Add-on Components ......................................................................... 181Tools forMonitoring GlassFish Server ................................................................................... 182

ConfiguringMonitoring ................................................................................................................... 182 To EnableMonitoring ............................................................................................................... 182 ToDisableMonitoring .............................................................................................................. 183

Viewing CommonMonitoring Data .............................................................................................. 185 ToViewCommonMonitoring Data ....................................................................................... 185

CommonMonitoring Statistics ............................................................................................... 186Viewing ComprehensiveMonitoring Data .................................................................................... 187

Guidelines for Using the list and get Subcommands forMonitoring .............................. 187 ToViewComprehensiveMonitoring Data ............................................................................ 188

ComprehensiveMonitoring Statistics ..................................................................................... 190Configuring JConsole to ViewGlassFish ServerMonitoring Data ............................................. 214 ToConnect JConsole to GlassFish Server ............................................................................... 214

9 Writing andRunning JavaScript Clients toMonitorGlassFish Server ......................................217Running a Script forMonitoring GlassFish Server ....................................................................... 217 To Run a Script forMonitoring GlassFish Server .................................................................. 218

Writing Scripts in the JavaScript Language forMonitoring GlassFish Server ........................... 218Obtaining Information About Events That ProvideMonitoring Data ............................... 218

To Register a Script as a Listener for an Event ........................................................................ 221 ToDisplay Information From a Script .................................................................................... 222

Contents

7

Writing an Event Callback Function ....................................................................................... 223Sample JavaScript Programs forMonitoring GlassFish Server .................................................... 225JavaScriptMonitoring Client API Reference ................................................................................. 228

Object client ............................................................................................................................. 228Object scriptContainer .......................................................................................................... 229

10 Administering Life CycleModules ..................................................................................................231About Life CycleModules ................................................................................................................ 231Configuring Life CycleModules ...................................................................................................... 232 ToCreate a Life CycleModule .................................................................................................. 232 To List Life CycleModules ........................................................................................................ 233 ToUpdate a Life CycleModule ................................................................................................ 233 ToDelete a Life CycleModule .................................................................................................. 234

11 Extending andUpdatingGlassFish Server .................................................................................... 235About Add-OnComponents ........................................................................................................... 235Preconfigured Repositories for GlassFish Server ........................................................................... 236

Oracle GlassFish Server Repositories ...................................................................................... 236GlassFish Server Open Source Edition Repositories ............................................................. 239

Tools for Extending andUpdating GlassFish Server .................................................................... 239Update Tool ................................................................................................................................ 240The pkgCommand .................................................................................................................... 240Administration Console ............................................................................................................ 240

Adding Components ......................................................................................................................... 241 To Install an Add-on Component ............................................................................................ 241

Updating Installed Components ..................................................................................................... 244 ToUpdate an Installed Component ........................................................................................ 244 ToUpdate All Installed Components in an Image ................................................................ 246

Removing Installed Components .................................................................................................... 247 ToUninstall an Installed Component ..................................................................................... 247 ToUninstall and Revert to anOlder Version of a Component ............................................ 249

Upgrading to Oracle GlassFish Server FromGlassFish Server Open Source Edition ............... 250 ToUpgrade to Oracle GlassFish Server by Using Update Tool ........................................... 251 ToUpgrade to Oracle GlassFish Server by Using the pkgCommand ................................. 252

Extending andUpdating GlassFish Server Inside a ClosedNetwork .......................................... 254

Contents


To Install the Pre-Installed Toolkit Image Inside a ClosedNetwork ................................... 255 ToConfigure a Local Repository Server Inside a ClosedNetwork ...................................... 256 ToConfigure a GlassFish Server Installation to Use a Local Repository Server Inside a

ClosedNetwork .......................................................................................................................... 259 To Install Updates From a Local Repository .......................................................................... 260

Part II Resources andServicesAdministration ........................................................................................ 263

12 AdministeringDatabaseConnectivity ..........................................................................................265About Database Connectivity .......................................................................................................... 265Setting Up the Database .................................................................................................................... 266 To Install the Database andDatabase Driver ......................................................................... 267 To Start the Database ................................................................................................................. 267 To Stop the Database ................................................................................................................. 268

Java DBUtility Scripts ............................................................................................................... 268Configuring Access to the Database ................................................................................................ 269

Administering JDBCConnection Pools ................................................................................. 270Administering JDBCResources ............................................................................................... 278Enabling the jdbc/__default Resource in a Clustered Environment ............................... 281Integrating the JDBCDriver ..................................................................................................... 282

Configuration Specifics for JDBCDrivers ...................................................................................... 283IBMDB2Database Type 2 Driver ............................................................................................ 283IBMDB2Database Type 4 Driver ............................................................................................ 284Java DB/Derby Type 4 Driver ................................................................................................... 284MySQL Server Database Type 4 Driver ................................................................................... 285Oracle 10 Database Driver ........................................................................................................ 285Oracle 11 Database Driver ........................................................................................................ 286PostgreSQL Type 4Driver ........................................................................................................ 287DataDirect Type 4 Driver for IBMDB2Database ................................................................. 287DataDirect Type 4 Driver for IBM Informix .......................................................................... 288DataDirect Type 4 Driver forMicrosoft SQL Server Database ............................................ 288DataDirect Type 4 Driver forMySQL Server Database ......................................................... 289DataDirect Type 4 Driver for Oracle 11 Database ................................................................. 289DataDirect Type 4 Driver for Sybase Database ...................................................................... 290Inet OraxoDriver for Oracle Database ................................................................................... 290

Contents

9

InetMerlia Driver forMicrosoft SQL Server Database ......................................................... 291Inet Sybelux Driver for Sybase Database ................................................................................. 291JConnect Type 4 Driver for Sybase ASE 12.5 Database ......................................................... 292

13 Administering EIS Connectivity ......................................................................................................293About EIS Connectivity .................................................................................................................... 294Administering Connector Connection Pools ................................................................................ 295 ToCreate a Connector Connection Pool ................................................................................ 295 To List Connector Connection Pools ...................................................................................... 296 ToConnect to (Ping) or Reset (Flush) a Connector Connection Pool ................................ 297 ToUpdate a Connector Connection Pool .............................................................................. 297 ToDelete a Connector Connection Pool ................................................................................ 298

Administering Connector Resources .............................................................................................. 298 ToCreate a Connector Resource ............................................................................................. 298 To List Connector Resources ................................................................................................... 299 ToUpdate a Connector Resource ............................................................................................ 300 ToDelete a Connector Resource .............................................................................................. 300

Administering the Resource Adapter Configuration .................................................................... 301 ToCreate Configuration Information for a Resource Adapter ............................................ 301 To List Resource Adapter Configurations .............................................................................. 302 ToUpdate a Resource Adapter Configuration ....................................................................... 302 ToDelete a Resource Adapter Configuration ........................................................................ 303

Administering Connector SecurityMaps ....................................................................................... 303 ToCreate a Connector SecurityMap ...................................................................................... 304 To List Connector SecurityMaps ............................................................................................ 304 ToUpdate a Connector SecurityMap ..................................................................................... 305 ToDelete a Connector SecurityMap ....................................................................................... 306

Administering ConnectorWork SecurityMaps ........................................................................... 306 ToCreate a ConnectorWork SecurityMap ........................................................................... 307 To List ConnectorWork SecurityMaps ................................................................................. 308 ToUpdate a ConnectorWork SecurityMap .......................................................................... 308 ToDelete a ConnectorWork SecurityMap ........................................................................... 309

Administering AdministeredObjects ............................................................................................. 309 ToCreate an AdministeredObject .......................................................................................... 310 To List AdministeredObjects ................................................................................................... 310

Contents


ToUpdate an AdministeredObject ......................................................................................... 311 ToDelete an AdministeredObject .......................................................................................... 311

14 Administering Internet Connectivity .............................................................................................313About Internet Connectivity ............................................................................................................ 313

About HTTPNetwork Listeners .............................................................................................. 313About Virtual Servers ................................................................................................................ 314

AdministeringHTTPNetwork Listeners ....................................................................................... 315 ToCreate an Internet Connection ........................................................................................... 316

AdministeringHTTP Protocols ............................................................................................... 316AdministeringHTTPConfigurations ..................................................................................... 318AdministeringHTTP Transports ............................................................................................ 319AdministeringHTTPNetwork Listeners ............................................................................... 321

Administering Virtual Servers ......................................................................................................... 325 ToCreate a Virtual Server ......................................................................................................... 326 To List Virtual Servers ............................................................................................................... 327 ToUpdate a Virtual Server ....................................................................................................... 327 ToDelete a Virtual Server ......................................................................................................... 327

ToAssign a DefaultWebModule to a Virtual Server ............................................................ 328 ToAssign a Virtual Server to an Application orModule ...................................................... 328 To Set JSESSIONIDSSOCookie Attributes ............................................................................... 329

15 Administering theObject Request Broker (ORB) ......................................................................... 331About the ORB ................................................................................................................................... 331Configuring the ORB ........................................................................................................................ 332Administering IIOP Listeners .......................................................................................................... 332 ToCreate an IIOP Listener ....................................................................................................... 332 To List IIOP Listeners ................................................................................................................ 333 ToUpdate an IIOP Listener ...................................................................................................... 333 ToDelete an IIOP Listener ....................................................................................................... 334

16 Administering the JavaMail Service ...............................................................................................335About JavaMail .................................................................................................................................. 335Administering JavaMail Resources ................................................................................................. 336

Contents

11

ToCreate a JavaMail Resource ................................................................................................. 336 To List JavaMail Resources ....................................................................................................... 337 ToUpdate a JavaMail Resource ................................................................................................ 337 ToDelete a JavaMail Resource ................................................................................................. 338

17 Administering the JavaMessage Service (JMS) ........................................................................... 339About the JMS Service ....................................................................................................................... 340

JMS Service High Availability ................................................................................................... 341Updating the JMS Service Configuration ....................................................................................... 341

SettingMessage Queue Broker Properties in the JMS Service Configuration .................... 343Administering JMSHosts ................................................................................................................. 343

About JMSHost Types .............................................................................................................. 343Configuring Embedded and Local JMSHosts ........................................................................ 344

ToCreate a JMSHost ................................................................................................................. 345 To List JMSHosts ....................................................................................................................... 346 ToUpdate a JMSHost ............................................................................................................... 347 ToDelete a JMSHost ................................................................................................................. 348

Administering JMSConnection Factories andDestinations ....................................................... 348 ToCreate a Connection Factory or Destination Resource ................................................... 349 To List JMS Resources ............................................................................................................... 351 ToDelete a Connection Factory or Destination Resource ................................................... 351

Administering JMS Physical Destinations ..................................................................................... 352 ToCreate a JMS Physical Destination ..................................................................................... 352 To List JMS Physical Destinations ........................................................................................... 353 To PurgeMessages From a Physical Destination ................................................................... 354 ToDelete a JMS Physical Destination ..................................................................................... 354

Special SituationsWhenUsing the JMS Service ............................................................................ 355Troubleshooting the JMS Service .................................................................................................... 356Using the Generic Resource Adapter for JMS to Integrate Supported External JMSProviders ............................................................................................................................................. 356

Configuring GenericJMSRA for Supported External JMS Providers .................................. 357Using GenericJMSRAwithWebLogic JMS ............................................................................ 364Using GenericJMSRAwith IBMWebSphereMQ ................................................................. 377

Contents


18 Administering the JavaNamingandDirectory Interface (JNDI) Service .................................387About JNDI ........................................................................................................................................ 387

Java EENaming Environment .................................................................................................. 388How the Naming Environment and the ContainerWork Together ................................... 388Naming References and Binding Information ....................................................................... 389

Administering JNDI Resources ....................................................................................................... 389Administering Custom JNDI Resources ................................................................................. 390Administering External JNDI Resources ................................................................................ 392

19 AdministeringTransactions .............................................................................................................397About Transactions ........................................................................................................................... 397

Transaction ResourceManagers .............................................................................................. 399Transaction Scope ...................................................................................................................... 399

Configuring the Transaction Service .............................................................................................. 400Managing the Transaction Service for Rollbacks .......................................................................... 401 To Stop the Transaction Service ............................................................................................... 402 To Roll Back a Transaction ....................................................................................................... 402 To Restart the Transaction Service .......................................................................................... 403

Determining Local Transaction Completion at Shutdown .................................................. 404Recovering Transactions .................................................................................................................. 404

Automatic Transaction Recovery ............................................................................................ 404 ToManually Recover Transactions ......................................................................................... 405

Distributed Transaction Recovery ........................................................................................... 406RecoveryWorkarounds and Limitations ................................................................................ 406

Transaction Logging ......................................................................................................................... 408 To Store Transaction Logs in a Database ................................................................................ 408

Part III Appendixes .........................................................................................................................................411

A Subcommands for the asadminUtility ........................................................................................... 413General Administration Subcommands ........................................................................................ 414Connectivity Subcommands ............................................................................................................ 416Domain Subcommands .................................................................................................................... 419Internet Connectivity Subcommands ............................................................................................. 420

Contents

13

JavaMail Subcommands ................................................................................................................... 421JMS Subcommands ........................................................................................................................... 422JNDI Subcommands ......................................................................................................................... 423JVM Subcommands .......................................................................................................................... 424Life CycleModule Subcommands ................................................................................................... 424Logging andMonitoring Subcommands ....................................................................................... 425ORB Subcommands .......................................................................................................................... 426Thread Pool Subcommands ............................................................................................................. 426Transaction Service Subcommands ................................................................................................ 426

Index ................................................................................................................................................... 429

Contents


Figures

FIGURE 21 WebPage for the RESTResource forManaging aDomain ................................. 66FIGURE 22 WebPage for the RESTResource That Provides Class Loader Statistics ........... 95

15

Tables

TABLE 11 DefaultAdministrationValues ................................................................................ 34TABLE 12 Default Locations ...................................................................................................... 34TABLE 21 RESTResourceMethods for AdministeringMonitoring andConfigurationData

...................................................................................................................................... 67TABLE 61 URLFields for ServletsWithin anApplication .................................................... 147TABLE 81 HTTPListenerCommonMonitoring Statistics .................................................. 186TABLE 82 JVMCommonMonitoring Statistics .................................................................... 186TABLE 83 WebModuleCommonMonitoring Statistics ..................................................... 187TABLE 84 Example Resources LevelDottedNames ............................................................. 188TABLE 85 EJBCacheMonitoring Statistics ............................................................................ 192TABLE 86 EJBContainerMonitoring Statistics ..................................................................... 192TABLE 87 EJBMethodMonitoring Statistics ......................................................................... 193TABLE 88 EJBPoolMonitoring Statistics ............................................................................... 194TABLE 89 TimerMonitoring Statistics ................................................................................... 194TABLE 810 HTTP ServiceVirtual ServerMonitoring Statistics ............................................ 195TABLE 811 Jersey Statistics ......................................................................................................... 196TABLE 812 Connector Connection PoolMonitoring Statistics (JMS) ................................. 197TABLE 813 ConnectorWorkManagementMonitoring Statistics (JMS) ............................. 198TABLE 814 JVMMonitoring Statistics for Java SEClass Loading ......................................... 199TABLE 815 JVMMonitoring Statistics for Java SE - Threads ................................................. 199TABLE 816 JVMMonitoring Statistics for Java SECompilation ........................................... 200TABLE 817 JVMMonitoring Statistics for Java SEGarbage Collectors ................................ 200TABLE 818 JVMMonitoring Statistics for Java SEMemory .................................................. 201TABLE 819 JVMStatistics for the Java SEOperating System ................................................. 201TABLE 820 JVMMonitoring Statistics for Java SERuntime .................................................. 202TABLE 821 NetworkKeepAlive Statistics ................................................................................ 203TABLE 822 NetworkConnectionQueue Statistics .................................................................. 203TABLE 823 Network File Cache Statistics ................................................................................. 204TABLE 824 NetworkThreadPool Statistics .............................................................................. 205

17

TABLE 825 ORBMonitoring Statistics (ConnectionManager) ............................................ 205TABLE 826 General ResourceMonitoring Statistics (Connection Pool) .............................. 206TABLE 827 Application Specific ResourceMonitoring Statistics (Connection Pool) ......... 208TABLE 828 EJB SecurityMonitoring Statistics ........................................................................ 208TABLE 829 WebSecurityMonitoring Statistics ....................................................................... 209TABLE 830 RealmSecurityMonitoring Statistics .................................................................... 209TABLE 831 ThreadPoolMonitoring Statistics ........................................................................ 210TABLE 832 JVMMonitoring Statistics for Java SE - Thread Info .......................................... 210TABLE 833 Transaction ServiceMonitoring Statistics ........................................................... 211TABLE 834 WebModule Servlet Statistics ................................................................................ 212TABLE 835 Web JSPMonitoring Statistics ............................................................................... 212TABLE 836 WebRequestMonitoring Statistics ....................................................................... 213TABLE 837 WebServletMonitoring Statistics ......................................................................... 213TABLE 838 WebSessionMonitoring Statistics ........................................................................ 214TABLE 111 OracleGlassFish Server PreconfiguredRepositories .......................................... 236TABLE 112 GlassFish ServerOpen Source Edition PreconfiguredRepositories ................. 239TABLE 141 Default Ports for Listeners ...................................................................................... 315TABLE 181 JNDI LookupNames andTheir Associated References ..................................... 389

Tables


Examples

EXAMPLE 11 Determining if theDASRequires Restart ............................................................... 40EXAMPLE 12 Determining if an Instance Requires Restart ......................................................... 40EXAMPLE 21 Running an asadminUtility Subcommand in SingleMode ................................. 52EXAMPLE 22 Specifying an asadminUtility OptionWith a Subcommand in SingleMode .... 52EXAMPLE 23 Specifying an asadminUtility Option and a SubcommandOption in Single

Mode ........................................................................................................................... 52EXAMPLE 24 DisplayingHelp Information for the asadminUtility ........................................... 53EXAMPLE 25 DisplayingHelp Information for an asadminUtility Subcommand ................... 53EXAMPLE 26 Starting aMultimode SessionWith asadminUtilityOptions .............................. 54EXAMPLE 27 Starting aMultimode Session byUsing the multimode Subcommand ............... 54EXAMPLE 28 Running a Subcommand in aMultimode Session ................................................. 54EXAMPLE 29 Running a Set of asadmin Subcommands From a File .......................................... 55EXAMPLE 210 Creating a SystemProperty ...................................................................................... 56EXAMPLE 211 Listing SystemProperties ......................................................................................... 57EXAMPLE 212 Deleting a SystemProperty ...................................................................................... 58EXAMPLE 213 AddingResources ...................................................................................................... 58EXAMPLE 214 DisplayingVersion Information ............................................................................. 59EXAMPLE 215 ListingApplications .................................................................................................. 60EXAMPLE 216 ListingContainers ..................................................................................................... 60EXAMPLE 217 ListingModules ......................................................................................................... 61EXAMPLE 218 Listing Subcommands .............................................................................................. 62EXAMPLE 219 ListingTimers ............................................................................................................ 63EXAMPLE 220 Showing Status of aComponent .............................................................................. 63EXAMPLE 221 Determining theMethods andMethod Parameters That anObject in the Tree

Supports ..................................................................................................................... 68EXAMPLE 222 RetrievingData for anObject in the Tree ............................................................... 70EXAMPLE 223 Adding anObject to the Tree ................................................................................... 71EXAMPLE 224 Updating anObject in the Tree ................................................................................ 73EXAMPLE 225 Deleting anObject From the Tree ........................................................................... 75

19

EXAMPLE 31 Creating aDomain .................................................................................................. 104EXAMPLE 32 ListingDomains ...................................................................................................... 108EXAMPLE 33 Logging In To aDomain on a RemoteMachine .................................................. 109EXAMPLE 34 Logging In to aDomain on theDefault Port of Localhost .................................. 110EXAMPLE 35 Deleting aDomain .................................................................................................. 110EXAMPLE 36 Starting aDomain ................................................................................................... 111EXAMPLE 37 Stopping aDomain (or Server) .............................................................................. 112EXAMPLE 38 Restarting aDomain (or Server) ............................................................................ 113EXAMPLE 39 Restarting aDomain in a Browser ......................................................................... 113EXAMPLE 310 Creating a Service to Restart a DASAutomatically onWindows ...................... 114EXAMPLE 311 Querying the Service to Restart a DASAutomatically onWindows ................. 115EXAMPLE 312 Creating a Service to Restart a DASAutomatically on Linux ............................. 116EXAMPLE 313 Creating a Service to Restart a DomainAutomatically onOracle Solaris ........ 117EXAMPLE 314 Suspending theDefaultDomain ........................................................................... 119EXAMPLE 315 Resuming theDefaultDomain .............................................................................. 120EXAMPLE 316 Creating a BackupConfiguration .......................................................................... 122EXAMPLE 317 ListingAll BackupConfigurations ........................................................................ 122EXAMPLE 318 ListingDetails for a BackupConfiguration .......................................................... 123EXAMPLE 319 Enabling a BackupConfiguration ......................................................................... 123EXAMPLE 320 Disabling a BackupConfiguration ........................................................................ 124EXAMPLE 321 Deleting a BackupConfiguration .......................................................................... 124EXAMPLE 322 Creating a Schedule ................................................................................................. 125EXAMPLE 323 Listing Schedules ..................................................................................................... 126EXAMPLE 324 Deleting a Schedule ................................................................................................. 126EXAMPLE 325 BackingUp theDefaultDomain ........................................................................... 127EXAMPLE 326 Restoring theDefaultDomain ............................................................................... 128EXAMPLE 327 Listing Backups of theDefault Domain ................................................................ 129EXAMPLE 328 Displaying theDASUptime ................................................................................... 132EXAMPLE 329 Changing theAdministration Port of aDomain ................................................. 134EXAMPLE 41 Creating JVMOptions ............................................................................................ 138EXAMPLE 42 Listing JVMOptions ............................................................................................... 138EXAMPLE 43 Deleting a JVMOption ........................................................................................... 139EXAMPLE 44 DeletingMultiple JVMOptions ............................................................................ 140EXAMPLE 45 Generating a JVMReport ....................................................................................... 140EXAMPLE 46 Creating a Profiler ................................................................................................... 141EXAMPLE 47 Deleting a Profiler .................................................................................................... 142

Examples


EXAMPLE 51 Creating aThreadPool ........................................................................................... 144EXAMPLE 52 ListingThreadPools ............................................................................................... 145EXAMPLE 53 Updating aThreadPool .......................................................................................... 145EXAMPLE 54 Deleting aThreadPool ........................................................................................... 146EXAMPLE 61 Invoking a ServletWith aURL .............................................................................. 148EXAMPLE 62 Invoking a Servlet FromWithin a JSP File ........................................................... 148EXAMPLE 63 Redirecting aURL ................................................................................................... 150EXAMPLE 64 httpd.conf File for mod_jk .................................................................................... 151EXAMPLE 65 workers.properties File for mod_jk ................................................................... 152EXAMPLE 66 httpd.conf File for LoadBalancing ..................................................................... 153EXAMPLE 67 workers.properties File for LoadBalancing .................................................... 153EXAMPLE 68 http-ssl.conf File for mod_jk Security .............................................................. 154EXAMPLE 71 Changing theName and Location of a Cluster's Log File ................................... 163EXAMPLE 72 Setting the java.util.logging.config.file SystemProperty ..................... 164EXAMPLE 73 Listing Logger Levels forModules ......................................................................... 165EXAMPLE 74 Listing Log Levels for an Instance ......................................................................... 166EXAMPLE 75 Changing theGlobal Log Level for AllModule Loggers ..................................... 167EXAMPLE 76 Setting the Log Level for aModule Logger ........................................................... 167EXAMPLE 77 Setting Log Levels forMultiple Loggers ................................................................ 168EXAMPLE 78 Changing theRotation Size .................................................................................... 169EXAMPLE 79 Changing theRotation Interval ............................................................................. 170EXAMPLE 710 Changing the LimitNumber of Retained Files .................................................... 171EXAMPLE 711 Rotating Log FilesManually ................................................................................... 171EXAMPLE 712 Adding aNewLogHandler .................................................................................... 172EXAMPLE 713 Creating aZIPArchive ........................................................................................... 173EXAMPLE 81 Enabling theMonitoring ServiceDynamically .................................................... 183EXAMPLE 82 EnablingMonitoring forModulesDynamically ................................................. 183EXAMPLE 83 EnablingMonitoring forModules byUsing the set Subcommand ................. 183EXAMPLE 84 Disabling theMonitoring ServiceDynamically .................................................. 184EXAMPLE 85 DisablingMonitoring forModulesDynamically ................................................ 184EXAMPLE 86 DisablingMonitoring byUsing the set Subcommand ...................................... 184EXAMPLE 87 ViewingCommonMonitoringData .................................................................... 185EXAMPLE 88 ViewingAttributes for a Specific Type .................................................................. 189EXAMPLE 89 ViewingMonitorableApplications ....................................................................... 190EXAMPLE 810 ViewingAttributes for anApplication .................................................................. 190EXAMPLE 811 Viewing a SpecificAttribute ................................................................................... 190

Examples

21

EXAMPLE 91 Running a Script forMonitoringGlassFish Server ............................................. 218EXAMPLE 92 ListingAll Events ..................................................................................................... 219EXAMPLE 93 DisplayingDetailed InformationAbout an Event ............................................... 220EXAMPLE 94 Registering a Script as a Listener for an Event ...................................................... 222EXAMPLE 95 Displaying Information Froma Script .................................................................. 222EXAMPLE 96 Generating aCounter Statistic ............................................................................... 223EXAMPLE 97 Generating aTimer Statistic ................................................................................... 224EXAMPLE 98 Counting theNumber of Loaded JSPTechnology Pages ................................... 225EXAMPLE 99 Measuring the Time to ProcessWeb Service Requests ....................................... 226EXAMPLE 101 Creating a Life CycleModule ................................................................................. 232EXAMPLE 102 Listing LifeCycleModules ..................................................................................... 233EXAMPLE 103 Updating a Life CycleModule ................................................................................ 234EXAMPLE 104 Deleting a Life CycleModule ................................................................................. 234EXAMPLE 111 Starting a Local RepositoryDaemon .................................................................... 258EXAMPLE 112 Configuring the pkgCommand toUse a Local Repository ................................ 260EXAMPLE 121 Starting aDatabase .................................................................................................. 267EXAMPLE 122 Stopping aDatabase ................................................................................................ 268EXAMPLE 123 Creating a JDBCConnection Pool ........................................................................ 271EXAMPLE 124 Listing JDBCConnectionPools ............................................................................ 271EXAMPLE 125 Contacting aConnectionPool ............................................................................... 272EXAMPLE 126 Resetting (Flushing) aConnection Pool ............................................................... 273EXAMPLE 127 Deleting a JDBCConnection Pool ........................................................................ 274EXAMPLE 128 Creating a JDBCResource ...................................................................................... 279EXAMPLE 129 Listing JDBCResources .......................................................................................... 280EXAMPLE 1210 Updating a JDBCResource .................................................................................... 280EXAMPLE 1211 Deleting a JDBCResource ...................................................................................... 281EXAMPLE 131 Creating aConnectorConnection Pool ............................................................... 296EXAMPLE 132 ListingConnectorConnectionPools .................................................................... 296EXAMPLE 133 Deleting aConnectorConnection Pool ................................................................ 298EXAMPLE 134 Creating aConnector Resource ............................................................................. 299EXAMPLE 135 ListingConnectorResources ................................................................................. 299EXAMPLE 136 Deleting aConnector Resource ............................................................................. 301EXAMPLE 137 Creating a ResourceAdapter Configuration ........................................................ 301EXAMPLE 138 ListingConfigurations for a ResourceAdapter ................................................... 302EXAMPLE 139 Deleting a ResourceAdapter Configuration ........................................................ 303EXAMPLE 1310 Creating aConnector SecurityMap ...................................................................... 304

Examples


EXAMPLE 1311 ListingAll Connector SecurityMaps for a Connector Connection Pool ......... 305EXAMPLE 1312 Listing Principals for a Specific SecurityMap for a Connector Connection Pool

.................................................................................................................................... 305EXAMPLE 1313 Listing Principals of All Connector SecurityMaps for a Connector Connection

Pool ........................................................................................................................... 305EXAMPLE 1314 Updating aConnector SecurityMap .................................................................... 306EXAMPLE 1315 Deleting aConnector SecurityMap ...................................................................... 306EXAMPLE 1316 CreatingConnectorWork SecurityMaps ............................................................ 307EXAMPLE 1317 Listing theConnectorWork SecurityMaps ......................................................... 308EXAMPLE 1318 Updating aConnectorWork SecurityMap ......................................................... 309EXAMPLE 1319 Deleting aConnectorWork SecurityMap ........................................................... 309EXAMPLE 1320 Creating anAdministeredObject .......................................................................... 310EXAMPLE 1321 ListingAdministeredObjects ................................................................................ 311EXAMPLE 1322 Deleting anAdministeredObject .......................................................................... 311EXAMPLE 141 Creating anHTTPProtocol ................................................................................... 317EXAMPLE 142 Listing the Protocols ................................................................................................ 317EXAMPLE 143 Deleting a Protocol .................................................................................................. 318EXAMPLE 144 Creating anHTTPConfiguration ......................................................................... 319EXAMPLE 145 Deleting anHTTPConfiguration ......................................................................... 319EXAMPLE 146 Creating aTransport ............................................................................................... 320EXAMPLE 147 ListingHTTPTransports ....................................................................................... 320EXAMPLE 148 Deleting aTransport ............................................................................................... 321EXAMPLE 149 Creating anHTTPListener .................................................................................... 322EXAMPLE 1410 Creating aNetwork Listener .................................................................................. 322EXAMPLE 1411 ListingHTTPListeners ........................................................................................... 322EXAMPLE 1412 Updating anHTTPNetwork Listener .................................................................. 323EXAMPLE 1413 Deleting anHTTPListener .................................................................................... 323EXAMPLE 1414 Configuring anHTTPListener for SSL ................................................................ 324EXAMPLE 1415 Deleting SSL FromanHTTPListener .................................................................. 324EXAMPLE 1416 Creating aVirtual Server ........................................................................................ 326EXAMPLE 1417 ListingVirtual Servers ............................................................................................ 327EXAMPLE 1418 Deleting aVirtual Server ........................................................................................ 328EXAMPLE 151 Creating an IIOPListener ....................................................................................... 332EXAMPLE 152 Listing IIOPListeners ............................................................................................. 333EXAMPLE 153 Updating an IIOPListener ..................................................................................... 333EXAMPLE 154 Deleting an IIOPListener ....................................................................................... 334

Examples

23

EXAMPLE 161 Creating a JavaMail Resource ................................................................................ 337EXAMPLE 162 Listing JavaMail Resources ..................................................................................... 337EXAMPLE 163 Updating a JavaMail Resource ............................................................................... 338EXAMPLE 164 Deleting a JavaMail Resource ................................................................................. 338EXAMPLE 171 Creating a JMSHost ................................................................................................ 346EXAMPLE 172 Listing JMSHosts .................................................................................................... 346EXAMPLE 173 Updating a JMSHost ............................................................................................... 348EXAMPLE 174 Deleting a JMSHost ................................................................................................ 348EXAMPLE 175 Creating a JMSConnection Factory ..................................................................... 350EXAMPLE 176 Creating a JMSDestination .................................................................................... 350EXAMPLE 177 ListingAll JMSResources ....................................................................................... 351EXAMPLE 178 Listing a JMSResources of a Specific Type ........................................................... 351EXAMPLE 179 Deleting a JMSResource ......................................................................................... 352EXAMPLE 1710 Creating a JMSPhysicalDestination .................................................................... 353EXAMPLE 1711 Listing JMSPhysicalDestinations ......................................................................... 353EXAMPLE 1712 FlushingMessages From a JMSPhysical Destination ......................................... 354EXAMPLE 1713 Deleting a PhysicalDestination ............................................................................. 355EXAMPLE 181 Creating aCustomResource .................................................................................. 390EXAMPLE 182 ListingCustomResources ...................................................................................... 391EXAMPLE 183 Updating aCustom JNDIResource ...................................................................... 391EXAMPLE 184 Deleting aCustomResource .................................................................................. 391EXAMPLE 185 Registering an External JNDIResource ................................................................ 392EXAMPLE 186 Listing JNDIResources ........................................................................................... 393EXAMPLE 187 Listing JNDIEntries ................................................................................................ 393EXAMPLE 188 Updating an External JNDIResource ................................................................... 394EXAMPLE 189 Deleting an External JNDIResource ..................................................................... 394EXAMPLE 191 Stopping theTransaction Service .......................................................................... 402EXAMPLE 192 Rolling Back aTransaction ..................................................................................... 403EXAMPLE 193 Restarting theTransaction Service ........................................................................ 403EXAMPLE 194 Manually RecoveringTransactions ....................................................................... 405

Examples


Preface

Oracle GlassFish Server 3.1 Administration Guide provides instructions for configuring andadministering Oracle GlassFish Server.

This preface contains information about and conventions for the entire Oracle GlassFish Server(GlassFish Server) documentation set.

GlassFish Server 3.1 is developed through the GlassFish project open-source community athttp://glassfish.java.net/. The GlassFish project provides a structured process fordeveloping the GlassFish Server platform that makes the new features of the Java EE platformavailable faster, while maintaining themost important feature of Java EE: compatibility. Itenables Java developers to access the GlassFish Server source code and to contribute to thedevelopment of the GlassFish Server. The GlassFish project is designed to encouragecommunication betweenOracle engineers and the community.

The following topics are addressed here:

GlassFish Server Documentation Set on page 25 Related Documentation on page 27 Typographic Conventions on page 28 Symbol Conventions on page 29 Default Paths and File Names on page 29 Documentation, Support, and Training on page 30 Searching Oracle Product Documentation on page 30 Third-PartyWeb Site References on page 31

GlassFish ServerDocumentation SetTheGlassFish Server documentation set describes deployment planning and systeminstallation. For an introduction to GlassFish Server, refer to the books in the order in whichthey are listed in the following table.

25

TABLE P1 Books in theGlassFish ServerDocumentation Set

BookTitle Description

Release Notes Provides late-breaking information about the software and thedocumentation and includes a comprehensive, table-based summary of thesupported hardware, operating system, Java Development Kit (JDK), anddatabase drivers.

Quick Start Guide Explains how to get started with the GlassFish Server product.

Installation Guide Explains how to install the software and its components.

Upgrade Guide Explains how to upgrade to the latest version of GlassFish Server. This guidealso describes differences between adjacent product releases andconfiguration options that can result in incompatibility with the productspecifications.

Deployment Planning Guide Explains how to build a production deployment of GlassFish Server thatmeets the requirements of your system and enterprise.

Administration Guide Explains how to configure, monitor, andmanage GlassFish Serversubsystems and components from the command line by using theasadmin(1M) utility. Instructions for performing these tasks from theAdministration Console are provided in the Administration Console onlinehelp.

Security Guide Provides instructions for configuring and administering GlassFish Serversecurity.

Application Deployment Guide Explains how to assemble and deploy applications to the GlassFish Serverand provides information about deployment descriptors.

Application Development Guide Explains how to create and implement Java Platform, Enterprise Edition(Java EE platform) applications that are intended to run on the GlassFishServer. These applications follow the open Java standardsmodel for Java EEcomponents and application programmer interfaces (APIs). This guideprovides information about developer tools, security, and debugging.

Add-On ComponentDevelopment Guide

Explains how to use published interfaces of GlassFish Server to developadd-on components for GlassFish Server. This document explains how toperform only those tasks that ensure that the add-on component is suitablefor GlassFish Server.

Embedded Server Guide Explains how to run applications in embeddedGlassFish Server and todevelop applications in which GlassFish Server is embedded.

High AvailabilityAdministration Guide

Explains how to configure GlassFish Server to provide higher availability andscalability through failover and load balancing.

Performance Tuning Guide Explains how to optimize the performance of GlassFish Server.

Preface


TABLE P1 Books in theGlassFish ServerDocumentation Set (Continued)BookTitle Description

Troubleshooting Guide Describes common problems that youmight encounter when usingGlassFish Server and explains how to solve them.

ErrorMessage Reference Describes errormessages that youmight encounter when using GlassFishServer.

ReferenceManual Provides reference information inman page format for GlassFish Serveradministration commands, utility commands, and related concepts.

Message Queue Release Notes Describes new features, compatibility issues, and existing bugs for GlassFishServerMessage Queue.

Message Queue TechnicalOverview

Provides an introduction to the technology, concepts, architecture,capabilities, and features of theMessage Queuemessaging service.

Message Queue AdministrationGuide

Explains how to set up andmanage aMessage Queuemessaging system.

Message Queue DevelopersGuide for JMXClients

Describes the application programming interface inMessage Queue forprogrammatically configuring andmonitoringMessage Queue resources inconformance with the JavaManagement Extensions (JMX).

Message Queue DevelopersGuide for Java Clients

Provides information about concepts and procedures for developing Javamessaging applications (Java clients) that work with GlassFish Server.

Message Queue DevelopersGuide for C Clients

Provides programming and reference information for developers workingwithMessage Queue whowant to use the C language binding to theMessageQueuemessaging service to send, receive, and processMessage Queuemessages.

RelatedDocumentationThe following tutorials explain how to develop Java EE applications:

Your First Cup: An Introduction to the Java EE Platform (http://download.oracle.com/javaee/6/firstcup/doc/). For beginning Java EE programmers, this short tutorialexplains the entire process for developing a simple enterprise application. The sampleapplication is a web application that consists of a component that is based on the EnterpriseJavaBeans specification, a JAX-RS web service, and a JavaServer Faces component for theweb front end.

The Java EE 6 Tutorial (http://download.oracle.com/javaee/6/tutorial/doc/). Thiscomprehensive tutorial explains how to use Java EE 6 platform technologies and APIs todevelop Java EE applications.

Preface

27

Javadoc tool reference documentation for packages that are provided with GlassFish Server isavailable as follows. The API specification for version 6 of Java EE is located at http://download.oracle.com/

javaee/6/api/. The API specification for GlassFish Server 3.1, including Java EE 6 platform packages and

nonplatform packages that are specific to the GlassFish Server product, is located athttp://glassfish.java.net/nonav/docs/v3/api/.

Additionally, the Java EE Specifications (http://www.oracle.com/technetwork/java/javaee/tech/index.html) might be useful.

For information about creating enterprise applications in the NetBeans IntegratedDevelopment Environment (IDE), see the NetBeans Documentation, Training & Support page(http://www.netbeans.org/kb/).

For information about the Java DB database for use with the GlassFish Server, see the Java DBproduct page (http://www.oracle.com/technetwork/java/javadb/overview/index.html).

The Java EE Samples project is a collection of sample applications that demonstrate a broadrange of Java EE technologies. The Java EE Samples are bundled with the Java EE SoftwareDevelopment Kit (SDK) and are also available from the Java EE Samples project page(http://java.net/projects/glassfish-samples).

Typographic ConventionsThe following table describes the typographic changes that are used in this book.

TABLE P2 TypographicConventions

Typeface Meaning Example

AaBbCc123 The names of commands, files, anddirectories, and onscreen computeroutput

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.

AaBbCc123 What you type, contrasted with onscreencomputer output

machine_name% su

Password:

AaBbCc123 Aplaceholder to be replaced with a realname or value

The command to remove a file is rm filename.

AaBbCc123 Book titles, new terms, and terms to beemphasized (note that some emphasizeditems appear bold online)

Read Chapter 6 in theUsers Guide.

A cache is a copy that is stored locally.

Do not save the file.

Preface

gfish

Documents