Release Notes for SunTM ONE Application Server, Enterprise Edition 

Formerly known as iPlanetTM Application Server.

816-6373-11

Version 6.5 Service Pack 1

Updated January 7, 2004 

These release notes contain important information available at the time of the Version 6.5 SP1 release of Sun ONE Application Server, Enterprise Edition. New features and enhancements, installation notes, known problems, and other late-breaking issues are addressed here. Read this document before you begin using Sun ONE Application Server, Enterprise Edition.

Throughout this document 'Sun ONE Application Server' and 'iPlanet Application Server' have been used interchangeably and both refer to the same product.

These release notes contain the following sections:


What's New in Sun ONE Application Server, Enterprise Edition 6.5 SP1

Sun ONE Application Server, Enterprise Edition 6.5 SP1 includes enhancements described in the following sections:

JDK 1.3.1_06 Support

J2SDK 1.3.1_06 is certified to work with Sun ONE Application Server, Enterprise Edition, 6.5 SP1.

Detecting Unresponsive KJS and KXS Threads

It's now possible to detect hanging KJS and KXS threads. By default, this feature is disabled.

To Detect Hanging KJS

KJS hang detection can be enabled from the registry key: SOFTWARE/iplanet/Application Server/6.5/CCS0/conn/HangDetectEnabled . You must restart Sun ONE Application Server and the webserver to enable this change.

With the KJS hang detection enabled, KXS detects and kills the hung KJS and routes the requests to other available KJS'. KXS detects the hung KJS based on the IAS_KJS_HANG_INTERVAL environment variable value specified in iasenv.ksh. If you do not set a value for this environment variable, the default value of 5 (50 seconds) is used.

The default value of 50 seconds is arrived at by multiplying the IAS_KJS_HANG_INTERVAL value with the SOFTWARE/iplanet/Application Server/6.5/CCS0/conn/RecvTimeOut registry value.

Therefore, if KXS does not receive any reply within the specified time interval, it kills that particular KJS.

NOTE: If an application takes more than 50 seconds, you will have to configure the IAS_KJS_HANG_INTERVAL accordingly, otherwise KXS will assume that KJS is hanging and kill that KJS. Consequently, any requests running on that KJS at that time will be lost.

KXS uses the install_dir/bin/StopHungKjs.sh script to kill the hung KJS. You can insert useful commands in this script, such as taking the stack trace or sending a mail to admin, before terminating the KJS.

To Detect Hanging KXS Threads

Another new environment variable introduced in this release is IAS_KXS_HANG_INTERVAL, to detect hung KXS threads. The default value is 60 seconds, in the iasenv.sh script.

If the KXS thread is unable to deliver the request in this specified time, then it times-out and assigns the request to the another KJS.

NOTE: If the network is taking more than 60 seconds to deliver the request to KJS, then this value should be suitably changed.


Sample Application Enhancements

The following sample has been added in Sun ONE Application Server, Enterprise Edition 6.5 SP1 release:

The following Message driven samples are bundled with Sun ONE Application Server, Enterprise Edition 6.5 SP1:

The sources and documentation for the sample applications are available at <iASInstallDir/ias/ias-samples/mdb>, and  developer.iplanet.com

Product Packaging

The following products are available on the Sun ONE Application Server Enterprise Edition 6.5 SP1, product CD:


Software and Hardware Requirements

Your system must meet the following requirements before you can install Sun ONE Application Server.

Solaris

Your Solaris® system must meet the following requirements before you can install Sun ONE Application Server:
The following patches for JDK 1.3.1_04 must be applied on Solaris 8. These patches can be downloaded from the http://sunsolve.sun.com/ or http://java.sun.com/j2se/1.3/download-solaris.html

  Table 2  Required patches for Solaris 8 

Patch 

Patch Description 

108652-37  X11 6.4.1 patch 
108921-13  CDE 1.4 patch 
108940-32  Motif patch 

Other required patches:
Table 3  Required patches for Solaris 8 

Patch 

Patch Description 

108528-17  kernel update patch 
108434-04(32-bit) / 108435-04 (64-bit)  libC patch 
108827-12  SunOS 5.8: /usr/lib/libthread.so.1 patch 

In cases where a patch is listed as missing and you have a later version installed, you can ignore the warning message and continue with installation. That is, the list of missing patches contains a patch whose higher version is already installed.

For example, you have 108435-05 on your system and the list of missing patches shows 108435-04.

No additional patches are required on Solaris 9. The install script will check for missing patches and report that a number of them are not found on your system. Disregard this message and continue with the installation.

