README: SAS/IntrNet CGI Tools
Release 8.2 for CMS

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

Application Dispatcher components
- Application Broker
- Samples
Xplore Sample Application
MDDB Report Viewer
htmSQL
Java Graphics components

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

The CGI Tools package is a tar format file. Obtain read/write access to a minidisk or SFS directory with sufficient space to contain the tar file. Click on the package name in the table to download the tar file. If downloading directly to CMS, direct your browser to save the file to the minidisk or SFS directory. If downloading from another platform, move the tar file to CMS via FTP or other suitable method. The download and any subsequent transfers must be done in BINARY mode. If you use a method that gives you control over record format and length, we suggest FIXED 512. However any record format and length will do.
You also need to download the CMSSETUP EXEC. This file must also be transferred in BINARY mode, and again the recfm and lrecl are not critical but we suggest FIXED 512. Note that unlike most execs, CMSSETUP EXEC is a binary file. Do not attempt to edit it.
CMSSETUP is a self-extracting exec. Issue the following command:
```
     CMSSETUP
```
and it will create the files UNTAR EXEC and UNTAR REXX.
Although the tar file may be stored either on minidisk or SFS, the package itself must be installed in SFS space, not minidisk. The remaining installation steps must be performed while you are logged onto the userid that owns the SFS filespace where the package will be installed.
Unpack the package with the UNTAR command:
```
     UNTAR WEBSRV TAR fm|dirid .
```
where WEBSRV TAR is the name of the tar file, "fm|dirid" is the filemode or SFS directory where the tar file is located, and "." represents the root directory of your SFS filespace. The tar file will be unpacked into subdirectories under this directory. Subsequent installation steps described below will move the files from this directory structure to their final locations.

You have now unpacked the CGI Tools package. You should see a .WEBSRV subdirectory that contains all of the files in this package. Follow the instructions below to install the components.

Installing the CGI Tools

Access the .WEBSRV directory you created above as A:
```
     ACCESS .WEBSRV A
```

Run the INSTALL exec by issuing the following command:

     INSTALL

The INSTALL exec 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 exec.

   You will be prompted for information about your Web server
   configuration and how you wish to install SAS/IntrNet.
   You will be able to review and confirm your responses
   before any updates are made to your system.

   Most prompts have a default response shown in parentheses.
   Simply pressing ENTER will select the default response.

   At any prompt you can enter END, EXIT, QUIT or STOP to terminate this exec.
   At any prompt you can enter ? to redisplay the prompt.

   The CGI Tools samples can be installed under one of the following
   base URLs:

   1: http://your_server/sasweb
   2: http://your_server/~ewebadm/sasweb

   Choice 1 is recommended if feasible.

   Enter your choice, 1 or 2.
   base URL (1):
   <enter>

   Enter the SFS directory corresponding to the URL
   http://your_server/
   Path (.WEBSHARE):
   .eweb

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

   Enter the SFS directory corresponding to http://your_server/sasweb/.
   Path (DEVCMS:EWEBADM.EWEB.sasweb):
   <enter>

   DEVCMS:EWEBADM.EWEB.SASWEB does not exist.
   Do you wish to create it (Y):
   <enter>
   DEVCMS:EWEBADM.EWEB.SASWEB created
   Enter the URL where you wish to install CGI executables.

   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/sasweb/htbin/ for these files,
   although you may use any URL.

   URL (http://your_server/sasweb/htbin):
   <enter>

   Enter the SFS directory corresponding to http://your_server/sasweb/htbin
   Path (DEVCMS:EWEBADM.EWEB.sasweb.htbin):
   <enter>

   DEVCMS:EWEBADM.EWEB.sasweb.htbin does not exist.
   Do you wish to create it (Y):
   <enter>

   DEVCMS:EWEBADM.EWEB.sasweb.htbin created
   Select a CGI URL format

   Which CGI URL format does your web server require?
   1. filename, no extension, slash separator (CGI standard)
      example: /sasweb/htbin/broker/
   2. filename, no extension, semicolon separator (e.g., Webshare)
      example: /sasweb/htbin/broker;
   3. filename, extension, slash separator
      example: /sasweb/htbin/broker.cgi/
   4. filename, extension, semicolon separator (e.g., EnterpriseWeb/VM)
      example: /sasweb/htbin/broker.cgi;
   5. other
   Enter a choice from 1 to 5:
   4
   Sample files will contain CGI URLs in the format: /sasweb/htbin/broker.cgi;

   The following steps will be performed:

   - Sample files will be updated to use /sasweb/htbin
     for all CGI references.
   - Sample files will be moved to DEVCMS:EWEBADM.EWEB.SASWEB.IntrNet8.
   - CGI executables will be moved to DEVCMS:EWEBADM.EWEB.sasweb.htbin.
     Any existing files will be renamed instead of overwritten.
   - Template CGI configuration files will be moved to
     DEVCMS:EWEBADM.EWEB.sasweb.htbin if no existing configuration
     files are found.
   - Java Graphics files will be moved to DEVCMS:EWEBADM.EWEB.SASWEB.graph.

   Do you wish to continue (Y):
   <enter>

   Modifying URL to CGI Tools in sample files

   Moving http://your_server/sasweb/IntrNet8 files to DEVCMS:EWEBADM.EWEB.SASWEB.IntrNet8

   Moving http://your_server/sasweb/htbin files to DEVCMS:EWEBADM.EWEB.sasweb.htbin

   Moving Java Graphics files to DEVCMS:EWEBADM.EWEB.SASWEB.graph


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

    - map http://your_server/sasweb/htbin to DEVCMS:EWEBADM.EWEB.sasweb.htbin
    - allow CGI execution in http://your_server/sasweb/htbin
    - map http://your_server/sasweb/ to DEVCMS:EWEBADM.EWEB.SASWEB

   Once your SAS Servers are configured and started, you can view
   SAS/IntrNet samples at http://your_server/sasweb/IntrNet8/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>/sasweb/htbin/broker? (add the .cgi extension to broker if required by your server) 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 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.

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 CONFIG file in the htbin directory to include the location of your Application Server(s). See the Completing the Installation section of the Application Dispatcher documentation for more information.

Also you must edit BROKER CGI in the htbin directory and change the value of the config_path variable to be the SFS directory where the BROKER CONFIG file is installed.

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 CONFIG file in the htbin 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.

README: SAS/IntrNet CGI Tools Release 8.2 for CMS

Unpacking This Package

Installing the CGI Tools

Using Application Dispatcher

Application Broker

Samples

Using htmSQL

Samples

README: SAS/IntrNet CGI Tools
Release 8.2 for CMS