JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun GlassFish Enterprise Server v2.1.1 Release Notes

Document Information

1.  Overview

2.  About Sun GlassFish Enterprise Server

What's New in Sun GlassFish Enterprise Server v2.1.1

Sun GlassFish Enterprise Server Features

Hardware and Software Requirements

Supported Platforms

System Virtualization Support

Important Patch Information

Solaris Patch Requirements

JDK Version

To Switch to the Supported Java SE Version

Apache Ant Version

JDBC Drivers and Databases

Using the Bundled Java DB Database

Starting and Stopping the Java DB Database

Java DB Utility Scripts

Message Queue Versions

Web Servers for the Load Balancing Plugin

Browsers

HADB Requirements and Supported Platforms

Supported Platforms

HADB Server Host Requirements

HADB Management Host Requirements

HADB Client Host Requirements

Upgrading the Enterprise Server

Required Free Ports

Other Requirements

Java EE 5 Platform APIs

Java EE 5 SDK

Switching to Another Supported Java Version

To Switch to Another Supported Java Version

Known Java ES 5 Compatibility Issues

Oracle Access Manager Integration

Web Stack Support

Front-ending Enterprise Server with Apache httpd and mod_jk

Features Not Supported on All Operating Systems

Features Not Supported on the AIX Operating System

Features Not Supported on the Linux Operating System

Features Not Supported on the Ubuntu Operating System

Sun GlassFish Enterprise Manger

Using the Update Center

To Use the Update Center

Upgrading the Enterprise Server on the Ubuntu Operating System

Enabling Multilevel Relationship Prefetching

Setting the Interval for Rotating a Node Agent's Log File

To Set the Interval for Rotating a Node Agent's Log File

More About WSIT Integration

3.  Known Issues and Limitations

Hardware and Software Requirements

This section lists the requirements that must be met before installing Sun GlassFish Enterprise Server.

Supported Platforms

The following table lists the operating systems with which the Sun GlassFish Enterprise Server v2.1.1 is compatible. All supported operating systems are 32-bit unless indicated otherwise. 64-bit JDK is only supported on 64-bit supported operating systems.


Note - The table lists the minimum required version of each supported operating system. Service pack updates to the minimum required version are also supported.


Table 2-1 Supported Operating Systems

Operating System
Minimum Memory
Recommended Memory
Minimum Disk Space
Recommended Disk Space
JVM
Sun Solaris 9, 10 (SPARC)

Solaris 9, 10 (x86)

512 MB
512 MB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

64–bit Sun Solaris 10 (SPARC, x86)
512 MB
512 MB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

Red Hat Enterprise Linux 3.0 Update 1, 4.0, and 5.x
512 MB
1 GB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

64–bit Red Hat Enterprise Linux 5.x
512 MB
1 GB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

SUSE Linux Enterprise Server 10 (SP1, SP2 are also supported)
512 MB
1 GB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

64–bit SUSE Linux Enterprise Server 10 (SP1 is also supported)
512 MB
1 GB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

64–bit SUSE Linux Enterprise Server 11
512 MB
1 GB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

Ubuntu Linux 8.04, Hardy Release

Supported only as a developer platform.

512 MB
1 GB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

AIX 5.2, 5.3, 6.1
512 MB
1 GB
250 MB free
500 MB free
J2SE 5.0

Java SE 6

64–bit AIX 6.1
512 MB
1 GB
250 MB free
500 MB free
JDK 1.6.0 SR6
Windows 2000 SP4+

Advanced Server SP4+

Windows Server 2003, 2008

Windows XP Pro SP3

Windows Vista

Windows 2008

1 GB
2 GB
500 MB free
1 GB free
J2SE 5.0

Java SE 6

64–bit Windows 2008 R2
1 GB
2 GB
500 MB free
1 GB free
JDK 1.6.0_23
Windows 7

Supported only as a developer platform

1 GB
2 GB
500 MB free
1 GB free
J2SE 5.0

Java SE 6

Macintosh OS 10.4, 10.5 (Intel, Power)

Supported only as a developer platform.

512 MB
512 MB
250 MB free
500 MB free
Java SE 5
OpenSolaris

Evaluation support only

512 MB
512 MB
250 MB free
500 MB free
Java SE 5

Java SE 6

On UNIX, you can check your operating system version using the uname command. Disk space can be checked using the df command.


Note -

  1. The Enterprise Server enterprise profile is not supported on any 64–bit platform.

  2. Its recommended that you use the NTFS file system rather than FAT or FAT32 when running the Enterprise Server on any Microsoft Windows platform.

  3. Although Mac OS is not supported for production deployments, it is supported for development purposes. You can get information on downloading the Macintosh operating system from the GlassFish downloads page , or through the SDK page where Mac is listed. For example, on the Java EE 5 SDK Update 5 download page.


System Virtualization Support

System virtualization is a technology that enables multiple operating system (OS) instances to execute independently on shared hardware. Functionally, software deployed to an OS hosted in a virtualized environment is generally unaware that the underlying platform has been virtualized. Sun performs testing of its Sun Java System products on select system virtualization and OS combinations to help validate that the Sun Java System products continue to function on properly sized and configured virtualized environments as they do on non-virtualized systems.

Important Patch Information

Solaris Patch Requirements

It is recommended that Solaris 10 (x86, SPARC) users have the “Sun recommended patch cluster” installed. This patch cluster is available under “Recommended and Security Patches” on the SunSolve Web site.

JDK Version

The minimum (and certified) version of JDK required for Enterprise Server is 1.6.0_23.

To Switch to the Supported Java SE Version

You can switch to a supported Java SE version by editing the asenv file as described here.

  1. If you have not already done so, install the new Java SE version on your system.

    The Java SE SDK can be downloaded from http://java.sun.com/javase

  2. Stop the Enterprise Server.
    • From the command line:

      install_dir/bin/asadmin stop-domain

    • From the Administration Console:

      1. Click the Application Server node.

      2. Click Stop Instance.

  3. Edit the install_dir/config/asenv.conf file (asenv.bat on Windows), changing the value for AS_JAVA to point to the new Java home directory:
  4. Edit the as-install/samples/common.properties file, changing the line beginning com.sun.aas.javaRoot... to reference the new Java home directory.
  5. Restart the Application Server.
    • From the command line:

      as-install/bin/asadmin start-domain

    • From the Administration Console:

      1. Click the Application Server node.

      2. Click Start Instance.

Apache Ant Version

Version 1.6.5 of Apache Ant is bundled with Enterprise Server on all operating systems except Ubuntu Linux. Version 1.7.0 of Apache Ant is bundled with Ubuntu Linux and used with Enterprise Server .

JDBC Drivers and Databases

Table 2-2 lists databases and drivers that meet the Java EE compatibility requirements. All supported configurations of the Sun GlassFish Enterprise Server must contain at least one database/driver combination from this table, such as the bundled Java DB database and driver. In addition, the Enterprise Server is designed to support JDBC connectivity to any additional DBMS with a corresponding JDBC driver.

Table 2-2 Java EE-Compatible JDBC Drivers

JDBC Driver Vendor
JDBC Driver Type
Supported Database Server
Derby Network Client
Type 4
Derby 10.2
DataDirect 3.6.x, 3.7.x

(Also known as Sun JDBC drivers)


Note - Sun JDBC drivers are provided only with Enterprise-profile capable installation bundles.


Type 4
Oracle 10g

Oracle 9i

Sybase ASE 12.5, 15

MS SQL 2000, 2005

DB2 9.1

DB2 8.1, 8.2

MySQL Connector/J Driver 3.1
Type 4
MySQL 5.0
Oracle 10g, 11g
Type 4
Oracle 10g, Oracle 11g

-RAC

PostGres
Type 4
8.1, 8.2.x

In general, the Enterprise Server v2.1.1 supports all JDBC drivers that meet the Java EE specification.

Using the Bundled Java DB Database

This section provides instructions for using the Java DB database implementation bundled with Enterprise Server v2.1.1. Java DB is based on the Apache Derby database.

Starting and Stopping the Java DB Database

