Migración de instancias de OS Management a OS Management Hub

Migre instancias de OS Management a OS Management Hub detectando los recursos de OS Management en uso, creando los recursos equivalentes en OS Management Hub y migrando instancias.

OS Management Hub proporciona un asistente de migración para ayudarle a realizar correctamente cada etapa de la migración. El asistente de migración soporta operaciones de detección, creación y migración masivas para simplificar la migración al hub de gestión del sistema operativo. La migración también se puede realizar manualmente mediante la consola de OCI por instancia.

Nota

A partir del 23 de abril de 2025, el servicio Oracle OS Management llega al final de su vida útil (EOL). OS Management se sustituye por OS Management Hub, que proporciona una experiencia de usuario mejorada con nuevas funciones, incluidos despliegues de parches a través de etapas del ciclo de vida, programación de trabajos mejorada y capacidades de generación de informes.

Antes de la fecha de fin de vida, recomendamos migrar instancias gestionadas de OS Management al hub de OS Management.

Fases de migración

La migración de OS Management a OS Management Hub es un proceso de tres etapas.

Detectar: examine las instancias de OS Management y determine los orígenes de software, los grupos de instancias gestionadas y los trabajos programados que necesita para las instancias gestionadas y resuelva los problemas de incompatibilidad.
Crear: cree los recursos necesarios en el hub de OS Management con la información que ha determinado en la detección. Agregue orígenes de software de proveedor y cree orígenes de software personalizados, cree grupos y cree perfiles de registro.
Migrar: anule el registro de las instancias de OS Management y utilice un perfil para registrarlas en OS Management Hub.

Antes de empezar

Antes de migrar instancias de OS Management al hub de OS Management, debe hacer lo siguiente:

Revise y comprenda el servicio OS Management Hub.
Complete las tareas de introducción para OS Management Hub.
Verifique que las instancias de OS Management utilizan Oracle Cloud Agent versión 1.40 o posterior antes de migrar. El hub de gestión del sistema operativo necesita una versión mínima de Oracle Cloud Agent 1.40.
Cree una nueva instancia de OCI y regístrela con OS Management Hub para familiarizarse con el servicio realizando estas tareas:

Importante

El registro de una instancia con el hub de gestión del sistema operativo también le proporciona acceso al asistente de migración.

Política de IAM necesaria

Para migrar correctamente instancias, debe tener permisos de arrendamiento para OS Management y OS Management Hub. Para obtener más información, consulte Configuración de políticas de IAM para OS Management y Política de IAM necesaria para OS Management Hub.

El asistente de migración tiene requisitos de política adicionales. Para utilizar el asistente de migración, necesita la siguiente política.

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 primera línea permite al grupo de usuarios mostrar los compartimentos del arrendamiento.
La segunda línea permite al grupo de usuarios actualizar los espacios de nombres de etiqueta para los recursos del arrendamiento. El asistente de migración utiliza etiquetas para realizar un seguimiento de los recursos que se han migrado al hub de gestión del sistema operativo.
La tercera línea permite al grupo de usuarios mostrar instancias y actualizar sus etiquetas para realizar un seguimiento del estado de migración.
La cuarta línea permite al grupo de usuarios supervisar el estado de los plugins de Oracle Cloud Agent del hub de OS Management y OS Management. El asistente de migración utiliza esta información para confirmar que las migraciones de instancias se han realizado correctamente.

Flujo de trabajo de migración

Utilice los siguientes flujos de trabajo para migrar instancias de OS Management al hub de OS Management en función de su caso de uso:

Si va a migrar una única instancia de OCI, migre la instancia de OCI mediante la consola.
Si va a migrar varias instancias de OCI, migre las instancias en bloque mediante el asistente de migración.

Migración de una única instancia mediante la consola

Defina la política de IAM, el grupo dinámico y el grupo de usuarios necesarios para el hub de OS Management.
(Sólo Oracle Linux) Identifique todos los orígenes de software de proveedor que utiliza la instancia y agregue los orígenes de software de proveedor al hub de gestión del sistema operativo.
(Sólo Oracle Linux) Identifique todos los orígenes de software personalizados que utiliza la instancia y cree en OS Management Hub.
Seleccione un perfil para registrar la instancia. Si es necesario, cree un perfil en OS Management Hub.
Migre la instancia mediante la consola.

Migración masiva de instancias mediante el asistente de migración

