Configure the IMAP Connector

This section implies that the connector has already been added.

See Creating a Standard Connector.

This task shows you how to:

See Also
Folder Configuration Examples

Configure the IMAP Server Global Configuration

  1. In Server name, enter the name of the IMAP server.

    For example, imap.mycompany.com

  2. In Server port, enter the IMAP server's port number. It is usually 143 or 993 if SSL is activated.
  3. Specify the following timeout limitations:
    1. Read/Write timeout to specify the time limit in seconds for reading a message.
    2. Connect timeout to specify the time limit in seconds for connecting to the IMAP server.
  4. Select SSL if the server is a secured IMAPS server.
  5. If SSL is enabled, you can select the Authorize all certificates property to allow users to access the IMAPS server without certificate authentication.
  6. For efficiency, mails are retrieved by groups and loaded into memory. To avoid "out of memory" errors, it is therefore important to specify the two following limitations:
    1. In Max. fetched mails, the maximum number of mails to fetch.
    2. In Max. fetched size, the maximum size (in MB) allowed for a group of mails.

If one of these thresholds is crossed, the mail or group of mails, is not indexed and an error is displayed in the logs of the connectors-java0 process. See Troubleshooting.

Configure a User Account

Before you begin: You can specify the users that have access to mail folders by associating them to a user account. You create user accounts under User accounts and you specify the security tokens associated to each user account in Users. For example, you can create the user account marketing.team and index the content of this account from imap.gmail.com. For this account, you define the login marketing.team and its associated password. You also create a list of users to restrain the access to the account to the users of this list, by listing their security tokens.
  1. Go to User accounts > Item 0.
  2. In Login, enter the login of the IMAP account, and in Password, enter the password associated to this login.
  3. To index unread email messages, select Index unread.
  4. To use the mail server’s date instead of the date found in the message body, select Use internal date.
  5. If your mail server has folders that you want everyone to have access to, select Public.
  6. In Users, you can then specify a list of security tokens corresponding to the users allowed to access the indexed documents with this user account.

    Copy the security tokens that have been defined under Security Sources > Configuration.

  7. To secure the search access, you can then add a security source.
    1. From Search > Security Sources, add a security source.
    2. Create the users allowed to search for the documents of mail folders.

For more information on security sources, seeManaging User Access in the Exalead CloudView Administration Guide

Configure Folders

Before you begin: This procedure describes how to index mail folders and subfolders.
  1. Go to User account > Item 0 > Folders and click Add item.
  2. In Name, enter the name of the folder to index. Enter * if you want to index all folders.
  3. To include all subfolders in the indexing process, select Recursive.
  4. If you do not want to index a specific folder, enter its name in the Name field and select Ignore.
  5. To index thread objects, specify the following properties:
    1. Select Create threads to index thread objects.
    2. Select Only threads to index thread objects only (not individual mails).
  6. To use subjects to group mails together in one thread object:
    1. Select Subject normalization.
    2. In addition, you can use the Subject norm field to exclude a string from the subject.

    See Subject Normalization.

  7. In Subject filters, you can then specify a list of subject filters based on regular expressions. Mails with subjects matching these regular expressions are not indexed.
  8. For example, the regular expression .*noindex.* matches the following mail subject lines:
    • ****NOINDEX****
    • Private: Salary survey. noindex
    • noindex Pension fund review
  9. Click Save.

Check Connectivity

Before you begin: When you configure an IMAP connector source, it is good practice to ensure that Exalead CloudView can access the IMAP server.
  1. At the top of the IMAP connector > Configuration tab, click Check connectivity.
  2. If an error message appears, read the instructions to tackle the issue.