Advanced Replication Settings

You can apply Advanced Settings to replication targets to minimize network address translation (NAT) and firewall wall issues, exclude or include files for replication, configure custom commands, and more.

Advanced settings among replication target types vary. Review the advanced settings relevant to your replication type.

Version Notes: CMS 10.6 vs. CMS 10.0–10.5

For CMS 10.6: Access Advanced Settings by selecting the Advanced tab.
For 10.0–10.5: Select the Advanced Settings area to expand the settings.

Important

After configuring replication settings, always save your changes by clicking Save in the top-right corner of the Manage Publishing Targets pane.

Additional Locations

All replication targets have Additional Locations settings. Additional locations identify folders to be replicated from outside the pub target folder. The folders exist outside the standard CMS directory structure and are only a supplement to replication.

For instance, if the site stores media files outside the standard media folder, administrators may want to include the external media folder as an additional location.

These settings apply to the following replication types:

Click the Add a New Additional Location plus (+) button to add an entry to Additional Locations.

Add Additional Location

Settings include:

Field	Description
Source Location	Enter the hard drive path or UNC path. Important This location must exist before you enter it here. The CMS doesn't generate the path.
Target Location	Enter the absolute path to the folder where the additional files will replicate. Keep in mind that the CMS replicates the source location into the target location. The CMS also excludes the folder, which corresponds to the target location in the publishing target, from replication. Example For example, if the source location is c:\media and the target location is /media/, the CMS doesn't replicate media from the publishing target. The CMS replicates c:\media into a new target location called media. No file merging occurs in the process.

Field

Description

Source Location

Enter the hard drive path or UNC path.

Important

This location must exist before you enter it here. The CMS doesn't generate the path.

Target Location

Enter the absolute path to the folder where the additional files will replicate.

Keep in mind that the CMS replicates the source location into the target location. The CMS also excludes the folder, which corresponds to the target location in the publishing target, from replication.

Example

For example, if the source location is c:\media and the target location is /media/, the CMS doesn't replicate media from the publishing target. The CMS replicates c:\media into a new target location called media. No file merging occurs in the process.

Cleanup Exclusions

All replication targets have Cleanup Exclusions settings. During full publishes, replication cleanup deletes all content from the replication target before replicating published content. Cleanup exclusions identify items to exclude from deletion. Commonly excluded files include Web.config and favicon.ico.

Important

Normally, these excluded items exist outside the publishing target folder. Replication overwrites all content, which includes items omitted from cleanup, in the publishing target folder.

These settings apply to the following replication types:

Click the Add a New Cleanup Exclusion plus (+) button to add an entry to Cleanup Exclusions.

Add Cleanup Exclusion

Complete the following fields for the new cleanup exclusion entry:

