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
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.
The product documentation library is also available:
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
The following html-based filesets are required for navigation and messaging.
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 188.8.131.52. The most recent version is 184.108.40.206. The document directories are different between these two versions.
Prior to 220.127.116.11:
http_server.base.core http_server.base.source http_server.modules.ssl (optional)
18.104.22.168 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).
IBM HTTP Server Web Server in default location
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
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.
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 ]