Gasterkennung ausführen

In diesem Dokument werden die Schritte zum Ausführen der verschiedenen Gasterkennungsmethoden beschrieben, die die mcdc-Befehlszeile bietet.

Überblick

Mit der Gasterkennung können Sie Daten zu den laufenden Anwendungen auf Ihren Maschinen scannen und erfassen. Dazu gehören sowohl VM-Instanzen als auch physische Server. Außerdem werden Daten zur Maschinenkonfiguration, zur Hardware, zum Netzwerk sowie zu offenen Dateien, Diensten und Prozessen erhoben.

Für Maschinen, die auf Plattformen ausgeführt werden, für die die Inventarermittlung des Migrationscenter-Discovery-Clients nicht unterstützt wird, z. B. VMs, die in Azure ausgeführt werden, oder lokal ausgeführte Maschinen, sowie für eine vollständige Bewertung von VMs, die auf VMware und AWS ausgeführt werden, können Sie eine Gasterkennung ausführen. Bei der Gasterkennung wird ein Gasterfassungsskript verwendet, um Daten zum Computer zu erfassen, und schreibt diese Daten in eine TAR-Datei für die Gastsammlung auf Linux-Computern oder in eine ZIP-Datei bei Windows-Computern.

Die Maschine, auf der die mcdc-Befehlszeile gehostet wird, lädt das Skript auf die Zielmaschine hoch, führt es aus und lädt die Ergebnisse herunter. Sie können das Skript lokal oder remote auf der Zielmaschine ausführen. Je nach Ihrer Infrastruktur können Sie die mcdc-Befehlszeile so verwenden:

• Bei Linux- und Windows-VMs, die auf VMware bereitgestellt werden, unterstützt die mcdc-Befehlszeile die Remote-Ausführung mit dem Befehl discover vsphere.
• Bei Linux-Maschinen, auf die über die mcdc-Befehlszeile zugegriffen werden kann, können Sie mit dem Befehl discover ssh eine Remote-Erkennung mit SSH durchführen.
• Bei Windows-Computern, auf die über die mcdc-Befehlszeile zugegriffen werden kann, können Sie mit dem Befehl discover wmi eine Remoteerkennung mithilfe der Windows-Verwaltungsinstrumentation (WMI) durchführen.
• Auf Linux- und Windows-Computern ohne Verbindung zur mcdc-Befehlszeile können Sie die Gasterfassungsskripts lokal herunterladen, ausführen und die erfassten Daten dann manuell auf den Computer importieren, auf dem die mcdc-Befehlszeile gehostet wird.

Das Gasterfassungsskript führt eine Reihe von Befehlen aus, um Informationen über die Quellmaschine und auch Informationen aus mehreren Dateien auf der Maschine zu erfassen.

Wichtig: Die mcdc-Befehlszeile kann potenziell vertrauliche Daten wie Befehlszeilenargumente, Netzwerkinformationen oder Umgebungsvariablen und Argumente in laufenden Prozessen erfassen. Vertrauliche Daten wie personenidentifizierbare Informationen werden niemals an Google oder einen Dritten gesendet. Die Daten bleiben auf dem Computer, auf dem sie während der mcdc-Befehlszeile erfasst werden.

Hinweise

1. Sehen Sie sich die Anforderungen zum Herunterladen und Ausführen der mcdc-Befehlszeile an.
2. Lesen Sie sich die Voraussetzungen zum Herunterladen und Ausführen der Skripts zur Gasterfassung durch.
3. Führen Sie die Schritte zum Herunterladen der mcdc-Befehlszeile aus.

Daten mithilfe von VMware-Tools per Remotezugriff erfassen

Bei in vSphere gehosteten VMs kann die mcdc-Befehlszeile VMware-Tools verwenden, um die Erfassungsskripts remote auf Linux- und Windows-VMs bereitzustellen und auszuführen. Bei Verwendung von VMware-Tools führt das mcdc-Befehlszeilentool folgende Schritte aus:

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

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

• Der Nutzername des vCenter-Servers, der an die mcdc-Befehlszeile übergeben wird, um eine Verbindung zu vSphere herzustellen, das die folgenden Berechtigungen für die 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 der Root-Zugriff nicht erforderlich. Mit dem Root-Zugriff kann die mcdc-Befehlszeile jedoch 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, 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: der Name der VM oder MOREF
   Wichtig: Wenn der vSphere-Cluster mehrere Rechenzentren hat, müssen Sie das Flag --dc verwenden, um den Namen des Rechenzentrums anzugeben.

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

Führen Sie die folgenden Schritte aus, um mit VMware-Tools Daten von mehreren vSphere-VMs gleichzeitig zu erfassen:

Wichtig: Alle VMs, von denen Sie Daten erfassen möchten, müssen denselben Nutzernamen und dasselbe Passwort haben. Wenn Sie separate Anmeldedaten für Ihre Windows- oder Linux-VMs haben, können Sie mit dem Flag --os-family ein Betriebssystem auswählen.

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 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 mit dem Flag --os-family auf Windows- oder Linux-VMs beschränken oder den Parallelitätsgrad mit dem Flag --max-parallelism ändern.

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

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

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

