Skip Headers
Oracle® Secure Enterprise Search Installation Guide
Release 11.2.1

Part Number E17644-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

  View PDF

Oracle® Secure Enterprise Search

Installation Guide

Release 11.2.1

E17644-02

January 2011

This guide provides optional information on how to manually add Oracle Secure Enterprise Search (SES) release 11.2.1 to an existing installation of Oracle Database 11g Release 2 (11.2.0.2) and to WebLogic Server release 10.3.4 (PS3). Oracle SES release 11.2.1 does not support earlier releases of Oracle Database and WebLogic Server.

This guide contains the following sections:

See Also:

Preinstallation Tasks

This section contains the following topics:

Oracle SES Browser Certifications

The Oracle SES Administration tool and default query application are certified on the following browsers:

  • Firefox 3.x

  • Internet Explorer 7.x, 8.x

  • Safari 4.x

Checking the Hardware Requirements

Oracle SES requires approximately 1.7 GB for the initial Oracle SES index. Additional Oracle SES requirements are based on the amount of data that you need to search.

For example, to index 100,000 documents:

  • 4 GB disk space

  • 2 GB RAM

To index 1,000,000 documents:

  • 20 GB disk space

  • 6 GB RAM

Note:

The number of CPUs on the server host affects the performance of concurrent queries over a prolonged period of time. Oracle recommends that you use systems with two or more CPUs for production deployments that serve 1000 or more users.

Checking the Software Requirements

Oracle Database 11g Release 2 (11.2.0.2) and WebLogic Server release 10.3.4 (PS3) must be installed before you can install Oracle SES release 11.2.1.

Use only the browsers listed in "Oracle SES Browser Certifications" when using the Web-based Administration tool or the default Search application.

Oracle Database

Oracle Database must be release 11.2.0.2. If you have an earlier release of Oracle Database that you want to use for this installation, then you must first upgrade the database to release 11.2.0.2.

Oracle Database can be installed on a single computer or on a cluster that uses Oracle Real Application Clusters.

Note:

As of SES release 11.2.1, the mid-tier and the database are installed separately and do not need to be co-located on the same host, nor do they need to use the same operating system.

Oracle WebLogic Server

Oracle WebLogic Server must be release 10.3.4 (PS3). If you have an earlier release, then you must upgrade Oracle WebLogic Server to release 10.3.4 (PS3) before installing Oracle SES release 11.2.1.

Installation and Configuration Tasks

This section contains the following topics:

Running the Repository Creation Utility

The Repository Creation Utility (RCU) enables you to remove the Oracle SES 11.1 database components and create the Oracle SES 11.2 database components.

To run the Repository Creation Utility on Linux systems: 

  1. Create a directory where you can unzip RCU, such as /scratch/rcu:

    sudo mkdir /scratch/rcu
    
  2. Change directories to ORACLE_HOME/search/rcu.

    cd $ORACLE_HOME/search/rcu
    
  3. Unzip sesRcuHome.zip into the new directory:

    unzip sesRcuHome.zip -d /scratch/rcu
    
  4. Open RCU with the following command (where options indicates the optional command line parameters that you may use):

    /scratch/rcu/bin/rcu options
    

    You can provide optional parameters on the command line so that the fields in RCU are filled in automatically. For information about these options, enter the following command at the operating system prompt:

    rcu --help
    

To run the Repository Creation Utility on Windows systems: 

  1. Using Windows Explorer, create a folder where you can unzip RCU, such as C:\temp\rcu. Do not use spaces in the file name.

  2. Unzip ORACLE_HOME\search\rcu\sesRcuHome.zip into the new folder.

  3. Open RCU from the Run box or a command window with a command like this one:

    C:\temp\rcu\bin\rcu.bat options
    

    You can provide some information on the command line so that the fields in RCU are filled in automatically. For information about these options, enter this command at the operating system prompt:

See Also:

Oracle Fusion Middleware Repository Creation Utility User's Guide

Removing Oracle SES Components From Oracle Database

If Oracle Database release 11.2.0.1 or earlier is already installed, you must ensure that earlier Oracle SES components are removed before using the new Oracle SES 11.2 back-end components.

To remove Oracle SES back-end components: 

  1. Open the Repository Creation Utility (RCU) for Oracle Fusion Middleware, as described in "Running the Repository Creation Utility".

  2. Follow the steps of the wizard as described in Table 1. Click Next to move from one page to the next.

Table 1 Using RCU to Drop the SES 11.1 Schemas

Page Title Action

1

Welcome

None.

2

Create Repository

Select Drop.

3

Database Connection Details

Complete all fields. Any values that you entered as RCU command options are filled in automatically here.

  • Database Type: Oracle Database

  • Username: SYS

  • Role: SYSDBA

4

Select Components

Select SEARCH.

5

Summary

Review the details, then click Drop to drop the tablespaces.

6

Completion Summary

Note the location of the log files.


Figure 1 RCU Database Connection Details

Description of Figure 1 follows
Description of "Figure 1 RCU Database Connection Details"

Adding Oracle SES 11.2.1 Components to Oracle Database 11g Release 2 (11.2.0.2)

The following procedure adds Oracle SES 11.2.1 back-end components to Oracle Database release 11.2.0.2.

To add Oracle SES 11.2 components to Oracle Database: 

  1. Open the Repository Creation Utility (RCU) for Oracle Fusion Middleware, as described in "Running the Repository Creation Utility".

  2. Follow the steps of the wizard as described in Table 2. Click Next to move from one page to the next.

Table 2 Using RCU to Add the SES 11.2 Schemas

