Installing Autonomy Servers

This section describes how to install and start Autonomy servers. The Autonomy files are located on the Enterprise Portal installation CD in the Search directory, as described in Chapter 1, “Overview.” The CD is read-only, so you need to copy the Search directory to a local directory and use it from there.

Performing the installation

Extract the Autonomy file into the location where you want to install Autonomy. The command for extracting the file depends on the utility you are using.

Use gunzip to extract the .gz file:
```
gunzip Autonomy.tar.gz
```
Extract the resulting tar file:
```
tar -xvf Autonomy.tar
```

Be sure to check that the directory into which you untar has sufficient space available or some files may not be extracted.

The expanded structure will consist of the autonomy parent directory and the necessary subdirectories. The full path of the autonomy directory, for example, /work1/autonomy, will be referred to as <Autonomy_Install_Dir>.

In <Autonomy_Install_Dir>, the following three files are used to customize the installation in a later step: onepage.jar, CUSTOMIZE.sh, and DOREPLACE.sh.

Verify that you have $JAVA_HOME/bin in your $PATH by entering:

java -version

If you receive “java: command not found,” or if the version shown is earlier than java 1.4, set JAVA_HOME to point to a 1.4 JRE or JDK. For example:

setenv JAVA_HOME $SYBASE/_jvm

Or:

set JAVA_HOME=$SYBASE/_jvm;export JAVA_HOME

Add the JAVA_HOME bin directory to your path:

setenv PATH $JAVA_HOME/bin:$PATH

Set up the Autonomy servers for your environment by running the CUSTOMIZE.sh, which in turn runs the DOREPLACE.sh script that sets variables in the Autonomy server configuration files and in the Start and Stop scripts.

To run the script:

Access <Autonomy_Install_Dir>.
Run CUSTOMIZE.sh by entering:
```
CUSTOMIZE.sh
```
The DOREPLACE.sh executes a java command. If “which java” does not find java, set the $JAVA_HOME environmental variable to point to the java directory and edit the DOREPLACE.sh by replacing “java” with “$JAVA_HOME/bin/java”.

To resolve a known problem with the NORE partition:

Use the su command to change to the root user.
From <Autonomy_Install_Dir>, run:
```
NORElink.sh
```
Exit root.

Stop the EP PortalSearchqueryh and PortalSearchautoindexer if they are running.

Go to <Autonomy_Install_Dir>/bin and use the .sh scripts to start the Autonomy servers in this order:

StartQuery.sh
StartLAUNESUIR.sh
StartNORESUIR.sh
StartLAUNE.sh
StartNORE.sh
StartCAP.sh
StartFetch.sh
StartIndexer.sh

The DiSH partition is neither licensed nor needed for proper portlet functionality.