DSS Content Location Best Practices, How to Move DSS Content to a New Location.
Version: CMS 8, 8.x
February 24, 2014
Last updated: 1/30/2021
To explain Dynamic Site Server (DSS) setup Best Practices.
To explain the configuration changes and steps necessary to move existing DSS content to a new location.
Administrator access to CMS.
Administrator access to the server where DSS is or will be installed.
I. Rationale and best practices
Beginning with CMS 8, a new publishing model became available and certain considerations must be taken into consideration due to ASP.NET 4.0 file change monitoring, which can cause an unscheduled application pool recycle in your envirnoment. As a result, we recommend separating DSS content from the DSS application files. Before running the Dynamic Server Setup, we recommend the creation of two sibling folders. Under our standard model, we create a folder structure such as the following:
Ensure that the file permissions allow full control for the following user accounts:
- Network Service
What is most important is to keep the DSS application files and the DSS content separated. When running the Dynamic Site Server Setup Wizard, you may now reference the newly-created folders.
II. Instructions for moving DSS content to another location; or to move DSS content out of the DSS site root
These steps should only be performed during a maintenance period, as stopping the Application Pool is a requirement. Note that DSSPreview is not the same as the DSS server, and it is not necessary to move its content out of the CMS root.
- From within IIS, stop the DSS application pool for the site in question.
- On the filesystem, create a sibling folder within the DSS site, eg. "Content"; alternatively, it may be placed in a location of choice.
- Ensure that the IUSR and Network Service user accounts have full access to the folder and its children.
- Move all DSS content to the newly-created folder.
- Open the web.config file within the DSS site root and update the PageFilesLocation value to reflect the new location.
- From within IIS, navigate under DSS site to the "prebuilt" virtual directory and select it.
- Click "Basic settings" in the right pane of IIS and update the "Physical path" to reflect the location created in step 2.
- Open CMS and update the replication target to point to the new location.
- Start the application pool for the DSS site.
- Perform a replication.