Documentation Search Service Installation Instructions - Lotus Domino Go and HTTPDLITE


Content

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

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


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.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
	IMNSearch.bld.all
	IMNSearch.rte.all
	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

	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.

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

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:

    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.

    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:.

  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.


Using Documentation Search Service

You must execute docsearch from within a graphical environment, such as Xwindows or the Common Desktop Environment (CDE). Executing docsearch will open up a Netscape browser and display the Documentation Search Service form. The URL will appear as http://hostname/cgi-gin/ds_form.

To reach the command Reference page, the URL is http://hostname/doc_link/en_US/a_doc_lib/aixgen/topnav/topnav.htm

Special considerations




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