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 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.

After legacy labels are upgraded, you can manage them the same way as other labels. See Labels.

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

1. Select the mainline branch that includes the legacy labels.

2. Choose Tools > Administration > Upgrade Legacy Labels.

The Legacy Labels dialog box opens and displays the legacy labels for the selected mainline branch.

3. Select the labels to upgrade. To select multiple labels, Ctrl+click each label.

4. Click Upgrade.

The Upgrade Legacy Labels dialog box opens. The branches the label can be applied to are displayed.

5. Enter a Label description.

This field is not available if you are upgrading multiple labels.

6. Select Show snapshot branches to include snapshot branches in the branch list.

7. Select the branch to apply the label to. 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.

8. Click OK.

The label is upgraded and you return to the Legacy Labels dialog box.

You can also delete legacy labels. See Deleting legacy labels.