Migración de instancias gestionadas al hub de OS Management

Migre las instancias gestionadas de OS Management al hub de OS Management mediante los perfiles de registro adecuados. El asistente de migración también soporta la migración masiva de instancias al hub de OS Management.

Requisitos
  • Cree los recursos necesarios del hub de gestión del sistema operativo y resuelva cualquier problema de compatibilidad para garantizar una migración correcta. Para obtener más información, consulte Flujo de trabajo de migración.
  • Verifique que las instancias utilizan Oracle Cloud Agent versión 1.40 o posterior. OS Management Hub requiere como mínimo la versión 1.40 de Oracle Cloud Agent. Para las instancias que utilizan imágenes de plataforma publicadas antes de abril de 2024, actualice Oracle Cloud Agent a la versión 1.40 o posterior.
Consejo

Para que sea más sencillo y eficaz, le recomendamos que utilice la herramienta de asistente de migración para realizar esta tarea. Para obtener más información, consulte instalación del asistente de migración.

Uso del Asistente de Migración

Utilice el comando osms-to-osmh migrate managed-instance y los parámetros necesarios para migrar instancias gestionadas de OS Management al servicio del hub de OS Management.

La instancia tarda hasta 20 minutos en anular el registro de OS Management y registrarse en OS Management Hub como parte del proceso de migración.

Migración de una instancia

Puede migrar una instancia gestionada de OS Management al hub de OS Management especificando el OCID asignado a la instancia.

Por ejemplo:

osms-to-osmh migrate managed-instance --managed-instance-id ocid 

El comando primero comprueba si las instancias gestionadas ya se han migrado al hub de OS Management. En caso afirmativo, no se necesita realizar ninguna acción. De lo contrario, el comando le solicitará el perfil que se utilizará para registrar la instancia con OS Management Hub.

Este es un ejemplo de salida:

$ 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
      
    
Migración masiva de instancias

Puede migrar varias instancias gestionadas de OS Management al hub de OS Management con el mismo perfil especificando una lista separada por comas de los OCID de instancia y el OCID de perfil. Puede migrar en bloque hasta 5 instancias directamente en la línea de comandos.

Por ejemplo:

osms-to-osmh migrate managed-instance --managed-instance-id ocid1,ocid2,ocid3 --profile profile -y

Si tiene más de 5 instancias que migrar o tiene instancias que utilizan perfiles variables, puede realizar una migración masiva de instancias gestionadas de OS Management al hub de OS Management mediante una asignación de JSON. Consulte Detalles de opción para obtener información sobre el formato de archivo de asignación de JSON.

Por ejemplo:

osms-to-osmh migrate managed-instance --mi-profile-map file://json_file -y

Las migraciones masivas se ejecutan en paralelo. Puede controlar el número de instancias que migran en paralelo con la opción --threads (el valor por defecto es 3).

La columna Estado cambia a medida que las instancias pasan por sus fases de migración. A continuación, se muestra un ejemplo de salida que muestra las instancias que están pasando por la etapa de validación de la migración.


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)

Cuando se realiza la migración masiva, la columna Estado se actualiza a Listo.


OCID                             Status                                                
-------------------------------  ------  
ocid1.instance.oc1..<unique_ID>  Done
ocid1.instance.oc1..<unique_ID>  Done
ocid1.instance.oc1..<unique_ID>  Done

Successfully migrated 3 instances

Sintaxis

osms-to-osmh [--threads number] migrate managed-instance --managed-instance-id ocid [--profile ocid] [--mi-profile-map map]  [-y | --yes] [ --help]

Detalles Opción

parámetro Descripción
--threads number Define el número de instancias que se van a migrar en paralelo. El rango es de 2 a 10 (el valor predeterminado es 3).
--managed-instance-id ocid

Migra la instancia gestionada de OS Management al hub de OS Management. Para ocid, especifique el OCID asignado a la instancia gestionada.

Especifique una lista separada por comas de OCID para migrar más de una instancia gestionada. Puede especificar hasta 5 OCID de instancia.

--profile ocid

Especifica el perfil de registro que se va a asociar a las instancias gestionadas que se van a migrar al hub de OS Management. Para ocid, especifique el OCID asignado al perfil.

Si no se especifica este parámetro opcional, el comando le solicita que especifique un perfil.

--mi-profile-map map

Especifica la entrada JSON para asociar instancias gestionadas con perfiles para la migración por lotes. Para map, especifique una cadena JSON o una ruta de archivo a un archivo JSON. El formato de entrada JSON es el siguiente:

{
    "managed-instance-ocid":"profile-ocid",
    "managed-instance-ocid":"profile-ocid",
    .....
}
-y | --yes Continúa con las acciones necesarias para migrar la instancia sin solicitarle confirmación.
--help Muestra información de ayuda sobre el comando del asistente de migración, como las opciones disponibles y los valores admitidos para cada opción.

Uso de la consola

  1. Abra el menú de navegación, seleccione Compute y, a continuación, seleccione Instances.
  2. Haga clic en la instancia en la que está interesado.
  3. Haga clic en el separador Oracle Cloud Agent.
  4. Para el plugin de OS Management Service Agent, cambie el conmutador Activar plugin a Desactivar.

    Este paso desactiva el plugin de OS Management Service Agent en la instancia. El cambio tarda hasta 10 minutos en surtir efecto.

  5. Active el plugin de OS Management Hub Agent.
    1. Para el plugin del hub de gestión del sistema operativo, cambie el conmutador Activar plugin a Activar.
    2. Seleccione un perfil para registrar la instancia.

      El cambio tarda hasta 10 minutos en surtir efecto.

  6. Cree los trabajos programados en el hub de OS Management que ha identificado en la etapa de detección.
Nota

Para obtener más información sobre cómo activar y ejecutar plugins, consulte Gestión de plugins con Oracle Cloud Agent.