Executar uma descoberta de convidados

Este documento descreve as etapas para executar os diferentes métodos de descoberta de convidados fornecidos pela CLI mcdc.

Visão geral

A descoberta de convidados permite verificar e coletar dados sobre os aplicativos em execução nas máquinas, incluindo instâncias de máquina virtual (VM) e servidores físicos. Ele também coleta dados sobre a configuração da máquina, hardware, rede, além de arquivos, serviços e processos abertos.

Para máquinas em execução em plataformas que não oferecem suporte à descoberta de inventário da CLI do discovery client da Central de migração, como VMs em execução no Azure ou máquinas em execução no local, bem como para uma avaliação completa de VMs em execução no VMware e na AWS, é possível executar uma descoberta de convidado. A descoberta de convidados usa um script de coleta de convidados para coletar dados sobre a máquina e gravar esses dados em um arquivo tar de coleta de convidados para máquinas Linux ou um arquivo ZIP para máquinas Windows.

A máquina que hospeda a CLI mcdc faz upload do script para a máquina de destino, o executa e faz o download dos resultados. É possível executar o script localmente na máquina de destino ou remotamente. Dependendo da sua infraestrutura, você pode usar a CLI mcdc das seguintes maneiras:

• Para VMs do Linux e do Windows implantadas no VMware, a CLI mcdc oferece suporte à execução remota com o comando discover vsphere.
• Para máquinas Linux acessíveis pela CLI mcdc, é possível realizar uma descoberta remota usando SSH com o comando discover ssh.
• Para máquinas Windows acessíveis pela CLI mcdc, é possível realizar uma descoberta remota usando a Instrumentação de Gerenciamento do Windows (WMI, na sigla em inglês) com o comando discover wmi.
• Para máquinas Linux e Windows sem conexão com a CLI mcdc, é possível fazer o download e executar os scripts de coleta de convidados localmente e, em seguida, importar manualmente os dados coletados para a máquina que hospeda a CLI mcdc.

O script de coleta de convidados executa uma série de comandos para coletar informações sobre a máquina de origem e também coleta informações de vários arquivos na máquina.

Importante: a CLI mcdc pode coletar dados potencialmente sensíveis, como argumentos de linha de comando, informações de rede ou variáveis de ambiente e argumentos em processos em execução. Dados sensíveis, como informações de identificação pessoal (PII), nunca são enviados ao Google ou a terceiros. Os dados permanecem na máquina em que são coletados durante a execução da CLI mcdc.

Antes de começar

1. Confira os requisitos para fazer o download e executar a CLI do mcdc.
2. Revise os requisitos para fazer o download e executar os scripts de coleta de convidados.
3. Siga as etapas para fazer o download da CLI mcdc.

Coletar dados remotamente usando ferramentas VMware

Para VMs hospedadas no vSphere, a CLI mcdc pode usar ferramentas do VMware para implantar e executar os scripts de coleta remotamente em VMs do Linux e do Windows. Ao usar as ferramentas VMware, a ferramenta CLI mcdc faz o seguinte:

• Faz o upload do script de coleta para a VM.
• Executa o script na VM.
• Faz o download e importa os resultados.

Dois conjuntos de credenciais são necessários para coletar dados remotamente:

• O nome de usuário do servidor vCenter transmitido à CLI mcdc para se conectar ao vSphere, que precisa ter os seguintes privilégios na VM:
  • Modificar operação de convidado
  • Executar programa de operação de convidado
  • Consultas de operação de convidado
• Credenciais do usuário da VM:
  • No Windows, você precisa ter privilégios de administrador.
  • No Linux, o acesso raiz não é obrigatório, mas permite que a CLI mcdc colete os dados necessários para uma avaliação completa.

Para coletar dados usando ferramentas do VMware, siga estas etapas:

1. Faça login na VM do Linux que hospeda a CLI mcdc.
2. Mude para o diretório em que você fez o download da CLI mcdc.
3. Confira se a VM está ligada.

