Installation Instructions: SAS/IntrNet CGI Tools
Release 9.1.3 for HP-UX for the Itanium Processor Family Architecture

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)
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

On the CGI Tools for the Web Server page, click the Install link for the appropriate platform.
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.
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

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

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.

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, and shrcgi (if available on this system) files in the cgi-bin directory to broker.cgi, and shrcgi.cgi. You must also update any HTML files (including the samples in this package) that refer to these CGI URLs.
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.

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.
The websrv/sasweb/cgi-bin directory contains template configuration files (broker.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  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.
Create a directory on your Web server corresponding to the URL http://<your_server>/sasweb.
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.
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.
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.
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.
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.

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

SAS/IntrNet CGI Tools

Installation Instructions: SAS/IntrNet CGI Tools Release 9.1.3 for HP-UX for the Itanium Processor Family Architecture