The Perl CD Bookshelf

About Searching on UNIX

You need to have a JRE or JDK installed. An executable called jre or java should be in your path, or the JRE environment variable should be set to the full path to some Java interpreter. If you don't have a Java interpreter, you can install a JRE.

When that is done, you can run run_me.sh from the root directory of the CD-ROM. You can stop the search server by typing ctrl-C, or, if you've run it the background, by killing the process.

If you are using Lynx

If you are using Lynx as your Web browser, the search will not work the first time you run the run_me.sh script. Wait for the message

Search Service using port: 6010

Then type ctrl-C to shut the search server down, and run run_me.sh again. Searches will now work from Lynx.

If search connections are refused

The search engine includes a security precaution that requests for files from hosts other than localhost are rejected. On some systems, including FreeBSD 2.x, requests from localhost are not correctly recognized. If this happens, you will receive the message:

403 Refusing non-local request

Error when fetching URL:

To fix this problem:

  1. Find your NetResults installation directory; it is /tmp/netresults unless you've given a directory other than /tmp in the initial installation dialog. If it does not exist, run run_me.sh from the root directory of the CD-ROM.
  2. Find the file http-nr.cfg. If it does not exist, kill the search engine if it is currently running, and run run_me.sh from the root directory of the CD-ROM a second time. This will create http-nr.cfg.
  3. Shut down the search server (use ctrl-C if it is running in the foreground, or issue a kill otherwise).
  4. Edit http-nr.cfg. Change all occurrences of localhost to the full name of your system (e.g., ivory.ora.com).
  5. Re-start the server by running run_me.sh from the root directory of the CD-ROM.

Installing a JRE

In the jre directory of the CD are JREs for several platforms:

FreeBSD
FreeBSD 2.2.* with a.out binary format
jre1.1.8_FreeBSD_aout.tar.gz
FreeBSD 3.* with ELF binary format
jre1.1.8_FreeBSD_ELF.tar.gz
HP-UX
HP-UX 10.20
jre1153_hpux1020.tar.Z
HP-UX 11
jre1153_hpux11.tar.Z
Linux
Linux with glibc
jre1.1.7-v3-Linux-glibc.tar.gz
Older JRE for Linux with glibc (try this if that doesn't work)
jre1.1.6-v2-Linux-glibc.tar.gz
Linux with libc5
jre1.1.6-v2-Linux-libc5.tar.gz
Solaris
Solaris 2.4-2.6 for SPARC
jre116-solaris2-sparc.bin
Solaris 2.5-2.6 for x86
jre116-solaris2-x86.bin
SunOS 4.1.3
jre1.1.5-sunos.tar.gz

The Solaris packages can be run; they will create a JRE installation in the current directory:

root@localhost:/usr/local# /cdrom/jre/jre116-solaris2-sparc.bin

will create a /usr/local/jre1.1.6 directory.

The other packages should be extracted into a directory, such as /usr/local/:

root@localhost:/usr/local# zcat /cdrom/jre/jre1.1.6-v2-Linux-libc5.tar.gz | tar xvf -

will similarly create a /usr/local/jre1.1.6 directory.

The HP-UX packages are system addition packages, and can be installed with your system's utilities.

Licensing terms prevent us from distributing JREs for AIX, Digital UNIX, and SCO UNIX. You can find these, and other JREs, from http://java.about.com/msub2.htm.

If you experience any problems running the server, cd to the netresults directory, run

jre -mx16m -cp . -ms8m itm.nr.serve.NRServer +ds +es +vs

and try the search again. The console will show more debugging information; have this available when contacting us.


The The Perl Perl in a Nutshell Learning Perl Learning Perl on Win32 Systems Programming Perl Advanced Perl Programming Perl Cookbook