This document desribes the two methods available to conduct search queries on the Toolbox CD in v5.0 using the OasisIII client program in concert with the oksvr server program.
The two methods are based upon whether one is running an HTTP server or not. The document describing v5.0 HTML Operability and Limitations explains the HTML (client) and HTTP (server) issues relating to these two distinct environments in which v5.0 will operate. If you haven't read about this yet, you should before you proceed further with this one.
Again, there are two distinct environments within version 5.0 to describe here:
But before you can do this you must install the oasisIII inst image. The inst files for this lives in toolbox/searchtools/dist. A listing of the subsystem sizes and all files loaded is included as well. The five subsytems indicated--books.help, man.oasisIII, man.relnotes, sw.client, sw.server--are those the janitor recommends you load. At a very minimum, you must load the complete oasisIII.sw image.
Once you have installed the oasisIII software, you must ensure the script /etc/init.d/okserver is correctly configured to run the server, /usr/sbin/oksvr, every time the machine boots up, or, if the root user executes:
/etc/init.d/okserver start
To stop the okserver root user executes:
/etc/init.d/okserver stop
chkconfig okserver off
And finally, you must ensure that both the /etc/init.d/okserver and www/cgi-bin/osearch-cgi scripts are correctly configured to reference the actual location of the "searchtools" directory (currently located in the top-of-tree). There are two distinct configurations that can occur here:
In this case, the /etc/init.d/okserver and the www/cgi-bin/osearch-cgi script are all set to go.
In this case, you will need to change the value of the OKSVR_ROOT environment variable in /etc/init.d/okserver, and create a file in /usr/tmp/.DT_OksvrRoot that replicates the value of OKSVR_ROOT. Quoting from the top of /etc/init.d/okserver,
# This is the oksvr /etc/init.d/okserver startup script for # The Developer Toolbox, version 5.0 CD, released, March 1995. # The key to running this script correctly is to always ensure # that the # # OKSVR_ROOT # # shell variable is defined to point to the absolute path location # where the "searchtools" directory exists. By default this # location is defined to be "/CDROM/searchtools". If one is # running an HTTP server and wants to create a child directory # of the HTTP server's Document Root to place the contents of # this toolbox in, the OKSVR_ROOT variable will need to be # redefined to properly point to the new "active" location of # "searchtools". For example, suppose the HTTP server's # Document Root is "/usr/local/www", and a directory under this # named "toolbox" is created to house the contents of the v5.0 # CD. Then, the default OKSVR_ROOT definition would change from, # # OKSVR_ROOT=/CDROM/searchtools # # to now be, # # OKSVR_ROOT=/usr/local/www/toolbox/searchtools
# DEFINE WHAT THE FULSEARCH PATH WILL BE SO WE CAN BUILD THE URLs: # # Make sure the value of the $OksvrSearchRoot variable inside the # /usr/tmp/.DT_OksvrRoot file, specified below, is equivalent # to what the OKSVR_ROOT variable is defined to be inside the # /etc/init.d/okserver script. # For example, if /etc/init.d/okserver has defined: # OKSVR_ROOT=/usr/local/www/toolbox/searchtools # then the /usr/tmp/.DT_OksvrRoot file should consist of the # following (starting from and including the `$' (dollar) sign: # $OksvrSearchRoot="/usr/local/www/toolbox/searchtools" ; # if (-f "/usr/tmp/.DT_OksvrRoot") { eval (`cat "/usr/tmp/.DT_OksvrRoot"`) ; } else { $OksvrSearchRoot="/CDROM/searchtools" ; }
$OksvrSearchRoot="/usr/local/www/toolbox/searchtools" ;At this point, with the /usr/tmp/.DT_OksvrRoot file defined to reflect the current location of the searchtools subtree, and the /etc/init.d/okserver started up with OKSVR_ROOT defined with the same absolute path value, you should have a functional search engine capability inside your local webDT site.
If you have any problems with any of this, please feel free to contact the janitor @ dave@sgi.com, 415/390-3556, or fax: 415/967-6239.
Once the oksvr is running, search queries can be initiated from within the Developer Toolbox: Oasis Search Engine form access via any "Seach" link available on most every .html file document throughout the toolbox.
Instead, you can use the sifttree script located in the top-of-tree toolbox directory. This will run via copies of oksvr and oasisIII located in the searchtools subdirectory--you don't need to install the oasisIII inst image software if you are going to simply run the sifttree script--and will invoke a motif-based-GUI version of oasisIII, similar to what has been included on the Toolbox in the past.
Through this motif-version of oasisIII you can perform all the sorts of multiple-keyword queries, etc., that has been possible with the oasisIII software in past toolboxes via the sifttree script.
In order to access the on-line help inside the oasisIII application, you WILL have to install the oasisIII.books.help subsystem, available in the oasisIII inst image located in searchtools/dist. There is an older version of this help book available in the sifttree.README ascii-text file, but this file is not as current as the on-line help system available through the motif-based oasisIII GUI after one loads the oasisIII.books.help inst subsystem.