For this procedure, using Management Agent Designer, on the
Create Management Agent page you select the type of
management agent that you want to create. This page appears only
when you create a new management agent. To complete this procedure, you must be logged on as a member of the MIISAdmins security group.
This procedure applies to management agents for the following
Microsoft Identity Integration Server 2003 editions:
Identity Integration Feature Pack for Active Directory
Active Directory, Active Directory Application Mode (ADAM),
Active Directory Global Address List (GAL)
To create a management agent
On the Tools menu, click Management Agents.
On the Actions menu, click Create.
In Management Agent Designer, in Management agent
type, click the type of management agent that you want to
In Name, type a name for the management agent.
In Description, type a description for the management
Click Next, and then, follow the instructions for
configuring additional pages in Management Agent Designer.
Do not run Windows Management Instrumentation (WMI) scripts
when you create a management agent. If you run WMI scripts when you
create a management agent, you might cause a management agent run
to fail or corrupt the management agent configuration.
After you create a management agent, you can view the
management agent's properties on the Properties page in
Management Agent Designer.
Each type of management agent has unique configuration
requirements. Management Agent Designer automatically presents the
appropriate configuration pages for the management agent that you
You cannot use the same name for two different management
agents that are located on the same server running Microsoft Identity Integration Server 2003. A valid management agent name can
contain uppercase or lowercase letters A through Z, numbers, dash
(-), underscore (_), period (.), comma (,), or space, and can not
be a reserved system file name. Other characters are not
When you create a new management agent, Management Agent
Designer creates a working folder with the same name as the
management agent in the root directory, by default, C:\Program
Files\Microsoft Identity Integration Server\MaData. The working
folder contains custom data input files from the connected data
sources that are associated with the management agent. If you
delete a management agent, Microsoft Identity Integration Server 2003deletes the associated working folder, unless
the folder contains files. If the working folder contains files,
Microsoft Identity Integration Server 2003 marks the working
folder for manual deletion. If you change the name of a management
agent, Microsoft Identity Integration Server 2003 changes name of
the associated working folder.
By default, the first time you create new management agent
using Management Agent Designer, the new management agent is run in
the same memory space as the Microsoft Identity Integration Server service. This improves overall performance by
consuming less memory space, but if a management agent process
fails, it might cause a disruption to the Microsoft Identity Integration Server service. After you create a management agent, you
can change the management agent so that it is run in a separate
memory space. This reduces the risk of a management agent process
from affecting the Microsoft Identity Integration Server service,
but it can decrease overall performance. To run a management agent
in a separate process, in Management Agents, click a
management agent. On the Actions menu, click
Properties. In Management Agent Designer, click
Properties, and then click Run this management agent in a
separate process. By running a management agent in a separate
memory space, you do not affect an associated rules extension that
also runs in its own memory space.