Upgrade VxBlock Central Orchestration Services

Upgrade VxBlock Central Orchestration Services to the latest RCM version.

About this task

You cannot upgrade from 1.x version to 2.x version. To upgrade from 1.x to 2.x version, install the 2.x version. You can upgrade from 2.x to later version only.

Procedure

  1. Download the upgrade files to install the bundle on the VxBlock Central Orchestration Services VM.
  2. To take a snapshot of the VM that is deployed for VxBlock Central Orchestration Services, perform the following:
    1. Connect to the VxBlock Central Orchestration Services VM.
    2. To power off the VM, log in to the VxBlock Central Orchestration Services and switch to the root user by entering sudo -I.
    3. Enter: shutdown -h now.
    4. Log in to the VMware vSphere Client using administrative privileges.
    5. Under Navigation, select Home > Inventory > Hosts and Clusters.
    6. Right-click the VM for the snapshot and select Snapshot > Take Snapshot.
    7. Enter a name and description for the snapshot.
    8. If necessary, clear the check boxes to snapshot the VM memory and forget the guest file system.
    9. Click OK.
    10. After completion, power on the VM and log in.
  3. Download the following files from the Download Center to a temporary location:
    • vxcos-upgrade-service-patch-x.x.x.zip (optional)
      NOTE: The service patch file enables you to view the Upgrade tab in the VxBlock Central Orchestration Services UI. You must have the Upgrade tab to perform the upgrade procedure. Download this file only if the Upgrade tab is not visible in the VxBlock Central Orchestration Services UI.
    • vxcos-upgrade-bundle-x.x.x.zip
  4. Perform the following steps to view the Upgrade tab on the VxBlock Central Orchestration Services UI: If the Upgrade tab is visible, then ignore the following steps and continue to step 5.
    1. Copy the vxcos-upgrade-service-patch-x.x.x.zip to the /home/ciadmin directory.
    2. To extract vxcos-upgrade-service-patch-x.x.x.zip, type:

      sudo unzip vxcos-upgrade-service-patch-x.x.x.zip

    3. To go to the patch directory, type:

      sudo cd vxcos-upgrade-service-patch-x.x.x

    4. To install the patch using the install script, type:

      sudo python UpgradePatch.py

    5. Launch VxBlock Central Orchestration Services and verify that the upgrade service is available with a status of UP. Verify that the Upgrade tab is visible in the VxBlock Central Orchestration Services UI.
  5. To upgrade the VxBlock Central Orchestration Services VM, perform the following steps:
    1. In the VxBlock Central Orchestration Services, select the Upgrade tab.
    2. Click Upload Upgrade Bundle and select the appropriate upgrade bundle.
    3. Select Upload.
    4. Verify in the Status column that the upgrade bundle is Ready to Install.
    5. In the Actions column, click the install icon. The following table explains the possible upgrade status:
      Status Description

      INSTALLED

      Upgrade completed without any issues.

      FAILED (Rollback that is done)

      Upgrade detected a problem and rolled back to one or more services version before the upgrade.

      FAILED (Rollback failed)

      Observed unexpected behavior post upgrade.

      If you receive the FAILED (Rollback Failed) status, revert to the VM snapshot taken before the upgrade and contact Dell EMC Support.