Upgrading to VisualSVN Server 4.0 in a multisite environment

Note
Please, read the latest version of the article if you are upgrading to VisualSVN Server 5.4: KB234: Upgrading to VisualSVN Server 5.4 in a multisite environment.

This article describes specific upgrade procedures that have to be followed when upgrading to VisualSVN Server 4.0 in a multisite environment. Note that the upgrade procedure is different depending on your current VisualSVN Server version.

Upgrading from VisualSVN Server versions 3.9 and later

If you are upgrading from VisualSVN Server 3.9 and later versions, you do not need to follow any specific upgrade procedure. Server instances can be upgraded one by one in any order, regardless of replication topology. The upgrade will not cause interruption of the replication between multisite repositories.

Upgrading from VisualSVN Server versions 3.8 and earlier

For VisualSVN Server 3.8 and earlier versions, the complexity of the upgrade procedure depends on the replication topology of your distributed repositories. VisualSVN Server allows you to have two types of replication topology: star topology or peer-to-peer topology. You have a star replication topology if all of your master VDFS repositories are hosted on the same instance of VisualSVN Server (which is located in your headquarters, for example). You have a peer-to-peer replication topology if master and slave VDFS repositories are mixed on some of your VisualSVN Server instances.

The upgrade procedures described below ensure that the upgrade will cause none or minimal interruption of the replication between multisite repositories. You can upgrade your replication servers in any order if you don’t care about the replication interruption. Your repositories are safe even if you upgrade your servers in an arbitrary order.

How to determine which replication topology is being used

You can determine which replication topology is being used by looking through your servers and examining whether slave and master VDFS repositories are mixed on some of your VisualSVN Server instances or not.

Perform the following steps for each of your VisualSVN Server instances:

  1. Connect to VisualSVN Server using VisualSVN Server Manager.
  2. On the left pane of VisualSVN Server Manager, select the Repositories node. All the repositories will be listed in the right pane.
  3. Examine the Type column for each of the listed repositories:
    1. You have the peer-to-peer replication topology if VDFS (master) and VDFS (slave) repositories are mixed on some of your VisualSVN Server instances.
    2. You have the star replication topology if VDFS (master) and VDFS (slave) repositories on any of your VisualSVN Server instances do never mix.

Upgrading to VisualSVN Server 4.0 in a star replication topology

You have a star replication topology if all of your master VDFS repositories are hosted on the same instance of VisualSVN Server. For example, it is a star topology if all master VDFS repositories are hosted on the server in Berlin and all slave VDFS repositories are hosted on the servers in New York and Rome.

The upgrade procedure for the star replication topology is the following:

  1. Upgrade the server that hosts all the master VDFS repositories to VisualSVN Server 4.0. Replication will not be interrupted because the master-side of the new VDFS protocol is backward compatible with the old version.
  2. Upgrade all other VisualSVN Server instances to version 4.0 one by one.

Upgrading to VisualSVN Server 4.0 in a peer-to-peer replication topology

You have a peer-to-peer replication topology if master and slave VDFS repositories are mixed on some of your VisualSVN Server instances. For example, it is a peer-to-peer topology if the server in Berlin hosts master VDFS repositories for projects mostly developed by German teams and the slave repositories for projects mostly developed by teams in other countries.

Note

The upgrade procedure for a peer-to-peer replication topology is not applicable if you are upgrading from versions older than 3.3. This means that if you are upgrading from VisualSVN Server 3.2.x or older, the replication will be partially interrupted until all of your servers are upgraded.

As a workaround you can perform an interim upgrade to VisualSVN Server 3.4 and then upgrade to VisualSVN Server 4.0.

The upgrade procedure for the peer-to-peer replication topology is the following:

  1. Add the following registry value on all your servers where VisualSVN Server is installed (assuming that you currently have VisualSVN Server 3.8.x installed):
    1. for a 32-bit operating system:
      [HKEY_LOCAL_MACHINE\SOFTWARE\VisualSVN\VisualSVN Server]
      "VdfsProtocolVersion"="3.8"
      
    2. for a 64-bit operating system:
      [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\VisualSVN\VisualSVN Server]
      "VdfsProtocolVersion"="3.8"
      
    Tip
    The specific VdfsProtocolVersion registry value depends on the particular version of VisualSVN Server you are upgrading from:
    • specify "VdfsProtocolVersion"="3.8" if you are upgrading from VisualSVN Server 3.8.x, 3.7.x, 3.6.x or 3.5.x (there were no VDFS protocol changes in these versions),
    • specify "VdfsProtocolVersion"="3.4" if you are upgrading from VisualSVN Server 3.4.x or 3.3.x (there were no VDFS protocol changes between versions 3.3.x and 3.4.x),
    • VDFS protocol versions "3.0" and "3.2" are not supported in VisualSVN Server 3.5 and later.
  2. Upgrade all your VisualSVN Server instances to version 4.0 one by one. You can upgrade your instances of VisualSVN Server in an arbitrary order because VDFS was configured to use a previous version of the protocol.
  3. After that, remove the VdfsProtocolVersion registry value on all of your servers one by one and restart VisualSVN Server services using the corresponding command in VisualSVN Server Manager.

The described upgrade procedures guarantee that replication will not be interrupted even if you have a lot of VisualSVN Server instances around the world.

See also

KB149: Upgrading to VisualSVN Server 4.0
Last Modified: