Upgrading manually

Last Updated : Dec 19, 2025 |

About this task

Perform the following procedure to upgrade Avaya Aura® MS and update the operating system, disk drive, or server hardware. The procedure includes steps to prepare the system for upgrade and to bring the system back in to service as follows:

  • Set the server through a progression of Pending Lock, Lock, and Stopped states to take the server out of service for the upgrade.

  • Uninstall packaged applications.

  • Uninstall the Avaya Aura® MS software.

  • Optionally upgrade the server operating system or hardware.

  • Perform a clean installation of the new software.

  • Use the Avaya Aura® MS 10.x upgrade tool to restore and upgrade preserved configuration and application data from the previous release.

  • Verify that the system is functional and that there are no unexpected alarms.

Before you begin

  • Ensure that the system meets the perquisites for upgrade. See the upgrade perquisites earlier in this chapter.

  • Create Avaya Aura® MS backups of the current system. Configuration and application data backups of the current installation are required to preserve the data through the upgrade process and if a rollback is required.

  • If you are upgrading a server that is member of a cluster, ensure that you are performing the task as part of one of the cluster upgrade procedures before continuing. Ensure that you start at the correct step in the following procedure, as specified by the cluster upgrade procedure.

Procedure

  1. Prevent new sessions from starting on the system by navigating to EM > System Status  > Element Status and selecting More Actions > Pending Lock.
  2. Click Confirm.
  3. Check for active sessions on the server by navigating to EM > System Status  > Monitoring > Active Sessions.

    Wait for the active sessions to end. The system automatically changes to the Locked state after all the sessions have ended.

    Perform the following steps if you want to continue before the active sessions end:

    1. Manually lock the media server, by navigating to EM > System Status > Element Status and clicking More Actions > Lock.

      Locking the media server also ends any remaining sessions.

    2. Click Confirm.
  4. After the system ends the sessions, stop the media server by navigating to EM > System Status > Element Status and clicking Stop.
  5. Click Confirm.
  6. Ensure that you have system configuration and application content data backups before proceeding. Backup files are used to upgrade the current data. All the data will be lost if you do not have backups of your current Avaya Aura® MS 10.x data.
  7. If you are replacing the hardware or the operating system, ensure that you have saved the Avaya Aura® MS backups off the server in a safe location and proceed to Step 11.
  8. Uninstall the current Avaya Aura® MS installation but do not preserve data. Select the option to remove all data during uninstallation. The backups are used to restore and upgrade the data.

    Use an appropriate uninstallation method for the system. For more information on uninstallation methods, see uninstallation.

  9. Use an appropriate installation method to install Avaya Aura® MS 10.2 on the system. For more information on installation methods, see the Installation chapter.
  10. After the installation is complete, log in to the new Avaya Aura® MS EM.

    If security alert dialog boxes appear in the browser, accept the new security conditions to proceed.

  11. Stop Avaya Aura® MS by navigating to EM > System Status > Element Status and clicking Stop.
  12. Click Confirm.
  13. Ensure that the system configuration and application content backup files saved earlier are available on the server.
  14. Open a Linux® shell on Avaya Aura® MS.
  15. Obtain root access.
  16. From the command-line, change to the directory where you have saved the backup files.
  17. Use the upgrade tool to upgrade the system configuration data by entering the following on the command-line:

    amsupgrade SystemConfigBackupFilename.zip

    Important:

    Restore the system configuration data before restoring the application data to ensure that the application data is restored to the configured location.

    Important:

    Backup data is not portable from one server to another. If you need to replace a server, you must configure the server with the same installation path, IP address, and hostname so that the data is compatible with the server configuration.

  18. Press Y to stop all Avaya Aura® MS services when prompted.

    The tool upgrades the data.

  19. Use the upgrade tool to upgrade the application content data by entering the following on the command-line:

    amsupgrade AppContentBackupFilename.zip

  20. Press Y to stop all Avaya Aura® MS services when prompted.

    The tool upgrades the data.

    Tip:

    The time required to complete the application content upgrade depends on the amount of application data in the backup file.

  21. Optional Install the latest versions of each required application by running the installer for each application.

    For application installation procedures, see application documentation.

  22. Verify the required software is installed by navigating to EM > Tools > Manage Software > Inventory.
  23. Start Avaya Aura® MS by navigating to EM > System Status > Element Status and clicking Start.
  24. Click Confirm.
  25. Check for any service-impacting alarms and perform an appropriate test for the system. For example, place a call to the application.
    Important:

    Running the upgrade tool, as recommended in this procedure, ensures that the system configuration parameters and all application data is upgraded and ready to use. However, there are new and updated system configuration options in this release that are not automatically configured. To ensure that the new options are configured properly, see Implementing and Administering Avaya Aura® Media Server. Many systems might not need any additional configuration.

Related information
Linux installation
System requirements