Gastsuchanfrage ausführen

In diesem Dokument werden die Schritte zum Ausführen der verschiedenen Methoden zur Gästeerkennung beschrieben, die die mcdc-Befehlszeile bietet.

Übersicht

Mit der Gasterkennung können Sie Daten zu den auf Ihren Maschinen ausgeführten Anwendungen erfassen, einschließlich virtueller Maschinen (VM-Instanzen) und physischer Server. Außerdem werden Daten zur Computerkonfiguration, zur Hardware, zum Netzwerk sowie zu geöffneten Dateien, Diensten und Prozessen erfasst.

Für Maschinen, die auf Plattformen ausgeführt werden, für die die Befehlszeile des Discovery-Clients im Migrationscenter die Inventarermittlung nicht unterstützt, z. B. VMs, die auf Azure oder lokal ausgeführt werden, sowie für eine vollständige Bewertung von VMs, die auf VMware und AWS ausgeführt werden, können Sie eine Gastermittlung ausführen. Bei der Gasterkennung werden mit einem Gasterfassungsskript Daten über den Computer erfasst und in eine TAR-Datei für Linux-Computer oder eine ZIP-Datei für Windows-Computer geschrieben.

Der Computer, auf dem die mcdc-Befehlszeile gehostet wird, lädt das Script auf den Zielcomputer hoch, führt es aus und lädt dann die Ergebnisse herunter. Sie können das Script lokal auf dem Zielcomputer oder remote ausführen. Je nach Infrastruktur können Sie die mcdc-Befehlszeile auf folgende Arten verwenden:

  • Für Linux- und Windows-VMs, die auf VMware bereitgestellt werden, unterstützt die mcdc-Befehlszeile die Remoteausführung mit dem Befehl discover vsphere.
  • Bei Linux-Computern, auf die über die mcdc-Befehlszeile zugegriffen werden kann, können Sie eine Remote-Erkennung mit SSH und dem Befehl discover ssh ausführen.
  • Auf Windows-Computern, auf die über die mcdc-Befehlszeile zugegriffen werden kann, können Sie mit dem Befehl discover wmi eine Remote-Erkennung mit WMI (Windows Management Instrumentation) durchführen.
  • Auf Linux- und Windows-Computern ohne Verbindung zur mcdc-Befehlszeile können Sie die Scripts zur Erfassung von Gästen lokal herunterladen und ausführen und die erfassten Daten dann manuell auf den Computer importieren, auf dem die mcdc-Befehlszeile gehostet wird.

Das Erfassungsskript für Gäste führt eine Reihe von Befehlen aus, um Informationen zum Quellcomputer und außerdem Daten aus mehreren Dateien auf dem Computer zu erfassen.

Hinweise

  1. Sehen Sie sich die Anforderungen zum Herunterladen und Ausführen der mcdc CLI an.
  2. Lesen Sie die Anforderungen zum Herunterladen und Ausführen der Gasterfassungsscripts.
  3. Führen Sie die Schritte aus, um die mcdc CLI herunterzuladen.

Daten mithilfe von VMware-Tools per Remotezugriff erfassen

Für VMs, die auf vSphere gehostet werden, kann die mcdc-Befehlszeile die Sammlungsskripts mit VMware-Tools sowohl auf Linux- als auch auf Windows-VMs bereitstellen und ausführen. Wenn Sie VMware-Tools verwenden, führt das mcdc-Befehlszeilentool Folgendes aus:

  • Lädt das Erfassungsskript auf die VM hoch.
  • Führt das Script auf der VM aus.
  • Ergebnisse herunterladen und importieren

Für die Remote-Erfassung von Daten sind zwei Gruppen von Anmeldedaten erforderlich:

  • Der an die mcdc-Befehlszeile übergebene vCenter-Server-Nutzername für die Verbindung mit vSphere muss die folgenden Berechtigungen auf der VM haben:
    • Gastbetrieb-Änderungen
    • Ausführung des Gastbetriebsprogramms
    • Gastbetrieb-Abfragen
  • Nutzeranmeldedaten für die VM:
    • Unter Windows benötigen Sie Administratorberechtigungen.
    • Unter Linux ist kein Root-Zugriff erforderlich, aber mit Root-Zugriff kann die mcdc-Befehlszeile die für eine vollständige Bewertung erforderlichen Daten erfassen.

