Exécuter une détection d'invités

Ce document décrit les étapes à suivre pour exécuter les différentes méthodes de détection d'invités. fournies par la CLI mcdc.

Présentation

La détection d'invités vous permet d'analyser et de collecter des données sur les applications en cours d'exécution sur vos machines, ce qui inclut à la fois des instances de machines virtuelles (VM) et serveurs physiques. Il collecte aussi des données sur la configuration de la machine, le matériel, le réseau, ainsi que les fichiers ouverts, les services et les processus.

Pour les machines s'exécutant sur des plates-formes pour lesquelles la CLI du client de découverte Migration Center ne sont compatibles avec la découverte d'inventaire, comme les VM sur Azure ou sur des machines sur site, des VM exécutées sur VMware et AWS, vous pouvez lancer une détection d'invités. La détection d'invités utilise un script de collecte d'invités pour collecter des données concernant la machine. et écrit ces données dans un fichier TAR de collection "invité" pour les machines Linux pour les machines Windows.

La machine qui héberge la CLI mcdc importe le script sur la machine cible, l'exécute, puis télécharge les résultats. Vous pouvez exécuter le script localement sur la machine cible ou à distance. En fonction de votre infrastructure, vous pouvez choisir d'utiliser la CLI mcdc comme suit:

• Pour les VM Linux et Windows déployées sur VMware, la CLI mcdc prend en charge l'exécution à distance avec la commande discover vsphere.
• Pour les machines Linux accessibles via la CLI mcdc, vous devez peuvent effectuer une détection à distance à l'aide de SSH à l'aide de la commande discover ssh.
• Pour les machines Windows accessibles par la CLI mcdc, vous pouvez effectuer une découverte à distance à l'aide de Windows Management Instrumentation (WMI) avec la commande discover wmi.
• Pour les machines Linux et Windows sans connexion à la CLI mcdc, vous pouvez télécharger et exécuter les scripts de collecte invités localement, puis importer manuellement les données collectées sur la machine hébergeant la CLI mcdc.

Le script de collecte des invités exécute une série de commandes pour recueillir des informations sur la machine source et collecte également des informations à partir de plusieurs fichiers sur la machine.

Important :La CLI mcdc peut collecter des données données sensibles telles que les arguments de ligne de commande, les informations réseau, ou des variables d'environnement et des arguments dans les processus en cours d'exécution. Les données sensibles, telles que les informations permettant d'identifier personnellement l'utilisateur, sont jamais envoyées à Google ni à un autre tiers. Les données restent sur la machine sur laquelle elles sont collectées pendant l'exécution de la CLI mcdc.

Avant de commencer

1. Consultez les conditions requises pour télécharger et exécuter la CLI mcdc.
2. Consultez les conditions requises pour télécharger et exécuter les scripts de collecte d'invités.
3. Suivez la procédure pour télécharger la CLI mcdc.

Collecter les données à distance à l'aide des outils VMware

Pour les VM hébergées sur vSphere, la CLI mcdc peut utiliser VMware des outils pour déployer et exécuter les scripts de collecte à distance sous Linux et VM Windows. Lorsque vous utilisez les outils VMware, l'outil CLI mcdc :

• importe le script de collecte sur la VM ;
• Exécute le script sur la VM.
• télécharge et importe les résultats.

Deux ensembles d'identifiants sont requis pour collecter des données à distance :

• Le nom d'utilisateur du serveur vCenter transmis à la CLI mcdc pour se connecter à vSphere, qui doit disposer des droits suivants sur la VM :
  • Modifications d'opération d'invité
  • Exécution du programme d'opération d'invité
  • Requêtes concernant les opérations d'invités
• Identifiants utilisateur pour la VM :
  • Sous Windows, vous devez disposer des droits d'administrateur.
  • Sous Linux, l'accès root n'est pas requis, mais l'accès root permet mcdc afin de collecter les données requises pour une terminer l'évaluation.

Pour collecter des données à l'aide des outils VMware, procédez comme suit:

1. Connectez-vous à la VM Linux hébergeant la CLI mcdc.
2. Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.
3. Assurez-vous que la VM est allumée.

4. Exécutez la détection d'invités :

   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

   Remplacez les éléments suivants :

   • VCENTER_USER : utilisateur du serveur vCenter
   • VM_USER : utilisateur de la VM
   • VM_ID: nom de la VM ou MOREF
   Important : Si le cluster vSphere comporte plusieurs centres de données, vous devez utiliser l'indicateur --dc pour spécifier le nom du centre de données.

5. Lorsque vous y êtes invité, saisissez le mot de passe pour VCENTER_USER et VM_USER.

Pour collecter les données de plusieurs VM vSphere en parallèle à l'aide d'outils VMware, procédez comme suit:

Important : Toutes les VM que vous souhaitez collecter doivent avoir le même nom d'utilisateur et le même mot de passe. Si vous avez des identifiants distincts pour vos VM Windows ou Linux, vous pouvez sélectionner un système d'exploitation à l'aide de l'option --os-family.

1. Connectez-vous à la VM Linux hébergeant la CLI mcdc.
2. Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.
3. Assurez-vous que toutes les VM sont sous tension.

4. Exécutez la détection d'invités :

   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

   Remplacez TIMEOUT_IN_SECONDS par le délai avant expiration en secondes.

   Vous pouvez éventuellement limiter la découverte aux seules VM Windows ou Linux à l'aide de l'option --os-family, ou modifier le niveau de parallélisme à l'aide de l'option --max-parallelism.

5. Lorsque vous y êtes invité, saisissez le mot de passe pour VCENTER_USER et VM_USER.

6. Vous pouvez également limiter la découverte à des VM spécifiques à l'aide de la classe --path, comme décrit pour VMware dans Exécuter une découverte d'inventaire.

Vous pouvez exporter et évaluer ces données collectées en ligne dans le centre de migration, ou exécuter une évaluation hors connexion.

Collecter les données à distance via SSH

Si la machine hébergeant la CLI mcdc dispose d'un accès SSH à la machine Linux cible (les machines Windows ne sont pas prises en charge), alors La CLI mcdc peut se connecter à la machine cible via SSH pour à collecter des données.

Lorsque vous utilisez SSH, la CLI mcdc effectue les opérations suivantes:

1. importe le script de collecte sur la machine ;

2. Exécute le script sur la machine en transmettant les identifiants utilisateur à la CLI mcdc.

   Remarque :Bien que les identifiants d'utilisateur de la machine ne nécessitent pas d'accès root, l'accès root permet à la CLI mcdc de collecter toutes des données d'évaluation.

3. télécharge et importe les résultats.

Modes SSH compatibles

Si vous utilisez la CLI mcdc sur une machine Linux, vous pouvez exécuter SSH de deux manières :

• Par défaut:utilise le binaire ssh et les configurations sur le mcdc. Le mode par défaut peut utiliser la connexion SSH locale de configuration par défaut, tels que ~/.ssh/config et ~/.ssh/known_hosts, de la station de travail qui l'héberge.

  Saisissez le mot de passe lorsque vous y êtes invité ou utilisez sshpass pour le transmettre ou la phrase secrète du fichier de clé privée sur la ligne de commande. Exemple :

  sshpass -p password mcdc discover ssh IP_ADDRESS
  

  Remplacez IP_ADDRESS par l'adresse IP de la machine.

• Intégré : utilise la bibliothèque SSH intégrée. Ce mode vous permet d'utiliser le client SSH intégré si le mode par défaut présente un dysfonctionnement dans votre environnement. Toutefois, il n'utilise pas les fichiers de configuration SSH locaux par défaut. Toi Vous pouvez utiliser l'option -i pour spécifier un fichier de clé privée SSH.

Si vous utilisez la CLI mcdc sur une machine Windows, seul le mode intégré est pris en charge.

Exécuter la collection

Pour collecter des données via SSH, procédez comme suit:

1. Connectez-vous à la machine Linux hébergeant la CLI mcdc.
2. Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.

3. Recueillez des données:

   Linux

   ./mcdc discover ssh IP_HOSTNAME

   Windows

   mcdc.exe discover ssh IP_HOSTNAME

   Remplacez IP_HOSTNAME par le nom d'hôte IP de la machine.

4. Le fichier de clé privée SSH de l'utilisateur appelant la La CLI mcdc est utilisée pour l'authentification SSH.

   Lorsque vous y êtes invité, saisissez le nom d'utilisateur d'un compte sur la machine Linux. Le script de collecte s'exécute en utilisant ces identifiants. Si la clé privée SSH de l'utilisateur appelant la CLI mcdc ne parvient pas à s'authentifier auprès de la machine avec le nom d'utilisateur, vous êtes également invité à saisir un mot de passe.

Autres scénarios d'utilisation de SSH

Consultez les scénarios suivants dans lesquels vous devrez peut-être modifier la commande:

• Pour spécifier l'utilisateur de la machine avec le mode par défaut, utilisez l'option -u:

  Linux

  ./mcdc discover ssh -u USER IP_HOSTNAME

  Windows

  mcdc.exe discover ssh -u USER IP_HOSTNAME

  Remplacez USER par l'utilisateur de la machine.

  Lorsque vous y êtes invité, saisissez le mot de passe de l'utilisateur.

• Pour spécifier le mode détaillé, utilisez l'indicateur -v:

  Linux

  ./mcdc discover ssh -u USER -v IP_HOSTNAME

  Windows

  mcdc.exe discover ssh -u USER -v IP_HOSTNAME

• Pour spécifier le fichier de clé privée SSH, utilisez l'option -i. Par exemple, pour spécifier .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

• Pour spécifier le mot de passe sur la ligne de commande, utilisez le mode intégré :

  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

  Comme la forme intégrée de la commande n'utilise pas les fichiers de configuration SSH locaux par défaut, assurez-vous que l'utilisateur que vous spécifiez dans la commande peut accéder à la machine via SSH et dispose de privilèges sur la machine pour exécuter le script de collecte.

• Pour spécifier le fichier de clé privée SSH avec le mode intégré, utilisez l'indicateur -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

• La commande CLI mcdc vous permet de spécifier la plupart des options SSH. Il transmet ensuite ces options à la commande ssh à l'aide de l'option -a ou --ssh-args. Par exemple, pour utiliser un 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

Vous pouvez exporter et évaluer ces données collectées en ligne dans le centre de migration, ou exécuter une évaluation hors connexion.

Collecter des données à distance via WMI

Si vous souhaitez effectuer une découverte d'invité sur une machine Windows cible avec WMI vous pouvez exécuter la commande mcdc discover wmi sur la machine Windows qui héberge la CLI mcdc. La collection WMI n'est compatible qu'avec la version Windows de la CLI mcdc.

Lorsque vous utilisez WMI, la CLI mcdc effectue les opérations suivantes :

1. Il importe le script de collecte sur la machine.

2. Exécute le script sur la machine en transmettant les identifiants utilisateur. à la CLI mcdc.

   Remarque :Bien que les identifiants de l'utilisateur machine ne nécessitent pas de droits d'administrateur, l'accès root permet à la CLI mcdc de collecter toutes les données d'évaluation.

3. télécharge et importe les résultats.

Pour collecter des données via WMI, procédez comme suit :

1. Connectez-vous à la machine Windows hébergeant la CLI mcdc.
2. Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.

3. Recueillez des données:

   mcdc.exe discover wmi IP_HOSTNAME
   

   Remplacez IP_HOSTNAME par le nom d'hôte IP de la machine.

4. Saisissez vos identifiants lorsque vous y êtes invité.

Collecter des données sur des machines Linux individuelles

Pour effectuer une collecte d'invités localement sur une machine Linux, vous pouvez exécuter le script mcdc-linux-collect.sh. Vous pouvez ensuite copier le fichier tar généré par le script dans la machine héberge la CLI mcdc et importez-la avec la discover import.

Vous exécutez généralement le script en spécifiant l'option sudo. Vous pouvez éventuellement exécuter le script en utilisant les droits de l'utilisateur exécutant la CLI mcdc. Toutefois, il se peut que le script ne puisse pas de collecter toutes les données requises.

1. Connectez-vous à votre machine.
2. Accédez au répertoire dans lequel vous avez téléchargé le script de collecte des invités.

3. Exécutez le script de collecte sur la machine:

   sudo ./mcdc-linux-collect.sh
   

   Le script génère un fichier tar nommé mcdc-collect-MACHINE_NAME-TIMESTAMP.tar vers le répertoire actuel. L'horodatage est au format YYYY-MM-DD-hh-mm.

   Cliquez pour afficher le format de fichier tar de la collecte d'invités

   Le fichier tar a le format suivant :

   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
    

   Vous pouvez également transmettre l'argument --output et spécifier le chemin d'accès où vous souhaitez enregistrer le fichier tar.

4. Copiez les données collectées depuis la machine cible sur la machine hôte.

5. Importez les données collectées sur la machine hôte:

   Linux

   ./mcdc discover import PATH_TO_TAR

   Windows

   mcdc.exe discover import PATH_TO_TAR

   Remplacez PATH_TO_TAR par le chemin d'accès au fichier tar.

Vous pouvez exporter et évaluer les données collectées en ligne dans Migration Center, ou effectuer une évaluation hors connexion.

Collecter des données sur une machine Windows individuelle

Pour effectuer une collecte d'invités localement sur un ordinateur Windows, vous pouvez exécuter la mcdc-windows-collect.ps1. Vous pouvez ensuite copier le fichier ZIP généré par le script sur la machine qui héberge la CLI mcdc, puis l'importer à l'aide de la commande discover import.

1. Connectez-vous à votre machine.
2. Ouvrez PowerShell à l'aide de l'option Exécuter en tant qu'administrateur.
3. Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.

4. Exécutez le script de collecte sur la machine:

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

5. Le script génère un fichier ZIP nommé mcdc-collect-MACHINE_NAME-TIMESTAMP.zip dans le répertoire actuel.

   Vous pouvez éventuellement inclure un chemin de sortie pour spécifier un emplacement différent :

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

6. Importez les données collectées sur la machine hôte:

   Linux

   ./mcdc discover import PATH_TO_TAR

   Windows

   mcdc.exe discover import PATH_TO_TAR

   Remplacez PATH_TO_TAR par le chemin d'accès au fichier tar.

Vous pouvez exporter les données collectées et les évaluer en ligne dans le centre de migration, ou exécuter une évaluation hors connexion.

Étape suivante

• Découvrez comment effectuer une analyse de plage d'adresses IP.
• Découvrez comment exporter les données collectées vers Migration Center.