J.2 Vor Verwendung des Werkzeugs

Dieser Abschnitt enthält folgende Informationen:

J.2.1 Vorkonfigurieren der Migrate-Serverwerte für die CLI

Bevor Sie damit beginnen, das Befehlszeilenprogramm zu verwenden, müssen Sie sicherstellen, dass der Migrate-Server ordnungsgemäß konfiguriert ist. Sie können die Konfiguration in der Datei PlateSpin.Migrate.Console.exe.config überprüfen, die im gleichen Pfad gespeichert ist wie das Befehlszeilenprogramm. Nach der Installation von Migrate sollte die nachfolgende config-Datei bereits Werte enthalten.

<?xml version="1.0" encoding="utf-8 ?>" 
<configuration> 
  <appSettings> 
    <add key="MigrateServerURL" value="https://localhost/PlateSpinMigrate/"/> 
    <add key="ServerDomain" value=""/> 
    <add key="psuser" value="administrator"/> 
    <add key="pspassword" value="encoded_password"/> 
    <add key ="encoded" value="yes"/> 
  </appSettings> 
</configuration>

Das Werkzeug verwendet diese Werte bei der Ausführung von Befehlen. Sie müssen die Werte in der Datei mit den Einstellungen für den Migrate-Server abgleichen, mit dem Sie eine Verbindung herstellen möchten.

Der Wert für den Schlüssel pspassword ist standardmäßig leer und Sie müssen ein verschlüsseltes Passwort als Wert angeben. Das Passwort wird dabei mit dem Befehl encode verschlüsselt. Weitere Informationen zu Befehlen finden Sie unter Abschnitt J.2.2, Sich mit den Befehlen vertraut machen.

Wenn Sie verschlüsselte Passwörter für den Ursprungs-Workload und die Zielplattform angeben, legen Sie den Wert für den verschlüsselten Schlüssel in der folgenden Zeile der Datei PlateSpin.Migrate.Console.config auf yes fest, ansonsten auf no.

J.2.2 Sich mit den Befehlen vertraut machen

Sie können die im Werkzeug unterstützten Befehle anzeigen, indem Sie es mit der Option Hilfe oder mit der Option? an der Eingabeaufforderung ausführen. Beispiel:

C:\Programme\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe Help

Das Werkzeug zeigt eine Matrix mit Informationen an, die den Informationen in der folgenden Tabelle ähneln:

Tabelle J-1 Im Migrate-CLI-Werkzeug verfügbare Befehle

Befehl	Beschreibung
ausführen	Führt eine konfigurierte .ini-Datei als geplanten Auftrag aus. Wenn Sie den Parameter /wait=no hinzufügen und der Auftrag ausgeführt wird, wird die Auftragskennung an der Schnittstelle angezeigt.
query	Führt eine Abfrage im Auftrag aus (wenn sie eine Auftragskennung angeben), um den aktuellen Status anzuzeigen.
Ermitteln	Führt einen Vorgang aus, durch den die Details eines unterstützten Workloads oder Zielrechners zur Vorbereitung eines Migrations- oder „Konvertierungs“-Auftrags inventarisiert werden.
Aktualisieren	Aktualisiert einen erkannten Server.
unDiscover	Macht die Ermittlung eines Servers rückgängig.
imageserver	Führt Imaging-Vorgänge an einem Workload (also Server installieren, Server deinstallieren, Werkzeuge aktualisieren) an einem Server durch.
Abbrechen	Bricht einen geplanten Auftrag ab.
licenseInfo	Zeigt die Lizenzinformationen für den Migrate-Server an.
serversync	Bereitet den Server auf den Serversynchronisierungsvorgang vor und führt dann einen Serversynchronisierungsauftrag anhand der Konfigurationsdatei aus.
encode	Verschlüsselt die Texteingabe oder die Daten in der Textdatei.
massdiscover	Startet eine Massenermittlung der Ursprungs-Workloads und der Ziele. Die ermittelten Workloads und Ziele werden sowohl im PlateSpin Migrate-Client als auch in der PlateSpin Migrate-Weboberfläche angezeigt. Zur Massenermittlung der Ursprungs-Workloads und der Ziele müssen Sie zunächst die gesuchten Workloads und Ziele in eine CSV-Datei eintragen. Weitere Informationen zum Erstellen dieser CSV-Datei finden Sie in der CSV-Beispieldatei \PlateSpin Migrate Client\CommandLine\Sample INI\MassDiscovery.csv.

