Requirements for an Upgrade

This section describes the steps that you follow to upgrade to the latest version of StarTeam Server, elaborating on the table provided in Overview of the Upgrade Process and providing references to related sections for more detailed information.

Before upgrading to the latest version of StarTeam Server, you need to:

Review the pre-installation issues for a new installation to determine whether any of them apply to you.
You can upgrade to the latest version of StarTeam Server only from StarTeam Server 2009 R2+. If you are on an earlier release, take the steps necessary to upgrade from that release to StarTeam Server 2009 R2. See the appropriate installation guides for details. Be sure to also install the latest patches. You can find information about the latest patches at http://supportline.microfocus.com.
Back up your StarTeam repositories and other server files. See the documentation for the release of StarTeam Server that you currently have installed for information about what to back up.
You cannot install StarTeam Server while server configurations are running. Therefore, you must perform one of the following procedures.
To shut down a StarTeam Server configuration that is not running as a Microsoft Windows service:
1. Open the Server Administration tool, by selecting Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server. The Server Administration tool opens.
2. Select the server configuration, and choose Actions > Shut Down Server. After you confirm that you want to shut down the server, the Status icon changes from Running to Stopping to Ready.
If your StarTeam Server configurations run as Microsoft Windows services, you must stop those services and change the StarTeam execution mode:
1. Click Start > Settings > Control Panel > Administrative Tools > Services. The Services window opens.
2. Locate the Server configuration and click Stop.
3. After the service stops, close the Services dialog box and the Control Panel.
4. Stop the server configuration from being run as a service. For example, in Server 2009 R2, start the Server Administration tool by selecting Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server. The Server Administration tool opens.
5. Select the server configuration, and choose Actions > Set to Run as Service. This menu command changes from checked to unchecked, indicating that the server configuration is no longer running as a service. The server configuration’s icon also changes.
Install StarTeam Server <latest version> on the same computer as the version of Server that you are upgrading from.
If necessary, upgrade or migrate your database to a version supported by Server latest version. For more information, see Database Requirements for Upgrading.
Note: Performing the StarTeam Server installation and the database upgrade in different sessions, such as different weekends, allows you to isolate any problems to one step or the other. If your database version is not one that is supported by the latest version of StarTeam Server, perform the database migration prior to installing the latest version of StarTeam Server. If performing an upgrade of both the StarTeam Server and the database, upgrade the database, install StarTeam Server, then upgrade or migrate your database to another database version.
Upgrade your server configurations. For more information, see Upgrading Server Configurations.