Migrating Enterprise Manager from Windows to Linux

You can migrate Enterprise Manager from a Microsoft Windows-based machine to a Linux-based machine. To perform the migration, back up the Enterprise Manager configuration database and restore it to the Linux machine where Enterprise Manager is already deployed.

Enterprise Manager migration preserves existing Enterprise Manager configurations including notification settings, Enterprise Manager accounts and roles, retention settings for index files and event history, self-service configurations for the Veeam Self-Service Backup Portal and vSphere Self-Service Backup Portal, SAML authentication settings, directory account settings, key management settings and encryption keys.

Before You Begin

Before you migrate the Enterprise Manager configuration database from a Microsoft Windows-based machine to a Linux-based, consider the following:

• Enterprise Manager of the same build must be installed on both the Microsoft Windows and Linux machines. For deployment instructions, see Enterprise Manager Deployment on Linux and Enterprise Manager Deployment on Windows.
• The Microsoft Windows installation of Enterprise Manager must use PostgreSQL as its configuration database. If the database is based on Microsoft SQL Server, first migrate it to PostgreSQL. For details, see Migrating Enterprise Manager from Microsoft SQL Server to PostrgeSQL.

• PostgreSQL must be set up and running on the source and target machines.

• Data that Enterprise Manager collects from backup servers (such as backup jobs, session logs, backed-up objects and so on) is not migrated. This data will be collected again after the first data collection run after migration. For details, see Collecting Data from Backup Servers.

• After you successfully migrate Enterprise Manager to Linux, local Microsoft Windows users will not be migrated (local Microsoft Windows groups may appear but cannot be used on Linux). Domain Active Directory users and groups will be preserved if Veeam Software Appliance is joined to the same Active Directory domain. The veeamadmin account will be automatically assigned the Enterprise Manager Administrator role.

Performing Migration

To migrate Enterprise Manager from Microsoft Windows to Linux, you can use the Enterprise Manager Database Migration utility. The utility supports both local (when the database is located on the same machine with Enterprise Manager) and remote PostgreSQL databases (when the database is located on another machine).

The Enterprise Manager Database Migration utility comes with Veeam Backup Enterprise Manager and is located on the Enterprise Manager server in the installation folder. The default path is the following:

• On Microsoft Windows-based machine:

• On Linux-based machine:

To migrate Enterprise Manager, follow these steps:

1. On the Microsoft Windows machine, back up the Enterprise Manager configuration database to an EMCO backup file. To create a configuration backup, use the Veeam.EM.DB.Migration.exe application. The utility requires access to the registry so you must run the command-line shell as administrator. In addition, make sure that the account that you specify to authenticate against a PostgreSQL server is a superuser.

2. Transfer the backup file to the Linux machine where Enterprise Manager is deployed as part of Veeam Software Appliance:

1. To enable SSH connection on the Linux machine, use Veeam Host Management. For details, see Configuring Remote Access Settings.
2. To transfer the backup file, you can run, for example, the scp command on the Microsoft Windows machine:

3. Restore the configuration database on the Linux machine:

1. To request root access on the Linux machine, use Veeam Host Management. For details, see Configuring Remote Access Settings.
2. To restore the configuration database from the backup file, run the Veeam.EM.DB.Migration.dll application with the dotnet command:

4. Update the configuration database name in the configuration file /etc/veeam/veeam_backup_reporting.conf:

5. To apply the changes, restart all Enterprise Manager services using Veeam Host Management. For details, see Performing Maintenance Tasks.
6. To enable Enterprise Manager to collect data from added backup servers, re‑enter credentials for each added backup servers. For details, see Editing Backup Servers.

Utility Parameters

The table below describes the Veeam.EM.DB.Migration parameters that you can use to migrate Enterprise Manager from Microsoft Windows to Linux.