2. About Sun GlassFish Enterprise Server
3. Known Issues and Limitations
Enterprise Server does not detect conflicts with the heartbeat port of a cluster (Issue number 1967)
Domain creation stops on NFS server running 64-bit Linux (Issue Number 1961)
Performance degradation seen when a huge log file is rotated (6718611)
Failed to Deploy Generic RA Resource Adapter against IBM MQ (Issue 6605)
Standalone instances sometimes obtain files from other instances (6698604)
Startup Message from the start-cluster command are too verbose (6728317)
Failed to Deploy Generic RA Resource Adapter against IBM MQ (Issue 6605)
The package-appclient script does not work if domain1 is not present (6171458)
Starting the Server with additional JMX Agent is not supported (6200011)
.asadmintruststore file not described in the Enterprise Server documentation (6315957)
Clustered instances fail to start due to a timeout in reaching the JMS broker (6523663)
Cannot display jmaki chart in Netscape 8.1.3, Mozilla 1.7 and Safari 2.0.4 browsers (6543014)
Default ports changing in each AS major release (6566481)
The create-domain command fails with custom master password in AIX (6628170)
Solution: (AIX) To Create a Domain With a Custom Master Password
AIX: 0403-027 The parameter list is too long (6625591)
(AIX) To Increase the Maximum Length of the Command Line
Apache and Load Balancer Plugin
SGES 2.1.1 Patch 2 LB plugin on WS7u8 crashes the web server on SUSE Linux 10 SP2 (6928066)
Must start Apache Web Server as root (6308021)
Library JAR packaged in Application Client Archive overwrites MANIFEST file (6193556)
ACC always tries to connect to localhost:3700 (6527987)
Unable to start domain , missing sunpkcs11.jar (6571044)
PreparedStatement errors (6170432)
Java DB is not started after machine reboot or server start (6515124)
Autodeployment fails on a cluster sometimes (6610527)
Bundled ANT throws java.lang.NoClassDefFoundError (6265624)
Application specific classloader not used by JSP compilation (6693246)
Javadoc Inconsistencies (various IDs)
GlassFish 2.x documentation referring to invalid create-session-store command (6935976)
HTTP Service Statistics attributes discrepancies (7018903)
Glassfish GFv2 Mod_JK AJP listens to all interfaces (7008190)
[UB]The *Global Transaction support box* is nowhere to be found (7536)
Misleading Documentation for Configuring JMS Physical Destinations
Upgrade Procedure is Confusing
Resouce Injection does not work in HandlerChain (6750245)
HADB Configuration with Double Networks (no ID)
HADB Database Creation Fails (no ID)
hadbm set does not check resource availability (disk and memory space) (5091280)
Heterogeneous paths for packagepath not supported (5091349)
hadbm createdomain may fail (6173886, 6253132)
Starting, stopping, and reconfiguring HADB may fail or hang (6230792, 6230415)
The management agent terminates with the exception "IPV6_MULTICAST_IF failed" (6232140)
clu_trans_srv cannot be interrupted (6249685)
hadbm does not support passwords containing capital letters (6262824)
Install/removal and symlink preservation (6271063)
Management agents in global and local zones may interfere (6273681)
Non-root users cannot manage HADB (6275319)
The Management Agent should not use special-use interfaces (6293912)
Reassembly failures on Windows (6291562)
Session state not maintained if the browser has another cookie with / path (6553415)
LB does not work with IIS 6; SASL32.DLL and ZLIB.DLL missing under as-install/lib (6572184)
DAS creation/startup and HA package propagation issues in Global Zone (6573511)
Enable/disable LB for an instance/cluster should show correct status (6595113)
Installer decoration image shows old product version (6862674)
The start-domain Command Times Out on OpenSolaris 2008.11 (6820169 and 6741572)
Enterprise profile installation is not supported with a 64-bit JVM on a 64-bit platform (6977626)
Installation with 64-bit JDK Fails (6796171)
Enterprise Server installer crashes on Linux (6739013)
Installation shutdown hanging on some Linux systems after clicking the "Finish" button (5009728)
On Windows, the imq directory needs to be created during installation (6199697)
IFR. Was not able to install AS in the sparse local zone, MQ packages issue. (6555578)
After upgrade, the following exceptions are seen in the log when a domain is started. (6774663)
TopLink expects my Collection field/property to be cloneable (Issue Tracker 556)
GenerationType.IDENTITY and DataDirect Driver with SyBase (Issue Tracker 2431)
Setting ejb-timer-service property causes set command to fail (6193449)
Error thrown when list JMS physical destinations within non-DAS config (6532532)
Win2003 only: Non-paged pool leak memory, breaking tcp stack and richaccess test (6575349)
Setting debug statement for access,failure causes hang in server startup (6180095)
Log level Setting for Persistence Cannot Be Made Persistent (13253247)
Enterprise Server Does Not Start If MQ Broker is Not Started (6740797)
MQ broker fails to start with cluster profile on Linux (6524871)
Mismatch of old and new classes is created when imqjmsra.jar is loaded before upgrade (6740794)
Open JNDI Browsing from Admin UI dumps a huge amount of exceptions in the server.log (6591734)
AIX: monitor command doesn't work on AIX (6655731)
Solution: To Install the Missing libcliutil.so Library File
Installation Log Shows Failures for Samples Installation (6802286)
After upgrade Enterprise Server samples and JES5 portal samples compete on derby port 1527 (6574563)
Expired Root CA for CN=GTE CyberTrust Root 5, OU=GTE CyberTrust Solutions, Inc. (17405362)
To Delete the GTE CyberTrust Root 5 Certificate From the Truststore
Modify Policy Files for Existing Domains (17419736 and 17574160)
CA Certificate bundled with Enterprise Server v2.1.1 has expired (12287499)
OutofMemory Error in SSL Scenarios During Heavy Stress (JDK 6 Issue 23)
AIX: WSS dynamic encrypt key test failed due to server side certification validation error (6627379)
SSL termination is not working (6269102)
Socket connection leak with SSL (6492477)
General Vulnerability Assessment (Issue 17287)
Different domains are lost during upgrade when different build combinations are used (6546130)
Localized Online Help for asupgrade GUI Does Not Exist (6610170)
Solution: To Preserve All Node Agents in a Side-by-Side Upgrade of Multiple Domains
In-place upgrade does not update the index.html file of existing domain (6831429)
Unable to compile JSP page on resource constrained servers (6184122)
Enterprise Server does not support auth-passthrough Web Server 6.1 Add-On (6188932)
AS 9.1 b50e.Linux. Can not start WS after AS LB installation: libjvm.so:cannot open shared (6572654)
Ant task wsimport fails with Java EE SDK b33d (using JDK 1.6) with NoClassDefFoundError (6527842)
publish-to-registry commands fail in IFR EE builds (6602046)
wscompile fails with "package javax.xml.rpc does not exist" on JDK6 u4 b3 (6638567)
This section describes known installation issues and associated solutions.
The image on the left-hand side of the installer shows an older product version instead of v2.1.1.
None.
On OpenSolaris 2008.11, when you attempt to start the domain with the asadmin start-domain command, the following error message is displayed:
Timeout waiting for domain domain1 to go to starting state. CLI156 Could not start the domain domain1.
The domain has started successfully. Correct the time and date after rebooting the machine.
Installation of Enterprise Server v2.1.1 Patch 7 with the enterprise profile does not work on any 64–bit JVM.
Do one of the following:
If the operating system supports running a 32–bit JVM on a 64–bit platform, you can run the enterprise profile with a 32–bit JVM.
You can run the cluster profile or the developer profile using a 64–bit JVM on a 64–bit platform.
For Oracle's policy with regard to Enterprise Server support on 64–bit platforms, refer to Doc ID 1320311.1 at My Oracle Support.
Installation fails on 64–bit systems that have 64–bit JDK because the installer tries to use the 64–bit JDK.
If you are installing Sun GlassFish Enterprise Server on a 64–bit system, download the 32–bit JDK and use it to install Sun GlassFish Enterprise Server on your 64–bit machine. You will need to use the following command: ./distribution_filename —javahome path to 32–bit JDK location
After installation, to ensure that Sun GlassFish Enterprise Server uses a 64–bit JDK, edit the value of the AS_JAVA variable in the asenv.conf file to point to the 64–bit JDK installation.
This problem has been observed on systems running Linux with the environment variable, MALLOC_CHECK_, set to 2.
Set the environment variable, MALLOC_CHECK_ to 0. Run one of the following commands:
For Bourne shell:
MALLOC_CHECK_=0; export MALLOC_CHECK_
For bash shell:
export MALLOC_CHECK_=0
For csh, tcsh shell:
setenv MALLOC_CHECK_ 0
This problem has been observed on several Linux systems. It is most common on Java Desktop System 2 but has also been observed on Linux Red Hat distributions.
After clicking the "Finish" button on the last installer screen, the installer fails to launch a browser window containing the product About page or product registration page, and hangs indefinitely, not returning the command prompt.
Exit the installer by pressing Ctrl+C in the terminal window in which the installer was started. After doing this, browser window containing product About page or registration page will sometimes be launched, but if it does not show up, start the browser and enter following URL in order to review About page:
file://as-install/docs-ee/about.html
If you also selected the installation option to register the product, follow the link to registration page available on product About page.
On Windows, immediately after installation, the Message Queue broker fails on startup with a message saying the directory drive:\as\domains\domain1\imq does not exist.
Note that if the broker is started after starting domain1, the directory will be created by the Application Server and the problem will not occur.
Create the var_home_dir_location before creating the broker:
$imqbrokerd -varhome var_home_dir_location
For example:
$imqbrokerd -varhome D:\as\domains\domain1\imq
If the Enterprise Server productregistry file contains shared component configurations, an Enterprise Server uninstallation procedure does not update the productregistry file correctly, and you will not be able to use silent mode in a subsequent installation unless the productregistry file is renamed or removed. Leaving the shared components entries in the productregistry file intact is by design, but it leads to confusion with subsequent silent installs.
After a successful uninstallation is reported back through uninstall log files, delete the productregistry file prior to running a subsequent installation. To verify that a previous uninstallation has completed successfully, look for a appserv_uninstall.class file in as-install. This file will not be present if the uninstallation was successful.
Note - Do not delete the productregistry if the uninstallation was not successful.
The productregistry file is located in /var/sadm/install on Solaris and /var/tmp on Linux.
When installing Enterprise Server in a sparse local zone, the installation fails if Message Queue (MQ) is not installed first. The installer attempts to install MQ, and then the whole installation fails.
MQ must be manually installed in the global zone before installing Enterprise Server in a sparse local zone. There are two work-arounds for this issue:
Install MQ 4.1 manually in the global zone from the same media on which Enterprise Server IFR installation is located to get the latest MQ packages.
Use the installer that corresponds to your platform:
mq4_1-installer-SunOS.zip mq4_1-installer-SunOS_X86.zip mq4_1-installer-Linux_X86.zip mq4_1-installer-WINNT.zip
Unzip the bits and run the installer.
The installer will be in the mq4_1-installer directory.
Install any component of IFR installation in global zone. This action would check the version of MQ in GZ and if required upgrade it to the one bundled in Enterprise Server IFR. Even Selecting and Installing the Sample Applications component upgrades MQ to IFR version.
Run the Enterprise Server installation in the global zone, but select only the sample components.
The sample component installation also installs MQ and Enterprise Server shared components in all zones.
Run the Enterprise Server installation again, this time in the local sparse zone.
Installation should complete without any problems.
When running the Enterprise Server IFR installer with the —console option (command-line mode), you are prompted:
Do you want to upgrade from previous Application Server version?
Unfortunately, the IFR installer does not support such upgrades, and so this prompt is erroneous. If you answer yes to the prompt, the installation proceeds normally, but no indication that a complete installation was performed, rather than an upgrade.
Use the upgrade tool if you want to upgrade your Enterprise Server installation.
The following exceptions might be thrown:
#|2008-11-19T01:44:37.422+0530|SEVERE|sun-appserver9.1|org.apache.catalina.session.ManagerBase|_ThreadID=17;_ThreadName=pool-1-thread-3;_Req uestID=cc0ddf54-a42e-400a-9788-e30d79a25d88;|PWC2768: IOException while loading persisted sessions: java.io.InvalidClassException: org.apache .catalina.session.StandardSession; local class incompatible: stream classdesc serialVersionUID = 8647852380089530442, local class serialVersi onUID = -8515037662877107054 java.io.InvalidClassException: org.apache.catalina.session.StandardSession; local class incompatible: stream classdesc serialVersionUID = 864 7852380089530442, local class serialVersionUID = -8515037662877107054..... .....
After upgrade is done and the upgrade domain is started, these exceptions can be ignored if they occur.