Sun GlassFish Enterprise Server has the following asadmin commands for starting and stopping the Java DB Network Server.

Java DB Utility Scripts

The Java DB configuration that is supplied with Enterprise Server 2..1.1 includes scripts that can help you use Java DB. The following scripts are available for use in the as-install/javadb/bin directory:

To Configure Your Environment to Run the Java DB Utility Scripts

  1. Ensure that the JAVA_HOME environment variable specifies the directory where the JDK is installed.
  2. Set the DERBY_HOME environment variable to point to the as-install/javadb directory.

See Also

For more information about these utilities, see the following Derby documentation:

Message Queue Versions

For file-based installations, Message Queue 4.4 is co-packaged with Enterprise Server.

The embedded Sun GlassFish Message Queue code that is supplied as part of Enterprise Server is only tested and certified (typically) against the equivalent version of the Message Queue broker. This means that using the supplied embedded Message Queue code to connect to a remote (not managed by Enterprise Server) Message Queue broker running a different version of the Message Queue code is not supported.

Web Servers for the Load Balancing Plugin

This section lists the Web servers that are supported for the Sun GlassFish Enterprise Server load balancing plugin.

Table 2-3 Supported Web Servers

Web Server
Version
Operating System1
Sun Java System Web Server (32–bit)
6.1, 7.0
Solaris SPARC 9, 10

Solaris x86 9, 10

Red Hat Enterprise Linux 3, 4 , 5

SUSE Linux 10, 11

Apache Web Server (32–bit)
2.0.x, 2.2.x
Solaris SPARC 9, 10

Solaris x86 10

Red Hat Enterprise Linux 3, 4, 5

SUSE Linux 10, 11

Microsoft IIS (32–bit)
5.0+, 6
Windows Server 2003

1Only 32–bit platforms are supported.

Browsers

This section lists the browsers that are supported with the Sun GlassFish Enterprise Server v2.1.1.

Table 2-4 Supported Web Browsers

Browser
Version
Mozilla
1.7.12
Internet Explorer
6.0 Service Pack 2, 7.0
Firefox
2.x, 3.x
Safari
3.x,4.x
Netscape
8.0.4, 8.1, 9.0, 9.0.x

HADB Requirements and Supported Platforms

In addition to the requirements listed in Hardware and Software Requirements, verify that your system meets the requirements listed below for running HADB.


Note - HADB is only bundled with the Enterprise Server v2.1.1 Enterprise profile. Also note that the Java components of the system have been built and tested on JDK 5 and JDK 6.


Supported Platforms

HADB Server Host Requirements


Note - Make sure write caching is disabled on devices storing HADB data and log files. Write caching is enabled by default on some Solaris platforms; for example, Solaris x86.


HADB Management Host Requirements

HADB Client Host Requirements

Upgrading the Enterprise Server

Refer to the Sun GlassFish Enterprise Server v2.1.1 Upgrade Guide for complete instructions for upgrading from a previous version of the Enterprise Server to the current version.

Required Free Ports

You must have seventeen unused ports available for the ports Enterprise Server uses. The installation program automatically detects ports that are in use and suggests currently unused ports for the default settings. The initial default port assignments are listed in the following table. If these default port numbers are in use, the installation program assigns a randomly selected port number from the dynamic port range. The selected port number might not be the next available port number.

Table 2-5 Default Port Assignments for Enterprise Server

Port Number
Usage
4848
Admin Console
8080
HTTP
8081
HTTPS
8686
Pure JMX clients
3700
IIOP
3820
IIOP/SSL
3920
IIOP/SSL with mutual authentication
22
SSH port
9009
Java debugger
6666
OSGi shell telnet port
7676
JMS provider
Auto-generated from the operating system's dynamic port range
Message Queue TCP port
Auto-generated from the operating system's dynamic port range
Message Queue Admin port
9090
GMS TCP start port
9200
GMS TCP end port
Auto-generated between GMS TCP start and end ports
GMS listener port
Auto generated between 2048 and 32000
GMS multicast port

Other Requirements

The following additional requirements should be met before installing the Sun GlassFish Enterprise Server software.