Johan Björnfot
Mar 24, 2011
(1 votes)

Mirror other than content

By default mirroring handles content (and resources used by content such as linked files or PageObjects). I have heard some feedback that it would be nice if mirroring handled other things as well, in that specific case the question was regarding including page types. We might add page types and other things to mirroring “out of the box”, but for now it is possible to write a module that extends mirroring with that. In this post I will present a simple module that will include page types, dynamic property definitions, categories and tab definitions to the mirroring process.

NOTE: To be able to mirror page types you must uncheck “Enable validation” on the mirroring channel configuration. Otherwise the mirroring job will fail with a validation error if page types differ. The mirroring will handle creation of new page types and properties on page types but it will not handle deletion of page types or properties.

It is also possible to mirror other types of data. Data stored in DDS can be mirrored by simply adding the Identity of the objects to mirror to the EPiServer.Enterprise.DynamicDataTransferHandler. It is also possible to write an own import/export handler that gives you an exclusive stream to handle custom data. See my related post here regarding export of custom data and DDS data.

Access rights can be mirrored by combining this module with a prior module I wrote. There are however some settings/data that are not handled by this module (or the prior module), like Users, Groups, Enabled languages, workflow definitions etc. Some of them can probably be mirrored by writing a custom module but for example users is tricky since the passwords are hashed and thereby not readable.

One use case for mirroring is backup/failover. If you mirror your whole site then you will always have a running backup which also uses another database meaning that even if the “original” database for some reason goes down you could switch traffic to the mirrored site.

This code goes with standard “works on my machine” so any use of it is of own risk and unsupported. The module should be deployed to the bin folder of the Mirroring service on the source side.

    public class MirrorAdditionalContentModule : IInitializableModule
        //Mirroring service executes each job in own AppDomain so 
        //we dont have to worry about several jobs executing in parallell.
        private bool _exportedData = false;

        public void Initialize(InitializationEngine context)
            MirroringEvents.SourceStartingJob +=
                delegate(object source, MirroringSourceInitializeEventArgs args)
                     DataExporter.Exporting +=
                        new EventHandler(DataExporter_Exporting);

        void DataExporter_Exporting(object sender, EventArgs e)
            //There might be several packages in one job, 
            //send "extra" data only in first package
            DataExporter exporter = sender as DataExporter;
            if (!_exportedData && exporter.TransferType == 
                _exportedData = true;
                //Unfortunately there is no easy way to keep track 
                //of changes on pagetypes, dynamic properties etc.
                //Therefore we always send all and let destination service merge.
                foreach (int catId in CategoryList.LoadCategories())

        public void Preload(string[] parameters) { }

        public void Uninitialize(InitializationEngine context)
Mar 24, 2011


Apr 13, 2011 09:31 AM


This is just what I am looking for, but I can't get it to build.
I can't find the correct includes for 'MirroringEvents', and 'MirroringSourceInitializeEventArgs'
Are you able to let me know what I need to get it building please? (I don't get the option to hover over the items to add the appropriate reference/include)

Danny Jun 15, 2011 06:56 PM

Look in your webservice's bin folder. There are binaries for it there.

Joshua Folkerts
Joshua Folkerts Jun 15, 2011 06:57 PM

you can find them in
1. bin -> EPiServer.Enterprise
2. root->MirroringService->EPiServer.MirroringService

Oct 27, 2011 02:42 PM

Regarding mirroring users, it is much easier to just use one database for users in a mirrored environment (supported with SQL membership), than mirror them.

Please login to comment.
Latest blogs
Vulnerability in EPiServer.GoogleAnalytics v3 and v4

Introduction A potential security vulnerability was detected for Optimizely Google Analytics addon (including EPiServer.GoogleAnalytics and...

Bien Nguyen | Sep 20, 2023

Overriding Optimizely’s Content Recommendations Block to Implement Custom Recommendations

Introduction The Content Recommendations add-on for Optimizely CMS dynamically recommends content from your site tailored to the interests of each...

abritt | Sep 13, 2023 | Syndicated blog

Developer contest! Install the AI Assistant and Win Bose QC45 Headphones!

We are thrilled to announce a developer contest where you have the chance to win a pair of Bose Headphones. The goal is to be the first developer t...

Luc Gosso (MVP) | Sep 7, 2023 | Syndicated blog

Send Optimizely notifications with SendGrid API, not SMTP

If your Optimizely site already sends transaction emails through an email platform API, why not do the same with Optimizely notification emails?

Stefan Holm Olsen | Sep 6, 2023 | Syndicated blog

Optimizely Configured Commerce Custom POST API

Introduction When creating custom API controllers for an Optimizely B2B project it’s possible you’ll want to create POST calls. Following the...

Dylan Barter | Sep 6, 2023

Using Google’s structured data to improve your SEO in Optimizely's B2B Configured Commerce

Introduction Following proper markup standards for search engine optimization is imperative for the success of every website. While Optimizely B2B’...

Dylan Barter | Sep 6, 2023