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

Version 6.5, Maintenance Update 3 for SPARC^TM/Solaris^TM

Part Number: 816-6436-10

Updated August 26, 2002

---

These release notes contain the following sections:

• Installation Notes
• Special Instructions
• Resolved Issues
• Additional Information

Installation Notes

---

Relevant Architecture: SPARC

Relevant Operating Systems: Solaris 2.6, 8, and 9

Files included with this patch:

./ias/bin/.kas
./ias/gxlib/libgxsyb2.so
./ias/gxlib/libiASApachePlugin.so
./ias/gxlib/libgxdsync.so
./ias/gxlib/libgxdsync_token.so
./ias/gxlib/libgxdsync_timeout.so
./ias/gxlib/libgxutil.so
./ias/gxlib/libjx2principal2.so
./ias/gxlib/libgxnsapi6.so
./ias/gxlib/libgxagent.so
./ias/gxlib/libgxnsapicli.so
./ias/gxlib/libgxconn.so
./ias/gxlib/libgxsession.so
./ias/classes/java/kfcjdk11.jar
./ias/classes/java/iasacc.jar
./ias/classes/java/buzz.jar
./ias/classes/java/tomcat/jasper.jar

Installation Instructions

1. Ensure that all application server processes have been shutdown.

2. Ensure that the directory server is running.

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

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

5. Change the working directory to the directory containing the patch.

6. Set the environment variable GX_ROOTDIR to the directory where you have installed Sun ONE Application Server:

   Example: for Bourne shell

   GX_ROOTDIR=/opt/appserver/ias; export GX_ROOTDIR

   Example: for Korn shell and BASH

   export GX_ROOTDIR=/opt/appserver/ias

   Example: for C shell

   setenv GX_ROOTDIR /opt/appserver/ias

7. Apply the Update by typing:

   ./applypatch

Special Install Instructions

1. If you have not installed the "Sun ONE Application Server Core Server Component", "PointBase Database Server", and the "Web Connector plug-in Component", then set the environment variable SPECIAL_INSTALL_OPTS to -i before you run applypatch in Step 6, Installation Instructions.

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

3. If you are running Rich clients, make sure to copy the modified install_dir/ias/classes/java/iasacc.jar file to the directory where the Rich client is installed.

Uninstallation Instructions

1. Become the user who had installed the application server installation for which you want to backout the patch.

2. Ensure that all webserver and application server processes have been shutdown.

3. Ensure that the directory server is running.

4. 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 /opt/appserver/ias/backup_1

   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.

5. If you want all the files in the backup directory to be removed after uninstalling Maintenance Update 3, set the REMOVE_BACKUPFILES environment variable to 1.

   Example: for Bourne shell

   REMOVE_BACKUPFILES=1; export REMOVE_BACKUPFILES

   Example: for Korn shell and BASH

   export REMOVE_BACKUPFILES=1

   Example: for C shell

   setenv REMOVE_BACKUPFILES 1

   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.

6. Uninstall the Update by typing:

   ./unpatch

Special Uninstallation Instructions

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

2. Give execute permission to the file, unpatch

3. Run the following command:

   ./unpatch

   This command will restore the files that were patched.

Note: If you are running Rich clients, after uninstalling the patch, make sure to copy the older install_dir/ias/classes/java/iasacc.jar file to the directory where the Rich client is installed.

Special Instructions

Firewall Time-outs

Workaround:

1. Open the registry editor by running the command, kregedit
2. Go to Application Server\6.5\CCSO\HTTPAPI.
3. Create a new entry called KeepAliveTimeOut, of type integer.

4. Enter the value for this key in milliseconds, which could be equal to the default TCP/IP timeout value of the firewall, or equal to the number of milliseconds for the firewall to timeout.

This value represents the number of milliseconds the plugin will wait for inactivity after the first request, and keep sending messages at the KeepAliveTimeOut intervals to keep the connection between the web server plugin and KXS process of the application server alive.

Resolved Issues

Table 1    List of resolved issues

