User ManualTable of ContentsSun GlassFish Enterprise Server 2.1 Administration Guide1Preface19Sun GlassFish Enterprise Server Documentation Set19Default Paths and File Names20Typographic Conventions21Symbol Conventions21Documentation, Support, and Training22Third-Party Web Site References22Sun Welcomes Your Comments22Enterprise Server Overview23Enterprise Server Overview and Concepts23Enterprise Server Overview23Tools for Administration24Admin Console24Command-line Interface (asadmin Utility)25JConsole25Enterprise Server Concepts26Domain26Domain Administration Server (DAS)26Usage Profiles27Cluster28Node Agent28Server Instance29Ports in the Enterprise Server30Basic Enterprise Server Commands31Creating a Domain31Deleting a Domain32Listing Domains32Starting the Domain32Starting the Default Domain on Windows33Stopping the Domain33Stopping the Default Domain on Windows33Restarting the Domain33Creating a Cluster33Starting a Cluster34Stopping a Cluster34Creating a Node Agent34Starting a Node Agent34Stopping a Node Agent35Starting an Instance35Stopping an Instance35Restarting an Instance35Recreating the Domain Administration Server36To migrate the DAS36Java Business Integration39JBI Environment39JBI Components39Service Engines39Binding Components40JBI Component Loggers40Service Assemblies41Shared Libraries42JBI Descriptors42JDBC Resources43JDBC Resources43JDBC Connection Pools44How JDBC Resources and Connection Pools Work Together44Setting Up Database Access45Working with JDBC Connection Pools46Creating a JDBC Connection Pool46Creating a JDBC Connection Pool and JDBC Resource Using the Admin Console46Creating a JDBC Connection Pool and JDBC Resource Using the CLI47Editing a JDBC Connection Pool48Editing JDBC Connection Pool Advanced Attributes50Configurations for Specific JDBC Drivers52Java DB Type 4 Driver53Sun GlassFish JDBC Driver for DB2 Databases54Sun GlassFish JDBC Driver for Oracle 8.1.7 and 9.x Databases54Sun GlassFish JDBC Driver for Microsoft SQL Server Databases55Sun GlassFish JDBC Driver for Sybase Databases55IBM DB2 8.1 Type 2 Driver56JConnect Type 4 Driver for Sybase ASE 12.5 Databases56MySQL Type 4 Driver57Inet Oraxo JDBC Driver for Oracle 8.1.7 and 9.x Databases57Inet Merlia JDBC Driver for Microsoft SQL Server Databases58Inet Sybelux JDBC Driver for Sybase Databases59Oracle Thin Type 4 Driver for Oracle 8.1.7 and 9.x Databases59OCI Oracle Type 2 Driver for Oracle 8.1.7 and 9.x Databases60IBM Informix Type 4 Driver61CloudScape 5.1 Type 4 Driver61Configuring Java Message Service Resources63JMS Resources63The Relationship Between JMS Resources and Connector Resources64JMS Connection Factories65JMS Destination Resources65JMS Physical Destinations65Configuring JMS Provider Properties66Accessing Remote Servers67Foreign JMS Providers67Configuring the Generic Resource Adapter for JMS67Configuring the Generic Resource Adapter68Resource Adapter Properties68ManagedConnectionFactory Properties71Administered Object Resource Properties72Activation Spec Properties72Configuring JavaMail Resources75Creating a JavaMail Session75JNDI Resources77Java EE Naming Services77Naming References and Binding Information78Using Custom Resources79Using External JNDI Repositories and Resources79Connector Resources81An Overview of Connectors81Managing Connector Connection Pools82To Create a Connector Connection Pool82To Edit a Connector Connection Pool83To Edit Connector Connection Pool Advanced Attributes85To Edit Connection Pool Properties87Managing Security Maps87To create security maps for connector connection pools87To Edit Security Maps for Connector Connection Pools87To Delete a Connector Connection Pool87To Set Up EIS Access88Managing Connector Resources88To Create a Connector Resource88To Edit a Connector Resource89To Delete a Connector Resource89To Configure the Connector Service90Managing Administered Object Resources90To Create an Administered Object Resource91To Edit an Administered Object Resource92To Delete an Administered Object Resource92Web and EJB Containers93The SIP Servlet Container93Editing the Properties of the SIP Container94Editing SIP Container General Attributes94Editing SIP Container Session Properties94Editing SIP Container Session Manager Properties95The Web Container95The EJB Container95Configuring Security97Understanding Application and System Security97Tools for Managing Security98Managing Security of Passwords99Encrypting a Password in the domain.xml File99Protecting Files with Encoded Passwords100Changing the Master Password100Working with the Master Password and Keystores101Changing the Admin Password101About Authentication and Authorization102Authenticating Entities102Verifying Single Sign-On103Authorizing Users103Specifying JACC Providers103Auditing Authentication and Authorization Decisions103Configuring Message Security104Understanding Users, Groups, Roles, and Realms104Users105Groups105Roles106Realms106To Configure a JDBC Realm for a Web, EJB Application107Introduction to Certificates and SSL108About Digital Certificates108About Certificate Chains109About Secure Sockets Layer109About Ciphers110Using Name-based Virtual Hosts110About Firewalls111About Certificate Files111Changing the Location of Certificate Files112Using Java Secure Socket Extension (JSSE) Tools112Using the keytool Utility112Generating a Certificate Using the keytool Utility114Signing a Digital Certificate Using the keytool Utility115Deleting a Certificate Using the keytool Utility115Using Network Security Services (NSS) Tools116Using the certutil Utility117Importing and Exporting Certificates Using the pk12util Utility118Adding and Deleting PKCS11 Modules using modutil119Using Hardware Crypto Accelerator With Enterprise Server120About Configuring Hardware Crypto Accelerators120Configuring PKCS#11 Tokens121Managing Keys And Certificates122Listing Keys and Certificates123Working With Private Keys and Certificates124Configuring J2SE 5.0 PKCS#11 Providers124Configuring Message Security127Overview of Message Security127Understanding Message Security in the Enterprise Server128Assigning Message Security Responsibilities128System Administrator128Application Deployer129Application Developer129About Security Tokens and Security Mechanisms129About Username Tokens129About Digital Signatures130About Encryption130About Message Protection Policies130Glossary of Message Security Terminology131Securing a Web Service132Configuring Application-Specific Web Services Security133Securing the Sample Application133Configuring the Enterprise Server for Message Security133Actions of Request and Response Policy Configurations134Configuring Other Security Facilities135After You Finish135Configuring a JCE Provider135Message Security Setup137Enabling Providers for Message Security137Configuring the Message Security Provider138Creating a Message Security Provider139Enabling Message Security for Application Clients139Setting the Request and Response Policy for the Application Client Configuration139Further Information140Configuring the Diagnostic Service141What is the Diagnostic Framework?141Diagnostic Service Framework141Generating a Diagnostic Report142Transactions143About Transactions143What is a Transaction?143Transactions in Java EE Technology144Workarounds for Specific Databases145Admin Console Tasks for Transactions145Configuring Transactions145To configure how the Enterprise Server recovers from transactions145To set a transaction timeout value146To set the location of the transaction logs147To set the keypoint interval148Configuring the HTTP Service149Virtual Servers149HTTP Listeners150Managing Web Services153Overview of Web Services153Web Services Standards154Java EE Web Service Standards154Deploying and Testing Web Services155Deploying Web Services155Viewing Deployed Web Services156Testing Web Services156Web Services Security156Using Web Services Registries156Adding a Registry157Publishing a Web Service to a Registry157Transforming Messages with XSLT Filters158Monitoring Web Services158Viewing Web Service Statistics159Monitoring Web Service Messages159Configuring the Object Request Broker161An Overview of the Object Request Broker161CORBA161What is the ORB?162IIOP Listeners162Configuring the ORB162Managing IIOP Listeners162Thread Pools163Working with Thread Pools164Configuring Logging165About Logging165Log Records165The Logger Namespace Hierarchy166Configuring Logging168Configuring General Logging Settings168Configuring Log Levels168Viewing Server Logs169Monitoring Components and Services171About Monitoring171Monitoring in the Enterprise Server171Overview of Monitoring172About the Tree Structure of Monitorable Objects172The Applications Tree172The HTTP Service Tree173The Resources Tree174The Connector Service Tree174The JMS Service Tree174The ORB Tree175The Thread Pool Tree175About Statistics for Monitored Components and Services175EJB Container Statistics176Web Container Statistics180HTTP Service Statistics181JDBC Connection Pools Statistics182JMS/Connector Service Statistics184Statistics for Connection Managers in an ORB185Thread Pools Statistics186Transaction Service Statistics186Java Virtual Machine (JVM) Statistics187JVM Statistics in Java SE187Enabling and Disabling Monitoring191Configuring Monitoring Levels Using the Admin Console192To Configure Monitoring Levels Using asadmin192Viewing Monitoring Data193Viewing Monitoring Data in the Admin Console193Viewing Monitoring Data With the asadmin Tool193To Use the asadmin monitor Command to View Monitoring Data193To Use the asadmin get and list Commands to View Monitoring Data194Understanding and Specifying Dotted Names195Examples of the list and get Commands196Examples for the list --user admin-user --monitor Command197Example 1197Example 2197Examples for the get --user admin-user --monitor Command197Example 1198Example 2198Example 3199Example 4199To Use the PetStore Example199Expected Output for list and get Commands at All Levels202Using JConsole209Securing JConsole to Application Server Connection210Prerequisites for Connecting JConsole to Application Server211Connecting JConsole to Application Server211Connecting JConsole Securely to Application Server212Configuring Management Rules215About Management Rules215Configuring Management Rules216Java Virtual Machine and Advanced Settings219Tuning the JVM Settings219Configuring Advanced Settings220Automatically Restarting a Domain or Node Agent221Restarting Automatically on Solaris 10221Restarting Automatically Using inittab on Solaris 9 and Linux Platforms223Restarting Automatically on the Microsoft Windows Platform223Creating a Windows Service223Preventing the Service From Shutting Down When a User Logs Out225Security for Automatic Restarts225Dotted Name Attributes for domain.xml227Top Level Elements227Elements Not Aliased229The asadmin Utility231The asadmin Utility232Common Options for Remote Commands234The Multimode Command235The Get, Set, and List Commands236Server Lifecycle Commands237List and Status Commands238Deployment Commands239Version Commands240Message Queue Administration Commands240Resource Management Commands241Configuration Commands243HTTP and IIOP Listener Commands243Lifecycle and Audit Module Commands243Profiler and SSL Commands244JVM Options and Virtual Server Commands244Threadpool and Auth-Realm Commands245Transaction and Timer Commands245Registry Commands246User Management Commands246Rules and Monitoring Commands247Database Commands247Diagnostic and Logging Commands248Web Service Commands248Security Service Commands249Password Commands250Verify Command251Custom MBean Commands251Service Command251Property Command252Index253Size: 1.53 MBPages: 256Language: EnglishOpen manual