test

Sun Java System Active Server Pages 4.0.3 Release Notes

Chapter 1 Sun Java System Active Server Pages Release Notes

These release notes contain important information available at the time of release of Sun Java™ System Active Server Pages 4.0.3 (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:

What's New in This Release

Features and Enhancements in ASP 4.0.2

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.3 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.3. This section contains the following topics:

UNIX Requirements

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

Supported Platforms

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

Table 1–1 Supported Platforms for Sun Java System ASP 4.0.3 for UNIX

Operating System  

Processor 

Minimum Memory 

Minimum FreeDisk Space 

Solaris 8, 9 

SPARC 

512 MB RAM 

250 MB 

Solaris 9 

AMD/Intel x86 

512 MB RAM 

250 MB 

Solaris 10 

SPARC 

512 MB RAM 

250 MB 

Solaris 10 

AMD/Intel x86 

512 MB RAM 

250 MB 

Red Hat Enterprise Linux 3.0 and 4.0 

* See Product Notes

AMD/Intel x86 

512 MB RAM 

250 MB 

HP-UX 11i 

PA-RISC 2.0 only 

512 MB RAM 

250 MB 

AIX 5.1, 5.2 and 5.3 

* See Product Notes

PowerPC only 

512 MB RAM 

250 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_16 or higher.

Patch information is listed by platform:

Solaris Patches

For the Solaris platform, the recommended patch list can be found at http://sunsolve.sun.com/show.do?target=patches/JavaSE

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

AIX 5.2

AIX 5.3

Web Server

The following Web Servers are certified for the ASP 4.0.3 release.

Windows Requirements

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

Supported Platforms

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

Table 1–2 Supported Platforms for Sun Java System ASP 4.0.3 for Windows

Operating System 

Processor 

Minimum Memory 

Minimum FreeDisk Space 

Windows 2000 Professional, Windows 2000 Advanced Server SP4  

AMD/Intel x86 

512 MB RAM 

250 MB 

Windows XP SP2 Professional 

AMD/Intel x86 

512 MB RAM 

250 MB 

Windows Server 2003 Enterprise Edition SP1 or above 

AMD/Intel x86 

512 MB RAM 

250 MB 

Installing Sun Java System Active Server Pages

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

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

    gunzip -c <name.tar.gz> | tar xvf —This step creates a temporary directory, which can be deleted after completing the installation.

  2. Run the install.sh script with the following command:

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

  3. Review the End-User License Agreement (EULA) that displays. Type ’yes’ if you agree with its conditions. You must type the entire word, yes.-or-Type ’no’ if you do not agree. The Sun Java System ASP setup program quits the installation.

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

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

  6. Press Enter to accept the default language (English - United States). - or - Enter the number of a language shown in the list.

  7. Specify the desired search option for choosing the Web server to configure with Sun Java System ASP, then follow the prompts for your selection.

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

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

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

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

  11. 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.3 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

ProcedureTo install Sun Java System ASP on Windows

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

  1. Launch the setup program:

    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.

  2. Perform the step-by-step installation, as prompted by the setup program.

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

Note –

Do not make any changes to the INSTALL, SYSFILES, or REGLIST settings.

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.2 installation of the product. To perform an upgrade to Sun Java System ASP 4.0.3, review the information listed below and take any necessary steps. Then follow the instructions in Installing Sun Java System Active Server Pages. 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.

Note –

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:

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

    ./uninstall

  2. Choose the number of the desired uninstall method:

    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.

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

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

  5. Delete the directories and files in the Sun Java System ASP installation directory.

ProcedureTo uninstall Sun Java System ASP on Windows

  1. Use the Add/Remove Programs option from the Control Panel, or launch the uninstall program from Start > Programs > Sun Java System ASP.

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/asp#hic

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

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

Table 1–3 Resolved Issues in Sun Java Systems ASP 4.0.3

Problem ID 

Description 

6238357 

ASP 4.0.2 does not support DSN connection with MS SQL Server 7 or 2000. 

6239314 

Web Server core gets dumped, when accessing the caspsamp/diag/server.asp resource.

6318716 

HTTP header containing quotes causes issue, when retrieving other header data through an ASP 

6340680 

Warning message is displayed when the user tries to attach a file. 

6363037 

Custom 404 Error Directive does not work with ASP 4.0.2 Windows version. 

6375404 

CLI scripts displays the unable to find default run level error 

6380949 

ChiliBean does not wok on ASP 4.0.2 Windows version. 

6380954 

Binaries missing from Windows installation bundle. 

6392482 

The log.cnfg file is called many times for each request.

6402629 

The dispint.h header file is not found in ASP 4.0.2

6442631 

Unable to install ASP 4.0.2 after uninstalling the earlier version of ASP. 

6463759 

Multiple vulnerabilities in ASP 4.0.2 administration server that uses Apache. 

6529288 

Unable to install ASP 4.0.2 on Windows, when system32/Tag/*. files are present in the system.

6542849 

HTTPd crashes when the ASP service is enabled for Apache. 

6550891 

Multiple vulnerabilities in ASP server might lead to execution of arbitrary code. 

6556637 

Vulnerabilities in ASP Server may lead to escalation of privileges. 

6577838 

An incorrect response status (200 vs 30x) is returned with Response.Redirect under Apache/2.0.58 (UNIX) DAV/2 Sun ONE ASP 4.0.2, which causes applications to fail.

6588868 

Need to provide migration support from ASP 4.0.2 to 4.0.3. 

6589845 

ASP 4.0.3 need to support Sun Java System 7.0 Web server. 

6590355 

Remove the incorrect README file from the admin directory. 

6590361 

Buffer overflow vulnerability in ASP. 

6593033 

ASP 4.0.3 need to support Apache 2.2 releases. 

6594286 

ASP 4.0.3 installer should support Web Server 7.0 in Windows. 

6594778 

Apache 1.3.x and 2.0.x builds crash on Windows. 

6594779 

ASP installer for Windows need to support Apache 2.2.x.  

6594786 

ASP 4.0.2 in Japanese locale fails to connect database when updating records, which has more than hundred Japanese characters. 

6595995 

ASP administration console pages should be secured. 

6596437 

ASP sample applications need to be updated. 

6606567 

ASP is unable to process the casp.cnfg file due to stdio limitations.

6621471 

Need to bundle JRE 1.4.2 with ASP server. 

6654973 

Displays an error when accessing the Web Server tab. 

6656681 

When ASP server is disabled, Netscape plug-in crashes while serving ASP requests. 

6658139 

SQL Server drivers need to be branded correctly. 

6658718 

ASP Server is unable to recognize the Apache 2.x installation without the ServerName directive

6675459 

ASP admin fails to start on HP-UX. 

6675461 

Unable to login to the Administration console, as the service.pwd file is empty.

6675465 

Unable to detect and configure Web Server 7.0. 

6675478 

On AIX, ASP instance fails to start during and after install. 

6692211 

Accessing ASP admin/instance crashes ASP server 

6693561 

CVS files that are bundled under admin directory should be removed. 

6693874 

Disable chilibean by default. 

6694339 

ASP installation program fails on Windows, when pre-configured Web Server is running. 

6621471 

Upgrade the JRE version from 1.4.2_06 to 1.4.2_16. 

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

6402629 

dispint.h is a header file and it is relevant only in some situations. If you have already installed ASP product successfully then you do not need to refresh the installation.

Known Issues in Sun Java System ASP

The following table lists the most important known issues in the ASP release:

Table 1–5 Known Issues in Sun Java System ASP

Problem ID 

Description 

No ID 

Cannot connect to a remote Oracle database when Sun Java System ASP 4.0.2 is installed on AIX 5.2 with the Oracle client. The connectivity test results in the following error: 

/opt/casp/asp-server-3154/testadocon[16]: 123088 Illegal instruction(coredump)

Workaround

By default, 64-bit libraries are installed when Oracle is installed on AIX 5.2. Sun Java System ASP 4.0.2 uses a 32-bit driver, so the following changes must be made: 

  1. Open the file /opt/casp/global_odbc.sh.

  2. Change ORACLE_LIB="/opt/orcl902/OraHome1/lib" to ORACLE_LIB="/opt/orcl902/OraHome1/lib32"

    If connectivity is still a problem, check the ODBC.ini and make sure tnsnames.ora and "servername" match. Also make sure that the recommended patches have been applied, as listed in AIX Patches.

6542849 

Apache HTTPd crashes with SIGSEGV, when ASP 4.0.2 installed on UNIX/Linux platforms and compiled with some non-standard options.  

Workaround

When Apache HTTPd compiled with some non-standard options, (for example, large file support), Sun Java System ASP Server requires that its module for Apache be re-compiled using apxs. For more information on how to compile, see Apache HTTPd documentation:

http://httpd.apache.org/docs/2.2/programs/apxs.html (Apache 2.2)

http://httpd.apache.org/docs/2.0/programs/apxs.html(Apache 2.0)

http://httpd.apache.org/docs/1.3/programs/apxs.html(Apache 1.3)

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 athttp://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: