Documentation Search Service Installation Instructions - Lotus Domino Go and HTTPDLITE

Content

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. Documentation Search Service requires several elements to function correctly. Netscape 4.04 is the recommended browser, and a Web server will be necessary to serve 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.rte
	bos.docsearch.client.Dt
	bos.docsearch.client.com
	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

• Base Documentation CD

	bos.html.en_US.all
        X11.html.en_US.all
        bos.msg.en_US.docsearch.client.com

Accessing this documentation from the CD is discussed in "Chapter 7" of the Installation Guide. You can access the specific section at the following link: http://www.rs6000.ibm.com/doc_link/en_US/a_doc_lib/aixins/aixinsgd/inst_doc_search.htm#97newlms50

• Extended Documentation CD

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

For AIX 4.3.0, you must access the documentation from the CD. At AIX 4.3.1, the documentation may be accessed from the CD or may be installed. The preceding URL also discusses accessing the Extended Documentation from the CD.

• Netscape 4.0.4 browser

At AIX version 4.3.0, you can find Netscape 4.0.4 on a separate Netscape CD.

	Netscape.nav.rte

At AIX version 4.3.1 and 4.3.2, you can find Netscape on the Bonus Pack CD.

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

• Web servers

Choose one of the following Web servers:

1. 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.httpd
           internet_server.security.export.httpd
   

2. Netscape Fastrack Server Version 2.1.

   AIX Version 4.3.0, Netscape Fastrack can be found on the separate Netscape CD.

   	netscape.fasttrack-us.rte
   

   AIX Version 4.3.1 and 4.3.2, Netscape Fastrack can be found on the Bonus Pack.

   	netscape.fasttrack.rte
   

3. Httpdlite Server

   	IMNSearch.rte.httpdlite
   

Configuring the Web server

After installing filesets that you need, configure the Web server using SMIT. Select System Environment then Internet and Documentation Services. (For the fastpath method, enter smitty web_configure or smit 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 the filesets have been installed locally, choose Local-this computer.

5. Hit Enter.

After choosing Local-this computer, the entry fields should be populated with information specific to the Web server being used. Two examples follow:

• For the Lotus Domino Go Webserver:

Web server SOFTWARE Lotus Domino Go Webserver

1. Hit Enter.
2. Populate the required fields with the following (The default values are correct if you are using the Lotus Go Webserver.):

   	DOCUMENT_SERVER_PORT   = 80
           CGI_DIRECTORY          = /usr/lpp/internet/server_root/cgi-bin
           DOCUMENT_DIRECTORY     = /usr/lpp/internet/server_root/pub
   

3. Ensure that these are the correct paths for your particular Web server and that the directories exist.
4. Hit Enter to configure.

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

• For the Httpdlite Webserver:

Web server SOFTWARE other local server or Lotus Domino go or IICS in non-default location

1. Hit Enter.
2. Populate the required field with the following:

   	DOCUMENT_SERVER_PORT   = 80
           CGI_DIRECTORY          = /var/docsearch/cgi-bin
           DOCUMENT_DIRECTORY     = /usr/IMNSearch/httpdlite/pub
   

3. Ensure that these are the correct paths for your particular Web server and that the directories exist.
4. Hit Enter to configure.

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

Additional instructions for the Httpdlite Web server:.

• Edit the /etc/INMSearch/httpdlite/httpdlite.conf file in the following four places:

1. HostName
2. PORT 80
3. # CGI exec translations

   	Exec /cgi-bin/* /usr/IMNSearch/httpdlite/cgi-bin/*
   

4. # document pass rules

   	Pass /* /usr/IMNSearch/httpdlite/pub/*
   

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