How to Migrate Veeam ONE Deployment

This article documents the procedure for migrating Veeam ONE to a different machine.

This can be useful if:

• The machine where Veeam ONE is currently installed runs an OS that is no longer supported by the version of Veeam ONE you plan to upgrade to.
• Your existing Veeam ONE deployment shares a machine with another Veeam product, and you'd like to migrate Veeam ONE to a dedicated machine (which is recommended).

Preparation

Before you begin any migration:

• Check System Requirements for the new Veeam ONE machine.
  
• Ensure the new machine where Veeam ONE will be installed has all the latest Windows updates.
  
• If the migration will involve migrating the Veeam ONE database to a dedicated SQL server, ensure that the SQL server is running a compatible version of Microsoft SQL.

Part 3: Finalizing Migration

9. Update all credentials in Veeam ONE
   After deploying Veeam ONE on the new machine, reusing the database from the old Veeam ONE deployment, all credentials stored in Veeam ONE must be updated. The credentials are stored in the Veeam ONE database in such a way that they can only be decrypted by the Veeam ONE server that stored them in the database, meaning all credentials become invalid after migrating Veeam ONE to the new machine.
   1. Launch the Veeam ONE Client.
   2. Open the Credentials Manager
   3. Edit each credential and update the password.
10. Reinitialize Connection to Veeam ONE Agents on Veeam Backup & Replication Servers
    After the migration, the existing Veeam ONE Agents deployed on monitored Veeam Backup & Replication servers will still be configured to connect to the old Veeam ONE server. To correct this, either:
    • Use the Repair Agent option to attempt to repair the Veeam ONE Agent deployment.
    • Use the Remove Agent option to uninstall the Veeam ONE Agent on the Veeam Backup & Replication server, then use the Install Agent option to redeploy it.
    • Connect to the Veeam Backup & Replication server and uninstall the Veeam ONE Agent, then use the Install Agent option within the Veeam ONE Client to redeploy it.
11. (Optional) If the Veeam ONE deployment on the old machine had custom registry values set; recreate them on the new machine.
    
    Note: The Veeam Support team recommends only moving over custom registry values that you're sure you need. If you are unsure, please create a support case and include an exported copy of the registry keys below from the old machine.
    
    Compare the values within the following keys to check for customized settings that may need to be migrated:
    • HKLM\SOFTWARE\Veeam\Reporter Enterprise\
    • HKLM\SOFTWARE\Veeam\Veeam ONE\
    • HKLM\SOFTWARE\Veeam\Veeam ONE Monitor\
12. (Skip if using an All-in-One Deployment) If the Veeam ONE deployment you were migrating was a custom distributed deployment, where the Veeam ONE Web Services are installed on a different machine, you must uninstall and reinstall the Veeam ONE Web Services components and specify the new machine's information to reconnect the Web Service and Server Components.
13. Restart the new Veeam ONE machine.