Synopsis:
How to add LDAP directory services to your e-mail client in order to find people at Princeton University and auto-complete the To: field.

Solution:
Configurations for supported e-mail applications are as follows:

Legacy software instructions for archival purposes:

• Mozilla / Netscape 7 and 8
• Netscape Communicator 4.x
• Eudora Pro (Windows)
• Eudora Pro (Mac)
• Outlook 98/2000 in IMAP mode
• Outlook 2000 in Exchange mode

Thunderbird/SeaMonkey

• From the Tools menu, select Account Settings...
• On the left, in the Categories window, select Composition and Addressing
• On the right, find the Addressing or Address Autocompletion settings
• Click Use a Different LDAP server so that Edit Directories... is available
• Click Edit Directories...
• In the LDAP Directory Servers window, click Add
• Within the Directory Server Properties window:
  • In the name field type: Princeton University
  • In the Hostname field type: ldap.princeton.edu
  • In the Base DN field type: o=Princeton University,c=US
    
    
• Click OK to close the Directory Server Properties window
• Click OK to close the LDAP Directory Server window
• You should be back at the Preferences window
• In the Directory Server field, pull down to Princeton University so that it is selected
  
  
• Click OK to close the Preferences window

Netscape Communicator 4.x

• In the Communicator pull-down menu select "Address Book"
• In the File pull-down menu select "New Directory"
• Enter the following in their respective fields:
• In the description type: Princeton University
• In the LDAP server field type: ldap.princeton.edu
• In the Search Root field type: o=Princeton University,c=US
• In the Port Number field verify that port 389 is typed. Click "OK"
• In the Edit pull-down menu select "Preferences"
• Under Mail & Newsgroups category on the left select "Addressing"
• Click in the box for "Directory Server"
• Select Princeton University in pull-down field
• Click OK

Mozilla / Netscape 7 and 8

• From the Edit menu, choose Preferences
• In left part of Preferences window, expand the Mail & Newsgroups and select Addressing
• In the right part of the this same Preferences window, you should see the
• Address Autocompletion settings
• Click Edit Directories...
• In the LDAP Directory Servers window, click Add
• In the Directory Server Properties window
• In the name field type: Princeton University
• In the Hostname field type: ldap.princeton.edu
• In the Base DN field type: o=Princeton University,c=US
• Click OK to close the Directory Server Properties window
• Click OK to close the LDAP Directory Server window
• You should be back at the Preferences window
• Check the box for Directory Server: Princeton University
• Click OK to close the Preferences window

Eudora Pro (Windows)

• Go to Tools -> Directory Services
• In the Protocols, highlight LDAP by clicking on it once
• Click on the "New Database" button
• In the Network tab:
• - name this entry Princeton
• - set the Hostname to: ldap.princeton.edu
• - the Port should be: 389
• In the Search Options tab:
• - set the Search Base to: o=Princeton University,c=US
• Click OK

Eudora Pro (Mac OS)

• Make sure that the Esoteric Settings plugin file is in your Eudora Stuff folder (it is not there by default). If it is not there, you should be able to find it in the Extra Plugins folder. Move it into the Eudora Stuff folder.
• Open Eudora (if you have moved the Esoteric Settings plugin, you will have to quit Eudora and open it again).
• Go to the Special menu and choose Settings.
• Click on the LDAP icon.
• Fill in the following settings:
• Directory Services Host:
• ldap://ldap.princeton.edu/o=Princeton University,c=US
• Word-wise search filter template (Princeton's LDAP server cannot handle Eudora's default setting):
• (cn=*^0*)
• Full query search filter template: (leave blank)

Mac OS X Mail

• Open the Mail application
• From the Mail menu, select Preferences
• Select Composing from the buttons at the top of the window
• Check "automatically complete addresses," if it is not already checked and then click the Configure LDAP button.
• In the new window, click either the Add button or the + sign
• Edit the server information, double click in each field and change its contents. Set them as follows:
• Name: Princeton University
• Server: ldap.princeton.edu
• Search Base: o=Princeton University,c=US
• Leave default settings for Port, Scope, and Authentication (if you have those fields).
• Click Save, and then Done.
• Now the Mail client will attempt to auto-complete messages as you address them.

Microsoft Outlook 98/2000 using IMAP Server

• When adding the LDAP directory to Outlook, you need to specify a 'Search Base.'
• Go to Tools - Accounts - Directory Service
• Click the 'Add' button
• Choose 'Directory Service'
• For 'Internet Directory (LDAP) server, type
• ldap.princeton.edu
• Continue clicking 'Next' and then 'Finish'
• Click the 'Properties' tab to edit the entry
• Click the 'Advanced' tab
• In the 'Search Base' field, type
• o=Princeton University,c=US
• Click OK

Microsoft Outlook 2000 using the Exchange server

• From the Tools menu, select Services.
• Select the Services tab and click Add.
• Choose Outlook Address Book and click OK. Click OK again, then restart Outlook.
• When Outlook reopens, a message will inform you that the location messages are delivered to has been changed. Click Yes to continue.
• Select the Contacts folder in the Exchange mailbox. From the File menu, expand the Folder sub-menu and select Properties for “Contacts.”
• Select the Outlook Address Book tab and check the box for Show this folder as an e-mail Address Book. Click OK.
• Select the Contacts folder in the Personal Folders mailbox. From the File menu, expand the Folder sub-menu and select Properties for “Contacts.”
• Select the Outlook Address Book tab and uncheck the box for Show this folder as an e-mail Address Book. Click OK.
• From the Tools menu, select Address Book. In the new Address Book window that appears, click on the Tools menu and select Options.
• Set the Show this address list first pull-down menu to Global Address List and click OK.

Microsoft Outlook 2003 / 2002 (XP) using Exchange server

• From the Tools menu, select E-mail Accounts.
• Choose Add a new directory or address book. Click Next.
• Choose Additional Address Books. Click Next.
• Select Outlook Address book. Click Next. Click OK.
• Restart Outlook.
• Select the Contacts folder in the Exchange mailbox. From the File menu, expand the Folder sub-menu and select Properties or “Contacts.”
• Select the Outlook Address Book tab and check the box for Show this folder as an e-mail Address Book. Click OK.
• Select the Contacts folder in the Personal Folders mailbox. From the File menu, expand the Folder sub-menu and select Properties for “Contacts.”
• Select the Outlook Address Book tab and uncheck the box for Show this folder as an e-mail Address Book. Click OK.
• From the Tools menu, select Address Book.
• In the new Address Book window that appears, click on the Tools menu and select Options.
• Set the “Show this address list first” pull-down menu to Global Address List.
• Click OK and exit out of the Address Book window.

To Search: While composing a new message, type the last name only of a person's name in the To: Field, then click the 'Check Names' icon (which looks like a head with a check mark). If you prefer you can use the keyboard combination of Ctrl + K. A list of possible e-mail addresses will be shown.

Unix search command "ldapsearch"
When using the hats or arizona servers, you can query the University's online campus directory using the "ldapsearch" command.

As an example, suppose you want to look up the telephone number of a person whose netID is "foobar".

1. Using SSH, log on to arizona.princeton.edu

2. At the Unix system prompt, enter

ldapsearch -h ldap.princeton.edu -b "o=Princeton University,c=US" uid=foobar dn telephoneNumber

The online campus directory will return the result in a form similar to:

cn=Fred O Obar (foobar@Princeton.EDU),o=Princeton University,c=US telephoneNumber=609-234-5678

For the hats servers, the command needs an additional -x option, as in:

ldapsearch -x -h ldap.princeton.edu -b "o=Princeton University,c=US" uid=foobar dn telephoneNumber