Installation Instructions: SAS/IntrNet CGI Tools
Release 9.1.3 for UNIX

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

• Application Dispatcher components (see support.sas.com/rnd/web/intrnet/dispatch)
  • Application Broker
  • Load Manager
  • Samples
• Xplore Sample Application (see support.sas.com/rnd/web/intrnet/xplore)
• MDDB Report Viewer (see support.sas.com/rnd/web/intrnet/mddbapp)
• htmSQL (see support.sas.com/rnd/web/intrnet/htmSQL)
• Tunnel Feature Server Programs for Java Tools (see support.sas.com/rnd/web/intrnet/java/tunnel) - not available on all UNIX platforms
• Java Graphics components

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

Installing and Extracting the Tar File Archive

1. On the CGI Tools for the Web Server page, click the Install link for the appropriate platform.

2. The Save Archive window is displayed. Enter a target directory in the Install Archived Product Here text field. The tar file will be extracted into a websrv subdirectory under this directory. For example, if you enter /usr/local/SAS, the archive will be extracted into /usr/local/SAS/websrv.

3. If the extraction is successful, the Install Succeeded window will be displayed. Click the OK button to continue.

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/IntrNet9.  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_v9 extension so that existing configuration
       files are not overwritten.  If no existing configuration file is 
       found the .cfg_v9 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/IntrNet9
   
     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/IntrNet9/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.

   Note: Some Web servers require that you add a .cgi extension to CGI programs. Consult your Web server documentation for more information. If so, you must rename the broker, htmSQL, and shrcgi (if available on this system) files in the cgi-bin directory to broker.cgi, htmSQL.cgi, and shrcgi.cgi. You must also update any HTML files (including the samples in this package) that refer to these CGI URLs.

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/IntrNet9/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 at support.sas.com/rnd/web/intrnet 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_v9, htmSQL.cfg_v9, and shrcgi.cfg_v9) 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_v9  broker.cfg
     cp  htmSQL.cfg_v9  htmSQL.cfg
     cp  shrcgi.cfg_v9  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.

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/IntrNet9 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/IntrNet9.

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/IntrNet9 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/IntrNet9/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 at support.sas.com/rnd/web/intrnet 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 section of the documentation.

Load Manager

The Load Manager executable can be found in the tools directory under the sasweb/IntrNet9 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/IntrNet9/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/IntrNet9/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/IntrNet9/samples.html.

Using the Tunnel Feature for Java Tools

The Tunnel Feature Server Programs enable tunneling for Java Tools applications served by this Web server. The Tunnel feature is available only on AIX, Compaq Tru64 UNIX, HP-UX, Solaris and Windows platforms.

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-bin 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>/cgi-bin/shrcgi?). 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.

---

Copyright © 2004 SAS Institute Inc., Cary, NC, USA. All Rights Reserved.