Rolling back an upgrade using the web interface

Last Updated : Jun 12, 2023 |
Prolog information
  1. Log in to the EMS web interface with administrator credentials.
  2. Navigate to Device ManagementUpdates.
    STEP RESULT:
    The EMS server displays the current EMS version and the available upgrade and rollback options.
  3. Click Rollback. The Rollback button shows the release to which you can roll back.
    STEP RESULT:
    The system displays the Rollback Devices window. Select the devices you want to roll back. The system determines the order in which you must roll back devices. For example, if you have an HA pair of SBC devices, you must roll back the secondary SBC before you roll back the primary SBC.
  4. Select the check box in the Device Name column that you want to roll back.
  5. Click Next.
    STEP RESULT:
    The system starts the rollback. You can click View Log to view the log file to follow the progress of the rollback or you can just wait for the status bar to complete. The rollback process for an SBC device should not take very long.
  6. Click Finish.
    ADDITIONAL INFORMATION:
    The system returns to the Device Management with the Updates tab selected.
    Note:
    • Until all of the SBC devices managed by this EMS have been rolled back, the EMS displays the following message for SBC HA pairs on the Updates tab:
      One or more devices are in an orphan state. If you would like to upgrade these devices now, please click the Upgrade button below.
      HA system pairs and all other SBC systems must be rolled back before this message is resolved.
    • If the EMS server becomes non-functional during the upgrade, after the upgrade is complete, you must enable the EASG feature manually to allow the EASG logins for the customers.
  7. Do one of the following steps:
    • If you have more SBC devices to roll back, click Rollback to repeat this procedure and roll back the next SBC device.
    • If you have rolled back all SBC devices that require a rollback, select the Devices tab to confirm that all SBC devices are rolled back to the correct version and that the status shows Commissioned. You can also run the ipcs-version command from the command line interface to view the current version and status of the EMS and SBC.
    • If only the EMS remains to roll back, the system displays the following message:
      One or more devices are in an orphan state. If you would like to upgrade these devices now, please click the Upgrade button below. You may also choose to rollback your EMS at this point.
  8. Click Rollback EMS.
    STEP RESULT:
    The system displays a warning message about rolling back the EMS.
  9. Click Start Rollback to roll back the EMS.
    STEP RESULT:
    The EMS server displays the Rollback EMS Device screen followed by a screen that shows the rollback log messages. The rollback process takes some time. Do not try to manually reboot the server when a rollback is in progress. After the rollback is complete, the EMS server displays the Return to EMS button.
  10. Click Return to EMS to log back in to EMS.
  11. To verify whether the upgrade was successful or not, do one of the following tasks:
    • Log on as administrator to the EMS you just upgraded, navigate to Device ManagementDevices, verify that the EMS has been rolled back with a status of Commissioned, and that any connected SBCs are rolled back on the same version with a status of Commissioned.
    • From the command line interface, run the ipcs-version command to view the current version and status of the EMS and SBC.
  12. Repeat Steps 7–11 on the secondary EMS, if it is part of the deployment.
  13. Optional: If after doing the rollback on all systems you see any of the systems display DOWN on the Device ManagementDevices tab, log on as root to the OS and run the following command to restart each system so that the systems synchronize with each other:
    ADDITIONAL INFORMATION:
    /etc/init.d/ipcs-init restart