› Communications Manager Installation Guide › Export functionality and initialization of new components › Export Contract Manager configuration

Export Contract Manager configuration

ExportContractManagerConfiguration.exe is a command-line tool designed to export an existing Contract Manager configuration into a .zip file. This configuration can be later imported to another Contract Manager.

This tool resides in: <deploy root>\CommunicationsManager\Programs\<version>\Management\Contract Manager.

ExportContractManagerConfiguration.exe tool can perform configuration export with or without infrastructure.

  • If exported without infrastructure, configuration contains the following items:
    • The log configuration of the Contract Manager.
    • The log configuration of the Contract Manager Registration.
    • The custom interfaces and custom contract types that are registered on the Contract Manager.
A custom interface or contract type is one that is created by the customer after installation.
  • If exported with infrastructure, configuration contains the items above, and also the following items:
    • Partners, customers and contracts that are registered on the Contract Manager.
    • Communications Manager instances and contract associations that are registered on the Contract Manager.
    • The application keys and privileges that are registered on the Contract Manager

Before you start

  1. Make sure the account used to run ExportContractManagerConfiguration.exe is included in the local Administrators group on the target server.

Parameters

To view the list of parameters for ExportContractManagerConfiguration.exe, run it without any parameters.

Parameter

Required / Optional Description
Product!Version Required if Communications Manager installation is not active

The Communications Manager version to export from.

Enter version number in the format Major.Minor

Example: Product!Version=2025.3

If omitted, defaults to the currently active Communications Manager installation.

ContractManager!ExportConfigurationFile Required The file to write the configuration export to.
ContractManage!ExportInfrastructure Required

Boolean flag that specifies whether the configuration is exported with or without infrastructure settings.

  • If set to True, configuration export will include infrastructure settings.
  • If set to False, configuration export will not include infrastructure settings.

Notes on usage

To create an export from an older Tungsten Communications Manager version, use the following procedure:

  1. Open the Software\Tools folder of the Tungsten Communications Manager 2025.3 installation package and locate the following files:
    • ExportContractManagerConfiguration.exe
    • ExportContractManagerConfiguration.exe.config
    • Nlog.config
    • All .dll files.
  2. Copy these files to the server on which the old Tungsten Communications Manager version is installed. All files must be placed in the same folder.
  3. From that folder, run ExportContractManagerConfiguration.exe.

If creating an export from an older Tungsten Communications Manager version, some configuration items may not be compatible with the current Tungsten Communications Manager version. Such items will be removed from the export. The result is a partial export, which can still be imported, although missing these items.

Import of exported configuration works only on the current Tungsten Communications Manager version and higher. It is only supported for exports created with the ExportContractManagerConfiguration tool included in the Tungsten Communications Manager version to which you import.