Table of Contents

Altering the Crawler Java classpath

The Ultra Search Crawler is a pure Java application and runs in a Java virtual machine. A Java virtual machine uses the Java classpath to find classes during runtime. When Ultra Search is installed, the default Crawler classpath is stored in the database. Whenever a new Ultra Search instance is created, this default classpath is copied and used as the Crawler classpath for that specific instance.

Reasons for altering the Crawler Java classpath

Ordinarily, you will not need to alter the Crawler Java classpath. However, there may be specific reasons for you to do so. One such reason may be to replace the JavaMail™ reference implementation with a third party JavaMail™ implementation.

Understanding the difference between the Crawler classpath and the Remote Crawler classpath

The Crawler classpath refers to the classpath of a crawler that runs on the same host where Ultra Search Server Component is installed. However, Ultra Search allows Remote Crawlers to be run on other hosts for scalability (see Using the Remote Crawler).

Remote Crawler activation uses Java Remote Method Invocation technology. As a result, the classpath setting of a Remote Crawler is inherited from the classpath settings of the RMI Registry and RMI Daemon.

Altering the Crawler Java classpath on the Ultra Search Server host

  1. Login in to the host where the Ultra Search Server Component is installed. Locate the file $ORACLE_HOME/ultrasearch/admin/wk0cpath.sql.

  2. Using SQL*Plus, run the wk0cpath.sql script as the WKSYS super-user or as a database user that has been granted the WKADMIN role.

  3. When prompted, specify whether you want to alter the default classpath or an instance specific classpath. Altering the default classpath will cause all subsequent created instances to use that classpath. Existing instances will not be modified.

  4. When prompted, enter the Ultra Search instance name if you are attempting to modify an instance specific classpath. If you are modifying the default classpath, you do not need enter anything here.

  5. When prompted, specify whether you want to update the entire classpath or append to it. Appending to a classpath adds entries to the beginning of it. Normally, entries earlier on in the classpath override later entries in the case of duplicate classes.

  6. When prompted, enter the new classpath if updating the entire classpath. Alternatively, if you are appending one or more directories or library files to the classpath, enter these separated by the classpath separator for the platform on which the Ultra Search Server Component is installed (the colon on unix platforms or the semicolon on windows platforms)

Altering the Crawler Java classpath on a Remote Crawler host

  1. Login in to the host where the Ultra Search Middle-Tier Components are installed on a remote crawler host. If the host is a unix machine, locate the file $WEB_ORACLE_HOME/ultrasearch/tools/remotecrawler/scripts/unix/define_env. If the host is a windows NT machine, locate the file $WEB_ORACLE_HOME/ultrasearch/tools/remotecrawler/scripts/winnt/define_env.bat.

  2. The define_env file specifies all environment settings used by the RMI subsystem. To alter the classpath, simply use a text editor to modify the APPLICATION_CLASSPATH variable.

  3. You must restart the RMI subsystem before these changes can take effect. Click here for more details on starting up the RMI subsystem.