Documentation Center

Exporting and importing Content Delivery information between Topology Manager instances in a scaled-out setup

If you have multiple Topology Manager instances running side by side, say, in a scaled-out or hybrid Cloud setup, you may want to transfer Content Delivery environment definitions between them. After the transfer, you can actually recreate the Content Delivery environment(s) in your target instance.

About this task

This task breaks down into the following steps:
  • Export the definitions of your Content Delivery environments (Web sites, Web applications and so on) from your source Topology Manager instance.
  • Import the definitions into your target Topology Manager instance.
  • Run a synchronization cmdlet one or more times to recreate the Content Delivery environment(s).

Procedure

  1. On the machine that contains your source Topology Manager instance, open a PowerShell prompt and run the following PowerShell cmdlet:
    Export-TtmCdStructure -CdEnvironmentIds CDENVIDS -Path PATH/TO/FILE -SecretKey ENCRYPTIONKEY
    where:
    • CDENVIDS is a comma-separated list of the IDs of the Content Delivery environment definitions you want to export
    • PATH/TO/FILE is the full path and filename of the file that will contain the exported definitions. If you omit this property, output is written to standard output.
    • ENCRYPTIONKEY is a key to use for encrypting sensitive values (must be at least 1 character long and can only contain lowercase and uppercase letters (a-z and A-Z), digits, = and /. If you omit this property, all output is in unencrypted plaintext.
  2. Move the output file produced by the command to the machine that contains your target Topology Manager instance (or to a network location that the machine can access).
  3. On the machine that contains your target Topology Manager instance, open a PowerShell prompt and run the following PowerShell cmdlet:
    Import-TtmCdStructure -Path PATH/TO/FILE -UpdateExistingItems true -SecretKey DECRYPTIONKEY
    where:
    • PATH/TO/FILE is the full path and filename of the file that contain the definitions you want to import.
    • DECRYPTIONKEY is the same key that you used during export. If you omit this property, the cmdlet interprets all input as unencrypted plaintext.

    The UpdateExistingItems property defaults to false if omitted. If set to true, any existing items are updated.

  4. Now that you have imported the definitions of your Content Delivery environment(s), you can recreate the Content Delivery environment on the source instance by running the following synchronization cmdlet for every Content Delivery environment you imported:
    Sync-TtmCdEnvironment -Id CDENVID

    where CDENVID is the identifier of an environment whose definition you imported into the target Topology Manager.