Migration d'instances gérées vers OS Management Hub
Migrez les instances gérées par OS Management vers OS Management Hub à l'aide des profils d'inscription appropriés. L'assistant de migration prend également en charge la migration en masse d'instances vers OS Management Hub.
- Prérequis
-
- Créez les ressources OS Management Hub nécessaires et résolvez les problèmes de compatibilité afin de garantir le succès de la migration. Pour plus d'informations, reportez-vous à la section Migration Workflow.
- Vérifiez que les instances utilisent l'agent Oracle Cloud version 1.40 ou ultérieure. OS Management Hub requiert la version 1.40 minimale de l'agent Oracle Cloud. Pour les instances utilisant des images de plate-forme publiées avant avril 2024, mettez à niveau l'agent Oracle Cloud vers la version 1.40 ou ultérieure.
Pour plus de simplicité et d'efficacité, nous vous recommandons d'utiliser l'outil Assistant de migration pour effectuer cette tâche. Pour plus d'informations, reportez-vous à la section Installing the Migration Assistant.
Utilisation de l'assistant Migration
Utilisez la commande osms-to-osmh migrate managed-instance
et les paramètres requis pour migrer les instances gérées d'OS Management vers le service OS Management Hub.
La désinscription de l'instance d'OS Management et son inscription à OS Management Hub dans le cadre du processus de migration prennent jusqu'à 20 minutes.
- Migration d'une instance
-
Vous pouvez migrer une instance gérée d'OS Management vers OS Management Hub en indiquant l'OCID affecté à l'instance.
Par exemple :
osms-to-osmh migrate managed-instance --managed-instance-id ocid
La commande vérifie d'abord si les instances gérées ont déjà migré vers OS Management Hub. Si tel est le cas, aucune action supplémentaire n'est requise. Dans le cas contraire, la commande vous invite à indiquer le profil à utiliser pour inscrire l'instance auprès d'OS Management Hub.
Voici un exemple de sortie :
$ osms-to-osmh migrate managed-instance --managed-instance-id ocid1.instance.oc1..<unique_ID> Migrating instance: ocid1.instance.oc1..<unique_ID> Fetching compatible profiles for instance Available profiles: S.No. Name Profile Type ----- ------- -------------- 1 ol9-arm SOFTWARESOURCE Select a profile: 1 Migrate ol9-mi01 to OS Management Hub with ol9-arm? [y/n] y Attaching profile ol9-arm to ol9-mi01 Disabling OS Management Service Agent Enabling OS Management Hub Agent Registering instance with OS Management Hub.............. Instance migrated successfully
- Migration en masse d'instances
-
Vous pouvez migrer plusieurs instances gérées par OS Management vers OS Management Hub avec le même profil en indiquant une liste d'OCID d'instance séparés par des virgules et l'OCID de profil. Vous pouvez migrer en masse jusqu'à 5 instances directement sur la ligne de commande.
Par exemple :
osms-to-osmh migrate managed-instance --managed-instance-id ocid1,ocid2,ocid3 --profile profile -y
Si vous avez plus de 5 instances à migrer ou que vous avez des instances utilisant des profils variables, vous pouvez effectuer une migration en masse d'instances gérées OS Management vers OS Management Hub à l'aide d'une correspondance JSON. Pour plus d'informations sur le format de fichier de mapping JSON, reportez-vous à Détails de l'option.
Par exemple :
osms-to-osmh migrate managed-instance --mi-profile-map file://json_file -y
Les migrations en masse s'exécutent en parallèle. Vous pouvez contrôler le nombre d'instances qui migrent en parallèle avec l'option
--threads
(la valeur par défaut est 3).La colonne Statut change au fur et à mesure que les instances passent par leurs phases de migration. Voici un exemple de sortie indiquant les instances qui passent par l'étape de validation de la migration.
OCID Status ------------------------------- ------------------------------------------------------ ocid1.instance.oc1..<unique_ID> Validating Instance (This might take up to 20 minutes) ocid1.instance.oc1..<unique_ID> Validating Instance (This might take up to 20 minutes) ocid1.instance.oc1..<unique_ID> Validating Instance (This might take up to 20 minutes)
Une fois la migration en masse terminée, la colonne Statut prend la valeur Terminé.
OCID Status ------------------------------- ------ ocid1.instance.oc1..<unique_ID> Done ocid1.instance.oc1..<unique_ID> Done ocid1.instance.oc1..<unique_ID> Done Successfully migrated 3 instances
Syntaxe
osms-to-osmh [--threads number] migrate managed-instance --managed-instance-id ocid [--profile ocid
] [--mi-profile-map map] [-y | --yes] [ --help]
Détails de l'option
Paramètre | Description |
---|---|
--threads number |
Définit le nombre d'instances à migrer en parallèle. La plage va de 2 à 10 (la valeur par défaut est 3). |
--managed-instance-id |
Migre l'instance gérée d'OS Management vers OS Management Hub. Pour ocid, indiquez l'OCID affecté à l'instance gérée. Indiquez une liste d'OCID séparés par des virgules pour migrer plusieurs instances gérées. Vous pouvez indiquer jusqu'à 5 OCID d'instance. |
--profile |
Spécifie le profil d'inscription à associer aux instances gérées en cours de migration vers OS Management Hub. Pour ocid, indiquez l'OCID affecté au profil. Si ce paramètre facultatif n'est pas spécifié, la commande vous invite à spécifier un profil. |
--mi-profile-map map |
Indique l'entrée JSON permettant d'associer des instances gérées à des profils pour la migration par lots. Pour map, indiquez une chaîne JSON ou un chemin de fichier vers un fichier JSON. Le format d'entrée JSON est le suivant :
|
-y | --yes |
Poursuit les actions requises pour migrer l'instance sans vous demander de confirmation. |
--help |
Affiche des informations d'aide sur la commande de l'assistant de migration, telles que les options disponibles et les valeurs prises en charge pour chaque option. |
Utilisation de la console
Pour plus d'informations sur l'activation et l'exécution des plug-ins, reportez-vous à Gestion des plug-ins avec l'agent Oracle Cloud.