Copy databases to the new farm for upgrade to SharePoint Server Subscription Edition

APPLIES TO: 2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

When you upgrade from SharePoint Server 2019 or SharePoint Server 2016 to SharePoint Server Subscription Edition, you must use a database-attach upgrade, which means that you upgrade only the content for your environment and not the configuration settings. After you have configured a new SharePoint Server Subscription Edition environment, you can copy the content and service application databases from the SharePoint Server 2019 or SharePoint Server 2016 environments to the SharePoint Server Subscription Edition environment. You use a backup and restore process to copy the database, and you can also choose to set the databases to read-only in the SharePoint Server 2019 or SharePoint Server 2016 environments so that users can continue to access their information, but not change it. This article contains the steps that you take to copy the databases.

Phase 2 of the upgrade process: Copy databases to the new farm

Phases

Description

This is the second phase in the process to upgrade SharePoint Server 2019 or SharePoint Server 2016 data and sites to SharePoint Server Subscription Edition. The process includes the following phases that must be completed in order: Create the SharePoint Server Subscription Edition farm for a database attach upgrade Copy databases to the new farm for upgrade to SharePoint Server Subscription Edition (this phase) Upgrade service applications to SharePoint Server Subscription Edition Upgrade content databases to SharePoint Server Subscription Edition. For an overview of the whole process, see Overview of the upgrade process to SharePoint Server Subscription Edition.

Before you begin

Before you copy the databases, review the following information and take any recommended actions.

• Ensure that the account that you use to copy the databases has access to SQL Server Management Studio on the SharePoint Server 2019 and SharePoint Server 2016 as well as SharePoint Server Subscription Edition environments and has access to a network location that can be accessed from all the environments to store the copies of the databases.

• Ensure that the account that you use to set the databases to read-only and read-write is a member of the db_owner fixed database role for the content databases that you want to upgrade.

• Before you back up the databases, check for and repair all database consistency errors.

Set the earlier version databases to be read-only

To maintain user access to your original environment, set the SharePoint Server 2019 and SharePoint Server 2016 databases to read-only before you back up the databases. Even if you don't want to maintain access over the long term, set the databases to read-only to make sure that you capture all the data in the backup so that you restore and upgrade the current state of the environment without allowing additional changes to be made. If the databases are set to read-only, users can continue to view content. However, they will be unable to add or change content.

To set a database to read-only by using SQL Server tools

1. Verify that the user account that is performing this procedure is a member of the db_owner fixed database role for the databases.

2. In SQL Server Management Studio, in Object Explorer, connect to an instance of the Database Engine, expand the server, and then expand Databases.

3. Find the database that you want to configure to be read-only, right-click the database, and then click Properties.

4. In the Database Properties dialog, in the Select a page section, click Options.

5. In the details pane, under Other options, in the State section, next to Database Read-Only, click the arrow, and then select True.

You can use Transact-SQL to configure the READ_ONLY database availability option. For more information about how to use the SET clause of the ALTER DATABASE statement, see Setting Database Options.

Back up the SharePoint Server 2019 or SharePoint Server 2016 databases by using SQL Server tools

You back up the databases in SQL Server Management Studio. A backup copy of the database guarantees that you have the data in a safe state if you must enable the original farm again and is required for a database-attach upgrade. Repeat the procedure for the following databases in the SharePoint Server 2019 or SharePoint Server 2016 server farms:

• All content databases (default database name: WSS_Content_ ID

• The following service application databases:

You do not have to back up the configuration or admin content databases, because you recreated these databases when you set up the SharePoint Server Subscription Edition server farm. Upgrading the configuration or admin content databases and the Central Administration site collection is not supported.

After you complete this procedure, you will have created backups of the read-only content databases.

To back up a database by using SQL Server tools

1. Verify that the user account that is performing this procedure is a member of the db_owner fixed database role for the databases.

2. In Management Studio, in Object Explorer, connect to an instance of the Database Engine, expand the server, and then expand Databases.

3. Right-click the database that you want to back up, point to Tasks, and then click Back Up.

   The Back Up Database dialog appears.

4. In the Source area, in the Database box, verify the database name.

5. In the Backup type box, select Full.

6. Under Backup component, select Database.

7. In the Backup set area, in the Name box, either accept the backup set name that is suggested or type a different name for the backup set.

8. In the Destination area, specify the type of backup destination by selecting Disk or Tape, and then specify a destination. To create a different destination, click Add.

9. Click OK to start the backup process.

Repeat the previous procedure to back up all the content and appropriate service application databases that SharePoint Server Subscription Edition uses in your environment.

Copy the backup files to the SharePoint Server Subscription Edition environment

Copy the backup files that you created in the previous procedure from the SharePoint Server 2019 or SharePoint Server 2016 environments to the SharePoint Server Subscription Edition environment.

Restore a backup copy of the database

After you configure the new SharePoint Server Subscription Edition server farm, you can restore the backup copies of the databases to SQL Server. Start with one database, and then verify that the restoration has worked before you restore the other databases.

To restore a backup copy of a database by using SQL Server tools

1. Verify that the user account that is performing this procedure is a member of the db_owner fixed database role for the databases.

2. After you connect to the appropriate instance of the SQL Server 2014 Database Engine, in Object Explorer, expand the server name.

3. Right-click Databases, and then click Restore Database.

   The Restore Database dialog appears.

4. In the Restore Database dialog, on the General page, type the name of the database to be restored in the To database list.

   Tip

   When you type the name for the restored database, you do not have to use the original name. If you want to change the database name from a name with a long GUID to a shorter, friendlier name, this is an opportunity to make that change. Be sure to also change the database and log file names in the file system (the MDF and LDF files) so that they match.

5. In the To a point in time text box, keep the default (Most recent possible).

6. To specify the source and location of the backup sets to restore, click From device, and then use the ellipsis ( ...) to select the backup file.

7. In the Specify Backup dialog, in the Backup media box, be sure that File is selected.

8. In the Backup location area, click Add.

9. In the Locate Backup File dialog, select the file that you want to restore, click OK, and then, in the Specify Backup dialog, click OK.

10. In the Restore Database dialog, under Select the backup sets to restore grid, select the Restore check box next to the most recent full backup.

11. In the Restore Database dialog, on the Options page, under Restore options, select the Overwrite the existing database check box.

12. Click OK to start the restore process.

Set the databases to read-write

You cannot upgrade a database that is set to read-only. You must set the databases back to read-write on your SharePoint Server Subscription Edition farm before you attach and upgrade them.

To set a database to read-write by using SQL Server tools

1. In SQL Server Management Studio, in Object Explorer, connect to an instance of the Database Engine, expand the server, and then expand Databases.

2. Select the database that you want to configure to be read-write, right-click the database, and then click Properties.

3. In the Database Properties dialog, in the Select a page section, click Options.

4. In the details pane, under Other options, in the State section, next to Database Read-Only, click the arrow, and then select False.

Phases	Description
	This is the second phase in the process to upgrade SharePoint Server 2019 and SharePoint Server 2016 data and sites to SharePoint Server Subscription Edition. Next phase: Upgrade service applications to SharePoint Server Subscription Edition For an overview of the whole process, see Overview of the upgrade process to SharePoint Server Subscription Edition.

See also

Concepts

Create the SharePoint Server Subscription Edition farm for a database attach upgrade

Upgrade service applications to SharePoint Server Subscription Edition

Upgrade content databases to SharePoint Server Subscription Edition