In this section:
Overview
Use this procedure to perform a SBC SWe HA upgrade on VMware ESXi using the OVA package.
Scope
This procedure only applies to upgrading a HA SBC SWe when it is installed with an OVA package on the VMware ESXi.
Prerequisites
Verify the following prior to starting the upgrade:
- SSH access to VMware ESXi for root user is enabled.
- The new OVA package is available for use in upgrading the SBC SWe.
SBC SWe Upgrade
Use the following steps to perform a HA SBC SWe upgrade on VMware ESXi using an OVA package.
- You may use the
hostname.domain_name
, if configured, instead of the IP address during the upgrade. - You may use other file transfer tools instead of 'scp' to upload the package to the VMware ESXi datastore (For example, WinSCP on Windows).
Start
Download the OVA Package
Download the new OVA package and upload it to the VMware ESXi host.
For example, ifsbc-V11.01.00R000-connexip-os_11.00.00-R000_12_amd64.ova
is the new OVA package for the SBC SWe upgrade and 172.19.201.11 is the IP address of the VMware ESXi server, use scp to upload the package to the VMware ESXi server:scp sbc-V11.01.00R000-connexip-os_11.00.00-R000_12_amd64.ova root@172.19.201.11:/vmfs/volumes/datastore1/
Save the SBC SWe configuration
Login to the VMware ESXi host via a web browser
Login to the SBC SWe VM Console as ‘
linuxadmin
’ user and change to ‘root
’ user using ‘sudo su –
‘.Save the instance-specific configuration of the VM:
/opt/sonus/sbx/scripts/saveConfig_fe.sh
NoteThis script backs up the configuration and relevant files, and then saves the backup on the DRBD disk under the
/home/sftproot/evlog/backup
directory.Ribbon recommends to also copy the backup directory (
/home/sftproot/evlog/backup
) to an external location outside of the VM using 'scp
' for any disaster recovery measures, if needed.
Shut down the VM
- Shut down SBC SWe VM from the VMware ESXi console by selecting the VM and clicking on Shut down.
Upgrade the SBC SWe to the new version
Login into the VMware ESXi server using SSH as the ‘
root
’ user and extract the VMDK image from the OVA package using the 'tar
' command.
For example, if 172.19.201.11 is the IP address for the VMware ESXi server and the OVA package is 'sbc-V11.01.00R000-connexip-os_11.00.00-R000_12_amd64.ova
' , then SSH to the VMware ESXi server as the 'root
' user and run:ssh root@172.19.201.11 cd /vmfs/volumes/datastore1/ tar xvf sbc-V11.01.00R000-connexip-os_11.00.00-R000_12_amd64.ova sbc-V11.01.00R000-connexip-os_11.00.00-R000_12_amd64.vmdk
Take a backup of the previous SBC SWe root disk.
(In this example, the SBC SWe VM name is ‘SBC1
’. Replace it with your VM name, if different)Example:cd /vmfs/volumes/datastore1/SBC1 mv SBC1.vmdk SBC1.vmdk_backup mv SBC1-flat.vmdk SBC1-flat.vmdk_backup
Make a compatible root disk from the new VMDK image using ‘
vmkfstools
’.
(In this example, the SBC SWe VM name is ‘SBC1
’. Replace it with your VM name, if different)Example:cd /vmfs/volumes/datastore1/SBC1 vmkfstools -i /vmfs/volumes/datastore1/sbc-V11.01.00R000-connexip-os_11.00.00-R000_12_amd64.vmdk SBC1.vmdk -d thin
NoteThe above command takes a minute or so to clone the disk. Wait for the control to return before proceeding.
Expand the new root disk to a size greater than 35 GB, where
<Size_in_GB>
is the new size of the disk, in GB.vmkfstools -X <Size_in_GB>G SBC1.vmdk
Example: New size is 65 GBvmkfstools -X 65G SBC1.vmdk
NoteMatch the new root disk size with the existing one.
Power on the SBC SWe VM from the VMware ESXi console
- Select the VM and click Power on.
Validate the SBC SWe upgrade
During the SBC SWe bootup after a power on, the SBC application comes up with the upgraded version and the configuration saved as part of step 2c above is automatically restored.- Login to the VMware ESXi host via a web browser
- Login to the SBC SWe VM Console as ‘
linuxadmin
’ and change to ‘root
’ user using‘sudo su –
‘. Run the
swinfo
command to check the SBC SWe version.
SBC SWe Rollback
Use the following procedure to perform an HA SBC SWe rollback on the VMware ESXi using an OVA package.
Start
Shut down the VM
- Shut down SBC SWe VM from VMware ESXi console by selecting the VM and clicking Shut down.
Roll back the SBC SWe to the previous version
Login into the VMware ESXi server using SSH and ‘
root
’ user and restore the disk to the backed up SBC SWe root disk.
For example, if 172.19.201.11 is the IP address for VMware ESXi server and the SBC SWe VM name is ‘SBC1’, then SSH to VMware ESXi server using 'root
' user and restore the disk from the backed up SBC SWe root disk.
(In this example, the SBC SWe VM name is ‘SBC1
’. Replace it with your VM name, if different)Example:ssh root@172.19.201.11 cd /vmfs/volumes/datastore1/SBC1 mv -f SBC1.vmdk_backup SBC1.vmdk mv -f SBC1-flat.vmdk_backup SBC1-flat.vmdk
Power on the VM
- Power on the SBC SWe VM from the VMware ESXi console by selecting the VM and clicking Power on.
Validate the SBC SWe rollback
Once the SBC SWe boots up after a power-on, the SBC SWe application comes up on the previous version.
Login to the VMware ESXi host via a web browser.
Login to the SBC SWe VM Console as ‘
linuxadmin
’ and change to ‘root
’ user using‘sudo su –
‘.Run the
swinfo
command to check the SBC SWe version.