Installation

This section describes known installation issues and associated solutions.

Installer decoration image shows old product version (6862674)

Description

The image on the left-hand side of the installer shows an older product version instead of v2.1.1.

Solution

None.

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

Description

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.

Solution

The domain has started successfully. Correct the time and date after rebooting the machine.

Enterprise profile installation is not supported with a 64-bit JVM on a 64–bit platform (6977626)

Description

Installation of Enterprise Server v2.1.1 Patch 7 with the enterprise profile does not work on any 64–bit JVM.

Solution

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

Description

Installation fails on 64–bit systems that have 64–bit JDK because the installer tries to use the 64–bit JDK.

Solution

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)

Description

This problem has been observed on systems running Linux with the environment variable, MALLOC_CHECK_, set to 2.

Solution

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

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

Description

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.

Solution

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, the imq directory needs to be created during installation (6199697)

Description

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.

Solution

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)

Description

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.

Solution

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.

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)

Description

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.

Solution

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 IFR installation is located to get the latest MQ packages.

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

   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 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)

Description

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.

Solution

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)

Description

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

Solution

After upgrade is done and the upgrade domain is started, these exceptions can be ignored if they occur.