Table of Contents

The release notes contain important information about Sun GlassFish Web Stack. Known limitations and problems, technical notes, and other information are described here. Read this document before you begin using Sun GlassFish Web Stack in order to improve your overall installation and operation experience.

Product Description

Sun GlassFish Web Stack is an integrated stack of popular open source web tier infrastructure technologies such as Apache HTTP Server, MySQL, memcached, and, PHP optimized for Solaris, OpenSolaris, and Linux operating platforms.

Component availability may be different depending upon the operating platform.

System Requirements

This section provides the hardware and software requirements for Sun GlassFish Web Stack for the supported operating platforms.

Hardware Requirements

Software Requirements

General Notes

Sun GlassFish Web Stack Components

The table lists the primary components bundled with Sun GlassFish Web Stack.

Changes Log

This section lists the changes made in this release of Sun GlassFish Web Stack for the Solaris, OpenSolaris, and Red Hat Linux operating platforms.

Version 1.5

• Sun GlassFish Web Stack components updated to the noted versions in the section Sun GlassFish Web Stack Components.
• New Component: Web Stack Enterprise Manager, a browser-based software application to monitor the health and availability of the Sun GlassFish Web Stack components. For more information see, Enterprise Manager Installation and User Guide.
• New Distribution: Unbundled IPS/pkg(5), This is distribution features Non-Root Installation, Relocatable Installation and Simplified Add-on framework.
• New Component: Sun Integration Server "Hudson", a JavaEE based continuous integration tool. For more information see, https://hudson.dev.java.net.
• Updated Component: MySQL 5.1, provides performance improvements and support for DTrace probes. For more information see, http://dev.mysql.com/doc/refman/5.1/en/news-5-1-x.html.
  o MySQL 5.1 is now the default MySQL, except for Web Stack 1.4 users using the upgrade install option
  o Use MySQL 5.1 client library in other components, including Lighttpd, MySQL, and APR-Util
  o default my.cnf is now based on my-medium.cnf
• Updated Component: Apache and additional modules
  o Integrated fixes for CVE-2009-0023, CVE-2009-1191, CVE-2009-1195, CVE-2009-1890, CVE-2009-1891, CVE-2009-1955, CVE-2009-1956, CVE-2007-1349
  o New modules installed by default, mod_sed, mod_security, and mod_auth_gss
  o Supports exception hooks
  o ldaps support using OpenLDAP on Solaris 10
• Updated Component: PHP and extensions
  o Included additional security and performance fixes from PHP 5.2.10
  o Included sample configuration script for simplified configuration with Sun Web Server 7
  o Delivered mysql and pgsql extensions in separate package
  o expat is replaced by libxml2
  o ldaps support using OpenLDAP on Solaris 10
  o Provided APC and memcache statistics files
  o Added DTrace probes
  o Added mcrypt extension
• Updated Component: Lighttpd
  o Added LDAP support using OpenLDAP
• Updated Component: Python
  o Provided additional standard Python modules

Solaris and Red Hat Enterprise Linux

Bugfixes:

• Tomcat and Squid init scripts for Red Hat Enterprise Linux now support chkconfig
• Apache and additional modules
  o Fixed permissions of logs directory and sample CGI scripts
• MySQL
  o Ignores the default confiugration files, /etc/my.cnf and /etc/mysql/my.cnf, which could have been installed by another distribution of MySQL
• PHP
  o Used reentrant form of MySQL client library for compatibility with APR-Util
  o Fixed crash in APC when stat is enabled
  o Fixed package dependencies on Solaris 10
  o Fixed incompatibilities between APC and suhosin extensions when using WordPress on SPARC
• Python
  o Fixed crash in ctypes extension on SPARC

OpenSolaris

Changes:

Bugfixes:

Version 1.4

Solaris and Red Hat Enterprise Linux

Sun GlassFish Web Stack is the first release of Sun GlassFish Web Stack on Solaris and Red Hat Linux operating platforms.

OpenSolaris

Changes in Sun GlassFish Web Stack for OpenSolaris 2008.11 (snv_101) from Sun GlassFish Web Stack OpenSolaris 2008.05 (snv_79b)

Changes:

• php5 integration supports PEAR / PECL extension
• memcached supported in php5
• PHP version updated to version 5.2.6
• DTrace module is integrated with Apache2
• Integrated a newer version of suhosin extension within OpenSolaris
• php DTrace extension enabled by default
• Squid Proxy Server integrated into OpenSolaris
• MySQL 5.0.45 version integrated
• Interface for user-specified environment variables are available for Apache2
• libapr and apr-util are in separate packages for other clients to use
• Apache Tomcat updated to version 5.5.17
• lighttpd 1.4 integrated
• JDBC Connector 5.1.5 is now part of MySQL 5.0.4 64-bit delivery
• imap / imap-ssl support within php
• Ruby DTrace support integrated
• External Apache modules (fcgid,jk,security) integrated

Bugfixes:

• (CR 6624123) Squid does not start because /var/squid/cache is not owned by its user
• (CR 6626831) SUNWsquidu package issues
• (CR 6628416) php-config / phpize scripts contains incorrect build relative and extension_dir location
• (CR 6631480) Apache2 manpage missing
• (CR 6640476) Squid vulnerable to denial of service per Squid Advisory SQUID-2007:2
• (CR 6657714) PHP MySQL module is incorrectly linked to 4.0 version of MySQL client
• (CR 6653084) Apache22 service fails to start
• (CR 6664712) mysql_config provides incorrect link library configuration
• (CR 6373222) Apache2 refuses to serve files over 2GB in size
• (CR 6367565) Bundled Apache2 runs out of file descriptors when there are many virtual hosts

Installation

For installing and configuring Sun GlassFish Web Stack, see Sun GlassFish Web Stack Installation and Configuration Guide.

Documentation

For additional product documentation, see the Sun GlassFish Web Stack Documentation Wiki.

Licensing

Sun GlassFish Web Stack is a set of many components from third party open source projects. Each of these components has its own license, as chosen by the third party which owns the component. The following table lists various licenses used in Sun GlassFish Web Stack.

