J.2 Avant d'utiliser l'outil

Cette section présente les informations suivantes :

J.2.1 Préconfiguration des valeurs du serveur Migrate pour l'ILC

Avant de commencer à utiliser l'utilitaire de ligne de commande, vous devez vous assurer que le serveur Migrate est correctement configuré. Vous pouvez vérifier sa configuration dans le fichier PlateSpin.Migrate.Console.exe.config, situé au même emplacement que l'utilitaire de ligne de commande. Une fois Migrate installé, des valeurs doivent normalement figurer dans le fichier .config suivant.

<?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="mot_de_passe_codé"/>
    <add key ="encoded" value="yes"/>
  </appSettings>
</configuration>

L'outil utilise ces valeurs lorsqu'il exécute des commandes. Vous devez faire correspondre les valeurs du fichier avec les paramètres du serveur Migrate auquel vous souhaitez vous connecter.

La valeur de la clé pspassword est vide par défaut et vous devez spécifier un mot de passe chiffré en tant que valeur. Pour coder le mot de passe, utilisez la commande encode. Pour plus d'informations sur les commandes, reportez-vous à la Section J.2.2, Familiarisation avec les commandes.

Si vous choisissez de fournir des mots de passe chiffrés pour le workload source et la plate-forme cible, définissez la valeur de la clé codée dans la ligne suivante du fichier PlateSpin.Migrate.Console.exe.config sur yes (oui). Dans le cas contraire, définissez cette valeur sur no (non).

J.2.2 Familiarisation avec les commandes

Vous pouvez afficher les commandes prises en charge dans l'outil en exécutant l'option Aide ou avec l'option ? à partir de l'invite de commande, comme suit :

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

L'outil affiche une matrice qui contient des informations similaires à celles incluses dans le tableau suivant :

Tableau J-1 Commandes disponibles dans l'outil ILC de Migrate

Commande	Description
run	Exécute un fichier .ini configuré en tant que tâche planifiée. Lorsque vous ajoutez le paramètre /wait=no et que l'exécution de la tâche débute, son ID s'affiche dans l'interface.
query	Exécute une requête sur la tâche (lorsque vous précisez un ID de tâche) pour afficher son état en cours.
discover	Exécute une opération qui inventorie les détails d'un workload ou d'un ordinateur cible pris en charge en vue d'une tâche de migration ou de « conversion ».
refresh	Rafraîchit un serveur découvert.
unDiscover	Annule la découverte d'un serveur.
imageserver	Effectue les opérations de création d'images sur un workload (c'est-à-dire installer le serveur, désinstaller le serveur et mettre à jour les outils) sur un serveur.
ignorer	Abandonne une tâche planifiée.
licenseInfo	Affiche les informations de licence du serveur de migration.
serversync	Prépare le serveur en vue de l'opération de synchronisation, puis exécute un travail serversync à l'aide du fichier de configuration.
encode	Code l'entrée texte ou les données dans le fichier texte.
massdiscover	Effectue une découverte de masse des workloads sources et des cibles. Les cibles et les workloads découverts sont affichés à la fois dans le client PlateSpin Migrate et dans l'interface Web de PlateSpin Migrate. Pour effectuer une découverte de masse des workloads et des cibles, vous devez d'abord dresser la liste des workloads et cibles à découvrir dans un fichier CSV. Pour créer ce fichier CSV, reportez-vous à l'exemple de fichier CSV qui se trouve à l'emplacement \PlateSpin Migrate Client\CommandLine\Sample INI\MassDiscovery.csv.

Lorsque vous exécutez l'une de ces commandes, vous devez inclure les paramètres requis correspondants dans la ligne de commande. Vous pouvez également inclure quelques paramètres facultatifs, si nécessaire. Par exemple, le paramètre savejob= enregistre la tâche à l'emplacement par défaut.

Pour afficher une liste des paramètres à l'invite de commande, exécutez la commande sans paramètre. Par exemple, si vous exécutez la commande discover sans paramètres, comme suit :

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

L'interface de ligne de commande affiche ceci :

[discover]                      découvre un serveur
Paramètres obligatoires :
    /machineAddress=      adresse de la machine à découvrir
    /UserName=            nom d'utilisateur à employer
    /password=            mot de passe à utiliser
    /type=                type comme windows, linux, vmware_esx, vmware_vcenter
    Paramètres facultatifs :
    /network=             nom du réseau auquel se connecter
    /address=             adresse du serveur auquel se connecter
    /psuser=              nom d'utilisateur pour accéder au serveur PlateSpin Migrate avec un autre nom d'utilisateur que celui actuellement connecté à cet ordinateur
    /pspassword=          mot de passe utilisé pour accéder au serveur PlateSpin Migrate avec un autre nom d'utilisateur que celui actuellement connecté à cet ordinateur
    /wait=                attendre que la tâche soit terminée [oui, non]
    /clusterName=         vnom de la grappe à découvrir
    /verbose=             = mode verbeux pour la sortie [actif, inactif]
    /output=              fichier de sortie
    /format=              sortie à afficher au format [texte, html, xml]
    /sslcertificatewarnings= ignorer ou appliquer les avertissements de certificats SSL [ignorer | appliquer]

REMARQUE :vous devez vous familiariser avec les différentes commandes ILC et leurs paramètres obligatoires et facultatifs.

Syntaxe de la ligne de commande

Si vous devez exécuter la commande discover (qui est également une tâche), vous devez normalement utiliser une syntaxe semblable à celle de cet exemple, à l'invite de commande :

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

Notez que tous les paramètres obligatoires ainsi qu'un paramètre facultatif sont inclus dans cet exemple.

Lorsque la commande discover (tâche) démarre, l'outil ILC affiche son ID de tâche, qui se présente comme suit :

8be8d306-7665-4869-9795-a9dbb3ce1471

Vous pouvez utiliser cet ID pour connaître l'état de la tâche, en utilisant simplement la commande query comme ceci :

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

La commande query produit un rapport d'état qui inclut tous les détails de la tâche. Il s'agit du même type d'informations que celles visibles dans la vue Tâches du client PlateSpin Migrate.