Documentation Search Service Installation Instructions - Lotus Domino Go Web Server

Content

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

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

• Volume 1

	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

• Volume 2

	IMNSearch.bld.all
	IMNSearch.rte.all

• Lotus Go Domino Server is available on the Bonus Pack CD.

  	
  	internet_server.base.admin
  	internet_server.base.doc
  	internet_server.base.httpd
  	internet_server.java.jdk
  	internet_server.msg.en_US.httpd
  	internet_server.security.common
  

  • Base Documentation CD

  	X11.html.en_US.all
  	bos.html.en_US.all
  

  • Netscape browser

  At AIX version 4.3.0, Netscape is on the Netscape CD.

  	Netscape.nav.rte
  

  At AIX version 4.3.1 and above, Netscape is on the Bonus Pack CD.

  	Netscape.msg.en_US.nav.rte
  	Netscape.nav.rte
  	Netscape.help.en_US.nav.rte
  

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 ]