Share via


How to Modify ADAM Configuration

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

 

Applies to: Exchange Server 2007, Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

This topic explains how to use the ConfigureAdam.ps1 script in the Exchange Management Shell to modify the default configuration of the Active Directory Application Mode (ADAM) directory service on the Edge Transport server.

Important

Do not modify the ADAM configuration of an Edge Transport server after the Edge Transport server is subscribed to the Microsoft Exchange Server 2007 organization. If you modify the ADAM configuration of a subscribed Edge Transport server, you must resubscribe the Edge Transport server to the Exchange organization. To resubscribe an Edge Transport server, export a new XML file on the Edge Transport server and then import the XML file on a Hub Transport server. You must resubscribe the Edge Transport server to the same Active Directory site to which it was originally subscribed. You do not have to first remove the original Edge Subscription. The resubscription process overwrites the existing subscription. For more information, see Managing Edge Subscriptions.

Modifying ADAM Configuration

After you install the Edge Transport server role, you can use the ConfigureAdam.ps1 script that is provided with Exchange 2007 to modify the ports and directories that the ADAM directory service uses.

The ConfigureAdam.ps1 script invokes the dsdbutil command to change the registry settings for ADAM. The dsdbutil command is a management tool for ADAM that is intended for use by experienced administrators only.

Warning

Do not modify the registry settings without using the script. Manual registry changes to the ADAM configuration make the ADAM instance unavailable.

Warning

Incorrectly editing the registry can cause serious problems that may require you to reinstall your operating system. Problems resulting from editing the registry incorrectly may not be able to be resolved. Before editing the registry, back up any valuable data.

The following table lists the parameters that can be used by the ConfigureAdam.ps1 script, how each parameter is used, and the registry setting that is modified by the script. You can use one, all, or a combination of any of these parameters to modify ADAM. You must run the script by using the Exchange Management Shell.

ConfigureAdam.ps1 parameters, their use, and associated registry settings

Parameter Use Registry setting

Ldapport

Use this parameter to modify the port that is used for LDAP communication. By default, the Edge Transport server uses the non-standard port 50389.

HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\v8.0\EdgeTransportRole\AdamSettings\MsExchangeAdam\LdapPort REG_DWORD

Sslport

Use this parameter to modify the communication port that is used for secure LDAP communication. By default, the Edge Transport server uses the non-standard port 50636.

HKLM\Software\Microsoft\Exchange\v8.0\EdgeTransportRole\AdamSettings\MsExchangeAdam\SslPort REG_DWORD

LogPath

Use this parameter to modify the location of the log files. By default, the Edge Transport server creates log files in the path C:\Program Files\Microsoft\Exchange server\Transport Roles\Data\adam.

HKLM\Software\Microsoft\Exchange\v8.0\EdgeTransportRole\AdamSettings\MsExchangeAdam\LogFilesPath REG_SZ

DataPath

Use this parameter to modify the location of the directory database file. By default, the Edge Transport server stores the directory database in the path C:\Program Files\Microsoft\Exchange server\Transport Roles\Data\adam.

HKLM\Software\Microsoft\Exchange\v8.0\EdgeTransportRole\AdamSettings\MsExchangeAdam\DataFilesPath REG_SZ

Before You Begin

Determine the settings that you will use with this command. If you modify the LDAP port or the SSL port that is used by ADAM, first verify that the selected port is not being used by another application. You can use the netstat command to view ports that are being used on the Edge Transport server.

To perform the following procedures on a computer that has the Edge Transport server role installed, you must log on by using an account that is a member of the local Administrators group on that computer.

Procedure

To use the ConfigureAdam.ps1 script to modify all ADAM configuration parameters

  • Open the Exchange Management Shell, and run the following command:

    ConfigureAdam.ps1 -ldapport:5000 -sslport:5001 -logPath:"d:\exchange server\data\adam" -dataPath:"d:\exchange server\data\adam"
    

To use the ConfigureAdam.ps1 script to modify only the LDAP port

  • Open the Exchange Management Shell, and run the following command:

    ConfigureAdam.ps1 -ldapport:5000
    

For More Information

For more information, see the following topics: