This part of the installation can normally only be done by the system manager.
In order to use this package to browse source code using a World Wide Web browser, the browser script scb.pl must be installed as a CGI (Common Gateway Interface) program on a computer running an HTTP server. For this purpose, the browser script is copied by the package installation process (the mk install step) into INSTALL/bin/cgi as well as into INSTALL/bin.
A full discussion of the setup of CGI programs is beyond the scope of this document, but by way of example, if the HTTP server being used is Apache, it will typically be necessary to add a stanza like the following to Apache's conf/access.conf file:
and a line like the following to the conf/srm.conf file:<Directory /star/bin/cgi> Options ExecCGI </Directory>
Alternatively, the script INSTALL/bin/cgi/scb.pl may be copied into an existing CGI directory; if correctly installed it should still work if its name or location are changed.ScriptAlias /cgi-bin/star/ /star/bin/cgi/
Every attempt has been made to make the CGI script secure against abuse by users of the browsing facility, but provision of any CGI program is an inherently risky business. It should also be noted that the browser program can use significant system resources which might make it possible for users of the service intentionally or unintentionally to degrade performance of the server. In particular, heavy use may be made of the following resources:
In this case no temporary disk space will be used, and much reduced disk activity will be required by the browser program. The disadvantage of doing this is increased use of disk space in the SCB_SOURCES directory (by around 250MB for the full unbuilt source code collection).setenv SCB_SOURCES /star/sources foreach tarfile (`find $SCB_SOURCES -name \*.tar -print`) cd $tarfile:h tar xf $tarfile:t end
SCB --- Source Code Browser