Remote-Daten über SSH erfassen

Wenn die Maschine, auf der die mcdc-Befehlszeile gehostet wird, SSH-Zugriff auf den Linux-Zielcomputer 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 folgende Schritte aus:

1. Lädt das Erfassungsskript auf den Computer hoch.

2. Führt das Skript auf dem Computer aus. Dabei werden die Nutzeranmeldedaten des Computers an die mcdc-Befehlszeile übergeben.

   Hinweis: Die Anmeldedaten des Computernutzers erfordern zwar keinen Root-Zugriff, aber mit dem Root-Zugriff kann die mcdc-Befehlszeile alle Bewertungsdaten erfassen.

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 das Binärprogramm ssh und die Konfigurationen auf der Befehlszeilenmaschine mcdc. Im Standardmodus können standardmäßig die lokalen SSH-Konfigurationsdateien wie ~/.ssh/config und ~/.ssh/known_hosts 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 der privaten Schlüsseldatei in der Befehlszeile zu übergeben. Beispiel:

  sshpass -p password mcdc discover ssh IP_ADDRESS
  

  Ersetzen Sie IP_ADDRESS durch die IP-Adresse der Maschine.

• Eingebettet:Verwendet die integrierte SSH-Bibliothek. In diesem Modus können Sie den eingebetteten SSH-Client verwenden, wenn der Standardmodus in Ihrer Umgebung nicht richtig funktioniert. 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 embedded-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 erfassen:

   Linux

   ./mcdc discover ssh IP_HOSTNAME

   Windows

   mcdc.exe discover ssh IP_HOSTNAME

   Ersetzen Sie IP_HOSTNAME durch den IP-Hostnamen der Maschine.

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

   Wenn Sie dazu aufgefordert werden, geben Sie den Nutzernamen eines Kontos auf dem Linux-Computer ein. Das Erfassungsskript wird mit diesen Anmeldedaten ausgeführt. Wenn sich der private SSH-Schlüssel des Nutzers, der die mcdc-Befehlszeile aufruft, nicht mit dem Nutzernamen bei dem Computer authentifizieren kann, werden Sie ebenfalls zur Eingabe eines Passworts aufgefordert.

Weitere Szenarien bei der Verwendung von SSH

In den folgenden Szenarien 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.

  Geben Sie das Passwort für den Nutzer ein, wenn Sie dazu aufgefordert werden.

• 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 Nutzer, den Sie im Befehl angeben, über SSH auf den Computer zugreifen können und auf dem Computer Berechtigungen zum Ausführen des Erfassungsskripts haben.

• 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 Befehlszeilenbefehl 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 durchführen.

Remote-Erhebung von Daten über WMI

Wenn Sie eine Gasterkennung 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-Befehlszeile gehostet wird. Die WMI-Sammlung wird nur in der Windows-Version der mcdc-Befehlszeile unterstützt.

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

1. Lädt das Erfassungsskript auf den Computer hoch.

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

   Hinweis: Für die Nutzeranmeldedaten des Computers sind keine Administratorrechte erforderlich. Mit dem Root-Zugriff kann die mcdc-Befehlszeile aber alle Bewertungsdaten erfassen.

3. Ergebnisse herunterladen und importieren

So erfassen Sie Daten über WMI:

1. Melden Sie sich auf dem Windows-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 erfassen:

   mcdc.exe discover wmi IP_HOSTNAME
   

   Ersetzen Sie IP_HOSTNAME durch den IP-Hostnamen der Maschine.

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

Daten auf einzelnen Linux-Computern erfassen

Wenn Sie eine Gasterfassung lokal auf einem Linux-Computer ausführen möchten, können Sie das Skript mcdc-linux-collect.sh ausführen. Anschließend können Sie die vom Skript generierte TAR-Datei auf den Computer kopieren, auf dem die mcdc-Befehlszeile 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 Skript mit den Berechtigungen des Nutzers ausführen, der die mcdc-Befehlszeile ausführt. Das Skript 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 Skript zur 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 mit dem Namen 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 Gastsammlung 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 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 erfassten Daten online im Migrationscenter exportieren und bewerten oder eine Offlinebewertung durchführen.

Daten auf einem einzelnen Windows-Computer erfassen

Wenn Sie eine Gasterfassung lokal auf einem Windows-Computer ausführen möchten, können Sie das Skript mcdc-windows-collect.ps1 ausführen. Anschließend können Sie die vom Skript erstellte 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 mit dem Namen mcdc-collect-MACHINE_NAME-TIMESTAMP.zip in das aktuelle Verzeichnis aus.

   Optional können Sie einen Ausgabepfad hinzufügen, 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 erfassten Daten exportieren und im Migrationscenter online bewerten oder eine Offlinebewertung durchführen.

Nächste Schritte

• IP-Bereichsscan ausführen
• Erfasste Daten in das Migrationscenter exportieren