CMS 10.6 Adding Robocopy Replication Targets


Prerequisites:

CMS 10.6 provides a Robocopy replication target type that replaces the Microsoft Sync Framework. System administrators can configure Robocopy replication in publishing targets. When performing replication during publication, Ingeniux CMS copies the published files using Robocopy. For full publishes, the system will do a cleanup on the remote target.

To set up a Robocopy replication target:
  1. Expand the Robocopy replication target in the Replication tab.

    FTP/SSL Replication Target

  2. Configure the following fields:
    FieldDescription

    Name

    Name of the replication target.
    Description (optional)Description of the replication target.
    Target Location

    UNC path (e.g., \\[DSS-server]\content) or the filepath on your local drive (e.g., [Drive]:[path-to-DSS-root-folder]\content).

    If you use an invalid path, an error message displays:

    Error updating replication targets: Invalid data in Replication Target: Invalid Target Location for File Replication Target: Directory "[target-location]" doesn't exist
    Note
    The Target Location field uses the same path the systems administrator provides when installing new DSS instances.
    Command Line Options

    You can add overrides to your Robocopy replication target, such as overrides for exclusions, multithread, verbose, authentication, etc.

    Keep in mind the CMS passes the following default robocopy parameters as a part of a full or incremental publish:

    • /TBD
    • /X
    • /FP
    • /BYTES
    • /S
    • /E
    • /DCOPY:DA
    • /COPY:DAT
    • /PURGE
    • /MIR
    • /J
    • /NP
    • /MT:32
    • /R:5
    • /W:5

    After you specify Robocopy options to use for the override, the CMS will add them to the copy by force.

    You can add a default option by entering one of the following basic arguments in the Command Line Options field:

    Note
    • See Microsoft: Robocopy for details about Robocopy options listed below, along with other options.
    • If you want to remove existing default Robocopy flags, you can place a dash (-) in front of each flag to remove them.
    • The CMS logs report Robocopy flags used during the replication process.
    /s

    Type: Copy option

    Copies subdirectories and automatically excludes empty directories.

    /e

    Type: Copy option

    Copies subdirectories and automatically includes empty directories.

    /z

    Type: Copy option

    Copies files in "restart" mode. If the file copying process is interrupted while this mode is enabled, then the process continues to complete after the interruption, rather than Robocopy recopying the entire file from the beginning.

    /purge

    Type: Copy option

    Deletes target files and directories that no longer exist in the source.

    Note
    If you use /purge along with /e and a target directory, then this combination prevents the target directory security settings from being overwritten.

    /r:5

    Type: Retry option

    Specifies the total number of copy attempts Robocopy can run when files fail to copy. If Robocopy reaches the maximum total and the file still fails to copy, then the process stops attempting to copy the file.

    For /r:n, the value n is the total copy attempt number. The default value of n is one million attempts. However, you can choose any number to follow /r: for this Robocopy option. For example, if you enter /r:5, then Robocopy will attempt to copy the file five times.

    /w:5

    Type: Retry option

    Specifies how long to wait between copy attempts.

    For /w:n, the value n is the wait time in seconds. The default value of n is 30 seconds. However, you can choose any number to follow /w: for this Robocopy option. For example, if you enter /w:5, then Robocopy will wait five seconds before initiating a new copy attempt on the file after the last attempt finishes.

    /tbd

    Type: Retry option

    Specifies that the system waits for share names to be defined (retry error 67).

    /np

    Type: Logging option

    Specifies the progress of the copying operation (the number of files or directories copied so far) will not display in the logs.

    /v

    Type: Logging option

    Produces verbose output, and shows all skipped files. Verbose output provides additional information in the logs that may be useful for troubleshooting.

    /mt:n

    Type: Copy option

    Creates multi-threaded copies with n threads. The value n in /mt:n must be an integer between 1 and 128. The default value for n is 8.

    Note
    • For better performance, redirect your output using /log option.

    • The /mt parameter cannot be used with the /ipg and /efsraw parameters.

Next Steps:

Choose one of the following.

  • Click Save in the top right corner of the Manage Publishing Targets pane.
  • Add Robocopy overrides for the replication target.
  • Go to Advanced Settings to configure impersonation settings, additional locations, and custom commands for the replication target.