Installation Guide | 2019.2

Preparing to upgrade from TestTrack 2011.1 and earlier

You cannot use or upgrade older database versions in Helix ALM 2017.1 and later or TestTrack 2016 - 2016.1. To upgrade the TestTrack Server 2011.1 or earlier, you must upgrade databases to TestTrack 2015.1 first. Contact Perforce Support for help with these upgrades.

Note:  TestTrack was renamed Helix ALM starting with the 2017.1 release.

Review the following steps required for this part of the upgrade process. The steps you follow depend on the database type.

If you use: And you want to: Perform these steps to upgrade databases
Native databases Continue using native databases 1. Review information about upgrading native databases to SQLite format.2. Install 32-bit TestTrack 2015.1.3. Start the Seapine License Server and TestTrack Server. The TestTrack Server database is automatically upgraded when the server starts.4. Use the TestTrack Server Admin Utility to upgrade legacy native projects to SQLite.Make sure to upgrade all projects you may want to use later, including archived or inactive projects, so they can be upgraded for use in Helix ALM.5. If you use external custom reports, configure them to use a SQLite ODBC driver.
Convert databases to a different RDBMS 1. Create an empty RDBMS server database.2. Install 32-bit TestTrack 2015.1.3. Start the Seapine License Server and TestTrack Server. The TestTrack Server database is automatically upgraded when the server starts.4. Use the TestTrack Server Admin Utility to convert the server database and legacy native projects to RDBMS. Make sure to upgrade all projects you may want to use later, including archived or inactive projects, so they can be upgraded for use in Helix ALM.
RDBMS databases (Oracle, PostgreSQL, or SQL Server) Continue using the same RDBMS 1. Install TestTrack 2015.1 (32-bit or 64-bit).2. Start the Seapine License Server and TestTrack Server. The TestTrack Server database is automatically upgraded when the server starts.3. Use the TestTrack Server Admin Utility to upgrade legacy RDBMS projects (version 11.0tt or earlier). Make sure to upgrade all projects you may want to use later, including archived or inactive projects, so they can be upgraded for use in Helix ALM.
Convert databases to native SQLite or a different RDBMS 1. Create an empty RDBMS server database. Not required for SQLite.2. Install TestTrack 2015.1 (32-bit or 64-bit).3. Start the Seapine License Server and TestTrack Server. The TestTrack Server database is automatically upgraded when the server starts.4. Use the TestTrack Server Admin Utility to convert the server database and legacy RDBMS projects (version 11.0tt or earlier) to Helix ALM Native or another RDBMS format. Make sure to upgrade all projects you may want to use later, including archived or inactive projects, so they can be upgraded for use in Helix ALM.