Mapackager: Management Agent Packaging Tool

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 Synchronization Service 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 Synchronization Service 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 Synchronization Service 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

See Also

Concepts

Command-Line Tools