|
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 ReleaseSun 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:
- Support for Red Hat Enterprise Linux 3, Solaris™ 9 x86, Solaris™ 10 SPARC and x86, Windows 2003, HP-UX 11i, and AIX 5.1 and 5.2.
- Updated DataDirect ODBC drivers (Release 5.0). For more information about the updated driver suite, go to:
http://www.datadirect.com/products/odbc/odbcrelhighlights/index.ssp- Streamlined installation. Serial numbers have been removed, and you no longer need to enter a license key during installation.
- Support for access logging and the logging of HTTP errors. Enable or disable these from the Server Settings page of the Administration Console. You can also look in the casp.cnfg configuration file for lines that set asplogdir, asplogerrors, and asplogaccess:
- Support for custom error pages for the 400-range with both Apache and Sun Java™ System Web Server. If a custom error page is defined in the Web server configuration files, ASP redirects to that page for the corresponding errors (most commonly, 404 file not found).
- Enhanced HTTP charset functionality. The HTTP charset attribute can now be set on an ASP-wide basis in the casp.cnfg file (or the registry on Windows). Previously, this had to be set on a page-by-page basis. The charset setting is under the [default machine] section in casp.cnfg. Examples of valid values include ISO-8859-1 and UTF-8. By default, ASP does not set charset on "text/html" pages. In that case, the browser picks up the Web server’s value.
- Enhanced VBScript functionality. The following VBScript byte-related functions are now supported: LenB, InStrB, LeftB, RightB, MidB, ChrB, AscB. These functions behave largely as expected. However, there is one caveat you should be aware of regarding the byte-order and wide-character size of the operating system under which ASP runs in some situations. Following is an example scenario in which character width discrepancies would be experienced:
inchar = "A"
leftbyte = LeftB(inchar)
rightbyte = RightB(inchar)outchar = leftbyte & rightbyte
On Windows, outchar will contain "A" as expected. However, on Solaris or Linux, the character A in string "A" is represented by four bytes. So the above code would yield only half of a valid character. Namely, the first and last bytes of "A" without the two middle bytes. A browser will display garbage or its unknown character symbol if the broken character is passed to Response.Write.
You can determine the byte-length of a character by calling the VBScript LenB function as follows:
Response.Write LenB("A")
On Windows, two will be returned. On Solaris x86, Solaris SPARC, and Linux, four will be returned.
Product NotesPlease note the following:
- The Apache Web Server is no longer bundled with Sun Java System ASP.
- Sun Java System ASP 4.0.2 includes JRE 1.4.2_06 on all platforms.
- MySQL is not supported on HP-UX and AIX.
- The DBMS tool is not supported on HP-UX and AIX.
- The Database Publisher tool is not supported when publishing to HP-UX and AIX.
- Red Hat Enterprise Linux 2.1 is considered to be deprecated. Support for this platform will be removed from future releases of Sun Java System ASP.
System RequirementsThis 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 SpaceSolaris 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/J2SEHP-UX Patches
For the HP-UX platform, the recommended patch list can be found at
http://www.hp.com/products1/unix/java/patches/index.htmlAIX 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:
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.
Web Server
You must be using one of the following Web servers:
Installing Sun Java System ASPThis 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:
- You are logged in as root.
- You have at least 100 MB of hard disk space available to extract the installation files.
- Your hardware and software meet the requirements listed in System Requirements.
- You know the language you want Sun Java System ASP to support. You can change the language after installation using the Sun Java System ASP Administration Console, as described in Managing the ASP Server > Configuring International Support in the product documentation.
- If you choose to customize settings for the Sun Java System ASP Administration Console, you must specify a user name and password for accessing the console. Be sure to specify a password that you can remember, or else plan to store the password in a secure location. You cannot access the Administration Console without providing this password. If you choose not to customize settings, the user name is set as 'admin' and the password as 'root.' To protect the security of your server, you should change these from the defaults as soon as possible, as described in Using the Administration Console > Configuring Usernames and Passwords.
- If you are upgrading from a previous version of the product, you must install Sun Java System ASP 4.0.2 in the same directory as your previous installation. Be sure to review Upgrading an Existing Installation for additional upgrade information.
Installation Steps
To install Sun Java System ASP on UNIX
- 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:
tar -xvf <name>.tar
This step creates a temporary directory, which can be deleted after completing the installation.- 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.
- 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.- 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.- 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.
- Press Enter to accept the default language (English - United States).
- or -
Enter the number of a language shown in the list.- Specify the desired search option for choosing the Web server to configure with Sun Java System ASP, then follow the prompts for your selection.
- 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.
- 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.
- 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.
- 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:
- The Administration Console is used to start and stop the Sun Java System ASP Server, and to change configuration settings. You can access the Administration Console by entering the following URL in your Web browser address bar:
http://[HOSTNAME]:[PORT]
where [HOSTNAME] is the host name of the Web server configured to run with Sun Java System ASP, and [PORT] is the port on which the Administration Console is running (5100 by default). The URL for accessing the Administration Console is provided in the following file:
[INSTALL_DIR]/logs/install_summary
where [INSTALL_DIR] is the installation directory for Sun Java System ASP (/opt/casp by default).
Expert users can also start and stop the ASP Server from the command line, as described in the Command-line Management section in the product documentation.
- If you chose not to configure a Web server to run with Sun Java System ASP during installation, you will be prompted to do so the first time you open the Sun Java System ASP Administration Console.
- The Sun Java System ASP setup program makes certain changes to the configuration files for the associated Web server. For more information, see Managing the Web Server > Changes to Web Server Configuration Files in the product documentation.
- You can change some of the options that were configured during installation, such as the Web server with which Sun Java System ASP is configured to run. For more information, see the Command-line Management section in the product documentation.
- Use the diagnostic applications to verify that your installation is working correctly. Diagnostics can be accessed from:
http://[HOSTNAME]/caspsamp/
where [HOSTNAME] is the host name of the Web server configured to run with Sun Java System ASP.
- Certain Sun Java System ASP settings have important implications for the security of the Sun Java System ASP Server. See Managing the ASP Server > Securing the Server in the product documentation to ensure that settings are appropriately configured for your specific environment.
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.
- Sun Java System ASP Server
- JRE 1.4.2_06 for Chili!Beans (the use of Chili!Beans is optional; this install is performed only if an existing JRE 1.4.1 or higher is not installed)
- Sun Java System ASP SpicePack components (the Chili.Mail component is installed only if an existing Microsoft CDONTS.Newmail component is not found on the machine)
This section contains the following topics:
Before You Install
Before starting your installation, make sure you meet the following requirements:
- You are logged in with administrator privileges.
- Your hardware and software meet the requirements listed in System Requirements.
- You’ve uninstalled any previous installations of Sun Java System ASP
- You’ve closed all applications that use ODBC connections
- You’ve stopped the Web server. If you are running the Web server as an executable, stop the server by shutting it down or by closing the executable's window. If you are running the Web server as a service, stop the service via the Windows Control Panel.
- To install and use the Sun Java System ASP ADO samples, MDAC 2.5 or higher must be installed on your computer. If you opt to install the samples during the installation of Sun Java System ASP, and MDAC 2.5 is not yet installed, you have the option to install it. If you choose to install MDAC 2.5, the setup program walks you through the MDAC installation. Following installation, restart your computer and rerun the Sun Java System ASP setup program as described in this procedure.
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.
- 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.- Perform the step-by-step installation, as prompted by the setup program.
- 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:
- Sun Java System ASP runs automatically whenever an ASP page is requested by a user (provided the Web server is running). Sun Java System ASP runs until the Web server is stopped. When the Web server is restarted, Sun Java System ASP will not run until an ASP page is requested by a user.
- The Sun Java System ASP Administration Console is referenced throughout the product documentation. The Administration Console is available for the UNIX/Linux version of the product only. With Sun Java System ASP for Windows, all configuration is performed during installation. Some of the configuration information is stored in registry settings, however, and EXPERT users may choose to use regedit to edit those settings.
- With Sun Java System ASP for Windows, ASP applications are defined by adding aliases or virtual directories to the Web server. Sun Java System ASP treats each alias or virtual directory as an ASP application. With Sun Java System Web Server, ASP applications are defined by adding an additional document directory using the server's Administration tool. With Apache Web Server, ASP applications are defined by adding an alias to the httpd.conf file.
- ODBC drivers are not installed with Sun Java System ASP for Windows. Use the Windows ODBC Data Source Administrator (accessed from the Control Panel) to view installed ODBC drivers and to create and manage DSNs. Consult Microsoft documentation for more information.
Upgrading an Existing InstallationOn 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.
- The Sun Java System ASP setup program preserves many (but not all) settings from your 3.6.2 or 4.0.1 installation, and imports those settings into your new Sun Java System ASP installation. Most settings imported from your existing installation will override the settings that you configure during installation.
SequeLink DSNs are not migrated when upgrading from 3.6.2 or 4.0.1 to Sun Java System ASP 4.0.2. Neither are the administrator name and password used to access the Sun Java System ASP Administration Console (you will specify these again during the installation). Also, DO NOT press CTRL+C during setting migration.
- If necessary, upgrade to meet the requirements listed in System Requirements.
- Do not upgrade a mission-critical production server. Performing the upgrade and taking the additional configuration steps required might keep your server offline for an unacceptably long period of time. If possible, mirror the production server to a nonproduction server, perform the upgrade, and then test and debug the upgraded server before deploying it in your production environment.
When the setup program has completed the installation, do the following:
- Verify that any system DSNs defined for your previous installation are functioning correctly. For more information, see Configuring a Database > Configuring Data Source Names (DSNs) > Testing a DSN in the product documentation. You can create or edit the system DSNs as needed, as described in Configuring a Database > Configuring Data Source Names (DSNs). Configuration information for the system DSNs that were defined for your previous installation can be found in the following file:
[INSTALL_DIR]/casp/INSTALL/settings.import
where [INSTALL_DIR] is the path name of the Sun Java System ASP installation directory (/opt/casp by default).
- You may also wish to verify that the following migrated successfully:
Uninstalling Sun Java System ASPThis 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.
- From the Sun Java System ASP installation directory, enter the following at the command prompt:
./uninstall
- 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.- 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.
- 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.
- Delete the directories and files in the Sun Java System ASP installation directory.
To uninstall Sun Java System ASP on Windows
Product DocumentationIn 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.activesrverAfter you’ve accessed the 4.0.2 collection and located the Administrator and Developer’s Guide, do one of the following:
- Click the 'Download' link to access the PDF version of the guide
-or-
- Click the link for the Administrator and Developer’s Guide in the collection list, and then click 'Sun ONE Active Server Pages Online Help' on the page that displays. This launches the complete HTML version of guide. (Note that the Search box is not functional when the document is accessed in this manner. To search Sun Java System ASP 4.0.2 documentation, go to the docs.sun.com URL listed above, select the 4.0.2 collection, and then use the docs.sun.com 'Search for' box to search the documents.)
You can also access the documentation in other ways:
- From the Administration Console following installation by clicking the 'Documentation' link in the left navigation pane (UNIX and Linux only).
- With the following URL if you enabled documentation on your Web server during the installation of Sun Java System ASP:
http://[HOSTNAME]/caspdoc/
where [HOSTNAME] is the host name of your Web server (the Web server must be running).For the PDF version of the documentation, the URL is:
http://[HOSTNAME]/caspdoc/pdf/SunONEActiveServerPages4.pdf
- In the appropriate installation directory (where [INSTALL_DIR] is the Sun Java System ASP installation directory):
- On UNIX and Linux: [INSTALL_DIR]/caspdoc. The index.html file launches the HTML version of the documentation. The PDF version can be found in [INSTALL_DIR]/caspdoc/pdf.
- On Windows: [INSTALL_DIR]\UserGuide. The index.html file launches the HTML version of the documentation. The PDF version can be found in [INSTALL_DIR]\UserGuide\pdf.
- Using the context-sensitive Administration Console Help that’s part of the product (UNIX and Linux):
- To access online Help for an entire screen in the Administration Console, click the HELP button in the upper right corner.
- To access online Help for a specific field on a screen, mouse over or click the question mark (?) icon next to the field. The specific fields and elements in the user interface are also listed alphabetically in the Administration Console Glossary section at the end of the administrator’s guide for quick reference and lookup.
Resolved Issues in Sun Java System ASP 4.0.2The following table lists the most important issues resolved in Sun Java System ASP 4.0.2 release:
How to Report Problems and Provide FeedbackIf you have problems with Sun Java System ASP, contact Sun customer support using one of the following mechanisms:
- Sun Software Support Services online at
http://www.sun.com/service/support/software- The telephone dispatch number associated with your maintenance contract
So that we can best assist you in resolving problems, please have the following information available when you contact support:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
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 ResourcesUseful information can be found at the following locations:
- Documentation for all versions of Sun Java System Active Server Pages
http://docs.sun.com/app/docs/prod/s1.activesrver- Developer Information
http://developers.sun.com/prodtech/asp/- Software Products and Service
http://www.sun.com/software- Software Support Services
http://www.sun.com/service/support/software- Support and Training Services
http://www.sun.com/supportraining
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.