Upgrading Perforce ALM

We recommend performing a full upgrade of all client and server applications, and other components for all major and maintenance Perforce ALM releases. Upgrades update executables and drivers, but do not affect existing data files. If you need upgrade help, contact Perforce Support.

You may want to install the new ALM version in a test environment before upgrading your production environment to evaluate new features, estimate downtime required to upgrade, and make sure no issues occur during the upgrade. See Installing Upgrades in a Test Environment.

Preparing for the upgrade

1. Review the release notes for information about new features, enhancements, bug fixes, and important upgrade information.

2. Check the system requirements to make sure computers you are installing ALM components on have the required space, memory, and other resources to run efficiently.

3. If you are upgrading from TestTrack 2011.1 or earlier, review additional steps required to prepare databases for upgrading.

4. Download the installer for the current ALM version.

Performing the upgrade

The time it takes to upgrade depends on the components you are installing and your data.

If you are upgrading both Perforce ALM and Surround SCM, upgrade the product with the most recent release date last to guarantee you install the latest version of the Perforce ALM License Server.

1. Stop the Perforce ALM License Server and Perforce ALM Server.

2. Back up your license server database and Perforce ALM databases and projects.

3. Run the ALM installer. You may be prompted to overwrite existing files, such as SOAP or HTML files. Always overwrite these files to ensure that ALM works correctly after the upgrade.

4. Start the license server and ALM Server applications. The server databases are automatically upgraded when the servers start.

5. Upgrade projects if needed. ALM can automatically upgrade projects when the server starts or you can manually upgrade them. See Upgrading projects.

After upgrading

  • If users cannot log in after upgrading, make sure a license is assigned to the user and that maintenance for the license is not expired. See Users Cannot Log In After Upgrading.

  • If you upgraded from Helix ALM to Perforce ALM on Windows, instances of Helix ALM in executable names changed to Perforce ALM. Any shortcuts to Helix ALM executables, such as in the Start menu or on the taskbar, will no longer work. You need to create new shortcuts to the Perforce ALM executables. To learn more, see the Windows documentation.