16.5 Installing Online Manuals

16.6 Invoking Documentation Search Service

You must log out and log in again after the Documentation Search Service has been configured so that you will pick up the environment variables set up during the configuration.

If you are running the CDE desktop environment, double-click the Documentation Search Service icon in the Application Manager window.

Alternatively, you can use the command docsearch to invoke the documentation search service. Your Web browser will start, and you should see the Documentation Search Service page. Netscape is used as the default Web browser for this discussion.

You can invoke the Documentation Search Service without installing the docsearch client component. In fact, you do not even need to invoke the documentation search service from an AIX machine. You can do this by first invoking the browser and entering the following URL:

http://<server_name>[:<port_number>]/cgi-bin/ds_form

This URL points to a global search form on the document server where the name of the remote server is given in server_name. The port_number only needs to be entered if the port is different from 80.

If you have not run Netscape previously, a series of informational messages and windows will be shown while Netscape is setting up the environment in your home directory. This is standard behavior for the first execution of Netscape. The messages will not be shown again the next time you start Netscape.

The top part of the Documentation Search Service page allows you to specify your search criteria, and the bottom part shows what online manuals have been installed. The following shows the documentation search service page with only the command reference manuals and the programming guide manuals installed (Figure 147).



Figure 147: Documentation Search Service

If you have a problem starting the Documentation Search Service, check the following environment variables. These environment variables may be set, displayed, and changed using SMIT. Start SMIT, select System Environments, then select Internet and Documentation Services.

• On the client machine
  1. Invoke the Web browser manually and enter the URL http://<server_name>[:<port_number>]/cgi-bin/ds_form to ensure that the server is up and running.

  2. Ensure the DEFAULT_BROWSER variable is set to the command for starting your Web browser.

     Use the command echo $DEFAULT_BROWSER to find out the command used in starting the browser. Test whether that command can bring up the browser by manually entering it on the command line.

  3. Ensure the DOCUMENT_SERVER_MACHINE_NAME variable is set to the document server's hostname or IP address.

  4. Ensure the DOCUMENT_SERVER_PORT variable is set to the port address used by the document server's port address.

• On the server machine
  1. Ensure the DEFAULT_BROWSER variable is set to the command for starting your Web browser.

     Use the command echo $DEFAULT_BROWSER to find out the command used in starting the browser. Test whether that command can bring up the browser by manually entering it on the command line.

  2. Ensure the DOCUMENT_SERVER_MACHINE_NAME variable is set to the local hostname.

  3. Ensure the DOCUMENT_SERVER_PORT variable is set to the port address used by the local Web server.

  4. Ensure that the CGI_DIRECTORY variable is set to the correct cgi-bin directory used by the local Web server.

  5. Ensure that the DOCUMENT_DIRECTORY is set to the directory where the symbolic links doc_link and ds_images reside. If you have not changed the default, it should be in /usr/lpp/internet/server_root/pub for both IBM Internet Connection Server and Lotus Domino Go Web Server.

  6. If you are not using the default directory, ensure that you have defined the necessary directory mapping in your Web server configuration file so that the directory can be resolved.

16.7 Quiz