Sun GlassFish Enterprise Server 2.1 Release Notes


This section describes known installation issues and associated solutions.

The start-domain Command Times Out on OpenSolaris 2008.11 (6820169 and 6741572)


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 with 64–bit JDK Fails (6796171)


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.

Enterprise Server installer crashes on Linux (6739013)


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:

Installation shutdown hanging on some Linux systems after clicking the "Finish" button (5009728)


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:


If you also selected the installation option to register the product, follow the link to registration page available on product About page.

On Windows, the imq directory needs to be created during installation (6199697)


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.


  1. 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

Uninstall does not update productregistry file properly; unable to use silent mode to install (6571598)


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.

IFR. Was not able to install AS in the sparse local zone, MQ packages issue. (6555578)


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:

  1. Install MQ 4.1 manually in the global zone from the same media on which Enterprise Server 2.1 IFR installation is located to get the latest MQ packages.

    1. Use the installer that corresponds to your platform:
    2. Unzip the bits and run the installer.

      The installer will be in the mq4_1-installer directory.

  2. 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 2.1 IFR. Even Selecting and Installing the Sample Applications component upgrades MQ to IFR version.

    1. 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.

    2. Run the Enterprise Server installation again, this time in the local sparse zone.

      Installation should complete without any problems.

IFR Installation -console prompt has to be removed: “Do you want to upgrade from previous Application?” (6592454)


When running the Enterprise Server 2.1 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.

After upgrade, the following exceptions are seen in the log when a domain is started. (6774663)


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: org.apache .catalina.session.StandardSession; local class incompatible: stream classdesc serialVersionUID = 8647852380089530442, local class serialVersi onUID = -8515037662877107054 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.