Installing webman The _w_e_b_m_a_n program is a shell script that allows users to view the Tru64 UNIX reference pages using a 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", or CGI, 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 programs, including _w_e_b_m_a_n, can be handled only through a Web server. Tru64 UNIX includes a copy of the Netscape FastTrack Web server software. 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 generated by _w_e_b_m_a_n requires a browser that supports HTML table constructs. The Netscape browser provided with Tru64 UNIX includes table support. Other browsers, especially very old ones, might not work properly with _w_e_b_m_a_n. +o The _O_S_F_D_C_M_Tnnn 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_S/_H_T_M_L/_w_e_b_m_a_n directory when the Tru64 UNIX documentation CD-ROM is correctly mounted: +o _w_e_b_m_a_n - the actual CGI script When your system is configured as a Web server, the HTTP daemon is usually 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 webman 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 The _w_e_b_m_a_n-_c_o_n_t_e_n_t directory - the help file and graphics used by _w_e_b_m_a_n: - _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 can also be translated for versions other than English. - _i_m_a_g_e_s - graphics directory This directory contains image files used by _w_e_b_m_a_n. The _w_e_b_m_a_n-_c_o_n_t_e_n_t directory must be installed in the server's primary content directory in order for _w_e_b_m_a_n to access it; for example, if you have specified /_u_s_r/_d_o_c/_n_e_t_s_c_a_p_e as the primary content directory, then you should copy _w_e_b_m_a_n-_c_o_n_t_e_n_t to that directory. Use the _c_p command's -_r and -_p options. Check that the ownership of the copied area is _r_o_o_t:_s_y_s_t_e_m. 2 Installing webman After installing the _w_e_b_m_a_n software, you must enable a hot link for _w_e_b_m_a_n in the Tru64 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 Enable 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. Find the list of hot links. This list is coded as a table, with each hot link contained in a single cell. For appearance, the table is laid out so that each table row appears as one item in the list. 3. The entry for _w_e_b_m_a_n is already in the table, but it is commented out. To enable it, remove the following two lines: - This line is immediately after the end of the table row for _w_e_b_m_a_n. Remove these two lines completely to enable the table entry for _w_e_b_m_a_n to appear. 4. In the hot link you have just enabled, 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 test it. When it works properly, quit from the editor. Installing webman 3