Installing webman The webman program is a shell script that allows users to view the DIGITAL UNIX reference pages using the Netscape World Wide Web browser. The usual place for installation of scripts and other executable Web programs is in a directory named cgi-bin. These programs are often referred to as "cgi-bin" programs. This document explains how to install webman. Prerequisites To use webman, your system must satisfy the following prerequisites: o Configuration as a Web server For security reasons, Web browsers do not permit a user to call for the execution of programs on the user's local system. Calls for cgi-bin programs, including webman, can be handled only through a Web server. DIGITAL UNIX includes a Web browser and the software needed to configure a system as a Web server. You can obtain other server software and configuration instructions from third parties such as Netscape Communications Corporation. When your system is configured as a Web server, it can serve the reference pages to any number of client systems, including itself. o A browser that supports HTML tables Some of the HTML coding used by webman requires a browser that supports HTML table constructs. The Netscape browser provided by DIGITAL includes table support. Other browsers might not work properly with webman. o The OSFDCMTnnn subset - contains tools used by webman This subset, where nnn represents the current 3-digit version ID of the operating system subsets, must be installed before webman can be used. Installation The webman installation requires the following files, all of which are provided in the /usr/share/doclib/online/DOCS/HTML/webman directory when the DIGITAL UNIX documentation CD-ROM is correctly mounted: o webman - the actual cgi-bin script When your system is configured as a Web server, the HTTP daemon is installed in a directory named httpd. This directory might be /httpd, or it might be in some other location. The webman script must be installed in the cgi-bin subdirectory immediately beneath the httpd directory. If no cgi-bin directory exists, create it and then place webman there. Check that the permissions on webman are 755 and that its ownership is root:system. o webman.cat - the localized message catalog used by webman This file must be placed in the cgi-bin directory along with webman. Check that its permissions are 644 and that its ownership is root:system. o webman.msg - the localizable source file from which webman.cat is generated This file is provided so that versions other than English can be made. It is not necessary to install this file on the system in order to run webman. (To generate a new webman.cat file, edit a copy of webman.msg and compile a new webman.cat by following the instructions in webman.msg.) o MANHELP.html - online instructions for using webman This file provides easily available online information for webman users. It must be installed in the /usr/doc/netscape directory in order for webman to access it. Check that its permissions are 644 and that its ownership is root:system. After installing the webman software, you must create a hot link for webman in the DIGITAL UNIX home page. The home page is contained in the following file: /usr/doc/netscape/Digital_UNIX.html Add the hot link for webman by following this procedure: 1. Edit the /usr/doc/netscape/Digital_UNIX.html file using your favorite text editor. 2 Installing webman 2. Find the list of hot links. This list is coded as a table. Each of the list items is coded as a definition, beginning with a
tag and ending with a tag. 3. Between the first and second list items, add the following new item:
   DIGITAL UNIX reference pages 4. In the hot link you have just added, replace the word SERVER. with the name you have assigned to your Web server (for example, www.gunther.com). 5. Save the edited file and quit from the editor. Installing webman 3