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


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

Web Stack Support

You can use Enterprise Server with Sun GlassFish Web Stack, which pre-integrates and bundles components such as Apache HTTP Server, PHP, Ruby, and more. For more information about Sun GlassFish Web Stack, see the Sun GlassFish Web Stack Documentation wiki.

Enterprise Server provides support for load balancing by using the load balancer plug-in front-ended by Sun Java System Web Server, Apache Web Server and Microsoft IIS. Another technique for front-ending Enterprise Server is to use Apache httpd with the mod_jk connector.

Front-ending Enterprise Server with Apache httpd and mod_jk

  1. Create an Enterprise Server cluster.
  2. Define the following JVM options as follows:
    • asadmin create-jvm-options --target cluster_name "-DjvmRoute=\${AJP_INSTANCE_NAME}"

    • asadmin create-jvm-options --target cluster_name "-Dcom.sun.enterprise.web.connector.enableJK=\${AJP_PORT}"

  3. Configure the JVM options, AJP_PORT and AJP_INSTANCE_NAME, for each instance in the cluster with the following command:

    asadmin create-system-properties --target instance_name AJP_INSTANCE_NAME=instance_name

    asadmin create-system-properties --target instance_name AJP_PORT=port-number

  4. Restart the cluster
  5. Install Apache httpd.

    Apache httpd is available from

  6. Install mod_jk.

    The mod_jk connector is available from

  7. Add the following lines to the file:
    LoadModule jk_module
    JkWorkersFile /etc/apache2/
    # Where to put jk logs
    JkLogFile /var/log/httpd/mod_jk.log
    # Set the jk log level [debug/error/info]
    JkLogLevel debug
    # Select the log format
    JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
    # JkRequestLogFormat set the request format
    JkRequestLogFormat "%w %V %T"
    # Send all jsp requests to GlassFish
    JkMount /*.jsp loadbalancer.
  8. Create a new file named /etc/apache2/ and add the following lines:
    # Define 1 real worker using ajp13
    # Set properties for instance1
    # Set properties for instance2
    # Set properties for instance3
  9. Copy the tomcat-ajp.jar file from the Apache 5.5.x installation to the Enterprise Server lib directory.
  10. Copy the commons-logging.jar (version 1.1.1) and the commons-modeler.jar (version 2.0.1) file from the Jakarta Commons web site at
  11. Restart the cluster and start httpd.