Is this really the version you are looking for? Kentico Xperience 9 Documentation is no longer updated. Use the switcher in the header to choose your product version.
This page describes how to resolve the most common errors that you may encounter when using staging.
Problems typically occur when the synchronization of staging tasks fails. To check your system for failed staging tasks and identify the type of error:
Error: "Synchronization client error: Exception occurred: The request failed with HTTP status 404: Not Found."
Not found errors occur in the following cases:
Error: "SyncServer.ServerError: Exception occurred: [SyncManager.UpdateDocument]: Parent node does not exist, please synchronize parent node first."
Occurs when attempting to synchronize a page whose parent or other ancestor page does not exist on the target server. Can also occur if the parent or ancestor page was created manually on the target server outside of the staging process (i.e. when the GUIDs of the pages do not match on both servers).
Synchronize all ancestor pages of the required page first. If your servers have inconsistent page GUIDs, you may need to delete the ancestor pages on the target server and synchronize the entire section from the source. You can use the action on the tab of the application (see ).
If possible, always avoid manual creating of pages on the target server for sections where you plan to deploy pages via staging. The correct approach is to transfer all pages via the staging service.
Errors:
"Synchronization client error: Exception occurred: Microsoft.Web.Services3.Security.SecurityFault: The security token could not be authenticated or authorized. ... The computed password digest doesn't match that of the incoming username token."
Occurs when the server password on the source instance does not match the password configured for the staging service settings on the target server.
"Synchronization client error: Exception occurred: System.Web.Services.Protocols.SoapException: Server was unable to process request. —> System.Exception: Missing X509 certificate token, please check authentication type " Occurs if the server on the source instance is configured for user name and password authentication, but the target server uses X.509 authentication.
"Synchronization client error: Exception occurred: [X509ClientOutputFilter.SecureMessage]: Unable to obtain server security token ID."
Occurs if the server on the source instance is configured for X.509 authentication and the target server does not have valid X.509 configuration.
On the source instance, open the Staging application and edit your target server on the Servers tab.
On the target instance, open the Settings application and select the Versioning & Synchronization -> Staging category.
Verify that the target server on the source instance and the Staging service settings on the target instance have matching authentication settings, including:
Error: "Synchronization client error: Exception occurred: Invalid URI: The format of the URI could not be determined."
URI format errors occur if the protocol (for example http://) is missing in the staging service URL of your target server.
Error: "Synchronization client error: Exception occurred: System.Web.Services.Protocols.SoapHeaderException: SOAP header Security was not understood."
Can occur in certain environments. This is a general error related to .NET and WSE.
Add the following to the <system.web> section in the web.config file on the target server:
<webServices>
<soapExtensionImporterTypes>
<add type="Microsoft.Web.Services3.Description.WseExtensionImporter, Microsoft.Web.Services3, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
</soapExtensionImporterTypes>
<soapServerProtocolFactory type="Microsoft.Web.Services3.WseProtocolFactory, Microsoft.Web.Services3, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
<protocols>
<add name="HttpSoap"/>
<remove name="HttpPost" />
<remove name="HttpGet" />
</protocols>
</webServices>Error: "The timeout period elapsed prior to completion of the operation or the server is not responding."
Timeouts may occur when synchronizing a very large number of staging tasks within a single operation. The default timeout interval is 180 seconds.
Either synchronize the tasks in smaller batches or increase the timeout interval. To increase the interval, add the CMSStagingServiceTimeout key to the configuration/appSettings section of the web.config file on the source server and set the value:
<add key="CMSStagingServiceTimeout" value="300" />Error: "Synchronization client error: Exception occurred: The request failed with HTTP status 413: Request Entity Too Large."
Can occur when synchronizing pages over HTTPS.
Note that it is not recommended to set the value to the maximum (2147483647) due to security reasons. Instead, determine the smallest value that the server should be allowed to read into a buffer and use that instead. The default value is 49152 bytes.
For example, the following appcmd.exe command changes the uploadReadAheadSize value to 245760 bytes.
appcmd.exe set config "Default Web Site" -section:system.webServer/serverRuntime /uploadReadAheadSize:"2147483647" /commit:apphostProblem: Bindings (relationships) between objects disappear after synchronizing changes from a different staging instance.
Such problems can occur because staging includes all child objects and bindings when synchronizing most objects.
For example: A role is not assigned to any users in the development environment, but to 100 users on the target production server. If you synchronize the role object through staging, the users are removed from the role on the target server.
Solution: Ensure that content and objects is mirrored and consistent across all staging environments.
Problem: Custom fields that store ID values (for example object selectors) point to different objects or are empty after staging.
Content staging cannot ensure that objects and pages have the same ID values after being transferred to a different environment. However, the synchronization process preserves GUID (opens in a new tab) values.
Solution: Use fields with the Unique identifier (GUID) data type if you need to safely identify pages or objects across multiple staging environments.
Problem: Objects are assigned to the wrong site after synchronization on instances with multiple sites.
Solution: Make sure that the service URLs set for target servers on your source instance contain the domain names of the correct sites. Each site's servers must use the domain name of the matching site on the target instance.
You may encounter problems when synchronizing staging tasks over a secured protocol (SSL). By default, the staging service only accepts certificates issued by a trusted certification authority.
To configure the system to accept all certificates, including self-signed, add the CMSStagingAcceptAllCertificates key to the configuration/appSettings section of your web.config file:
<add key="CMSStagingAcceptAllCertificates" value="true" />