Migrate XCO from TPVM to Server

You can migrate XCO from TPVM-based deployment to Server-based deployment model.

Before you begin

Ensure that no sub-interfaces, static IPs, or virtual routes are present before migration. If there are, ensure that you have deleted and re-added after migration.

About this task

Follow this process to migrate XCO from TPVM-based deployment to Server-based deployment model.

Use the XCO backup and restore procedure to migrate XCO from TPVM High Availability to Server High Availability, which will run XCO to manage a fabric with a large number of POs and EPGs.

Note

It takes approximately 1 hour to complete the migration.
As a best practice, complete the migration during a maintenance window.

Procedure

Back up XCO.
Run the following command to take a backup of the XCO config from the old TPVM (for example, EFA 2.7.2):
```
efa system backup
```
Install XCO.
Install XCO on a new server in High Availability mode with the same target version (for example, EFA 2.7.2).
Use the 18.04 LTS Ubuntu servers since EFA 2.7.2 supports only on the 18.04 LTS Ubuntu server.
Copy the backup.
Copy the backup taken from TPVM to the new server location /var/log/efa/backup/:
```
cd /var/log/efa/backup/
```
Restore the backup.
Run the following command and select the backup file name which was taken from the TPVM setup:
```
efa system restore
```
Enable secure connection.
Run the following command to install the certificates on devices:
```
efa certificate device install --force
```
The command installs the HTTPS or OAuth2 certificate on one or more devices.
Verify the device status.
Run the following command to get the current state of the devices:
```
efa inventory device update
```
Stop old XCO services on TPVM.
Run the following command on both SLX switches to power off the old TPVMs where XCO is installed:
```
tpvm stop
```
Alternatively, run the following command to disable all services:
```
efactl stop
```
Upgrade XCO in the server setup.
Copy the target version tar file (for example, efa 3.3.1 tar file) to the server setup and upgrade it to the target version (for example, XCO 3.3.1) to upgrade from the source version (for example, 2.7.2) to the target version (for example, XCO 3.3.1).
Upgrade Ubuntu host OS from 18.04 to 20.04 LTS.
For details on upgrading Ubuntu in a single-node and a multi-node deployment, see Upgrade Ubuntu on the XCO Host - Single Node or Multi Node.