The Tunnel Feature Server Programs: README

You must install the tunnel feature server programs in order to use the tunnel feature. The tunnel feature server programs are CGI programs that reside on a Web server. If you do not have access to the Web server, pass these instructions to your Web administrator.

Note: Be sure that you install the tunnel feature on the same Web server machine where you installed your SAS Java archive.

To install the tunnel feature server programs, complete the following steps:

After unpacking the tunnel feature package, examine the resulting directory structure. You should see a tunnel subdirectory that contains all of the files in this package. Compare the tunnel subdirectory to the information in the package contents file.
Ensure that you have a directory on your Web server for CGI programs. This directory is usually created during the installation of the Web server and is often called cgi-bin or scripts. (For documentation purposes, these instructions refer to your CGI directory as cgi-bin. If your directory is named differently, ensure that you substitute the correct name in the instructions and examples.)
Copy the executable program files (shrcgi and shrproc) to the cgi-bin directory on your Web server machine. Some Web servers require that you add a .cgi extension to the shrcgi executable program file (shrcgi.cgi); consult your Web server documentation for more information.
If this is the first time you are installing the tunnel feature server programs on this system, copy the configuration file template (shrcgi.cfg) to the cgi-bin directory. Modify the configuration file template by following the instructions included in the template file, or use the directions provided in the online documentation. (You can view the tunnel feature documentation at http://www.sas.com/rnd/web/java/tunnel/index.html.)
Use a Web browser to test your installation. Enter the URL that corresponds to the location of the tunnel feature server programs, and add a question mark (?) to the end of the URL. For example, if the URL to the tunnel feature server programs is
```
   http://your_server/cgi-bin/shrcgi
```
you would enter
```
   http://your_server/cgi-bin/shrcgi?
```
If the programs were installed properly and you entered the right URL, a page will be displayed that provides information about the environment variable settings associated with the programs. If the programs were not installed properly or you entered the wrong URL, your Web browser will return an error message.

After you have completed all of the above steps, you should be able to use your Web browser to run the tunneled applets you create.