README: SAS/IntrNet CGI Tools
Release 8.2 for OS/390

This package contains SAS/IntrNet CGI components and samples to be installed on a Web server. The following components are included:

Note: You must install Release 8.2 of the SAS System, including SAS/IntrNet software, somewhere on your network to use the contents of this package.

Unpacking This Package

  1. Create a temporary directory to hold the contents of this package. This directory will be used only during the installation process and can be deleted after the installation is complete. For example:
    mkdir /tmp/inet

  2. The CGI Tools package is a tar format file. If you are downloading from the SAS Institute Web site, the package is also compressed with the UNIX compress utility. Click on the package name in the table to download the package. Direct your browser to save the file in the directory you created above.

  3. If necessary, use the uncompress command:
    uncompress websrv.tar.Z

  4. Unpack the package with the tar command:
    tar -xof websrv.tar
You have now unpacked the CGI Tools package. You should see a websrv subdirectory that contains all of the files in this package. Read the instructions below to install the components. If you wish to install the CGI Tools package manually without the INSTALL script, see the Alternate Manual Installation section below.

Installing the CGI Tools

  1. Change to the websrv directory created when you unpacked the CGI Tools package.

  2. Run the INSTALL script by issuing the following command: 
      INSTALL
    The install script will prompt for Web server configuration data and then install the package contents. An example installation is shown below. 
      Welcome to the SAS/IntrNet CGI Tools installation script.

  You will be prompted for information about your Web server
  configuration and how you wish to install SAS/IntrNet.
  This installation script will move the files that were       
  extracted from the CGI Tools package into a directory under
  your Web server.  You will be able to review and confirm
  your responses before any updates are made to your system.

  The CGI Tools samples must be installed in the Web server
  directory corresponding to the URL http://<your_server>/sasweb.

  Enter the physical path corresponding to http://<your_server>/sasweb.
  If this directory does not exist, it will be created for you.
  Path: <return>

  /httpd/sasweb does not exist.
  Do you wish to create it [Y]? <return>
  /httpd/sasweb created

  Enter the physical path for SAS/IntrNet CGI executables.   
  This can be a standard CGI directory or a new directory    
  reserved for SAS/IntrNet.  Setup will create this          
  directory for you if it does not exist.

  Path [/httpd/cgi-bin]: <return>

  /httpd/cgi-bin does not exist.
  Do you wish to create it [Y]? <return>
  /httpd/cgi-bin created

  The CGI executables and configuration files must be installed
  in a Web server directory with execute privilege.  We suggest
  using the URL http://<your_server>/cgi-bin for these files,
  although you may use any URL.

  Enter the URL path corresponding to the physical path /httpd/cgi-bin
  CGI URL [http://<your_server>/cgi-bin]: <return>

  The following steps will be performed:

  - Sample files will be installed to /httpd/sasweb/IntrNet8.  Existing 
    files will be overwritten.
   
  - CGI executables and configuration files will be installed to 
    /httpd/cgi-bin.  Existing executables will be renamed as a backup 
    before the new executables are installed.  New configuration files 
    are installed with a .cfg_v8 extension so that existing configuration
    files are not overwritten.  If no existing configuration file is 
    found the .cfg_v8 file is copied to create a new .cfg file.
   
  - Java Graphics files will be moved to /httpd/sasweb/graph.  Existing 
    files will be renamed as a backup.
 
  Do you wish to continue [Y]? <return>

  Moving samples to /httpd/sasweb/IntrNet8

  Moving CGI files to /httpd/cgi-bin

  Moving Java Graphics files to /httpd/sasweb/graph

  The installation is complete.  Verify that your Web server is
  configured to:

   - map http://<your_server>/cgi-bin to /httpd/cgi-bin
   - allow CGI execution in http://<your_server>/cgi-bin
   - map http://<your_server>/sasweb to /httpd/sasweb

  Once your SAS Servers are configured and started, you can view
  SAS/IntrNet samples at http://<your_server>/sasweb/IntrNet8/samples.html.
  3. Verify that your Web server is configured to execute CGI programs in the path you selected in the installation script. You can test the installation by viewing the Application Broker URL with a Web browser. For example, enter http://<your_server>/cgi-bin/broker? and you will see a version message if the CGI Tools were installed and the Web server is configured correctly.

  4. Verify that your Web server is configured to serve the SAS/IntrNet samples from the path you specified in the installation script. You can test the installation by viewing the main samples page at http://<your_server>/sasweb/IntrNet8/samples.html. The samples will not be functional until you complete the configuration steps listed below.
SAS/IntrNet CGI Tools are now installed on your Web server. See the following sections for information on configuring and using the components contained in this package. See the product documentation on the SAS Client Side Components CD or at http://support.sas.com/documentation/onlinedoc/intrnet/index.html for full information.

Alternate Manual Installation

You can install the contents of this package without using the INSTALL script. You do not need to perform these steps if you ran the INSTALL script described above.
  1. Move the contents of the websrv/sasweb/cgi-bin directory to the Web server directory on your system for CGI executables. Be careful to backup any existing files if you are upgrading an existing installation.

  2. The websrv/sasweb/cgi-bin directory contains template configuration files (broker.cfg_v8 and htmSQL.cfg_v8) for each of the CGI components. If this is a first-time SAS/IntrNet CGI Tools installation, copy these templates to create initial configuration files: 
      cd  your-CGI-executable-directory
  cp  broker.cfg_v8  broker.cfg
  cp  htmSQL.cfg_v8  htmSQL.cfg
    Note: DO NOT copy these templates over an existing configuration file. See the documentation for each CGI component for information on updating the configuration file for this release.

  3. Create a directory on your Web server corresponding to the URL http://<your_server>/sasweb.

  4. Move the websrv/sasweb/graph directory to the Web server directory you created above. This step moves the Java Graphics components to the URL http://<your_server>/sasweb/graph.

  5. Move the websrv/sasweb/IntrNet8 directory to the Web server directory you created above (corresponding to the URL http://<your_server>/sasweb). This step moves the SAS/IntrNet samples and tools to the URL http://<your_server>/sasweb/IntrNet8.

  6. The SAS/IntrNet samples assume the CGI executables are installed in the URL http://<your_server>/sasweb/cgi-bin. If you chose a different directory in step 1 above, you must edit the sample HTML files in the directory corresponding to http://<your_server>/sasweb/IntrNet8 and its subdirectories. Change all occurrences of the string "/sasweb/cgi-bin" to the URL path for your CGI executables. There are approximately 20 HTML files that must be edited.

  7. Verify that your Web server is configured to execute CGI programs in the path you selected for your CGI executables. You can test the installation by viewing the Application Broker URL with a Web browser. For example, enter http://<your_server>/sasweb/cgi-bin/broker? and you will see a version message if the CGI Tools were installed and the Web server is configured correctly.

  8. Verify that your Web server is configured to serve the SAS/IntrNet samples. You can test the installation by viewing the main samples page at http://<your_server>/sasweb/IntrNet8/samples.html. The samples will not be functional until you complete the configuration steps listed below.

SAS/IntrNet CGI Tools are now installed on your Web server. See the following sections for information on configuring and using the components contained in this package. See the product documentation on the SAS Client-Side Components CD or at http://support.sas.com/documentation/onlinedoc/intrnet/index.html for full information.

Using Application Dispatcher

Application Broker

If this is the first time you are installing the Application Broker on this system, you must update the broker.cfg file in the cgi-bin directory to include the location of your Application Server(s). See the Completing the Installation section of the Application Dispatcher documentation for more information. If this is an upgrade installation, see the Upgrading From a Previous Version section of the documentation.

Load Manager

The Load Manager executable can be found in the tools directory under the sasweb/IntrNet8 directory you created during the installation. See the Application Dispatcher documentation for more information on the Load Manager.

Samples

Application Dispatcher samples and the Xplore sample application can be found on the SAS/IntrNet CGI Tools samples page at http://<your_server>/sasweb/IntrNet8/samples.html.

Using htmSQL

If this is the first time you are installing htmSQL on this system, you should review the htmSQL.cfg file in the cgi-bin directory to verify that the options in the default file are suitable for your system. You must also set up a data source definition file using the dsdef utility contained in the sasweb/IntrNet8/tools directory. See the htmSQL documentation for more information.

Samples

htmSQL samples can be found on the SAS/IntrNet CGI Tools samples page at http://<your_server>/sasweb/IntrNet8/samples.html.