Migrating from StarTeam 2008 Server for Windows to StarTeam 14.0 Server for Linux

StarTeam Server 2008 and 2008 R2 for Microsoft Windows support both Oracle and Microsoft SQL Server relational database management systems (RDBMS's), while StarTeam Server 14.0 for Linux supports only Oracle. For more details about supported database platforms, see System Requirements and Prerequisites.

Important: The following steps assume that the original Microsoft Windows StarTeam configuration you are migrating uses an Oracle database. If you are migrating a StarTeam 2008/2008R2 for Microsoft Windows configuration that uses Microsoft SQL Server, you must first migrate it to Oracle using the steps specified in the Migrating Server Configurations to Other Databases topic of the StarTeam Server 2008/2008 R2 for Windows Help. After you successfully migrate your StarTeam Server for Microsoft Windows configuration to an Oracle database, you can proceed with the following Microsoft Windows to Linux migration steps.
  1. Back up the current Oracle database (schema used for storing StarTeam Server 2008/2008 R2 for Microsoft Windows metadata).

    Save this backup copy. Do not recycle it

  2. Install the Oracle client on the Linux machine. Verify that the supported Oracle client versions for this release are installed.
  3. Create a StarTeam user account on the Linux machine.
  4. Establish Oracle connectivity between the Linux machine and the Oracle database currently used for storing StarTeam metadata.
  5. Verify the database connectivity using SQL*Plus.
  6. Install StarTeam Server 14.0 for Linux on the Linux machine.
  7. Copy the Microsoft Windows configuration file and hive index files fromStarTeam Server14.0 to the StarTeam Server for Linux repository folder.
  8. Copy the vault, including the attachments (if running Microsoft Windows 2009 R2) from the Microsoft Windows Server to the Linux Server.
  9. Open the Server Tools, and click Help > About > License to verify that the Server is licensed correctly.
  10. Select the configuration, and click Server > Configuration from the menu.
  11. Set the correct log file path in the starteam-server-configs.xml file.
  12. Select the Database Connection Information tab, and click Verify Connection to verify the database connectivity.
  13. Click Tools > Administration > Hive Manager from the Server Administration tool to update the hives.

    If there are multiple hives, ensure that all of them are set correctly.

  14. Click Help > About > Info from the Server Administration tool to verify that the destination build number is greater than or equal to the source build on Microsoft Windows. If the destination build number is greater than the source build number, choose Actions > Upgrade. This step upgrades the source database to the destination's build. Upgrade is not required when the source and destination builds are identical.
  15. Verify that the upgrade log that gets created in the log file path directory is error free.
  16. Back up the current Oracle database. Save this backup copy. Do not recycle it.
  17. Verify that the server log that gets created in the log file path directory is clean.
Parent topic: StarTeam Server for Linux Installation