Migrando Instâncias do Serviço OS Management para o Serviço OS Management Hub

Migre instâncias do serviço OS Management para o OS Management Hub descobrindo os recursos do serviço OS Management em uso, criando os recursos equivalentes no OS Management Hub e migrando instâncias.

O OS Management Hub fornece um assistente de migração para ajudá-lo a executar com sucesso cada estágio da migração. O assistente de migração suporta operações de descoberta, criação e migração em massa para simplificar a migração para o OS Management Hub. A migração também pode ser feita manualmente usando a Console do OCI por instância.

Observação

A partir de 23 de abril de 2025, o serviço Oracle OS Management atinge o fim da vida útil (EOL). O serviço OS Management foi substituído pelo OS Management Hub, que fornece uma experiência aprimorada ao usuário com novos recursos, incluindo implantações de patches por meio de estágios do ciclo de vida, programação de jobs aprimorada e recursos de geração de relatórios.

Antes da data de EOL, recomendamos que você migre instâncias gerenciadas do serviço OS Management para o OS Management Hub.

estágios de migração

A migração do OS Management para o OS Management Hub é um processo de três estágios.

Descobrir: Examine suas instâncias do serviço OS Management e determine as origens de software, OS grupos de instâncias gerenciadas e OS jobs programados necessários para suas instâncias gerenciadas e resolva problemas de incompatibilidade.
Criar: Crie OS recursos necessários no OS Management Hub usando as informações que você determinou na descoberta. Adicione origens de software do fornecedor e crie origens de software personalizadas, crie grupos e crie perfis de registro.
Migrar: Cancele o registro de suas instâncias no serviço OS Management e use um perfil para registrá-las no OS Management Hub.

Antes de Começar

Antes de migrar instâncias do serviço OS Management para o OS Management Hub, faça o seguinte:

Revise e entenda o serviço OS Management Hub.
Conclua as tarefas introdutórias do OS Management Hub.
Verifique se suas instâncias do serviço OS Management estão usando o Oracle Cloud Agent versão 1.40 ou mais recente antes de migrar. O OS Management Hub requer a versão 1.40 mínima do Oracle Cloud Agent.
Crie uma nova instância do OCI e registre-a no OS Management Hub para se familiarizar com o serviço executando estas tarefas:
1. (Somente Oracle Linux) Adicione origens de software do fornecedor.
2. Crie um perfil de registro para registrar a instância.
3. Registre a instância no OS Management Hub.

Importante

O registro de uma instância no OS Management Hub também dá acesso ao assistente de migração.

Política do IAM Necessária

Para migrar instâncias com sucesso, você deve ter permissões de tenancy para o OS Management e o OS Management Hub. Para obter mais informações, consulte Configurando Políticas de IAM para o OS Management e a Política de IAM Obrigatória para o OS Management Hub.

O assistente de migração tem requisitos de política adicionais. Para usar o assistente de migração, você precisa da política a seguir.

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

A primeira linha permite que o grupo de usuários liste os compartimentos na tenancy.
A segunda linha permite que o grupo de usuários atualize namespaces de tag para recursos na tenancy. O assistente de migração usa tags para rastrear quais recursos foram migrados para o OS Management Hub.
A terceira linha permite que o grupo de usuários liste instâncias e atualize suas tags para rastrear o status da migração.
A quarta linha permite que o grupo de usuários monitore o status dos plug-ins do Oracle Cloud Agent do OS Management e do OS Management Hub. O assistente de migração usa essas informações para confirmar se as migrações de instância foram bem-sucedidas.

Workflow de Migração

Use OS seguintes workflows para migrar instâncias do serviço OS Management para o OS Management Hub, dependendo do seu caso de uso:

Se você estiver migrando uma única instância do OCI, migre a instância do OCI usando a Console.
Se você estiver migrando várias instâncias do OCI, migre as instâncias em massa usando o assistente de migração.

Migrar uma Única Instância Usando a Console

Defina a política de IAM, o grupo dinâmico e o grupo de usuários necessários para o OS Management Hub.
(Somente Oracle Linux) Identifique todas as origens de software do fornecedor em uso pela instância e adicione as origens de software do fornecedor ao OS Management Hub.
(Somente Oracle Linux) Identifique todas as origens de software personalizadas em uso pela instância e crie-as no OS Management Hub.
Selecione um perfil para registrar a instância. Se necessário, crie um perfil no OS Management Hub.
Migre a instância usando a Console.

Migrar Instâncias em Massa Usando o Assistente de Migração

