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.
tarformat 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.
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 EXECis a binary file. Do not attempt to edit it.
CMSSETUPis a self-extracting exec. Issue the following command:
CMSSETUPand it will create the files
Unpack the package with the
UNTAR WEBSRV TAR fm|dirid .where
WEBSRV TARis 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
subdirectory that contains all of the files in this package. Follow the
instructions below to install the components.
.WEBSRVdirectory you created above as A:
ACCESS .WEBSRV A
INSTALLexec by issuing the following command:
INSTALLexec 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.
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.
http://<your_server>/sasweb/IntrNet8/samples.html. The samples will not be functional until you complete the configuration steps listed below.
BROKER CONFIGfile in the
htbindirectory 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.
HTMSQL CONFIGfile in the
htbindirectory 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
DSDEFutility contained in the
sasweb/IntrNet8/toolsdirectory. See the htmSQL documentation for more information.