Simplified Configuration-Only Migration from Hot Standby Docker to Docker

Preparing to Migrate

This procedure provides instructions on how to migrate from one of the following releases by migrating the database only:

• Legacy Orchestrator Docker Hot Standby (21.08 or later version) to Cisco Crosswork Assurance Sensor Management Docker Hot Standby (25.07.1-LTS)

Migration involves setting up a new Target Installation Docker with the new operating system version that will be used to import the database configuration of the Source Installation with the old operating system version. This requires, at a minimum:

• The deployment of the Target Installation Docker
• The configuration of its hostname, IP addresses, NTP time sources (highly recommended), timezone (highly recommended)
• The selection of its deployment profile.

For redundant environments, two new Target Installation Dockers will be required and for hot standby environments, the need for three interfaces per appliance on distinct subnets remains.

These procedures are written assuming the target installation will be hosted in a new environment with new net IP addresses. It is expected that new firewall implementations will be required to ensure the application can connect to the network and that end users can access the application interfaces.

The installation of these new Target Installation Dockers is beyond the scope of this article. These procedures are already captured in the Sensor Management Docker Deployment article and should be used in the preparation for your migrating activity. The important point to consider while installing your Target Installation Docker is the deployment profile. The software ships with four deployment profiles:

• 5K profile (default)
• 15K profile
• 30K profile
• 60K profile.

The profiles reference the number of network elements the system can manage. Larger profiles have larger memory, CPU, and disk requirements. The selection of the profile is dictated by the current number of network elements in your source installation.

Consult your Cisco sales engineer if you need guidance on the profile to choose for your Target Installation Docker. The deployment profile can be changed (during a maintenance window) at any time, but when doing so, adequate memory, CPU, and disk resources need to be assigned to the Docker host.

Once the Target Installation Docker is in place, with IP addresses assigned, deployment profile selected, and networking rules in place, the high level process of migrating entails the following tasks:

1. Taking a database backup of your source installation
2. Stopping the software on your source installation
3. Importing the database backup into the target installation
4. Starting up the software on your target installation.

Migration Procedure

Source Installation Procedures

Backing up the Data Store

To rehome, a database backup of the source installation is required. If running a hot standby configuration, the hot standby license file must be copied as well.

To back up and transfer the data store

1. Open an SSH terminal session to the Legacy Orchestrator CLI on port 2200.
2. Log in as the skylight user.
3. Create a backup of the data store by entering:

database backup

Note: On the Hot Standby configuration system:

• The backup must be taken from the active site.
• The backup is generated as a tar.gz file in the folder /home/skylight/so/mysql-ha/backups.

4. Rename the database backup file to migrate.tar.gz and transfer it to the new Target Installation Docker under the /tmp directory.

Note: The file should be transferred to both Target Installation Dockers.

Stopping the Hot Standby process

It is best to stop the Legacy Orchestrator services on the source installation while doing the migrating procedure. The procedure to stop the Legacy Orchestrator services differs for hot standby setups.

1. Open an SSH terminal session to the Legacy Orchestrator on port 2200.
2. Log in as the skylight user.
3. Stop the Hot Standby process by entering:

redundancy control stop

Target Installation Procedures

These procedures guide you through the database import and rebalancing process that is to be executed on the target installation of Legacy Orchestrator Docker.

Requirements

Ensure that all configurations related to network, interface, NTP server, Hamon, and timezone (highly recommended) are configured manually and match the configuration on the virtual appliances (source installation) to ensure all devices are reachable on the Legacy Orchestrator Docker (target installation). Refer to the Sensor Management Docker Deployment articles for additional information.

Ensure the data volume(s) is configured to store all performance session data and performance metrics data.

Stopping the Target Installation Services

Stopping Hot Standby Process

Active Site

1. Open an SSH terminal session to the Target Installation CLI on port 2200.
2. Log in as the skylight user.
3. Stop the Hot Standby process by entering:

redundancy control stop

Importing the Database

Ensure the user 'skylight' has read access to the archive that was copied in the /tmp folder. The backup file that needs to be restored must be placed on the appliance file system in the /tmp directory.

1. Open an SSH terminal session to the Target Installation CLI on port 2200.

Note: Log into the target installation virtual appliance you have designated to be the preferred active site.

2. Log in as the skylight user.
3. Restore the backup by entering:

database migrate <filename_of_the_backup_archive>

Note: You must provide only the filename of the archive, not the path which is assumed to be /tmp.

Starting the Target Installation Services

This procedure will start the application.

Starting the Target Installation services for Hot Standby configuration

1. Open an SSH terminal session to the Target Installation designated as the preferred active site on port 2200.
2. Log in as the skylight user.
3. Configure the preferred site, the site which transferred the To back up and transfer the data store step, enter:

redundancy config preferred {site-a | site-b}

4. Start the Hot Standby process by entering:

redundancy control start

5. Verify redundancy status, enter:

redundancy show status

Rollback Procedure

The migrating operation can be rolled back by stopping the application on the target installation and restarting the application on the source installation.

Target Installation Procedures

Stopping Hot Standby Process

Active Site

1. Open an SSH terminal session to the Target Installation CLI on port 2200.
2. Log in as the skylight user.
3. Stop the Hot Standby process by entering:

redundancy control stop

Source Installation Procedures

This procedure will start the application.

Starting the Legacy Orchestrator services for Hot Standby configuration

1. Open an SSH terminal session to the Legacy Orchestrator designated as the preferred active site on port 2200.
2. Log in as the skylight user.
3. Configure the preferred site to the last active site, enter:

redundancy config preferred {site-a | site-b}

4. Start the Hot Standby process by entering:

redundancy control start

5. Verify redundancy status, enter:

redundancy show status