Release Notes for Sun^TM ONE Application Server, Enterprise Edition

Formerly known as iPlanet^TM Application Server.

Version 6.5 Service Pack 1, Maintenance Update 3 for x86/Windows Platform

Part Number: 817-4099-10

Updated September 11, 2003

These release notes contain important information available at the time of the Version 6.5 SP1, Maintenance Update 3 release of Sun ONE Application Server, Enterprise Edition.

This document contains the following sections:

Installation Notes
Special Instructions
Resolved Issues
Additional Information
Known Issues and Limitations

Installation Notes

This section contains information about installing Sun ONE Application Server, Enterprise Edition, 6.5 SP1 Maintenance Update 3. For detailed information about installation procedures, see Sun ONE Application Server Installation Guide at Sun documentation web site.

Relevant Architecture: x86

Relevant Operating Systems: Windows NT 4.0 SP6a, Windows 2000 Professional SP2, Windows 2000 Server SP2, Windows 2000 Advanced Server

Files included with this patch:

.\ias\bin\gxbindu.dll
.\ias\bin\gxreposit.dll
.\ias\bin\gxprincipal.dll
.\ias\bin\iASApachePlugin.dll
.\ias\bin\gxdsync.dll
.\ias\bin\jx2thread.dll
.\ias\bin\jx2ebfp.dll
.\ias\bin\gxagent.dll
.\ias\bin\gxnsapi6.dll
.\ias\bin\gxisapi.dll
.\ias\bin\gxorcl.dll
.\ias\bin\gxsecurity.dll
.\ias\bin\gxutil.dll
.\ias\bin\gxmailbox.dll
.\ias\bin\kas.exe
.\ias\bin\patchversion.exe
.\ias\classes\java\kfcjdk11.jar
.\ias\classes\java\kadmin.jar
.\ias\classes\java\buzz.jar
.\ias\classes\java\jasper.jar

Installation Instructions

Install Activestate Perl (ActivePerl) version 5.6.0 or later. You can download it from http://www.activestate.com.

Ensure that all application server processes have been shutdown.

Ensure that the directory server is running.

If the Web server is running on the same machine as Sun ONE Application Server, then stop the Web server before installing this update.

Become the user who had installed the Sun ONE Application Server you want to patch.

Change the working directory to the directory containing the patch.

Apply the Update by typing:

perl .\applypatch

Special Install Instructions

If you have not installed the "Core Server Component", or "PointBase Database Server", or the "Web Connector plug-in Component", then set the environment variable SPECIAL_INSTALL_OPTS to "-i" before you run applypatch in Step 7, Installation Instructions.
If the Webconnector plugin is running on a separate machine, then the Update must be installed on that machine as well. Set the environment variable SPECIAL_INSTALL_OPTS to -i before performing the steps described in Installation Instructions.
If you are running Rich clients, ensure that after installing Maintenance Update 3, copy install_dir\ias\classes\java\iasacc.jar to the directory where the Rich client is installed.
After applying the patch, copy the file gxisapi.dll from the Sun ONE Application Server installation to the proper directory in the IIS installation and rename the file to gx.dll.

Uninstallation Instructions

Become the user who had installed the application server installation for which you want to backout the patch.
Ensure that all webserver and application server processes have been shutdown.
Ensure that the directory server is running.
Change working directory to the directory where the backup data is saved. The backup data is saved in a directory named backup_patch number in your Sun ONE Application Server installation directory:
Example: cd c:\iplanet\ias6\ias\backup_3

Note: If the Webconnector plugin is installed on a different machine, then you must uninstall the update from the Webconnector directory as well. To restore the old files from the backup directory, follow the steps given under Uninstallation Instructions.
You have to manually remove all files in the backup directory after the Maintenance Update uninstallation is over.
Note: The presence of the backup directory does not affect the reinstallation of the same patch. However you may want to remove the files in the backup directory to save disk space.
Ensure that all application server processes have been shutdown.
Ensure that the directory server is running.
Uninstall the Update by typing:
perl .\unpatch

Special Uninstallation Instructions

If the installation process quits after patching some of the files, then follow these steps to restore the older files:

Change the working directory to the backup_patch number directory present in your Sun ONE Application Server installation.

Copy and rename the file unpatch.bak to unpatch.bat.

Run the following command:

.\unpatch.bat

This command will restore the files that were patched.

Copy the file gxisapi.dll from the Sun ONE Application Server installation backup directory to the IIS installation and rename the file to gx.dll. This will restore the original IIS plugin.

Special Instructions

New EJBC option
In this Maintenace Update 3 release, a new option, called -newjavac, has been made available for iPlanet Enterprise Java Beans^TM Compiler (ejbc). The -newjavac option will invoke a new ejbc shipped with JDK 1.3.1. ejbc will use the old Java compiler by default to provide backward compatibility.
The two Java compilers shipped with JDK 1.3.1 are:
- The old Java compiler available in sun.tools.javac package.
- The new Java compiler available in com.sun.tools.javac package.
If the -newjavac option is passed to ejbc, then the new Java compiler will be used. Using the new compiler does not affect the code generation path. Except in a few corner cases, the two Java compilers are highly compatible with respect to the class files they generate. If you use the -newjavac option, ensure that you build both the client and server with the new compiler to avoid any incompatibility issues.
Before using the new compiler, you will have to modify the existing build scripts, such as makefiles, Ant and shell scripts.
Firewall Time-outs
Problem:If the inactivity period of the application server exceeds the TCP/IP timeout interval of the firewall, then you need to restart the application server and web server.
Workaround:
1. Open the registry editor by running the command, kregedit
2. Go to Application Server\6.5\CCSO\HTTPAPI.
3. Enter the value for the key, KeepAliveTimeOut (in seconds), which could be equal to the default TCP/IP timeout value of the firewall, or equal to the number of seconds for the firewall to timeout.

Resolved Issues

The following table lists the critical issues resolved in Sun ONE Application Server, Enterprise Edition 6.5 SP1, Maintenance Update 3 release. This list also includes bugs fixed in Maintenance Update 1 and 2 releases.

Table 1 List of resolved issues

Bug ID

Description

4849445 Reconstruct URL when forwarding requests between the various components of the request path.
4666151 Plugin fills the error logs with FilterLite::StreamWrite() failure messages.
4808427 Deadlock in cleanUP() and destroy() in ConnectionPool for JDBC driver.
4798957 PDF file does not load from IE browser.
4872305 KJS threads hang on PlatformNASSession.invalidate forever.
4540200 Stateful Session Bean is recycling without clearing internal content.

4836194 Hang on createSession().
4884791 KJS crashes at Java_com_kivasoft_ebfp_FPRequest_invokenative.
4878322 IP address and port of host sent to browser when appserver is down.
4846902 Application server unable to locate JSP dynamically if that JSP has been missing previously.
4854912 JSP being recompiled at each iAS startup.
4852986 Webserver crashes when a request with a malformed URL is made from the browser.
4834034 EJBC compiler spikes CPU on Win2k and freezes compile. Have to perform CTRL+C to continue.
4892620 Patchversion script dose not handle Exception Release version.
4877248 KJS crashes due to Memory corruption.
4774589 Connection Pool statistics for maxIdleTime and reclaimedTimeout connections not captured.

4809129 Timestamp not printed in log.

4799058 All version up to iAS6.5 SP1 IIS plugin has request GX2GX error

4788127 Socket remains in CLOSE_WAIT state forever on Windows platform.

4805009 Java files with wrong names created from JSPs when run through the JSP precompiler.

4808387 Crash in failover code.

4820280 ksvradmin fails to start if Datasource entries are greater than 204 characters.

4819229 CXS process does not start, when using other than the default launcher while starting.

4797959 Sun ONE Application Server webconnector crashes when uploading file with wrong Content-Length Mime.

4828101 Issues with LDAP authentication.

4828267 Connection pool of Jconnect5.5 showing strange auto-commit behaviour.

4769407 Pre-compilation of JSPs not working.

4571019 Database connections cleanup not working for NAS 2.1 and C++ applogics.

4836387 Webconnector crashes when ServletName (web.xml)is longer than path.

4820534 EJB passivate() method throws a NullPointerException.

4764851 JSPC compilation issues during runtime.

4754456 HTTP response from JSPs contains offending CRLF right after HTTP header.

4770671 Request parameters are getting lost(except 1) when going to FBA login page.

4779207 Registered JSP pages fail to execute properly on 6.5 MU3.

4689007 Webconnector logs "info (5242): gxrequest.cpp:gxrequest()..."

4767997 Enable Dynamic Class Reloading check box gets unselected after restart.

4750058 Dsync Logging causes KXS to crash.

4761598 JDBC connection pool not releasing connection when an error occurs in db.

