Procedure

The following steps describe the procedures to upgrade the Azure using IaC:

  1. Create an Ubuntu 18.04 LTS instance in Azure.
  2. Install the Azure CLI. Refer to Instantiate Standalone SBC on Azure > Install Azure CLI.

  3. Create Network Security Group rules to allow the instance to allow SSH access to SBC MGT IP on ports 22, 2024, 444, and 443. Refer to Instantiate Standalone SBC on Azure > Create Network Security Group. 

    Note

    If the NIC for the IaC instance was created in the same subnet as the SBC MGT, this step is not needed.

  4. Run az login and sign in as a user with the role 'owner' for the subscription.

  5. If not yet created, create a Service Principal that contains 'owner' permissions for the subscription. For example: 

    az ad sp create-for-rbac -n rbbn-iac --role="owner" --scopes="/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXa511"

  6. Export the following values from the Service Principal: 

    export ARM_SUBSCRIPTION_ID="<subscription_id>"
export ARM_TENANT_ID="<tenant_id>"
export ARM_CLIENT_ID="<client_id>"
export ARM_CLIENT_SECRET="<client_secret>"
    Note

    You can add this values to the file and source it before running the upgrade command.

  7. Make a directory to extract the IaC tarball.

  8. Copy the IaC tarball to the created directory created above and change it to that directory.

  9. Extract the IaC tarball using tar -zxvf.

  10. Follow the instructions available in ./README.md to set up IaC the environment.

  11. Change to management/SBC/upgrade/.

  12. Follow the instructions available in ./management/SBC/upgrade/README.azure.md to edit the necessary files and run the upgrade. 

    Information about the update required in the azure_access.yml and upgrade-revert.yml files are available at the last paragraph of README.azure.md.