Staging allows you to easily transfer changes made to documents or objects in a Kentico instance on one server to a different instance on another server. You can also perform complete synchronization of all documents and objects. Staging is particularly useful if you need to synchronize multiple environments during development, for example:
Development -> Testing -> Editing (staging) -> Live (production)
All documents stored in the content tree of websites can be synchronized. However, not all objects in Kentico support synchronization. See the What can be synchronized section for more information.
Setting up staging
Configuring content staging - to allow synchronization, you need to configure the Kentico instances that you wish to connect.
Bi-directional content staging - explains how to configure servers to be both target and source servers at the same time. Allows transferring of changes in both directions.
Using X.509 authentication - learn how to install your own X.509 certificates or how to use our sample certificates for the X.509 type of staging service authentication.
Content staging security - learn about the permissions that roles need to perform synchronization actions.
Synchronizing the content - explains how to transfer synchronization tasks to other servers.
Automatic content synchronization - set up the system to perform synchronization automatically.
Exporting and importing sites - you can also manually transfer your content to other instances of Kentico using the export and import features.
What can be synchronized
Content staging supports synchronization of the following data:
- Document data - documents in the website content tree.
- Pages need to be on the same place in the content tree on both the source and target servers.
- Timeout defined for documents that are part of a workflow is not synchronized for consistency reasons.
- Document file attachments - if a document contains attachments or file fields, the files are synchronized together with the document.
- Document relationships - relationships between documents are synchronized if the relationship type and both documents exist on the target server. Synchronization is NOT supported for relationships between documents on different sites.
- Workflow process - only published document versions are synchronized to the target server and both servers need to have the same workflow schemas defined.
- Custom tables and their data.
- Media libraries and the files and folders in them.
- ACLs (document-level permissions)
- Global objects - all global objects except for the exceptions listed below.
Content staging does not support synchronization of the following data:
- Abuse reports
- Blog comments (blogs and blog posts are synchronized as documents)
- Booking event attendees
- Contacts (the state of contacts in automation processes is also not synchronized)
- Custom modules
- Event log
- Export history
- Form data (the actual form objects are synchronized)
- Forum posts (forum objects are synchronized)
- Message board messages (message board objects are synchronized)
- Personal messages
- Sites (the global objects holding the metadata and settings of sites in the system)
- Web templates
- Physical files associated with global objects (for example web part source file, form control files, ASPX page template files)
- Database views and stored procedures managed through the Database objects application
- Object code stored and edited in physical files via deployment mode or source control mode
- On source servers, staging tasks are generated only if you edit code in the Kentico UI or after you synchronize changes from files into the database.
- On target servers, staging tasks do not update object code if deployment or source control mode is enabled.
Staging and ID values
Content staging cannot ensure that objects and documents have the same ID values after being transferred to a different environment. However, the synchronization process preserves GUID values. Use GUID fields if you need to identify documents or objects across multiple staging environments.