4.3.3 Docsearch Installation Instructions - IBM HTTPServer


Contents

About this document
    Related documentation
What to install
Configure the Web server
Using Docsearch

About this document

This document describes the procedures for setting up Docsearch as your search service in AIX version 4.3.3. Docsearch launches the Documentation Search Service's global search form into a Web browser window. Docsearch requires several elements to function correctly and are detailed in this document. A Web server is necessary to serve out the html-based information files, and Netscape is the recommended browser.

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 Docsearch from Volumes 1 and 2 of the AIX V4.3.3 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

The following html-based filesets are required for navigation and messaging.

	X11.html.en_US.all
	bos.html.en_US.all
	Netscape.communicator.com
	Netscape.communicator.plugins

Configure the Web server

Note that the IBMWebAS Web Server Volume 1, also found on the Bonus Pack, is a different Web server. However, the IBM HTTP Server and IBMWebAS Web server are based on the Apache Web Server code. The version sent out before November 1999 is 1.3.3.2. The most recent version is 1.3.6.0. The document directories are different between these two versions.

  1. Install the following:

    Prior to 1.3.6.0:

    	http_server.base.core
            http_server.base.source
            http_server.modules.ssl  (optional)
    

    1.3.6.0 and later:

            http_server.admin
    	http_server.base.rte
    	http_server.base.source
    

    To stop/kill any httpd process, enter:

    	ps -ef |grep httpd
    	kill <process ID>
    

    To stop/kill any IMNSearch processes, enter:

    	ps -ef |grep -i imn
    	imnss -stop imnhelp
    

    If an httpdlite entry is in the inittab, ensure that you comment it out using the ":" (colon).

  2. Enter:
    smitty web_configure
    
  3. Change documentation and Search Server by choosing:
    Local
    
  4. Change local documentation and Search Server by hitting F4 and choosing:
    IBM HTTP Server Web Server in default location
    
  5. Press Enter.

    All of the required fields should be populated as in the following examples:

    	DEFAULT_BROWSER = netscape
    	DOCUMENT_SERVER_MACHINE_NAME = <machine name>.austin.ibm.com
    	DOCUMENT_SERVER_PORT = 80
    	CGI_DIRECTORY = /usr/lpp/HTTPServer/share/cgi-bin
    	DOCUMENT_DIRECTORY = /usr/lpp/HTTPServer/share/htdocs
    
    	DEFAULT_BROWSER = netscape
    	DOCUMENT_SERVER_MACHINE_NAME = <machine name>.austin.ibm.com
    	DOCUMENT_SERVER_PORT = 80
    	CGI_DIRECTORY = /usr/HTTPServer/cgi-bin
    	DOCUMENT_DIRECTORY = /usr/HTTPServer/htdocs
    
  6. Press Enter.

Using Docsearch

Execute Docsearch within a graphical environment such as Xwindows or the Common Desktop Environment. Executing docsearch in a command line will start Netscape and display the Documentation Library form. The URL will appear as http://cgi-bin/ds_form.

NOTE: If you plan to run the Netscape browser from a machine which does not have a graphical console, first ensure that the following fileset is installed.

	X11.compat.lib.X11R5

Use the preview button in SMIT to determine how much disk space will be required to install filesets.

If you are using IBM HTTPServer version 1.3.6, you may see broken links and indices. This is a documented problem, and the fix is APAR IY05162.


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