This topic describes the steps to install a custom configuration of Chili!Soft ASP 3.6.0-P1 for IBM AIX. For more information about a custom installation, see "Choosing an Installation Option for IBM AIX" in this chapter.
The configuration options you specify when installing a custom configuration of Chili!Soft ASP can have serious consequences for your server environment. Before you begin, make sure you meet the following requirements:
· You must be logged in as root.
· If you are downloading Chili!Soft ASP 3.6.0-P1 from the Web, in order to extract the installation files, you must have 45 MB of hard disk space available to install the version that does not include the DB2 Client Application Enabler (CAE) or 225 MB of hard disk space available to install the version that includes the DB2 CAE.
· Your hardware and software must meet the requirements listed in "Installation RequirementsChili!Soft ASP for IBM AIX" in this chapter.
· You need to know your product serial number. Chili!Soft ASP requires a valid serial number in order to run. If you downloaded the product from the Web, you should have received an e-mail message that included your serial number. If you are installing this product from a CD-ROM, the serial number is printed on the CD-ROM case. If you are installing a trial version from a CD-ROM, you must obtain a serial number at:
http://www.chilisoft.com/register
· To enable Chili!Beans, you must have a Java Runtime Environment (JRE) version between 1.1.7 and 1.2.1_03a installed on the target Web server. Chili!Beans enables you to access Java objects and classes from an ASP script. For more information about Chili!Beans, see "Chili!Beans Component Reference" in "Chapter 5: Developer's Reference."
· To configure Chili!Soft ASP to work with a Web server that is already installed on the target computer, you must shut down the Web server, and prepare to provide the following information:
Absolute path name of the Web server main configuration file (for example, /usr/HTTPServer/conf/httpd.conf)
Absolute path name of the Web server binary (for example, /usr/HTTPServer/bin/httpd)
Web server version (for example, 1.3.12)
Web server type (for example, Apache)
Web server port number (for example, 80)
Web server root directory (for example, /usr/HTTPServer)
· If you install Chili!Soft ASP to run with an Apache Web Server that does not support Dynamic Shared Objects (DSO), you must take additional steps. Following installation, you must manually link the Web server to Chili!Soft ASP and then recompile it, as described in "Configuring a Non-DSO Apache Web Server" in this chapter. If your Apache Web Server supports DSO, there are no additional steps to take: Chili!Soft ASP includes pre-built DSO modules that automatically link to your Web server.
· You need to know whether you want to run Chili!Soft ASP in multi-threaded or multi-process mode. For more information, see "Running in Multi-process Mode" and "Running in Multi-threaded Mode" in "Chapter 3: Managing Chili!Soft ASP."
· If you choose to customize settings for the Chili!Soft ASP Administration Console, you will need to specify a username and password for accessing it. Be sure to specify a password that you can remember, or else plan to store it in a secure location. If you forget your password, you can run the admtool utility and set a new password, as described in "Configuring Usernames and Passwords" in "Chapter 3: Managing 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.
· When configuring the Zeus Web Server to run with Chili!Soft ASP 3.6, 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 this: hostname.domain.com
Instead, use this: hostname
· The setup program for Chili!Soft ASP 3.6 for IBM AIX does not upgrade previous versions. For more information about preserving your settings from a previous installation of Chili!Soft ASP, see the product README file or go to:
http://www.chilisoft.com/support/
To install a custom configuration of Chili!Soft ASP for IBM AIX
1. If you are downloading Chili!Soft ASP from the Web, make sure you have 45 MB of hard disk space available to install the version that does not include the DB2 Client Application Enabler (CAE) or 225 MB of hard disk space available to install the version that includes the DB2 CAE. (The DB2 CAE is installed only with a bundle installation.)
2. If you are installing Chili!Soft ASP from a CD-ROM, skip this step. If you are downloading Chili!Soft ASP from the Web, download the casp-3.6.0-p1-aix.tar file to a temporary directory, and then extract the installation files by using the following command:
#> tar -xvf casp-3.6.0-p1-aix.tar
This step creates the following files, which you can delete after completing the installation:
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 Chili!Soft ASP
3. 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
4. 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 Chili!Soft ASP setup program cancels the installation.
5. On the next screen, enter 2 to select a Custom Installation.
6. On the next screen, press Enter to accept the default Chili!Soft ASP installation directory (/opt/casp).
or
Enter the absolute path name of the installation directory you want. The installation directory you specify cannot already exist. It is a good idea to make a note of the installation directory path name so that you can easily find the Chili!Soft ASP files at a later time.
7. In the previous step, if you specified a directory that already exists on your server, the setup program cancels the installation. You must restart setup and specify an installation directory that does not exist in order to complete the installation.
8. 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. Chili!Soft ASP will not run without a serial number, so if you enter n, the setup program cancels the installation.
9. When prompted, enter the product serial number.
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, enter y to enable Chili!Beans support.
or
Enter n if you do not want to enable Chili!Beans support.
12. On the next screen, enter the absolute path name of your Java Runtime Environment (JRE or JDK 1.1.8).
13. The next screen provides options for choosing the Web server to configure with Chili!Soft ASP. If you want the setup program to search your system and generate a list of installed Web servers from which to select, enter the number of the search option you want (1, 2, or 3). If you select one of these search options, skip to step 17.
or
If you want to skip this search and provide information about the Web server, enter 4 (Don't search). If you choose option 4 (Dont search), follow the instructions in step 15.
14. If you want to provide information about the Web server to configure, on the next screen, enter 1 (Specify the Webserver), and then follow the instructions in step 15.
or
If you want the setup program to search for installed Web servers from which to select, enter 2 (Refresh the Webserver list), and then follow the instructions in step 13.
or
If you do not want to configure a Web server during installation, enter 3 (Do not configure a Webserver), and then go to step 19. If you choose this option, the first time you open the Chili!Soft ASP Administration Console, you will be prompted to configure the ASP Server and a Web server.
15. On the next screen, enter the number of the type of Web server to configure: 1 for Apache, 2 for Netscape, 3 for Zeus, or 4 for IBM HTTP Server and go to the next step.
or
To cancel the user-specified Web server configuration, enter 5. 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 14.
16. At the prompts, enter the requested information about the Web server, and go to the next step.
17. On the next screen, enter the number of the Web server you want the setup program to configure to run with Chili!Soft ASP, and go to the next step.
or
To provide information about the Web server to configure, enter the number for the option, Specify the Webserver. If you choose this option, follow the instructions in step 15.
or
To perform another search for installed Web servers, enter the number for the option, Refresh the webserver list. If you choose this option, follow the instructions in step 13.
or
If you do not want to configure a Web server during installation, enter the number for the option, Do not configure a Webserver, and then go to step 19. If you choose this option, the first time you open the Chili!Soft ASP Administration Console, you will be prompted to configure the ASP Server and a Web server.
18. On the next screen, verify the information that the setup program displays about your Web server. If the information is incorrect, the Chili!Soft ASP installation could fail. In this event, 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 Chili!Soft ASP" in this chapter. If the information on the screen is correct, enter y (yes), and go to the next step.
or
If the information is incorrect, enter n (no). The setup program returns you to the previous screen. For this screen, follow the instructions in step 17.
19. On the next screen, choose a configuration option for the ASP Server. Enter 1 to choose a default configuration, and go to the next step.
or
Enter 2 to choose a custom configuration, and enter the following information at the prompts:
Would you like me to restart this Web Server for you? Enter y (yes) if you want the setup program to automatically restart the Web server after completing Chili!Soft ASP installation, or enter n (no) if you do not want this.
Choose a mode. Enter the number of the mode in which you want to run the ASP Server, or enter 3 for more information about this option.
1. Multi-threaded
2. Multi-process
3. More information
Enable samples on this Web server? Enter y (yes) if you want the setup program to install and configure the Chili!Soft ASP samples on your Web server, or n (no) if you do not want this.
Enable documentation on this Web server? Enter y (yes) if you want the setup program to install and configure the Chili!Soft ASP documentation on your Web server, or n (no) if you do not want this. If you enter n, the documentation will be available from the Administration Console, but not from the Chili!Soft ASP Start Page.
Start the Chili!Soft ASP on system boot? Enter y (yes) if you want the setup program to start Chili!Soft ASP automatically each time you start the computer, or type n (no) if you do not want this.
Would you like to start this Chili!Soft ASP Server? Enter y (yes) if you want the setup program to start Chili!Soft ASP automatically immediately after you finish installing it, or n (no) if you do not want this.
or
Enter 3 to choose another Web server to configure for Chili!Soft ASP, and follow the instructions in step 13.
20. On the next screen, select a configuration option for the Administration Console. When you choose Auto-Select/Default, the setup program configures the console using default settings. With this option, it specifies the username as "admin" and the password as "root." To protect the security of your server, it is highly recommended that you change these settings as soon as possible. For information about doing this, see "Configuring Usernames and Passwords" in "Chapter 3: Managing Chili!Soft ASP."
If you choose Customize Settings, 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 Chili!Soft ASP Administration Console to start automatically each time you start the computer, or n (no) if you do not want this.
Type the username: Enter the administrator username.
New password: Enter the administrator password, which is required for accessing the Administration Console. It is a good idea to make note of this password, because you cannot access the Administration Console without providing it.
Confirm password: Re-enter the password.
21. The next screen provides summary information about your Administration Console configuration, including the URL for accessing it. It is a good idea to make a note of this information or else print this screen for future reference. When finished, press Enter to complete the installation.
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 Chili!Soft ASP (/usr/local/casp by default).
Before running a custom installation of Chili!Soft ASP, see "Important Notes About Custom Installations for IBM AIX" in this chapter.
For information about the changes the setup program makes to your Web server configuration files, see "Changes to Netscape Web Server Configuration Files" or "Changes to Apache Web Server Configuration Files" in this chapter, as appropriate.
See also:
Installing Chili!Soft ASP 3.6 for IBM AIX in this chapter
Uninstalling Chili!Soft ASP in this chapter
Copyright 2001 Sun Microsystems, Inc. All rights reserved. Legal Notice.