Sun Java System Active Server Pages 4.0.2 Release Notes

Sun Java™ System Active Server Pages Release Notes

Version 4.0.2

February 2005

Part Number 819-0911-10

These release notes contain important information available at the time of release of Sun Java™ System Active Server Pages 4.0.2 (formerly Sun™ ONE Active Server Pages and Sun Chili!Soft ASP). The release notes also contain installation instructions and information that will help you get started. Be sure to read this document before you begin using the product.

These release notes contain the following sections:


New in This Release

Sun Java System Active Server Pages (also referred to as Sun Java System ASP) is a platform-independent implementation of ASP technology. Sun Java System ASP 4.0.2 includes the following enhancements:


Product Notes

Please note the following:


System Requirements

This section lists the hardware and software requirements for installing and running Sun Java System ASP 4.0.2. This section contains the following topics:

UNIX Requirements

This section lists the installation requirements for Sun Java System ASP 4.0.2 for UNIX. This section contains the following topics:

Supported Platforms

Sun Java System ASP 4.0.2 for UNIX can be installed on UNIX and Linux. The following table lists the supported platforms.

Table 1  Supported Platforms for Sun Java System ASP for UNIX

Operating System

Processor         

Minimum Memory

Minimum Free
Disk Space

Solaris 8, 9

SPARC

512 MB RAM

200 MB

Solaris 9

AMD/Intel x86

512 MB RAM

200 MB

Solaris 10

SPARC

512 MB RAM

200 MB

Solaris 10

AMD/Intel x86

512 MB RAM

200 MB

Red Hat Enterprise Linux 2.1*, 3.0

* See Product Notes

AMD/Intel x86

512 MB RAM

200 MB

HP-UX 11i

PA-RISC only

512 MB

200 MB

AIX 5.1, 5.2

PowerPC only

512 MB

200 MB

Patches

For optimal performance it is recommended that you update your operating system with the latest applicable patches. For UNIX platforms, the patch level should be the same as that applied for JDK 1.4.2_06.

Patch information is listed by platform:

Solaris Patches

For the Solaris platform, the recommended patch list can be found at
http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/J2SE

HP-UX Patches

For the HP-UX platform, the recommended patch list can be found at
http://www.hp.com/products1/unix/java/patches/index.html

AIX Patches

For the AIX platform, the following maintenance packages are recommended:

AIX 5.1

5100-04 (APAR IY44478)

AIX 5.2

5200-01 (APAR IY44479)

Web Server

You must be using one of the following Web servers:


Note

Sun Java System ASP may install to other versions of the supported Web servers listed above. However, versions not listed have not been certified to run with Sun Java System ASP and their use is not supported by Customer Support. Zeus Web servers are not supported in this release of Sun Java System ASP.


Windows Requirements

This section lists the installation requirements for Sun Java System ASP 4.0.2 for Windows. This section contains the following topics:

Supported Platforms

The following table lists the supported platforms for Sun Java System ASP 4.0.2 for Windows.

Table 2  Supported Platforms for Sun Java System ASP for Windows

Operating System

Processor         

Minimum Memory

Minimum Free
Disk Space

Windows 2000 SP4

AMD/Intel x86

256 MB RAM

100 MB

Windows XP Pro

AMD/Intel x86

512 MB RAM

100 MB

Windows 2003 Server

AMD/Intel x86

512 MB RAM

100 MB

Web Server

You must be using one of the following Web servers:


Note

Sun Java System ASP may install to other versions of the supported Web servers listed above. However, versions not listed have not been certified to run with Sun Java System ASP and their use is not supported by Customer Support. Zeus Web servers are not supported in this release of Sun Java System ASP.



Installing Sun Java System ASP

This section describes how to install Sun Java System ASP. This section contains the following topics:

Installing Sun Java System ASP on UNIX

The setup program takes you through the steps required to install Sun Java System ASP. During installation you have many options to accept default configuration settings or to specify your own. The setup program installs the following components on the target Web server:


Note

If you are upgrading an existing installation of Sun Java System ASP, review Upgrading an Existing Installation before beginning your installation.


This section contains the following topics:

Before You Install

Before starting your installation, make sure you meet the following requirements:

Installation Steps

