Microsoft Identity Integration Server 2003 graphic

Create a management agent

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:

Enterprise Edition	Identity Integration Feature Pack for Active Directory
All	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 create.
In Name, type a name for the management agent.
In Description, type a description for the management agent.
Click Next, and then, follow the instructions for configuring additional pages in Management Agent Designer.

Caution

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.

Notes

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 select.
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 permitted.
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.