Razl Log Files: What is in the Log?

May 01, 2019 | Kliment Klimentov

When moving content from one environment to another, you need to ensure that every item is successfully copied. If there's a problem, you need to be aware of it. Razl logs all the steps it completes and returns an error when there's an issue with the synchronization. The logs come in handy when you are looking for data from past operations or looking for additional information as to why an operation failed. 

If you haven't used the logging capabilities of Razl, or you don't know where the log files are saved, this is configured in Razl's settings button: 

Snapshot of Razl Setting Button

If you're executing scripts, another way of saving logs is to pipe the output of the console to a text file and save the log there. 

Razl logs everything in its log files. If all works properly, you'll only see INFO entries in the log files. Most of the information entries are self-explanatory.  

Here are some examples:  

INFO  Razl Starting 

INFO  Settings saved 

INFO  Connected to sitecore:  Name: <connection name>, Url: <Url of the Sitecore instance>, Path: <path to the webroot>, Package: False 

INFO  Connection: <connection name> - Added 

INFO  CopyItem Started Id: <item id>, Path: <path in the Sitecore tree>, From: <connection name>, To: <connection name> 

INFO  CopyItem Finish Id: <item id>, Path: <path in the Sitecore tree>, From: <connection name>, To: <connection name> 

INFO  Starting Razl Script Mode 

INFO  Read XML connection <connection name> 

INFO  Read XML command 'CopyItem' 

INFO  Installed connector for connection <connection name> 

INFO  Starting Razl Script Mode Finished 

In case of an error, Razl will stop the process, and an error message will pop-up. Usually, the errors are logged with much more detail there.  

Below are some common errors seen when supporting Razl: 

CallService Protocol Exceptions and CallService Exceptions 

These exceptions are followed by a long stack trace in the log files, which can usually point you to the problem. The exception indicates that Sitecore threw an error when Razl tried to use the service. If a web page HTML follows the error, or the stack trace mentions any error codes, you should review the Sitecore logs, the IIS logs, and the Windows Event logs for additional information.  

Console error: Cannot find source parent 

Razl throws this error if there's an invalid item ID in the script or a corrupted item in the Sitecore tree. Again, you'll probably find additional information in the Sitecore logs, or you'll notice a problem when browsing this item.  

An error occurred when checking for a license @ <date and time>. The error message is: The activation was rejected by the server. 

Razl also logs information for problems occurring when communicating with the license server or the license key. If you see the above error, there's probably another installation of Razl using the same license key, or there's a problem with the key itself. In this case, please contact the Hedgehog support team.

The connector test failed. The reason is 'Can't install connector. The web root can't be found.' 

This error appears when the webroot location is not specified in the Razl connection settings. This can be fixed by opening the connection manager and entering the proper location for the connection you're trying to use. 

Learn more about the features of Razl 4.0 including the new Connection Manager window.  

Razl Razl 4.0

Related Blog Posts

Razl new Sitecore Connection Manager
<div>Introduced with the 4.0 version release of Razl is the new Sitecore connection manager feature offering an improved user experience.&nbsp;</div>
Hedgehog Announces Release of Razl 4.0
<div>Hedgehog, a digital consultancy engineering high - performance, multi-channel solutions, announced the release of a new version of Razl, a part of the Team Development for Sitecore Essential Collection.</div>
RAZL Best Practices: Lightning Mode and Deep Compare
From scheduling Razl scripts to sync changes between Production and QA environments to keeping logs from scheduled Razl scripts, our team has a few tips and tricks to make the Razl experience even better.
TDS for SC Hackathon 2016
For all those participating in the Sitecore Hackathon, check out our Habitat for TDS and some other cool surprises.