Searching The Perl CD Bookshelf on UNIX

#

# 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.