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
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
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.
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).
smitty web_configure
Local
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.
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 ]