This topic describes the steps to install a custom configuration of Chili!Soft ASP 3.6 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 from the Web, you must have 45 MB of hard disk space available in order to extract the installation files.
· Your hardware and software must meet the requirements listed in "Installation Requirements—Chili!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
· The Web server must be shut down. If you are not familiar with this process, consult your network administrator.
· To configure Chili!Beans support you must have Java Runtime Environment (JRE) 1.1.8 installed on the target Web server. Chili!Beans enables you to access Java objects and classes from an ASP script.
· To configure Chili!Soft ASP to work with a Web server that is already installed on the target computer, you need to know the following:
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), 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 install the Chili!Soft ASP Administration Console and specify a custom configuration, you need to specify an administrator username and password. Please note that if you specify a password and later forget it, you can no longer access the console. Be sure to specify a password that you can remember, or else plan to save a record of it in a secure location. To change a username and password, or to add a new one, follow the instructions in "Configuring Usernames and Passwords" in "Chapter 3: Managing Chili!Soft ASP."
· The setup program for Chili!Soft ASP 3.6 for IBM-AIX does not upgrade previous versions. If you have a previous installation of Chili!Soft ASP, go to the Chili!Soft Web site for more information about preserving your settings, at:
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 for the installation files.
2. If you are installing Chili!Soft ASP from a CD, skip this step. If you are downloading Chili!Soft ASP from the Web, download the casp-3.6.0-AIX.tar file to a temporary directory, and then extract the installation files by using the following command:
#> tar -xvf casp-3.6.0-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 Y (Yes) if you agree with its conditions, and N (No) if you do not agree. If you do not agree with the EULA, you will not be able to install Chili!Soft ASP.
5. On the next screen, select the Custom Installation option.
6. On the next screen, enter the absolute path name of the target directory for the installation. If you do not specify an installation directory, the setup program installs Chili!Soft ASP to /opt/casp. You might want make a note of this location so that you can easily find the Chili!Soft ASP files at a later time.
7. On the next screen, enter the product serial number.
8. On the next screen, in order to enable Chili!Beans, type the absolute path name of your Java Runtime Environment (JRE or JDK 1.1.8).
9. Next, the setup program searches your system to generate a list of installed Web servers from which you can select a Web server to run with Chili!Soft ASP. To start the search, enter the number of one of the search options. Or, if you prefer, you can skip the search by choosing option 4, and specify the path name to the Web server you want on the next screen.
10. On the next screen, select a Web server to run with Chili!Soft ASP from the list, or enter the absolute path name of the Web server you want.
11. On the next screen, verify the information that the setup program displays about your Web server. If this information is incorrect, the 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.
12. On the next screen, select a configuration option for the Chili!Soft ASP Server. If you choose the custom configuration option, you are then prompted to specify the following options:
Enable Samples: Install and configure the Chili!Soft ASP samples on your Web server
Enable Documentation: Install and configure the Chili!Soft ASP documentation on your Web server
Start Chili!Soft ASP on system boot: Start Chili!Soft ASP automatically each time you start the computer
Start the Chili!Soft ASP server after installation: Start Chili!Soft ASP automatically immediately after you finish installing it
Restart Web server after installation: Start the Web server automatically after you finish installing Chili!Soft ASP
13. On the next screen, select a configuration option for the Chili!Soft ASP Administration Console. When you choose Auto-Select/Default the setup program automatically configures the console. For this option, the setup program specifies the administrator username as "admin" and the password as "root." To protect the security of your server, it is highly recommend that you change these settings as soon as possible. For more information, see "Configuring Usernames and Passwords" in "Chapter 3: Managing Chili!Soft ASP."
14. When you choose Customize Settings, you are prompted to specify the following settings:
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.
15. The next screen provides summary information about your Administration Console configuration. It is a good idea to print this screen for future reference.
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