Running the Setup Program: Sun Chili!Soft ASP for Solaris

The Sun Chili!Soft ASP setup program takes you through the steps required to install Sun Chili!Soft ASP 3.6.2 on Sun Solaris. The setup program installs the following components on the target server:

· Sun Chili!Soft ASP Server

· Sun Chili!Soft ASP Administration Console

· Sun Chili!Beans support (the use of Chili!Beans is optional). Sun Chili!Soft ASP 3.6.2 includes Java Runtime Environment (JRE) 1.3.1. The use of this specific JRE version is not required, but is strongly recommended.

· Sun SpicePack components

· Apache Web Server 1.3.19 DSO (preconfigured or "bundled" with Sun Chili!Soft ASP 3.6.2).

The setup program gives you the option to either specify the configuration options or accept the default configuration settings. The configuration settings you specify during installation can have serious consequences for your server environment. Before you begin, make sure you meet the following requirements:

· You are logged in as root.

· You have 60 MB of hard disk space available to extract the installation files.

· Your hardware and software meet the requirements listed in "Installation Requirements: Sun Chili!Soft ASP for Solaris" in this chapter.

· You know your product serial number. If you do not know your product serial number and you go ahead with the installation, you will receive an evaluation license.

· You know which language you want Sun Chili!Soft ASP to support (English - US, Japanese Shift-JIS, and so on) . If desired, you can change the language after installation, as described in "Configuring International Support" in "Chapter 3: Managing Sun Chili!Soft ASP."

· To use Chili!Beans, a Java runtime environment (JRE) must be installed on the machine, and Chili!Beans must be enabled from the Administration Console. During installation, Sun Chili!Soft ASP will install JRE 1.3.1 unless you choose to install another supported version (1.2.x or 1.3.x). Note that while you have the option to install a different JRE, and the Java 2 Runtime Environment can also be used, the use of JRE 1.3.1 is strongly recommended. Chili!Beans enables you to access Java objects and classes from an ASP script. For more information, see "Chili!Beans Component Reference" in "Chapter 5: Developer's Reference."

· If you are upgrading from a previous version of Sun Chili!Soft ASP, you must install Sun Chili!Soft ASP 3.6.2 in the same directory as your previous installation. Also, be sure to review the information in "Upgrading Sun Chili!Soft ASP for Solaris" in this chapter.

· If you choose to customize settings for the Sun Chili!Soft ASP Administration Console, you must specify a username 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. If you forget your password, you can run the admtool utility and set a new one, as described in "Configuring Usernames and Passwords" in "Chapter 3: Managing Sun Chili!Soft ASP." If you do not choose the customize settings option, the username is set as "admin" and the password as "root." To protect the security of your server, you should run the admtool and change these as soon as possible following installation.

· If you are installing Sun Chili!Soft ASP to a Zeus Web server, you must take additional steps prior to installation. See "Installing Sun Chili!Soft ASP to a Zeus Web Server" immediately below. If you are not installing to a Zeus Web server, proceed with the installation as described in "To run the setup program" in this section.

Installing Sun Chili!Soft ASP to a Zeus Web Server