4711735 iPlanet Application Server 6.0 sp3 KJS not load sharing properly.

4754692 Request forwarding is not working when there is a space character in parameter

4735914 Struts template application is not formatting page properly.

4768799 The info for dynamic reloading of servlets is not shown in a log form in KJS.

4672041 MDB Durable Subscribers always create a new subscription.

4804086 Could not configure a durable topic from the deploytool during deployment.

4761319 KXS crashes when customer tries to retrieve any cached information.

4760264 Client Certificate Authentication fails with certificates from iCMS 4.2sp2.

4758869 Context is wrong after FBA with GET.

4762957 deploytool does not handle the editing of the deploy descriptors correctly.

4768669 When username is same as group name ias authorizes an invalid user to login (FBA).

4693651 Monitoring "Total Threads" does not work.

4794965 Urgent need for ias-web.xml server-info tags to work.

4640716 Cluster problems in DSYNC.

4783055 KXS core dumps in GXBuffer::Alloc().

4825234 KJS Hangs at saveSession.

4871079 KeepAliveTimeOut is measured in seconds.

Bug ID	Description
4849445	Reconstruct URL when forwarding requests between the various components of the request path.
4666151	Plugin fills the error logs with FilterLite::StreamWrite() failure messages.
4808427	Deadlock in cleanUP() and destroy() in ConnectionPool for JDBC driver.
4798957	PDF file does not load from IE browser.
4872305	KJS threads hang on PlatformNASSession.invalidate forever.
4540200	Stateful Session Bean is recycling without clearing internal content.
4836194	Hang on createSession().
4884791	KJS crashes at Java_com_kivasoft_ebfp_FPRequest_invokenative.
4878322	IP address and port of host sent to browser when appserver is down.
4846902	Application server unable to locate JSP dynamically if that JSP has been missing previously.
4854912	JSP being recompiled at each iAS startup.
4852986	Webserver crashes when a request with a malformed URL is made from the browser.
4834034	EJBC compiler spikes CPU on Win2k and freezes compile. Have to perform CTRL+C to continue.
4892620	Patchversion script dose not handle Exception Release version.
4877248	KJS crashes due to Memory corruption.
4774589	Connection Pool statistics for maxIdleTime and reclaimedTimeout connections not captured.
4809129	Timestamp not printed in log.
4799058	All version up to iAS6.5 SP1 IIS plugin has request GX2GX error
4788127	Socket remains in CLOSE_WAIT state forever on Windows platform.
4805009	Java files with wrong names created from JSPs when run through the JSP precompiler.
4808387	Crash in failover code.
4820280	ksvradmin fails to start if Datasource entries are greater than 204 characters.
4819229	CXS process does not start, when using other than the default launcher while starting.
4797959	Sun ONE Application Server webconnector crashes when uploading file with wrong Content-Length Mime.
4828101	Issues with LDAP authentication.
4828267	Connection pool of Jconnect5.5 showing strange auto-commit behaviour.
4769407	Pre-compilation of JSPs not working.
4571019	Database connections cleanup not working for NAS 2.1 and C++ applogics.
4836387	Webconnector crashes when ServletName (web.xml)is longer than path.
4820534	EJB passivate() method throws a NullPointerException.
4764851	JSPC compilation issues during runtime.
4754456	HTTP response from JSPs contains offending CRLF right after HTTP header.
4770671	Request parameters are getting lost(except 1) when going to FBA login page.
4779207	Registered JSP pages fail to execute properly on 6.5 MU3.
4689007	Webconnector logs "info (5242): gxrequest.cpp:gxrequest()..."
4767997	Enable Dynamic Class Reloading check box gets unselected after restart.
4750058	Dsync Logging causes KXS to crash.
4761598	JDBC connection pool not releasing connection when an error occurs in db.
4711735	iPlanet Application Server 6.0 sp3 KJS not load sharing properly.
4754692	Request forwarding is not working when there is a space character in parameter
4735914	Struts template application is not formatting page properly.
4768799	The info for dynamic reloading of servlets is not shown in a log form in KJS.
4672041	MDB Durable Subscribers always create a new subscription.
4804086	Could not configure a durable topic from the deploytool during deployment.
4761319	KXS crashes when customer tries to retrieve any cached information.
4760264	Client Certificate Authentication fails with certificates from iCMS 4.2sp2.
4758869	Context is wrong after FBA with GET.
4762957	deploytool does not handle the editing of the deploy descriptors correctly.
4768669	When username is same as group name ias authorizes an invalid user to login (FBA).
4693651	Monitoring "Total Threads" does not work.
4794965	Urgent need for ias-web.xml server-info tags to work.
4640716	Cluster problems in DSYNC.
4783055	KXS core dumps in GXBuffer::Alloc().
4825234	KJS Hangs at saveSession.
4871079	KeepAliveTimeOut is measured in seconds.