Field	Description
Location to Exclude	Provide the path to the location to exclude from cleanup. Note Provide only the relative folder path, starting and ending with a forward slash (/).
Exclude all files in this location from cleaning up checkbox	If selected, the replication excludes all content from replication cleanup in the specified location. If cleared, the replication excludes only defined search patterns or descendents or descendants in the chosen location from cleanup. Use the following settings to define the search patterns or descendants excluded from cleanup: Exclude files search patterns This setting excludes items that fit the search patterns from replication cleanup (i.e., cleanup won't delete the items). You can use wildcards to create search patterns. For example, k. excludes any file starting with the letter k. Note Use the pipe (\|) delimiter to separate values. Exclusion covers descendant directories checkbox If selected, this setting excludes all subfolders of the folder specified in the Location to Exclude field from replication cleanup. Warning If cleared, cleanup deletes all descendant folders.

Field

Description

Location to Exclude

Provide the path to the location to exclude from cleanup.

Note

Provide only the relative folder path, starting and ending with a forward slash (/).

Exclude all files in this location from cleaning up checkbox

If selected, the replication excludes all content from replication cleanup in the specified location.

If cleared, the replication excludes only defined search patterns or descendents or descendants in the chosen location from cleanup.

Use the following settings to define the search patterns or descendants excluded from cleanup:

Exclude files search patterns: This setting excludes items that fit the search patterns from replication cleanup (i.e., cleanup won't delete the items).
You can use wildcards to create search patterns. For example, k*.* excludes any file starting with the letter k.
Note
Use the pipe (|) delimiter to separate values.
Exclusion covers descendant directories checkbox: If selected, this setting excludes all subfolders of the folder specified in the Location to Exclude field from replication cleanup.
Warning
If cleared, cleanup deletes all descendant folders.

Custom Commands

All replication targets have Custom Command settings. System administrators can use custom commands to customize the replication process. For example, you can use a custom command to send an email pertaining to the replication process.

Custom commands can use any file type executable under Windows Shell (for example, .exe). In most cases, custom commands point to batch files. Enabling this setting opens additional configuration options.

These settings apply to the following replication types:

Version Notes: CMS 10.6

Only CMS 10.6 provides custom commands for Amazon AWS S3 and Azure Storage.

Requirements

In standard CMS installations, the application pool runs under the Network Service account on the CMS server.

This common scenario includes the following requirements:

You may want to write a batch script. Store this script in a new folder called scripts within [Drive]:\igxsites folder.
For example: C:\igxsites\scripts\myscript.bat
Executables and scripts configured to run as before- or after-replication commands require access to the Network Service account.

When the scripts folder has access rights to the Network Service account, the system can call scripts from the CMS site. If needed, you can configure the script file to allow a different user account to run commands.

Test Script

Use the following scenario information as a general outline for creating test scripts to run as pre- or post-replication commands. You can run this test script in your CMS.

To create a test script, you can copy and paste the following code in a new file within a text editor:

REM This is a simple test batch file, which just updates a *.txt file with current timestamp. for /F "tokens=2" %%i in ('date /t') do set mydate=%%i set mytime=%time%
REM Appends datetime to designated file path. File location needs to grant rights to NETWORK SERVICE account. ECHO This script executed at %mydate%:%mytime% >> [Drive]:\[path-to]\ReplicationCommands.txt exit

Important

In the script, change the [Drive]:\[path-to] placeholder to an actual absolute path on your server to store the sample .txt file.

Name the test script test.bat, and save the file to your scripts folder within [Drive]:\igxsites.

After the getting the test script in place, set configure the Custom Commands in your replication target's Advanced Settings.

Fields

Select the Use Custom Commands checkbox to enable customization for the replication target.

Add Cleanup Exclusion

Tip

Keep the following in mind when working with the test script:

If you want to experiment with your test script, enter the absolute path to the script (e.g., C:\igxsites\scripts\test.bat) in one of the Custom Command fields.
After completing configuration, you can run a full publish with replication to test the custom command. If you run a full publish, ensure that ReplicationCommands.txt contains current date and time values in the Publishing Monitor logs to verify that the script executed properly.

Settings include:

Field	Description
Custom command to execute before replication	Filepath to the custom command (i.e., script/executable file) that executes prior to performing replication. Important This field only accepts the filepath and does not support passing parameters at this time.
Timeout (before)	Time to wait (in seconds) prior to the before-replication command times out. Some replication tasks take a while. If no response initiates after this specified timeout period, the command process terminates.
Custom command to execute after replication	Filepath to the custom command (i.e., script/executable file) that executes post performing replication. Important This field only accepts the filepath and does not support passing parameters at this time.
Timeout (after)	Time to wait (in seconds) prior to the after-replication command times out. Some replication tasks take a while. If no response initiates after this specified timeout period, the command process terminates.

Exempt Locations

All replication targets have Exempt Locations settings. Exempt Locations identify folders excluded from replicating to the deployment location. Use these settings to exclude files by folders and file extensions.

These settings apply to the following replication types:

Click the Add a New Exempt Location plus (+) button to add an entry to Exempt Locations.

Configure Exempt Location

Complete the following fields for the new cleanup exclusion entry:

Field	Description
Exempt Location	Provide the path to the exempt location.
Exempt All Files in this Location checkbox	If selected, the replication excludes all content in the exempt location. If cleared, the replication excludes defined extensions or descendants in the exempt location. Use the following settings to define the excluded extensions or descendants: Exempt Search Patterns This setting excludes files containing the given string pattern(s). By entering wildcards and file extensions, you can exclude specific file types. For example, entering .wmv excludes all Windows Media Video files from replication in the exempt location. You can also exclude partial matches. For instance, p.pdf excludes all PDF files starting with the letter p. Note Use the pipe (\|) delimiter to separate values. Exemption Covers Descendant Directories checkbox If selected, the setting applies the exclusion pattern to all subfolders of the folder specified in the Exempt Location field.

Field

Description

Exempt Location

Provide the path to the exempt location.

Exempt All Files in this Location checkbox

If selected, the replication excludes all content in the exempt location. If cleared, the replication excludes defined extensions or descendants in the exempt location.

Use the following settings to define the excluded extensions or descendants:

Exempt Search Patterns

This setting excludes files containing the given string pattern(s). By entering wildcards and file extensions, you can exclude specific file types. For example, entering *.wmv excludes all Windows Media Video files from replication in the exempt location.

You can also exclude partial matches. For instance, p*.pdf excludes all PDF files starting with the letter p.

Note

Use the pipe (|) delimiter to separate values.

Exemption Covers Descendant Directories checkbox

If selected, the setting applies the exclusion pattern to all subfolders of the folder specified in the Exempt Location field.

Exempt Locations

FTP Options

You can use FTP options to minimize NAT device and firewall issues and compress data during transfers.

These settings apply to the following replication types:

✓ FTP
✓ FTP/SSL
✓ SSH FTP

Settings include:

Field	Description
Passive Mode	Only applicable to FTP and FTP/SSL. If selected, enables a passive FTP connection. You can use the passive connection to avoid issues with NAT devices and firewalls, if the FTP server employs these technologies.
Compressed Transfer	If selected, enables on-the-fly data stream compression. Data is then decompressed on the FTP server. Warning Compressed transfer can cause bottleneck. Use this option with caution. Turning on compressed transfer can speed up file transfer in some cases. For example, some text and image files may transfer faster. However, for .jpg, .zip, and large video files, the process won't be noticeably faster.

Field

Description

Passive Mode

Only applicable to FTP and FTP/SSL.

If selected, enables a passive FTP connection. You can use the passive connection to avoid issues with NAT devices and firewalls, if the FTP server employs these technologies.

Compressed Transfer

If selected, enables on-the-fly data stream compression. Data is then decompressed on the FTP server.

Warning

Compressed transfer can cause bottleneck. Use this option with caution.

Turning on compressed transfer can speed up file transfer in some cases. For example, some text and image files may transfer faster. However, for .jpg, .zip, and large video files, the process won't be noticeably faster.

FTP Options

Impersonation Settings

You can use Impersonation Settings to connect to the universal naming convention (UNC) path with a different user account.

Important

Replicating files to a different server requires administrators to configure a user account with access to the server.

These settings apply to the following replication types:

✓ File Replication

Settings include:

Field	Description
Connecting User	The user with access to the UNC path.
User Domain	The domain name (e.g., "Ingeniux").
Password	The user's password (encrypted).

Impersonation Settings

SMB Settings

Version Notes: CMS 10.6

SMB settings are exclusive to CMS 10.6.

You can use Server Message Block (SMB) protocol settings to enable UseWriteThrough functionality for SMB file replication. In some scenarios and environments, enabling UseWriteThrough can increase replication reliability. However, keep in mind this functionality also lowers replication performance.

These settings apply to the following replication types:

✓ File Replication

Select the Use Writethrough for SMB Replication checkbox to enable UseWriteThrough functionality.