G.2 Utilitaire Agent Migrate pour Windows

G.2.1 Téléchargement et installation de l'agent Migrate sur un workload Windows source

Pour télécharger et installer l'utilitaire Agent Migrate pour Windows sur le workload source :

Connectez-vous à la machine Windows source en tant qu'administrateur.
Dans un navigateur Web, lancez l'interface Web de PlateSpin Migrate et connectez-vous.
Cliquez sur l'onglet Téléchargements.
Cliquez sur le lien de l'application Agent Migrate pour la plate-forme cible Windows, puis enregistrez le fichier compressé MigrateAgent.cli.exe.
Extrayez le contenu du fichier pour accéder au fichier exécutable.
(Facultatif) Affichez l'aide de l'agent Migrate en entrant :
```
MigrateAgent.cli.exe -h
```

G.2.2 Commandes de l'agent Migrate pour Windows

Pour exécuter l'utilitaire Agent Migrate pour Windows, utilisez la syntaxe suivante :

MigrateAgent.cli.exe {command} [command_option] [/psserver=%IP%]

Le Tableau G-1 décrit les commandes, options de commande et paramètres disponibles pour la commande MigrateAgent.cli.exe sous Windows.

Tableau G-1 Commandes, options de commande et paramètre de l'utilitaire Agent Migrate pour Windows

Syntaxe	Description
Commandes
h \| ? \| help	Affiche la syntaxe et les options de la commande.
logs\|view-logs	Ouvre le répertoire des journaux de l'application.
reg \| register /reg /psserver=%IP% /username=<nom_utilisateur> [[ /password=<mot_de_passe>] \| [/pwdfile=<chemin_fichier_mot_de_passe>]] Si vous ne spécifiez pas de mot de passe ou de chemin d'accès à un fichier qui contient le mot de passe, une invite vous demande le mot de passe. Le mot de passe est masqué lorsque vous le saisissez et il n'apparaît pas dans la liste à traiter. Exemple : MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd	Enregistre cette machine en tant que workload sur le serveur spécifié. Cette commande recherche également les mises à niveau de pilote à partir du serveur PlateSpin spécifié. Permet d'ajouter des workloads qui ne peuvent pas être découverts. Les workloads inscrits diffèrent des workloads découverts pour les raisons suivantes : Les workloads sources inscrits ne stockent pas les informations d'identification de la source. Vous devez utiliser l'agent Migrate pour installer, mettre à niveau et supprimer les pilotes de transfert par bloc des workloads sources inscrits. Après avoir supprimé le contrat d'un workload source inscrit, vous devez supprimer manuellement le contrôleur OFX du workload. Pour supprimer le contrôleur OFX du workload, reportez-vous à l'article de la base de connaissances.
status /status [/psserver=%IP%]	Affiche l'état d'installation du contrôleur et des pilotes PlateSpin sur ce workload. Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.
din\|driver-install /din [/psserver=%IP%]	Installe les pilotes PlateSpin. REMARQUE :Avant d'installer des pilotes de transfert par bloc sur les workloads Windows sources, assurez-vous d'avoir appliqué les dernières mises à jour Windows sur ces workloads. Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.
dup\|driver-upgrade /dup [/psserver=%IP%]	Met à niveau les pilotes PlateSpin. Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.
dun\|driver-uninstall [/dun /psserver=%IP%]	Désinstalle les pilotes PlateSpin.
con \| config /con /setting=<nom_paramètre>:<valeur> Exemple : migrateagent.cli.exe /config /setting=psserver:10.10.10.202	Indique le nom du paramètre et sa valeur à modifier dans le fichier de configuration sur ce workload. L'option psserver arrête le service du contrôleur OFX (ofxcontroller), modifie le fichier OfxController.exe.config en indiquant la nouvelle adresse IP et redémarre le service. Si vous modifiez l'adresse IP publique du serveur PlateSpin, vous devez exécuter cette commande sur chacun des workloads sources configurés pour le serveur.
Paramètre
/psserver=%IP%	Spécifie l'adresse IPv4 du serveur PlateSpin. Télécharge les pilotes de transfert par bloc du serveur spécifié lorsque vous invoquez les options status, driver-install ou driver-upgrade.
Options de commande
username /username=valeur	Indique le nom d'utilisateur du serveur PlateSpin pour un utilisateur de niveau administrateur disposant de droits pour ajouter un workload.
password \| pwd \| p /password= valeur	Spécifie le mot de passe du nom d'utilisateur spécifié pour le serveur PlateSpin. Si vous excluez le mot de passe de la ligne de commande, le script vous invite à le spécifier. Le mot de passe est masqué lorsque vous le saisissez et il n'apparaît pas dans la liste à traiter. Ne combinez pas cette option avec l'option /pwdfile.
pwdfile \| pf /pwdfile=valeur	Indique le chemin d'accès à un fichier qui contient le mot de passe pour le nom d'utilisateur du serveur PlateSpin spécifié. Ne combinez pas cette option avec l'option password.
setting /setting=<nom_paramètre>:<valeur>	Spécifie le nom du paramètre et la valeur du paramètre de configuration à modifier. Les noms de paramètre pris en charge sont les suivants : psserver altAddress heartbeat