Defina la política de IAM, el grupo dinámico y el grupo de usuarios necesarios para el hub de OS Management.
Registre una instancia con OS Management Hub y familiarícese con el servicio y cómo funcionan los perfiles de registro y obtenga acceso al asistente de migración.
Acceda e instale las utilidades del asistente de migración para ayudar con las tareas necesarias para la migración.
(Sólo Oracle Linux) Identifique todos los orígenes de software de proveedor que utilizan las instancias gestionadas de OS Management y agregue los orígenes de software de proveedor al hub de OS Management.
(Sólo Oracle Linux) Identifique todos los orígenes de software personalizados que utilizan las instancias gestionadas de OS Management, resuelva problemas de incompatibilidad y cree en OS Management Hub.
Identifique todos los grupos de instancias gestionadas en OS Management, resuelva problemas de incompatibilidad y cree los recursos de grupo en OS Management Hub.
Identifique instancias gestionadas, resuelva problemas de incompatibilidad y cree perfiles para registrar las instancias con el servicio del hub de OS Management.
Migre instancias al hub de gestión del sistema operativo mediante el perfil adecuado.

Asistente de Migración

El asistente de migración proporciona un juego de utilidades para ayudarle con cada etapa de migración de instancias de OS Management al hub de OS Management. Para instalar el asistente de migración, consulte Installing the Migration Assistant.


Almacenar en caché	Utilidades del asistente de migración
Detección	Identifique los recursos de OS Management en uso y resalte posibles problemas de migración, como orígenes de software incompatibles o grupos de instancias gestionadas. Las utilidades sugieren cómo solucionar los problemas de incompatibilidad encontrados con un recurso. Las siguientes utilidades del asistente de migración están disponibles para identificar los recursos de OS Management en uso: `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`
Crear	Cree los recursos del hub de gestión del sistema operativo necesarios para soportar las instancias gestionadas, incluidos los orígenes de software, los grupos, los trabajos programados y los perfiles de registro. Las siguientes utilidades del asistente de migración están disponibles para crear recursos de 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`
Migrar	Migre instancias de OS Management al hub de OS Management mediante un perfil de registro adecuado. El asistente de migración también soporta la migración masiva de instancias. La siguiente utilidad del asistente de migración está disponible para migrar instancias: `osms-to-osmh migrate managed-instance`
Realizar rollback	Si es necesario, devuelva una instancia gestionada a OS Management. La siguiente utilidad del asistente de migración está disponible para revertir instancias: `osms-to-osmh rollback managed-instance`

Instalación del Asistente de Migración

Puede instalar el asistente de migración mediante Oracle Cloud Infrastructure (OCI) Cloud Shell o mediante el SDK de Oracle Cloud Infrastructure (OCI) en el sistema.

Antes de instalar el asistente de migración:

Asegúrese de que su entorno cumple los siguientes requisitos:
- SDK de OCI 2.126 o posterior.
- Python 3.8 o posterior. Utilice el comando python --version para comprobar la versión en el sistema.
Descargue el asistente de migración.

Instale el asistente de migración mediante uno de los siguientes métodos:

Consejo

Para que sea más sencillo, recomendamos que utilice Cloud Shell para ejecutar el asistente de migración.

Acceso al Asistente de Migración

Registre una instancia con OS Management Hub.
Conéctese a la instancia mediante SSH.
Navegue al directorio adecuado y copie el archivo 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
Nota

Utilice la versión 1.0.155 o posterior del asistente de migración para que sea compatible con las actualizaciones más recientes del hub de gestión del sistema operativo.
Instale la migración mediante Cloud Shell o mediante el SDK de OCI.

Uso de Cloud Shell

Antes de instalar el asistente de migración mediante Cloud Shell, asegúrese de que la política de IAM necesaria para utilizar Cloud Shell y las redes públicas de Cloud Shell estén definidas:

Política de IAM necesaria para utilizar Cloud Shell.
Política de IAM necesaria para la red pública gestionada de Cloud Shell para instalar las utilidades del asistente de migración.

Cargue el archivo osms_to_osmh-<version>-py3-none-any.whl en Cloud Shell.
Asegúrese de que la red de Cloud Shell esté definida en Public (Público).

Instale el asistente de migración en Cloud Shell.

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

Cree el enlace simbólico necesario para ejecutar los comandos desde el directorio raíz de Cloud Shell.
```
ln -s /home/oci/lib/oracle-cli/bin/osms-to-osmh /home/oci/bin/osms-to-osmh
```

Uso del SDK de OCI

Configure las claves SSH necesarias para trabajar con los SDK de OCI y los kits de herramientas de desarrollador, y configure los SDK.
Consulte Configuración y requisitos en Oracle Cloud Infrastructure Developer Guide.
Cargue el archivo osms_to_osmh-<version>-py3-none-any.whl en el sistema.

Instale el asistente de migración en el sistema.

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

Documentación de Oracle Cloud Infrastructure