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

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 ocid

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 ocid

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 :

{
    "managed-instance-ocid":"profile-ocid",
    "managed-instance-ocid":"profile-ocid",
    .....
}
-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

  1. Ouvrez le menu de navigation, sélectionnez Compute, puis Instances.
  2. Cliquez sur l'instance qui vous intéresse.
  3. Cliquez sur l'onglet Agent Oracle Cloud.
  4. Pour le module d'extension Agent de service OS Management, basculez le commutateur Activer le module d'extension sur Désactiver.

    Cette étape désactive le module d'extension Agent de service OS Management sur l'instance. L'application de la modification prend jusqu'à 10 minutes.

  5. Activez le module d'extension Agent OS Management Hub.
    1. Pour le module d'extension OS Management Hub, basculez le commutateur Activer le module d'extension sur Activer.
    2. Sélectionnez un profil pour inscrire l'instance.

      L'application de la modification prend jusqu'à 10 minutes.

  6. Créez les travaux programmés dans OS Management Hub que vous avez identifiés lors de la phase de repérage.
Remarque

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.