Contents

Title and Copyright Information

Preface

• GlassFish Server Documentation Set
• Related Documentation
• Typographic Conventions
• Symbol Conventions
• Default Paths and File Names
• Documentation, Support, and Training
• Searching Oracle Product Documentation
• Documentation Accessibility

1 Oracle GlassFish Server 3.1.2 and 3.1.2.2 Release Notes

• Revision History
• What's New in the GlassFish Server 3.1.2.2 Release?
• What's New in the GlassFish Server 3.1.2 Release?
  • Environment and Component Changes
  • Administration Console Enhancements
  • Simplified Set Up of Windows Systems for Centralized Administration of Remote Instances
  • mod_proxy_ajp Support
  • GMS Without Multicast Support
  • TopLink and MOXy Support
  • Transaction Recovery from a Database
  • New Thread Pool Properties
  • New Library Management Commands
  • Updated OSGi Module Management Subsystem
  • GlassFish Server Samples for NetBeans
• Hardware and Software Requirements
  • Supported Platforms, JDK Versions, Browsers, mod_jk, and JDBC Drivers and Databases
  • System Virtualization Support
  • Required Disk Space
  • Required Free Ports
    • To Configure Specific Ports for a JMS Host
    • To Configure Specific GMS Ports for a Cluster
  • Message Queue Broker Requirements
  • Important Patch Information
  • Paths and Environment Settings for the JDK Software
    • Use the Correct Java Version
    • Use the JDK Binaries
    • Set the JAVA_HOME Environment Variable
    • Set Other Environment Variables As Necessary