So erfassen Sie Daten mit VMware-Tools:

  1. Melden Sie sich bei der Linux-VM an, die die mcdc-Befehlszeile hostet.
  2. Wechseln Sie in das Verzeichnis, in das Sie die mcdc-Befehlszeile heruntergeladen haben.
  3. Prüfen Sie, ob die VM eingeschaltet ist.

  4. Führen Sie die Gastsuchanfrage aus:

    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

    Ersetzen Sie Folgendes:

    • VCENTER_USER: der vCenter-Servernutzer
    • VM_USER: der VM-Nutzer
    • VM_ID: der Name der VM oder MOREF

  5. Geben Sie bei entsprechender Aufforderung das Passwort für VCENTER_USER und VM_USER ein.

So erfassen Sie Daten aus mehreren vSphere-VMs parallel mit VMware-Tools:

  1. Melden Sie sich bei der Linux-VM an, die die mcdc-Befehlszeile hostet.
  2. Wechseln Sie in das Verzeichnis, in das Sie die mcdc-Befehlszeile heruntergeladen haben.
  3. Achten Sie darauf, dass alle VMs eingeschaltet sind.

  4. Führen Sie die Gastsuchanfrage aus:

    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

    Ersetzen Sie TIMEOUT_IN_SECONDS durch das Zeitlimit in Sekunden.

    Optional können Sie die Suche mit dem Flag --os-family auf Windows- oder Linux-VMs beschränken oder mit dem Flag --max-parallelism die Parallelitätsstufe ändern.

  5. Geben Sie bei entsprechender Aufforderung das Passwort für VCENTER_USER und VM_USER ein.

  6. Sie können die Erfassung auch mit dem Flag --path auf bestimmte VMs beschränken. Dies wird für VMware im Abschnitt Inventarerkennung ausführen beschrieben.

Sie können diese erfassten Daten online im Migrationscenter exportieren und bewerten oder eine Offlinebewertung ausführen.

Remote-Daten über SSH erfassen

Wenn der Computer, auf dem die mcdc-Befehlszeile gehostet wird, SSH-Zugriff auf den Ziel-Linux-Computer hat (Windows-Computer werden nicht unterstützt), kann die mcdc-Befehlszeile über SSH eine Verbindung zum Zielcomputer herstellen, um Daten zu erfassen.

Wenn Sie SSH verwenden, führt die mcdc-Befehlszeile Folgendes aus:

  1. Das Erfassungsskript wird auf den Computer hochgeladen.

  2. Führt das Script auf dem Computer mit den Anmeldedaten des Computernutzers aus, die an die mcdc CLI übergeben werden.

  3. Ergebnisse herunterladen und importieren

Unterstützte SSH-Modi

Wenn Sie die mcdc-Befehlszeile auf einem Linux-Computer verwenden, können Sie SSH in zwei Modi ausführen:

  • Standard:Verwendet die ssh-Binärdatei und die Konfigurationen auf der mcdc-CLI-Maschine. Im Standardmodus können die lokalen SSH-Konfigurationsdateien wie ~/.ssh/config und ~/.ssh/known_hosts standardmäßig von der Workstation verwendet werden, die sie hostet.

    Geben Sie das Passwort ein, wenn Sie dazu aufgefordert werden, oder verwenden Sie sshpass, um das Passwort oder die Passphrase für die private Schlüsseldatei in der Befehlszeile zu übergeben. Beispiel:

    sshpass -p password mcdc discover ssh IP_ADDRESS

    Ersetzen Sie IP_ADDRESS durch die IP-Adresse des Computers.

  • Eingebettet:Verwendet die integrierte SSH-Bibliothek. In diesem Modus können Sie den eingebetteten SSH-Client verwenden, wenn im Standardmodus in Ihrer Umgebung Fehler auftreten. Die lokalen SSH-Konfigurationsdateien werden jedoch nicht standardmäßig verwendet. Mit dem Flag -i können Sie eine private SSH-Schlüsseldatei angeben.

