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. Netscape 4.04 is the recommended
browser
and you will need a Web server to serve the html based information files. You
must
execute docsearch from within a graphical environment, such as Xwindows
or the Common
Desktop Environment (CDE).
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.
bos.docsearch.client.Dt bos.docsearch.client.com bos.docsearch.rte bos.html.en_US.topnav.navigate bos.msg.en_US.docsearch.client.com bos.msg.en_US.docsearch.client.Dt
IMNSearch.rte.all IMNSearch.bld.all
X11.html.en_US.all bos.html.en_US.all bos.msg.en_US.docsearch.client.com
Netscape.nav.rte
Netscape.msg.en_US.nav.rte Netscape.nav.rte
NOTE: At AIX Version 4.3.0, Netscape 4.03 can be found on a separate Netscape CD.
After installing the filesets that you need, configure the Web server through SMIT. Select System Environment then select Internet and Documentation Services (for the fastpath method, enter smitty web_configure.)
Local-this computeror
Remote computer
If you chose Local-this computer, the entry field should be populated with your Web server as in the following example. Keep in mind, however, that the example below may differ, depending on the Web server you have chosen. In this example, the chosen Web server is HTTPD Lite.
Web server SOFTWARE Other local server or Lotus Domino Go or IICS in non-default location
DOCUMENT_SERVER_PORT = 80 CGI_DIRECTORY = /usr/IMNSearch/httpdlite/cgi-bin DOCUMENT_DIRECTORY = /usr/IMNSearch/httpdlite/pub
NOTE: The cgi-bin directory should have world executable permissions.
Exec /cgi-bin/* /usr/IMNSearch/httpdlite/cgi-bin/*
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 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 your machine for the changes to take effect.
Before you execute the command docsearch, ensure that the HTTPD Lite Web server is running. To do this, issue the command ps -ef | grep httpdlite. Entering the command should return the following.
/usr/IMNSearch/httpdlite/httpdlite -r /etc/IMNSearch/httpdlite/httpdlite.conf
If the HTTPD Lite Web Server is NOT running, issue the following commands to start the Web server:
/usr/IMNSearch/httpdlite/httpdlite -r /etc/IMNSearch/httpdlite/httpdlite.conf
When you execute docsearch, this will start Netscape and display the Documentation Search Service form. The URL will appear as http://<hostname>/cgi-bin/ds_form.
To reach the Command Reference page, the URL is http://<hostname>/doc_link/en_US/a_doc_lib/aixgen/topnav/topnav.htm.
At AIX version 4.3.0, a known problem exists when accessing a machine without DNS configured. The problem will appear when you attempt a search and the returned items cannot be accessed. Also, the URL information may reveal http:///doc_link, which indicates that the hostname could not be obtained. APAR IX75072 fixes this problem.
If you intend to run the Netscape browser from a machine that does not have a graphical user interface (GUI), ensure that the following prerequisite fileset is installed:
X11.compat.lib.X11R5
Finally, use the preview function in SMIT to determine how much disk space
you will need to install
the required filesets.
[ Doc Ref: 97690579120236 Publish Date: Dec. 19, 2000 4FAX Ref: none ]