Windows

Your Microsoft Windows system must meet the following requirements before you can install  Sun ONE Application Server:

Installation Notes

This section contains late-breaking information about installing Sun ONE Application Server, Enterprise Edition, 6.5 SP1. For detailed information about installation procedures, see  iPlanet Application Server Installation Guide.

  Certified Directory Servers 

The following directory servers are certified to work with Sun ONE Application Server 6.5 SP1.
Table 4    Certified Directory Servers 
Directory Server  Version 
  Sun ONE Directory Server  5.1 SP1 (certified on Solaris 9, both bundled and unbundled versions)

5.0 SP1 (bundled with Sun ONE Application Server 6.5 SP1) 

4.13 

Certified Web Servers 

The following Web servers are certified to work with Sun ONE Application Server, Enterprise Edition 6.5 SP1.
Table 5   Certified Web Servers
Web Server 

Interface 

Sun ONE Web Server, Enterprise Edition 6.0, SP1, SP2, or 6.0.1
All versions of
Sun ONE Web Server, Enterprise Edition 6.0, SP1 or later are certified on Solaris.
NSAPI
Sun ONE Web Server Enterprise Edition 4.1, SP7 or later  NSAPI 
Microsoft Internet Information Server 4.0 (Windows NT)  ISAPI 
Microsoft Internet Information Server 5.0 (Windows 2000)  ISAPI 
Apache 1.3.19, 1.13.26 APACHEAPI 


Certified JVMs 

The following JVMs are certified to work with Sun ONE Application Server 6.5 SP1.
Table 6 Certified JVMs 

Platform 

Version 

JVM 

Windows 2000  Professional, Server, Advanced Server  JDK  1.3.1_06
Windows NT  4.0 SP6a  JDK 1.3.1_06
Solaris  2.6, 8 , 9 JDK 1.3.1_06


Certified Third Party JDBC Database Drivers 

The following Third Party JDBC drivers are certified to work with Sun ONE Application Server 6.5 SP1.

Table 7   Third party JDBC database drivers supported in 6.5 SP1 on Windows and Solaris 

Database Vendor 

JDBC Driver 

Oracle  Oracle 8.1.7 (Type 4 and Type 2), 9i 
Merant SequeLink  DataDirect Java 5.1 (all databases supported by DDJ5.1) 
Sybase  jConnect for JDBC 5.2 Type 4 
IBM DB2  IBM DB2 7.1 JDBC Client, IBM DB2 8.1.4 Type 2 Universal JDBC Driver 
Informix  Informix JDBC v2.1 Type 4 

Certified Native Type 2 Database Servers and Clients 

Sun ONE Application Server 6.5 SP1 continues to support the database clients and servers for Sun ONE Application Server Type 2 JDBC Database Drivers listed here. 
Table 8  Certified Native Type 2 database servers and clients for 6.5 SP1 

Database Server 

Database Client 

Platform 

Oracle 7.3.4, 8.0.x, 8i, 9i Oracle8i 8.1.7  Windows NT/Solaris 
Sybase 12  Sybase Open/Client System 12  Windows NT/Solaris 
DB2 7.1  DB2 6.1, 7.1  Windows NT/Solaris 
Informix 9.2  Informix SDK 2.40  Windows NT/Solaris 
Microsoft SQL Server 7, 2000  ODBC 3.51  Windows NT only (client)


Note
  • For proper functioning of the Sybase global transactions on Solaris, the following Sybase patches for client version 12.0 should be installed:
    • EBF 9651 
    • EBF 9769 

    These patches are available from the Sybase website at: www.sybase.com. 

  • On Oracle, transactions are supported on Oracle 8.1.7 or later server versions.



Upgrading to 6.5 SP1

This section describes procedures to upgrade from Sun ONE Application Server 6.5, Enterprise Edition to Sun ONE Application Server 6.5 SP1, Enterprise Edition.

The following topics are covered in this section:

Before You Start

Make sure to follow these guidelines before upgrading to 6.5 SP1:

Upgrading on Solaris Platforms

To upgrade to Sun ONE Application Server 6.5, SP1 on Solaris, perform the following steps:


Note Choose the same configuration options that you chose for the existing installation. You can make modifications to your configuration after upgrading.

  1. Ensure you have met all the conditions listed in  Software and Hardware Requirements .
  2. Run the setup program.
  3. Enter y and press Enter at the Welcome Screen.
  4. Enter y and press Enter to accept the license agreement.
  5. Select 1 to install Sun ONE Servers.
  6. Select Typical or Custom as the type of installation.
  7. Change the location of install to the same location as your current installation.
  8. Press Enter.
    The iPlanet Server Products Components screen appears.

  9. Enter 4 and press Enter to install only the iPlanet Application Server component.
  10. Make sure this is the only selected component. Do not select the other components.

  11. Select the sub-components shown in subsequent screens.
  12. Enter the fully qualified domain name ( hostname.domain.com) of the machine on which you are installing  Sun ONE Application Server.
  13. Enter the system user and system group names.
  14. Enter the Administrator ID and password for the Configuration Directory Server.
  15. When you are asked whether you want to upgrade, type y at the prompt and press Enter.
  16. Enter the Product Key.
    The product key is in the welcome letter you received with the product CD.
  17. The installation program extracts the required files and completes the upgrade process.
For more detailed information on the installation procedure, see Sun ONE Application Server Installation Guide.


Upgrading on Windows Platforms



Note

In the `Components to Install' screen, ensure to select the main components before selecting the sub-components. Some of the components may have already been selected. In such cases, de-select these components and select them again.



To upgrade to Sun ONE Application Server 6.5 SP1 on Windows, perform the following steps:

  1. Ensure you have met all the conditions listed in Software and Hardware Requirements .
  2. Run the setup program.
  3. Click Next after the Welcome screen appears.
  4. Click Yes to accept the license agreement.
  5. You must accept the License agreement to continue.

  6. Click Next to install the iPlanet Server and core components.
  7. Select Typical or Custom as the type of installation.
  8. The Setup program will automatically select the same location as your current installation. Click Next to continue.
  9. The Components to Install screen appears.

  10. Select iPlanet Application Server 6.0.
  11. Make sure this is the only selected component. Do not select the other components.

  12. Enter the configuration directory administrator ID and password
  13. Click OK when you are asked whether you want to upgrade.
  14. Confirm the configuration directory information displayed and enter the password of the user directory administrator (typically cn=Directory Manager).
  15. Enter the Product Key. The product key is in the welcome letter you received with the product CD.
  16. Click Install to complete the upgrade.
  17. For more information on the installation procedure, see Sun ONE Application Server Installation Guide


Upgrading Webless Installations

The following procedure describes how to upgrade a webless installation of Sun ONE Application Server 6.5 on both Solaris and Windows.

  1. Ensure you have met all the conditions listed in Software and Hardware Requirements .
  2. Run the setup program.
  3. Press Enter at the Welcome Screen.
  4. Accept the license agreement.
  5. Select 1 to install iPlanet Servers.
  6. Select Typical or Custom as the type of installation.
  7. Change the location of install to the same location as your current installation, and press Enter.
  8. Enter 4 and press Enter to install only the iPlanet Application Server component.
  9. Make sure this is the only selected component. Do not select the other components.
    The iPlanet Server Products Components screen appears. Depending on your previous configuration, a few options will be automatically selected. If you proceed with the selected components, the upgrade might fail at a later stage with the error message, "the installed components do not match with the selected components".

  10. De-select all automatically selected components (only on Windows).
  11. Additionally, ensure to select the main components before selecting the sub-components.

  12. Select the sub-components shown in subsequent screens, except for the Web-connector plugin.
  13. Enter the fully qualified domain name ( hostname.domain.com) of the machine on which you are installing Sun ONE Application Server.
  14. Enter the system user and system group names.
  15. Enter the Administrator ID and password for the Configuration Directory Server.
  16. When you are asked whether you want to upgrade, type y at the prompt and press Enter.
  17. Enter the Product Key.
    The product key is in the welcome letter you received with the product CD.
  18. The installation program extracts the required files and completes the upgrade process.


Upgrading Web-connector Plugin

The following procedure describes how to upgrade the Web-connector plugin on both Solaris and Windows.

  1. Ensure you have met all the conditions listed in Software and Hardware Requirements .
  2. Run the setup program on the machine where the Web-connector plugin is installed.
  3. Press Enter at the Welcome Screen.
  4. Accept the license agreement.
  5. Select 1 to install iPlanet Servers.
  6. Select Typical or Custom as the type of installation.
  7. Change the location of install to the same location as your current installation, and press Enter.
  8. Enter 4 and press Enter to install only the iPlanet Application Server component.
  9. Make sure this is the only selected component. Do not select the other components.
    The iPlanet Server Products Components screen appears. Depending on your previous configuration, a few options will be automatically selected. If you proceed with the selected components, the upgrade might fail at a later stage with the error message, "the installed components do not match with the selected components".

  10. De-select all automatically selected components (only on Windows).
  11. Additionally, ensure to select the main components before selecting the sub-components.

  12. Select the Web-connector plugin component.
  13. Ensure to de-select the other sub-components.

  14. Enter the fully qualified domain name ( hostname.domain.com) of the machine on which you are installing Sun ONE Application Server.
  15. Enter the system user and system group names.
  16. Enter the Administrator ID and password for the Configuration Directory Server.
  17. When you are asked whether you want to upgrade, type y at the prompt and press Enter.
  18. The installation program extracts the required files and completes the upgrade process.


Documentation Updates

The list of fixed documentation bugs is included in Resolved Issues.

Resolved Issues

The following table lists the critical issues resolved in Sun ONE Application Server, Enterprise Edition 6.5, SP1 release.

Table 6    List of resolved issues

Bud ID

Description

4748467

Unable remove server from a Cluster.
4749974 The default values for EJB container parameters are shown to be reset to zero in the
Admintool, however they are unchanged in the registry.
4683407 

JNI KJS crash issue: erroneous ref to JNI pointer in iPlanet Application Server crashes KJS. 

4633841 

Stress: KJS memory growth and java.lang.OutOfMemoryError 

4643711
4658566 

A call to DatasourceXmlUtil.xmlToDescriptor(String) results in NullPointerException 

4640854 

iPlanet Application Server 6.5 performance degradation. 

4680321 

A core dump occurs when a non-existing EJB is looked up from an RMI Client. 

4679952 

Could not lookup EJBs from newly created threads. 

4681292 

Access to iPlanet Application Server Ejb_jar_1_1.dtd from www.sun.com. 

4656714 

iPlanet type 2 JDBC driver does not reuse connection from the connection pool. 

4656773 

KJS core dumps when using Oracle Native Driver. 

4687490 

JMS lookup cannot be done from a rich client in iPlanet Application Server 6.5. 

4688873 

Dot in the JSP filename is recognized as a package name. 

4656352 

Cannot connect to Informix using native driver (on Solaris). 

4640817 

KJS core dumps with huge memory increase in EPE stress tests. 02/19/2002 iPlanet Application Server Build 

4690593 

Web connector will not allow resetting of GX_jst cookie. 

4671791 

iPlanet Application Server 6.5 not getting synchronized access to session data. 

4683700 

KJS hang issue: JVM unable to process session request. 

4686904 

Global transaction does not work for 3rd party drivers (type2 and 4). 

4672039 

MDBs cannot perform resource lookups in either ejbCreate or setMessageDriven.  

4670242 

DSync lock not getting handled properly. 

4640716 

Cluster problems in DSYNC, inherited from 4536411 

4546661 

Problems with declarative security. 

4632839 

Unable to reliably store data to session in SP4. 

4643419 

Failover does not happen gracefully in a clustered environment in iPlanet Application Server 6.0 SP4. 

4539309 

Deployment does not overwrite previous deployment. 

4656767 

Improper display in Help-About of Deploy Tool. 

4660405 

Cannot connect to Sybase Third Party driver (jConnect). 

4655528 

Installer shows Netscape core components. 

4679374 

i2's cX hangs on iPlanet Application Server 6.0 SP4. OutOfMemory errors thrown. 

4680325 

Admin Tool -Problem in setting EJB container parameters for Multiple KJS engines 

4684784 

While uploading large files, the file descriptor leaks. 

4688129 

URL re-writing for applogics fails when cookies are disabled. 

4688306 

Appserver unable to handle names that contain `equal to' sign. 

4688932 

RDBMS query tag is not picking up the user and password from datasource. 

4689007 

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

4689180 

JSP Caching - Session problems. 

4690776 

iPlanet Application Server returns wrong ContextPath when application.xml context-root is set. 

4691377 

Plugin fails to detect and send request to a restarted appserver instance. 

4691471 

KXS fails to detect and send requests to a running KJS-engine 

4691475 

JSP file locking problem with iPlanet Application Server 6.5 on Windows NT/2000. 

4693317 

Unable to release DB2 database connection back to connection pool. 

4622951 

File permissions should be restricted in iPlanet Application Server. 

4671477 

Support for JAXP v1.1 in iPlanet Application Server 6.5. 

4687901 

ConnectionProxy class regression in iPlanet Application Server 6.5. 

4664355 

Webconnector installation from CD throws an error. 

4697668 

Not able to access secured static pages using form based authentication. 

4699714 

Request path elements wrong for default servlet mapping.  

4654572 

Error messages shown while removing a KJS process. 

4691867 

EOL'ed JDK 1.3.1_02 ships with iPlanet Application Server 6.5. 

4651613 

For iPlanet Application Server 6.5, the number of reserved pool connections was two times more than for iPlanet Application Server 6.0 SP2. 

4541504 

The uninstallation process did not kill all the processes. 

4691066 

JNDI lookup for EJB reference name does not work in application client. 

4648003 

Some of the *.inf files shows Sun-Netscape Alliance and version as 6.0. 

4639196 

Patch verifier throws unnecessary errors. 

4639174 

db_setup doesn't validate iPlanet Application Server installation directory. 

4639076 

KJS core dumps under stress for Oracle Native Driver. 

4641661 

NASA produces error even when the database isn't registered. 

4639206 

Description is not stored in XML File for a JAR Descriptor. 

4637074 

Core dump when tried to lookup and create an Ejb Home. 

4653294 

Functionality for patch checking on Solaris 9. 

4680980 

Authentication problem using j_security_check. 

4700060 

Race condition in SQLPersistense manager prevents use of MT clients. 

4714912 

Timestamp not printed in log - Need a debug patch 

4629844 

kreg dumping core. 

4632626 

HTTPLog leaves some fields null/zero. 

4651611 

"Import Localized JSP File(s)" copies the JSP file in the wrong location. 

4667423 

iPlanet Application Server deploy command does not remove the applications from APPS folder in Win NT. 

4681782 

Keyword "default" as JSP name is not getting compiled. 

4686737 

javax.naming.NameNotFoundException in an infinite loop in RMI Client applications. 

4532069 

When uninstalling with forced silent option, install script deletes needed files. 

4535993 

Redeploy/undeploy does not remove servlet mapping from LDAP. 

4539034 

Inconsistent registry entry for Solaris and NT. 

4540054 

Impact of threading and iPlanet Application Server recommendations. 

4540888 

Need to remove old copyrights from startup sequence. 

4619973 

Warning message thrown during silent installation. 

4642101 

Inconsistent JSP compiler behavior on error cases. 

4647097 

usr directory has got wrong group and user. 

4676197 

The verify_patches script is not Solaris 9 compatible. 

4690687 

JNDI lookup throws error messages to the client but lookup works fine. 

4655813

Nametrans lookup failure while using frames with IIS.

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.

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.0se.

4664501

Inconsistent JSP cache timeout behavior.

4648744

Change not reflected when two JSPs are accessed simultaneously.

4662159

Form-Based Login: In web.xml, value is being misinterpreted.

4664267

Performance improvement in CXS.

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

(6.5)RMI - Complex objects in EJB methods throws exceptios 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).

4664742

Need to port the fix 4634092 into 6.5

4634092

Unable to control remote instance from Admin Tool (Windows NT only).

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.

4655813

Nametrans lookup failure while using frames with IIS.

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.

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, value is being misinterpreted.

4629105

java.sql.SQLException: executeQuery returned null resultset.

4664267

Performance improvement in CXS.

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

4664742

Need to port the fix 4634092 into 6.5

4634092

Unable to control remote instance from Admin Tool (Windows NT only).

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.

4655848

Sun ONE 6.5 Japanese- Problem with JSP compilation on Windows 2000.

4665988/4542727

Keeping connection open between Sun ONE Application Server and Sun ONE Web Server.

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 appserver 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 w.r.t 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()...".

4713089

SQL exceptions are thrown from wrong driver when third party jdbc driver is in use.

4725663

Stress test resulted in large KXS memory growth.


Known Problems and Limitations

This section describes known problems and associated workarounds with Sun ONE Application Server, Enterprise Edition 6.5 SP1.This information is organized into the following sections:


Installation Issues

This section describes the known Sun ONE Application Server, Enterprise Edition  6.5 SP1installation issues, and the associated workarounds.

ID  Summary 
4770316
Problem 
Webless and custom upgrades show errors due to an issue with the install program's GUI.

Workaround 
During the upgrade process, ensure to first de-select and then select the main components listed in the "iPlanet Application Server Components" screen. Next, de-select the sub-components that were not installed earlier. For more information, see iPlanet Application Server Installation Guide .

549653 
Problem 
Installation fails on Windows if Sun ONE Application Server executables are placed in a directory containing spaces or special characters. 

Workaround 
Sun ONE Application Server executables should be placed in a directory, which has no spaces or special characters. 

524125 
Problem 
In custom installation mode, at the point where the user is asked if he wants to populate the Directory Server with entries, if 'None' is chosen then no entry is created. 

After installation, connecting to the server fails since the user is not in the LDAP information. 

Workaround 
Instead of choosing 'None', the user should select the default option: 'Suggest'. 


Problem 
Creation of administrator user entry in the remote user directory fails if that directory is read-only. 
The administrator user entry must exist in the user LDAP directory for registering the server through Sun ONE Application Server Administration Tool (iASAT). 

Workaround 
To enable Sun ONE Application Server to authenticate against a remote user directory server, complete the installation and then perform the following steps: 

  1. Create an adminuser.ldif file with the following entries: 


  2. dn: uid=iasadmin., ou=People, o=iplanet.com 
    changetype: add 
    cn: Nas Administrator 
    sn: Nas Administrator 
    givenname: iAS admin 
    objectclass: top 
    objectclass: person 
    objectclass: inetorgperson 
    ou: People 
    uid: iasadmin 
    userpassword: password 

  3. Run the ladapmodify command: 

  4. < iASInstallDir /shared/bin> ldapmodify -D "cn=Directory Manager" -p < ldap_PortNo. > -w < password > -a -f adminuser.ldif. 
4632617
Problem 
iPlanet Console hangs if Sun ONE Application Server is installed in the same directory where  Sun ONE Directory Server 4.13 is installed.
This problem occurs because the JDK version used by Sun ONE Application Server and Sun ONE Directory Server 4.13 are different.


Workaround
Install Sun ONE Application Server in a different directory from the one in which iDS 4.13 is installed.


Core Server Issues

This section describes the known Sun ONE Application Server, Enterprise Edition  6.5 SP1core server issues, and the associated workarounds.
>



 
Problem
iPlanet Application Server fails to respond while running UIF + SAP + Process Manager Integration Tests.
Workaround
Rename libclntsh.so.9.0 under, $ORACLE_HOME/lib to libclntsh.so.8.0
   
   4719690
Problem
Session is not retained in a distributed application.

Workaround
Ensure that all servers participating in a cluster have the same system time and date. 

4626356;
Problem 
Administration Tool fails to connect to application server after the primary fails.
This would happen if you have a cluster set-up configured with Maxbackups=0.

If Maxbackups is specified as 0 (none), then there is no backup application server and the alternates change to the standalone state. However, when the primary comes up again, it cannot connect to the alternate as it's in standalone mode.

Workaround
When configuring a cluster, ensure that Maxbackups is 1 or more, not 0.

4753639 Problem
Issues with shared directory server.

In a non-clustered environment, where two application servers are sharing the same directory server, and each running a different instance of the same application, if an application is undeployed from one of the application servers, then requests to the other application server also fails.

This problem occurs because when application is undeployed from one of the application servers, that application's "Classdef" information is removed from the directory server. Since this directory server is shared, no other application server would be able to get the GUID of this application.

Workaround
If you have a setup where two or more application servers are sharing the same directory server, use the Sun ONE Application Server Administration Tool to disable the application, instead of undeploying it.

4719687 Problem
Cluster entries in LDAP are not deleted after uninstalling servers.

These entries, under SOFTWARE\iPlanet\Application Server\NASCluster\SyncServers, do not cause any problems and, if required, can be manually deleted.

4639210
Problem 
Transaction propagation does not work consistently.
If two KJS' are participating in a transaction and only one of them is made recoverable, then this configuration cannot lead to proper recovery.

Workaround
Ensure that in a recoverable scenario, all participant KJS' should be recoverable. Either all should be recoverable or none should be recoverable.

4633284
Problem 
When using DB2 as the database, transactions are not rolled back even though one of the application servers fails to recover from a crash.
This problem occurs due to limitations in DB2.


Workaround
If your Sun ONE Application Server installation is using DB2 as the database, then ensure that both Sun ONE Application Server and DB2 are installed on the same server.

4633274
Problem 
KJS crashes during transaction recovery, if DB2 is in an inconsistent sate.
If recovery is done when DB2 is in an inconsistent state, the recovery call to DB2 dumps core and crashes KJS.

Workaround
Disable recovery in iPlanet registry to bring up KJS again.

542273 
Problem 
The CORBA Executive Server crashes when exceptions are thrown. 
536256 
Problem 
A JSP of size larger than 185 KB cannot be executed on Sun ONE Application Server. 
560053 
Problem 
Struts applications fail when the Versioning key is enabled. 

Workaround 
Do not enable dynamic reloading. Ensure that the Versioning key is set to 1 in the registry. 

