Shahram Shahinzadeh
Apr 26, 2010
(0 votes)

Mirroring and Monitoring Configurations


This document describes configuration settings around mirroring, monitoring and Mirroring Transfer Provider (MTP).

Mirroring Configuration on CMS

Parameters felt on Mirroring Settings

Parameter's felt is used to pass settings to a custom MTP (Mirroring Transfer Provider).
By default the mirroring server uses EPiServer MTP (EPiServer.MirroringService.MirroringTransferProtocol.WCF.MirroringTransferClient) as a transfer provider.
You can use your own custom implementation of the MTP provider if you add transferprovider=youcstomprovidername and added it in the mirroring web config file, the mirroring server uses this provider to communicate and delivers export packages. 

There is another parameter configuration in the parameter that can be used which is TransferAction. The TransferAction by default is None, but you can change it to ForceCurrentVersion. It means that the same page will be updated on the target site for a new version, by other words there is only one version.

Use default URI and URI on Mirroring Settings

If you select Use default URI option then you have to define a transfer address in the mirroring config file otherwise you have to define an Uri address in mirroring settings.

Continue on error on Mirroring Settings

If the Continue on error option is selected then the Mirroring Server continues to do mirroring even if it is an error on the importing site. When mirroring server starts it sends existing packages. If you do reset channel everything starts from the beginning and existing packages would be deleted in the next mirroring.
If the Continue on error option is NOT selected then the mirroring server interrupts to processing of mirroring as soon as it gets an error, it does not matter if the error is on the export or import side. The Mirroring server always refuses to continue doing mirroring if the error is on export side becuase it is not able to generate export packages.

Configuration on Mirroring Server web config

By default the Mirroring Server uses EPiServer MTP (EPiServer.MirroringService.MirroringTransferProtocol.WCF.MirroringTransferClient type) and it has configuration settings which are worth to mention them.

destinationConnectionStringName = “ConnectionStringName” you can decide which connection string name should be use on the target side if there are more than one.
defaultEndpointName = “endpoint of WCF”.
chunkSize = “number of bytes” with this attribute you can choose how many bytes you will send from client to server (between mirroring source server and mirroring target server). Each export packages be divided to subpackages with size of the chuncksize.
The username and password uses to authentication on the target side if the validateUser attribute sets to true (by default it is true).
The numberOfFilesInPackage and numberOfPagesInPackage defines the number of pages/Files in export package.
The sourcePath and destinationPath defines path of packages on the source and target mirroring side.

Configure same mirroring service to handle many sites

If you will use same mirroring server for multiple sites you can do it by adding mirroringSites element under episervermirroring element.

   1: <episerverMirroring>
   3:   <mirroringSites>
   4:     <add siteId= "siteId1" connectionStringName=“ConnnectionName_1“/>
   5:     <add siteId= ”siteId2” connectionStringName=“ConnectionName_2“/>
   6:   </mirroringSites>
   7: </episerverMirroring>
ConnectionName_1 and ConnectionName_2 should be added to connectionStrings element.


Offline Monitoring Log

If you like to log all state changing in the mirroring server you can do it by setting offlineLoggingEnabled to true and you can choose your custom path also via offlineLogPath attribute.

   1: <mirroringMonitoting offlineLoggingEnabled=”true” offlineLogPath=”Path to offline Log Path”>
Apr 26, 2010


Please login to comment.
Latest blogs
Optimizely SendGrid SMTP host is deprecated

SendGrid is a services for sending email that is included in Optimizely DXP. Previously was the recommended SMTP server to use,...

Tomas Hensrud Gulla | Dec 4, 2022 | Syndicated blog

Hosting Optimizely CMS 12 on Docker Engine

Since Optimizely CMS can now be deployed as a Docker container, here is a demonstration of building, running and scaling an Optimizely CMS 12 site ...

Stefan Holm Olsen | Dec 4, 2022 | Syndicated blog

How to use CacheTagHelper with content areas in Optimizely CMS 12

I might be going out on a limb here - if you have a better solution, feel very free to share it!  Upgrading your Optimizely web application from .N...

Andreas J | Dec 2, 2022

The 1001st Piece in your 1000 Piece Puzzle: .NET Default Interface Functions

I was recently working with a client who wanted a reasonably large subsystem added to Optimizely that would add automated management to their...

Greg J | Nov 28, 2022 | Syndicated blog

Video Demonstration, creating a CMS12 Alloy Sample Site

Hey All Below you will find a quick video demonstration on how to install a local version of Alloy Sample based on CMS12 / .Net 6. As you will see ...

Minesh Shah (Netcel) | Nov 28, 2022

Opticon Deep Dive: Optimizely's Product Announcements

We attended Opticon 2022 in San Diego which explored the future of orchestration, experimentation, and growth. We dive into Optimizely's product...

Liz Spranzani | Nov 28, 2022 | Syndicated blog