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. PPPPrrrreeeerrrreeeeqqqquuuuiiiissssiiiitttteeeessss 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 Compaq Secure 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 _w_e_b_m_a_n utility to any number of client systems, including itself. +o A browser that supports HTML tables, forms, and JavaScript 1.1 (for example, Netscape Navigator or Communicator Version 4.0 or higher, or Microsoft Internet Explorer Version 4.0 or higher) The Netscape browser provided with Tru64 UNIX includes the required 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. IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn This section describes how to install the _w_e_b_m_a_n utility. _N_o_t_e The following instructions specify directories into which you must place the files making up the _i_s_e_a_r_c_h utility. Do not attempt to place any of the files in other locations; there are interlocking HTML links between the _w_e_b_m_a_n utility and its content files, and the utility will not work correctly if any of the files are not where they are expected to be. Similarly, you must not change the names of any of the files. 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 The _w_e_b_m_a_n script must be installed in the server-level _c_g_i-_b_i_n directory. If you have not configured a _c_g_i-_b_i_n directory, configure it and then place the script files there. The directory must be named _c_g_i-_b_i_n, and it must be at the top of the site so that its Web location is as follows: _h_t_t_p://your.server.domain/_c_g_i-_b_i_n/ Check that the permissions on the _w_e_b_m_a_n script are 755 and that their 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 2 Installing webman _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 - image file directory This directory contains several 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 /_d_a_t_a/_w_e_b/_p_u_b_l_i_c as the primary content directory, then you must 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. MMMMaaaakkkkiiiinnnngggg wwwweeeebbbbmmmmaaaannnn AAAAvvvvaaaaiiiillllaaaabbbblllleeee ttttoooo UUUUsssseeeerrrrssss 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/_T_r_u_6_4__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/_T_r_u_6_4__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: Installing webman 3 - 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. 4 Installing webman