To install Sun Java System ASP on UNIX

  1. If you are installing Sun Java System ASP from the CD-ROM, go to Step 2. If you are downloading Sun Java System ASP from the Web, download the file for your platform to a temporary directory and then extract the installation files using the following command:
  2. tar -xvf <name>.tar

    This step creates a temporary directory, which can be deleted after completing the installation.

  3. Run the install.sh script with the following command:
  4. ./install.sh

    For downloaded versions, this script is located in the temporary directory you created in the previous step. For CD-ROM versions, this script is located on your installation CD-ROM.

  5. Review the End-User License Agreement (EULA) that displays. Type 'yes' if you agree with its conditions. You must type the entire word, y-e-s.
    -or-
    Type 'no' if you do not agree. The Sun Java System ASP setup program quits the installation.
  6. Press Enter to accept the default Sun Java System ASP installation directory (/opt/casp). The installation files will then be extracted.
    - or -
    Enter the absolute path name of a different installation directory. Make note of this location so you can easily find the Sun Java System ASP files at a later time. To upgrade from a previous version of the product, you must specify the installation directory of your existing installation.
  7. If the setup program detects a previous installation of Sun Java System ASP in the specified directory, you will be prompted to uninstall the previous version. If a previous installation is not detected, you will go to the next step. Make your selection and then follow the prompts.
  8. Press Enter to accept the default language (English - United States).
    - or -
    Enter the number of a language shown in the list.
  9. Specify the desired search option for choosing the Web server to configure with Sun Java System ASP, then follow the prompts for your selection.
  10. After selecting and verifying information about the Web server, choose a configuration option for the ASP Server, and then follow the prompts for your selection.
  11. Select a configuration option for the Administration Console, and then follow the prompts for your selection. If you choose the default configuration option (recommended), the user name is specified as 'admin' and the password as 'root.' To protect the security of your server, change these from the defaults as soon as possible, as described in Using the Administration Console > Configuring Usernames and Passwords in the product documentation.
  12. Review and make note of the summary information provided for your Sun Java System ASP Administration Console configuration. It is recommended that you print this information for future reference. When finished, press Enter for product verification and to complete the installation. An installation summary file containing important information about your installation is located in:
  13. [INSTALL_DIR]/logs/install_summary

    where [INSTALL_DIR] is the directory in which you installed Sun Java System ASP (/opt/casp by default). Print the install_summary file for future reference.

  14. If you are upgrading from a previous version of the product, you will be prompted to import the previous settings into your new installation. Follow the prompts as desired. If you choose to import previous settings, the settings will be imported, the ASP server and Web server will be restarted, and you will be notified whether the import succeeded or failed.

After You Install

Before running your installation, review the following information:

Installing Sun Java System ASP on Windows

The setup program takes you through the steps required to install Sun Java System ASP 4.0.2 for Windows. All configuration is performed during installation. The setup program installs the following components on the target Web server.


Note

The Sun Java System ASP Administration Console is NOT available on Windows.


This section contains the following topics:

Before You Install

Before starting your installation, make sure you meet the following requirements:

Installation Steps

To install Sun Java System ASP on Windows

You must uninstall any previous installations of this product before installing Sun Java System ASP 4.0.2.

  1. Launch the setup program:
  2. If you are installing Sun Java System ASP from a CD-ROM, insert the CD-ROM into the CD-ROM drive. If the setup program does not start automatically, double-click the setup file located on the CD-ROM.
    - or -
    If you are downloading Sun Java System ASP from the Web, download the installation file for Windows, and then double-click the file.

  3. Perform the step-by-step installation, as prompted by the setup program.
  4. After the installation of Sun Java System ASP is finished and you have restarted your computer, restart the Web server that was configured to run with Sun Java System ASP.

After You Install

Before running your installation, review the following information:


Upgrading an Existing Installation

On UNIX platforms, Sun Java System ASP automatically upgrades many of your settings from an existing 3.6.2 or 4.0.1 installation of the product. To perform an upgrade to Sun Java System ASP 4.0.2, review the information listed below and take any necessary steps. Then follow the instructions in Installing Sun Java System ASP. During the installation, you will be prompted to import your settings.


Note

This information applies to UNIX platforms only. Migration is not supported on Windows platforms.



Caution

The new installation will completely overwrite your existing installation. If your current Sun Java System ASP installation directory contains any items you want to preserve, copy them to another location or they will be lost. Be sure to back up your existing installation before beginning the upgrade.


When the setup program has completed the installation, do the following:


Uninstalling Sun Java System ASP

This section describes how to uninstall Sun Java System ASP on UNIX and Windows platforms:

To uninstall Sun Java System ASP on UNIX