Page Title Action

1

Welcome

None.

2

Create Repository

Select Create.

3

Database Connection Details

Complete all fields. Any values that you entered as RCU command options are filled in automatically here.

  • Database Type: Oracle Database

  • Username: SYS

  • Role: SYSDBA

4

Select Components

Select SEARCH.

5

Schema Passwords

Enter passwords for the SEARCHSYS and SEARCHSYS_DATA schemas.

6

Custom Variables

Enter Y for yes or N for no depending on whether you have licenses for these database options:

  • Advanced Compression

  • Oracle Partitioning

7

Map Tablespaces

Retain the default values for the tablespaces.

8

Summary

Review the details, then click Create to create the tablespaces.

9

Completion Summary

Note the location of the log files, then click Close to exit RCU.


Configuring WebLogic Server for Oracle SES 11.2.1

The procedure in this section configures WebLogic Server 10.3.4 as the middle tier for Oracle SES 11.2.1. After completing this procedure, you can run the Oracle SES Administration tool and the default Search application.

To configure WebLogic Server: 

  1. Open the Fusion Middleware Configuration Wizard:

    • On Linux, change to ORACLE_HOME/wls/wlserver/common/bin and enter:

      config.sh
      
    • On Windows, change to C:\ORACLE_HOME\wls\wlserver\common\bin and click:

      config.bat
      
  2. Follow the steps of the wizard as described in Table 3. Click Next to move from one page to the next.

  3. Start WebLogic Server from the operating system command line:

    startWebLogic.sh
    

Table 3 Creating and Extending a WebLogic Server Domain

Page Title Action

1

Welcome

Select Create a new WebLogic domain.

2

Select Domain Source

Select Generate a domain configured automatically, then Oracle Secure Enterprise Search - 11.2.1.0.

3

Configure Administrator User Name and Password

Enter a name of your choosing for the domain name.

4

Configure Administrator User Name and Password

Enter a password for the weblogic user.

5

Configure JDBC Component Schema

Select:

  • Production Mode as the WebLogic startup mode.

  • JRockit SDK 1.6.0_20 as the available JDK.

6

Configure JDBC Component Schema

Select SearchAdminDS Schema as the Component Schema, then enter the host, port, and service name for Oracle Database, as shown in Figure 2.

Select SearchQueryDS Schema as the Component Schema. Re-enter the host, port, and service name.

7

Test Component Schema

Click Select All, then Test Connections.

If the test fails, then correct the connection information for the two schemas.

8

Select Optional Configuration

Leave all check boxes empty.

9

Configuration Summary

Review the details, then click Create.

10

Creating Domain

Note the URL for the Admin Server.

11

Completion Summary

Click Close.


Figure 2 WebLogic Domain JDBC Component Configuration

Description of Figure 2 follows
Description of "Figure 2 WebLogic Domain JDBC Component Configuration"

Postinstallation Tasks

Refer to My Oracle Support at https://support.oracle.com to check for the latest patches for Oracle Database and Oracle Fusion Middleware.

Starting and Stopping Oracle SES

This section contains procedures for starting and stopping Oracle SES. Note that you can start, suspend, and stop Oracle SES from the WebLogic administration console by going to http://wls_host:admin_port/console.

Note:

Startup and shutdown for the database and listener services are managed independently of the Oracle midtier.

To start Oracle SES: 

  1. Verify that Oracle Database is up and running. If it is down, start it now. You can use the tool of your choice, such as Oracle Enterprise Manager or SQL*Plus.

  2. Start WebLogic Server.

    • For Linux:

      startWebLogic.sh
      
    • For Windows:

      startWebLogic.bat
      
  3. Log in as the weblogic user with the password set under "Configuring WebLogic Server for Oracle SES 11.2.1".

  4. In a separate window, start Oracle SES.

    • For Linux:

      startManagedWebLogic.sh search_server1
      
    • For Windows:

      StartManagedWebLogic.bat search_server1
      
  5. Log in again as the weblogic user.

To stop Oracle SES: 

  1. Use the tool of your choice, such as Oracle Enterprise Manager or SQL*Plus. Oracle Database must be up and running to use these tools.

  2. Start WebLogic Server.

    • For Linux:

      startWebLogic.sh
      
    • For Windows:

      startWebLogic.bat
      
  3. Log in as the weblogic user with the password set under "Configuring WebLogic Server for Oracle SES 11.2.1".

  4. In a separate window, stop Oracle SES.

    • For Linux:

      stopManagedWebLogic.sh search_server1
      
    • For Windows:

      StopManagedWebLogic.bat search_server1
      
  5. If needed, log in again as the weblogic user.

Deinstallation Tasks

The recommended procedure for deinstalling Oracle SES is to run uninstall_search_software.sh from the Oracle Fusion Middleware home location as follows:

MW_HOME/Oracle_SES/install/uninstall_search_software.sh

To remove the search-specific back-end components from the database home, run the uninstall_search_software.sh script from ORACLE_HOME/install/.

After running uninstall_search_software.sh from either the Fusion Middleware home or the database home, you must run the Repository Creation Utility to completely remove all the Oracle SES 11.2 back-end components. Follow the procedure under "Removing Oracle SES Components From Oracle Database".

What to Do Next

To become familiar with Oracle Secure Enterprise Search, Oracle recommends that you take advantage of the resources described in this section.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/support/contact.html or visit http://www.oracle.com/accessibility/support.html if you are hearing impaired.


Oracle® Secure Enterprise Search Installation Guide, Release 11.2.1

E17644-02

Copyright © 2011, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.