J.2 Avant d'utiliser l'outil

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).

<add key ="encoded" value="no"/>

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.