Installing a QFE patch

Last Updated : Nov 20, 2024 |

About this task

Perform the following procedure to install a QFE patch to the system. When possible, apply patches during a maintenance window:

Important:

You must apply QFE patches in sequential, numerical order because new patches depend on previously installed QFE patches. For example, you must install QFE-platform-10.2.0.230-0001 before you install QFE-platform-10.2.0.230-0002.

Note:

Some steps in the following procedure are specific to the Avaya Aura® MS EM management system. If you are using a different management system, the procedure is different.

Before you begin

Before proceeding with the QFE installation, ensure that you:

  • Back up your system.

    In case of unforeseen problems, you can use the backup to restore your system to the previous configuration.

  • Apply patches to N+1 load sharing clusters one node at a time so that the other nodes in the cluster can provide service during the procedure. See, Managing QFEs for N+1 load sharing clusters.

  • Apply patches to 1+1 High Availability clusters by applying the QFE to the standby server first and then applying the QFE to the other server. See, Managing QFEs for 1+1 High Availability clusters.

  • Ensure that the QFE is downloaded and staged on the target server. Root access is required to stage the QFE file, so contact Avaya support if root access is not available. To stage the QFE as root, copy it to the QFE directory $MASHOME/qfe.

Procedure

  1. Prevent new sessions from starting on the system by navigating to EM > System Status > Element Status and select 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 Avaya Aura® MS, 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 all the sessions, stop Avaya Aura® MS by navigating to EM > System Status > Element Status and select More Actions > Stop.
  5. Click Confirm.
  6. Open a Linux® shell.
  7. Enter the following command to get the actual name of the patch to be applied:

    amspatch list all

    Remember the name of the patch listed under the QFE column for use in the next steps. This name can be different from the file name.

    If you do not see the QFE patch in the list of available patches, then check the following:

    • The patch file is present in the patch QFE directory.

    • The patch file you downloaded is not set to read-only.

  8. Enter the following command to apply a single patch:

    amspatch apply patchname

    To apply all available patches enter the following command:

    amspatch apply all

  9. Press y to continue.
  10. After the patch application is complete, open EM and navigate to EM > Tools > Manage Software > Inventory.
  11. Verify whether the patch version listed in the Patch Level column is correct.
  12. Optional If you stopped the media server in Step 6, then start Avaya Aura® MS with the following steps:
    1. Navigate to EM > System Status > Element Status and select Start.
    2. Click Confirm.
  13. Unlock Avaya Aura® MS by navigating to EM > System Status > Element Status and select More Actions > Unlock.
  14. Click Confirm.
  15. Check for any service-impacting alarms and perform an appropriate test of the system, for example, place a call to the application.
Related information
Managing QFEs for 1+1 High Availability clusters
Managing QFEs for N+1 load sharing clusters