Known Problems and Limitations

This section describes known problems and associated workarounds with Sun ONE Application Server, Enterprise Edition 6.5 SP1, Maintenance Update 3.


ID	Summary
4878322	Problem By default, the application server's IP address and port number will not be displayed if the application server goes down. Workaround To know the IP address and port number of the machine on which the application server went down, set the debug mode of webconnector plug-in to 2 or greater.
4892677, 4858315	Problem Redeployment of an updated version of an application does not remove the contents of the previous deployment from the file system area. In addition to leftover file system content, some of the application server registry settings are also not overwritten and/or removed as an application is redeployed.� This behavior can lead to older application settings remaining in effect after a redeploy.� Workaround To perform a clean redeployment, first perform a remove (iasdpeloy removeapp, removemodule, etc.) followed by a deploy.� To remove unnecessary entries from the file system in a much faster way, set the registry key, Application Server\6.5\Deployment\cleanup, to true before redeploying applications.
4828914	Problem unpatch utility of Sun ONE Application Server 6.5 Maintenance Update 1 inadvertently uninstalls Sun ONE Application Server 6.5 SP1 Maintenance Update 3. When you upgrade from Sun ONE Application Server 6.5 Maintenance Update 1 to Sun ONE Application Server 6.5 SP1 Maintenance Update 3, a backup directory is created for both 6.5 Maintenance Update 1(backup_1) and 6.5 SP1 Maintenance Update 3,(backup_65sp1_3). If you run the unpatch utility from the 6.5 Maintenance Update 1(backup_1), Sun ONE Application Server 6.5 SP1 Maintenance Update 3 will get uninstalled. Workaround To uninstall Sun ONE Application Server 6.5 Maintenance Update 1, make sure you run the unpatch utility from the backup_1) directory.
4805318	Problem StaticServlet does not serve internationalized document correctly. This problem will be seen by machines that does not have LANG set (mostly English countries) and that want to serve non iso-8859-1 characters (non 7-bit characters). Workaround Edit iasenv.ksh and set LC_ALL to proper language and character set. Use the format, export LC_ALL=language.charset. For example, export LC_ALL=ja_JP.PCK. Re-start the application server. Open the application in the Deployment tool. Open the Deployment Descriptor panel. Go to the NLS tab and map the required locale (in this case ja) to the charset of the HTML file. Deploy the application and access the HTML file.
4731873	Problem Struts templates are not handled properly in S1AS 6.5 Maintenance Update 2. Workaround Use the following recommended procedure to perform the flush operation. Change the chapterTemplate.jsp in the following manner using struts defined attribute for template tag. <td><template:get name='sidebar' flush='true'/></td> <td><table> <tr><td><template:get name='header' flush='true'/></td></tr> <tr><td><template:get name='content' flush='true'/></td></tr> <tr><td><template:get name='footer' flush='true'/></td></tr> </table> </td> The only addition here is flush='true' in every template:get tag which flushes the buffer before every include.
4858315	Problem Redeployment of an updated version of an application does not does not delete LDAP entries if the updated application has less registered components than previous deployments. This can leave "orphan" entries that are difficult to remove. This behavior can lead to older application settings remaining in effect after a redeploy. Workaround To perform a clean redeployment, first perform a remove followed by a deploy.

Additional Information

Useful Sun ONE information can be found at the following Internet locations:

Sun ONE release notes and other documentation - http://docs.sun.com
Sun ONE product status http://www.sun.com/service/support/software/iplanet/index.html
Sun ONE Professional Services information - http://www.sun.com/service/sunps/iplanet/
Sun ONE developer information - http://developer.iplanet.com/
Sun ONE learning solutions - http://wwws.sun.com/software/training/
Sun ONE product data sheets - http://wwws.sun.com/software/

Use of Sun ONE Application Server, Enterprise Edition is subject to the terms described in the license agreement accompanying it.

Last Updated September 11, 2003

Release Notes for SunTM ONE Application Server, Enterprise Edition