Copying mainline branches to different databases

By default, mainline branches are stored in the same RDBMS database as the Surround SCM Server database. You can convert mainline branches to copy them to a different RDBMS database. During the conversion, data is copied to the destination database and is not deleted from the current database. Depending on the mainline database size, the conversion may take a few minutes to several hours.

You must inactivate the mainline branch before converting it. See Inactivating and activating branches.

1. Choose Tools > Administration > Convert Mainline Branch.

The Mainline Destination dialog box opens.

2. Select a database Destination.

The list includes RDBMS connections configured for the server. Select the connection for the database to store the mainline branch in. See Adding RDBMS connections if you need to add an RDBMS connection.

3. Select Ignore errors during upgrade to allow processing to continue even if errors occur.

Only select this option if you have already used the analyze utility and were unable to repair issues causing errors.

4. Click OK.

The conversion information is sent to the server for validation.

  • If the validation succeeds, you are prompted to start the conversion.
  • If the validation fails, the Test Connection dialog box opens with error information. You can copy and paste the text into an email or text file and email it to your DBA for help.

5. Click Yes.

The Conversion Status dialog box opens.

If the destination database does not include any Surround SCM tables, you are prompted to create them. See Creating Surround SCM database tables.

6. Click Close when the conversion finishes.

You must activate the mainline branch before users can access it. See Inactivating and activating branches.