dmimportuserconfiguration - Import multiple CDC Replication configurations

Use this command to create or update one or more instances of CDC Replication by importing the configuration settings from an XML file that you created with the dmexportconfiguration command and an XML configuration file with values that you want to override.

You can script this command and use a silent installation to deploy CDC Replication on multiple systems.

Syntax

At a command prompt, launch the import user configuration tool by issuing one of the following commands in the specified directory:

Windows

CDC_Replication_installation_directory\bin\dmimportuserconfiguration path-to-base-XML-configuration-file path-to-user-XML-configuration-file [-L locale]

Linux and UNIX

CDC_Replication_installation_directory/bin/dmimportuserconfiguration path-to-base-XML-configuration-file path-to-user-XML-configuration-file [-L locale]

Parameters

CDC_Replication_installation_directory: The path to the CDC Replication installation folder.
path-to-base-XML-configuration-file: The absolute path to the base XML configuration file that you are importing. This file is generated using dmexportconfiguration on an existing instance of CDC Replication.
path-to-user-XML-configuration-file: The absolute path to the user XML configuration file that is created manually by using the export XML. The file has keys and values that you want to override in the base XML configuration file.
[-L locale]: The name of the locale that is used for the CDC Replication instance. The default is your machine's locale.

Result

This command returns a value of 0 if the command was successful and a non-zero value if the command fails.

Example

The following example shows the format of an XML user configuration file named userconfiguration.xml:

<userconfig>

<instance overrideTargetTables="true">
<name>instancename1</name>
<tcpPort>10450</tcpPort>
<dbName>dbname1</dbName>
...
...
</instance>

<instance overrideTargetTables="true">
<name>instancename2</name>
<tcpPort>10451</tcpPort>
<dbName>dbname2</dbName>
...
</instance>

...
...
...

<instance overrideTargetTables="true">
<name>instancenameN</name>
<tcpPort>10500</tcpPort>
<dbName>dbnameN</dbName>
...
...
</instance>

</userconfig>