On UNIX, Sun Java System ASP is uninstalled by running the script named uninstall located in the Sun Java System ASP installation directory (/opt/casp by default). When you run the uninstall program, you can delete all directories and files contained in the installation directory. Before running the uninstall program, make copies of any files contained under this directory that you do not want to lose. To perform this procedure you must be logged in as root on the computer running Sun Java System ASP.

  1. From the Sun Java System ASP installation directory, enter the following at the command prompt:
  2. ./uninstall

  3. Choose the number of the desired uninstall method:
  4. Choose '1. Uninstall the entire product' to remove all Sun Java System ASP components and all files and directories under the installation directory. If you choose this option, go to Step 5.
    - or -
    Choose '2. Perform a stage-based uninstall' to select the components to uninstall. If you choose this option, go to Step 3.
    - or -
    Choose '3. Cancel the uninstall' to stop the uninstall without removing any files.

  5. If you chose option '2. Perform a stage-based uninstall,' you are prompted to select the components to uninstall. At the prompts, enter the number of the component(s) you want removed.
  6. After making your specifications in Step 3, you will then be given the option to uninstall the Web server-Sun Java System ASP association. Respond to the prompts as desired, choosing to either proceed with or cancel the uninstall.
  7. Delete the directories and files in the Sun Java System ASP installation directory.

To uninstall Sun Java System ASP on Windows


Product Documentation

In addition to these release notes, Sun Java System ASP also includes an Administrator and Developer’s Guide that provides detailed information about configuring, managing, and using Sun Java System ASP. The guide also provides reference information about using scripting languages, connecting to databases, and developing and using components.

The Administrator and Developer’s Guide can be found at:
http://docs.sun.com/app/docs/prod/s1.activesrver

After you’ve accessed the 4.0.2 collection and located the Administrator and Developer’s Guide, do one of the following:

You can also access the documentation in other ways:


Resolved Issues in Sun Java System ASP 4.0.2

The following table lists the most important issues resolved in Sun Java System ASP 4.0.2 release:

Table 3  Resolved Issues in Sun Java System ASP 4.0.2

Problem ID

Description

4866826

VBScript error on self-assignment of variable. The variable assignment foo = foo incorrectly caused foo's value to be destroyed.

4872092

RecordSet properties conflict with field names. The following two cases were erroneously behaving the same: myRecordSet("State") and myRecordSet.State.

4872116

Virtual host list truncation. When the list of virtual hosts exceeded a certain length, it was truncated at that point.

4873437

Response.Cookies.Expires gives Type Mismatch error when passed a string containing a validly formatted date.

4879323

VBScript Split function did not create trailing empty elements when last character of the input string was a delimiter character.

4929078

A RecordSet object's default property with NULL value would cause Response.Write to error-out incorrectly.

4929094

Replace function fails when called more than 128 times.

4967340

On Windows, ASP exits when users log off the system.

4978332

Apache 2.0 virtual hosts do not support setting user/group id to something other than the ids under which the main Apache server is running. This is a change from the Apache 1.x series. To work around this problem, Apache 2.x virtual host blocks can now contain ASPUser=<uid> and ASPGroup=<gid> to set the user and group id values under which the virtual host's requests will execute.

4978334

Interrupted or failed install procedures now give users the option to leave the partial install. This allows users to examine any error messages in the installation logs.

4997325

VBScript for ... step <increment value> worked incorrectly on Solaris (SPARC). Specifically, the loop always exited immediately after the first iteration when step <increment value> was specified, whereas loops without step worked correctly. Both now work as expected.

5012510

Fails to install on Windows Server 2003 Enterprise Edition.

5012512

Admin Web server fails to start on Red Hat Linux Advanced Server 3.0.

5040097

Custom 404 Error Directive not recognized by the ASP engine.

5040871

500 Error when trying to access ASP updates.

No ID

Response.charset not correctly appending its values to the content-type line for text/html.


How to Report Problems and Provide Feedback

If you have problems with Sun Java System ASP, contact Sun customer support using one of the following mechanisms:

So that we can best assist you in resolving problems, please have the following information available when you contact support:

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Send your comments to Sun using the "Send comments" link at
http://docs.sun.com/

Please include identifying information with your comments, such as the book’s part number and title.


Additional Sun Resources

Useful information can be found at the following locations:


Copyright 2005 Sun Microsystems, Inc. All rights reserved.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Use is subject to license terms. Portions may be derived from Berkeley BSD systems, licensed from U. of CA. Sun, Sun Microsystems, the Sun logo, Sun ONE, iPlanet, Solaris, SPARC, Java, the Java Coffee Cup logo, J2EE, J2SE, JavaServer Pages, JSP, Java Naming and Directory Interface, JDBC, and NetBeans are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.