G.3 Utilitaire Agent Migrate pour Linux

Avant d'installer ou d'utiliser l'agent Migrate, vérifiez que votre système satisfait aux Conditions requises pour l'utilitaire Agent Migrate.

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

Avant d'installer l'utilitaire Agent Migrate pour Linux, assurez-vous que la machine source dispose de GNU C Library (glibc) 2.11.3 ou version ultérieure.

Veillez à télécharger l'application avec l'architecture appropriée pour vos machines sources Linux. Le nom du fichier respecte la casse.

64 bits : MigrateAgent-x86_64.tar.gz
32 bits : MigrateAgent-x86.tar.gz

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

Connectez-vous au workload Linux source en tant qu'utilisateur root.
Utilisez l'une des méthodes suivantes pour obtenir le fichier MigrateAgent-arch.tar.gz.

Remplacez arch avec l'architecture appropriée (x86_64 ou x86).
- Téléchargez le fichier zip à partir de l'interface Web :
  1. Dans un navigateur Web, lancez l'interface Web de PlateSpin Migrate et connectez-vous.
    
    https://<Your_PlateSpin_Server >/Migrate
    
    Remplacez votre_serveur_PlateSpin par le nom DNS ou l'adresse IP de votre serveur PlateSpin Migrate.
  2. Cliquez sur l'onglet Téléchargements.
  3. Cliquez sur le lien d'application de l'agent Migrate pour la plate-forme Linux appropriée (x86_64 ou x86), puis enregistrez le fichier MigrateAgent-arch.tar.gz.
  -OU-
- Utilisez la commande wget pour copier le fichier à partir du serveur PlateSpin.
  
  REMARQUE :si le système d'exploitation sur l'hôte du serveur PlateSpin accepte uniquement les connexions TLS 1.2, utilisez wget version 1.16.1 ou ultérieure sur votre workload Linux source.
  1. Lancez un terminal, puis entrez :
    wget --no-check-certificate --http-user=<username> --http-password=<password> https://<Your_PlateSpin_Server>/Migrate/Downloads/MigrateAgent-<arch>.tar.gpz
    
    Remplacez votre_serveur_PlateSpin par le nom DNS ou l'adresse IP de votre serveur PlateSpin Migrate. Remplacez arch par x86_64 ou x86.
Ouvrez le fichier MigrateAgent-arch.tar.gz dans le gestionnaire d'archives, puis extrayez le répertoire MigrateAgent et son contenu dans le répertoire root (/).

Vous pouvez également entrer ce qui suit dans une invite shell :
```
tar xvf MigrateAgent-<arch>.tar.gz
```
Remplacez arch par x86_64 ou x86.
Définissez le répertoire sur /MigrateAgent, puis affichez son contenu. Dans un terminal, entrez :
```
cd MigrateAgent
ls
```
Le répertoire contient un fichier commands et le fichier de script MigrateAgent.
Affichez l'aide de la commande en entrant :
```
./MigrateAgent -h
```

G.3.2 Commandes de l'agent Migrate pour Linux

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

./MigrateAgent [Command] [-h]

Le Tableau G-2 décrit les options et arguments disponibles pour la commande MigrateAgent sous Linux.

Tableau G-2 Options de commande et arguments de l'utilitaire Agent Migrate pour Linux

Syntaxe	Description
Commandes
register <serveur> <utilisateur> [[-p password] \| [-pf <chemin_fichier_mot_de_passe>]] Remplacez serveur par le nom DNS ou l'adresse IP de votre serveur PlateSpin Migrate. Remplacez utilisateur par un nom d'utilisateur PlateSpin Server valide. Celui-ci doit être de niveau administrateur et disposer des droits nécessaires pour ajouter un workload. Pour le mot de passe, effectuez l'une des opérations suivantes : Utilisez l'option -p et entrez le mot de passe dans la commande pour le nom d'utilisateur PlateSpin spécifié. -p mypassword Utilisez l'option -pf pour spécifier le chemin d'accès à un fichier qui contient le mot de passe pour le nom d'utilisateur PlateSpin spécifié. -pf /tmp/jsmith-password-file.txt N'indiquez pas le mot de passe dans la commande. Vous serez invité à entrer le mot de passe à la ligne de commande. Exemple : ./MigrateAgent register 10.10.10.101 jsmith -p 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 blkwatch Linux des workloads sources enregistrés. Après avoir supprimé le contrat d'un workload source enregistré, vous devez supprimer manuellement le contrôleur OFX du workload. Reportez-vous à la section Section 42.2.2, Nettoyage des workloads Linux.
status [<serveur>] Remplacez serveur par le nom DNS ou l'adresse IP de votre serveur PlateSpin Migrate.	Affiche l'état d'installation du contrôleur et des pilotes PlateSpin. Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.
driver-install [<serveur>] Remplacez serveur par le nom DNS ou l'adresse IP de votre serveur PlateSpin Migrate.	Installe le pilote blkwatch PlateSpin approprié. Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.
driver-upgrade [<serveur>] Remplacez serveur par le nom DNS ou l'adresse IP de votre serveur PlateSpin Migrate.	Met à niveau le pilote blkwatch PlateSpin installé. Si vous spécifiez le serveur PlateSpin, l'utilitaire recherche les mises à niveau de pilote à partir du serveur.
driver-uninstall	Désinstalle le pilote blkwatch PlateSpin installé sur le workload source Linux.
configure <serveur> <nouveau-serveur> Remplacez serveur par le nom DNS ou l'adresse IP de votre serveur PlateSpin Migrate. Pour nouveau-serveur, indiquez le nouveau nom DNS ou l'adresse IP du serveur PlateSpin Migrate. Exemple : ./MigrateAgent configure 10.10.10.10 10.10.20.20	Arrête le service du contrôleur OFX (ofxcontroller), modifie son fichier de configuration en indiquant la nouvelle adresse 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.
Options de commande
server	Spécifie le nom DNS ou l'adresse IP du serveur PlateSpin Migrate. Télécharge les pilotes blkwatch du serveur spécifié lorsque vous invoquez les options status, driver-install ou driver-upgrade.
user	Indique le nom d'utilisateur du serveur PlateSpin pour un utilisateur de niveau administrateur disposant de droits pour ajouter un workload.
Options
-h, --help	Affiche la syntaxe et les options de la commande.
-p, --password -p <mot_de_passe_utilisateur>	Spécifie le mot de passe du nom d'utilisateur du 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 passwordfile.
-pf, --passwordfile -pf <chemin_fichier_mdp>	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.
Consignation
logging.json	Contient les paramètres de configuration au format JSON pour la consignation des opérations de l'utilitaire Agent Migrate. Pour afficher les paramètres de consignation, utilisez la commande cat : cat MigrateAgent/logging.json Vous pouvez modifier le fichier dans un éditeur de texte. Définissez le niveau de consignation en spécifiant la valeur « level: » sur « DEBUG », « INFO » ou « ERROR ». Par exemple : « level » : « DEBUG » ou « level » : « INFO » ou « level » : « ERROR » Les messages consignés sont écrits par défaut dans le fichier MigrateAgent.log dans le répertoire MigrateAgent. Vous pouvez modifier le paramètre du nom de fichier journal dans le fichier logging.json.
MigrateAgent.log	Contient les messages consignés pour la commande MigrateAgent. Pour afficher le journal, utilisez la commande cat. cat MigrateAgent.log