Wenn Sie diese Befehle ausführen, müssen Sie deren erforderliche Parameter in der Befehlszeile mit angeben. Sie können gegebenenfalls auch einige optionale Parameter angeben. Mit dem Parameter savejob= wird der Auftrag beispielsweise im standardmäßigen Speicherort gespeichert.

Zur Anzeige einer Liste dieser Parameter an der Eingabeaufforderung können Sie den Befehl ohne Parameter ausführen. Beispiel: Wenn Sie den Befehl discover ohne Parameter angeben

C:\Programme\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover

wird an der Befehlszeilenschnittstelle Folgendes angezeigt:

[discover]                      ermittelt einen Server
Erforderliche Parameter:
    /machineAddress=      zu ermittelnde Computeradresse
    /userName=            der zu verwendende Benutzername
    /password=            das zu verwendende Passwort
    /type=                type like windows, linux,vmware_esx,vmware_vcenter,
    Optionale Parameter:
    /network=             Name des Netzwerks, mit dem eine Verbindung hergestellt werden soll
    /address=             Adresse des Servers, mit dem eine Verbindung hergestellt werden soll
    /psuser=              der Benutzername, der für den Zugriff auf den PlateSpin Migrate-Server verwendet wird, unterscheidet sich von dem des Benutzers, der bei diesem Computer angemeldet ist
    /pspassword=          das Passwort, das für den Zugriff auf den PlateSpin Migrate-Server verwendet wird, unterscheidet sich von dem des Benutzers, der bei diesem Computer angemeldet ist
    /wait=                warten auf Abschluss des Auftrags [yes,no]
    /clusterName=         zu ermittelnder Clustername
    /verbose=             Ausführlicher Modus für Ausgabe [on,off]
    /output=              die Ausgabedatei
    /format=              das Ausgabeformat für die Anzeige [text,html,xml]
    /sslcertificatewarnings=      Angabe, ob SSL-Zertifikat-Warnmeldungen ignoriert (Ignore) oder erzwungen (Enforce) werden sollen [Ignore | Enforce]

HINWEIS:Sie sollten sich mit den verschiedenen CLI-Befehlen und deren entsprechenden erforderlichen und optionalen Parametern vertraut machen.

Befehlszeilensyntax

Falls Sie den Befehl „discover“ ausführen sollten (der auch ein Auftrag ist), würden Sie an der Eingabeaufforderung eine Syntax verwenden, die diesem Beispiel ähnelt:

C:\Programme\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover /machineaddress=10.10.8.100 /username=administrator /password=password /type=windows /wait=no

Beachten Sie, dass in diesem Beispiel alle erforderlichen Parameter und ein optionaler Parameter enthalten sind.

Wenn der Befehl (Auftrag) „discover“ startet, zeigt das CLI-Werkzeug dessen Auftragskennung an wie in dem folgenden Beispiel:

8be8d306-7665-4869-9795-a9dbb3ce1471

Sie können diese Kennung verwenden, um den Status des Auftrags zu erfahren, indem Sie einfach den Befehl query wie folgt verwenden:

C:\Programme\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe query /id=8be8d306-7665-4869-9795-a9dbb3ce1471

Der Befehl „query“ gibt einen Statusbericht aus, der alle Details zum Auftrag enthält. Dabei handelt es sich um die gleichen Informationen, die Sie möglicherweise auch in der Ansicht „Migrate-Client-Aufträge“ sehen.