README: SAS/IntrNet CGI Tools
Release 8.2 for Windows

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.

Installing the CGI Tools

This package is a zip format file. An executable setup program (websrv.exe) is available on the SAS/IntrNet CD or at the SAS Institute web site. The executable setup program is recommended unless you have special installation requirements that cannot be performed by the install script. Installing manually using this zip file may make future upgrades to SAS/IntrNet harder to install.

Perform the following steps to install SAS/IntrNet CGI Tools.

  1. Download or copy the websrv.zip file to a temporary directory such as C:\TEMP.

  2. Unzip the package. This will create a websrv subdirectory under your temporary directory.

  3. 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.

  4. The websrv\sasweb\cgi-bin directory contains template configuration files (broker.cfg_v8, htmSQL.cfg_v8, and shrcgi.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
  copy  broker.cfg_v8  broker.cfg
  copy  htmSQL.cfg_v8  htmSQL.cfg
  copy  shrcgi.cfg_v8  shrcgi.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.

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

  6. Move the websrv\sasweb\graph directory to the web server directory you created above. This step will move the Java Graphics components to the URL http://<your_server>/sasweb/graph.

  7. Move the websrv\sasweb\IntrNet8 directory to the web server directory you created above (corresponding to the URL http://<your_server>/sasweb). This step will move the SAS/IntrNet samples and tools to the URL http://<your_server>/sasweb/IntrNet8.

  8. 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 3 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.

  9. 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.exe? and you will see a version message if the CGI Tools were installed and the Web server is configured correctly.

  10. 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 executable 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 executable 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.exe 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.

Using the Tunnel Feature for Java Tools

The Tunnel Feature Server Programs enable the tunnel feature for Java Tools applications served by this Web server. If this is the first time you are installing the Server Programs on this Web server, modify the configuration file (shrcgi.cfg) in the CGI executable directory by following the instructions in the file.

You can test your installation with a Web browser. Enter the URL corresponding to the shrcgi program (for example, http://<your_server>/sasweb/cgi-bin/shrcgi.exe?). A page will be displayed showing environment variable settings for the Tunnel Feature Server Programs. An error will be displayed if the server program is not installed or configured properly.