Migration d'instances OS Management vers OS Management Hub

Migrez les instances OS Management vers OS Management Hub en repérant les ressources OS Management en cours d'utilisation, en créant les ressources équivalentes dans OS Management Hub et en migrant les instances.

OS Management Hub fournit un assistant de migration pour vous aider à effectuer chaque étape de la migration. L'assistant de migration prend en charge les opérations de repérage, de création et de migration en masse afin de simplifier le passage à OS Management Hub. La migration peut également être effectuée manuellement à l'aide de la console OCI sur une base par instance.

Remarque

À compter du 23 avril 2025, le service Oracle OS Management atteint la fin de vie (EOL). OS Management est remplacé par OS Management Hub, qui offre une expérience utilisateur améliorée avec de nouvelles fonctionnalités, notamment des déploiements de patches via des étapes de cycle de vie, une planification de travail améliorée et des fonctionnalités de reporting.

Avant la date de fin de vie, nous vous recommandons de migrer les instances gérées d'OS Management vers OS Management Hub.

Phases de la migration

La migration d'OS Management vers OS Management Hub est un processus en trois étapes.

Repérage : examinez vos instances OS Management et déterminez les sources logicielles, les groupes d'instances gérées et les travaux programmés dont vous avez besoin pour vos instances gérées, et résolvez les problèmes d'incompatibilité.
Créer : créez les ressources requises dans OS Management Hub à l'aide des informations que vous avez déterminées lors du repérage. Ajouter des sources logicielles fournisseur et créer des sources logicielles personnalisées, créer des groupes et créer des profils d'enregistrement.
Migrer : désinscrivez vos instances d'OS Management et utilisez un profil pour les inscrire auprès d'OS Management Hub.

Avant de commencer

Avant de migrer des instances OS Management vers OS Management Hub, vous devez effectuer les opérations suivantes :

Consultez et comprenez le service OS Management Hub.
Effectuez les tâches de prise en main pour OS Management Hub.
Vérifiez que vos instances OS Management utilisent l'agent Oracle Cloud version 1.40 ou ultérieure avant de procéder à la migration. OS Management Hub requiert la version 1.40 minimale de l'agent Oracle Cloud.
Créez une instance OCI et enregistrez-la dans OS Management Hub pour vous familiariser avec le service en effectuant les tâches suivantes :
1. (Oracle Linux uniquement) Ajouter des sources logicielles de fournisseur.
2. Créez un profil d'enregistrement pour inscrire l'instance.
3. Inscrivez l'instance auprès d'OS Management Hub.

Important

L'inscription d'une instance auprès d'OS Management Hub vous donne également accès à l'assistant de migration.

Stratégie IAM requise

Pour migrer des instances, vous devez disposer des droits d'accès de location pour OS Management et OS Management Hub. Pour plus d'informations, reportez-vous à Configuration de stratégies IAM pour OS Management et à Stratégie IAM requise pour OS Management Hub.

L'assistant de migration a des exigences de stratégie supplémentaires. Pour utiliser l'assistant de migration, vous avez besoin de la stratégie suivante.

allow group group-name to inspect compartments in tenancy
allow group group-name to use tag-namespaces in tenancy
allow group group-name to use instances in tenancy
allow group group-name to inspect work-requests in tenancy

La première ligne permet au groupe d'utilisateurs de répertorier les compartiments de la location.
La deuxième ligne permet au groupe d'utilisateurs de mettre à jour les espaces de noms de balise des ressources de la location. L'assistant de migration utilise des balises pour suivre les ressources migrées vers OS Management Hub.
La troisième ligne permet au groupe d'utilisateurs de répertorier les instances et de mettre à jour leurs balises pour suivre le statut de migration.
La quatrième ligne permet au groupe d'utilisateurs de surveiller le statut des modules d'extension d'agent Oracle Cloud OS Management et OS Management Hub. L'assistant de migration utilise ces informations pour vérifier que les migrations d'instance ont réussi.

Workflow de migration

Utilisez les workflows suivants pour migrer des instances OS Management vers OS Management Hub en fonction de votre cas d'emploi :

Si vous migrez une seule instance OCI, migrez l'instance OCI à l'aide de la console.
Si vous migrez plusieurs instances OCI, migrez les instances en masse à l'aide de l'assistant de migration.

Migration d'une instance unique à l'aide de la console

Définissez la stratégie IAM, le groupe dynamique et le groupe d'utilisateurs requis pour OS Management Hub.
(Oracle Linux uniquement) Identifiez toutes les sources logicielles fournisseur utilisées par l'instance et ajoutez les sources logicielles fournisseur à OS Management Hub.
(Oracle Linux uniquement) Identifiez toutes les sources logicielles personnalisées utilisées par l'instance et créez-les dans OS Management Hub.
Sélectionnez un profil pour inscrire l'instance. Si nécessaire, créez un profil dans OS Management Hub.
Migrez l'instance à l'aide de la console.

Migrer des instances en masse à l'aide de l'assistant de migration

Définissez la stratégie IAM, le groupe dynamique et le groupe d'utilisateurs requis pour OS Management Hub.
Inscrivez une instance auprès d'OS Management Hub, familiarisez-vous avec le service et le fonctionnement des profils d'inscription et accédez à l'assistant de migration.
Accédez aux utilitaires de l'assistant de migration et installez-les pour vous aider à effectuer les tâches requises pour la migration.
(Oracle Linux uniquement) Identifiez toutes les sources logicielles fournisseur utilisées par les instances gérées par OS Management et ajoutez les sources logicielles fournisseur à OS Management Hub.
(Oracle Linux uniquement) Identifiez toutes les sources logicielles personnalisées utilisées par les instances gérées par OS Management, résolvez les problèmes d'incompatibilité et créez-les dans OS Management Hub.
Identifiez tous les groupes d'instances gérées dans OS Management, résolvez les problèmes d'incompatibilité et créez les ressources de groupe dans OS Management Hub.
Identifiez les instances gérées, résolvez les problèmes d'incompatibilité et créez des profils pour inscrire les instances auprès du service OS Management Hub.
Migrer des instances vers OS Management Hub à l'aide du profil approprié.