The Sun-owned source code which includes Installer and Registration tool is under CDDL (http://www.sun.com/cddl/) .

Known Issues

This section contains information on known bugs and problems in this release and instructions on fixing, avoiding or working around them.

• (CR 6820045) Sun GlassFish Enterprise Server installation will not work with the 64-bit JDK. If you are installing Sun GlassFish Enterprise Server on a 64-bit version of Red Hat Enterprise Linux, use a 32-bit JDK to install Sun GlassFish Enterprise Server. For more information, see this document.
• (CR 6824240) Sun GlassFish integration with mod_jk needs depends upon Tomcat 5.5 library. If you use mod_jk to communicate with GlassFish Enterprise Server 2.1, update GlassFish Enterprise Server with Tomcat's AJP support as described at this document
• (CR 6835221) In certain configurations, Apache may log a large number of the following messages:

  [warn] (128)Network is unreachable: connect to listener on [::]:80
  

  If that occurs, change the Listen directive to specify an IPv4 address, as in the following example: "Listen 0.0.0.0:80".

• (CR 6856875) regtool cannot be launched automatically when the system's locale is not set properly. In this case the user needs to execute the regtool manually from command line.
• (CR 6847959) Installation of the Ruby mysql gem on Solaris 10 may use an incompatible MySQL client library in /usr/sfw/lib by default. This may cause gems builds to fail. In order to use the Sun GlassFish Web Stack version of the MySQL client library you need to build the gem as follows:

  ./bin/gem install mysql -- --with-mysql-include=OPT_ROOT/mysql/5.1/include/mysql --with-mysql-lib=OPT_ROOT/mysql/5.1/lib/mysql
  

• (CR 6855348) Native and the Unbundled IPS/pkg(5)Distribution of the Sun GlassFish Web Stack Administration tool listens on the same port, hence a simultaneous install of the two version can result in the corrupt data.
• (CR 6853608) Update Center 2 Release: Root installation of the Sun GlassFish Web Stack components will not be successful if the appropriate user does not exists in the system. For instance, For apache httpd, lighttpd, php, tomcat, squid requires the presence of the user "webservd" and mysql requires presence of the user "mysql".
• (CR 6861325) If GlassFish Web Stack RPMs are uninstalled on Red Hat Enterprise Linux, several admin product directories under /opt/sun/webstack/admin may remain. These directories must be be deleted manually.
• (CR 6862456) After upgrading from Web Stack 1.4 on Solaris 10, the SMF manifests for Apache HTTP Server, Squid, Lighttpd, and Tomcat must be manually imported. For each installed service, use the command below to perform this required upgrade step:

Apache HTTP Server:

/usr/sbin/svccfg import /var/svc/manifest/network/http-sun-apache22.xml

Squid:

/usr/sbin/svccfg import /var/svc/manifest/network/http-sun-squid.xml

Lighttpd:

/usr/sbin/svccfg import /var/svc/manifest/network/http-sun-lighttpd14.xml

Tomcat:

/usr/sbin/svccfg import /var/svc/manifest/network/sun-http-tomcat6.xml

• (CR 6836774, 6836775, 6836771, 6836773, 6836772) On Solaris, removing 1.4 packages using pkgrm command removes all the modified, user-editable files, if any. This applies to 1.5 PHP core and extension packages (i.e. sun-php52*) as well. Hence, take a backup of these files before invoking pkgrm.
• (CR 6863037) On Solaris, upgrading PHP core and extension packages (i.e. sun-php52* packages) using the install tool replaces all the configuration files. Hence, if you have modified any of the config files, take a backup before upgrading.
• (CR 6862214) On Red Hat Enterprise Linux Unbundled IPS/pkg(5) distribution, Enterprise Manager may fail with exceptions logged into the enterprise manager log. For expected behavior you need to add the OPT_ROOT/bin in the PATH variable.
• (CR 6852152) When you set server_type/enable_64bit property and restart the Apache SMF service, an HTTPD setting is added to ETC_ROOT/apache2/2.2/envvars which hard-codes the path to HTTPD. Direct use of apachectl can then fail because the modules loaded may not match the server executable file (32-bit/64-bit mismatch). To work around the issue, modify the value of HTTPD in ETC_ROOT/apache2/2.2/envvars file.
• (CR 6866312) On Red Hat Enterprise Linux,Unbundled IPS/pkg(5) distribution of Sun GlassFish Web Stack may not work when SELinux is enabled. See the Update Center Release Notes (CR 1211) for more information and work around to this issue.

Component Release Notes

The following table lists the release notes available for the individual components of the Sun GlassFish Web Stack.

Official Sales and Support

Sun GlassFish Web Stack Support is only available as a part of the Sun GlassFish Portfolio Subscription. Please see Sun GlassFish Portfolio for information on subscription services.

Support for this product is available via Sun GlassFish Portfolio Support. Please see Sun GlassFish Portfolio Support and the Sun GlassFish Web Stack Product Page for more information.

Community Support

Community Support is available through the Sun GlassFish Web Stack Forum.

Product Registration

Register your copy of Sun GlassFish Web Stack, to stay updated with the latest Sun GlassFish Web Stack News and Updates.

Sun GlassFish Web Stack has a regtool command for registering the product. This tool is invoked automatically after installation. In case you have skipped the registration process you can re-run the registration process by invoking the regtool. You can invoke the regtool by performing the following command:

OPT_ROOT/bin/regtool

Product Feedback

You can submit product feedback via the Sun GlassFish Web Stack Forum.