• Known Issues in GlassFish Server 3.1.2
  • restart-instance takes a long time on Solaris 11 (sun.security.pkcs11.SunPKCS11) (15537)
    • Description
    • Workaround
  • Accept multiple certs for admin authentication (16437)
    • Description
    • Workaround
  • tcp-no-delay attribute in Http is not working (16902)
    • Description
    • Workaround
  • Invoking GF installer on AIX 6.1 with JDK6 64 bit gives Warning (16667)
    • Description
    • Workaround
  • (JDK) NLS: Crashed when tried to install the bundle in ko locale (16699)
    • Description
    • Workaround
  • PKG_CLIENT_READ_TIMEOUT is too small (16999)
    • Description
    • Workaround
  • cannot remote deploy large wars (15773)
    • Description
    • Workaround
  • Fail to install the bundle named with -jdk7 when unset JAVA_HOME in solaris 11 Express x86 (16698)
    • Description
    • Workaround
  • asadmin timeout from HA short execution on AIX (16960)
    • Description
    • Workaround
  • domain.xml encoding can cause upgrade problems and startup failure with certain locale changes (16304, 16700)
    • Description
    • Workaround
  • Unable to restart Embedded GlassFish Server instance once a remote EJB is deployed (16916)
    • Description
    • Workaround
  • EJB Timer Service is not loaded correctly after Embedded GlassFish Server restart (16230)
    • Description
    • Workaround
  • Stopping Embedded GlassFish Server leaves several daemon threads running (11088)
    • Description
    • Workaround
  • [OWSM] Interop Metro-WLS:NPE WSSECURTIYTOKEN NULL for WSSE:SECURITYTOKENREFERENCE (Issue 9716247)
    • Description
    • Workaround
  • [JDK_Issue] Performance degradation caused by invoking setSoLinger or setReuseAddress (Issue 7109)
    • Description
    • Workaround
  • [JDK_Issue] IO exception: invalid argument during longevity test (Issue 7529)
    • Description
    • Workaround
  • File permissions on domain /applications directory can cause NullProcessException (Issue 6545)
    • Description
    • Workaround
  • Issues occur with ZIP distribution if UAC enabled on Windows 7 and Vista (Issue 10755)
    • Description
    • Workaround
  • [Open Installer] Option -l to relocate log files ignored on Windows (Issue 10693)
    • Description
    • Workaround
  • [Open Installer] Start menus not displayed and then empty on Windows Vista (Issue 5087)
    • Description
    • Workaround
  • Standalone Update Tool fails with segmentation fault on Solaris (Issue 11222)
    • Description
    • Workaround
  • Java EE 6 Managed Bean support not available in app clients launched using Java Web Start (Issue 11257)
    • Description
    • Workaround
  • Warning messages when invoking appclient script on Mac OS X with Apple Java implementation (Issue 8644)
    • Description
    • Workaround
  • Unable to open installation log files using links on the Summary screen on Linux and Mac OS (Issue 6621)
    • Description
    • Workaround
  • updatetool command does not work if you reinstall into the same install directory on Windows (Issue 8233)
    • Description
    • Workaround
  • Problems debugging JPA (Issue 11274)
    • Description
    • Workaround
  • There doesn't appear to be any explanation about the classpath-prefix and classpath-suffix in the GF 3.x documentation (Issue 16082)
    • Description
    • Workaround
  • Windows startup menu shows single entry on multiple installation of Glassfish 3.1 (7002744)
    • Description
    • Workaround
  • New Grizzly integration required for http://java.net/jira/browse/GRIZZLY-970 (15909)
    • Description
    • Workaround
  • ReleaseNotes: document Restart Required issues (Umbrella issue 16040)
    • Description
    • Workaround
  • [UB]org.osgi.framework.BundleException during shutdown after upgrade (15441)
    • Description
    • Workaround
  • Update coordinates failure with enable-security-admin (7017384)
    • Description
    • Workaround
  • Man page for list-supported-cipher-suites (15998)
    • Description
    • Workaround
  • Description of create-jacc-provider references JSR196 but the command has nothing to do with JSR196 and JAAS (15999)
    • Description
    • Workaround
  • lazy-init attribute missing from admin console Edit IIOP Listener page (15975)
    • Description
    • Workaround
  • RMIConnectorStarter constructs invalid URLs with a literal IPv6 address (15937)
    • Description
    • Workaround
  • man-page-review umbrella issue (15929)
    • Description
    • Workaround
  • [UB]Release note security permissions required for CDI applications (15456)
    • Description
    • Workaround
  • build 40 : list-jmsdest for cluster1 not working, it just hangs
    • Description
    • Workaround
  • Create Resource Adapter Config is throwing an exception if JMS is already started (15571)
    • Description
    • Workaround
  • [Release Note]Samples. at ant all output was seen URL for samples that don't have a web client (12264)
    • Description
    • Workaround
  • Domain.xml: setting protocol.http-listener-1.http.max-connections set in 1 or -1 (16025)
    • Description
    • Workaround
  • Intermittent issue: Left tree not refreshed when new elements are added/removed in IE and firefox (15997)
    • Description
    • Workaround
  • [UB][regression] jpaRLCreateEMF failure on sybase (15763)
    • Description
    • Workaround
  • Admin Console: intermittent Blank Screen (15633)
    • Description
    • Workaround
  • Caching JMS session in a session bean causes errors when invoked by a MDB when under load (15558)
    • Description
    • Workaround
  • Domain fails to stop after console loaded (with secure admin enabled) (15482)
    • Description
    • Workaround
  • Modifying keyfile path in a newly created config does not properly list the users (15429)
    • Description
    • Workaround
  • [BigApps] [STRESS] ~17 occurrences of "EOFException" warnings coming from JMS (15424)
    • Description
    • Workaround
  • Mysql ping fails when additional properties are not deleted (14547)
    • Description
    • Workaround
  • If TS resource had been changed, tables are not created after server restart (13873)
    • Description
    • Workaround
  • GlassFish/Grizzly not able to accept new request if a remote client hangs (6963818)
    • Description
    • Workaround
  • restore-domain from a config only backup will corrupt the domain directory (7026114)
    • Description
    • Workaround
  • JSF PhaseListener executed for each virtual host (15809)
    • Description
    • Workaround
  • could not find Factory: javax.faces.context.FacesContextFactory (16061)
    • Description
    • Workaround
  • GlassFish installer needs to prompt user to set MQ admin password (12305750)
    • Description
    • Workaround
  • App client cannot find EJB behind NAT (17147) and EJB remote deployed on GF behind a NAT inaccessible (17151)
    • Description
    • Workaround
  • asadmin update-node-ssh command hangs when SSH port is not provided (18185)
    • Description
    • Workaround
  • QL bean-validator/simple-bv-servlet test failed in security_manager ON mode (17288)
    • Description
    • Workaround
  • Virtual network interfaces introduced by virtualization systems regress Glassfish 3.1.2 GMS auto selection of an appropriate network interface to use (18024)
    • Description
    • Workaround
  • Require username/password to access admin console locally (18063)
    • Description
    • Workaround
  • Failure to replicate sessions larger than 64kB with only one active clustered instance (18085)
    • Description
    • Workaround
  • [JRockit-intermittent] Observed 100% CPU usage & deploy taking > 5 minutes when running the Coherence HA tests (18222)
    • Description
    • Workaround
  • IE9 and Google Chrome only: Export a LB config xml not working properly (18281)
    • Description
    • Workaround
  • AccessControlException in Coherence*Web Test with Security Manager On (13614812)
    • Description
    • Workaround
  • Traffic loss during instance start between the time 8080 is up and application is loaded (18267)
    • Description
    • Workaround
  • Repeated Deploy & Undeploy of a Coherence 3.7.1 enabled application causes an OutOfMemory (PermGen space) error (18309)
    • Description
    • Workaround
  • JMS Connection Factories tree node should not include JMS Destination Resources (18314)
    • Description
    • Workaround
  • Install silent option does not store admin password input (18318)
    • Description
    • Workaround
  • Appclient appending an extra $ and \r for arguments passed (18332)
    • Description
    • Workaround
  • Custom installation crashes when "Configure an existing installation" selected (17269)
    • Description
    • Workaround
  • SocketException While Starting Cluster with Coherence on AIX (13704617)
    • Description
    • Workaround
  • Unable to set a value on the lb config's rewrite-location property when using jdk 1.7.0_03 (18368)
    • Description
    • Workaround
  • Plain file in INSTALL_ROOT causes install-node to fail (18645)
    • Description
    • Workaround
  • Incorrect Maximum Allowed Value for the --multicastport Option in the create-cluster(1) and validate-multicast(1) Help Pages
  • Disabling Group Search in LDAP User Name Search
    • Description
    • Workaround
  • ORB Tuning: Limiting the Maximum Number of Client Connections
  • Chunking Support Added to GlassFish Load Balancer Plug-In
  • Documentation Missing for Disabling JReplica Cookies
  • Incorrect Closed Network Patch Numbers Listed in the GlassFish Server 3.1.x Documentation
  • Error in the Instructions for Upgrading from GlassFish Server 3.1 or 3.1.1 to 3.1.2
  • Upgrade Fails from GlassFish Server 3.1.2.2 to 3.1.2.3
    • Description
    • Workaround
  • Patch Upgrade for GlassFish Server 3.1.2
  • Misleading Documentation for the Auto Apply Feature of the Load Balancer Plug-In
  • Errors and Omissions in the configure-ldap-for-admin Help Page
  • Service for the DAS or a GlassFish Server Instance Does Not Start
  • Master Password and Truststore Password Must be the Same
    • Description
    • Workaround
  • Documentation Incorrect for Setting Up Transaction Recovery
  • Expired Root CA for CN=GTE CyberTrust Root 5, OU=GTE CyberTrust Solutions, Inc.
    • Description
    • Workaround
    • To Delete the GTE CyberTrust Root 5 Certificate From The Truststore
  • Documentation Incorrect for Default Keypoint Interval Value
  • Addition of Capability to Process JDBC Resource Properties Configuration
  • System Property Added For IIOP/SSL Connections
  • Changes to JDK 1.7.0_51's java.policy File
  • IPS Online Upgrade No Longer Available
    • Description
    • Workaround
  • Error Related to Secure Admin Setup Occurs When Upgrading GlassFish Server
    • Description
    • Workaround
  • Use Latest JDK Versions with GlassFish Server 3.1.2.11
• Restrictions and Deprecated Functionality
  • Node Agent Support
  • HADB and hadbm Command Support
  • asadmin Subcommands
  • Deprecated, Unsupported, and Obsolete Options
  • Applications That Use Java DB
  • No Support for Client VM on Windows AMD64
  • Metro Reliable Messaging in InOrder Delivery Mode
  • No Support for Kerberos on AIX
  • Persistence of EJB References in HTTP Sessions Not Supported for Coherence*Web
• Features Available Only in the Full Platform Profile
• Java EE 6 Standards Support
• Java EE 6 SDK
• How to Report Problems and Provide Feedback
• Additional Resources