Documentation Search Service Installation Instructions - Lotus Domino Go Web Server


Content

About this document
    Related documentation
What to install
Configuring the Web server
Using Documentation Search Service
Additional instructions

About this document

This document discusses the procedures for setting up Documentation Search Service as your search service at AIX version 4.3.x. docsearch launches the AIX Documentation Search Service global search form into a Web browser window. Netscape 4.04 is the recommended browser and you will need a Web server to serve out the html based information files.

Related documentation

The product documentation library is also available:
http://www.rs6000.ibm.com/resource/aix_resource/Pubs/index.html


What to install

The following filesets install Documentation Search Service from Volumes 1 and 2 of AIX version 4.3.x installation media.

	bos.docsearch.client.Dt
	bos.docsearch.client.com
	bos.docsearch.rte
	bos.html.en_US.topnav.navigate
	bos.msg.en_US.docsearch.client.Dt
	bos.msg.en_US.docsearch.client.com
	IMNSearch.bld.all
	IMNSearch.rte.all

Configuring the Web server

After installing the filesets that you need, configure the Web server through SMIT. First Select System Environment, then Internet and Documentation Services (for the fastpath method, enter smitty web_configure.)

  1. Select Change/Show Default Browser and select your browser from the pulldown menu (F4 in smitty).
  2. Select Change Documentation and Search Server.
  3. Set the Documentation search server LOCATION.
  4. Choose
    	Local-this computer
    
    or
    	Remote computer
    

    NOTE: If you installed the filesets locally, choose Local-this computer

  5. Hit Enter.

    After choosing Local-this computer, the entry field should be populated with your Web server as shown in the example below. Keep in mind, however, that it may differ from your screen, depending on the Web server you have chosen.

    	Web server SOFTWARE   Lotus Domino Go Webserver
    
  6. Hit Enter.

    SMIT will configure the port, cgi-bin, and the html documentation directory as follows:

    	DOCUMENT_SERVER_PORT   = 80
    	CGI_DIRECTORY          = /usr/lpp/internet/server_root/cgi-bin
    	DOCUMENT_DIRECTORY     = /usr/lpp/internet/server_root/pub
    
  7. Hit Enter to configure.

    NOTE: The cgi-bin directory should have world executable permissions.

    If you chose Remote computer, enter in the fully qualified name of the remote host machine. The cgi-bin directory and document directory will be set by that machine. Also ensure that you verify the paths on the remote machine. Finally, you will need to reboot your machine for the changes to take effect.


    Using Documentation Search Service

    You must execute docsearch from within a graphical environment, such as Xwindows or the Common Desktop Environment (CDE). When you execute Documentation Search Service, this will start Netscape and display the Documentation Search Service form. The URL will appear as http:///cgi-bin/ds_form.

    To reach the commands reference page, the URL is http:////doc_link/en_US/a_doc_lib/aixgen/topnav/topnav.htm.


    Additional instructions

    At AIX 4.3.0, a known problem exists when you access a machine without DNS configured. The problem will appear when a search is attempted and the returned items cannot be accessed. Additionally, the URL may appear as htt:///doc_link/, which indicates that the hostname could not be obtained. APAR IX75702 fixes this problem.

    If you intend to run Netscape from a machine which does not have a graphical console, ensure that the following prerequisite fileset is installed.

    	X11.compat.lib.X11R5
    

    Use the preview function in SMIT to determine how much disk space you need to install filesets.


    [ Doc Ref: 97690743220928     Publish Date: Dec. 19, 2000     4FAX Ref: none ]