Skip to content

Migrating Management Console to a new server

This guide will help you migrate Management Console to the new machine preserving its configuration. Migrated Console retains agents, jobs and job runs, profiles, groups, users and all related parameters from the old Console.

Management Console's Agent

This procedure applies to the Management Console only and does not apply to the Management Console's Agent and its jobs. If you need to migrate Management Console's Agent, contact Resilio support.

Prerequisites

In order to perform a successful migration, the following conditions must be met:

  • Management Console on the new location must use the same IP address or DNS name as the old one (whichever was used for the old Management Console). Otherwise, the agents won't be able to connect to it as they will be attempting to connect by the old address. If you cannot preserve the original IP address or DNS name:

    • If agents were connected to the console using sync.conf file, their configuration files shall be updated with the new address. Use the old Management Console to set the new IP address or a DNS name. For details, see Updating Agent Configuration File.
    • If agents were connected using the Management Console's IP address (over Agent UI on Windows or using the --server option on Linux), is it required to enter the location of the new Management Console on each agent manually.

  • New Management Console must have same version.** If you plan to upgrade Management Console, fully complete the migration first.

Migration to a different OS is supported.

Migration does not reset administrators or their credentials. For details on resetting user's password, see Failed Login And Resetting Password In Resilio Management Console.

Migrate the Management Console

To migrate your Management Console:

  1. Install a clean Management Console on a new machine.
  2. Stop the Management Console service on the new machine.
  3. If the MC storage was encrypted on the old server (for versions 3.6 and newer), copy the encryption key (environment variable value) to the new server and set it up the same way.

  4. On the old Managment Console, select Settings > Backups, the click Backup now to create the latest backup:

    Migrating Mc Backup

  5. Stop Management Console service on the old machine.

  6. Copy latest backup located in data/server_backup of the storage folder from an old machine to the data/server_backup of the storage folder on a new machine.

    Note

    If the server_backup folder does not exist on the new machine, create it manually.

  7. Start the Management Console service on a new machine and log in. You will have to set up the console as if it was the new installation: create a temporary user and upload your license.

  8. Restore the backup on a new machine.

    Migrating Mc Restore

  9. Management console service will restart. Reload the page, login with any old (restored) user's credentials, confirm the console's state is restored. Temporary user is deleted. Old management console can be discarded.