• eSync Certificates - Errors, Information, and Verfication

    Description Ektron's eSync security certificates are used to ensure secured communication between servers. Here is more information for troubleshooting, generating, and verifying security certificates.  They're tied to server hardware, server hostname, and IP address. If any of these settings were to change, certificates would need to be regenerated and swapped between sync servers as necessary. Resolution How To: Completely Remove eSync Certificates Ensuring Sync Certificate Va...

  • Esync error: "No security certificates were found for synchronization."

    Description In some cases you may see the following error when creating a sync relationship. "No security certificates were found for synchronization." Below are the possible culprits and resolutions. Resolution Culprit #1: Security certificates have never been generated or were generated incorrectly. To verify check your site folder for 3 files named like '%_SyncClient%'. If these files are not present or their timestamps do not match the same files in the EktronWindowsServic...

  • eSync error: hexadecimal value 0x00

    DescriptionThe following error occurred during eSync: " '.', hexadecimal value 0x00, is an invalid character. Line 1, position 1."CauseThe ServerInfo85.xml  file at either end of the Sync-relationship is blank. ResolutionThe ServerInfo85.xml file must contain proper XML before it can be populated by the Ektron Windows Service. 1. Locate ServerInfo85.xml at each end of the Sync-relationship. The file is located in the \sync folder at the root of the drive where the CMS site is located ...

  • eSync error: Unexpected end of file while parsing Name has occurred

    Description When you try to run an eSync profile, the following error occurs just after the Synchronization initialization phase: Unexpected end of file while parsing Name has occurred. Line 50, position 9.Synchronization Was Canceled Cause When you execute an eSync profile, information from all servers in the eSync forest is read and the profile fails if there is a problem reading the data in the ServerInfo85.XML file. Resolution Enable logging in the Ektron Windows Se...

  • eSync fills hard drive space

    Description eSync fills up your c:\ drive. Cause This is caused by .tmp files being put in the c:\windows\temp drive when eSync is looking at the knowledge files for your assets, private assets, uploaded files, uploaded images, and asset library. eSync does the following:  Gets a copy of the file that should move over and puts a .tmp version in  c:\windows\temp on the sending server.   Copies that .tmp file, puts it in the receiving server's c:\windows\temp . Checks the receivi...

  • esync Invalid Scope Id

    Description When you try a sync, you may get an error like the following: Invalid scopeId 339435-xxxx-xxx-xxx-xxxxx Local Exception:Remote Exception. Cause Most likely one of the databases was restored from the other's backup. This results in both databases having the same scope ID causing the sync to fail. Resolution On both sending and receiving servers follow the backup/restore sync steps.  

  • eSync logging

    Description There are a few places and ways to gather eSync logs. Read below to learn different ways of setting up eSync logging. Resolution Ektron L2/L4 Logs These are useful for troubleshooting an EktronWindowService/Certificate issue. To find these logs: On the server, open Control Panel > All Control Panel Items > Administrative Tools > Event Viewer.   Within Event Viewer is an Application and Services Logs folder. This will take a minute to open. You should see the Ektron ...

  • eSync MessageSecurityException: An unsecured or incorrectly secured fault was received from the other party.

    DescriptionWhen performing an eSync, this error appears in the dialog. MessageSecurityException: An unsecured or incorrectly secured fault was received from the other party. It appears in the AllowInitialSync in the stack trace.CauseThis issue is due to incorrect certificates or incorrect encoded values with certificates.Resolution1. Confirm the encode values as described in eSync configuration found here. 2. If the keys are correct in step 1, it is recommended to regenerate the certs as exp...

  • eSync profile Paused and now I see an odd Schedule date

    DescriptionA paused sync shows a Schedule of "1/1/0001  12:00:00 AM."   Cause"1/1/0001 12:00:00 AM" shows sometimes when the eSync Profile has been paused. Normally, it looks like this:  ResolutionIf you paused an eSync profile and the Schedule shows "1/1/0001  12:00:00 AM", click the unpause (>) button (circled below) to the left of the delete (-) button. The Schedule date should return.   Here is an example of the returned eSync Schedule:               

  • eSync security certificates expiring 1/1/2019

    Description eSync security certificates will be expiring January 1st, 2019. This is problematic in 9.3 where SSL secured endpoints were first used with eSync. When the certificates expire in 9.3, eSync will give an Object Reference error. Versions prior to 9.3 should not be affected by this error, however if issues are encountered due to the expiring certs, see below. Resolution A new Security Configurator has been developed which creates certificates ten years into the future...

  • Esync setup error message

    DescriptionWhen setting up Esync, you receive the error "specified network password is not correct."CauseThe Application Identity Pool in IIS is not using the Network Service. Resolution Open IIS. Navigate to Application Pools. Click on the default website. Click Advanced Settings on the right side of the page. Scroll down to Process Model. Next to Identity, choose NetworkService. Click OK

  • eSync Setup Error: An uninitialized 'all folders' relationship exists for the specified database

    DescriptionThe following error can occur when creating a multisite synchronization relationship. CauseWhen creating a multisite synchronization server relationship if there are any uninitialized sync relationships this error will occur, even if one of the relationships is a previously initialized relationship with the same database as the new one being created. ResolutionDelete or initialize(i.e. initial sync) all uninitialized sync relationships.

  • eSync: Metadata Dependency Checking on Content

    DescriptionWhen you select a particular content item to synchronise, eSync determines whether the content item contains any dependencies on other items, such as images or files in the library; those images or files can be synced at the same time as the content. The dependency check also uses metadata values. For example, if there is a Content Resource Selector defined in the metadata, and it contains links to other, related, content, the dependency checker also parses those content items. Th...

  • EWS Backwards Compatibility

    DescriptionEsync allows you to use an Ektron Windows Service (EWS) version that is greater than the version of the sites on the server. There are a few version rules which should be followed.  ResolutionThe Ektron Windows Service (EWS) version should be the same version between syncing servers. This is present in the following file: C:\Program Files (x86)\Ektron\EktronWindowsService40\Ektron.ASM.EktronServices40.exe.config   For the version find the following key. = 9.1 (9.1.0.184) SP1...

  • EWS Error: Could not find a part of the path

    DescriptionIf you are seeing sync stuck at 0% during an initial sync to a min database and the Ektron Windows Service logs show the error, "Could not find part of the path", there may be an issue due to an incorrect drive path or a permission issue.CauseSync requires that the same drive of the syncing site be on the remote server.There is a updatexml method that is looking at the opposing server on the same drive letter as the local server when it creates the sync folder. So if your site on ...

  • EWS started up BUT is NOT fully functional

    Description Error: EWS started BUT is NOT fully functional appears in the Ektron L4 logs. Resolution The EWS started up BUT is NOT fully functional  error occurs because EWS cannot locate the certificates. Run  SecurityConfigurator.exe as an administrator from the following folder: 8.70 or earlier: C:\Program Files (x86)\Ektron\CMS400v8x\Utilities\SOFTWARE\SecurityConfigurator 9.00 or later: C:\Program Files (x86)\Ektron\CMS400v9x\Utilities\SecurityConfig\SecurityConfigurator ...

  • Exiting as cannot load target model Master in remote database

    Description Execution of an eSync profile fails with one of the following error messages: Exiting as cannot load target model Master in remote database. Exiting as cannot load target model Master in local database. Resolution Important! Backup the database before making any changes. Ektron 8.6.1 introduced Package Synchronization and the eSync infrastructure now handles the context changes when switching from one type of sync to another. For example, when you execute a package...

  • Folder or Content sync will not show

    DescriptionWhen you click on a folder or content sync, it appears as if nothing happens because the option to pick the database does not show. ResolutionRun the following scripts on all database's in the eSync chain.Important! Back up the databases before making any changes.delete from cmsentity_syncstatus_tbl where scheduleid in(select scheduleid from scheduler where status = 0)delete from scheduler where status = 0.If this does not resolve the issue, contact Ektron Support.

  • Generating, Troubleshooting and Verifying eSync Security Certificates

    Description Ektron's eSync security certificates are used to ensure secured communication between servers. Here is more information for troubleshooting, generating, and verifying security certificates.    Resolution Generating and Applying Security Certificates (setting up eSync > Scenario) Generating Security Certificates with Integrated Security Common sync issues Ensuring Correct Encoded Values

  • How does eSync work?

    Description Read below to learn how sync works. Resolution Below is a basic overview of how sync functions. Database sync: When sync begins, it looks through tracking tables in the local database and compares the date modified to the receiving database's tracking tables. Then, the Ektron Window Service begins to batch the database in parts to prepare it to move over. File sync: When files are moved over, such as Assets, PrivateAssets, UploadedFiles, UploadedImages, and AssetLibr...

  • How to Create a Min-Database for eSync

    Description When upgrading, migrating, or testing sites and databases with eSync, you may wish to create a min database. We also use min databases to troubleshoot sync issues in Support. Please find the steps below to create a min database for eSync purposes. These steps are extremely similar to the original min-site article. However, there are extra steps needed to set up a sync relationship to a min database.  Resolution NOTE: We highly recommend to back up any existing databa...

  • How to Delete Sync Profiles

    DescriptionFor troubleshooting reasons, it may be appropriate to delete synchronization profiles. This article explains how to do that. ResolutionIt is generally safe to delete eSync profiles. Before doing so, it may be pertinent to record the profile settings so you can recreate the profiles with the same settings. In the example below, the profiles are listed in the table. To delete a profile, click the red minus sign to its right. Note: The heading yn91sp1v2 is the name of the sync relati...

  • How to disable a file or directory in eSync.

    DescriptionThis KB article shows how to disable a file or directory in eSync. Resolution Open C:\Program Files (x86)\Ektron\EktronWindowsService40 on your Ektron server. Open Ektron.ASM.Services40.exe.config. Set the <add key="disableFileSyncProvider"> to true. Save Ektron.ASM.Services40.exe.config. Restart the Ektron Windows service. Here is the section that is added to profile creation screen:

  • How to Ensure Proper Generation of Security Certificates

    Description In some cases you will see eSync fail due to improperly generated encoded values. Resolution In some cases you will see eSync fail due to improperly generated encoded values. You can confirm if the correct encoded values were generated by the security configurator by comparing the web.config file to the Ektron Windows Service config file.  To confirm the values, do the following: In the Ektron Windows Service folder(located in \program files(x86)\Ektron\Ektron Windo...

  • How to fix a corrupt table

    DescriptionIf you have a client who's database sync starts but never completes and you have exhausted most routes to resolve the issue, typically the last resort is to run the SQL Profiler on the database while the database sync is running.This can provide valuable information on what is causing the database sync not to complete ResolutionBelow is one issue that has come up before and the steps to fix this type of issue. This particular one comes from a user_to_group_tbl syncCaptured in...

  • How to modify connection strings in an eSync relationship

    Description The quickest way to inadvertently break your eSync relationship is by altering your sending or receiving web site's connection string. Why? Because both strings are written to the database at the time the sync relationship is created. When you sync, the Ektron Windows Service grabs this information and tries to verify it. When the service finds that the new connection info does not match an existing one, sync fails. Depending on your version, you might see errors ranging fro...

  • How to prevent eSync from breaking after updating the connection string password

    DescriptionAfter updating your web.config's connection string password, eSync no longer functions properly. ResolutionThe most common error received is:  "Error reading/validating eSync license key"  You may also see  "CMS version do not match (local version:,remote version:XXX)"  where the local version is empty, and the remote version is corrrect.The Scheduler table's TriggerAction column contains the old connection string password. ServerInfo85.xml may also contain the older password...

  • How to prevent unwanted sync changes in 9.2 upgrade

    Description When upgrading to 9.2, UTC conversion is run on almost every row in the database. Since the conversion changes every row, eSync will take that into account on the next sync. If you have conflict resolution(see your sync profile) with remote set to win, this could mean that old content will never be overwritten on the destination side of the sync. New content could still sync to the destination, but any changes on the remote side prevent old content from moving. Resolut...

  • How to reduce eSync duration

    Description Here are some ways that you can reduce the duration of full syncs. Resolution Examine your sync profile and remove unnecessary items. This screenshot shows the default sync options. Database options CMSCore This is the most critical sync profile option as it syncs most of the Ektron tables. At least one of your sync profiles need to have this option.  Workflow This is very rarely used. If you are using Ektron eCommerce you may need this checked. History T...

  • How to resolve a secured fault error

    Description If the following error appears after syncing, see below for the solution.Error: An unsecured or incorrectly secured fault was received from the other party. See the inner FaultException for the fault code and detail. ResolutionCheck the time on both the sending and receiving servers, they should match. Ensure that the timezones are correct as well.