Beginning with release 12.0, the SBC Core supports the Ribbon Application Management Platform (RAMP), which replaces the EMS.
However, the EMA, CLI and API will continue to include EMS-labeled parameters and screens to facilitate SBC migrations from older releases. Accordingly, any references to "EMS" in this documentation pertain to the RAMP platform.
Clear the upgrade directory from both servers before reattempting further upgrades using the command rm -fr /var/log/sonus/upgrade/*
under all the following conditions:
- There is a need to revert the upgraded server after a single server upgrade while the peer is still on an older version.
- A revert will be performed by doing a re-ISO.
In this section:
This section describes the different methods to upgrade the SBC Core application.
When an SBC upgrade is available, the software is posted on the Ribbon Support Portal. Refer to Downloading Software from the Ribbon Support Portal for more information.
Prerequisities
Prior to performing an upgrade on the SBC Core, ensure the following activies are accomplished.
SBC Core (in general)
- Before upgrading the ConnexIP OS, firmware, and the SBC application, you must first save the configuration in case you encounter any issues during the upgrade.
- This will allow you to restore the system and continue the upgrade.
- Refer to Saving the SBC Configuration and Restoring SBC Configuration.
Before upgrading the application, upgrade the SBC firmware to the latest version on both the active and standby SBCs for an HA pair.
- Refer to the target Release Note for the latest firmware version.
- Upgrade the firmware using Upgrading the BMC and BIOS Firmware procedure.
SBC SWe
Increase the memory to the larger of:
- the minimum memory required for the release.
or - the memory required for the desired session capacity.
NoteThe performance/capacity of the SBC SWe is impacted by the amount of memory assigned to the VM. Review SBC SWe Performance Metrics to see the memory requirements for the current release plus a procedure to upgrade memory, if required. Complete the procedure to upgrade memory prior to performing the upgrade.
- the minimum memory required for the release.
- Ensure the SBC SWe memory reservation meets the requirements for the current release. Refer to SBC SWe Performance Metrics.
- Check minimum disk space requirements:
The amount of disk space used during the upgrade process depends on how the hypervisor internally handles the disk lifecycle for an instance. The following table provides Ribbon's recommendation for extra disk space for different types of nodes/instances.
NoteFor proper performance, you must provide the minimum resources shown here.
Node Type Extra Disk Space*
(in GB)
S-SBC 80 M-SBC 80 PSX-M 360 PSX-S 360 PSX-Test 360 EMS_SA 150
To recover from a mismatch in session estimates in an HA pair, refer to Recovering from Default Indices in 1:1 HA SBC SWe, if applicable.
The E1000E network interface type is unsupported in VMware.
Live Software Upgrade (LSWU)
LSWU allows a user to upgrade the SBC application software on HA pairs without impacting service (dropping calls). This is mainly recommended for HA SBC systems. You can also perform a LSWU on the SBC EMA and in SBC EMA Platform Mode. Refer to Live Software Upgrade using CLI and System Administration - Software Install-Upgrade for more information.
Notes for Performing LSWU from Release 11.1.0x
On SBC setups, the active node takes more time than expected for the services to come up after an upgrade from 11.1.0x. Before performing an upgrade from 11.1.0x, apply the following steps:
- Confirm that the cnixpmadmin password is not default by running the following command as root on the active and standby nodes:
[root@SBC]# $ENCRYPTED_STORE_SH cnxipmadmin
NoteThe command must not show the default password "
Cnx1PmAdm1n
" - If the password is still the default, randomize the password by running the following command as root on the active node:
[root@SBC]# $CHANGE_DEFAULT_PASSWDS_SH
- Verify the cnxipmadmin password is updated to a random one on both the active and standby nodes:
[root@SBC]# $ENCRYPTED_STORE_SH cnxipmadmin
Non-Live Software Upgrade (Non-LSWU)
The non-LSWU upgrade process requires taking the SBC system offline to perform an application upgrade. This refers to upgrading the SBC application in a standalone or HA configuration using EMA Platform Mode. Refer to Upgrading SBC Application using EMA Platform Mode for more information.
Once the upgrade is complete, rediscover the SBC from the RAMP, if present, and edit any attributes that may have been modified post-upgrade. Attributes are listed under the RAMP page Register an SBC Core Device.