Moving server configurations to a new server

This topic describes the steps in migrating a server configuration.

 

Preparing for the migration

To prepare for migrating a server configuration:

  1. Shut down the server configuration.
  2. Create a database backup.
  3. Verify the location of the files that you need to move. These file are:
    • The database backup.
    • starteam-server-configs.xml.
    • The repository including its Native-II archives if they are not located under the repository folder.

Back to top

Migrating the server configuration

To migrate a server configuration migration:

  1. Copy the files from the source to the target location.
  2. Open starteam-server-configs-xml in a text editor.
  3. Copy the entire entry for the source server configuration into the target starteam-server-configs-xml file.

    Note: If starteam-server-configs-xml does not exist on the target machine, then you can copy the entire file and delete any entries from it for any server configurations that do not exist on the target machine. However, if this file does exist on the target machine, then take care to copy only the section needed for the server configuration that you are moving to the target machine.

  4. Open the starteam-server-configs-xml file.

  5. Type the correct values in the RepositoryPath and LogPath options for your migrated server configuration so that it points to the new migrated locations for the specified server configuration. For example, you would update the following values for these options:

    • <option name="RepositoryPath" value="C:\Program Files\Micro Focus\StarTeam Server <version>\QA Team Repository\" />
    • <option name="LogPath" value="C:\Program Files\Micro Focus\StarTeam Server <version>\QA Team Repository\" />
    6. To prepare for migrating a server configuration: To prepare for migrating a server configuration:

Back to top

Completing the server configuration

To complete a server configuration migration:

  1. Restore the database from backup.
  2. Configure the database for the migrated server configuration.

  3. Start the migrated server configuration. Depending on whether you have other server configurations running on the same machine, you may need to start the migrated server configuration on a different port. If you need to do this, do one of the following:

    • Click the Start with Override toolbar button; or
    • Choose Actions > Start With Override from the main menu.

Back to top