Page History

Volume-based Upgrade Overview

Volume-based upgrade is a procedure in which the computing and the network resources can be reused. Use this document to upgrade SBC software from 7.X to 9.0.

Procedure

1. Login to the Active SBC CLI admin, and execute the following command to perform a backup of the configuration. The backup file is stored in the path as shown.
   
   
   
   
   
2. SCP this configuration file from SBC to local server as below.
   
   
   

3. Check the Status on SBC before upgrade.
   
   
   Ensure that you complete the configuration and userdata backup from the existing instances (both active and standby).
   Also, ensure that in your local machine, you have a copy of the license bundle you downloaded from the Ribbon Support Portal and used in the existing instance.

   Info
   The hypervisor changes when migrating from C4/M4 to C5/M5, rendering existing hypervisor licenses invalid. Contact your Ribbon representatives for new licenses.

   
   

4. Create two new volumes using the new AMI ID snapshot provided for the volume-based upgrade. For information on creating volumes, refer to Create, Detach, and Attach Volumes in AWS.

   Info
   title Note
   Ensure that the new volumes are created in the same "Availability zone" as that of the running the existing instance.

   
   

5. Shut down the existing instance (both active and standby volumes).

   Info
   title Note
   Volume-based upgrade is applicable only for offline upgrade. All participating HA pair instances should be turned off during the upgrade.

   
   

6. After the existing instance is completely shut down, detach the active and standby volumes from the instance. For information on detaching volumes, refer to Create, Detach, and Attach Volumes in AWS.

7. Attach the new active and standby volumes created using the upgraded instance AMI snapshot to the existing instance. For information on attaching volumes, refer to Create, Detach, and Attach Volumes in AWS.

   Info
   title Note
   The new volumes must be associated as root volumes (device name: /dev/sda1) to the corresponding instances.

   
   

   Note
   title Caution
   Do not start the instance immediately after attaching the new volumes. You must execute the next steps.

   
   

   Info
   The following step applies only for volume-based upgrades from 5.1 to 6.2.1. Skip this step if you are not upgrading on this specific path.

   
   

8. While in stopped state, modify the userdata. You must provide the new userdata variables for the upgraded instance. Refer to Metadata and Userdata Formats on AWS for additiona details.
   To view/modify userdata, on your AWS dashboard:

   1. Select the instance, right click and navigate to Instance Settings > View/Change User Data.

      Caption
      0 Figure 1 View/Change User Data 3 View/Change User Data

      
      

   2. Modify the userdata and click Save.

      Caption
      0 Figure 1 View/Change User Data

      
      

      Info
      title Note
      For assistance in modifying the userdata to suit the the upgraded instance requirements, refer to Metadata and Userdata Formats on AWS.

      
      

      The following new userdata variables are added for the upgraded instance:

      Anchor
      Mandatory New Userdata Variables Mandatory New Userdata Variables

      Multiexcerpt include
      MultiExcerptName HA user-data PageWithExcerpt Upgrade SBC SWe on AWS

      
      

9. Start the upgraded instances.

10. Login to the CLI of the upgraded instance as linuxadmin and perform the following steps:
    

    1. Check for the persistence of the UUID of the instance. On successful upgrade, it must remain same.
       (Refer to Metadata and Userdata Formats on AWS for details)

    2. Check for the correctness of the upgrade by executing the command swinfo.
       (Refer to Metadata and Userdata Formats on AWS for details)

       Info
       title Note
       On successful upgrade, the values for the fields OS, SonusDB, EMA, and SBC must change to reflect the new build. The values displayed against the fields Installed host role and Current host role varies depending on whether the volume to which you have logged on is active or standby.

       
       

    3. Check whether the userdata variables reflect the modified values. For information on how to view the userdata, see figure: View/Change User Data.
       (Refer to Metadata and Userdata Formats on AWS for additonal details)
       
       

11. Copy the saved configuration from release 7.x on local server to the upgraded Active SBC.
    

    
    

12. Run below command to load the 7.x configuration. After loading the configuration, both SBCs will go for restart. This will take approximately 10 minutess (depending on the configuration size) for the 7.x configuration to load.

    
    
    

13. After loading the configuration, check the server status using the CLI ‘show table system serverStatus’ to ensure that calls are running successfully.
    
    
    

14. Login to the CLI of the upgraded instance as linuxadmin, and then SSH to admin to verify the licenses are correctly retained using the command:
    > show table system licenseInfo

    Info
    title Note
    Login is via the AdminSshKey in the userdata.