Bug ID	Description
4656570	The form authentication login page is not shown when accessed with POST method.
4656564	Form authentication does not work with GET method.
4550126	ias-cmp with long file names does not perform the lookup and resolve the reference.
4636443	Entity bean callback in ejbRemove throws NoSuchEntityException.
4545862	You cannot monitor more than 1 NAS server per computer with SNMP.
4648579/4641862	Invoking business method in ejbRemove() throws PersistenceException.
4526316	FBA - url parameters are not passed to error page.
4659863	DriverManager.getDriver(url) always returns com.netscape.server.jdbc.Driver.
4640628	HttpBindingListener problems in 6.0SP4, 6.5 and 7.0 SE.
4664501	Inconsistent JSP cache timeout behavior.
4648744	Change not reflected when two JSPs are accessed simultaneously.
4662159	Form-Based Login: In web.xml, form-error page value is being misinterpreted.
4664267	Performance improvement in CXS.
4629105	java.sql.SQLException: executeQuery returned null resultset.
4631477	Sybase - stored procedure always returns 0 as output parameter.
4666165	Webconnector configure with Apache server stops writing to access logs.
4666328	Sun ONE Application Server 6.5 throws "Print Writer in use" if it is running in i18n mode.
4665167	RMI - Complex objects in EJB methods throws exceptions with multiple KJS eng.
4660828	Sun ONE Application Server crashed after running 12 hours (approximately).
4668469	Sessions are not timing out from last accessed time.
4607509	Session can be accessed after expiry (timeout).
4660289	RequestDispatcher.include & Declarative Security: InvalidStateException.
4670381	DataSourceImp in Sun ONE Application Server is not serializable.
4673685	Regression: Session Invalidation is not working.
4679265	Specification Violation in 6.5 for Certificate handling.
4696746	KJS crashes while running User Benchmark Stress test using iPM.
4683700	KJS hang issue: JVM unable to process session request.
4643711	Rapid memory growth in KJS.
4653824	500 simultaneous users, 3 times performance degradation for DB search.
4652612	Security in webconnector plugin.
4539234	Deployment tool gives a misleading message in the deploy window even when the deployment tool fails to deploy successfully.
4687707	Exception throws from getAttributeNamesInScopt() method in PageContext.
4665988/4542727	Keeping connection open between iAS and iWS.
4667476	Sun ONE + jConnect 5.2 causes SQL Exception - "SET CHAINED command not allowed".
4537060/4678626	Sun ONE Application Server is not load balancing properly in a cluster after an app server restart.
4677382/4667562	Garbled <input> tag seen in hidden field being passed to the browser.
4665505	Webconnector crashes when number of characters are less than 5 in SSL_APP_PREFIX.
4672039	MDBs cannot perform resource lookups in either ejbCreate or setMessageDriven.
4538213	iASDT prompts for saving, even if you have not changed anything in ear file.
4626157	Application session hangs in SP4; was working fine in SP3.
4682811	Frame based application resulting in ConcurrentModificationException after apply.
4690245/4668522	Session object is losing data when accessed from two frames at the same time.
4688129	URL re-writing for applogics fails when cookies are disabled.
4688873	Dot in JSP filename is recognized as a package name.
4691475	JSP file locking problem with Sun ONE Application Server 6.5.
4702779	setMaxInactiveInterval API is ineffective wrt session timeout.
4537553	HttpSession.invalidate() does not invalidate the session the first time.
4537595	JSP cache size in Admin Tool.
4693291	Using Apache Web server: cgi applications do not work after loading Apache plugin.
4699714	Request path elements wrong for default servlet mapping "/".
4691066	JNDI lookup for EJB reference name does not work in client application.
4709124	Classloading problems with primitive data type for n (n>1) dimensional arrays.
4712157	Session cookies are overwritten prematurely while working with multiple apps.
4689007/4658510	Webconnector logs "info (5242): gxrequest.cpp: gxrequest()...".
4725663	Stress test resulted in large KXS memory growth.

Additional Information

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

Copyright © 2002 Sun Microsystems, Inc. All rights reserved.

Last Updated August 26, 2002