Syntaxe

Description

Commandes

h | ? | help

Affiche la syntaxe et les options de la commande.

logs|view-logs

Ouvre le répertoire des journaux de l'application.

reg | register

/reg /psserver=%IP% /username=<nom_utilisateur> [[ /password=<mot_de_passe>] | [/pwdfile=<chemin_fichier_mot_de_passe>]]

Si vous ne spécifiez pas de mot de passe ou de chemin d'accès à un fichier qui contient le mot de passe, une invite vous demande le mot de passe. Le mot de passe est masqué lorsque vous le saisissez et il n'apparaît pas dans la liste à traiter.

Exemple :

MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd

Enregistre cette machine en tant que workload sur le serveur spécifié. Cette commande recherche également les mises à niveau de pilote à partir du serveur PlateSpin spécifié.

Permet d'ajouter des workloads qui ne peuvent pas être découverts. Les workloads inscrits diffèrent des workloads découverts pour les raisons suivantes :

Les workloads sources inscrits ne stockent pas les informations d'identification de la source.
Vous devez utiliser l'agent Migrate pour installer, mettre à niveau et supprimer les pilotes de transfert par bloc des workloads sources inscrits.
Après avoir supprimé le contrat d'un workload source inscrit, vous devez supprimer manuellement le contrôleur OFX du workload. Pour supprimer le contrôleur OFX du workload, reportez-vous à l'article de la base de connaissances.

status

/status [/psserver=%IP%]

Affiche l'état d'installation du contrôleur et des pilotes PlateSpin sur ce workload.

Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.

din|driver-install

/din [/psserver=%IP%]

Installe les pilotes PlateSpin.

REMARQUE :Avant d'installer des pilotes de transfert par bloc sur les workloads Windows sources, assurez-vous d'avoir appliqué les dernières mises à jour Windows sur ces workloads.

Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.

dup|driver-upgrade

/dup [/psserver=%IP%]

Met à niveau les pilotes PlateSpin.

Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.

dun|driver-uninstall

[/dun /psserver=%IP%]

Désinstalle les pilotes PlateSpin.

con | config

/con /setting=<nom_paramètre>:<valeur>

Exemple :

migrateagent.cli.exe /config /setting=psserver:10.10.10.202

Indique le nom du paramètre et sa valeur à modifier dans le fichier de configuration sur ce workload.

L'option psserver arrête le service du contrôleur OFX (ofxcontroller), modifie le fichier OfxController.exe.config en indiquant la nouvelle adresse IP et redémarre le service. Si vous modifiez l'adresse IP publique du serveur PlateSpin, vous devez exécuter cette commande sur chacun des workloads sources configurés pour le serveur.

Paramètre

/psserver=%IP%

Spécifie l'adresse IPv4 du serveur PlateSpin.

Télécharge les pilotes de transfert par bloc du serveur spécifié lorsque vous invoquez les options status, driver-install ou driver-upgrade.

Options de commande

username

/username=valeur

Indique le nom d'utilisateur du serveur PlateSpin pour un utilisateur de niveau administrateur disposant de droits pour ajouter un workload.

password | pwd | p

/password= valeur

Spécifie le mot de passe du nom d'utilisateur spécifié pour le serveur PlateSpin.

Si vous excluez le mot de passe de la ligne de commande, le script vous invite à le spécifier. Le mot de passe est masqué lorsque vous le saisissez et il n'apparaît pas dans la liste à traiter.

Ne combinez pas cette option avec l'option /pwdfile.

pwdfile | pf

/pwdfile=valeur

Indique le chemin d'accès à un fichier qui contient le mot de passe pour le nom d'utilisateur du serveur PlateSpin spécifié.

Ne combinez pas cette option avec l'option password.

setting

/setting=<nom_paramètre>:<valeur>

Spécifie le nom du paramètre et la valeur du paramètre de configuration à modifier.

Les noms de paramètre pris en charge sont les suivants :

psserver
altAddress
heartbeat