Migrando Instâncias Gerenciadas para o OS Management Hub

Migre instâncias gerenciadas do serviço OS Management para o OS Management Hub usando perfis de registro apropriados. O assistente de migração também suporta a migração em massa de instâncias para o OS Management Hub.

Pré-requisitos
  • Crie os recursos necessários do OS Management Hub e resolva quaisquer problemas de compatibilidade para garantir uma migração bem-sucedida. Para obter mais informações, consulte Workflow de Migração.
  • Verifique se as instâncias estão usando o Oracle Cloud Agent versão 1.40 ou mais recente. O OS Management Hub requer a versão 1.40 mínima do Oracle Cloud Agent. Para instâncias que usam imagens de plataforma lançadas antes de abril de 2024, faça upgrade do Oracle Cloud Agent para 1.40 ou mais recente.
Dica

Para simplicidade e eficiência, recomendamos que você use a ferramenta do assistente de migração para executar essa tarefa. Para obter mais informações, consulte Instalando o Assistente de Migração.

Usando o Assistente de Migração

Use o comando osms-to-osmh migrate managed-instance e os parâmetros necessários para migrar instâncias gerenciadas do serviço OS Management para o serviço OS Management Hub.

Leva até 20 minutos para que a instância cancele o registro no serviço OS Management e se registre no OS Management Hub como parte do processo de migração.

Migrando uma Instância

Você pode migrar uma instância gerenciada do serviço OS Management para o OS Management Hub especificando o OCID designado à instância.

Por exemplo:

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

O comando primeiro verifica se as instâncias gerenciadas já migraram para o OS Management Hub. Em caso afirmativo, nenhuma outra ação é necessária. Caso contrário, o comando solicitará que o perfil seja usado para registrar a instância no OS Management Hub.

Esta é a saída de amostra:

$ 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
      
    
Migrando Instâncias em Massa

Você pode migrar várias instâncias gerenciadas pelo serviço OS Management para o OS Management Hub com o mesmo perfil especificando uma lista separada por vírgulas de OCIDs de instância e o OCID do perfil. Você pode migrar em massa até 5 instâncias diretamente na linha de comando.

Por exemplo:

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

Se você tiver mais de 5 instâncias para migrar ou tiver instâncias usando perfis variados, poderá executar uma migração em massa de instâncias gerenciadas pelo serviço OS Management para o OS Management Hub usando um mapa JSON. Consulte Detalhes da Opção para obter informações sobre o formato de arquivo de mapa JSON.

Por exemplo:

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

As migrações em massa são executadas em paralelo. Você pode controlar o número de instâncias que migram em paralelo com a opção --threads (o padrão é 3).

A coluna Status é alterada à medida que as instâncias passam por suas fases de migração. Veja a seguir um exemplo de saída mostrando instâncias que estão passando pelo estágio de validação da migração.


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)

Quando a migração em massa é concluída, a coluna Status é atualizada para Concluído.


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

Successfully migrated 3 instances

Uso

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

Detalhes da Opção

Parâmetro Descrição
--threads number Define o número de instâncias a serem migradas em paralelo. O intervalo é de 2 a 10 (o padrão é 3).
--managed-instance-id ocid

Migra a instância gerenciada do serviço OS Management para o OS Management Hub. Para ocid, especifique o OCID designado à instância gerenciada.

Especifique uma lista de OCIDs separados por vírgulas para migrar mais de uma instância gerenciada. Você pode especificar até 5 OCIDs de instância.

--profile ocid

Especifica o perfil de registro a ser associado às instâncias gerenciadas que estão sendo migradas para o OS Management Hub. Para ocid, especifique o OCID designado ao perfil.

Se esse parâmetro opcional não for especificado, o comando solicitará que você especifique um perfil.

--mi-profile-map map

Especifica a entrada JSON para associar instâncias gerenciadas a perfis para migração em batch. Para map, especifique uma string JSON ou um caminho de arquivo para um arquivo JSON. O formato de entrada JSON é o seguinte:

{
    "managed-instance-ocid":"profile-ocid",
    "managed-instance-ocid":"profile-ocid",
    .....
}
-y | --yes Prossegue com as ações necessárias para migrar a instância sem solicitar confirmação.
--help Exibe informações de ajuda sobre o comando do assistente de migração, como as opções disponíveis e os valores suportados para cada opção.

Usando a Console

  1. Abra o menu de navegação, selecione Compute e, em seguida, selecione Instances.
  2. Clique na instância em que você está interessado.
  3. Clique na guia Oracle Cloud Agent.
  4. Para o plug-in do Agente do Serviço OS Management, alterne a opção Ativar Plug-in para Desativar.

    Esta etapa desativa o plug-in do OS Management Service Agent na instância. Leva até 10 minutos para que a alteração entre em vigor.

  5. Ative o plug-in do OS Management Hub Agent.
    1. Para o plug-in do OS Management Hub, alterne a opção Ativar Plug-in para Ativar.
    2. Selecione um perfil para registrar a instância.

      Leva até 10 minutos para que a alteração entre em vigor.

  6. Crie OS jobs programados no OS Management Hub que você identificou no estágio de descoberta.
Observação

Para obter mais informações sobre como ativar e executar plug-ins, consulte Gerenciando Plug-ins com o Oracle Cloud Agent.