En este documento, se describen los pasos para ejecutar los diferentes métodos de descubrimiento de invitados.
que proporciona la CLI de mcdc
.
Descripción general
El descubrimiento de invitados te permite analizar y recopilar datos sobre las aplicaciones en ejecución en tus máquinas, que incluye instancias de máquina virtual (VM) y servidores físicos. También recopila datos sobre la configuración de las máquinas, hardware, la red, así como los archivos, servicios y procesos abiertos.
En el caso de las máquinas que se ejecutan en plataformas para las que la CLI del cliente de descubrimiento de Migration Center no admite el descubrimiento de inventario, como las VMs que se ejecutan en Azure o las máquinas que se ejecutan de forma local, así como para una evaluación completa de las VMs que se ejecutan en VMware y AWS, puedes ejecutar un descubrimiento de invitados. El descubrimiento de invitados usa una secuencia de comandos de recopilación de invitados para recopilar datos sobre la máquina. y escribe esos datos en un archivo tar de recopilación de invitados para máquinas Linux, o ZIP para máquinas de Windows.
La máquina que aloja la CLI de mcdc
sube la secuencia de comandos al
de destino, la ejecuta y descarga los resultados. Puedes ejecutar la secuencia de comandos
de manera local en la máquina de destino
o ejecutarlas de forma remota. Según tu
puedes usar la CLI de mcdc
de las siguientes maneras:
- Para las VMs de Linux y Windows implementadas en VMware, la CLI de
mcdc
admite la ejecución remota con el comandodiscover vsphere
. - Para las máquinas de Linux a las que se puede acceder con la CLI de
mcdc
, puedes puede realizar un descubrimiento remoto mediante SSH con el comandodiscover ssh
. - Para las máquinas de Windows a las que se puede acceder con la CLI de
mcdc
, puedes puede realizar una detección remota con el Instrumental de administración de Windows (WMI) con el comandodiscover wmi
. - En el caso de las máquinas de Linux y Windows sin conexión a la CLI de
mcdc
, puedes descargar y ejecutar las secuencias de comandos de recopilación de invitados de forma local y, luego, importar manualmente los datos recopilados a la máquina que aloja la CLI demcdc
.
La secuencia de comandos de recopilación de invitados ejecuta una serie de comandos para recopilar información acerca de la máquina de origen y recopila información de varios archivos de la máquina.
Antes de comenzar
- Revisa los requisitos para descargar y ejecutar la CLI de
mcdc
. - Revisa los requisitos para descargar y ejecutar las secuencias de comandos de recopilación de invitados.
- Completa los pasos para descargar la CLI de
mcdc
.
Recopila datos de forma remota con herramientas de VMware
En las VMs alojadas en vSphere, la CLI de mcdc
puede usar las herramientas de VMware para implementar y ejecutar las secuencias de comandos de recopilación de forma remota en las VMs de Linux y Windows. Cuando se usan herramientas de VMware, la herramienta de la CLI de mcdc
hace lo siguiente:
- Sube la secuencia de comandos de la recopilación a la VM.
- Ejecuta la secuencia de comandos en la VM.
- Descarga e importa los resultados.
Se requieren dos conjuntos de credenciales para recopilar datos de forma remota:
- El nombre de usuario del servidor de vCenter que se pasa a la CLI de
mcdc
a conectarte a vSphere, que debe tener los siguientes privilegios en la VM:- Modificaciones de las operaciones de invitado
- Ejecución del programa de operaciones de invitado
- Consultas de operaciones de invitado
- Credenciales del usuario para la VM:
- En Windows, debes tener privilegios de administrador.
- En Linux, no se requiere acceso con permisos de administrador, pero este último lo permite
CLI de
mcdc
para recopilar los datos necesarios para una completa la evaluación.
Para recopilar datos con las herramientas de VMware, sigue estos pasos:
- Accede a tu VM de Linux que aloja la CLI de
mcdc
. - Cambia al directorio en el que descargaste la CLI de
mcdc
. - Asegúrate de que la VM esté encendida.
Ejecuta el descubrimiento de invitado:
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
Reemplaza lo siguiente:
- VCENTER_USER: el usuario del servidor de vCenter.
- VM_USER: el usuario de la VM
- VM_ID: Es el nombre de la VM o MOREF.
Cuando se te solicite, ingresa la contraseña de VCENTER_USER y VM_USER
Para recopilar datos de varias VMs de vSphere en paralelo con las herramientas de VMware, sigue estos pasos:
- Accede a tu VM de Linux que aloja la CLI de
mcdc
. - Cambia al directorio en el que descargaste la CLI de
mcdc
. - Asegúrate de que todas las VMs estén encendidas.
Ejecuta el descubrimiento de invitado:
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
Reemplaza TIMEOUT_IN_SECONDS por el tiempo de espera en segundos.
De manera opcional, limita la detección solo a VMs de Windows o Linux con el
--os-family
o cambia el nivel de paralelismo con el--max-parallelism
.Cuando se te solicite, ingresa la contraseña de VCENTER_USER y VM_USER
También puedes definir el alcance del descubrimiento en VMs específicas mediante la marca
--path
, como se describe para VMware en Ejecuta un descubrimiento de inventario.
Puedes exportar y evaluar estos datos recopilados en línea en Migration Center o ejecutar una evaluación sin conexión.
Recopila datos de forma remota a través de SSH
Si la máquina que aloja la CLI mcdc
tiene acceso SSH a
la máquina Linux de destino (las máquinas con Windows no son compatibles) y, luego,
La CLI de mcdc
puede conectarse a la máquina de destino mediante SSH a
recopilar datos.
Cuando se usa SSH, la CLI de mcdc
hace lo siguiente:
- Sube la secuencia de comandos de la recopilación a la máquina.
Ejecuta la secuencia de comandos en la máquina con las credenciales de usuario de la máquina pasadas a la CLI de
mcdc
.Descarga e importa los resultados.
Modos SSH compatibles
Si usas la CLI de mcdc
en una máquina Linux,
Puedes usar dos modos para ejecutar SSH:
Predeterminado: usa el objeto binario
ssh
y los parámetros de configuración en lamcdc
de CLI. El modo predeterminado puede usar el SSH local archivos de configuración de forma predeterminada, como~/.ssh/config
y~/.ssh/known_hosts
, de la estación de trabajo que lo aloja.Ingresa la contraseña cuando se te solicite o usa
sshpass
para pasarla. o la frase de contraseña del archivo de clave privada en la línea de comandos. Por ejemplo:sshpass -p password mcdc discover ssh IP_ADDRESS
Reemplaza IP_ADDRESS por la dirección IP de la máquina.
Incorporado: Usa la biblioteca SSH integrada. Este modo te permite usar el cliente SSH incorporado si el modo predeterminado funciona mal en tu entorno. Sin embargo, no usa los archivos de configuración de SSH locales de forma predeterminada. Puedes usar la marca
-i
para especificar un archivo de claves privadas SSH.
Si usas la CLI de mcdc
en una máquina con Windows, haz lo siguiente:
Solo se admite el modo incorporado.
Ejecuta la colección
Para recopilar datos mediante SSH, sigue estos pasos:
- Accede a la máquina Linux que aloja la CLI de
mcdc
. - Cambia al directorio en el que descargaste la CLI de
mcdc
. Recopilar datos:
Linux
./mcdc discover ssh IP_HOSTNAME
Windows
mcdc.exe discover ssh IP_HOSTNAME
Reemplaza IP_HOSTNAME por el nombre de host IP de la máquina.
El archivo de claves privadas SSH del usuario que invoca al La CLI de
mcdc
se usa para la autenticación SSH.Cuando se te solicite, ingresa el nombre de usuario de una cuenta en la máquina de Linux. El de recopilación de imágenes se ejecuta con estas credenciales. Si la clave privada SSH de el usuario que invoca la CLI de
mcdc
no se puede autenticar a la máquina con el nombre de usuario, también se te solicitará una contraseña.
Situaciones adicionales cuando se usa SSH
Consulta las siguientes situaciones en las que es posible que debas modificar el comando:
Para especificar el usuario de la máquina con el modo predeterminado, usa la marca
-u
:Linux
./mcdc discover ssh -u USER IP_HOSTNAME
Windows
mcdc.exe discover ssh -u USER IP_HOSTNAME
Reemplaza USER por el usuario de la máquina.
Cuando se te solicite, ingresa la contraseña del usuario.
Para especificar el modo detallado, usa la marca
-v
:Linux
./mcdc discover ssh -u USER -v IP_HOSTNAME
Windows
mcdc.exe discover ssh -u USER -v IP_HOSTNAME
Para especificar el archivo de claves privadas SSH, usa la marca
-i
. Por ejemplo, para especificar.ssh/my_private_key
, usa lo siguiente: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 la contraseña en la línea de comandos, usa el 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
Debido a que el formulario incorporado del comando no usa los archivos de configuración de SSH locales de forma predeterminada, asegúrate de que el usuario que especifiques en el comando pueda acceder a la máquina a través de SSH y tenga privilegios en la máquina para ejecutar la secuencia de comandos de recopilación.
Para especificar el archivo de claves privadas SSH con el modo incorporado, usa la marca
-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
El comando
mcdc
de la CLI te permite especificar la mayoría de las marcas de SSH. Luego, pasa estas marcas al comandossh
con-a
.--ssh-args
. Por ejemplo, para usar un proxy de 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
Puedes exportar y evaluar en línea estos datos recopilados en el Centro de migraciones. o ejecutar una evaluación sin conexión.
Recopilar datos de forma remota a través de WMI
Si quieres realizar una detección de invitados en una máquina Windows de destino con WMI
puedes usar el comando mcdc discover wmi
en la máquina con Windows
que aloja la CLI de mcdc
. Se admite la recopilación de WMI.
solo en la versión para Windows de la CLI de mcdc
.
Cuando usas WMI, la CLI de mcdc
hace lo siguiente:
- Sube la secuencia de comandos de la recopilación a la máquina.
Ejecuta la secuencia de comandos en la máquina después de pasar las credenciales de usuario de la máquina. a la CLI de
mcdc
.Descarga e importa los resultados.
Para recopilar datos a través de WMI, sigue estos pasos:
- Accede a la máquina de Windows que aloja la CLI de
mcdc
. - Cambia al directorio donde descargaste la
CLI de
mcdc
Recopilar datos:
mcdc.exe discover wmi IP_HOSTNAME
Reemplaza IP_HOSTNAME por el nombre de host IP de la máquina.
Ingresa tus credenciales cuando se te solicite.
Recopilar datos en máquinas individuales de Linux
Para realizar una recopilación de invitados de forma local en una máquina de Linux, puedes ejecutar la secuencia de comandos mcdc-linux-collect.sh
.
Luego, puedes copiar el archivo tar que genera la secuencia de comandos en la máquina que
hosting la CLI de mcdc
y, luego, importarlo con el
comando discover import
.
Por lo general, debes ejecutar la secuencia de comandos si especificas la opción sudo
.
De manera opcional, puedes ejecutar la secuencia de comandos con los privilegios del usuario que ejecuta
la CLI de mcdc
. Sin embargo, es posible que la secuencia de comandos no pueda
recopilar todos los datos requeridos.
- Accede a tu máquina.
- Cambia al directorio donde descargaste la secuencia de comandos de la colección de invitados.
Ejecuta la secuencia de comandos de recopilación en la máquina:
sudo ./mcdc-linux-collect.sh
La secuencia de comandos genera un archivo tar llamado
mcdc-collect-MACHINE_NAME-TIMESTAMP.tar
al directorio actual. La marca de tiempo tiene el formatoYYYY-MM-DD-hh-mm
.Haz clic para ver el formato de archivo tar de la colección de invitados
El archivo tar tiene el siguiente 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
De manera opcional, puedes pasar el argumento
--output
y especificar la ruta de acceso. en la que quieres guardar el archivo tar.Copia los datos recopilados de la máquina de destino en la máquina anfitrión.
Importa los datos recopilados en la máquina anfitrión:
Linux
./mcdc discover import PATH_TO_TAR
Windows
mcdc.exe discover import PATH_TO_TAR
Reemplaza PATH_TO_TAR por la ruta de acceso al archivo tar.
Puedes exportar y evaluar estos datos recopilados en línea en Migration Center o ejecutar una evaluación sin conexión.
Recopilar datos en una máquina individual de Windows
Para realizar una recopilación de invitados de forma local en un equipo con Windows, puedes ejecutar el comando
mcdc-windows-collect.ps1
.
A continuación, puedes copiar el archivo ZIP generado por la secuencia de comandos en la máquina que
aloja la CLI de mcdc
y, luego, impórtala con el
Comando discover import
.
- Accede a tu máquina.
- Abre PowerShell mediante la opción Ejecutar como administrador.
- Cambia al directorio en el que descargaste la CLI de
mcdc
. Ejecuta la secuencia de comandos de recopilación en la máquina:
powershell -ExecutionPolicy ByPass -File .\mcdc-windows-collect.ps1
La secuencia de comandos genera un archivo ZIP llamado
mcdc-collect-MACHINE_NAME-TIMESTAMP.zip
en el directorio actual.De manera opcional, puedes incluir una ruta de salida para especificar una ubicación diferente:
.\mcdc-windows-collect.ps1 PATH_FOR_OUTPUT.zip
Importa los datos recopilados en la máquina host:
Linux
./mcdc discover import PATH_TO_TAR
Windows
mcdc.exe discover import PATH_TO_TAR
Reemplaza PATH_TO_TAR por la ruta de acceso al archivo tar.
Puedes exportar los datos recopilados y evaluarlos en línea en Migration Center o ejecuta una evaluación sin conexión.
¿Qué sigue?
- Aprende a ejecutar un análisis de rango de IP.
- Obtén información para exportar los datos recopilados a Migration Center.