Migrating from Docker to Docker
  • 31 Oct 2024
  • 9 Minutes to read
  • Contributors
  • PDF

Migrating from Docker to Docker

  • PDF

Article summary

Preparing to Migrate

This procedure contains instructions on how to migrate from one of the following releases:

  • Legacy orchestrator Docker 24.09 (old operating system version: Ubuntu 20.04/Red Hat 8.8) to the Legacy orchestrator Docker 24.09 (new operating system version: Ubuntu 22.04/Red Hat 9.3)


Notes: If Legacy orchestrator Docker is running a previous version, the system needs to be upgraded to the 24.09 version before starting the migration process.

Legacy orchestrator Docker 24.09 does not support cross-operation system migration between Docker hosts, which means it will NOT allow:

  • Migration from Ubuntu 20.04 to Red Hat 9.3 operating system version
  • Migration from Red Hat 8.8 to Ubuntu 22.04 operating system version


Migration involves setting up a new Legacy orchestrator Docker 24.09 with the new operation system version (target installation) that will be used to import the database configuration of the Legacy orchestrator Docker 24.09 with the old operating system version (source installation). This requires, at a minimum:

  • The deployment of the Legacy orchestrator 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 Legacy orchestrator 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 Legacy orchestrator Dockers is beyond the scope of this article. These procedures are already captured in the Docker Deployment article and should be used in the preparation for your migrating activity. The important point to consider while installing your Legacy orchestrator 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.

Please consult your sales engineer if you need guidance on the profile to choose for your Legacy orchestrator 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 Legacy orchestrator 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. Transferring all resync DAT files on each mediation folder to your target installation
  4. Transferring the performance session data to your target installation
  5. Importing the database backup into the target installation
  6. Starting up the software on your target installation.


Note: In redundant deployments, these steps are only required on the preferred appliance.

Migration Procedure

Source Installation Procedures

Precondition

On the source installation, ensure that the Internal License Server key needs to be added before performing the migration process.


Note: From release 23.04, all activation keys are preinstalled by default on Legacy orchestrator. Skip procedure below if using Legacy orchestrator 23.04.

To import an Internal License Server key

  1. Obtain the appropriate key file from Technical Support.
  2. Save the key file on the local file system (for example, on the desktop) and extract this file.
  3. Access the Admin ▶ Feature Activation page.
  4. Click the Choose File button.
  5. Select the Internal License Server key file on your local file system from the file selector dialog.
  6. Click the Import button.

Backing up the Data Store

In order 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


Notes: On the Non-Hot Standby configuration system, the backup is generated as a tar.gz file in the folder ‘backups’ of the ‘so-mysql’ volume.

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'

If you are rehoming a redundant configuration, the backup must be taken from the active site.


  1. Rename the database backup file to migrate.tar.gz and transfer it to the new Legacy orchestrator Docker (target installation) under the /tmp directory.


Note: If you are migrating a redundant configuration, the file should be transferred to both Legacy orchestrator Dockers of the target installation.

Stopping the Legacy orchestrator Services

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.


Note: If you are migrating a redundant configuration, these steps must be run on the active site.

If you are operating in a Hot Standby configuration

  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

Otherwise

  1. Open an SSH terminal session to the Legacy orchestrator on port 2200.
  2. Log in as the skylight user.
  3. Stop the application by entering:
services stop

Transferring All Resync DAT Files

To preserve the historical performance monitoring data, it must be transferred over to the target installation by following these steps.


Note: If you are migrating a redundant configuration, these steps must be run on the active site.

  1. Open an SSH terminal session to Legacy orchestrator on port 22.
  2. Log in as the skylight user.
  3. Initiate the transfer by entering:
cd <path_of_data_volume_for_mediation1>
rsync -R -v medn1instance/s*/datfiles/*/*_RESYNC.* skylight@<ip_docker_host>:<path_of_data_volume_for_mediation1>

cd <path_of_data_volume_for_mediation2>
rsync -R -v s*/datfiles/*/*_RESYNC.* skylight@<ip_docker_host>:<path_of_data_volume_for_mediation2>

cd <path_of_data_volume_for_mediation3>
rsync -R -v s*/datfiles/*/*_RESYNC.* skylight@<ip_docker_host>:<path_of_data_volume_for_mediation3>

cd <path_of_data_volume_for_mediation4>
rsync -R -v s*/datfiles/*/*_RESYNC.* skylight@<ip_docker_host>:<path_of_data_volume_for_mediation4>

cd <path_of_data_volume_for_mediation5>
rsync -R -v s*/datfiles/*/*_RESYNC.* skylight@<ip_docker_host>:<path_of_data_volume_for_mediation5>

cd <path_of_data_volume_for_mediation6>
rsync -R -v s*/datfiles/*/*_RESYNC.* skylight@<ip_docker_host>:<path_of_data_volume_for_mediation6>

If migrating to a redundant configuration, transfer the files over to the virtual appliance that will be used as the preferred site.

Transferring the Performance Session Data

To preserve the historical performance session data, it must be transferred over to the target installation by following these steps.


Note: If you are migrating a redundant configuration, these steps must be run on the active site.

  1. Open an SSH terminal session to Legacy orchestrator on port 22.
  2. Log in as the skylight user.
  3. Initiate the transfer by entering:
cd <path_of_data_volume_for_mediation1>

rsync -av bizn1instance/sdmm skylight@x.x.x.x:/<directory>

Where x.x.x.x is the IP address of the target installation.
Where < directory > is the bizn1instance directory under so-data volume

If migrating to a redundant configuration, transfer the files over to the virtual appliance that will be used as the preferred site.

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, timezone (highly recommended), and so on will be configured manually and same as the configuration on the virtual appliances (source installation) to ensure all devices are reachable on the Legacy orchestrator Docker (target installation). Please refer to the 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 Legacy orchestrator Services

Stopping Hot Standby Process and Legacy orchestrator Services on Hot Standby Configuration

Active Site

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

Stopping Legacy orchestrator Services on Non-Hot Standby Configuration

  1. Open an SSH terminal session to the Legacy orchestrator CLI on port 2200.
  2. Log in as the skylight user.
  3. Stop services by entering:
services stop


Note: If the services are stopped, skip this step.

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 Legacy orchestrator CLI on port 2200.


Note: If you are rehoming a redundant configuration, log into the target installation virtual appliance you have designated to be the preferred active site.

  1. Log in as the skylight user.
  2. Restore the backup by entering:
database restore <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 Legacy orchestrator Services

This procedure will start the application.

Starting the application 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, the site which transferred the files at ‘Transferring All Resync DAT Files’ step, enter:

redundancy config preferred {site-a | site-b}
  1. Start the Hot Standby process by entering:
redundancy control start
  1. Verify redundancy status, enter:
redundancy show status

Starting Legacy orchestrator services on Non-Hot Standby configuration

  1. Open an SSH terminal session to the Legacy orchestrator CLI on port 2200.
  2. Log in as the skylight user.
  3. Start services by entering:
services start

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 and Legacy orchestrator Services on Hot Standby Configuration

Active Site

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

Stopping Legacy orchestrator Services on Non-Hot Standby Configuration

  1. Open an SSH terminal session to the Legacy orchestrator CLI on port 2200.
  2. Log in as the skylight user.
  3. Stop services by entering:
services stop

Source Installation Procedures

This procedure will start the application.

Starting the application 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}
  1. Start the Hot Standby process by entering:
redundancy control start
  1. Verify redundancy status, enter:
redundancy show status

Starting the application for Non-Hot Standby configuration

  1. Open an SSH terminal session to the Legacy orchestrator on port 2200.
  2. Log in as the skylight user.
  3. Start the application by entering:
services start

© 2024 Cisco and/or its affiliates. All rights reserved.
 
For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms

For legal information about Accedian Skylight products, please visit: Accedian legal terms and tradmarks



Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.