To disable dynamic reloading: 

  1. Start iPlanet Registry Editor, kregedit, and modify the Disable value under the Versioning key: SOFTWARE/iplanet/Application Server/6.0/CCS0/SYSTEM_JAVA/Versioning 
  2. Set the Disable value to 1 
  3. Restart Sun ONE Application Server to enable the change. 
557991 
Problem 
On Windows, the security principal class is not invoked automatically when security is enabled for RMI/IIOP based applications. 

Workaround 
Before running RMI/IIOP based applications, the org.omg.CORBA.ORBClass property value should be changed to com.netscape.ejb.client.ClientORB in the orb.properties file under iASInstDir /ias/usr/java/jre/lib

For example, org.omg.CORBA.ORBClass=com.netscape.ejb.client.ClientORB

-
Problem 
For distributed sessions, a negative value for setMaxInactiveInterval() will make the session timeout immediately. 

Workaround 
Pass a very high value as an argument to setMaxInactiveInterval().  

4539468
Problem 
In certain cases, IMQ as the JMS will not work on Solaris.

Workaround 
Go to iASInstallDir/ias/env directory and open iasenv.ksh file. Check whether jmq.jar and jmqadmin.jar are in the CLASSPATH. If not, add them to the end of the CLASSPATH settings.
Stop and restart Sun ONE Application Server. The iMQ classes will now be in the server environment.


Deployment Tool Issues

This section describes the known iPlanet Application Server, Enterprise Edition  6.5 SP1 Deployment Tool issues, and the associated workarounds.

ID  Summary 
537872 
Problem 
Libthread panic error while opening large application files on Solaris. 

Workaround 
Change the File Descriptor setting in the UNIX environment file using the ulimit command. Set the File Descriptor limit to a number greater than the number of files contained in the ear/war/jar file. 

For example, if a war file contains 970 files, set the File Descriptor limit to 1000: 
ulimit -n 1000 

548426 
Problem 
Redeployment of an updated version of an application does not remove the contents of the previous deployment from the file system area of the application area. The default location of deployed files is install_dir/ias/APPS/modules/module_name/ or APPS/ear_name/module_name/

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 followed by a deploy. 

537084  Problem 
If Sun ONE Application Server is installed as root on a machine using the custom installation, the deploytool (DT) is not accessible by other uses to create applications on Solaris platforms. 

Workaround 
If a user "A" has installed app server and ALL its components, then any other user "B" needs following permissions in order to run the Deploy Tool properly (note that iasdir refers to the installation location of  Sun ONE Application Server): 

  1. DT reads/writes in iasdir/registry/reg.dat. Make sure that directory, iasdir/ias/registry has ALL permissions for user "B". 
  2. Deploy Tool writes its temporary xml files from descriptors, EJB skels and stubs into, iasdir/ias/tmp . Make sure that user "B" has WRITE permissions to this directory. 
  3. Deploy Tool writes its preferences into "iasdir/ias/dt". If user "B" needs to save the preferences, this directory needs to be WRITABLE by user "B". This permission is not critical for normal functioning of Deploy Tool. 
  4. User "B" needs to have READ and EXECUTE permissions to many other directories/files as Deploy Tool loads/runs scripts/executables/executable jars/libs/dlls, and so on from iasdir/ias/bin , iasdir/ias/lib , iasdir/ias/java/classes (on Unix platforms) and others. 
  5. As an additional precaution, user "B" needs to have WRITE permission to the directory where the app/module being opened resides on file system. For example, bank.ear resides in iasdir/ias/ias-samples/bank. Consequently, that directory should be WRITABLE. 

Database Support Issues

This section describes the known Sun ONE Application Server, Enterprise Edition 6.5 SP1 database support issues, and the associated workarounds.

ID  Summary 
4639241
Problem 
Vendor specific parameters, such as global connection, servername, databasename, ifxinformixhost, etc., are not saved when datasource is registered using XML file.

Workaround 
The vendor-specific property cannot be specified using Sun ONE Application Server 6.0 SPx XML files. You cannot mix parameters between the old and new XML files.
Register the datasource using the new XML file.

PointBase Database Installation (Solaris Platforms) 
Problem 
The PointBase database installation requires access to the X Windowing System environment. If you are installing the pointbase database with the application server, the installation should have access to an X Windowing System. If there is no access to the X Windows environment, the PointBase database server will fail to start-up on that machine.

Workaround 
When you attempt to install the Pointbase Database, you must have access to an X Windowing System Server, and in particular, have the DISPLAY environment variable set to point to that accessable server.

If the DISPLAY variable is set incorrectly, Sun ONE Application Server post installation commands fail. 

4625632 
Problem 
Unable to use Oracle 9i client libraries through iPlanet Type 2 Native Driver. 
Workaround 
Rename libclntsh.so.9.0 under, $ORACLE_HOME/lib to libclntsh.so.8.0
4643903 
Problem 
On Solaris platforms, you will be unable to use the Oracle OCI driver if it has been registered under External JDBC Driver , through the Administration Tool. 
Workaround 
Ensure that $ORACLE_HOME is set in the iasenv.ksh script, under iASInstallDir /ias/env directory. 

Sample Application Issues

This section describes the known Sun ONE Application Server, Enterprise Edition 6.5 SP1 sample application issues, and the associated workarounds.


ID  Summary 
4640249 
Problem
Session distribution of soap web application does not work as per sample application documentation.

Workaround
In the soap-install.html file, under "Deploy the Apache SOAP Web Application" the third point should read:
Select the WAR file from the list of Web Applications. Right-click and select Edit Descriptor from the pop-up menu. In the iAS tab, click the Distributed Session button so that it is unselected and click the Local Data Synchronization radio button so that it is selected. Since the Apache SOAP implementation stores non-serializable objects in user session, this step is required to disable session synchronization for the SOAP web application. Close the deployment descriptor window and be sure to save its contents.

549549
Problem
Samples fail after recreating tables in PointBase. 

Several of the J2EE Developer's Guide samples require that you to recreate the database tables before executing the samples a second time. If you use the SQL files provided to recreate the tables without restarting the application server, several of the J2EE Developer's Guide samples will fail. 

Workaround
For those samples that require recreation of database tables before running the samples a second time, restart Sun ONE Application Server after recreating the tables. 
 

548418
Problem
"Inserted value too large for column" errors when using Bank application. 

Workaround
Avoid using special characters or ` - ' for SSN or Phone number fields. Do not enter more than two letters for the State field and not more than four letters for the Prefix field. 
 

558611
Problem
Cannot create new customer in Bank Application with the same SSN of a deleted customer. 

The Bank Application does not correctly update tables in the database, and therefore you cannot create a new customer with same SSN. 

548861
Problem
iPlanet Type 2 Native Drivers for Sybase gives errors with JPS 1.1.2. 

Workaround
Use a Sybase Type 4 driver to exercise JPS 1.1.2 with Sybase. The sample has been tested with the Sybase jConnect type 4 driver.
 

549374
Problem
The setup_syb.bat and setup_syb.sh scripts for the Transactions sample will not execute. 

Workaround 
The path to isql in the script is wrong. Open the script with a text editor. Search and replace SYBASE/bin/isql with SYBASE/OCS-12_0/bin/isql
 

550427
Problem
Documentation error in the J2EEGuide sample. 
In the chapter "Currency Converter EJB", the third point under "Assemble EAR File", the value of the context root of the web application, is incorrectly mentioned as j2eeguide-confirmer

Workaround
Replace j2eeguide-confirmer with j2eeguide-converter
 

-
Problem
Documentation error in the Bank sample. 
Under the "Create bank.war Module" > "Modify Web Application Descriptor" topic, the login information in the "Security Tab" point is incorrect. 

Workaround
When assembling the Bank sample application from scratch, the two lines for BankUser and BankAdmin have to placed together on one line. 
 

545753
Problem
Search functionality does not work when using JPS 1.1.2 with PointBase. 
Search functions do not work in JPS 1.1.2 when using the bundled PointBase database engine as the current version of PointBase bundled with Sun ONE Application Server 6.0 SP4 does not support subqueries. 
560667
Problem
Exception while running l10n application 
An exception is thrown when the user logs in as restaurant owner. 
562432
Problem
Hot deployment of Petstore Application throws exception. 

Workaround
1) Disable dynamic reloading, or 
2) Avoid making changes to the application when dynamic reloading is enabled. 

-
Problem 
When Sun ONE Application Server is installed with Microsoft IIS Webserver running on port number other than 80, the shortcut link for Sample Application will not work. 

Workaround 
Change the port number from 80 to the port number being used by IIS in the path-property for that shortcut. 


Documentation Issues

This section describes the known Sun ONE Application Server, Enterprise Edition 6.5 SP1 documentation issues, and the associated workarounds.
ID  Summary 

How to Report Problems

If you have problems with Sun ONE Application Server, Enterprise Edition,6.5 SP1 contact Sun ONE customer support using one of the following reporting mechanisms: To assist you in the best possible way to resolve your problems, please have the following information available when you contact support:


Additional Information

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

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

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

Last Updated January 15, 2004