What are the steps to move a StarTeam 2006 Server to a new machine?



What are the steps to move a StarTeam 2006 Server to a new machine?


  • Product Name: Starteam
  • Product Version: 2006
  • Product Component: N/A
  • Platform/OS Version: Windows-specific, but can be used with any supported OS

The StarTeam server configuration is comprised of three things:

  • The starteam-server-configs.xml file.
  • The entire repository.
  • A supporting database, Oracle, SQL, or MSDE.

To move a StarTeam 2006 server from one physical system to another follow the process below.

1. Install StarTeam 2006 on the target system. You can download the latest version of StarTeam 2006 from the following link:

2. Copy the entire repository and starteam-server-configs.xml to the target system. If the database is also being moved and will be run on the same physical system copy the database backup to the target system as well. An easy way to determine the repository path is to highlight the server configuration and click on Configure Server in the Administration pane. Look on the General tab for "Attachments path:". The repository will, by default, be in the parent folder of the one listed there.

3. Rename the starteam-server-configs.xml in the new StarTeam 2006 server installation and replace it with the starteam-server-configs.xml from the source system. To verify if this step was followed correctly the name of the server configuration that appeared in the Server Administration on the source system should now appear in the Server Administration menu on the target system. To find Server Administration on the same physical system where the StarTeam server is installed click "Start"->"Programs"->"Borland StarTeam"->"StarTeam Server 2006"-> "StarTeam Server". This will open a window titled "Server Administration".

Edit the starteam-server-configs.xml file in it"s new location using notepad so that the line that reads "Repository Path" lines and "LogPath" reflect their new locations on the target server. To make the move easier, it is suggested and recommended that when moving the repository, you place it in the same exact folder tree location on the new system that it resided under on the source system. That way you will not need to make any changes to the XML file.

4. Restore the database if necessary. This process will vary depending on database type, for SQL server there is a create backup/restore backup process, for Oracle EXP/IMP, and for MSDE the MSDE Admin Tool will need to be used.

Please note: The MSDE Admin Tool can be installed from the StarTeam Server 2006 installation package. When installing select Custom installation, the admin tool is one of the options. By default it is not installed.

5. Within Server Administration on the target system highlight the server configuration and click menu item "Server" --> "Configuration Properties". Verify that the log file path has been changed to reflect your edit to the starteam-server-configs.xml file. Select the Database Connection Information tab and use the ODBC database name to create a new ODBC connection. This process will differ again depending on database type, for SQL or MSDE create a system DSN specifying the target database.
For Oracle a new ODBC driver will need to be installed as described in Chapter 8 of the StarTeam 2006 Installation Guide: "Using Oracle Schema Users with Borland StarTeam Server". Regardless of the database type specified click "Verify" when the process is completed to confirm that the ODBC configuration has been created successfully. Click "OK" to close. It is highly recommended that you create the ODBC to be identical to the one that was in place on the source system. That way you will not need to edit the XML file.

6. From within Server Administration, highlight the server configuration and verify that the "Execution mode" is set to "Application". To do this click on menu item Actions, and check to see if Run as Service is unchecked. If not, click "Run as Service one time and the service will be removed from Windows Services.

7. Start with overrride - With the StarTeam server configuration still highlighted click "Start with Override", either on the toolbar or using the menu (Actions --> Start with Override...". There will be fields for the TCP/IP protocol endpoint and attachments path. The default endpoint is 49201, and the attachments folder is stored within the repository. You can use any TCP/IP endpoint that you have available. StarTeam will NOT start if there is a conflict with this port.

Note: If the Starteam server starts successfully verify that client connections allow files to be checked out. If the StarTeam server fails to start there should be an error onscreen and an entry in the server.en-us.log. Any mention of the Event Viewer can be safely disregarded.

8. After the server starts correctly, you can add it to Windows Services. Shutdown the server Configuration, click the pruple Run as Service icon on the toolbar, enter the log on information, and then start the server. It will start as a service the next time the system is restarted using the TCP/IP endpoint you entered in the ocerride step.

Author: Donnie Nix

Old KB# 27675
Comment List