Upgrade projects

After a project appears in the OpenText Application Quality Management 25.1 Site Administration project list, you can proceed with the actual project upgrade. You can upgrade projects individually or on the domain level, which upgrades all projects contained in the domain. You must first upgrade any template projects before upgrading other projects.

About upgrading domains and projects

By default, the upgrade process runs in non-silent mode. When running the process in non-silent mode, OpenText Application Quality Management may pause and prompt you for input when an error occurs. Instead, you can choose to run the process in silent mode. When running the process in silent mode, OpenText Application Quality Management aborts the process without prompting you for input.

After the project has been upgraded, you can no longer use the project with a previous version of OpenText Application Quality Management/Quality Center.

Note:

During the upgrade process, the project directory must be accessible. For example, if your project directory is located on a file server, ensure that the server is running and accessible.
During the upgrade process, no database maintenance jobs can be run. Running database maintenance jobs can cause the upgrade to fail and can corrupt projects.
If a project has extensions enabled, the availability of these extensions on the new server must be verified before upgrading. If any extension is not available on the new server, the upgrade fails.
You must first upgrade a template project before upgrading any of its linked projects. If the template project and its linked projects are in different databases, ensure that the template project’s database is accessible when updating any linked projects.
Version Control: Version control enabled projects cannot be upgraded while there are checked out entities. All entities must be checked in to the corresponding version of Quality Center or OpenText Application Quality Management. To determine if there are checked out entities, see this KB article.

Upgrade a domain

This section describes how to upgrade all projects in a domain.

To upgrade a domain:

In Site Administration, click the Projects tab.
In the Projects list, select a domain.
Click the Maintain Domain button and select Upgrade Domain. The Upgrade Domain dialog box opens.
In the Upgrade Settings area, under Upgrade Mode, you can select the following options:
- Run in Silent Mode. Runs the process without any user interaction.
- Continue to next project if upgrade failed. Proceeds to the next project if the upgrade process fails. This is the default option.
In the Upgrade Settings area, under After the Upgrade, you can select one of the following options:
- Leave all projects deactivated. Leaves all projects deactivated after the upgrade process completes.
- Activate only currently active projects. Reactivates previously-activated projects after the upgrade process completes. This is the default option.
- Activate all projects. Activates all projects after the upgrade process completes.
To view the current version numbers of your projects, select the project names, or click Select All to view version numbers for all projects. Click the Display Versions button.

The project version number is displayed in the Version column.
To upgrade your projects, select the project names, or click Select All to verify all projects. Click the Upgrade Projects button.

If a database error occurs while running the process in non-silent mode, a message box opens. Click the Abort or Retry buttons, based on whether you can correct the problem described in the message box.

If the upgrade fails, OpenText Application Quality Management displays an error message with reasons for the failure and refers you to the log file. You must restore the backed up projects before you try to upgrade again. For details, seeRestore backed up projects and repositories.
To pause the upgrade process, click the Pause button. To continue, click the Resume button.
To abort the upgrade process, click the Abort button. Click Yes to confirm.
To save the messages displayed in the Upgrade Results pane in a text file, click the Export Log button. In the Export Log to File dialog box, choose a location and type a name for the file. Click Save.
To clear the messages displayed in the Upgrade Results pane, click the Clear Log button.
Click Close to close the Upgrade Domain dialog box.

Upgrade a project

This section describes how to upgrade a single project.

To upgrade a project:

In Site Administration, click the Projects tab.
In the Projects list, select a project.
Click the Maintain Project button and select Upgrade Project. The Upgrade Project dialog box opens.
To run the upgrade process without any user interaction, select Run in silent mode.
To start the upgrade process, click the Upgrade Project button. If the project is active, you are prompted to deactivate it.

If a database error occurs while running the process in non-silent mode, a message box opens. Click the Abort or Retry buttons, based on whether you can correct the problem described in the message box.

If the upgrade fails, OpenText Application Quality Management displays an error message with reasons for the failure and refers you to the log file. You must restore the backed up project before you try to upgrade again. For details, see Restore backed up projects and repositories.
To pause the upgrade process, click the Pause button. To continue, click the Resume button.
To abort the upgrade process, click the Abort button. Click Yes to confirm.
To save the messages displayed in the Upgrade Results pane to a text file, click the Export Log button. In the Export Log to File dialog box, choose a location and type a name for the file. Click Save.
To clear the messages displayed in the Upgrade Results pane, click the Clear Log button.
Click Close to close the Upgrade Project dialog box.
Reactivate the project.