SBC release 8.1 consolidated high-availability (HA) redundancy models into two supported options: N:1 HA and 1:1 HA. Because of changes related to HA consolidation, upgrading a 1:1 HA deployment from any prior release to release 8.1 or later requires deleting your current nodes and re-instantiating them using Heat templates that incorporate HA model changes. Deleting the nodes is service-impacting.

You can deploy SBC SWe in 1:1 HA mode either with or without a RAMP system. If your deployment includes a RAMP (a Direct-Single deployment), your configuration database is backed up on  RAMP and are available for download again after you re-instantiate the nodes. Otherwise, deleting your current nodes will result in loss of your current configuration. To save and then restore your own configuration backup, refer to Saving the SBC Configuration using EMA and Restoring the SBC Configuration using EMA.

After you upgrade to release 8.1 or higher, the required database changes are in place and you can resume using the replacement-based upgrade procedure for subsequent upgrades to higher releases. Refer to Upgrading SBC SWe 1:1 HA Nodes on OpenStack using Heat Templates - 8.1 and later.

Note

For upgrades from release 7.2 to 8.x or higher, a Direct-Single SBC node can go to an unregistered state on RAMP while coming up, which pauses the upgrade. This can occur because of the conversion of the policy database from Oracle to Postgres. To continue, reboot the node to return it to a registered-online state.


Start

Perform the following activities to upgrade an SBC SWe 1:1 HA deployment to SBC release 8.1 on OpenStack using Heat.


StepAction
1

Upgrade RAMP

If you include a RAMP in your deployment, upgrade it first before re-instantiating the SBC nodes.

Refer to one of the following pages:

2

Download the Software Image

Download the required .QCOW2 and .sha256 files from the Customer Portal.

3

Upload the Software Image to OpenStack

To upload the .QCOW2 file to OpenStack, navigate to Project > Compute > Images.

For more information, refer to Creating a Glance Image.

4

Update the Heat Template 

Refer to Instantiating SBC SWe on OpenStack using Heat Templates for information on the process to develop Heat templates and instantiate SBC nodes.  

Refer to the current release notes for information on how to access the current set of sample Heat templates.

As a result of HA model consolidation, the user data parameter in the Heat templates for specifying the HA model for a deployment is called 'SbcHaMode'.

For 1:1 HA deployments, you must set this parameter to '1to1'. 

If you include a RAMP in the deployment and want to download your prior configuration after re-instantiating the SBC nodes, ensure to specify the same RAMP IP address and cluster parameters when instantiating the nodes.

5

Delete the Existing Nodes

Use the Horizon GUI to delete the stacks corresponding to the current nodes. 

  1. Log into the Horizon GUI.
  2. Access the list of current stacks list: Project > Orchestration > Stacks
  3. Locate the entries for the SBC nodes in the stack list.
  4. In the drop-down menu adjacent to the entries, select Delete Stack. 
6

Instantiate the Nodes

Use standard OpenStack Heat commands or the OpenStack Horizon dashboard to instantiate the nodes using the 8.1 software image and Heat templates. 

Refer to Instantiating SBC SWe Using a Heat Template for additional information.  

Note

The new SBC nodes you create in OpenStack will have a new Universal Unique Identifier (UUID) value. If a node is configured to use node-locked licensing, after re-instantiating the node you must generate a new license for the node using the new UUID.

Related articles: