Migrate configurations

You migrate Sitefinity CMS configurations from the database to the file system, using an ASPX page, which helps to extract the configurations. The code runs only on applications, which are configured to store configurations in the database: <sitefinityConfig storageMode="Database" />

IMPORTANT: Before executing the code, you must backup of project files and database.

Procedure

  1. Download the page from Sitefinity CMS GitHub repository
  2. Host ConfigMigration.aspx page in your application under ~/Sitefinity and integrate it in your project.
  3. Navigate to ~/Sitefinity/ConfigMigration.aspx page.
    You should be logged as administrator.
  4. Click Migrate.
    The system creates an automatic back up of your current configurations, which are stored in ~\App_Data\Sitefinity\Configuration folder, and stores it in the same folder with format _config_migration_backup + Time stamp
    All existing Sitefinity CMS configurations are extracted and saved in ~\App_Data\Sitefinity\Configuration folder.
  5. Update the web.config file by replacing 
    <sitefinityConfig storageMode="Database" />
    with
    <sitefinityConfig storageMode="FileSystem" />
  6. Recycle the application pool of the website.
  7. Validate that your site is working correctly.
    After confirming that the application functions as expected, perform the following:
    1. In the database, delete all rows from table [sf_xml_config_items]
    2. Clean up the backups created in ~\App_Data\Sitefinity\Configuration folder.

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Web Security for Sitefinity Administrators

The free standalone Web Security lesson teaches administrators how to protect your websites and Sitefinity instance from external threats. Learn to configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?