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.

Note: In environments where you have hundreds or thousands of VMs, you might already have tools to automate the process of downloading and running the guest collection script on each VM.

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

Before you begin

• Review the requirements for downloading the mcdc CLI

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

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

• 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.

   Note: To generate optimal assessment results, it is recommended that for running a guest discovery, you log in with a user that has administrator rights.

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.

   Note: To generate optimal assessment results, it is recommended that for running a guest discovery, you log in with a user that has administrator rights.

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

• Learn how to discover assets using the following methods:

  • Inventory discovery
  • Guest discovery
  • IP range scan