Upgrading legacy labels

When you upgrade from Surround SCM 2008 and earlier, labels are not automatically applied to files and must be manually upgraded before they can be used.

Labels created in earlier Surround SCM versions were applied to the file version in all branches. Now, you can create labels for a mainline branch or a specific branch. Upgrading legacy labels allows you to choose the existing labels to import and the branches to apply them to.

The timestamp and comments from existing labels are copied to the label history during the upgrade.

1. In the Surround SCM Client, select the mainline branch that includes the legacy labels to upgrade and choose Tools > Administration > Upgrade Legacy Labels.

2. Select the label you want to upgrade and click Upgrade. To select multiple labels, Ctrl+click each label.

3. Select the branch to apply the label to in the Upgrade Legacy Labels dialog box and click OK. To include snapshot branches in the branch list, select Show snapshot branches. To select multiple branches, Ctrl+click each branch.

If you select a branch that did not previously include any files with the label applied, the label is not applied to any files.

The File count field displays the total number of files the label can be applied to. Compare this number to the File Count column for each branch to determine the branches to apply the label to. Typically, you will apply the label to the branch with the highest file count because it is a good indicator of the branch the label is intended for. You may also apply the label to other branches depending on how it is used. File count information not displayed if you are upgrading multiple labels.