3.3 Providing User Searches Based on E-Mail Addresses

By default, Messenger users can search for other users to add to their contact lists in the Messenger client by first name, by last name, by first and last name, and by eDirectory user ID. You can add the capability of searching on e-mail addresses by setting up Messenger addresses that are equivalent to users' existing e-mail addresses. To set up Messenger addresses, you must add one or more hostnames to your Messenger system.

For another approach to this task, see Customizing Authentication and Searches by eDirectory Attribute.

3.3.1 Establishing a Hostname for Your Messenger System

If all of your Messenger users have e-mail addresses that are part of the same Internet domain (for example, Corporate.com), you can set up your Messenger system to recognize that Internet domain name as a Messenger address. This enables users to locate contacts by searching for their e-mail addresses (for example, JSmith@Corporate.com).

  1. In ConsoleOne, browse to and expand the Messenger Service object.

  2. Right-click the Host Container object, then click New > Object.

    New Object dialog box
  3. Select nnmHost, then click OK.

    New Host dialog box
  4. Specify a descriptive name for the new Host object (or host profile)

    For simplicity, you might want to name the new host profile after the Internet domain name it represents. For example, if users receive e-mail at username@Corporate.com, then you could use Corporate as the name of the host profile.

  5. Select Define Additional Properties, then click OK.

    Host General page
  6. In the Host Name field, specify the Internet domain name that appears in users' e-mail addresses (for example, Corporate.com).

  7. In the Scope Profile field, browse to and select the Default Scope Profile object, then click OK to create the new host profile.

  8. Right-click the Messenger Service object, then click Properties.

    Messenger Service General page
  9. Beside the Host list, click Add.

  10. Browse to and select the new host profile you created in Step 7 above.

  11. Click OK to save the updated host list.

  12. Stop and then start the Messaging Agent to put the new hostname into effect.

Messenger users can now specify e-mail addresses as well as eDirectory user IDs in the Messenger client Use This User ID field.

If archiving is enabled, authorized Messenger users can search the Messenger archive for users' conversations by specifying their e-mail addresses. Conversations archived before the hostname was established are not searchable by e-mail address.

3.3.2 Setting Up Multiple Hostnames

If your organization is large, it might be divided up into units. For example, Corporate.com might include Development.Corporate.com, Sales.Corporate.com, and so forth. By setting up multiple hostnames, you enable Messenger users to search for contacts within subsets of your organization.

In order to set up multiple hostnames, you must first set up a scope profile for each hostname.

  1. In ConsoleOne, browse to and expand the Messenger Service object.

  2. Right-click the Scope Container object, then click New > Object.

    New Object dialog box
  3. Select nnmScopeProfile, then click OK.

    New Scope Profile dialog box
  4. Type a descriptive name for the new scope profile, select Define Additional Properties, then click OK.

    Scope Profile General page
  5. Click Add.

    Context List Entry dialog box
  6. Browse to and select one or more contexts that use the hostname you want to create.

  7. If necessary, select Include sub-contexts for the selected contexts.

  8. Click OK to add the contexts to the context list.

  9. Repeat Step 5 through Step 8 for additional contexts that use the hostname you want to create.

  10. Click OK to save the scope profile for the hostname.

  11. Right-click the Host Container object, then click New > Object.

    New Object dialog box
  12. Select nnmHost, then click OK.

    New Host dialog box
  13. Type a descriptive name for the new Host object.

    It could be the same as the hostname you are setting up or it could be different, as needed.

  14. Select Define additional properties, then click OK.

    Host General page
  15. Fill in the following fields:

    Host Name: Specify the hostname the corresponds to the scope profile you created in Step 10 above.

    Continuing with the above example, to subdivide Corporate.com, you would specify Development.Corporate.com.

    Scope Profile: Browse to and select the new scope profile you just created in Step 10 above.

  16. Click OK to create the new Host object.

  17. Repeat Step 2 through Step 16 for each hostname you want to establish in your Messenger system.

  18. Right-click the Messenger Service object, then click Properties.

    Messenger Service General page
  19. Beside the host list, click Add.

  20. Browse to and select the new Host objects to add them to the host list.

  21. Click OK to save the updated host list.

  22. Stop and then start the Messaging Agent to put the new hostnames into effect.