Upgrading the cluster

Last Updated : Mar 20, 2026 |
Prolog information
The cluster upgrade takes a minimum of one hour. During the upgrade, folders and virtual machines are created on the host machines visible in the vCenter of the host.
Before you begin
  • Remove the previous version of Async messaging.
  • Pre-staging artifacts is non-service impacting and can be completed outside of a maintenance window.
  1. Log in to Cluster Control Manager with your customer account.
  2. To run the upgrade in the background, at the CCM prompt, type screen.
    ADDITIONAL INFORMATION:
    When running the upgrade in the background, if you need to detach from the upgrade SSH session, see Detaching from the upgrade SSH session.
  3. Run the ccm upgrade spec <complete path>/<solution spreadsheet name>.xlsx --infra command.
    ADDITIONAL INFORMATION:
    The upgrade takes approximately one hour, and services take approximately one more hour to start.
    Tip:
    If the upgrade stalls and does not progress, then cancel the upgrade, run ccm upgrade hard-reset to clear the state, and retry the upgrade.
  4. When prompted, enter your Avaya SSO credentials.
  5. When prompted, type y to confirm the cluster node upgrade to the new version specified in the solution spreadsheet and to accept the warning reminding you to start a screen session.
    ADDITIONAL INFORMATION:
    Only type y if you have already run screen. Do not continue with the upgrade until you do this.
    Failure to run the screen command exits the process and you have to start over.
  6. When prompted, accept the EULA.
    ADDITIONAL INFORMATION:
    Validation runs after accepting the EULA. If any part of the validation fails, you must address the detected issues and restart the upgrade.
  7. When prompted to perform a backup, enter y or n.
    ADDITIONAL INFORMATION:
    If you enter y, a backup runs after the upgrade is complete. The backup takes approximately 5 to 10 minutes to complete. If the archive destination is set to Local, the backup file is located at /var/avaya/artifactCache/ccmClusterBackup. If the archive destination is set to Remote, the ccmClusterBackup folder, which contains the backup file, is located in the base directory you specified.
  8. To monitor the progress of the upgrade, run the tail -f /var/log/avaya/ccm/ccm-main.log command.