Before you can install Sun Chili!Soft ASP to a Zeus Web server, you must first enable NSAPI (Netscape's Web server API) for a Zeus Virtual Server, and then copy the NSAPI configuration files to the proper location. For detailed information beyond what is provided here, see your Zeus product documentation.

Note

When configuring the Zeus Web server to run with Sun Chili!Soft ASP 3.6.2, do not specify the Web server hostname as the fully qualified domain name (or "server address"). If you do, the Test DSN feature of the Administration Console will not work. Instead, use the hostname only. For example, do not use: hostname.domain.com. Instead, use: hostname.

To enable NSAPI for a Zeus Virtual Server

1. Go to the Configuration Summary page for the Zeus Virtual Server.

2. Go to the Enabling NSAPI Functionality page by clicking the NSAPI link.

3. Click the Enabled button, write down the value of [path_prefix] for future reference, and then click the Apply changes button.

4. Commit the changes by clicking the yellow sun graphic in the top right section of the page, and then click the Commit button.

NSAPI has been enabled for a Zeus Virtual Server. You must now copy the NSAPI configuration files, as described in the following procedure.

To copy the NSAPI configuration files

Zeus provides copies of the NSAPI configuration files, which are typically located in the following directory:

[zeushome]/webadmin-4.0r1/docroot/nsapi-skel/

where [zeushome] is the root of your Zeus installation (that is, /usr/local/zeus).

Once the files have been located, use the following commands:

#> mkdir -p [path_prefix]/https-[virtual_server_name]/config

#> cd [path_prefix]/https-[virtual_server_name]/config

#> cp -r [zeushome]/webadmin-4.0r1/docroot/nsapi-skel/* .

where [path_prefix] is the value you wrote down in step 3 of the previous procedure (the default will be [zeushome]/ns-config), and [virtual_server_name] is the name of the Zeus Virtual Server. Zeus is now configured correctly for the installation of Sun Chili!Soft ASP.

To run the setup program and install Sun Chili!Soft ASP, use the following procedure.

To run the setup program

1. If you are installing Sun Chili!Soft ASP 3.6.2 from the CD-ROM, go to step 2. If you are downloading Sun Chili!Soft ASP 3.6.2 from the Web, download the casp-3.6.2-solaris.tar file to a temporary directory, and then extract the installation files by using the following command:

#> tar -xvf casp-3.6.2-solaris.tar

This step creates the following files in the temporary directory, which you can delete after completing the installation:

A QuickStart Guide with installation instructions
A README file containing important product information
The install.sh installation script
A package/EULA file containing the End-User License Agreement
A package/directory containing files required to install Sun Chili!Soft ASP

2. Run the install.sh script by using the following command. 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.

#> ./install.sh

3. Review the End-User License Agreement (EULA) that displays. Enter yes if you agree with its conditions. You must type the entire word, "yes."

- or -

Enter no if you do not agree. If you enter no, the Sun Chili!Soft ASP setup program quits the installation.

4. On the next screen, press Enter to accept the default Sun Chili!Soft ASP installation directory (/opt/casp).

- or -

Enter the absolute path name of a different installation directory. Make note of this location, so you can easily find the Sun Chili!Soft ASP files at a later time.

Note: To upgrade from the previous version, you must specify the installation directory of your existing installation.

5. If the setup program detects a previous installation of Sun Chili!Soft ASP in the specified directory, you will be prompted to uninstall the previous version (if a previous installation is not detected, go to step 6):

Enter n (no) to change the installation directory or cancel the installation.

- or -

Enter y (yes) to uninstall the previous installation. You will then be prompted to proceed. At this confirmation prompt, enter n to cancel the installation, or y to uninstall the previous version. If you enter y, the previous version will be uninstalled by the installer. Once that process is finished, press Enter to continue.

Note: At the end of the Sun Chili!Soft ASP installation process you will be prompted to import your settings.

6. On the next screen, enter y (yes) if you know the product serial number.

- or -

If you do not know the serial number, enter n. An evaluation license will be installed (go to step 8).

Note: iPlanet 6.0 users are already licensed to use this product and do not need to enter a serial number. If you are using iPlanet 6.0, enter n and you will receive a full, unlimited license (go to step 8).

7. When prompted, enter the product serial number.

8. Sun Chili!Soft ASP 3.6.2 includes a ready-to-run Apache 1.3.19 Web server configured with support for Microsoft FrontPage 2002 Server Extensions (the extensions themselves are not installed) and EAPI (Extended API). If you have not yet configured a Web server, you have the option to install this preconfigured Apache Web server.

Enter y (yes) to install the preconfigured ("bundled") Apache 1.3.19 Web server, and proceed to the next step.

- or -

Enter n (no) if you do not want to install the preconfigured Apache Web server, and proceed to step 10.

Note: Installing the preconfigured Apache Web server will not affect any other installed Web server. However, make sure you do not install the preconfigured Apache Web server to the same port as that of an existing Web server.

9. The Apache Web server has many settings that you can select and configure. Specify the desired configuration option for the preconfigured Apache 1.3.19 Web server:

Enter 1 (Default configuration) to direct Sun Chili!Soft ASP to automatically configure all settings for you.

- or -

Enter 2 (Specify only the Web server listen port) to specify only the port number that the Apache Web server will listen on, and then specify the port.

- or -

Enter 3 (Customize the configuration) to specify the configuration of many different settings, and then respond to the prompts.

Note: All Apache configuration settings can be changed manually after installation by editing the Apache configuration file.

10. On the next screen, press Enter to accept the default language (English - US).

- or -

Enter the number of a language shown in the list.

11. On the next screen, enable or disable Chili!Beans support as desired:

Select Use the bundled 1.3.1 JRE to enable Chili!Beans support and install JRE 1.3.1 (this is the recommended JRE), and then respond to the prompts.

- or -

Select Specify the path to an existing JRE to specify the path to an existing JRE (JRE versions 1.2.x and 1.3.x are supported), or type none to return to the previous screen, and then respond to the prompts.

- or -

Select Disable Java support to disable Chili!Beans support, and then respond to the prompts.

- or -

Select Keep your current settings.

12. The next screen provides options for choosing the Web server to configure with Sun Chili!Soft ASP. If you want the setup program to search your system and generate a list of installed Web servers from which to choose, enter the number of the desired search option (1, 2, or 3). If you select one of these search options, skip to step 15.

- or -

If you want to skip this search and provide information about the Web server, enter 4 (Don't search). The installer will not search for the Web server, and instead takes you to step 13.

Note: If you chose to install the preconfigured ("bundled") Apache 1.3.19 Web server in step 8, go to step 15.

13. On the next screen, enter the number of the type of Web server to configure: 1 for Apache, 2 for iPlanet, or 3 for Zeus, and go to step 14.

- or -

To cancel the user-specified Web server configuration, enter 4. If you choose this option, the setup program returns you to the previous screen. From this screen you can choose another option, as described in step 15.

14. At the prompts, enter the path of your Web server. If you do not know the correct path, type none to cancel (this takes you to step 15). If you selected Apache in step 13, you will be prompted for the Web server binary. After all information has been added correctly, the installer takes you to step 15. There you will be able to select the Web server that was just added.

15. On the next screen, enter the number of the Web server you want the setup program to configure to run with Sun Chili!Soft ASP, and go to step 16 (if you selected option 1, 2, or 3 in step 12).

- or -

To provide information about the Web server to configure, enter the number for the option Specify the Web server. If you choose this option, follow the instructions in step 13.

- or -

To perform another search for installed Web servers, enter the number for the option Attempt to auto-detect more Web servers. If you choose this option, follow the instructions in step 12.

- or -

If you do not want to configure a Web server during installation, enter the number for the option Do not configure a Web server, and then go to step 18. If you choose this option, the first time you open the Sun Chili!Soft ASP Administration Console you will be prompted to configure the ASP Server and a Web server.

16. On the next screen, verify the information that the setup program displays about your Web server. If the information is incorrect, the Sun Chili!Soft ASP installation could fail. If the installation does fail, you can run the installation script again. If you do this, it is recommended that you first run the uninstall script, as described in "Uninstalling Sun Chili!Soft ASP for UNIX and Linux" in this chapter. If the information on the screen is correct, enter y (yes), and go to step 17.

- or -

If the information is incorrect, enter n (no). The setup program returns you to the previous screen (step 15).

17. On the next screen, choose a configuration option for the ASP Server:

Enter 1 to choose a default configuration, and go to step 18.

- or -

Enter 2 to choose a custom configuration, and enter the following information at the prompts:

Enable samples on this Web server? Enter y (yes) if you want the setup program to install and configure the Sun Chili!Soft ASP samples on your Web server, or enter n (no).

Enable documentation on this Web server? Enter y (yes) if you want the setup program to enable the Sun Chili!Soft ASP documentation on your Web server, or enter n (no). If you enter n, the documentation will be available from the Administration Console, but not from the Sun Chili!Soft ASP Start Page.

Start the ASP Server on system boot? Enter y (yes) if you want the setup program to start Sun Chili!Soft ASP automatically each time you start the computer, or enter n (no).

Would you like this [Web server] restarted? Enter y (yes) if you want the setup program to automatically restart the Web server after completing Sun Chili!Soft ASP installation, or enter n (no).

- or -

Enter 3 to choose another Web server to configure for Sun Chili!Soft ASP, and follow the instructions in step 12.

18. On the next screen, select a configuration option for the Administration Console. When you choose Default configuration, the setup program configures the console using default settings. With this option, the username is specified as "admin" and the password as "root." To protect the security of your server, it is strongly recommended that you change these settings as soon as possible. For information about doing this, see "Configuring Usernames and Passwords" in "Chapter 3: Managing Sun Chili!Soft ASP."

If you choose Custom configuration, enter the following information at the prompts:

Administration Console port number: Enter the number of the port on which the Web server should listen for requests for the Administration Console, or press Enter to accept the default.

Automatically start the Administration Console on system startup: Enter y (yes) if you want the Sun Chili!Soft ASP Administration Console to start automatically each time you start the computer, or enter n (no).

Type the username...: Enter the administrator username.

New password: Enter the administrator password, which is required to access the Administration Console. Make note of this password, because you cannot access the Administration Console without providing it.

Confirm password: Reenter the password.

19. The next screen provides summary information about your Administration Console configuration. Make note of this information or else print this screen for future reference. When finished, press Enter to complete the installation.

20. If you are upgrading from the previous version for Solaris and the setup program was able to export the settings from your previous installation, you will be prompted to import these settings into your new installation. Enter y (yes) to import your settings.

- or -

Enter n (no) if you do not want to import your settings.

The setup program then completes the installation and writes a summary file to:

[C-ASP_INSTALL_DIR]/logs/install_summary

where [C-ASP_INSTALL_DIR] is the directory in which you installed Sun Chili!Soft ASP (/opt/casp by default). Be sure to print the information contained in the install_summary file for future reference.

Before running your installation of Sun Chili!Soft ASP 3.6.2, see "Important Notes about Solaris Installations" in this chapter. If you are upgrading from a previous version of Sun Chili!Soft ASP for Sun Solaris, see "Upgrading Sun Chili!Soft ASP for Solaris" in this chapter.

For information about changes the setup program makes to your Web server configuration files, see "Changes to Web Server Configuration Files" in this chapter. For information about how to change some of the options that were configured during installation, see "Changing Installation Options after Installation" in this chapter.