8.0 Utilitaire MigrateAgent

MigrateAgent (MigrateAgent.cli.exe) est un utilitaire de ligne de commande que vous pouvez utiliser pour installer, mettre à niveau, interroger ou désinstaller les pilotes de transfert par bloc. Bien qu'un redémarrage soit toujours requis lors de l'installation, de la désinstallation ou de la mise à niveau des pilotes, cet utilitaire vous permet de mieux contrôler le moment où se produit l'opération et, par conséquent, le moment du redémarrage du serveur. Vous pouvez, par exemple, utiliser l'utilitaire MigrateAgent pour installer les pilotes pendant le temps hors service planifié, au lieu de le faire lors de la première réplication.

La syntaxe de l'utilitaire MigrateAgent se présente comme suit :

MigrateAgent.cli.exe [Option] [/psserver=%IP%]

Le Tableau 8-1 décrit le paramètre et les options disponibles pour la commande MigrateAgent.cli.exe.

Tableau 8-1 Paramètre et options des commandes de MigrateAgent

Utilisation

Description

Options

h |? | help

Affiche la syntaxe et les options de la commande.

logs|view-logs

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

status

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

din|driver-install

Installe les pilotes PlateSpin.

dup|driver-upgrade

Met à niveau les pilotes PlateSpin.

dun|driver-uninstall

Désinstalle les pilotes PlateSpin.

Paramètre

/psserver=%IP%

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

Une copie des pilotes de transfert par bloc est intégrée à l'utilitaire MigrateAgent. Vous pouvez également spécifier le paramètre de ligne de commande /psserver= afin de télécharger les pilotes du serveur PlateSpin lorsque vous invoquez les options status, driver-install ou driver-upgrade. Cela se révèle particulièrement utile lorsqu'un nouveau paquetage de pilotes est appliqué comme correctif au serveur, mais pas à l'utilitaire de ligne de commande MigrateAgent.

REMARQUE :pour éviter toute confusion, il est conseillé d'utiliser MigrateAgent pour installer, désinstaller ou mettre à niveau les pilotes, puis de procéder à un redémarrage avant d'effectuer une réplication.

Il est conseillé de redémarrer le système chaque fois que vous installez, désinstallez ou mettez à niveau les pilotes. Le redémarrage force l'arrêt du pilote en cours d'exécution. Le nouveau pilote est alors appliqué au redémarrage du système. Si vous ne redémarrez pas le système avant d'effectuer une réplication, la source continue à se comporter comme si l'opération n'était pas terminée. Si, par exemple, vous installez des pilotes sans redémarrer le système, la source se comporte comme si aucun pilote n'avait été installé lors de la réplication. De même, si vous mettez à niveau les pilotes sans redémarrer le système, la source continue à utiliser le pilote en cours d'exécution lors de la réplication jusqu'au prochain redémarrage.

Si la version du pilote installé n'est pas la même que celle du pilote en cours d'exécution, l'option status rappelle à l'utilisateur qu'il doit redémarrer. Par exemple :

C:\MigrateAgent\MigrateAgent.cli.exe status
Step 1 of 2: Querying the PlateSpin controller service
   Done
Step 2 of 2: Querying the installed PlateSpin driver version
   Done

The task completed successfully
PlateSpin Controller Service Status
    The PlateSpin Controller service is not installed
   
PlateSpin Driver Status
    Installed Driver Version: 8.0.0.11
    Running Driver Version: Not running. Reboot to load the driver.
    Upgrade Available: No

PlateSpin crée une tâche pour avertir l'utilisateur qu'un redémarrage est nécessaire pour terminer l'installation ou la mise à niveau du pilote. La notification apparaît dans la liste Tâches (Figure 8-1). Au cours de la réplication, la notification apparaît dans la page Détails de la commande (Figure 8-2).

Figure 8-1 Tâche de notification de redémarrage

Figure 8-2 Notification de redémarrage pendant la réplication

Le redémarrage de la machine source applique et démarre les pilotes installés ou mis à niveau. Si le pilote a été installé récemment, une réplication complète ou une réplication de synchronisation des serveurs est requise après le redémarrage afin de s'assurer que toutes les modifications d'une source sont prises en compte. Cette réplication de synchronisation des serveurs sera présentée à l'utilisateur dans le champ État sous la forme d'un avertissement (Figure 8-3). Les réplications incrémentielles suivantes seront effectuées sans avertissement.

Figure 8-3 Notification de synchronisation des serveurs requise