Documentation Center

Exporting and importingContent Delivery information between Topology Manager instances in a DTAP setup

In a DTAP setup, you can export the definitions of your Content Delivery environments (Web sites, Web applications and so on) from the Topology Manager in your Production instance to the one in, say, your Development instance.

About this task

To export and import this information, you run an export, and then modify the export file in such a way that the Topology (the logical organization of your publishing infrastructure) is preserved, but the host names, port numbers and URLs are adapted for the instance into which you are importing. After you have imported the definitions, you can run a synchronization cmdlet one or more times to actually recreate the Content Delivery environment(s) in your target instance.

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. Open the output file, which is in the JSON format, for editing in a plain-text editor.
  4. Find all instances of the following properties, and change their values to match the target instance into which you are importing the file:
    DiscoveryEndpointUrl

    Set the value to the Discovery Service endpoint URL of the Content Deliveryenvironment you associate with the Purpose found in the sibling EnvironmentPurpose property.

    BaseUrls

    Set the value to one or more base URLs of the Web site you associate with the Content Deliveryenvironment identified by the sibling CdEnvironmentId property.

  5. If your target instance does not have the same Content Delivery environments as your Production instance (say it has no Content Delivery environment for the Live purpose, only for the Staging purpose), remove all JSON items associated with that purpose.
  6. 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.

  7. 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.