Installing webman The _w_e_b_m_a_n 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 _c_g_i-_b_i_n. These programs are often referred to as "cgi-bin" programs. This document explains how to install _w_e_b_m_a_n. _P_r_e_r_e_q_u_i_s_i_t_e_s To use _w_e_b_m_a_n, 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 _w_e_b_m_a_n, can be handled only through a Web server. Digital UNIX includes a Web browser but does not include all the software needed to configure a system as a Web server. You can obtain 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 _w_e_b_m_a_n requires a browser that supports HTML table constructs. The Netscape browser provided by Digital includes table support. Other browsers might not work properly with _w_e_b_m_a_n. +o The OSFDCMTnnn subset - contains tools used by _w_e_b_m_a_n This subset, where nnn represents the current 3-digit version ID of the operating system subsets, must be installed before _w_e_b_m_a_n can be used. _I_n_s_t_a_l_l_a_t_i_o_n The _w_e_b_m_a_n installation requires the following files, all of which are provided in the /_u_s_r/_s_h_a_r_e/_d_o_c_l_i_b/_o_n_l_i_n_e/_D_O_C_U_M_E_N_T_A_T_I_O_N/_H_T_M_L/_w_e_b_m_a_n directory when the Digital UNIX documentation CD-ROM is correctly mounted: +o _w_e_b_m_a_n - the actual cgi-bin script When your system is configured as a Web server, the HTTP daemon is installed in a directory named _h_t_t_p_d. This directory might be /_h_t_t_p_d, or it might be in some other location. The _w_e_b_m_a_n script must be installed in the _c_g_i-_b_i_n subdirectory immediately beneath the _h_t_t_p_d directory. If no _c_g_i-_b_i_n directory exists, create it and then place _w_e_b_m_a_n there. Check that the permissions on _w_e_b_m_a_n are 755 and that its ownership is _r_o_o_t:_s_y_s_t_e_m. +o _w_e_b_m_a_n._c_a_t - the localized message catalog used by _w_e_b_m_a_n This file must be placed in the _c_g_i-_b_i_n directory along with _w_e_b_m_a_n. Check that its permissions are 644 and that its ownership is _r_o_o_t:_s_y_s_t_e_m. +o _w_e_b_m_a_n._m_s_g - the localizable source file from which _w_e_b_m_a_n._c_a_t 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 _w_e_b_m_a_n. (To generate a new _w_e_b_m_a_n._c_a_t file, edit a copy of _w_e_b_m_a_n._m_s_g and compile a new _w_e_b_m_a_n._c_a_t by following the instructions in _w_e_b_m_a_n._m_s_g.) +o _M_A_N_H_E_L_P._h_t_m_l - online instructions for using _w_e_b_m_a_n This file provides easily available online information for _w_e_b_m_a_n users. It must be installed in the /_u_s_r/_d_o_c/_n_e_t_s_c_a_p_e directory in order for _w_e_b_m_a_n to access it. Check that its permissions are 644 and that its ownership is _r_o_o_t:_s_y_s_t_e_m. After installing the _w_e_b_m_a_n software, you must create a hot link for _w_e_b_m_a_n in the Digital UNIX home page. The home page is contained in the following file: /_u_s_r/_d_o_c/_n_e_t_s_c_a_p_e/_D_i_g_i_t_a_l__U_N_I_X._h_t_m_l Add the hot link for _w_e_b_m_a_n by following this procedure: 1. Edit the /_u_s_r/_d_o_c/_n_e_t_s_c_a_p_e/_D_i_g_i_t_a_l__U_N_I_X._h_t_m_l file using your favorite text editor. 2 Installing webman 2. Find the list of hot links. This list is a definition list. Each of the list items is coded as a definition, beginning with a <_d_t> 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 _S_E_R_V_E_R. with the name you have assigned to your Web server (for example, _w_w_w._g_u_n_t_h_e_r._c_o_m). 5. Save the edited file and quit from the editor. Installing webman 3