• How to resolve max index (server_index and share_index) errors

    DescriptioneSync requires that each database in a sync relationship have a unique ID. These server IDs are tracked in the 'server_index' value in the 'settings' table of the site's database, and are used to create unique ID ranges for content created in each environment, thus preventing collisions during eSync.  In addition, each database tracks the total number of databases involved in a specific eSync 'forest' in the 'share_index' value of the same table. An example of one of these types o...

  • How to set up web alerts with eSync

    Description Read on to learn how to set up/troubleshoot web alerts with eSync. Resolution This article assumes that web alerts have already been set up and working, and the end user is looking to set up web alerts to fire with eSync. If you have not set up web alerts, please follow this documentation. The following needs to be set up and confirmed prior to web alerts firing during a sync: On the local server <add key="ek_DisableWebAlerts" ..... /> should be set to true. On the ...

  • How to Setup Ektron Load Balancing

    DescriptionThis topic explains how to set up Ektron load balancing between servers. CauseLoad Balancing has 2 purposes:Provides redundancy for your website-if one server fails, a second can handle requestsBalances requests-distributes requests across multiple serversEktron load balancing does neither of these things. Ektron load balancing copies files between the servers setup for Ektron load balancing.  ResolutionIMPORTANT:  The physical path to the Ektron website must be the same...

  • How to toggle eSync's 'Hash' Mode

    DescriptionThis KB article shows how to enable or disable 'Hash' mode for eSync. ResolutionEdit C:\Program Files (x86)\Ektron\EktronWindowsService40\Ektron.ASM.EktronServices40.exe.config.Find the following keys:   Set the keys to enable (true) or disable (false) 'Hash' mode. NOTE: Hashing is CPU-intensive, and may not be suitable for all environments.

  • How To: Completely Remove eSync Certificates

    Description You've changed the server's host-name, re-installed the Ektron Windows Service, or just need to start fresh. Here is the process for completely removing eSync certificates. Resolution  In the Web.config, remove the hashed portion from the 'encodedValue' key. BEFORE:<add key="encodedvalue" value="3232498374987OIENNVIOEJWOIJFNIOJNIEFOJWEFJWOIE1234512" /> AFTER: <add key="encodedvalue" value="" /> In the Ektron.ASM.EktronServices40.exe.config, delete the entire encod...

  • How to: Sync templates for subsites

    DescriptionRead on below to learn how to sync templates for subsites in a multisite scenario. ResolutionLog into the parent site's workareaGo to Settings > Configuration > SynchronizationWhen you get to Step 3 of 3 Pop up, select the sub site in the site drop down.Then, run an initial sync with that new relationship.Afterwards set up a profile for Templates.

  • Impact of eSync on Web Alerts

    Description When content is published for the first time, or previously-published content is modified then published, Ektron generates a Web alert if set up correctly. But if you sync content that is scheduled to go live after the sync occurs, the Web alert will not fire after the content reaches the production server. Resolution To avoid this problem, set the go-live date after the next sync. For example, if you have a daily sync, schedule it for the next day. Web alerts do not...

  • Initial eSync not completing

    Description If you do an initial sync but the sync never completes, you may need to update the esync memory settings.  Cause eSync is not batching up changes properly. Resolution Modify the memory settings so eSync can create batches.  Open the workarea/settings/sync settings. Change the application transaction size and memory cache size to 16384. Be sure to update all profiles to 16384. for both transaction size and memory size. (Check the dropdown in the title bar --...

  • Is File Sync Stuck?

    DescriptionYou try to sync an individual file or a folder, it takes a long time to sync, and you are unsure if the remote end of the sync is updating.Cause You may have a knowledge file issue. ResolutionCheck the time stamps of the knowledge files for the remote server. To do that, navigate to the following folder path: sync (for example, C:\\sync\), the name of the remote server, the germane site, and the type of file being synced. For example, if you are synching asset files to the Ek...

  • Keyset does not exist

    DescriptionThis article explains how to resolve the following error when using eSync. "Error System.Security.Cryptography.CryptographicException: Keyset does not exist" Resolution"Error System.Security.Cryptography.CryptographicException: Keyset does not exist" when attempting to run eSync. If running the application pool under a domain user identity, and that user is not a member of any local user group on that machine,  the user will not have permission to read the certificate from the sto...

  • Last sync time showing different value than expected

    DescriptionWhen performing a manual or scheduled sync in versions earlier than 9.2 the last sync time may show a different time than what is displayed in the server's time or the local machines time.CauseIf the server leveraging the sites is running an Ektron Windows Service running on version 9.2 then the issue is likely caused by how the later version of the service handles time zones. The 9.2 version of the service will always calculate the syncs on UTC time as opposed to the server's tim...

  • License Key User Limit Considerations with eSync

    DescriptionEktron license keys can have a user limit which may be violated after a sync. If you see a user limit in your key and you suspect you are close to breaking the limit, the following may apply to you.Here is a scenario where you could see the user limit broken.You have the below license key which allows 15 CMS users.  yoursite.com(exp-2016-06-11)(PR)(S)(XML)(users-15)?16516516515131553245901581091-8You also have two sites, stagesite.com with 10 unique users and prodsite.com with 6 u...

  • Load Balancing Never Completes or Hangs

    DescriptionYou go to run a forced load balancer (Settings>Configuration>Load Balancing) between your load balanced servers and it never completes or appears to be “hanging”. We’ve also seen this happen when, after a sync from a server to a load balanced environment, LB doesn't place content in both locations, and/or seeing timeout errors in the logs. ResolutionThe first thing to do if you're running into a situation like this would be to stop and start the Ektron Windows Service for al...

  • Load Balancing times out reaching load balancing peers

    Description This article explains how to resolve errors relating to load balancing timing out or being unavailable. Sometimes, when you get such an error, you can load balance shortly afterwards. Resolution To resolve this problem, increase the time that the load balancer waits to see if the server is available to load balance. To do this: Go to the C:\Program Files (x86)\Ektron\EktronWindowsService40 folder. Open the Ektron.ASM.EktronServices40.exe.config file Change the time ...

  • Load Balancing: The Static File Handler

    Description Occasionally, due to server loading and priorities, a file being propagated by Ektron Load Balancing may not reach all target servers before a request for the file is received. In this case, you may encounter a 404 page. The Static File Handler addresses this situation. Resolution When you enable Static File Handling, a server that receives a request for a non-existent file will query other load-balanced servers for the file, then send it to the client. The assumption ...

  • Long sync time after upgrading to 9.2

    Description After upgrading to 9.2 you may find that the first full database sync is taking much longer than expected. Resolution This is normal and is a result of UTC conversion. In 9.2 UTC conversion was added to convert all dates to UTC time. By running UTC conversion you are modifying almost every row in the database. When a row is modified, eSync needs to read and compare it with the equivalent row on the sync destination. All of these reads and comparisons explain the lo...

  • New content will not sync while old content can be updated

    DescriptionIn some cases individual or folder syncs will not carry over new content in a synchronization, but updates to old content does sync. CauseThis can arise when there is too large a discrepancy between individual content/folder sync knowledge and full sync(the sync used in workarea>settings>synchronization>profiles) knowledge. Sync knowledge is the record of previous syncs and the two types of syncs knowledge need to match otherwise you can start to see issues with new content s...

  • No CMS Sites found during sync server relationship creation

    DescriptionWhen attempting to create a sync relationship to another server you encounter the following error:No viable CMS sites were found on the remote server specified. Please check the remote server and try again. Possible causes include:The remote server could not be foundThere are no CMS site(s) installed on the remote server.The Ektron Windows Services 4.0 is not running on the remote server.The local and remote server's clocks are not synchronized. ResolutionTo begin troubleshoo...

  • No Site Details Found during sync

    Description A previously working sync is now saying "No site details found the site..." while performing a sync. The below steps can also be used for some troubleshooting by support, so these steps may be requested even if the exact error message listed is not being thrown. Cause 'Site Details Not Found' is typically due to the remote site having a modified connectionstrings value compared to what is in the sync relationship information within the database. Resolution E...

  • Package Sync Showing Only 50 Folders; More Button Missing

    DescriptionThe package sync UI in version 9.00 SP2 shows a maximum of 50 content folders and the more button is not present. ResolutionUpgrade to 9.00 SP3 or the latest version of the CMS.Downloads and Install Instructions

  • Permissions required for sync

    DescriptionWhat permissions are needed for sync to function properly? ResolutionThe Ektron Window Service requires the ability to read, write, and edit files as it's performing its operations. For a standard sync set up, the Application Pool is set to have an identity of 'Network Service'. Meanwhile, the Ektron Window Service 4.0 service is using 'Local System'. Both 'Network Service' and 'System' full permissions should be applied to the 'Ektron' folder and site root folder for the sit...

  • Preparing for eSync failures

    Description Once setup and if not changed sync usually runs without issues but occasionally failures will still happen due to a network problem, database issue, configuration problem or in some cases a product issue. To prepare for this possibility, please see below. Resolution In many cases esync generates an error in the L4 or windows application event logs. It's possible to setup event viewer so you receive an email notification regarding the failure. This can reduce the ti...

  • PublicKeyToken = ' ' is not marked as serializable.

    DescriptionWhile running a sync, the error, PublicKeyToken = ' ' is not marked as serializable, is received.CauseCorrupted/invalid eSync certificates, or server clocks are not within 5 minutes of each other (or not in the same time zone). ResolutionTo resolve the error: Regenerate certificates and swap Create eSync certificates from scratch. Check server clocks and time zones to ensure accuracy

  • Purpose of Tracking Tables

    Description With eSync setup you will see tracking tables generated for almost every table in your site's database. This KB explains the purpose of them.  Resolution The purpose of tracking tables is to track actions taken on content for the purposes of eSync. The tracking data allows eSync to make decisions about whether to move, delete, or update content. Tracking tables can be identified by looking for '_tracking' appended to the a table name. For example, content_tracking. T...

  • Reducing size of Ektron Windows Service folder

    Description In some cases, the Ektron Windows Service 40 folder can grow quite large. Below are the folders you can remove files from. Removing these files has the added benefit of reducing upgrade time, since an upgrade backs up the EWS folder. Resolution The following folders can have their content removed. To be safe, back up the folders to another location. Stop the Ektron Windows Service before doing this, then start it again once complete.  C:\Program Files (x86)\Ektron\Ek...

  • Removing eSync security certificates

    Description In some cases before you create new certificates you should remove the old ones. Steps 1 - 4 show how to delete remote certs and steps 5 onward show how to remove and regenerate the local certificates. Removing, regenerating, and copying certificates between servers is often necessary after upgrades or server moves. For regenerating and copying certificates, please see the following documentation.  Synchronizing Servers Using eSync > Managing eSync Security Certificates > Re...

  • Row size can not fit within the specified batch size

    Description When trying to Sync, you may come across an error in the profiler trace logs that resembles the following: ERROR  , Ektron.ASM.EktronServices40, 23, 10/10/2017 10:19:32:647, Caught exception while getting changes: Microsoft.Synchronization.Data.DbSyncException: Cannot enumerate changes at the RelationalSyncProvider for table 'content'.  Check the inner exception for any store-specific errors. ---> Microsoft.Synchronization.Data.DbSyncException: The row of size 81876KB from t...

  • ServerInfo85.xml related esync errors: root element is missing

    Description Esync errors out with Root Element is missing You may also see the following errors. System.IO.IOException: The device is not ready. System.NullReferenceException: Object reference not set to an instance of an object. Cause The most common cause of this issue is that the hard drive partition has run out of hard drive space.  This causes the serverinfo.xml or serverinfo85.xml file to end up blank as there is no more hard drive space to save updates to either file. If ...

  • Setting Up Integrated Security with eSync

    DescriptionIn some cases you may want to implement integrated security with eSync for security concerns. Here are the steps to do that.  Resolution1) Set integrated security from 0 to 1 in the file Ektron.ASM.EktronServices40.exe.config (located in program files(x86)/Ektron/Ektron Windows Service 40). 2) Do the same for the web.config.3) Run the following utility as an administrator:C:\Program Files (x86)\Ektron\CMS400v91\Utilities\SecurityConfig\SecurityConfiguratorIntegrated\SecurityC...

  • Setting up SQL Profiler to troubleshoot eSync

    Description If sync is running longer than expected or it is not syncing the expected items it can sometimes be helpful to create a SQL Profiler trace to show what queries are executing. Resolution SQL Profiler Trace Setup Steps Open SQL profiler (tools > SQL Profiler from SQL Management Studio). Click File then New Trace.  Enter the SQL Server of the receiving database(if necessary you can also setup on the sending side) and click connect. On the next screen give the trace a...