Carbonite Migrate

Carbonite Migrate

You can migrate devices from Device42 using Carbonite Migrate.

User Requirements

The following software must be installed and running on the client computer:

  • Device42 16.10.00+
  • Carbonite Console
  1. After installing the Carbonite Console, please copy the DoubleTake.PowerShell.dll from its install directory (by default in C:\Program Files\Carbonite\Replication\Console) to the root folder of your scripts’ location
  2. PowerShell 5.1: if you are using Windows 10, you already have the necessary version of PowerShell, if you are using Windows 7/8/8.1; please download the Windows Management Framework 5.1 that includes the necessary updates to Windows PowerShell -> Download WMF 5.1
  3. For convenience, you can use PowerShell ISE, which includes a dual screen layout where you can view the script and run it at the same time using a GUI. Run it by pressing the Windows key and typing powershell ise.

If you never ran a PowerShell script before, you will need to perform the following steps:

  • Start Windows PowerShell with the “Run as Administrator” option. Only members of the Administrators group on the computer can change the execution policy.
  • Enable running unsigned scripts by entering Set-ExecutionPolicy RemoteSigned.

Creating a CSV Export for Carbonite Migration

Go to your the D42 main appliance and select Apps > Business Applications from the menu bar.

On the Select Business Application to view page, add a business application or select an existing one from the list. Select Create Migration for Selected Objects item from the Action menu and click the blue lightning button.

Select the Carbonite CSV target for migration from the drop-down list and click  Export.

You will be prompted to save a CSV export file with server information for the migration. Save it to some directory. This file is used to enter server data into the PowerShell script and Carbonite job creation.


  • Install the Carbonite client.
  • Download the D42 Carbonite PowerShell scripts from the Device42 GitHub page.
  • Copy the file C:\Program Files\Carbonite\Replication\Console\DoubleTake.PowerShell.dll to the folder where you unpacked the Carbonite migrations scripts.
  • Now run the script by entering its name from the PowerShell: ./ESX-EVRAMigrationJobScript.ps1.

Enter the required responses when prompted.

You will also be asked to create a replica name which will be the name of the migrated machine on the VMware server and the name appearing in D42. You can use tags such as:

{YYYY} = 4 digit year
{MM} = 2 digit month
{DD} = 2 digit day
{HH} = 2 digit hour

{MN} = 2 digit minutes
{SS} = 2 digit seconds
{MS} = milliseconds
{IP} = Current IP of the VM to be migrated

With these tags you can create unique names, for example entering: “d42-carbonite-[source ip].[YYYYMMDD.HHMNSS]” will create a name equivalent to: “d42-carbonite-[current vm ip].20200412.092311”.

You should answer ‘Yes’ to the question about the vmName.txt file. The script will execute and issue a job id # upon completion.

While the script is running or when it has finished, you will check the job status and modify the D42 device, which was migrated by running the job monitoring script JobMonitorScript.ps1.

Using the Job Monitoring Script

  1. Run the script by entering its name from the PowerShell: ./JobMonitorScript.ps1
  2. Answer questions when prompted similar to the above migration script.
  3. The script will report on the job status of the migration updating every 30 seconds.
  4. Once the job completes and the job fails over (successfully completes), the script will mark the old device as not in service.
  5. A new device which has been migrated over to, should be automatically added with the name you’ve given your replica in the migrate script step: