Skip Headers
Oracle® Secure Enterprise Search Release Notes
10g Release 1 (10.1.7) Beta for All Platforms

Part Number B32015-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

Beta Draft

Oracle® Secure Enterprise Search

Release Notes

10g Release 1 (10.1.7) Beta for All Platforms

B32015-02

August 2006

Oracle Secure Enterprise Search (SES) 10g Release 1 (10.1.7) Beta Readme includes the following topics:

What's New in Release 10.1.7 Beta

Oracle Secure Enterprise Search 10g Release 1 (10.1.7) is a limited Beta release, available to selected customers only. It will be upgradable to version 10.1.8.

Release 10.1.7 contains the following new features:

Version Information

To identify detailed version information for your Oracle Secure Enterprise Search installation, do the following:

% $ORACLE_HOME/jdk/bin/jar -xvf $ORACLE_HOME/search/lib/search_query.jar
"oracle/search/query/buildinfo.properties"

% cd ./oracle/search/query

The buildinfo.properties file contains detailed build information that can be provided upon request to Oracle Technical Support.


Note:

$ORACLE_HOME represents the directory where Oracle SES was installed.

Known Issues

For updated information on bugs, workarounds, and best practices, go to the following site: http://www.oracle.com/technology/products/oses/index.html

Installation Issues

  • If Oracle SES is installed in a low-performance system, or a system with high system load, then it is possible for the installation to fail.

    Workaround: Switch to a higher-performance system, or reduce system load, before reinstalling.

    This is tracked with Oracle bug 5464943.

Linux Issues

  • On Linux only, in high I/O situations the system may hang if a large number of document conversion errors are encountered.

    Workaround: Turn off core file generation at the operating system level.

    This is tracked with Oracle bug 5199037.

Microsoft Windows Issues


Attention Windows Laptop Users:

If you frequently connect and disconnect your laptop from the network, or if you have your machine set to dynamically determine its IP address (DHCP protocol), then you must install a loopback adapter. See the Pre-Installation Steps in the Oracle Secure Enterprise Search Installation Guide for Microsoft Windows (32-Bit).

  • On Windows only: You must be part of the Administrators group on Windows to install Oracle SES.

    Workaround: Log on as a user with Administrator privileges to install.

    This is tracked with Oracle bug 5471204.

  • On Windows only: Silent-mode installations (specified with the -silent option) are not supported.

    Workaround: Install Oracle SES with Oracle Universal Installer in the standard interactive mode, which prompts you to provide information in GUI screens.

    This is tracked with Oracle bug 5482703.

  • On Windows only, the Search Configuration Assistant creates invalid directories under the C:\ drive.

    Workaround: Remove these directories after installation.

    This is tracked with Oracle bug 5489061.

  • On Windows only, Oracle SES cannot allocate memory (SGA + PGA) correctly if the machine has more than 2G physical memory. The maximum memory usage Oracle SES can allocate is 800M.

    Workaround: You can manually increase the maximum memory usage to 40% of the machine physical memory. Detailed instructions for this workaround are provided in the "Post-Installation Tasks" section of the Oracle Secure Enterprise Search Installation Guide for Microsoft Windows (32-Bit).

    This is tracked with Oracle bug 4620102.

  • On Windows only, the searchctl restart command fails.

    Workaround: If you encounter this issue, use searchctl stop then searchctl start instead of searchctl restart.

    This is tracked with Oracle bug 5475227.

  • On Windows only, online help pages are missing the top Contents, Search, and View Topic tabs.

    This is tracked with Oracle bug 5477987.

AIX Issues

  • On AIX only, the following line is also shown when starting the Oracle SES midtier (searchctl start):

    [ JVMCL200: Classloader system property ibm.cl.eagerresolution ]
    
    

    This is because an additional parameter "-Dibm.cl.eagerresolution" is required to startup OC4J on AIX.

    This is tracked as Oracle bug 5237455.