Wenn Sie die mcdc-Befehlszeile auf einem Windows-Computer verwenden, wird nur der eingebettete Modus unterstützt.

Sammlung ausführen

So erfassen Sie Daten über SSH:

  1. Melden Sie sich auf dem Linux-Computer an, auf dem die mcdc-Befehlszeile gehostet wird.
  2. Wechseln Sie in das Verzeichnis, in das Sie die mcdc-Befehlszeile heruntergeladen haben.

  3. Daten erheben:

    Linux

    ./mcdc discover ssh IP_HOSTNAME

    Windows

    mcdc.exe discover ssh IP_HOSTNAME

    Ersetzen Sie IP_HOSTNAME durch den IP-Hostnamen des Computers.

  4. Die private SSH-Schlüsseldatei des Nutzers, der die mcdc-Befehlszeile aufruft, wird für die SSH-Authentifizierung verwendet.

    Geben Sie den Nutzernamen eines Kontos auf dem Linux-Rechner ein, wenn Sie dazu aufgefordert werden. Das Erfassungsskript wird mit diesen Anmeldedaten ausgeführt. Wenn der private SSH-Schlüssel des Nutzers, der die mcdc-Befehlszeile aufruft, nicht bei der Maschine mit dem Nutzernamen authentifiziert werden kann, werden Sie auch zur Eingabe eines Passworts aufgefordert.

Zusätzliche Szenarien bei der Verwendung von SSH

In den folgenden Fällen müssen Sie den Befehl möglicherweise ändern:

  • Verwenden Sie das Flag -u, um den Nutzer des Computers im Standardmodus anzugeben:

    Linux

    ./mcdc discover ssh -u USER IP_HOSTNAME

    Windows

    mcdc.exe discover ssh -u USER IP_HOSTNAME

    Ersetzen Sie USER durch den Nutzer des Computers.

    Geben Sie bei Aufforderung das Passwort für den Nutzer ein.

  • Verwenden Sie das Flag -v, um den ausführlichen Modus anzugeben:

    Linux

    ./mcdc discover ssh -u USER -v IP_HOSTNAME

    Windows

    mcdc.exe discover ssh -u USER -v IP_HOSTNAME

  • Verwenden Sie das Flag -i, um die private SSH-Schlüsseldatei anzugeben. So geben Sie beispielsweise .ssh/my_private_key an:

    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

  • Verwenden Sie den eingebetteten Modus, um das Passwort in der Befehlszeile anzugeben:

    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

    Da die eingebettete Form des Befehls standardmäßig nicht die lokalen SSH-Konfigurationsdateien verwendet, muss der im Befehl angegebene Nutzer über SSH auf den Computer zugreifen und Berechtigungen auf dem Computer haben, um das Sammelskript auszuführen.

  • Verwenden Sie das Flag -i, um die private SSH-Schlüsseldatei mit eingebettetem Modus anzugeben:

    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

  • Mit dem Befehl mcdc können Sie die meisten SSH-Flags angeben. Diese Flags werden dann mit dem Flag -a oder --ssh-args an den Befehl ssh übergeben. So verwenden Sie beispielsweise einen Socks-Proxy:

    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

Sie können diese erfassten Daten online im Migrationscenter exportieren und bewerten oder eine Offlinebewertung ausführen.

Daten per Remotezugriff über WMI erfassen

Wenn Sie eine Gastsuche auf einem Windows-Zielcomputer mit WMI-Unterstützung ausführen möchten, können Sie den Befehl mcdc discover wmi auf dem Windows-Computer verwenden, auf dem die mcdc CLI gehostet wird. Die WMI-Erfassung wird nur von der Windows-Version der mcdc-Befehlszeile unterstützt.

Bei Verwendung von WMI führt die mcdc-Befehlszeile folgende Schritte aus:

  1. Das Erfassungsskript wird auf den Computer hochgeladen.

  2. Führt das Skript auf dem Computer mit den Anmeldedaten des Computernutzers aus, die an die mcdc-Befehlszeile übergeben werden.

  3. Ergebnisse herunterladen und importieren

So erfassen Sie Daten über WMI:

  1. Melden Sie sich auf dem Windows-Computer an, auf dem die mcdc CLI gehostet wird.
  2. Wechseln Sie in das Verzeichnis, in das Sie die mcdc-Befehlszeile heruntergeladen haben.

  3. Daten erheben:

    mcdc.exe discover wmi IP_HOSTNAME

    Ersetzen Sie IP_HOSTNAME durch den IP-Hostnamen des Computers.

  4. Geben Sie Ihre Anmeldedaten ein, wenn Sie dazu aufgefordert werden.

Daten auf einem einzelnen Linux-Computer erfassen

Wenn Sie eine Gasterhebung lokal auf einem Linux-Computer ausführen möchten, können Sie das mcdc-linux-collect.sh-Script ausführen. Anschließend können Sie die vom Script generierte TAR-Datei auf den Computer kopieren, auf dem die mcdc CLI gehostet wird, und sie mit dem Befehl discover import importieren.

In der Regel führen Sie das Skript mit der Option sudo aus. Optional können Sie das Script mit den Berechtigungen des Nutzers ausführen, der die mcdc-Befehlszeile ausführt. Das Script kann jedoch möglicherweise nicht alle erforderlichen Daten erfassen.

  1. Melden Sie sich auf Ihrem Computer an.
  2. Wechseln Sie in das Verzeichnis, in das Sie das Script für die Gästeerfassung heruntergeladen haben.

  3. Führen Sie das Erfassungsskript auf dem Computer aus:

    sudo ./mcdc-linux-collect.sh

    Das Skript gibt eine TAR-Datei namens mcdc-collect-MACHINE_NAME-TIMESTAMP.tar in das aktuelle Verzeichnis aus. Der Zeitstempel hat das Format YYYY-MM-DD-hh-mm.

    Klicken Sie hier, um das TAR-Dateiformat der Gasterfassung aufzurufen.

    Die TAR-Datei hat das folgende Format:

    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

    Optional können Sie das Argument --output übergeben und den Pfad angeben, unter dem die TAR-Datei gespeichert werden soll.

  4. Kopieren Sie die erfassten Daten von der Zielmaschine auf den Hostcomputer.

  5. Importieren Sie die erfassten Daten auf dem Hostcomputer:

    Linux

    ./mcdc discover import PATH_TO_TAR

    Windows

    mcdc.exe discover import PATH_TO_TAR

    Ersetzen Sie PATH_TO_TAR durch den Pfad zur TAR-Datei.

Sie können diese erfassten Daten online im Migrationscenter exportieren und bewerten oder eine Offlinebewertung ausführen.

Daten auf einem einzelnen Windows-Computer erfassen

Wenn Sie eine Gasterhebung lokal auf einem Windows-Computer ausführen möchten, können Sie das mcdc-windows-collect.ps1-Script ausführen. Anschließend können Sie die vom Script generierte ZIP-Datei auf den Computer kopieren, auf dem die mcdc-Befehlszeile gehostet wird, und sie mit dem Befehl discover import importieren.

  1. Melden Sie sich auf Ihrem Computer an.
  2. Öffnen Sie PowerShell mit der Option Als Administrator ausführen.
  3. Wechseln Sie in das Verzeichnis, in das Sie die mcdc-Befehlszeile heruntergeladen haben.

  4. Führen Sie das Erfassungsskript auf dem Computer aus:

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

  5. Das Skript gibt eine ZIP-Datei namens mcdc-collect-MACHINE_NAME-TIMESTAMP.zip in das aktuelle Verzeichnis aus.

    Optional können Sie einen Ausgabepfad angeben, um einen anderen Speicherort anzugeben:

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

  6. Importieren Sie die erfassten Daten auf dem Hostcomputer:

    Linux

    ./mcdc discover import PATH_TO_TAR

    Windows

    mcdc.exe discover import PATH_TO_TAR

    Ersetzen Sie PATH_TO_TAR durch den Pfad zur TAR-Datei.

Sie können die erfassten Daten exportieren und online im Migrationscenter bewerten oder eine Offlinebewertung ausführen.

Nächste Schritte