TPVM Upgrade Workflow States

This topic describes all the upgrade states in a TPVM upgrade workflow.

TPVM Upgrade State Next State Case Description
TPVM Upgrade Workflow Started Device Validation

Normal Upgrade

Node Replacement

Initial start state for the TPVM upgrade workflow.
Device Validation

Success: TPVM Config Validation

Failure: TPVM Upgrade Workflow Finished

Normal Upgrade

Node Replacement

Ensure that the provided device IP has an associated TPVM configurations in the XCO DB, and the device‘s TPVM IP is one of the XCO peer node IPs.
TPVM Config Validation

-Normal Upgrade:

Success: TPVM Upgrade

Failure: TPVM Upgrade Workflow Finished

-Node Replacement:

Success: TPVM Configuration

Failure: TPVM Upgrade Workflow Finished

Normal Upgrade

Node Replacement

Read TPVM config and operational data from the device and determine if it is a normal TPVM Upgrade or a faulty node replacement.

  1. If TPVM config and operational data are present on the device and TPVM IP is one of the XCO peers, then it is a normal TPVM upgrade.
  2. If there is no TPVM config present on the device, then it is a node replacement.
  3. If TPVM config and operational data are present on the device and TPVM IP does not match one of the XCO peers, then validation for a normal TPVM upgrade was unsuccessful.

The Detailed Status column in the tpvm-upgrade show command output shows the nature of the issue and possible remedy.

TPVM Configuration

Success: TPVM Installation

Failure: TPVM Upgrade Workflow Finished

Node Replacement Device running-config is programmed using TPVM config data from XCO DB.
TPVM Installation

Success: XCO Deploy Peer and Rejoin

Failure: TPVM Upgrade Workflow Finished

Node Replacement TPVM install and start is invoked on the device.
TPVM Upgrade

Success: XCO Deploy Peer and Rejoin

Failure: TPVM Revert

Normal Upgrade TPVM upgrade is invoked on the device.
TPVM Revert

Success: TPVM Upgrade Workflow Finished

Failure: TPVM Upgrade Workflow Finished

Normal Upgrade On failure of “Upgrading TPVM” or “Deploying XCO for Rejoin”, the TPVM revert state is invoked to rollback the TPVM upgrade failure.
XCO Deploy Peer and Rejoin

Success: TPVM Upgrade Workflow Finished

Failure: TPVM Revert

Normal Upgrade

Node Replacement

On active XCO node, re-deploying of XCO on the peer node for rejoin is invoked.
TPVM Upgrade Workflow Finished N/A

Normal Upgrade

Node Replacement

End state for the TPVM upgrade workflow.