Gastsuchanfrage ausführen

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

Übersicht

Mit der Gasterkennung können Sie Daten zu den laufenden Anwendungen scannen und erfassen die sowohl VM-Instanzen als auch physischen Servern. Außerdem werden Daten zur Computerkonfiguration, Hardware, Netzwerk sowie zu geöffneten Dateien, Diensten und Prozessen erfasst.

Für Computer, die auf Plattformen ausgeführt werden, für die die Befehlszeile des Discovery-Clients des Migration Centers nicht unterstützt wird unterstützen die Inventarerkennung, z. B. VMs. auf Azure oder lokal ausgeführten Maschinen, sowie für eine Bewertung von VMs, die auf VMware und AWS ausgeführt werden, können Sie eine Gasterkennung ausführen. Bei der Gasterkennung wird ein Script zur Gasterfassung verwendet, um Daten über den Computer zu erfassen und schreibt diese Daten in eine TAR-Datei für die Gastsammlung auf Linux-Computern, für Windows-Computer.

Die Maschine, auf der die mcdc-Befehlszeile gehostet wird, lädt das Skript in den Zielcomputer ausführen, ihn ausführen und dann die Ergebnisse herunterladen. Sie können das Skript ausführen, lokal auf dem Zielcomputer oder remote ausführen. Je nach Infrastruktur befinden, können Sie die mcdc-Befehlszeile verwenden. auf folgende Arten:

  • Für Linux- und Windows-VMs, die auf VMware bereitgestellt werden, die mcdc-Befehlszeile unterstützt die Remote-Ausführung mit dem Befehl discover vsphere.
  • Für Linux-Maschinen, auf die über die mcdc-Befehlszeile zugegriffen werden kann, gilt Folgendes: kann eine Remote-Erkennung mithilfe von SSH mit dem Befehl discover ssh durchfü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) ausführen.
  • Bei Linux- und Windows-Computern ohne Verbindung zum mcdc-Befehlszeile können Sie die und anschließend manuell importieren. Daten an die Maschine übertragen, auf der die mcdc-Befehlszeile gehostet wird.

Das Skript zur Gasterfassung führt eine Reihe von Befehlen aus, um Informationen über den Quellcomputer und sammelt auch Informationen aus mehreren Dateien auf an der Maschine.

Hinweise

  1. Lesen Sie die Anforderungen zum Herunterladen und Ausführen der mcdc-Befehlszeile.
  2. Lesen Sie die Anforderungen zum Herunterladen und Ausführen der Gasterfassungsscripts.
  3. Führen Sie die Schritte zum Herunterladen der mcdc-Befehlszeile aus.

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. Bei Verwendung von VMware-Tools: Das mcdc-Befehlszeilentool führt 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, der die folgenden Berechtigungen auf der VM haben muss:
    • 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, mcdc-Befehlszeile zum Erfassen der für eine um die Bewertung abzuschließen.

So erfassen Sie Daten mit VMware-Tools:

  1. Melden Sie sich bei der Linux-VM an, auf der die mcdc-Befehlszeile gehostet wird.
  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: Name der VM oder von MOREF
  5. Wenn Sie dazu aufgefordert werden, geben Sie das Passwort für VCENTER_USER ein und VM_USER.

Um Daten aus mehreren vSphere-VMs parallel mit VMware-Tools zu erfassen, führen Sie folgende Schritte aus:

  1. Melden Sie sich bei der Linux-VM an, auf der die mcdc-Befehlszeile gehostet wird.
  2. Wechseln Sie zu dem Verzeichnis, in das Sie die mcdc-Befehlszeile heruntergeladen haben.
  3. Prüfen Sie, ob 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 Erkennung auf Windows- oder Linux-VMs beschränken. Verwenden Sie dazu die Methode --os-family oder ändern Sie den Parallelitätsgrad mithilfe der Methode --max-parallelism-Flag.

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

  6. Sie können die Erkennung auch auf bestimmte VMs beschränken, indem Sie die Flag --path, wie für VMware unter Inventarerkennung ausführen beschrieben.

Sie können diese erhobenen Daten online im Migration Center exportieren und bewerten. oder eine Offline-Bewertung durchführen.

Remote-Daten über SSH erfassen

Wenn die Maschine, auf der die mcdc-Befehlszeile gehostet wird, SSH-Zugriff auf auf dem Linux-Zielcomputer (Windows werden nicht unterstützt), dann Die mcdc-Befehlszeile kann über SSH eine Verbindung zur Zielmaschine herstellen, um Daten zu erheben.

Bei Verwendung von SSH führt die mcdc-Befehlszeile Folgendes aus:

  1. Das Erfassungsskript wird auf den Computer hochgeladen.
  2. Führt das Skript auf dem Computer mit den Nutzeranmeldedaten für Maschinen aus, die an die mcdc-Befehlszeile.

  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 kann die lokale SSH-Verbindung verwendet werden Konfigurationsdateien wie ~/.ssh/config und ~/.ssh/known_hosts der Workstation, auf der sie gehostet wird.

    Geben Sie das Passwort ein, wenn Sie dazu aufgefordert werden, oder geben Sie es mit sshpass weiter oder die Passphrase des privaten Schlüssels in die Befehlszeile ein. 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 in Ihrer Umgebung der Standardmodus nicht korrekt funktioniert. Es verwendet jedoch nicht standardmäßig die lokalen SSH-Konfigurationsdateien. Mit dem Flag -i können Sie eine private SSH-Schlüsseldatei angeben.

Wenn Sie die mcdc CLI 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 zu dem Verzeichnis, in das Sie die mcdc-Befehlszeile heruntergeladen haben.
  3. Daten erfassen:

    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. Die Erfassungsskripts mit diesen Anmeldedaten ausgeführt. Wenn der private SSH-Schlüssel Der Nutzer, der die mcdc-Befehlszeile aufruft, kann nicht authentifiziert werden mit dem Nutzernamen anmelden, werden Sie auch zur Eingabe eines Passworts aufgefordert.

Weitere 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 Computernutzer 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 Computernutzer.

    Wenn Sie dazu aufgefordert werden, geben Sie 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

    Weil die eingebettete Form des Befehls nicht das lokale SSH verwendet Konfigurationsdateien müssen Sie sicherstellen, dass der Nutzer, den Sie in den kann über SSH auf den Computer zugreifen und hat Berechtigungen für um das Erfassungsskript auszuführen.

  • Verwenden Sie das Flag -i, um die private SSH-Schlüsseldatei im eingebetteten 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 der Befehlszeile können Sie die meisten SSH-Flags angeben. Diese Flags werden dann mit der Methode -a oderssh --ssh-args-Flag. 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 erhobenen Daten online im Migration Center exportieren und bewerten. oder eine Offline-Bewertung durchführen.

Remote-Datenerfassung über WMI

Wenn Sie eine Gasterkennung auf einem Windows-Zielcomputer mit WMI ausführen möchten können Sie den Befehl mcdc discover wmi auf dem Windows-Computer der die mcdc-Befehlszeile hostet. WMI-Sammlung wird unterstützt nur in der Windows-Version der mcdc-Befehlszeile.

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

  1. Das Erfassungsskript auf den Computer hochladen.
  2. Führt das Skript auf dem Computer mit den übergebenen Nutzeranmeldedaten aus mit der mcdc-Befehlszeile.

  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 Datei mcdc-Befehlszeile.
  3. Daten erfassen:

    mcdc.exe discover wmi IP_HOSTNAME
    

    Ersetzen Sie IP_HOSTNAME durch den IP-Hostnamen von an der Maschine.

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

Daten auf einzelnen Linux-Computern erfassen

Um eine Gastsammlung lokal auf einem Linux-Computer auszuführen, können Sie den mcdc-linux-collect.sh-Script. Dann können Sie die vom Skript generierte TAR-Datei auf den Computer kopieren, hostet die mcdc-Befehlszeile und importieren sie mit der discover import-Befehl.

In der Regel führen Sie das Skript mit der Option sudo aus. Optional können Sie das Skript mit den Berechtigungen des ausgeführten Nutzers ausführen die mcdc-Befehlszeile. Das Skript kann jedoch alle erforderlichen Daten zu sammeln.

  1. Melden Sie sich auf Ihrem Computer an.
  2. Wechseln Sie in das Verzeichnis, in das Sie das Skript für die Gasterfassung heruntergeladen haben.
  3. Führen Sie das Erfassungsskript auf dem Computer aus:

    sudo ./mcdc-linux-collect.sh
    

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

    Klicken, um das TAR-Dateiformat der Gästesammlung anzusehen

    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. wo Sie die TAR-Datei speichern möchten.

  4. Kopieren Sie die erfassten Daten vom Zielcomputer auf den Hostcomputer.

  5. Importieren Sie die erfassten Daten auf den 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 erhobenen Daten online im Migration Center exportieren und bewerten. oder eine Offline-Bewertung durchführen.

Daten auf einem einzelnen Windows-Computer erfassen

Um eine Gastsammlung lokal auf einem Windows-Computer auszuführen, können Sie den mcdc-windows-collect.ps1-Script. 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 zu dem 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 mit dem Namen mcdc-collect-MACHINE_NAME-TIMESTAMP.zip in das aktuelle Verzeichnis.

    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 den 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 gesammelten Daten exportieren und online beurteilen in: Migration Center ausführen oder eine Offline-Bewertung durchführen.

Nächste Schritte