• Article

sp_vupgrade_replication (Transact-SQL)

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.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_vupgrade_replication [ [@login=] 'login' ]
    [ , [ @password= ] 'password' ]
    [ , [ @ver_old= ] 'old_version' ]
    [ , [ @force_remove= ] 'force_removal' ]
    [ , [ @security_mode= ] security_mode ]

Arguments

  • [ @login=] 'login'
    Is 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 is not required if security_mode is set to 1, which is Windows Authentication.

    Note

    This parameter is ignored when you are upgrading to SQL Server 2005 and later versions.

  • [ @password=] 'password'
    Is the system administrator password to use when creating new system objects in the Distribution database. password is sysname, with a default of '' (empty string). This parameter is not required if security_mode is set to 1, which is Windows Authentication.

    Note

    This parameter is ignored when you are upgrading to SQL SQL Server 2005 and later versions.

  • [ @ver_old=] 'old_version'
    Identified for informational purposes only. Not supported. Future compatibility is not guaranteed. 

    This stored procedure is deprecated and will be removed in a future release of SQL Server.

  • [ @force_remove=] 'force_removal'
    Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

  • [ @security_mode=] 'security_mode'
    Is the login security mode to use when creating new system objects in the Distribution database. security_mode is bit with a default value of 0. If 0, SQL Server Authentication will be used. If 1, Windows Authentication will be used.

    Note

    This parameter is ignored when you are upgrading to SQL Server 2005 and later versions.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_vupgrade_replication is used when upgrading all types of replication.

Permissions

Only members of the sysadmin fixed server role can execute sp_vupgrade_replication.