WebSpeed
Installation and
Configuration Guide


Beginning the Installation

How you install WebSpeed depends on what products, components, and subcomponents you choose to install. You can tailor your installation so that only those products and components essential to your business operation are installed.

As you proceed through the installation, you will be asked to choose one of the following installation options:

Read the system requirements information in "Installation Requirements," before performing the installation.

Follow these steps to begin installing your WebSpeed products:

  1. See your License Addendum for additional information that you need to install your WebSpeed products. The License Addendum includes the version number, serial number, and control number for your installation. It also provides volume information, the media ID number, and the licensed user limit. Once you complete the installation process, keep the License Addendum in a secure area.
  2. If you have not done so already, read both the online and hard copy Release Notes for the installation. The Release Notes might replace or supplement the installation instructions in this book.
  3. Log in as root. If you do not know the root password for your machine, check with your system administrator.
  4. Insert the installation CD into the CD-ROM drive.
  5. NOTE: You cannot install WebSpeed on an NFS mounted device.

  6. Enter your platform-specific mount command (where device-name is the device you are using for the installation and mount-point is the mount-point directory). Table 6–1 lists the mount commands for each supported platform.
  7. Table 6–1: Mount Commands 
    Operating System
    Mount Command
    HP-UX 11
    (32-bit)
    mount -F cdfs -r -o cdcase device-name mount-point
    For example:
    mount -F cdfs -r -o cdcase /dev/dsk/c0t2d0 /cdrom
    IBM AIX
    4.3.2 (32-bit)
    mount -v cdrfs -r device-name mount-point
    For example:
    mount -v cdrfs -r /dev/cd0 /cdrom
    SCO UnixWare
    7.0
    mount -F cdfs -r -o nmconv=lm,fperm=555,dperm=555
    device-name mount-point
    For example:
    mount -F cdfs -r -o nmconv=lm,fperm=555,dperm=555
    /dev/cdrom/c0b0t210 /cdrom
    Sun Solaris
    SPARC 2.6, 2.7 (32-bit)
    mount -F hsfs -o ro,nrr -r device-name mount-point
    For example:
    mount -F hsfs -o ro,nrr -r /dev/dsk/c0t4d0s0 /cdrom
    Sun Solaris Intel 2.6 and 2.7
    mount -F hsfs -r -o ro,nrr device-name mount-point
    For example:
    mount -F hsfs -r -o ro,nrr /dev/dsk/c0t4d0s0 /cdrom
    Compaq Tru64 UNIX 4.0D
    mount -t cdfs -o noversion device-name mount-point
    For example:
    mount -t cdfs -o noversion /dev/rz3c /cdrom

  8. Enter the following install command:
  9. mount-point/proinst 
    

    NOTE: You cannot run proinst if you are in the mount-point directory.

    The Welcome dialog box appears:

  10. Press RETURN. The Product Configuration Data dialog box appears:
  11. The information you provide depends on whether you are installing all WebSpeed components on the same machine or installing a subset of WebSpeed components and distributing WebSpeed across networked machines.

  12. Type in your company name (any character string is acceptable), the serial number, and the control number from your License Addendum for the first product you want to install. Use the TAB key to move to the next line.
  13. This information is not case sensitive. The installation process automatically converts all letters to uppercase.

    Table 6–2 describes the options available in the Product Configuration Data dialog box.

    Table 6–2: Product Configuration Data Dialog Box Options 
    Option
    Function
    ENTER = Additional
    Confirms that the product information entered is correct and clears the input fields for additional information for another WebSpeed product you want to install. If you enter incorrect information, an error message appears indicating that the information is invalid. Press RETURN, correct the product information, and continue with the installation.
    CTRL-E = Done
    Confirms that the product information entered is correct, and continues to the next step in the installation. The actual key you use to indicate Done varies by terminal type. Refer to the Product Configuration Data dialog box for the appropriate key combination for your terminal. If you enter incorrect information, an error message appears indicating that the information is invalid. Press RETURN, correct the product information, and continue with the installation.
    CTRL-T = Quit
    Quits the Installation Utility.
    The Quit Confirmation dialog box appears. Choose Y to quit or N to continue the installation.
    (When you quit the installation process, the installation utility and all the installation files you copied into your working directory are deleted.)
    CTRL-N = Release Notes
    Displays the online Release Notes .
    Opens the vi emacs editor, which displays the WebSpeed Web Site URL where you can access the Release Notes for the installation. To close the editor, press :q! or ESCAPE ZZ.
    CTRL-V = View
    Displays the selected WebSpeed products for which you entered control numbers.
    TAB = Next Field
    Moves to the next field in the dialog box.

  14. To select an option, highlight the option using the SPACEBAR, TAB, cursor keys, or the accelerator keys that are highlighted in each selection. Press RETURN to execute the selected option.
  15. If you enter incorrect product configuration information, the following error message appears indicating that the data is invalid:

    Press RETURN to correct the product information and continue with the installation. The Product Configuration Data dialog box reappears, allowing you to enter the configuration data for the next product you want to install.

  16. To view the WebSpeed products for which you entered control numbers, press CTRL-V (see Table 6–2):
  17. After viewing the product control numbers that you entered, press RETURN and the Product Configuration Data dialog box reappears, allowing you to enter the configuration data for the next product you want to install.

  18. When you finish entering the control numbers for the products you want to install, press CTRL-E (see Table 6–2). The Done Configuration Data Confirmation dialog box appears:
  19. Type Y to continue with the installation.
  20. If you are installing a WebSpeed product that includes a messenger component, the Before You Start dialog box appears:
  21. To continue with the installation, you must be able to provide the following information:

    • Web Server type—You must know whether the Web server that you are using with WebSpeed is NSAPI- or CGI-compatible. Choose which WebSpeed Messenger to install based on the kind of Web Server you have installed.
    • Web Server script directory—You must know the absolute pathname of the directory that your Web server uses to store scripts. The installation utility installs the WebSpeed CGI Messenger script into that directory. It installs the Messenger executables in install-path/bin.
    • Web Server Document Root directory—You must know the absolute pathname of the directory that your Web server uses to locate static HTML files.
    • Language—You must decide what language you want WebSpeed to use when displaying messages and handling data.
    • Deployment Architecture—You must decide whether you want to install all WebSpeed components on one machine or distribute them across two or more machines.
  22. Press RETURN to continue. For those UNIX platforms on which the JRE/JDK is not automatically included during installation, the following dialog box, or one that is similar, appears:
  23. The JavaHome directory is the Java installation directory.

    NOTE: On these platforms, the installation process searches for the correct version of the JDK residing on the target system before continuing the installation.

  24. Enter a different version/location than the one specified or press RETURN to continue.
  25. The Type, Device and Destination dialog box appears:

    Table 6–3 describes the menu options in the Type, Device and Destination dialog box. To select an option, highlight the option using the SPACEBAR, TAB, cursor keys, or the accelerator keys that are highlighted in each selection. Press ENTER to execute the selected option.

    Table 6–3: Type, Device and Destination Dialog Box Options 
    Option
    Function
    Select Type of
    Installation
    Allows you to select the type of installation you want to perform: Typical, Complete, or Custom.
    Select Destination
    Pathname
    Allows you to change the default destination pathname (/usr/dlc).1
    Continue with
    Installation
    Confirms your selections (or accepts the defaults listed in the status box) and continues with the installation.
    View Release Notes
    Views the latest release notes using the vi or emacs editor.
    When you choose this option, the Installation Utility launches the editor. To exit vi after reading the Release Notes , press :q!. To exit emacs, press CTRL-X and then CTRL-C
    Cancel
    Cancels the previous selection and returns you to the Product Configuration Data dialog box.
    Quit Installation
    Quits the Installation Utility.
    The Quit Confirmation dialog box appears. Choose Y to quit or N to continue the installation.
    (When you quit the installation process, the installation utility and all the installation files you copied into your working directory are deleted.)
    1. If you have Progress or WebSpeed products installed, do not enter the pathname where these products reside.

CAUTION: Do not make your working directory a subdirectory under the installation path. If you uninstall WebSpeed, the working directory is deleted along with the destination directory.
NOTE: Progress Software Corporation recommends that you read both the online and hard-copy Release Notes before continuing with the installation. The Release Notes replace or supplement the installation instructions in this booklet. The online Release Notes appear in the vi or emacs editor.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095