4. Execute a descoberta de convidado:

   Linux

   ./mcdc discover vsphere guest --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER VM_ID

   Windows

   mcdc.exe discover vsphere guest --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER VM_ID

   Substitua:

   • VCENTER_USER: o usuário do servidor vCenter
   • VM_USER: o usuário da VM
   • VM_ID: o nome da VM ou MOREF
   Importante: se o cluster do vSphere tiver vários data centers, use a flag --dc para especificar o nome do data center.

5. Quando solicitado, insira a senha de VCENTER_USER e VM_USER.

Para coletar dados de várias VMs do vSphere em paralelo usando ferramentas do VMware, siga estas etapas:

Importante: todas as VMs de que você quer coletar dados precisam ter o mesmo nome de usuário e senha. Se você tiver credenciais separadas para as VMs do Windows ou Linux, selecione um sistema operacional usando a flag --os-family.

1. Faça login na VM do Linux que hospeda a CLI mcdc.
2. Mude para o diretório em que você fez o download da CLI mcdc.
3. Verifique se todas as VMs estão ativas.

4. Execute a descoberta de convidado:

   Linux

   ./mcdc discover vsphere guest all --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER --timeout TIMEOUT_IN_SECONDS

   Windows

   mcdc.exe discover vsphere guest all --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER --timeout TIMEOUT_IN_SECONDS

   Substitua TIMEOUT_IN_SECONDS pelo tempo limite em segundos.

   Opcionalmente, limite a descoberta apenas a VMs do Windows ou Linux usando a flag --os-family ou mude o nível de paralelismo usando a flag --max-parallelism.

5. Quando solicitado, insira a senha de VCENTER_USER e VM_USER.

6. Também é possível definir o escopo da descoberta para VMs específicas usando a flag --path, conforme descrito no VMware em Executar uma descoberta de inventário.

É possível exportar e avaliar esses dados coletados on-line na Central de migração ou executar uma avaliação off-line.

Coletar dados remotamente por SSH

Se a máquina que hospeda a CLI mcdc tiver acesso SSH à máquina Linux de destino (as máquinas Windows não são compatíveis), a CLI mcdc poderá se conectar à máquina de destino por SSH para coletar dados.

Ao usar o SSH, a CLI mcdc faz o seguinte:

1. Faz o upload do script de coleta para a máquina.

2. Executa o script na máquina com as credenciais de usuário da máquina transmitidas para a CLI mcdc.

   Observação: embora as credenciais do usuário da máquina não exijam acesso raiz, o acesso raiz permite que a CLI mcdc colete todos os dados de avaliação.

3. Faz o download e importa os resultados.

Modos de SSH compatíveis

Se você estiver usando a CLI mcdc em uma máquina Linux, é possível usar dois modos para executar o SSH:

• Padrão:usa o binário ssh e as configurações na máquina da CLI mcdc. O modo padrão pode usar os arquivos de configuração SSH local por padrão, como ~/.ssh/config e ~/.ssh/known_hosts, da estação de trabalho que o hospeda.

  Digite a senha quando solicitado ou use sshpass para transmitir a senha ou a senha longa do arquivo de chave privada na linha de comando. Exemplo:

  sshpass -p password mcdc discover ssh IP_ADDRESS
  

  Substitua IP_ADDRESS pelo endereço IP da máquina.

• Incorporado:usa a biblioteca SSH integrada. Esse modo permite que você use o cliente SSH incorporado se o modo padrão não funcionar corretamente no seu ambiente. No entanto, ele não usa os arquivos de configuração do SSH local por padrão. É possível usar a flag -i para especificar um arquivo de chave privada SSH.

Se você estiver usando a CLI mcdc em uma máquina Windows, somente o modo embedded será aceito.

Executar a coleção

Para coletar dados por SSH, siga estas etapas:

1. Faça login na máquina Linux que hospeda a CLI mcdc.
2. Mude para o diretório em que você fez o download da CLI mcdc.

3. Coletar dados:

   Linux

   ./mcdc discover ssh IP_HOSTNAME

   Windows

   mcdc.exe discover ssh IP_HOSTNAME

   Substitua IP_HOSTNAME pelo nome do host IP da máquina.

4. O arquivo de chave privada SSH do usuário que invoca a CLI mcdc é usado para autenticação SSH.

   Quando solicitado, digite o nome de usuário de uma conta na máquina Linux. O script de coleta é executado usando essas credenciais. Se a chave privada SSH do usuário que invoca a CLI mcdc não conseguir autenticar na máquina com o nome de usuário, uma senha também será solicitada.

Outros cenários ao usar o SSH

Confira os seguintes cenários em que talvez seja necessário modificar o comando:

• Para especificar o usuário da máquina com o modo padrão, use a flag -u:

  Linux

  ./mcdc discover ssh -u USER IP_HOSTNAME

  Windows

  mcdc.exe discover ssh -u USER IP_HOSTNAME

  Substitua USER pelo usuário da máquina.

  Quando solicitado, digite a senha do usuário.

• Para especificar o modo detalhado, use a flag -v:

  Linux

  ./mcdc discover ssh -u USER -v IP_HOSTNAME

  Windows

  mcdc.exe discover ssh -u USER -v IP_HOSTNAME

• Para especificar o arquivo de chave privada SSH, use a flag -i. Por exemplo, para especificar .ssh/my_private_key:

  Linux

  ./mcdc discover ssh -i ~/.ssh/my_private_key -u USER IP_HOSTNAME

  Windows

  mcdc.exe discover ssh -i ~/.ssh/my_private_key -u USER IP_HOSTNAME

• Para especificar a senha na linha de comando, use o modo incorporado:

  Linux

  ./mcdc discover ssh --ssh-client embedded -u USER --passphrase PASSWORD IP_HOSTNAME

  Windows

  mcdc.exe discover ssh --ssh-client embedded -u USER --passphrase PASSWORD IP_HOSTNAME

  Como a forma incorporada do comando não usa os arquivos de configuração SSH locais por padrão, verifique se o usuário especificado no comando pode acessar a máquina por SSH e tem privilégios na máquina para executar o script de coleta.

• Para especificar o arquivo de chave privada SSH com o modo incorporado, use a flag -i:

  Linux

  ./mcdc discover ssh --ssh-client embedded -i ~/.ssh/id_rsa -u USER --password PASSWORD IP_HOSTNAME

  Windows

  mcdc.exe discover ssh --ssh-client embedded -i ~/.ssh/id_rsa -u USER --password PASSWORD IP_HOSTNAME

• O comando da CLI mcdc permite especificar a maioria das flags do SSH. Em seguida, ele transmite essas flags para o comando ssh usando a flag -a ou --ssh-args. Por exemplo, para usar um proxy socks:

  Linux

  ./mcdc discover ssh -u USER -a '-o' -a 'ProxyCommand=nc -X 5 -x 127.0.0.1:proxy port %h %p' IP_HOSTNAME

  Windows

  mcdc.exe discover ssh -u USER -a '-o' -a 'ProxyCommand=nc -X 5 -x 127.0.0.1:proxy port %h %p' IP_HOSTNAME

É possível exportar e avaliar esses dados coletados on-line na Central de migração ou executar uma avaliação off-line.

Coletar dados remotamente por WMI

Se você quiser realizar uma descoberta de convidados em uma máquina Windows de destino com suporte a WMI, use o comando mcdc discover wmi na máquina Windows que hospeda a CLI mcdc. A coleção WMI tem suporte apenas na versão do Windows da CLI mcdc.

Ao usar o WMI, a CLI mcdc faz o seguinte:

1. Faz o upload do script de coleta para a máquina.

2. Executa o script na máquina com as credenciais de usuário da máquina transmitidas para a CLI mcdc.

   Observação: embora as credenciais do usuário da máquina não exijam direitos de administrador, o acesso raiz permite que a CLI mcdc colete todos os dados de avaliação.

3. Faz o download e importa os resultados.

Para coletar dados pelo WMI, siga estas etapas:

1. Faça login na máquina Windows que hospeda a CLI do mcdc.
2. Mude para o diretório em que você fez o download da CLI mcdc.

3. Coletar dados:

   mcdc.exe discover wmi IP_HOSTNAME
   

   Substitua IP_HOSTNAME pelo nome do host IP da máquina.

4. Insira suas credenciais quando solicitado.

Coletar dados em uma máquina Linux individual

Para realizar uma coleta de convidados localmente em uma máquina Linux, execute o script mcdc-linux-collect.sh. Em seguida, copie o arquivo tar gerado pelo script para a máquina que hospeda a CLI mcdc e importe-o com o comando discover import.

Normalmente, o script é executado especificando a opção sudo. Opcionalmente, é possível executar o script usando os privilégios do usuário que está executando a CLI mcdc. No entanto, talvez o script não consiga coletar todos os dados necessários.

1. Faça login na máquina.
2. Mude para o diretório em que você fez o download do script de coleta de convidados.

3. Execute o script de coleta na máquina:

   sudo ./mcdc-linux-collect.sh
   

   O script gera um arquivo .tar chamado mcdc-collect-MACHINE_NAME-TIMESTAMP.tar para o diretório atual. O carimbo de data/hora está no formato YYYY-MM-DD-hh-mm.

   Clique para conferir o formato do arquivo tar da coleção de convidados

   O arquivo tar tem o seguinte formato:

   collect.log # Log output of the script
    files # Directory containing files with their full path from root. For example:
      |- etc/fstab
      |- etc/hostname
      |- etc/network/interfaces
      |- ...
    commands # Output of commands run by the script:
      |- dpkg
      |- netstat
      |- ps
      |- ...
    found_paths # Text file with the list of installation directories
    machinename # Text file with machine name
    ostype # Text file with operating system type (Linux)
    timestamp # Text file with collection timestamp
    version # Text file with the version of the script
    

   Opcionalmente, é possível transmitir o argumento --output e especificar o caminho em que você quer salvar o arquivo tar.

4. Copie os dados coletados da máquina de destino para a máquina host.

5. Importe os dados coletados na máquina host:

   Linux

   ./mcdc discover import PATH_TO_TAR

   Windows

   mcdc.exe discover import PATH_TO_TAR

   Substitua PATH_TO_TAR pelo caminho para o arquivo tar.

É possível exportar e avaliar esses dados coletados on-line na Central de migração ou executar uma avaliação off-line.

Coletar dados em uma máquina Windows individual

Para realizar uma coleta de convidados localmente em uma máquina Windows, execute o script mcdc-windows-collect.ps1. Em seguida, copie o arquivo ZIP gerado pelo script na máquina que hospeda a CLI mcdc e importe-o com o comando discover import.

1. Faça login na máquina.
2. Abra o PowerShell usando a opção Executar como administrador.
3. Mude para o diretório em que você fez o download da CLI mcdc.

4. Execute o script de coleta na máquina:

   powershell -ExecutionPolicy ByPass -File .\mcdc-windows-collect.ps1
   

5. O script gera um arquivo ZIP chamado mcdc-collect-MACHINE_NAME-TIMESTAMP.zip para o diretório atual.

   Como alternativa, é possível incluir um caminho de saída para especificar um local diferente:

   .\mcdc-windows-collect.ps1 PATH_FOR_OUTPUT.zip
   

6. Importe os dados coletados na máquina host:

   Linux

   ./mcdc discover import PATH_TO_TAR

   Windows

   mcdc.exe discover import PATH_TO_TAR

   Substitua PATH_TO_TAR pelo caminho para o arquivo tar.

É possível exportar os dados coletados e avaliá-los on-line na Central de migração ou executar uma avaliação off-line.

A seguir

• Saiba como executar uma verificação de intervalo de IP.
• Saiba como exportar dados coletados para o Migration Center.