Auto-storage mode of configurations
Overview
Auto-storage mode is the default and recommended configuration storage option. It is a hybrid mode that stores configuration files on both the file system and the database (in table [sf_xml_config_items])
.
- Environment configurations that are part of the system setup are stored in the file system.
They are part of the deployment process of the web application and you distribute them as files between different environments.
Such configurations are the Advanced settings of Sitefinity CMS.
- Application settings that are part of the Sitefinity CMS website and are modified runtime are stored in the database.
Turn on Auto-storage mode of configurations
When Sitefinity CMS uses FileSystem storage mode, you can switch to Auto-storage mode.
IMPORTANT: Once you switch to Auto-storage mode, you cannot switch back to any different configuration storage option.
To turn on Auto-storage mode of configurations, perform the following:
- Open you
web.config
file.
- Make the following transformations:
- Save and close the
web.config
and restart the application.
From this point on, the configuration files will be stored on both the file system and the database. In Auto-storage mode, the system makes the best decision where to store the configurations depending on the context.
When the system is in Auto-storage mode, you can restrict the modification of the file system configurations. For more information, see Read-only mode of configurations.
IMPORTANT: You must not remove existing configuration files from the project's ~/App_Data/Sitefinity/Configuration folder, because Sitefinity CMS continues to use them to read the default values. Only new changes are written to the database.
Explicitly save configurations on the file system in Auto mode
When the system is in Auto-storage mode, if you want to save a configuration intentionally on the file system, you can use one of the following methods:
- The
FileSystemModeRegion
in the following way:
- The
SaveSection
overload method: