| title | sp_vupgrade_replication (Transact-SQL) | ||
|---|---|---|---|
| description | Activated by setup when upgrading a replication server. | ||
| author | markingmyname | ||
| ms.author | maghan | ||
| ms.reviewer | randolphwest | ||
| ms.date | 06/23/2025 | ||
| ms.service | sql | ||
| ms.subservice | replication | ||
| ms.topic | reference | ||
| f1_keywords |
|
||
| helpviewer_keywords |
|
||
| dev_langs |
|
[!INCLUDE SQL Server SQL MI]
Activated by setup when upgrading a replication server. Upgrades schema and system data as needed to support replication at the current product level. Creates new replication system objects in system and user databases. This stored procedure is executed at the machine where the replication upgrade is to occur.
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions
sp_vupgrade_replication
[ [ @login = ] N'login' ]
[ , [ @password = ] N'password' ]
[ , [ @ver_old = ] ver_old ]
[ , [ @force_remove = ] force_remove ]
[ , [ @security_mode = ] security_mode ]
[ , [ @db_id = ] db_id ]
[ ; ]
The system administrator login to use when creating new system objects in the Distribution database. @login is sysname, with a default of NULL. This parameter isn't required if @security_mode is set to 1, which is Windows Authentication.
Note
This parameter is ignored when you're upgrading to [!INCLUDE ssVersion2005] and later versions.
The system administrator password to use when creating new system objects in the Distribution database. @password is sysname, with a default of an empty string. This parameter isn't required if @security_mode is set to 1, which is Windows Authentication.
Note
This parameter is ignored when you're upgrading to [!INCLUDE ssVersion2005] and later versions.
[!INCLUDE ssInternalOnly]
This stored procedure is deprecated and will be removed in a future release of [!INCLUDE ssNoVersion].
[!INCLUDE ssInternalOnly]
The login security mode to use when creating new system objects in the Distribution database. @security_mode is bit, with a default of 1. If 0, [!INCLUDE ssNoVersion] Authentication is used. If 1, Windows Authentication is used.
Note
This parameter is ignored when you're upgrading to [!INCLUDE ssVersion2005] and later versions.
[!INCLUDE ssInternalOnly]
0 (success) or 1 (failure).
sp_vupgrade_replication is used when upgrading all types of replication.
Only members of the sysadmin fixed server role can execute sp_vupgrade_replication.