OracleAS Portal Issues

  • Secure OracleAS Portal crawling requires the latest version of OracleAS Portal.

    Workaround: The following table lists patch information necessary for each version of OracleAS Portal for which Oracle SES certifies. You can apply the one-off patch on top of the listed version, or you can wait to upgrade to the next patchset indicated. The one-off patches are available on Oracle Metalink at http://metalink.oracle.com. Enter the bug number for the appropriate OracleAS Portal release to get the patch.

    Table 1 OracleAS Portal Patch Necessary for Secure OracleAS Portal Crawling

    OracleAS Portal Release Patchset to Upgrade One-off Patch

    9.0.4

    9.0.4.3.0

    This is tracked with Oracle bug 4637116. This should be applied on top of 9.0.4.2.0.

    10.1.2

    10.1.2.2.0

    This is tracked with Oracle bug 4637116. This should be applied on top of 10.1.2.0.2.

    10.1.4

    10.1.4.1.0

    This is tracked with Oracle bug 4995600. This should be applied on top of 10.1.4.0.0.

    10.1.4

    Not available

    This is tracked with Oracle bug 5462366. This should be applied on top of 10.1.4.0.0.


General Issues

  • Oracle SES does not support a default entity to attribute mapping mechanism for XML content.

    Workaround: A custom crawler plug-in is required to crawl and index XML. (see the Oracle Secure Enterprise Search Administrator's Guide for details).

    This is tracked with Oracle bug 4501161.

  • The e-mail message browser in the default query application is unable to display attached HTML files for crawled e-mail messages that were originally sent from certain mail clients (for example, Mozilla Thunderbird). An UnsupportedEncodingException will be shown instead.

    This is tracked by Oracle bug 5104659.

Administration Issues

  • Table sources cannot handle quoted identifiers for the table or column names. For example, table or column names containing spaces, lowercase characters, or non-alphabetic characters other than underscore (_), dollar sign ($), and pound sign (#) are not supported.

    Workaround: Create a view using nonquoted identifiers on top of the table having quoted identifiers. Then crawl that view.

    This is tracked with Oracle bug 5093512.

  • Limitations in the range of characters that can be used in the Suggested Links feature: Suggested links does not support keywords with a hyphen, such as e-travel. The characters +-!`~ in a query string are ignored while matching suggested links, and the characters ~`!@#$%^*()_+-=[]\{}|;:?,./<>"'& should be ignored in suggested links.

    This is tracked with Oracle bugs 4434993, 4280409, and 4280437.

  • When an end user changes the credentials (user name/password) for a subscribed (self service) source after it has been crawled, the previous documents crawled with the old credentials remain in the index.This may cause unexpected behavior for e-mail sources, in which the old documents may share the same URL with new e-mail documents from the most recent e-mail account. In this situations, some e-mail messages from the most recent crawl using the new credentials may not be indexed if an old message shares the same folder and message IDs.

    Workaround: Update the crawler recrawl policy to Process All Documents on the Home - Schedules - Edit Schedules page, and recrawl the source.

    This is tracked with Oracle bug 5048374.

Secure Search Issues

  • The documented restrictions about changing ACL policies only work if the Authorization page for the source in the administration tool is current. If the page is not current, then you may be able to update the ACL policy in a way that should be disallowed.

    Workaround: Before updating the ACL policy, ensure that the Authorization page is current by clicking the browser Refresh button.

    This is tracked with Oracle bug 5065426.

Search Term Issues

  • Wildcard search inside a phrase is not supported.

    This is tracked with Oracle bug 4451462.

  • The Boolean OR operator is not supported between advanced search operators; for example, a site/filetype restricted term and other search terms.

    This is tracked with Oracle bug 4451445.

  • Very long search terms cause an exception in the Web service query interface.

    This is tracked with Oracle bug 4446793.

  • Browse results do not include file sources.

    This is tracked with Oracle bug 4285489.

Internationalization Issues

  • The administration environment language is reset to English after having been set to another language if not properly logged out.

    This is tracked with Oracle bug 4424711.

  • Browse categories render incorrectly in BIDI.

    This is tracked with Oracle bug 4198113.

Crawler Plug-in Issues

  • In the crawler plug-in interface, when a document is empty or is in pure text format (not HTML), document attributes may not be inserted correctly into the index. This may affect attribute search and search within a source group.

    Workaround: Add a start tag and end tag in the document content; for example, <html></html> for empty or text documents before submitting the document to the crawler.

    This is tracked with Oracle bug 5047114.

  • When editing user-defined sources, the following pages in the administration tool do not apply to the crawler plug-in:

    • Authentication page

    • Document Types page

    • Crawling Parameters page: Only the following fields on this page can be set for user-defined sources: Number of crawling threads, Enable language detection, Default language

Web Services API Issues

  • The logUserClick API is not supported.

    This is tracked with Oracle bug 5090058.

  • Deploying an application using the Web Services APIs in the same middle tier (OC4J container) as Oracle SES is not supported if the Oracle SES crawlers require HTTP proxy settings.

    Workaround: Oracle SES HTTP proxy settings are applied to the entire OC4J container. Invocation of the WS APIs should be done without using a proxy. That is, this particular URL to the custom Web application should be excluded from the proxy settings. For this, make the settings in searchctl.pl file directly, so that it will be effective for the entire OC4J container.

    1. Open $ORACLE_HOME/bin/searchctl.pl.

    2. Find the startUS subroutine.

    3. Add the following options to the $cmd variable after the first doublequote:

      -Dhttps.proxyHost=<host> -Dhttps.proxyPort=<port> 
      -Dhttp.proxyHost=<host> -Dhttp.proxyPort=<port>
      -Dhttp.nonProxyHosts='<*.domain>'
       
      

      where <*.domain> is the domain you want to exclude from the proxy settings

    4. Restart the middle tier with searchctl restart.

    This is tracked with Oracle bug 5102814.

Documentation Errata

This section corrects errors in the existing documentation.

Online Help

  • Oracle SES includes a built-in source type for Oracle Content Database. Oracle Content Database is the new name for the latest release of Oracle Content Services. This section uses the product name Oracle Content Database to mean Oracle Content Database and Oracle Content Services. The online help uses the product name Oracle Content Services to mean Oracle Content Database and Oracle Content Services. Oracle Content Database sources are certified with Oracle Content Database release 10.2 and Oracle Content Services release 10.1.2.3.

  • The online help for the end-user search page states that the following file type extensions are supported for file type filtering: doc, html, pdf, txt, rtf, ppt, xls. Oracle SES 10.1.7 also supports ps, htm, and xml.

  • The Home - Sources - Crawling Parameters help page says that Index Dynamic Page is set to No by default. This is incorrect. The default is Yes.

  • The Global Settings - Query Configuration help page says that the spelling correction feature is turned on by default. This is incorrect. Enable Spelling Correction is set to No by default.

  • The Global Settings - Crawler Configuration page says, "If the total number of log files for a source reaches three, then the oldest log file is deleted." This is incorrect. The three should be changed to seven.

  • The Home - Sources - Authentication for OracleAS Portal Sources help page states the following: "Note: The user specified must have view-all privileges for the page groups being crawled." This is incorrect. It should state the following: "The user specified must have the following privileges in OracleAS Portal: the View privilege on the object types All Page Groups, All Pages, and All Styles."

  • When creating a federated source, you must enter the Web services URL. The tip below the input box uses the following example: <protocol>://<host>:<port>/default/query/OracleSearch. This is incorrect. It should be the actual default Oracle SES Web services URL. For example: <protocol>://host>:<port>/search/query/OracleSearch

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. 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.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.


Oracle Secure Enterprise Search Release Notes, 10g Release 1 (10.1.7) Beta for All Platforms

B32015-02

Copyright © 2006, Oracle. All rights reserved.

The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.

The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.

If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States 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, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software—Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.

Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle USA, Inc. and/or its affiliates. Other names may be trademarks of their respective owners.

The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.

Alpha and Beta Draft documentation are considered to be in prerelease status. This documentation is intended for demonstration and preliminary use only. We expect that you may encounter some errors, ranging from typographical errors to data inaccuracies. This documentation is subject to change without notice, and it may not be specific to the hardware on which you are using the software. Please be advised that prerelease documentation is not warranted in any manner, for any purpose, and we will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.