Defina a política de IAM, o grupo dinâmico e o grupo de usuários necessários para o OS Management Hub.
Registre uma instância no OS Management Hub e familiarize-se com o serviço e como OS perfis de registro funcionam e obtenha acesso ao assistente de migração.
Acesse e instale os utilitários do assistente de migração para ajudar com as tarefas necessárias para migração.
(Somente Oracle Linux) Identifique todas as origens de software do fornecedor em uso pelas instâncias gerenciadas do serviço OS Management e adicione as origens de software do fornecedor ao OS Management Hub.
(Somente Oracle Linux) Identifique todas as origens de software personalizadas em uso pelas instâncias gerenciadas do serviço OS Management, resolva problemas de incompatibilidade e crie-OS no OS Management Hub.
Identifique todos os grupos de instâncias gerenciadas no serviço OS Management, resolva problemas de incompatibilidade e crie os recursos do grupo no OS Management Hub.
Identificar instâncias gerenciadas, resolver problemas de incompatibilidade e criar perfis para registrar as instâncias no serviço OS Management Hub.
Migre instâncias para o OS Management Hub usando o perfil apropriado.

Assistente de Migração

O assistente de migração fornece um conjunto de utilitários para ajudá-lo em cada estágio da migração de instâncias do serviço OS Management para o OS Management Hub. Para instalar o assistente de migração, consulte Instalando o Assistente de Migração.


Fase	Utilitários do Assistente de Migração
Descoberta	Identifique os recursos do serviço OS Management em uso e destaque possíveis problemas de migração, como origens de software incompatíveis ou grupos de instâncias gerenciadas. Os utilitários sugerem como corrigir problemas de incompatibilidade encontrados com um recurso. Os seguintes utilitários do assistente de migração estão disponíveis para identificar os recursos do serviço OS Management em 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`
Criar	Crie os recursos necessários do OS Management Hub para suportar suas instâncias gerenciadas, incluindo origens de software, grupos, jobs programados e perfis de registro. Os seguintes utilitários do assistente de migração estão disponíveis para criar recursos do 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 instâncias do serviço OS Management para o OS Management Hub usando um perfil de registro apropriado. O assistente de migração também suporta migração em massa de instâncias. O seguinte utilitário do assistente de migração está disponível para migrar instâncias: `osms-to-osmh migrate managed-instance`
Rollback	Retorne uma instância gerenciada ao serviço OS Management, se necessário. O seguinte utilitário de assistente de migração está disponível para fazer rollback de instâncias: `osms-to-osmh rollback managed-instance`

Instalando o Assistente de Migração

Você pode instalar o assistente de migração usando o Oracle Cloud Infrastructure (OCI) Cloud Shell ou usando o Oracle Cloud Infrastructure (OCI) SDK no seu sistema.

Antes de instalar o assistente de migração:

Certifique-se de que seu ambiente atende aos seguintes requisitos:
- OCI SDK 2.126 ou posterior.
- Python 3.8 ou posterior. Use o comando python --version para verificar a versão no sistema.
Faça download do assistente de migração.

Instale o assistente de migração usando um dos seguintes métodos:

Dica

Para simplificar, recomendamos que você use o Cloud Shell para executar o assistente de migração.

Como Acessar o Assistente de Migração

Registre uma instância no OS Management Hub.
Conecte-se à instância usando SSH.
Navegue até o diretório apropriado e copie o arquivo 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
Observação

Use a versão 1.0.155 ou posterior do assistente de migração para ser compatível com as atualizações mais recentes do OS Management Hub.
Instale a migração usando o Cloud Shell ou usando o OCI SDK.

Usando o Cloud Shell

Antes de instalar o assistente de migração usando o Cloud Shell, certifique-se de que a política de IAM necessária para usar o Cloud Shell e a Rede Pública do Cloud Shell esteja definida:

Política de IAM Obrigatória para usar o Cloud Shell.
Política de IAM Obrigatória para a Rede Pública gerenciada pelo Cloud Shell para instalar os utilitários do assistente de migração.

Faça upload do arquivo osms_to_osmh-<version>-py3-none-any.whl para o Cloud Shell.
Certifique-se de que a Rede do Cloud Shell esteja definida como Pública.

Instale o assistente de migração no Cloud Shell.

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

Crie o link simbólico necessário para executar os comandos do diretório home no Cloud Shell.
```
ln -s /home/oci/lib/oracle-cli/bin/osms-to-osmh /home/oci/bin/osms-to-osmh
```

Usando o OCI SDK

Configure as chaves SSH necessárias para trabalhar com os OCI SDKs e os SDKs do desenvolvedor e configurar os SDKs.
Consulte Configuração e Pré-requisitos no Oracle Cloud Infrastructure Developer Guide.
Faça upload do arquivo osms_to_osmh-<version>-py3-none-any.whl no sistema.

Instale o assistente de migração no sistema.

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

Documentação do Oracle Cloud Infrastructure