Creating Management Agents

For data sources without management agents, you can synchronize the data by using the extensible connectivity management agent with a connected data source extension. The extensible connectivity management agent can also be packaged into a management agent that can be distributed with the connected data source extension to other ILM 2007 FP1 servers.

This topic shows you how to package an extensible connectivity management agent into a packaged management agent that can be distributed to other ILM 2007 FP1 servers.

The topic assumes you are familiar with the following tasks:

• Creating connected data source extensions
• Configuring management agents in ILM 2007 FP1. For more information, see Work with Management Agents in the Microsoft Identity Lifecycle Manager 2007, Feature Pack 1 Help.
• Creating XML files.
• Using command-line utility programs.
• Creating installation programs.

Note  The only management agent that can be packaged is the extensible connectivity management agent. The Management Agent Packaging Tool can only create a distributable management agent from the extensible connectivity management agent.

To Create A Packaged Management Agent

1. Create an extensible connectivity management agent in Identity Manager. For more information, see Configure Management Agents with Management Agent Designer in the ILM 2007 FP1 Help.
2. Export the extensible connectivity management agent to a server configuration XML file. For more information, see Export a management agent to file in the ILM 2007 FP1 Help.
3. Create a customization file to identify your management agent and to specify how your management agent appears in Identity Manager. See Creating a customization file.
4. Use the Management Agent Packaging Tool with the server configuration XML file and the customization XML to package the extensible management agent. See Using the Management Agent Packaging Tool
5. Copy the packaged management agent and the connected data source extension into the ILM 2007 FP1 server, either using a setup program or manually. See Installing the Packaged Management Agent and Connected Data Source Extension.
6. Create the management agent in the ILM 2007 FP1 server. For more information, see Configure Management Agents with Management Agent Designer in the ILM 2007 FP1 Help.

Creating a Customization File

The Management Agent Packaging Tool requires a customization file to create a packaged management agent. The contents of this file are used in Identity Manager to display your packaged management agent, and internally by ILM 2007 FP1.

The customization file is an XML file that contains the following elements:

• <ma-customization-info>

  • <ma-internal-version>
  • <ma-companyname>
  • <ma-subtype>
  • <ma-listname>
  • <ma-help-text>

The following XML example shows a customization file for a management agent created by a fictional company called Fabrikam.

<ma-customization-info>
    <ma-internal-version>1</ma-internal-version>
    <ma-companyname>Fabrikam</ma-companyname>
    <ma-subtype>Fabrikam ECMA</ma-subtype>
    <ma-listname>Fabrikam Custom Management Agent</ma-listname>
    <ma-help-text>This is the text that appears in the Create Management Agent dialog box.</ma-help-text>   
</ma-customization-info>

The following illustration shows where some of the elements are used in Create Management Agent.

The <ma-internal-version> and <ma-subtype> elements are used internally by ILM 2007 FP1. For more information about these elements, see Configuration File XML Reference.

Using the Management Agent Packaging Tool

After exporting the server configuration of your extensible connectivity management agent to an XML file and creating the customization file, you can use the Management Agent Packaging Tool to create a distributable management agent.

The Management Agent Packaging Tool combines the server configuration and customization files into an XML file. You then put this file the following folder: UIShell\XMLs\PackagedMAs, which is part of the ILM 2007 FP1 program folder. The default folder is C:\Program Files\Microsoft Identity Integration Server. For more information, see Management Agent Packaging Tool Reference.

Installing the Packaged Management Agent and Connected Data Source Extension

The distributable management agent and connected data source extension can be copied to the appropriate directories either manually or through a setup program. The following table shows the default folders for these files.

File	Folder
Packaged Management Agent XML file	C:\Program Files\Microsoft Identity Integration Server\UIShell\XMLs\PackagedMAs
Connected Data Source Extension files	C:\Program Files\Microsoft Identity Integration Server\Extensions

Note  Close Identity Manager before copying the XML file of the distributable management agent to the folder. The management agent might not appear in the Management agent list box of Create Management Agent in Identity Manager if the management agent file was copied to the folder with Identity Manager open.

To verify that the files were installed in the correct folders, open Identity Manager and create a management agent. In Create Management Agent, your management agent should be in the Management agent list box. For more information, see Configure Management Agents with Management Agent Designer in the ILM 2007 FP1 Help.

Send comments about this topic to Microsoft

Build date: 2/16/2009