Microsoft Identity Integration Server 2003 graphic

Mapackager: Management agent packaging tool

Creates an XML file from an exported extensible management agent that can be used by Microsoft Identity Integration Server 2003 as a packaged management agent.

Syntax

Mapackager /e: ma_file /c: customization_file_name /o: output_file

Parameters

Ma_file

Specifies the file that contains the XML generated from running Export Management Agent in Identity Manager.

Customization_file_name

The file that contains the customization information. This is specified in XML and has the following schema:

<ma-customization-info>
     <ma-internal-version>
     <ma-companyname>
     <ma-subtype>
     <ma-listname>
     <ma-help-text>
</ma-customization-info>

For example:

<ma-customization-info>
     <ma-internal-version>1</ma-internal-version>
     <ma-companyname>Fabrikam</ma-companyname>
     <ma-subtype>Enterprise Connectivity</ma-subtype>
     <ma-listname>Custom management agent</ma-listname>
     <ma-help-text>Custom management agent created by Fabrikam</ma-help-text>
</ma-customization-info>

Element	Description
ma-internal-version	Used to identify management agents that are created from this packaged management agent. This must be an integer value.
ma-companyname	Name of the company to display in the management agent type, for example Fabrikam. Ma-companyname is combined with ma-subtype to create the value for ma-type. Limited to 255 characters.
ma-subtype	Name of the management agent type, for example, NextGen MA. This should be a unique value. Ma-subtype is combined with ma-companyname to create the value for ma-type. Limited to 255 characters.
ma-listname	Name of the management agent as you want it to appear in the list of available management agents in Identity Manager. This should be a unique value. For the above example, the displayed name could be NextGen MA - Fabrikam. Limited to 255 characters.
ma-help-text	Text displayed in Identity Manager that describes what the management agent is used for. For example, "With this management agent, you can connect to the Fabrikam Human Resources database." Limited to 255 characters.

Output_file

The name of the packaged XML output file.

/?

Displays help at the command prompt.

Remarks

Mapackager.exe is located in the InstallationDirectory\Bin folder.
All elements in the customization file are mandatory.

Example

To create a packaged XML file for the "ABC" management agent, type:

mapackager /e: exported_ABC_MA.xml /c: custom_data_ABC.xml /o: packaged_ABC_MA.xml

Formatting legend

Format	Meaning
Italic	Information that the user must supply
Bold	Elements that the user must type exactly as shown
Ellipsis (...)	Parameter that can be repeated several times in a command line
Between brackets ([])	Optional items
Between braces ({}); choices separated by pipe (\|). Example: {even\|odd}	Set of choices from which the user must choose only one
`Courier font`	Code or program output