Skip Headers
Oracle® Secure Enterprise Search Administrator's Guide
11g Release 2 (11.2.1)

Part Number E17332-04
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
View PDF

Setting Up Oracle Collaboration Suite E-Mail Sources

Oracle Collaboration Suite 10g Mail (Oracle Mail) implements the IMAP protocol, which is used by Oracle SES to retrieve data. You must login to the mail server using the user name and password to retrieve information. Note that Oracle Collaboration Suite mail server has a flag that allows the administrator to crawl mails of all users. The IMAP connector uses this feature to crawl all the mails of all users using the mail server's administration login.

Important Notes for Oracle Collaboration Suite E-Mail Sources

Apart from the private folders, the Oracle Collaboration Suite E-Mail has shared folders. You can share any folder with another person by making it shared. Hence, while doing ACL stamping, the crawler must look if the mail is a part of a private folder or a shared folder and act accordingly.

The Oracle Collaboration Suite E-Mail has a Web interface to open mail. This same Web interface opens the searched mails from Oracle SES.

Required Tasks

For the e-mail administrator to crawl data, set this parameter:

Go to Farm - Midtier - Mail Application - IMAP Server - Default Settings, and set Allow Admin to Access Any Account to true.

Setting Up Identity Management for Oracle Collaboration Suite E-Mail Sources

Activate the identity plug-in on the Global Settings - Identity Management Setup page. Select Oracle Internet Directory identity plug-in and click Activate.

Enter values for the following parameters: 

  • Authentication Attribute: Select nickname.

  • Host name: Enter the host name of the computer where Oracle Internet Directory is running.

  • Port: Enter the value 389, which is the default LDAP port number.

  • Use SSL: Enter true or false.

  • Realm: Enter the Oracle Internet Directory realm; for example, dc=us,dc=oracle,dc=com.

  • User name: Enter the Oracle Internet Directory administrator user name; for example, cn=orcladmin.

  • Password: Enter the password for the user name.

Creating an Oracle Collaboration Suite E-Mail Source

Create an Oracle Collaboration Suite E-Mail source on the Home - Sources page. Select Oracle Collaboration Suite E-Mail from the Source Type list, and click Create.

Enter values for the following parameters: 

  • Email Server Address: The IP address or DNS name of the IMAP e-mail server to be crawled, with the port number. This also specifies if the e-mail server follows IMAP or IMAPS protocol. Required.

    Use the format:

    [imap | imaps]://IPaddress:portNumber

    An exception is thrown if this parameter is null. If the server address is incorrect, then an exception is logged at the time of accessing the server.

  • Email Server Admin User: The administration user name to access the e-mail server. Required.

  • Email Server Admin Password: The password of the e-mail admin user. Required.

  • Authentication Attribute: Attribute used to validate the user. This varies based on the identity plug-in used for authentication. Oracle Collaboration Suite E-Mail uses Oracle Internet Directory for authentication, so set this parameter to mail.

  • LDAP Server: The LDAP server information (IP address or DNS name, and so on).

  • LDAP Server Port: The LDAP server port number.

  • LDAP Base: The domain to be searched; for example, dc=oracle, dc=com.

  • LDAP Query: The query string defining the users whose e-mails must be crawled. This parameter is used for user-level partitioning.

    For example, to crawl only users with names beginning with A and having an e-mail in the domain us.example.com, the query is (|(cn=A*)(mail=*@us.example.com)).

  • LDAP Admin User Name: The administrator user name of the LDAP server. Required.

  • LDAP Admin Password: The password of the admin user of the LDAP server.

  • Days to which the crawling needs to be done: Specifies the number of days earlier to which the crawling must be done. The current date (time of crawl) is the base. For example, a value of 7 specifies crawling messages that are seven or more days old. Today is the default value.

  • Days from which crawling needs to be done: The number of days earlier from which the crawling is done. The current date (time of crawl) is the base. For example, a value of 200 specifies crawling messages with dates that are 200 or fewer days old. All mail is the default value.

  • Folders to crawl: The comma-delimited list of folders to be crawled. '*' means crawl all folders. Other valid values are INBOX, sent, and trash. This does not support regular expressions.

  • Folders not to crawl: The comma-delimited list of folders not to be crawled. This list is considered only if the Folders to crawl parameter has the * wildcard as its value. Valid values are INBOX, sent, and trash. This parameter does not support regular expressions.

  • Remove Deleted messages from Index: Indicates whether to keep the index for deleted mails in incremental recrawls. Valid values are yes and no. Any other value is considered to be yes.

  • Display URL template: The display URL to be used for viewing the documents. This should have the placeholder for e-mail or user ID. For example, to see the full e-mail address in the display URL, enter the following:

    http://<>/um/templates/message_list.uix?state=message_list&cAction=openmessage&message_wmuid=$EMAIL

    To see the user ID, enter the following:

    http://<>/um/templates/message_list.uix?state=message_list&cAction=openmessage&message_wmuid=$UID

  • Email Server Version: The email server to be crawled. Valid values are ocs10g or beehive.

  • Revisit Skipped Attachments: Controls whether the crawler revisits attachments that were skipped in earlier crawls because they did not meet the document type inclusion rules. This setting provides an alternative to a force recrawl after changing the document type inclusion rules. Set to TRUE to revisit skipped attachments, or set to FALSE otherwise (default). The skipped attachments must have been crawled in Oracle SES 11.1.2.2 or later to be revisited.