Parallels H-Sphere Documentation System Administrator Guide

 

Chili!Soft ASP Installation

 

Last modified: 27 Dec 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

This guide describes the installation of Chili!Soft ASP to H-Sphere web box.

It is advisable to read the README file that contains Chili!ASP bundle to get familiar with Chili!ASP general issues and features.

WORKFLOW

  1. Download Chili!Soft ASP tarball.
  2. Run the command
    # mkdir casp
  3. Run the command
    # tar xf chiliasp-3.6.2L.1047a.tar -C casp
  4. Run the command
    # cd casp && ./install
  5. You will see dialogue windows in the order set below. We shall lead you though the procedure and give you the responces required for the correct Sun Chili!Soft ASP installation.
    On each step, you will have to choose one of the options suggested. The default choice is shown in square brackets e.g. [1], the option that you need to choose if is shown in bold in the description below next to the default one, e.g. [1] 2 -- the correct choice is option 2.

    Step I.
    ----------------------------------------------------------------------
    Sun Chili!Soft ASP - Installation
    --------------------------------------------------------------------
    Setup will now install the files needed to run and configure Sun Chili!Soft ASP to a directory that you specify. To accept the default (shown in brackets below), press Enter. To specify a different directory, enter the pathname and then press Enter.
    Note: Configuration options specific to this installation are contained in the directory that you specify. Make a note of this location, so you can easily find Sun Chili!Soft ASP files at a later time.

    ------------------------------------------------------------------
    Enter the directory in which to install Sun Chili!Soft ASP [/opt/casp] /hsphere/shared/casp

    Extracting files to /hsphere/shared/casp ...
    + bean-classes package . done.
    + bean-jre package ......... done.
    + bean package . done.
    + caspdoc package ................ done.
    + caspsamp package ... done.
    + casp package . done.
    + chilicom package ... done.
    + components package . done.
    + installer package . done.
    + license package . done.
    + module package . done.
    + odbc-direct-40 package ........ done.
    + odbc-opensource package . done.
    + server package .. done.
    + sqlnk-4_51 package . done.
    + chili-tools-linux2 package .. done.
    + supporting binary / library packages . done.

    Step II.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Product Serial Number
    --------------------------------------------------------------------
    Sun Chili!Soft ASP requires a valid serial number to run. If you downloaded this 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 do not have a serial number, enter 'n' below to receive a 30-day trial license.

    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' below to receive a full, unlimited license.

    --------------------------------------------------------------------
    Do you have a Sun Chili!Soft ASP Product Serial Number (y/n)? [y] y

    Note: If you wish to exit out of the license key installer, type none.

    Enter your Sun Chili!Soft ASP Product Serial Number
    [none] Y_O_U_R_ S_E_R_I_A_L

    Step III.
    ----------------------------------------------------------------------
    Sun Chili!Soft ASP - Bundled Apache 1.3.19 Configuration
    -----------------------------------------------------------------------
    Sun Chili!Soft ASP includes a ready-to-run Apache 1.3.19 Web server that is configured with Microsoft (TM) FrontPage 2002 Server
    Extensions support and EAPI (Extended API). If you have not yet configured a Web server, you now have the option to install this preconfigured Apache Web server.

    Note: Sun ChiliSoft ASP supports but does not install FrontPage 2002 Server Extensions; those must be obtained from Microsoft. For more information about Sun Chili!Soft ASP support for FrontPage 2002 Server Extensions, see 'Chapter 3' in our production documentation. For more information about EAPI, including the mod_ssl / OpenSSL module, visit www.modssl.org

    ---------------------------------------------------------------------
    Would you like to install the bundled Apache 1.3.19 Web server (y/n)? [n] n

    Step IV.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Language Selection
    ----------------------------------------------------------------------
    Sun Chili!Soft ASP supports various languages. Select the language you want to use from the list below.
    1. English - US
    2. English - British
    3. Japanese Shift-JIS
    4. German
    5. Dutch
    6. Spanish
    7. French

    -----------------------------------------------------------------------
    Which language would you like to use? [1] 1

    Step V.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Configuring Java Support
    ---------------------------------------------------------------------
    The Sun Chili!Beans component allows you to directly access Java objects and classes from inside your ASP scripts. For this functionality to be provided, a Java runtime environment (JRE) must be installed. Sun Chili!Soft ASP includes JRE 1.3.1. While other JREs are supported, the use of JRE 1.3.1 is strongly recommended. Choose option 1 to use the bundled JRE.

    1. Use the bundled JRE 1.3.1.
    2. Specify the path to an existing JRE.
    3. Disable Java support.

    ----------------------------------------------------------------------
    Which JRE would you like to use? [1] 3

    Are you sure you want to disable Java support (y/n)? [n] y

    Step VI.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Web Server Auto-Detection
    -----------------------------------------------------------------------
    Setup will now conduct a search of your system to generate a list of installed Web servers. On the next screen, you have the option to enable ASP support for one of these detected Web servers. If you want to skip this step, you can specify the pathname to a specific Web server by choosing option 4 below.

    1. Exhaustive search (slow)
    2. Search in: /usr, /opt, /etc, /var (moderate)
    3. Search the common Web server locations (fast)
    4. Don't search (specify Web server on next screen)

    ----------------------------------------------------------------------
    Which type of search would you like to perform? [2] 4

    Step VII.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Web Server Configuration
    ----------------------------------------------------------------------
    No Web servers have been detected. As options, you can manually specify Web server information to aid in detection, direct Setup to try to detect more Web servers, or delay Web server configuration until another time.
    1. Specify the Web server.
    2. Attempt to auto-detect more Web servers.
    3. Do not configure a Web server.

    ----------------------------------------------------------------------
    Which configuration option would you like to perform? [1] 1

    Step VIII.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - User-specifed Web Server Configuration
    ----------------------------------------------------------------
    Listed below are the types of Web servers to which this version of Sun Chili!Soft ASP will install:
    1. Apache
    2. Netscape / iPlanet
    3. Zeus
    4. Cancel user-specified Web server configuration.

    ----------------------------------------------------------------------
    Which Web server type do you want to configure? [1] 1

    BEFORE REPLYING TO THE NEXT QUESTION, DO THE FOLLOWING STEPS FROM ANOTHER SERVER CONSOLE:
    a) check if your version of H-Sphere Apache server is different from the suported bundle version
    # /hsphere/shared/apache/bin/httpd -v
    b) if it is, do two additional steps:
    #mkdir -p /hsphere/shared/casp/module/linux2_optimized/apache_1.3.{corresponding_number}/eapi
    #cp /hsphere/shared/casp/module/linux2_optimized/apache_{number_of_bundle_vesion}/mod_casp2.so \
    /hsphere/shared/casp/module/linux2_optimized/apache_1.3.{corresponding_number}/eapi

    c) return to the installation console.

    NOTE: Regardless of this fact, you may be able to build your own module that supports this version of Apache. Refer to Sun Chili!Soft ASP documentation for information on building your own module. After the module has been built, proceed to the following steps:
    (1) # mkdir -p /hsphere/shared/casp/module/linux2_optimized/apache_1.3.23/eapi
    (2)# cp <generated build dir>/mod_casp2.so /hsphere/shared/casp/module/linux2_optimized/apache_1.3.23/eapi
    (3) Re-run the the installer by executing the following script:
    HASH(0x81b9b84)-{asphome}/INSTALL/install

    After placing the file into the created module directory, the installer will recognize it as a supported Web server and act accordingly.

    Step IX.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Apache Configuration
    ----------------------------------------------------------------
    Because of the way the Apache Web server works, few of the configuration questions listed below can be answered outright. However, wherever possible, default values have been provided for some of the questions.
    Note: To exit Web server configuration, type 'none' for the listed option.

    ---------------------------------------------------------------------
    Enter the path and file name of the Apache Web server configuration file:
    [none] /hsphere/shared/apache/conf/httpd.conf

    Enter the path and file name of the Apache binary:
    [/hsphere/shared/apache/bin/httpd]

    Step X.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Web Server Configuration
    ---------------------------------------------------------------
    The following list contains all currently detected Web servers. If the Web server for which you want to enable ASP support appears below, enter the number that corresponds to the Web server. If the Web server is not listed, you can manually specify Web server information to aid in detection, direct Setup to try to detect more Web servers, or delay Web server configuration until another time.

    1. Apache Secure Server
    Settings file: /hsphere/shared/apache/conf/httpd.conf
    Port: 80
    2. Specify the Web server.
    3. Attempt to auto-detect more Web servers.
    4. Do not configure a Web server.

    ----------------------------------------------------------------------
    Which configuration option would you like to perform? [1] 1


    Step XI.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Web Server Verification
    ----------------------------------------------------------------
    Setup has automatically detected the following information about the Web server you selected on the previous screen. If the information is correct, type 'y' and press Enter. If the information is incorrect type 'n', press Enter, and then select 'Specify the Web server' from the menu.
    Web server information:

    Main configuration file: /hsphere/shared/apache/conf/httpd.conf
    Binary: /hsphere/shared/apache/bin/httpd
    Version: 1.3.19
    Type: Apache
    Port: 80
    Root: /hsphere/shared/apache

    ---------------------------------------------------------------------
    The Web server information is correct (y/n). [n] y

    Step XII.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Server Configuration
    ----------------------------------------------------------------
    Setup will now configure the Sun Chili!Soft ASP Server. Unless you are an experienced Sun Chili!Soft ASP user, it is strongly recommended that you use the default configuration settings (option 1, below). If you choose the custom configuration option, you will be asked to specify a number of settings. For detailed information about configuring Sun Chili!Soft ASP, see 'Chapter 3' in the product documentation.
    1. Default configuration.
    2. Customize configuration.
    3. Choose another Web server to install to.

    ----------------------------------------------------------------------
    Select a configuration option. [1] 1

    Step XIII.
    ---------------------------------------------------------------------
    Chili!Soft ASP - Administration Console Installation
    -----------------------------------------------------------------------
    Setup will now install the Sun Chili!Soft ASP Adminstation Console. Unless you are an experienced Sun Chili!Soft ASP user, it is strongly recommened that you choose the default configuration (option 1, below). If you choose the custom configuration option, you will be asked to specify a number of settings. For detailed information about configuring the Sun Chili!Soft ASP Adminstration Console, see 'Chapter 3' in the product documentation.
    Note: If you choose the 'Default configuration' option, the username and password will be set to default values. To protect the security of your server, you should change these settings immediately after installation. For more infromation, see the product documentation.

    1. Default configuration
    2. Custom configuration

    ----------------------------------------------------------------------
    Select a configuration option for the Administration Console. [1] 1

    Step XIV.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Administration Console Information
    ----------------------------------------------------------------
    Setup has finished installing the Administration Console. To configure Sun Chili!Soft ASP, you can connect to the Administration
    Console from a URL or from the command line, as shown below. For more information about configuring Sun Chili!Soft ASP, see 'Chapter 3' in the product documentation. It is a good idea to print this page for future reference.
    ---------------------------------------------------------------------

    To connect from a browser, use this URL: http://gargona.psoft:5100
    To start, stop and add users, use this script: /var/casp/admtool
    The console's username is: admin
    The console's password is: root

    To continue, press Enter.

    Step XV.
    ---------------------------------------------------------------------
    Sun Chili!Soft ASP - Setup Complete
    ----------------------------------------------------------------
    Sun Chili!Soft ASP has been successfully installed! Important next steps:

    -- Read the README file that came with Sun Chili!Soft ASP. This file contains the latest installation and application notes.
    -- Read the 'Getting Started' section in the 'Sun Chili!Soft ASP Quick Start Guide.' This guide provides basic information about getting started with Sun Chili!Soft ASP, and points you to additional resources.
    -- Take a moment to register this product. By registering you will be eligible for 30 days of free introductory support. Register at: http://www.chilisoft.com/register
    -----------------------------------------------------------------

    Summary file: /var/casp/logs/install_summary

  6. If the installation was performed correctly, corresponding Chili!ASP services should be activated. Use
    # ps -ax | grep casp
    Also, check the httpd.conf file for the presence of additional directives. Use
    # grep casp /hsphere/shared/apache/conf/httpd.conf
  7. If all is OK, copy the web content of ASP test scripts into corresponding default "DocumentRoot" directory
    # cp -Rp /hsphere/shared/casp/caspsamp /hsphere/shared/apache/htdocs/
  8. Check the operation of ASP test scripts via the URL http://your_webserver_name/caspsamp
  9. You may reinstall Chili!ASP. In this case, you need to execute the /hsphere/shared/casp/unistall script prior to the re-installation.

NOTE: It is advisable to avoid restarting Apache when installing Chili!Soft ASP even if suggested so by the installation script.



© Copyright 2017. Parallels Holdings. All rights reserved.