Documentação do Oracle Cloud Infrastructure

Registrando uma Instância Não OCI

Registre uma instância de nuvem de terceiros on-premises ou suportada instalando os pacotes necessários, adicionando um perfil de registro e instalando o Management Agent.

Importante

Não há suporte para a clonagem de uma VM já registrada no OS Management Hub.

Antes de Começar

Antes de registrar uma instância no OS Management Hub, você deve fazer o seguinte:

Adicionar o Perfil de Registro à Instância

  1. Na Console, copie o conteúdo da origem de software, do grupo ou do perfil do ciclo de vida.
    1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em OS Management Hub, selecione Perfis.
    2. Selecione o nome do perfil.
    3. Verifique as informações de perfil que identificam uma Estação de Gerenciamento. Isso confirma que o perfil é para instâncias on-premises ou de nuvem de terceiros.
    4. Se o perfil for do tipo correto, selecione Exibir.
    5. Copie o conteúdo do perfil.
  2. Efetue log-in na instância como um usuário com privilégios sudo
  3. Crie o arquivo /etc/osmh-profile (sem extensão de arquivo no nome do arquivo) usando um editor de texto. Por exemplo: 
    sudo vi /etc/osmh-profile
  4. Cole o conteúdo do perfil copiado da Console e salve o arquivo.

Instale o Management Agent

Instale o software Management Agent na instância. O Management Agent usa o plug-in do OS Management Hub para registrar instâncias no serviço OS Management Hub.

Observação

Para obter etapas mais detalhadas sobre a instalação do software Management Agent, consulte Instalando Management Agents.
  1. Verifique se /etc/sudoers inclui /etc/sudoers.d: 
    sudo visudo

    Confirme se as linhas a seguir estão presentes. Caso contrário, adicione-os e salve o arquivo.

    ## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
#includedir /etc/sudoers.d
  2. Instale os pacotes necessários. Isso inclui o Java 8 (no mínimo 1.8u281 ou uma versão 1.8 posterior).

    Java 8 deve ser instalado na instância antes de instalar o software do Management Agent.

    Oracle Linux 9 do Oracle Linux
    sudo dnf install -y java-1.8.0-openjdk chkconfig
    Oracle Linux 8
    sudo dnf install -y java-1.8.0-openjdk
    Oracle Linux 7
    sudo yum install -y java-1.8.0-openjdk
  3. Defina a variável de ambiente JAVA_HOME para usar o Java 8. A definição da variável garante que o MACS use a versão correta do Java quando houver versões mais recentes no sistema. 
    JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk ; export JAVA_HOME
  4. Navegue até o diretório que contém o arquivo RPM do software do Management Agent submetido a download e execute o seguinte comando para instalar o arquivo RPM:
    Oracle Linux 8 ou 9
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm
    Oracle Linux 7
    sudo --preserve-env=JAVA_HOME yum install -y <rpm_file_name>.rpm

Configurar o Agente de Gerenciamento

Ative o Agente de Gerenciamento com o plug-in do Hub de Gerenciamento do SO. Após a ativação, a instância se registra no serviço OS Management Hub no compartimento especificado na chave de instalação e no conteúdo associado ao perfil.

  1. Configure o plug-in do Management Agent para ser executado como raiz. O plug-in do OS Management Hub precisa ser executado como raiz para aplicar patch à instância. Por exemplo: 
    sudo tee /etc/sudoers.d/mgmt_agent <<EOF
## Allows Management Agent to change ownership of deployed External Plugin
mgmt_agent ALL=(ALL) NOPASSWD:/opt/oracle/mgmt_agent/agent_inst/bin/chown_recursive_ep.sh
## Allows Management Agent to run External Plugin under root user
mgmt_agent ALL=(root) NOPASSWD:SETENV: /opt/oracle/mgmt_agent/plugins/osmh/*/osmh
## Disable requiretty for Management Agent
Defaults:mgmt_agent !requiretty
EOF
  2. Defina as permissões do arquivo como 440. 
    sudo chmod 440 /etc/sudoers.d/mgmt_agent
  3. Na Console, copie a chave de instalação do Management Agent a ser usada para registrar a instância.
    1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Management Agent, selecione Downloads e Chaves.
    2. Em Chaves de instalação, localize a chave que você deseja usar para registrar a instância.
    3. Selecione o menu Ações da chave e selecione Copiar chave para área de transferência.
  4. Crie um arquivo de resposta (input.rsp) manualmente com um editor de texto e substitua <MACS_KEY> pela chave de instalação que você copiou na etapa anterior.

    Por exemplo:

    cat >/tmp/input.rsp <<EOF
ManagementAgentInstallKey = <MACS_KEY>
Service.plugin.osmh.download = true
GatewayServerHost = <STATION_OR_LOAD_BALANCER_HOSTNAME>
GatewayServerPort = <STATION_PROXY_PORT>
EOF

    O arquivo input.rsp requer os seguintes parâmetros obrigatórios.

    • ManagementAgentInstallKey: Chave de instalação necessária para validar a identidade do domínio e a autenticidade da instalação.
    • Service.plugin.osmh.download = true: Implanta o plug-in do OS Management Hub (osmh) durante a instalação do agente.

    Para usar a estação de gerenciamento como proxy para toda a comunicação do OS Management Hub com a instância, adicione OS parâmetros a seguir no arquivo input.rsp.

    Para identificar o nome do host e a porta proxy da estação de gerenciamento, siga estas etapas na Console:

    1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em OS Management Hub, selecione Perfis.
    2. Selecione o perfil associado à instância.
    3. Na seção Informações do perfil, selecione o nome da Estação de gerenciamento.
    4. Selecione a tab Configuração.
    5. Registre os valores Nome do Host e Porta de listening de proxy a serem usados no arquivo input.rsp.
  5. Configure o Management Agent executando o script setup.sh usando o arquivo de resposta. 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp

    Uma configuração bem-sucedida retorna a seguinte mensagem: Agent setup completed and the agent is running. A configuração do plug-in do OS Management Hub pode levar alguns minutos em segundo plano.

Verificar Registro e Detalhes da Instância

Verifique a instância registrada no OS Management Hub.

  1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em OS Management Hub, selecione Instâncias.
  2. Em Escopo da lista, selecione o compartimento que contém a instância.
  3. Confirme se a instância aparece na tabela e verifique se o status é Ativo.
    Dica

    Para solucionar problemas de registro, consulte Falha no Registro da Instância ou da Estação de Gerenciamento.

  4. Selecione o nome da instância para exibir seus detalhes.

    Em Informações da instância, você pode exibir detalhes sobre a instância, como o perfil de registro que ela usou para se registrar no serviço e se ela é membro de um grupo ou de um ambiente de ciclo de vida, se aplicável.

    Observação

    A instância pode levar alguns minutos para relatar o pacote inicial e o inventário de módulos ao serviço.