Overview

Sitecore Razl is used to compare two Sitecore databases side by side, highlighting missing or outdated features. With Razl, it is possible to find missing items and move an entire database or a single item.

Prerequisites

• A valid Razl license. It can be obtained here.
• A local SitecoreAI project based on the StarterKit template (if connecting to locally-hosted SitecoreAI instances).

Adding Razl support

To add Razl support to the SitecoreAI environment:

1. Download the Sitecore Razl desktop application package. Unzip and install the application.
2. Run the Razl Desktop application and register the application.
3. Follow the steps to create a connection using a package:
   • Connecting Razl to cloud-hosted SitecoreAI instances
     1. For the Server URL, enter the URL of the CM.
     2. Click Pick Package Location to open a dialogue to save the Sitecore package to disk. Download and unzip the package.
     3. Move the /files/_CMP directory from the package to the authoring/platform/ directory of the SitecoreAI project
     4. Move the /files/bin/HedgehogDevelopment.Razl.Service.dll files to the authoring/platform directory of the SitecoreAI project.
        Note: Do not put this file inside authoring/platform/bin
     5. Add the following nodes to the .csproj file:

        <ItemGroup>
            <Content Include="_CMP\RazlService.asmx" />
            <Content Include="_CMP\web.config" />
          </ItemGroup>
          <ItemGroup>  
            <Reference Include="HedgehogDevelopment.Razl.Service">     
            <HintPath>HedgehogDevelopment.Razl.Service.dll</HintPath> 
            <Private>True</Private>   
            </Reference> 
          </ItemGroup>

     6. Add, commit, push the changes, and restart the CM environment.
     7. After the deployment, test the connection on Razl.
   • Connecting Razl to locally-hosted SitecoreAI instances
     1. For the Server URL, enter the URL of the local SitecoreAI instance.
     2. Click Pick Package Location to open a dialogue to save the Sitecore package to disk. Download and unzip the package.
     3. Copy the _CMP and bin folders from the Sitecore Package’s files folder and add them to the SitecoreAI project repository, in the authoring/platform folder of the local SitecoreAI repository.
        
        Note: Do not copy the _CMP and bin folders that are found in the properties folder.
     4. In the authoring\platform\Platform.csproj file, in the node containing the App_Config includes, add the following nodes:
        

        <Content Include="bin\HedgehogDevelopment.Razl.Service.dll" />
        <Content Include="_CMP\RazlService.asmx" />
        <Content Include="_CMP\web.config" />

        For example:
        
     5. Open authoring/XmCloudAuthoring.sln in Visual Studio, and perform publish.
        
     6. After publish, continue with the remaining steps defined in create a connection using a package:
         
        Note: If multiple developers are connecting to the same server, make sure the Access GUID is the same for all developers found in the web.config file from _CMP folder that has been added before.