Documentação do Oracle Cloud Infrastructure

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.

Dica

Com problemas? Consulte Falha no Registro da Instância ou da Estação de Gerenciamento.

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: