Executar uma descoberta de convidado

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, o que inclui 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 para as quais a CLI do discovery client do Migration Center não oferecem suporte à descoberta de inventário, como VMs; em execução no Azure ou em máquinas locais, além de uma infraestrutura completa de VMs em execução no VMware e 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 grava os dados em um arquivo tar de coleta de convidado para máquinas Linux ou 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, pode realizar uma descoberta remota usando a Instrumentação de Gerenciamento do Windows (WMI, na sigla em inglês) usando 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 coleta informações de vários arquivos no da máquina.

Importante: a CLI mcdc pode coletar dados 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 ele é coletado 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 o VMware ferramentas para implantar e executar os scripts de coleta remotamente no Linux e ou VMs 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 conecte-se 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 de usuário para a VM:
  • No Windows, você precisa ter privilégios de administrador.
  • No Linux, o acesso raiz não é obrigatório, mas o acesso raiz permite CLI mcdc para coletar os dados necessários para uma concluir a avaliação.

Para coletar dados usando as 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. Verifique 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 que você quiser coletar precisam ter o mesmo nome de usuário e senha. Se você tiver credenciais separadas para VMs do Windows ou do Linux, é possível selecionar um sistema operacional usando a sinalização --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 ligadas.

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 faça uma avaliação off-line.

Coletar dados remotamente por SSH

Se a máquina que hospeda a CLI mcdc tiver acesso SSH a máquina Linux de destino (não há suporte para máquinas com Windows), então o A CLI mcdc pode se conectar à máquina de destino via 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: as credenciais de usuário da máquina não exigem acesso raiz, o acesso raiz permite que a CLI mcdc colete todos dados de avaliação.

3. Faz o download e importa os resultados.

Modos 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 usar o cliente SSH incorporado se o modo padrão não funcionar 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 coleta

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 o script de coleta de dados é executado usando essas credenciais. Se a chave privada SSH de o usuário que está invocando a CLI mcdc não consegue fazer a autenticação à máquina com o nome de usuário, também é necessário inserir uma senha.

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 sinalização -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 sinalização -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 o SSH local de configuração do Terraform por padrão, verifique se o usuário especificado no pode acessar a máquina por SSH e tem privilégios na 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 mcdc da CLI permite especificar a maioria das sinalizações 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 pelo WMI

Se você quiser executar uma descoberta de convidado em uma máquina Windows de destino com WMI use o comando mcdc discover wmi na máquina Windows que hospeda a CLI mcdc. A coleta de WMI é compatível apenas na versão Windows da CLI mcdc.

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

1. Faz upload do script de coleta na 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: as credenciais de usuário da máquina não exigem direitos de administrador, ter acesso raiz permite que a CLI mcdc colete todos os dados da 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 mcdc.
2. Mude para o diretório onde você fez o download do 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 máquinas Linux individuais

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

Normalmente, o script é executado especificando a opção sudo. Também é 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 sua 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 faça uma avaliação off-line.

Coletar dados em uma máquina Windows individual

Para realizar uma coleta de convidado localmente em uma máquina Windows, execute o comando mcdc-windows-collect.ps1. Depois copie o arquivo ZIP gerado pelo script para a máquina que hospeda a CLI mcdc e a importe 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.

Você pode exportar os dados coletados e avaliá-los online em Migration Center ou faça uma avaliação off-line.

A seguir

• Saiba como executar uma verificação de intervalo de IP.
• Saiba como exportar os dados coletados para a Central de migração.