Upgrading a Domain

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

To upgrade a domain:

  1. If you have backed up your project during the repair process (see Repairing Domains and Projects), proceed to step 3.

  2. Back up your projects. For details, see Backing Up Projects.

  3. In Site Administration, click the Site Projects tab.

  4. In the Projects list, select a domain.

  5. Click the Maintain Domain button and select Upgrade Domain. The Upgrade Domain dialog box opens.

  6. 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.

  7. 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.

  8. 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.

  9. To upgrade your projects, select the project names, or click Select All to verify all projects. Click the Upgrade Projects button.

    If an error occurs while running the process in non-silent mode, a message box opens. Click the Abort or Retry buttons accordingly.

    If the upgrade fails, ALM 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, see Restoring Projects.

  10. To pause the upgrade process, click the Pause button. To continue, click the Resume button.

  11. To abort the upgrade process, click the Abort button. Click Yes to confirm.

  12. 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.

  13. To clear the messages displayed in the Upgrade Results pane, click the Clear Log button.

  14. Click Close to close the Upgrade Domain dialog box.