Version History

Installation notes:

The distribution package consists of this documentation and three files (cgi-pipe, ppclient, and ppSrvr). The following paragraphs describe where to place copies on your server and how to configure it to use them.

1.httpd.confThis existing file (use the Finder's "Go to folder ..." command to get to it) in /etc/httpd/ needs to be edited to establish an action and associate it with the desired extension (.acgi) It also needs to rigidly send all such actions to the "cgi-pipe" shell script, which should be located in the CGI-Executables folder. This can be accomplished by adding the following two lines to the httpd.conf file near the bottom.
Action acgi /cgi-bin/cgi-pipe
AddHandler acgi .acgi

After making these changes, use System Preferences to Stop and reStart Personal Web Sharing.

2.cgi-pipeThis shell script assembles the necessary shell environment variables, hands them to the ppclient application, and passes back the results. It needs to be copied to the CGI-Executables folder (matching the Action declaration given in httpd.conf, above). The TCP/IP port number (5555, in this case) included in the command to ppclient MUST match that given to the server when it is launched.
3.ppSrvris the heart of the system. It is run from a Terminal window command line, and must be running at any time CGI execution is needed (the CGIs themselves will be launched if not already running). It may be convenient to locate it in the home directory of the user who will be logged on when the server is running (as this is the default working directory for Terminal) but it can be anywhere on the server. When launched, it is given a port number, using a command like this (at the shell prompt):
./ppsrvr 5555
4.ppclientneeds to exist in the CGI-Executables folder where it can be run by the cgi-pipe script. The script includes a port number reference that must match that used when starting ppSrvr (5555 by default).