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, el hardware y la red de la máquina, así como los archivos, los servicios y los procesos abiertos.
Para máquinas que se ejecutan en plataformas para las cuales no funciona la CLI del cliente de descubrimiento del Centro de migraciones Admiten el descubrimiento de inventario, como las VMs que se ejecutan en Azure o máquinas que se ejecutan de manera local, así como también de 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
. - En el caso de las máquinas de Windows a las que puede acceder la CLI de
mcdc
, puedes realizar un descubrimiento remoto con el Instrumental de administración de Windows (WMI) con el comandodiscover wmi
. - Para máquinas Linux y Windows sin conexión a la
mcdc
, puedes descargar y ejecutar secuencias de comandos de colecciones de invitados de forma local y, luego, 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
Para las VMs alojadas en vSphere, la CLI de mcdc
puede usar VMware
para implementar y ejecutar las secuencias de comandos de recopilación de forma remota, tanto en Linux como
VMs de 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
para conectarse 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 forma opcional, limita el descubrimiento solo a VMs de Windows o Linux con la marca
--os-family
, o cambia el nivel de paralelismo con la marca--max-parallelism
.Cuando se te solicite, ingresa la contraseña de VCENTER_USER y VM_USER.
También puedes definir el alcance del descubrimiento a VMs específicas con el La marca
--path
, como se describe para VMware en Ejecuta un descubrimiento de inventario.
Puedes exportar y evaluar en línea estos datos recopilados en el Centro de migraciones. 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 de mcdc
tiene acceso SSH a la máquina de Linux de destino (las máquinas de Windows no son compatibles), la CLI de mcdc
puede conectarse a la máquina de destino a través de SSH para recopilar datos.
Cuando usas SSH, la CLI de mcdc
hace lo siguiente:
- Sube la secuencia de comandos de 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 de SSH compatibles
Si usas la CLI de mcdc
en una máquina de Linux, puedes usar dos modos para ejecutar SSH:
Predeterminada: Usa el objeto binario y la configuración
ssh
en la máquina de la CLI demcdc
. El modo predeterminado puede usar los archivos de configuración de SSH locales 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 Windows, solo se admite el modo incrustado.
Ejecuta la colección
Para recopilar datos mediante SSH, sigue estos pasos:
- Accede a la máquina de Linux que aloja la CLI de
mcdc
. - Cambia al directorio en el que descargaste la CLI de
mcdc
. Recopilación de 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. La secuencia de comandos de la colección 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 la forma incorporada del comando no usa la conexión SSH local archivos de configuración de forma predeterminada, asegúrate de que el usuario que especifiques en la puede acceder a la máquina a través de SSH y tiene privilegios en la 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 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.
Recopila datos de forma remota a través de WMI
Si deseas realizar un descubrimiento de invitados en una máquina de Windows de destino con compatibilidad con WMI, puedes usar el comando mcdc discover wmi
en la máquina de 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 se usa 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 en el que descargaste la CLI de
mcdc
. Recopila 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 localmente en una máquina Linux, puedes ejecutar el comando
mcdc-linux-collect.sh
.
Luego, puedes copiar el archivo tar 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
.
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 en el que descargaste la secuencia de comandos de recopilació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
en el 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 una máquina Windows, puedes ejecutar la secuencia de comandos 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.