Log changes to the database during upgrades

Sitefinity CMS logs all database schema changes applied during the upgrade phase. For example, adding a new column to an existing table: ALTER TABLE table_name ALTER COLUMN column_name datatype

The Data Definition Language (DDL) statement for each update is recorded in the UpgradeTrace.log. The file is located in the ~\App_Data\Sitefinity\Logs folder of your project.
Together with the DDL migration statements, Sitefinity CMS stores additional information that describes the entire database schema migration process in general:

  • The complexity of the schema migration:
    • Trivial - contains schema artifacts without influencing the existing schema
    • Extending - contains schema artifacts that extend the existing schema
    • Complex - contains schema artifacts with structural changes
  • Types of the schema changes to be applied to the underlying database:
    • Adding new artifacts:
      • Adding columns on an existing tables
      • Adding foreign key constraints to existing tables
      • Adding foreign key constraints to new tables - the create table statement is included as well
      • Adding indices to existing tables
      • Adding indices definition for new tables - the create table statement is included as well
      • Adding new tables
      • Adding structures independent of existing
      • Adding primary key constraints to existing tables
      • Adding primary key constraints to new tables - the create table statement is included as well
    • Modifying existing artifacts:
      • Modifying columns of existing tables
      • Modifying existing structures
    • Removing existing artifacts:
      • Removing columns from existing tables
      • Removing foreign key constraints from existing tables
      • Removing indices from existing tables
      • Removing primary key constraints from existing tables
    • Using temporary tables to migrate data during structural table changes
EXAMPLE: Following is an example of the contents of the UpgradeTrace.log file after a complex schema migration:
EXAMPLE: Following is an example of the contents of the UpgradeTrace.log file after an extending schema migration:

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

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. 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?