Release Notes for Sun ONE TM Application Server, Enterprise Edition

Formerly known as iPlanetTM Application Server.

Version 6.5 Service Pack 1, Maintenance Update 2 for SPARCTM/SolarisTM

Part Number: 817-3091-10

Updated June 26, 2003 

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

These release notes contain the following sections:

Installation Notes 

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

Relevant Architecture: SPARC

Relevant Operating Systems: Solaris 2.6, 8, and 9

Files included with this patch:

./ias/gxlib/libgxbindu.so
./ias/gxlib/libgxprincipal.so
./ias/gxlib/libgxreposit.so
./ias/gxlib/libjx2thread.so
./ias/gxlib/libiASApachePlugin.so
./ias/gxlib/libgxdsync_failover.so
./ias/gxlib/libgxdsync_token.so
./ias/gxlib/libgxdsync_messenger.so
./ias/gxlib/libgxagent.so
./ias/gxlib/libgxnsapi6.so
./ias/gxlib/libgxsecurity.so
./ias/gxlib/libgxorcl.so
./ias/classes/java/kfcjdk11.jar
./ias/classes/java/kadmin.jar
./ias/classes/java/buzz.jar
./ias/classes/java/jasper.jar
./ias/bin/.kas

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 is 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:

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

    8. ./applypatch

Special Install Instructions

  1. If you have not installed the "Sun ONE Application Server 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 running 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.
  4. To apply the fix for Bug Id: 4819229 please replace the following line in kjs script, located in install_dir/ias/bin directory:

    $JAVA_HOME/bin/java ${JAVA_ARGS} com.kivasoft.engine.Engine $opts

    with the following lines

    ## Start fix for bug 4819229
    d_opts=""
    mod_opts=""

    for optvar in $opts
    do

    echo $optvar |grep "^-D" >/dev/null
    if [ $? -eq 0 ]
    then
    d_opts="$d_opts $optvar"
    else
    mod_opts="$mod_opts $optvar"
    fi
    done

    if [ ! -z "$d_opts" ]
    then

    JAVA_ARGS=${JAVA_ARGS}${SPACE}$d_opts

    fi

    $JAVA_HOME/bin/java ${JAVA_ARGS} com.kivasoft.engine.Engine $mod_opts
    ## End fix for bug 4819229

Uninstallation Instructions

  1. Ensure that all webserver and application server processes have been shutdown.
  2. Ensure that the directory server is running.
  3. Become the user who had installed the application server installation for which you want to backout the patch.
  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:

    5. Example: cd /opt/appserver/ias/backup_2

    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.

    6. 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:

    7. ./unpatch

Special Uninstallation Instructions

If the installation process quits after patching some of the files, then follow these steps to restore the older files:
  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:

    4. ./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

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. Create a new entry called KeepAliveTimeOut, of type integer.
  4. Enter the value for this key 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.

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

Resolved Issues

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

Table 1    List of resolved issues 
 

Bug ID 

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

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


When you upgrade from Sun ONE Application Server 6.5 Maintenance Update 1 to Sun ONE Application Server 6.5 SP1 Maintenance Update 2, a backup directory is created for both 6.5 Maintenance Update 1(backup_1) and 6.5 SP1 Maintenance Update 2(backup_65sp1_2 for 65sp1).

If you run the unpatch utility from the 6.5 Maintenance Update 1(backup_1), Sun ONE Application Server 6.5 SP1 Maintenance Update 2 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

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

  2. Re-start the application server.

  3. Open the application in the Deployment tool.

  4. Open the Deployment Descriptor panel.

  5. Go to the NLS tab and map the required locale (in this case ja) to the charset of the HTML file.

  6. 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:

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

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

Last Updated June 26, 2003