Assistant Migration

L'assistant de migration fournit un ensemble d'utilitaires pour vous aider à chaque étape de la migration des instances d'OS Management vers OS Management Hub. Pour installer l'assistant de migration, reportez-vous à la section Installing the Migration Assistant.


Préparation	Utilitaires de l'assistant Migration
Repérage	Identifier les ressources OS Management en cours d'utilisation et mettre en évidence les problèmes de migration potentiels, tels que les sources logicielles incompatibles ou les groupes d'instances gérées. Les utilitaires suggèrent comment résoudre les problèmes d'incompatibilité détectés avec une ressource. Les utilitaires suivants de l'assistant de migration sont disponibles pour identifier les ressources OS Management en cours d'utilisation : `osms-to-osmh discover vendor-software-source` `osms-to-osmh discover custom-software-source` `osms-to-osmh discover managed-instance-group` `osms-to-osmh discover managed-instance`
Créer	Créez les ressources OS Management Hub requises pour prendre en charge vos instances gérées, y compris les sources logicielles, les groupes, les travaux programmés et les profils d'inscription. Les utilitaires suivants de l'assistant de migration sont disponibles pour créer des ressources OS Management Hub : `osms-to-osmh create vendor-software-source` `osms-to-osmh create custom-software-source` `osms-to-osmh create managed-instance-group` `osms-to-osmh create profile`
Migration	Migrez des instances d'OS Management vers OS Management Hub à l'aide d'un profil d'inscription approprié. L'assistant de migration prend également en charge la migration en masse d'instances. L'utilitaire d'assistant de migration suivant est disponible pour migrer des instances : `osms-to-osmh migrate managed-instance`
Annuler	Renvoyez une instance gérée à OS Management, si nécessaire. L'utilitaire d'assistant de migration suivant est disponible pour annuler (rollback) les instances : `osms-to-osmh rollback managed-instance`

Installation de l'assistant Migration

Vous pouvez installer l'assistant de migration à l'aide d'Oracle Cloud Infrastructure (OCI) Cloud Shell ou du kit SDK Oracle Cloud Infrastructure (OCI) sur votre système.

Avant d'installer l'assistant de migration :

Assurez-vous que l'environnement répond aux exigences suivantes :
- OCI SDK 2.126 ou version ultérieure.
- Python 3.8 ou version ultérieure. Utilisez la commande python --version pour vérifier la version sur votre système.
Téléchargez l'assistant Migration.

Installez l'assistant de migration à l'aide de l'une des méthodes suivantes :

Conseil

Pour plus de simplicité, nous vous recommandons d'utiliser Cloud Shell pour exécuter l'assistant de migration.

Accès à l'assistant Migration

Inscrivez une instance auprès d'OS Management Hub.
Connectez-vous à l'instance à l'aide de SSH.
Accédez au répertoire approprié et copiez le fichier osms_to_osmh-<version>-py3-none-any.whl :
- Oracle Linux : /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/osms_to_osmh-<version>-py3-none-any.whl
- Windows 2016 : C:\Users\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent\stateDir\osms_to_osmh-<version>-py3-none-any.whl
- Windows 2019/2022 : C:\Windows\ServiceProfiles\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent\stateDir\osms_to_osmh-<version>-py3-none-any.whl
Remarque

Utilisez la version 1.0.155 ou ultérieure de l'assistant de migration pour être compatible avec les mises à jour les plus récentes d'OS Management Hub.
Installez la migration à l'aide de Cloud Shell ou à l'aide du kit SDK OCI.

Utilisation de Cloud Shell

Avant d'installer l'assistant de migration à l'aide de Cloud Shell, assurez-vous que la stratégie IAM requise pour l'utilisation de Cloud Shell et de la mise en réseau publique Cloud Shell est définie :

Stratégie IAM requise pour utiliser Cloud Shell.
Stratégie IAM requise pour le réseau public géré par Cloud Shell afin d'installer les utilitaires de l'assistant de migration.

Téléchargez le fichier osms_to_osmh-<version>-py3-none-any.whl vers Cloud Shell.
Assurez-vous que le réseau Cloud Shell est défini sur Public.

Installez l'assistant de migration dans Cloud Shell.

/home/oci/lib/oracle-cli/bin/python3 -m pip install osms_to_osmh-<version>-py3-none-any.whl

Créez le lien symbolique requis pour exécuter les commandes à partir du répertoire de base dans Cloud Shell.
```
ln -s /home/oci/lib/oracle-cli/bin/osms-to-osmh /home/oci/bin/osms-to-osmh
```

Utilisation du kit SDK OCI

Configurez les clés SSH requises pour utiliser les SDK OCI et les toolkits de développement, et configurez les SDK.
Reportez-vous à Configuration et prérequis dans le guide du développeur Oracle Cloud Infrastructure.
Téléchargez le fichier osms_to_osmh-<version>-py3-none-any.whl vers votre système.

Installez l'assistant de migration sur votre système.

python -m pip install osms_to_osmh-<version>-py3-none-any.whl

Documentation Oracle Cloud Infrastructure