9 Configuring Ultra Search

This chapter provides information about how to configure Grid Control 10g Release 2 (10.2) to monitor Oracle Ultra Search for Oracle Collaboration Suite Release 2.

Note:

See Chapter 1, "Introduction to Managing Oracle Collaboration Suite 10g Release 1" for information on configuring Grid Control to manage Collaboration Suite Search components for Oracle Collaboration Suite 10g Release 1

This chapter contains the following sections:

• Overview of the Oracle Ultra Search Target Types

• Creating an Oracle Ultra Search Target

• Creating the Oracle Ultra Search Web Application Target

• Creating the Oracle Ultra Search Group Target

9.1 Overview of the Oracle Ultra Search Target Types

Oracle Ultra Search consists of a database and a middle-tier component. As an administrator, you should create one Ultra Search target for each Ultra Search database repository. This target will collect crawling status for all Ultra Search instances.

After you install the Management Agent on the Oracle Ultra Search hosts, you can use Grid Control to create Oracle Ultra Search targets. After the targets are created, you can view the various metrics collected for each Oracle Ultra Search target.

For information on running the Oracle Ultra Search crawler, see Oracle Ultra Search User's Guide for Oracle Collaboration Suite Release 2 at:

http://www.oracle.com/technology/documentation/collab.html

When you manage Ultra Search with Grid Control, you create the following target types:

• An Ultra Search target for each Ultra Search database repository

• A Web Application for each Ultra Search target and its related targets, such as the database and hosts where the Ultra Search target exists.

• An Ultra Search group target for all the Ultra Search targets in your environment, as well as the related targets for each.

9.2 Creating an Oracle Ultra Search Target

To create the Oracle Ultra Search target:

1. Using Grid Control, navigate to the home page for the Management Agent that was installed on the Oracle Ultra Search Repository Database host. Use these steps to navigate to the appropriate Agent hom e page:

   1. Click Setup at the top of any Grid Control page.

   2. Click Agents in the Overview of Setup page subtab.

   3. In the Agents table on the Agents page, click the link for the Management Agent for the Ultra Search Repository Database host.

2. In the Monitored Targets section of the page, select Ultra Search from the Add box, then click Go.

   Grid Control displays the property page for the selected target type.

3. Provide the required information, as described in Table 9-1.

4. Click OK to create the target.

   See Also:

   "Adding Targets to be Monitored and Administered by Enterprise Manager" in the Grid Control online help

Table 9-1 Oracle Ultra Search Target Properties

Property	Description
Name	Enter a unique name for the Oracle Ultra Search target. If you have multiple Oracle Ultra Search targets in your environment, consider including the host name in the target name.
Database Host	The host for the Oracle Ultra Search repository database. This is usually an Oracle Application Server Infrastructure database. For example: iashost2.acme.com
Database Listener Port	The port for the Oracle Ultra Search repository database. For example: 1521
Oracle SID	The System Identifier (SID) for the Oracle Ultra Search repository database. For example: iasdb
Schema Username	User name for the owner of the Oracle Ultra Search schema. By default, the user name is WKSYS.
Schema Password	Password for the WKSYS user account.

9.3 Creating the Oracle Ultra Search Web Application Target

To monitor your Oracle Ultra Search components, you create a Web Application target. Web Application targets can be monitored for availability and performance with Application Service Level Management transactions. You can also measure the response time of pages in your Web Applications using End-User Page Performance Monitoring.

To create a Web Application target for monitoring your Oracle Ultra Search components:

1. Using Grid Control, click the Targets tab and then click Web Applications.

2. Click Add.

   Grid Control displays the Create Web Application wizard, which guides you through the process of creating the Web Application. Click Help if you need more information about using the Wizard.

3. Click Submit to create the target.

4. Use the instructions in the online help to create some representative transactions to measure the availability and performance of the Web Application you just created.

   For example, create the following transactions:

   • One transaction that logs in to the Ultra Search Administration tool, using the following URL:

     http://<host>:<port>/ultrasearch/admin/
     
     

     For example:

     http://ultsrch42.acme.com:7777/ultrasearch/admin/
     
     

   • One transaction that performs a search using Oracle Ultra Search, using the following URL:

     http://<host>:<port>/ultrasearch/query/search.jsp
     
     

     For example:

     http://ultsrch42.acme.com:7777/ultrasearch/query/search.jsp
     

   See Also:

   "Creating Transactions" in the Grid Control online help

5. Enable End-User Page Performance Monitoring for the Web Application using the procedures for earlier versions of the Oracle Application Server described in "Configuring End-User Performance Monitoring Using Earlier Versions of Oracle Application Server Web Cache" in Oracle Enterprise Manager Advanced Configuration for Oracle Enterprise Manager Grid Control 10g Release 2 at:

   http://www.oracle.com/technology/documentation/oem.html

   Note:

   Before you enable End-User Page Performance Monitoring to monitor your Oracle Collaboration Suite Web Application target, you must apply patch number 3040716 to the Oracle Application Server middle-tier instance. You can download this patch from OracleMetaLink:

   http://metalink.oracle.com/

9.4 Creating the Oracle Ultra Search Group Target

After all the Oracle Ultra Search targets are configured, you can create the Oracle Ultra Search group target, which provides a single interface for monitoring multiple Oracle Ultra Search targets in your Oracle Collaboration Suite environment.

The Oracle Ultra Search group home page contains the alerts table, followed by a table of rows of component targets and columns of key metrics. There is also a Performance tab where key metrics are charted for the Oracle Ultra Search group.

To create the Oracle Ultra Search group target:

1. Click the Targets tab in Grid Control.

2. Click Groups.

3. Select Group from the Add box, then click Go.

   Grid Control displays the Create Group wizard.

4. Enter a name for the Oracle Ultra Search group in the Name field.

   For example, enter Ultra Search Group.

5. Use the Type box and the Move button to add the following targets to the group:

   • Any Ultra Search targets you created using the instructions in Section 9.2

   • The host targets where the Ultra Search servers reside

   • The Ultra Search repository database.

   • The application server target where the Ultra Search target resides

6. Use the remaining pages in the wizard to select a set of summary metrics for the group and to review your changes before you create the group.

   Summary metrics appear on the Performance tab of the Oracle Ultra Search Group home page.