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

• Installing Sun Java System ASP on Windows

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:

• Sun Java System ASP Server

• Sun Java System ASP Administration Console

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

• Installation Steps

• After You Install

Before You Install

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

• You are logged in as root.

• You have at least 250 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.3 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

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:

• 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.3 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_16 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)

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

This section contains the following topics:

• Before You Install

• Installation Steps

• After You Install

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

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

Do not make any changes to the INSTALL, SYSFILES, or REGLIST 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.