Skip Headers
Oracle® Beehive Integration Guide
Release 2 (2.0.1.8)

Part Number E16650-06
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

9 Integrating Oracle Secure Enterprise Search 10g with Oracle Beehive

This module describes how to integrate Oracle Secure Enterprise Search Release 10g with Oracle Beehive.

This module contains the following topics:

About Integrating Oracle Secure Enterprise Search with Oracle Beehive

Oracle Beehive maintains an optimized search index that enables users to perform comprehensive searches across all Oracle Beehive artifacts. At the enterprise level, however, other information repositories might exist and contain information that users need. For example, depending on their roles, knowledge workers might need to find expense reports or purchase requisitions stored outside of Oracle Beehive. This level of search across all enterprise information repositories is provided by Oracle Secure Enterprise Search.

Oracle Secure Enterprise Search has been designed as a stand-alone enterprise search solution. It incorporates best-in-class indexing, crawling, and security capabilities to create a reliable and comprehensive search solution for any organization.

To use this powerful option requires the completion of tasks (post-installation) that are specific to Oracle Beehive and others that are specific to Oracle Secure Enterprise Search 10g. For example, your Oracle Beehive instance must be configured in Oracle Secure Enterprise Search 10g as a federated data source.

You use the beectl utility to complete the tasks that are specific to Oracle Beehive, which include:

  • Creating a special user account that has administrator rights to the content managed by Oracle Beehive

  • Configuring the Secure Enterprise Search service by entering the host and port number of your Oracle Beehive instance, and by enabling the service

  • Activating these changes using the activate_configuration command

For detailed information about using the beectl utility, see "Managing Oracle Beehive Using beectl" in Oracle Beehive Administrator's Guide.

You use the Oracle Secure Enterprise Search Administration Tool to complete the tasks that are specific to Oracle Secure Enterprise Search 10g, which include:

  • Activating the identity plug-in on the Global Settings - Identity Management Setup page.

  • Specifying your Oracle Beehive database instance as a federated source.

  • Specifying the Uniform Resource Identifier (URI) of the Oracle Beehive Search Service.

  • Entering the credentials of the special user account that you created in Oracle Beehive.

For more information about the tasks that are specific to Oracle Secure Enterprise Search 10g, see "Setting Up Federated Sources" in the Oracle Secure Enterprise Search 10g Administrator's Guide.

Note:

additional integration details are mentioned in the section "Configuring Oracle Secure Enterprise Search (SES) Integration" in the Readme of the patchsets.

Prerequisites for Integrating Oracle Secure Enterprise Search

Oracle Beehive supports integration with Oracle Secure Enterprise Search or later.

Procedure for Integrating Oracle Secure Enterprise Search

This section contains:

Step 1: Add Oracle Secure Enterprise Search to Oracle Beehive

  1. Optionally, if you are not in shell mode, from the $ORACLE_HOME/beehive/bin directory, obfuscate the password that you will enter in Step 2.

    For example:

    beectl obfuscate <expiration_time_in_minutes>
    

    The default for expiration_time_in_minutes is 30. If you do not want the obfuscation to expire, then set this value to 0.

  2. Create and register a trusted identity account.

    This account will have administrative privileges for the content managed by Oracle Beehive.

    If you are not in shell mode, then enter the --obfuscated option after the password entry. If you are in shell mode, then omit the --obfuscated option but use the same add_trusted_identity syntax as shown in the following example.

    For example:

    beectl add_trusted_identity
      --is_service false
      --service_name sessearch
      --type SES
      --name BeehiveSesTrustedEntity
      --password <password> --obfuscated
    

    Enter the arguments all on one line. The examples in this guide are formatted as shown here for easier readability.

    For the password argument, enter any valid password. Remember the trusted identity account name and password, because you will need them in "Step 2: Configure Oracle Secure Enterprise Search for Oracle Beehive".

  3. Configure the host and port number of your Oracle Beehive instance, as follows:

    beectl modify_property
      --component _SesEndptService
      --name Host
      --value <Host name of your Oracle Beehive instance>
    
    beectl modify_property
      --component _SesEndptService
      --name Port
      --value <Oracle Beehive HTTP listening port>
    
    beectl modify_property
      --component _SesEndptService
      --name SesEndptServiceEnabled
      --value true
    

    To determine the HTTP listening port, run the beectl list_ports command and then search for the property name HttpListenPort.

  4. Activate and commit changes:

    beectl> activate_configuration
    beectl> modify_local_configuration_files
    

Step 2: Configure Oracle Secure Enterprise Search for Oracle Beehive

  1. Log in to the Oracle Secure Enterprise Search administrator page.

    The URL typically has the following form:

    http://<Oracle SES host name>:<HTTP listening port>/search/admin
    
  2. Click the Sources tab.

  3. From the Source type drop-down list, select Federated.

  4. Click the Create button.

  5. Enter the following values to define the source:

    • Source Name: Enter any name to identity your source.

    • Web Services URL: Enter the Web Services URL in the following format:

      http://<Oracle Beehive host name>:<Oracle Beehive HTTP listening port>/ses-endpt/OracleSearch
      
    • Remote Entity Name: Enter the entity name that you created in Step 2 under "Step 1: Add Oracle Secure Enterprise Search to Oracle Beehive".

      BeehiveSesTrustedEntity
      
    • Remote Entity Password: Enter the password for the BeehiveSesTrustedEntity user that you created in Step 2 under "Step 1: Add Oracle Secure Enterprise Search to Oracle Beehive".

    • Search User Attribute: Enter a value for this field only if Oracle Secure Enterprise Search uses a different authentication attribute than Oracle Beehive. Otherwise, leave this field blank.