Registrando uma Estação de Gerenciamento

Registre uma estação de gerenciamento no OS Management Hub usando o perfil da estação de gerenciamento e instalando o Management Agent.

No registro, o OS Management Hub anexa as origens de software mínimas necessárias à instância da estação (Oracle Linux 8 BaseOS e Oracle Linux 8 Appstream). Isso garante que o OS Management Hub possa fornecer atualizações para a instância que age como a estação.

Antes de Começar

Para registrar com sucesso uma estação de gerenciamento no serviço OS Management Hub, faça o seguinte:

Instalar os pacotes necessários

A estação de gerenciamento é executada como um aplicativo de servidor Apache em sua atribuição como proxy de rede e espelho yum local para o serviço OS Management Hub. É necessário instalar o servidor Web Apache necessário, iniciar e ativar o serviço httpd.

Se sua estação de gerenciamento estiver usando SELinux, você também deverá instalar o pacote policycoreutils-python-utils, que fornece os utilitários necessários para o gerenciamento de SELinux.

  1. Faça log-in na instância como um usuário com privilégios sudo.
  2. Instale os pacotes necessários do Apache.
    sudo dnf install -y httpd mod_ssl openssl
  3. Inicie e ative o serviço httpd.
    sudo systemctl start httpd
    sudo systemctl enable httpd
  4. Instale o pacote SELinux necessário e quaisquer dependências.
    sudo dnf install -y policycoreutils-python-utils
    

Adicionar o Perfil de Estação à Instância

Adicione o perfil da estação à instância. O perfil identifica a instância como uma estação de gerenciamento. O perfil pode ser usado para registrar apenas uma única estação de gerenciamento. Não é possível reutilizar perfis de estação de gerenciamento.
  1. Na Console, copie o conteúdo do perfil da estação de gerenciamento.
    1. Em OS Management Hub, selecione Estações de gerenciamento.
    2. Selecione o nome da estação de gerenciamento cujo perfil você deseja usar.
    3. Selecione Exibir Perfil.
    4. 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 da estação de gerenciamento. O OS Management Hub requer que um Management Agent seja instalado na instância e forneça um plug-in de serviço ao serviço Management Agent.
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.

    sudo dnf 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:
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm

Configurar o Agente de Gerenciamento

Crie o arquivo de resposta do Management Agent na instância da estação de gerenciamento e configure o arquivo de resposta para usar o Management Agent com o plug-in de serviço do OS Management Hub para registrar a instância 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. 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. Certifique-se de ter criado a chave de instalação do Management Agent.
  4. 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.
  5. 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
    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.
  6. 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.

  7. Configure as definições de firewall e SELinux para permitir tráfego e acesso.

    A estação de gerenciamento usa as portas definidas durante a configuração para sincronizar o espelho do yum e gerenciar o tráfego de proxy com o OCI.

    Você pode atualizar manualmente as regras de firewall e as definições SELinux ou usar o script station-setup.sh.

    O script station-setup.sh configura o firewall e as definições SELinux para permitir o tráfego nas portas que você especificou na configuração de proxy na estação de gerenciamento e no servidor Web Apache HTTP para atender pacotes do caminho na configuração de espelho. O script manipula a configuração de firewall e SELinux para espelhos usando o sistema de arquivos xfs, ext4, btrfs ou nfs.

    Importante

    Para sua conveniência, o script station-setup.sh está disponível para configurar o firewall e as definições SELinux. Antes de executar o script em seu ambiente de produção, verifique o script e entenda as alterações feitas pelo script no firewall e nas configurações do SELinux.
    sudo /opt/oracle/mgmt_agent/plugins/osmh/stateDir/station-setup.sh
    Observação

    Se você receber uma mensagem de erro command not found ou No such file, aguarde alguns minutos para que a configuração do plug-in do OS Management Hub seja concluída e o script station-setup.sh fique disponível. Se o problema persistir, o registro pode ter falhado. Consulte Falha no Registro da Instância ou da Estação de Gerenciamento.
  8. Se você não executou o script station-setup.sh, reinicie o servidor Web Apache HTTP.
    sudo systemctl restart httpd

Verificar Registro e Detalhes da Estação de Gerenciamento

Verifique se a estação de gerenciamento está registrada no OS Management Hub como uma instância e se está disponível para espelhar e distribuir conteúdo para instâncias no data center.

  1. Em OS Management Hub, selecione Estações de gerenciamento.
  2. Selecione o compartimento que contém a estação de gerenciamento.
  3. Verifique se a estação de gerenciamento está listada na tabela e se seu 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 estação de gerenciamento para exibir seus detalhes.
    Importante

    A lista de origens de software espelhadas ficará vazia até que você crie um perfil que use a estação. Consulte Quais origens de software são espelhadas?.

Próximas etapas

Depois de registrar a estação de gerenciamento, as próximas etapas podem incluir: