Oracle Ultra Search Online Documentation
Release 9.2


Home	Book List	Contents	Master Index	Feedback

Installing the Ultra Search Server Tier Component on Remote Crawler Hosts

	Related Topics
About the Ultra Search Administration Tool Installing the Ultra Search Server Component Installing the Ultra Search Middle Tier Component on Web Server Hosts

The Ultra Search remote crawler allows multiple crawlers to run in parallel on different hosts. However, all remote crawler hosts must share common resources, such as common directories and a common Ultra Search database.

Installation Steps

The Ultra Search remote crawler is part of the Ultra Search server component. Therefore, the installation procedure is the same as installing the Ultra Search server component.

Click here to learn how to install the Ultra Search server component.

Click here to learn how to install the Ultra Search server component.

On each remote crawler host, the Ultra Search server component is installed under a common directory known as the Oracle home. You should have been prompted by the Oracle Universal Installer to enter this directory. The Oracle home directory is referred to as $REMOTE_ORACLE_HOME.

Note: If you choose not to install the Oracle HTTP server during the Oracle9i Application Server (9iAS) release 2 infrastructure installation, then you must perform the following steps manually for remote crawling:

Locate $REMOTE_ORACLE_HOME/ultrasearch/tools/remotecrawler/scripts/unix/define_env on a UNIX system or $REMOTE_ORACLE_HOME/ultrasearch/tools/remotecrawler/scripts/winnt/define_env.bat on a Windows NT system.

Replace %ORACLE_HOME% with the value of the REMOTE_ORACLE_HOME environment variable.

Replace %s_jreLocation% with the directory path of a Java runtime environment (JRE) version 1.2.2 and higher. You should specify the root directory of the JRE.

Replace %s_jreJDBCclassfile% with the full path and file name of the Oracle JDBC thin driver (version 12).

Configuration Steps

The only configuration needed for an Ultra Search remote crawler host is to register the host with the Ultra Search system. The registration process is done by running a SQL script on the Ultra Search remote crawler host. The SQL script connects over SQL*Plus to the 9iAS middle tier and registers the remote crawler host.

Step 1: Locate the correct Oracle Home

The Ultra Search middle tier component is installed under a common directory known as the Oracle home. If you have installed other Oracle products prior to the Ultra Search middle tier component, then you could have multiple Oracle homes on your host. The registration script requires that you enter the Oracle home directory in which the Ultra Search middle tier component is installed.

Step 2: Locate the WKSYS superuser password

You need to run the registration script as the WKSYS superuser or as a database user that has been granted the WKADMIN role.

Step 3: Start SQL*Plus

The SQL script that you need to run is located in /ultrasearch/tools/remotecrawler/scripts/common/register.sql under $REMOTE_ORACLE_HOME.

You must now run SQL*Plus. Be sure to run the correct version of SQL*Plus, because multiple versions can reside on the same host if you have previously installed some Oracle products. On UNIX platforms, make sure that the correct values for PATH, ORACLE_HOME and TNS_ADMIN variables are set. On Windows platforms, choose the correct menu item from the Start menu.

After you have identified how to run the correct SQL*Plus client, you must log on to the Ultra Search database. To do this, you might need to configure an Oracle Net service setting for the Ultra Search database. See the Oracle Networking documentation for more information on how to configure a service setting.

After SQL*Plus is running, log on to the database using the schema and password that you located in Step 2.

Step 4: Invoke the registration script

Invoke the registration script by starting up SQL*Plus as the WKSYS superuser and entering the following:
@<full path name of registration script>

For example, if value for $REMOTE_ORACLE_HOME on a UNIX host is /home/oracle9i, then enter the following at the SQL*Plus prompt:
@/home/oracle9i/ultrasearch/tools/remotecrawler/scripts/unix/register.sql

If you are running SQL*Plus on Windows NT, and $REMOTE_ORACLE_HOME is in d:\Oracle\Oracle9i, then enter the following at the SQL*Plus prompt:
@d:\Oracle\Oracle9i\ultrasearch\tools\remotecrawler\scripts\winnt\register.sql

The registration script prompts you for two variables. The following is a list of the variables and their descriptions:

REMOTE_CRAWLER_HOSTNAME: The DNS host name of the remote crawler host.

ORACLE_HOME: The Oracle home located in Step 1.
For example, /u01/oracle9i on a UNIX host or D:/u01/oracle9i on a Windows NT host. (Note: Be careful to use forward slashes and not back slashes for Windows NT hosts.)

The registration script invokes the wk_crw.register_remote_crawler PL/SQL API. The REMOTE_CRAWLER_HOSTNAME and ORACLE_HOME variables are used to compose arguments for the wk_crw.register_remote_crawler API.

Step 5: Verify and complete the remote crawler profile configuration

Be sure to enter the correct values for both variables. To verify that the registration has completed correctly, log on to the Ultra Search administration tool. Click the Remote Crawler Profiles subtab in the Crawler tab. You should see the host name of the remote crawler host you have just registered in the remote crawler Profile List. Click Edit to complete the configuration process for the remote crawler profile.

What To Do if You Make a Mistake

If you enter any wrong values for the register.sql script, then you must unregister the remote crawler using the unregister.sql script. Invoke the unregister script the same way as you invoke the registration script. The unregister.sql script calls the wk_crw.unregister_remote_crawler PL/SQL API.

After you have successfully unregistered the remote crawler, you can rerun the register.sql script.


Home	Book List	Contents	Master Index	Feedback