Download Migration Center discovery client CLI

To discover your assets, you need to download the Migration Center discovery client CLI to a machine that has access to all your target assets. The machine can be a physical server or a virtual machine (VM) instance. The mcdc CLI executable is available in two versions, Linux and Windows (Preview), depending on the OS of the machine where you want to install it.

The mcdc CLI performs the guest discovery by running collection scripts remotely on your target machines from the machine where it is installed. It can also find and collect data from multiple machines using the IP range scan. You can run a guest discovery on VMs running on VMware, and on machines with a connection to the machine hosting the mcdc CLI.

Alternatively, to perform a discovery on VMs hosted on AWS and Azure, or on your on-premises machines without SSH access, you need to download the guest collection script and run it locally. Use mcdc-linux-collect.sh on Linux machines and mcdc-windows-collect.ps1 on Windows machines.

This document describes how to download the mcdc CLI and the collection scripts to discover and collect your infrastructure data.

Before you begin

Download mcdc CLI

Depending on the OS of the machine, download the Linux or Windows executable of the mcdc CLI.

Linux

  • Download the latest version of the mcdc CLI on a Linux machine and make it executable:
curl -O "https://mcdc-release.storage.googleapis.com/$(curl -s https://mcdc-release.storage.googleapis.com/latest)/mcdc"
chmod +x mcdc

Windows

  • To download the latest version of the mcdc CLI on a Windows machine with Powershell and Invoke-WebRequest:
$ProgressPreference = 'SilentlyContinue'; $version = Invoke-RestMethod -Uri 'https://mcdc-release.storage.googleapis.com/latest'; Invoke-WebRequest -Uri  "https://storage.googleapis.com/mcdc-release/$($version.Trim())/windows/mcdc.exe" -OutFile mcdc.exe
  • To download the latest version of the mcdc CLI on a Windows machine with Command Prompt and curl:
for /f usebackq %V in (`curl -s https://mcdc-release.storage.googleapis.com/latest`) do curl -O https://mcdc-release.storage.googleapis.com/%V/windows/mcdc.exe
  • To download the latest version of the mcdc CLI with a direct link:
https://mcdc-release.storage.googleapis.com/2.1.0/windows/mcdc.exe

View help information for mcdc CLI

  • To view help information for the mcdc CLI, use the --help flag:

    Linux

    ./mcdc --help

    Windows

    mcdc.exe --help

  • To view help for a specific command, use the --help flag with the command. For example, to view help for the import command, run the following command:

    Linux

    ./mcdc discover import --help

    Windows

    mcdc.exe discover import --help

Download guest collection scripts

To download the guest collection scripts on the target machine, perform the steps in the following sections.

Download guest collection script on a Linux machine

On a Linux machine, to download mcdc-linux-collect.sh, follow these steps:

  1. Log in to the machine.

  2. Download the guest collection script to the machine and make it executable:

    curl -O "https://mcdc-release.storage.googleapis.com/$(curl -s https://mcdc-release.storage.googleapis.com/latest)/mcdc-linux-collect.sh"
chmod +x mcdc-linux-collect.sh

Download guest collection script on a Windows machine

On a Windows machine, to download mcdc-windows-collect.ps1, follow these steps:

  1. Log in to your machine and open PowerShell.

  2. Download the guest collection script to the machine:

    $version = Invoke-WebRequest -UseBasicParsing https://mcdc-release.storage.googleapis.com/latest
$WebClient = New-Object System.Net.WebClient
$WebClient.DownloadFile("https://mcdc-release.storage.googleapis.com/"+$version+"/mcdc-windows-collect.ps1", (Get-Location).Path + "\mcdc-windows-collect.ps1")

What's next