Exécuter une recherche d'invité

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écouverte d'invités vous permet d'analyser et de collecter des données concernant les applications en cours d'exécution sur vos machines, y compris les instances de machines virtuelles (VM) et les serveurs physiques. Il collecte également 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 exécutées sur des plates-formes pour lesquelles la CLI cliente de découverte du centre de migration n'est pas compatible avec la découverte d'inventaire, telles que les VM exécutées sur Azure ou sur site, ainsi que pour une évaluation complète des VM exécutées sur VMware et AWS, vous pouvez exécuter une détection d'invités. La découverte d'invités utilise un script de collecte d'invités pour collecter des données sur la machine et les écrit dans un fichier tar de collection d'invités pour les machines Linux ou un fichier ZIP pour les machines Windows.

La machine hébergeant la CLI mcdc importe le script dans 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. Selon votre infrastructure, vous pouvez choisir d'utiliser la CLI mcdc de différentes manières:

Pour les VM Linux et Windows déployées sur VMware, la CLI mcdc permet l'exécution à distance à l'aide de la commande discover vsphere.
Pour les machines Linux accessibles via la CLI mcdc, vous pouvez effectuer une découverte à distance en SSH à l'aide de la commande discover ssh.
Pour les machines Windows accessibles via la CLI mcdc, vous pouvez effectuer une recherche à distance à l'aide de Windows Management Instrumentation (WMI) à l'aide de la commande discover wmi.
Pour les machines Linux et Windows qui ne sont pas connectées à la CLI mcdc, vous pouvez télécharger et exécuter en local les scripts de collecte des invités, 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, ainsi que des informations à partir de plusieurs fichiers de la machine.

Avant de commencer

Consultez les conditions requises pour le téléchargement et l'exécution de la CLI mcdc.
Consultez la configuration requise pour télécharger et exécuter les scripts de collection des invités.
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 les outils VMware pour déployer et exécuter les scripts de collecte à distance sur les VM Linux et Windows. Lorsque vous utilisez des outils VMware, l'outil CLI mcdc effectue les opérations suivantes:

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 :

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 racine n'est pas requis, mais il permet à la CLI mcdc de collecter les données requises pour une évaluation complète.

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

Connectez-vous à la VM Linux qui héberge la CLI mcdc.
Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.
Assurez-vous que la VM est sous tension.
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.
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:

Connectez-vous à la VM Linux qui héberge la CLI mcdc.
Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.
Assurez-vous que toutes les VM sont allumées.
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, exprimé en secondes.

Si vous le souhaitez, limitez la détection aux VM Windows ou Linux uniquement à l'aide de l'option --os-family, ou modifiez le niveau de parallélisme à l'aide de l'option --max-parallelism.
Lorsque vous y êtes invité, saisissez le mot de passe pour VCENTER_USER et VM_USER.
Vous pouvez également limiter la détection à des VM spécifiques à l'aide de l'indicateur --path, comme décrit pour VMware dans la section Exécuter une détection d'inventaire.

Vous pouvez exporter et évaluer les données collectées en ligne dans le centre de migration, ou effectuer 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 compatibles), 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:

Importe le script de collecte sur la machine.
Exécute le script sur la machine avec les identifiants de l'utilisateur transmis à la CLI mcdc.

Remarque :Bien que les identifiants de l'utilisateur machine ne nécessitent pas d'accès racine, l'accès à la racine permet à la CLI mcdc de collecter toutes les données d'évaluation.
télécharge et importe les résultats.

Modes SSH compatibles

Si vous utilisez la CLI mcdc sur une machine Linux, vous pouvez utiliser deux modes pour exécuter SSH:

Par défaut:utilise le binaire ssh et les configurations sur la machine CLI mcdc. Le mode par défaut peut utiliser par défaut les fichiers de configuration SSH locaux, 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 transmettre la phrase secrète du mot de passe ou du fichier de clé privée via la ligne de commande. Exemple :
```
sshpass -p password mcdc discover ssh IP_ADDRESS
```
Remplacez IP_ADDRESS par l'adresse IP de la machine.
Imbriqué: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. Cependant, il n'utilise pas par défaut les fichiers de configuration SSH locaux. Vous pouvez utiliser l'option -i pour spécifier un fichier de clé privée SSH.

Si vous utilisez la CLI mcdc sur un ordinateur Windows, seul le mode intégré est compatible.

Exécuter la collection

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

Connectez-vous à la machine Linux hébergeant la CLI mcdc.
Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.
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.
Le fichier de clé privée SSH de l'utilisateur qui appelle la CLI mcdc est utilisé 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 à l'aide de ces identifiants. Si la clé privée SSH de l'utilisateur appelant la CLI mcdc ne parvient pas à s'authentifier sur la machine avec le nom d'utilisateur, vous êtes également invité à saisir un mot de passe.

Scénarios supplémentaires lors de l'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'indicateur -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
```
Étant donné que 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 qu'elle dispose des droits nécessaires pour exécuter le script de collecte.

Pour spécifier le fichier de clé privée SSH en 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 indicateurs 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 les données collectées en ligne dans le centre de migration, ou effectuer une évaluation hors connexion.

Collecter des données à distance via WMI

Si vous souhaitez effectuer une recherche d'invités sur une machine Windows cible compatible avec WMI, vous pouvez utiliser la commande mcdc discover wmi sur la machine Windows hébergeant la CLI mcdc. La collecte 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:

Importe le script de collecte sur la machine.
Exécute le script sur la machine avec les identifiants de l'utilisateur transmis à la CLI mcdc.

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

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

Connectez-vous à la machine Windows hébergeant la CLI mcdc.
Accédez au répertoire dans lequel vous avez téléchargé la CLI mcdc.
Recueillez des données:
```
mcdc.exe discover wmi IP_HOSTNAME
```
Remplacez IP_HOSTNAME par le nom d'hôte IP de la machine.
Saisissez vos identifiants lorsque vous y êtes invité.

Collecter des données sur des machines Linux individuelles

Pour effectuer une collecte en tant qu'invité localement sur un ordinateur Linux, vous pouvez exécuter le script mcdc-linux-collect.sh. Vous pouvez ensuite copier le fichier tar généré par le script sur la machine qui héberge la CLI mcdc, puis l'importer avec la commande 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, le script risque de ne pas pouvoir collecter toutes les données requises.

Connectez-vous à votre ordinateur.
Accédez au répertoire dans lequel vous avez téléchargé le script de collection invité.

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 dans le répertoire actuel. L'horodatage est au format YYYY-MM-DD-hh-mm.

Cliquez pour afficher le format de fichier tar de la collection invitée

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 éventuellement transmettre l'argument --output et spécifier le chemin d'accès où vous souhaitez enregistrer le fichier tar.

Copiez les données collectées de la machine cible sur la machine hôte.
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 le centre de migration, ou effectuer une évaluation hors connexion.

Collecter des données sur une machine Windows individuelle

Pour effectuer une collecte en tant qu'invité localement sur un ordinateur Windows, vous pouvez exécuter le script 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 avec la commande discover import.

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

Exécutez le script de collecte sur la machine:

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

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
```
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 effectuer une évaluation hors connexion.

Étapes suivantes

Découvrez comment exécuter une analyse de plage d'adresses IP.
Découvrez comment exporter les données collectées vers le centre de migration.