Documentation Home
> Oracle GlassFish Server 3.0.1 Administration Guide
Oracle GlassFish Server 3.0.1 Administration Guide
Book Information
Index
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Preface
Chapter 1 Overview of GlassFish Server Administration
Default Settings and Locations
Configuration Tasks
Initial Configuration Tasks
How Dotted Names Work for Configuration
Configuration Files
Impact of Configuration Changes
Configuration Changes That Require Server Restart
Dynamic Configuration Changes
Administration Tools
Administration Console
asadmin Utility
REST Interfaces
Update Tool
OSGi Module Management Subsystem
keytool Utility
Java Monitoring and Management Console (JConsole)
Application Server Management Extension (AMX)
Instructions for Administering GlassFish Server
Part I Runtime Administration
Chapter 2 General Administration
Using the asadmin Utility
Path to the asadmin Utility
asadmin Utility Syntax
Subcommands of the asadmin Utility
asadmin Utility Options and Subcommand Options
Operands of asadmin Utility Subcommands
To Run an asadmin Utility Subcommand in Single Mode
To Display Help Information for the asadmin Utility or a Subcommand
To Start a Multimode Session
To End a Multimode Session
To Run a Set of asadmin Subcommands From a File
Administering System Properties
To Create System Properties
To List System Properties
To Delete a System Property
Administering Resources
To Add Resources From an XML File
Listing Various System Elements
To Display the GlassFish Server Version
To List Applications
To List Containers
To List Modules
To List Subcommands
To List Timers
To Show Component Status
Using REST Interfaces to Administer GlassFish Server
Using REST URLs to Administer GlassFish Server
Using REST Resource Methods to Administer GlassFish Server
To Determine the Methods and Method Parameters That a Node in the Tree Supports
To Retrieve Data for a Node in the Tree
To Add a Node to the Tree
To Update a Node in the Tree
To Delete a Node From the Tree
Child Resources for Non-CRUD Operations
Securing GlassFish Server REST Interfaces
Formats for Resource Representation
JSON Resource Representation
JSON Representation of a Method in a Method List
JSON Representation of a Message Parameter or a Query Parameter
Example JSON Resource Representation
XML Resource Representation
XML Representation of a Resource Method
XML Representation of a Message Parameter or a Query Parameter
Example XML Resource Representation
HTML Resource Representation
Chapter 3 Administering Domains
About Administering Domains (or Servers)
Creating, Logging In To, and Deleting a Domain
To Create a Domain
To List Domains
To Log In to a Domain
To Delete a Domain
Starting and Stopping a Domain
To Start a Domain
To Stop a Domain
To Restart a Domain
Configuring a Domain for Automatic Restart
To Configure a Domain for Automatic Restart on Windows
To Configure a Domain for Automatic Restart on Oracle Solaris 10
To Restart Automatically on Linux
To Prevent Service Shutdown When a User Logs Out on Windows
Additional Domain Tasks
To Display Domain Uptime
To Switch a Domain to Another Supported Java Version
Chapter 4 Administering the Virtual Machine for the Java Platform
Administering JVM Options
To Create JVM Options
To List JVM Options
To Delete JVM Options
To Generate a JVM Report
Administering the Profiler
To Create a Profiler
To Delete a Profiler
Chapter 5 Administering Thread Pools
About Thread Pools
Configuring Thread Pools
To Create a Thread Pool
To List Thread Pools
To Update a Thread Pool
To Delete a Thread Pool
Chapter 6 Administering Web Applications
Invoking a Servlet by Alternate Means
Changing Log Output for a Servlet
Defining Global Features for Web Applications
To Use the default-web.xml File
Redirecting a URL
Administering mod_jk
To Enable mod_jk
To Load Balance Using mod_jk and GlassFish Server
To Enable SSL Between the mod_jk Load Balancer and the Browser
To Enable SSL Between the mod_jk Load Balancer and GlassFish Server
Chapter 7 Administering the Logging Service
About Logging
Log File
Logger Namespaces
Setting Log Levels
Setting Log Levels
To List the Logger Levels
To Set the Global Log Level
To Set Module Logger Levels
Rotating the Server Log
To Rotate a Log File Manually
Changing the Limit on the Number of Rotated Log Files
To Change the Limit on the Number of Rotated Log Files
Viewing Log Information
Chapter 8 Administering the Monitoring Service
About Monitoring
How the Monitoring Tree Structure Works
Tree Structure of Monitorable Objects
Applications Tree Hierarchy
Connector Service Tree Hierarchy
HTTP Service Tree Hierarchy
JMS/Container Service Tree Hierarchy
JRuby Tree Hierarchy
JVM Tree Hierarchy
Network Tree Hierarchy
ORB Tree Hierarchy
Resources Tree Hierarchy
Security Tree Hierarchy
Thread Pool Tree Hierarchy
Transactions Service Tree Hierarchy
Web Tree Hierarchy
About Monitoring for Add-on Components
Tools for Monitoring GlassFish Server
Configuring Monitoring
To Enable Monitoring
To Disable Monitoring
Viewing Common Monitoring Data
To View Common Monitoring Data
Common Monitoring Statistics
HTTP Listener Common Statistics
JVM Common Statistics
Web Module Common Statistics
Viewing Comprehensive Monitoring Data
Guidelines for Using the list and get Subcommands for Monitoring
To View Comprehensive Monitoring Data
Comprehensive Monitoring Statistics
EJB Statistics
EJB Cache Statistics
EJB Container Statistics
EJB Method Statistics
EJB Pool Statistics
Timer Statistics
HTTP Service Statistics
HTTP Service Virtual Server Statistics
Jersey Statistics
JMS/Connector Service Statistics
Connector Connection Pool Statistics (JMS)
Connector Work Management Statistics (JMS)
JRuby Statistics
JRuby Container Statistics
JRuby Runtime Statistics
JRuby HTTP Service Statistics
JVM Statistics
JVM Class Loading System Statistics
JVM Compilation System Statistics
JVM Garbage Collectors Statistics
JVM Memory Statistics
JVM Operating System Statistics
JVM Runtime Statistics
Network Statistics
Network Keep Alive Statistics
Network Connection Queue Statistics
Network File Cache Statistics
Network Thread Pool Statistics
ORB Statistics (Connection Manager)
Resource Statistics (Connection Pool)
Security Statistics
EJB Security Statistics
Web Security Statistics
Realm Security Statistics
Thread Pool Statistics
Thread Pool Monitoring Statistics
JVM Statistics for Java SE-Thread Information
Transaction Service Statistics
Web Statistics
Web Module Servlet Statistics
Web JSP Statistics
Web Request Statistics
Web Servlet Statistics
Web Session Statistics
Configuring JConsole to View GlassFish Server Monitoring Data
To Connect JConsole to GlassFish Server
Chapter 9 Administering Life Cycle Modules
About Life Cycle Modules
Configuring Life Cycle Modules
To Create a Life Cycle Module
To List Life Cycle Modules
To Update a Life Cycle Module
To Delete a Life Cycle Module
Chapter 10 Extending and Updating GlassFish Server
About Add-On Components
Preconfigured Repositories for GlassFish Server
Oracle GlassFish Server Repositories
GlassFish Server Open Source Edition Repositories
Tools for Extending and Updating GlassFish Server
Update Tool
The pkg Command
Administration Console
Adding Components
To Install an Add-on Component
Updating Installed Components
To Update an Installed Component
To Update All Installed Components in an Image
Removing Installed Components
To Uninstall an Installed Component
To Uninstall and Revert to an Older Version of a Component
Upgrading to Oracle GlassFish Server From GlassFish Server Open Source Edition
To Upgrade to Oracle GlassFish Server by Using Update Tool
To Upgrade to Oracle GlassFish Server by Using the pkg Command
Extending and Updating GlassFish Server Inside a Closed Network
To Install the Pre-Installed Toolkit Image Inside a Closed Network
To Configure a Local Repository Server Inside a Closed Network
To Configure a GlassFish Server Installation to Use a Local Repository Server Inside a Closed Network
To Install Updates From a Local Repository
Part II Security Administration
Chapter 11 Administering System Security
About System Security in GlassFish Server
Authentication
Authentication Types
Passwords
Master Password and Keystores
Administration Password
Encoded Passwords
Web Browsers and Password Storage
Password Aliases
Single Sign-on
Authorization
Roles
Java Authorization Contract for Containers
Auditing
Firewalls
Certificates and SSL
Certificates
Certificate Chains
Certificate Files
Secure Sockets Layer
Ciphers
Name-based Virtual Hosts
Tools for Managing System Security
Administering Passwords
To Change the Master Password
To Change the Administration Password
To Set a Password From a File
Administering Password Aliases
To Create a Password Alias
To List Password Aliases
To Delete a Password Alias
To Update a Password Alias
Administering Audit Modules
To Create an Audit Module
To List Audit Modules
To Delete an Audit Module
Administering JSSE Certificates
To Generate a Certificate by Using keytool
To Sign a Certificate by Using keytool
To Delete a Certificate by Using keytool
Chapter 12 Administering User Security
Administering Authentication Realms
Overview of Authentication Realms
To Create an Authentication Realm
To List Authentication Realms
To Update an Authentication Realm
To Delete an Authentication Realm
To Configure a JDBC or Digest Authentication Realm
To Configure LDAP Authentication with OID and OVD
To Enable LDAP Authentication on the GlassFish Server DAS
Administering File Users
To Create a File User
To List File Users
To List File Groups
To Update a File User
To Delete a File User
Chapter 13 Administering Message Security
About Message Security in GlassFish Server
Security Tokens and Security Mechanisms
Authentication Providers
Message Protection Policies
Application-Specific Web Services Security
Message Security Administration
Message Security Tasks
Message Security Roles
System Administrator
Application Deployer
Application Developer/Assembler
Sample Application for Web Services
Enabling Default Message Security Providers for Web Services
To Enable a Default Server Provider
To Enable a Default Client Provider
Configuring Message Protection Policies
Message Protection Policy Mapping
To Configure the Message Protection Policies for a Provider
Setting the Request and Response Policy for the Application Client Configuration
Administering Non-default Message Security Providers
To Create a Message Security Provider
To List Message Security Providers
To Update a Message Security Provider
To Delete a Message Security Provider
Enabling Message Security for Application Clients
Additional Information About Message Security
Part III Resources and Services Administration
Chapter 14 Administering Database Connectivity
About Database Connectivity
Setting Up the Database
To Install the Database and Database Driver
To Start the Database
To Stop the Database
Java DB Utility Scripts
To Configure Your Environment to Run Java DB Utility Scripts
Configuring Access to the Database
Administering JDBC Connection Pools
To Create a JDBC Connection Pool
To List JDBC Connection Pools
To Contact (Ping) a Connection Pool
To Reset (Flush) a Connection Pool
To Update a JDBC Connection Pool
To Delete a JDBC Connection Pool
Administering JDBC Resources
To Create a JDBC Resource
To List JDBC Resources
To Update a JDBC Resource
To Delete a JDBC Resource
Integrating the JDBC Driver
Configuration Specifics for JDBC Drivers
JDBC Drivers, Full Support
IBM DB2 Database Type 2 DataDirect JDBC Driver
IBM DB2 Database Type 2 JDBC Driver
Java DB/Derby Type 4 JDBC Driver
Microsoft SQL Server Database Type 4 DataDirect JDBC Driver
MySQL Server Database Type 4 DataDirect JDBC Driver
MySQL Server Database Type 4 JDBC Driver
Oracle 11 Database DataDirect JDBC Driver
Oracle OCI Type 2 Driver for Oracle Databases
Oracle 11 Database Thin Type 4 JDBC Driver
PostgreSQL Type 4 JDBC Driver
Sybase Database Type 4 DataDirect JDBC Driver
JDBC Drivers, Limited Support
IBM Informix Type 4 Driver for DataDirect
Inet Oraxo JDBC Driver for Oracle Databases
Inet Merlia JDBC Driver for Microsoft SQL Server Databases
Inet Sybelux JDBC Driver for Sybase Databases
JConnect Type 4 Driver for Sybase ASE 12.5 Databases
Chapter 15 Administering EIS Connectivity
About EIS Connectivity
Administering Connector Connection Pools
To Create a Connector Connection Pool
To List Connector Connection Pools
To Connect to (Ping) or Reset (Flush) a Connector Connection Pool
To Update a Connector Connection Pool
To Delete a Connector Connection Pool
Administering Connector Resources
To Create a Connector Resource
To List Connector Resources
To Update a Connector Resource
To Delete a Connector Resource
Administering the Resource Adapter Configuration
To Create Configuration Information for a Resource Adapter
To List Resource Adapter Configurations
To Update a Resource Adapter Configuration
To Delete a Resource Adapter Configuration
Administering Connector Security Maps
To Create a Connector Security Map
To List Connector Security Maps
To Update a Connector Security Map
To Delete a Connector Security Map
Administering Connector Work Security Maps
To Create a Connector Work Security Map
To List Connector Work Security Maps
To Update a Connector Work Security Map
To Delete a Connector Work Security Map
Administering Administered Objects
To Create an Administered Object
To List Administered Objects
To Update an Administered Object
To Delete an Administered Object
Chapter 16 Administering Internet Connectivity
About Internet Connectivity
About HTTP Network Listeners
About Virtual Servers
Administering HTTP Network Listeners
To Create an Internet Connection
Administering HTTP Protocols
To Create a Protocol
To List Protocols
To Delete a Protocol
Administering HTTP Configurations
To Create an HTTP Configuration
To Delete an HTTP Configuration
Administering HTTP Transports
To Create a Transport
To List Transports
To Delete a Transport
Administering HTTP Network Listeners
To Create an HTTP Network Listener
To List HTTP Network Listeners
To Update an HTTP Network Listener
To Delete an HTTP Network Listener
To Configure an HTTP Listener for SSL
To Delete SSL From an HTTP Listener
To Assign a Default Virtual Server to an HTTP Listener
Administering Virtual Servers
To Create a Virtual Server
To List Virtual Servers
To Update a Virtual Server
To Delete a Virtual Server
To Assign a Default Web Module to a Virtual Server
To Assign a Virtual Server to an Application or Module
Chapter 17 Administering the Object Request Broker (ORB)
About the ORB
Configuring the ORB
Administering IIOP Listeners
To Create an IIOP Listener
To List IIOP Listeners
To Update an IIOP Listener
To Delete an IIOP Listener
Chapter 18 Administering the JavaMail Service
About JavaMail
Administering JavaMail Resources
To Create a JavaMail Resource
To List JavaMail Resources
To Update a JavaMail Resource
To Delete a JavaMail Resource
Chapter 19 Administering the Java Message Service (JMS)
About the JMS
Message Queue Broker Modes
Administering JMS Physical Destinations
To Create a JMS Physical Destination
To List JMS Physical Destinations
To Purge Messages From a Physical Destination
To Delete a JMS Physical Destination
Administering JMS Connection Factories and Destinations
To Create a Connection Factory or Destination Resource
To List JMS Resources
To Delete a Connection Factory or Destination Resource
Administering JMS Hosts
To Create a JMS Host
To List JMS Hosts
To Update a JMS Host
To Delete a JMS Host
Administering Connection Addressing
Setting JMS Connection Pooling
Accessing Remote Servers
Configuring Resource Adapters for JMS
To Configure the Generic Resource Adapter
Troubleshooting JMS
Chapter 20 Administering the Java Naming and Directory Interface (JNDI) Service
About JNDI
Java EE Naming Environment
How the Naming Environment and the Container Work Together
Naming References and Binding Information
Administering JNDI Resources
Administering Custom JNDI Resources
To Create a Custom JNDI Resource
To List Custom JNDI Resources
To Update a Custom JNDI Resource
To Delete a Custom JNDI Resource
Administering External JNDI Resources
To Register an External JNDI Resource
To List External JNDI Resources
To List External JNDI Entries
To Update an External JNDI Resource
To Delete an External JNDI Resource
Example of Using an External JNDI Resource
Chapter 21 Administering Transactions
About Transactions
Managing the Transaction Service
To Stop the Transaction Service
To Roll Back a Transaction
To Restart the Transaction Service
Recovering Transactions
To Manually Recover Transactions
Part IV Appendixes
Appendix A Subcommands for the asadmin Utility
General Administration Subcommands
Connectivity Subcommands
Domain Subcommands
Internet Connectivity Subcommands
JavaMail Subcommands
JMS Subcommands
JNDI Subcommands
JVM Subcommands
Life Cycle Module Subcommands
Logging and Monitoring Subcommands
ORB Subcommands
Security Subcommands
Thread Pool Subcommands
Transaction Service Subcommands
User Management Subcommands
© 2010, Oracle Corporation and/or its affiliates