Sphere Agent (v1-4)

agente remoto que é instalado como serviço nos sistemas operacionais windows e linux utilizado para coleta de métricas do ambiente e responsável por executar a automação remota compatibilidade de os o sphere agent funciona nas versões linux (oracle/centos/rhel/ubuntu/suse/amazon linux) e windows (2008 ou superior) de 64 bits confira mais detalhes na seção requisitos do sistema procedimento de instalação antes de começar, vamos entender a estrutura dos arquivos do agent sphere agent/ # raiz do agent plugins/ # diretorio dos plugins do sphere queue/ # diretorio temporario de metricas atmosphere yaml # arquivo de configuração principal config yaml # arquivo de configuração de coleta sphere agent log # arquivo de log do agent arquivo de configuração (atmosphere yaml) esta é a principal configuração que determina qual o servidor do regent na rede e atributos essenciais do host como permissão de automação e configuração automática do arquivo de coleta config yaml modificar hostname modificar para o ip do host port modificar para a porta 80 adicionar ao arquivo path /sphere sync scheme http arquivo de configuração (config yaml) determina a configuração dos plugins, períodos de coleta, proxy, etc este arquivo é configurado automaticamente através da infraestrutura (exige a configuração antecipada do atmosphere yaml ) modificar hostname modificar para o ip do host port modificar para a porta 80 adicionar ao arquivo path /sphere sync requisitos para instalação espaço livre 500mb (mínimo recomendado) volume de instalação linux /opt sub diretório /sphere agent linux /sphere agent linux windows c /programdata/safia sub diretório /sphere agent windows instalação automática procedimento recomendado e disponivel a partir da versão 4 0 0+ on premises e agent pré configurado para realizar a primeira instalação e principalmente nas distribuições on premises, é recomendado substituir o endereço apontando para a url do servidor principal do regent , desta forma o download será realizado na rede interna e o agent estará automaticamente configurado para este ambiente recomendação de atualização recomendamos que antes da atualização do agent verifique o espaço em disco disponível e confirme se a url utilizada condiz com o tipo de instalação desejada linux (64 bits) execute uma das opções de comando abaixo no terminal, a instalação será iniciada e exibirá o log do progresso no console \# (opção 1) utilizando curl curl k http //\<regent master node>/repo/update sphere agent sh | sudo sh \# (opção 2) utilizando wget wget o http //\<regent master node>/repo/update sphere agent sh | sudo sh com este mesmo comando é possível realizar a atualização do agent quando disponível, um aviso será observado na tela de infraestrutura dentro de infraestrutura faça o download do arquivo no repositório do regent através da url como no exemplo http // \<regent master node> /repo/update sphere agent ps1 execute o powershell como administrador e rode o comando abaixo \# acesse a pasta onde encontra se o arquivo baixado e execute o comando powershell exe executionpolicy bypass file \update sphere agent ps1 instalação manual windows (64 bits) faça o download do agent para windows https //\<regent master node>/repo/ sphere agent windows x64 z ip descompacte o arquivo baixado (se houver, escolha a opção "extrair aqui”) acesse a pasta criada e execute o arquivo no powershell \install service ps1 confirme no gerenciador de serviços do windows se o processo “sphere agent” foi iniciado, caso contrário, inicie o serviço reiniciar o serviço (após modificar o config yaml), no powershell restart service name "sphere agent" linux (64 bits) faça o download do agent para linux wget o /opt/sphere agent linux tar gz https //\<regent master node>/ repo/latest/sphere agent linux x64 tar gz salve o arquivo na pasta de serviços desejados, recomendamos uma das pastas /opt/ /srv/ /usr/src descompacte o arquivo na pasta ou via comando no terminal tar zxvf sphere agent linux x64 tar gz acesse a pasta criada e execute o comando no terminal\ sudo bash /install service sh confirme o status do serviço rodando um dos comandos no terminal\ sudo k reiniciar o serviço no terminal (após modificar o arquivo config yaml)\ sudo systemctl restart sphere agent arquivos de configuração confira o arquivo config yaml se a seção output server foi configurada corretamente caso já tenha iniciado o serviço, realize as mudanças no arquivo config yaml e em seguida reinicie o serviço exemplo do atmosphere yaml apiversion v1 # versão da api do regent kind host # tipo do item de configuração metadata namespace default # namespace deste host domain "\<root domain>" # nome do dominio raiz annotations # anotações locais do host atmosphere/host services '\[]' # lista de serviços mapeados config hostname "127 0 0 1" # ip/hostname do regent api key "\<atmosphere api>" # chave da api scheme http # (opcional) se utilizar ssl / default http port 18001 # ssl 443, default 18001 path /sphere sync path / # /sphere sync (se utilizar proxy 80/443) agent # configurações do agent local self update true # atualizações automáticas do agent com este arquivo presente na pasta de configuração será possível controlar as configurações do agent remotamente (via infraestrutura ) remoção do agent linux \# utilize o arquivo uninstall sh para remover o agent sudo bash /opt/sphere agent linux/uninstall sh \# remover as pastas do agent rm rf /opt/sphere agent linux \# bonus se o atmosphere (módulo de automação) tiver instalado \# remover as pastas do atmosphere rm rf /opt/ atmosphere aviso cuidado ao utilizar o comando " rm rf " apontando somente as pastas do agent informadas acima windows ao utilizar o instalador " msi" você poderá desinstalar o agent no gerenciador de programas do próprio windows ou então poderá seguir para a remoção via script ( uninstall ps1 ) presente na pasta do agent \# desinstalar o agent powershell exe executionpolicy bypass file c \programdata\safia\sphere agent\uninstall ps1 atmosphere o atmosphere é o módulo adicional que se conecta ao sphere agent instalado na máquina e fornece as ferramentas necessárias para execução de rotinas de automação / recuperação de processos e serviços compatibilidade de os o atmosphere funciona em todas as versões linux compatíveis com sphere agent para as versões windows há somente disponibilidade parcial de algumas distribuições requisitos para instalação espaço livre 500mb (mínimo recomendado) diretório de instalação /opt / atmosphere instalação automática o plugin de automação não deve ser instalado na instância masternode linux (64 bits) execute uma das opções de comando abaixo no terminal, a instalação será iniciada e exibirá o log do progresso no console \# (opção 1) utilizando curl curl k http //\<regent master node>/repo/install atmosphere sh | sudo sh \# (opção 2) utilizando wget wget o http //\<regent master node>/repo/install atmosphere sh | sudo sh após a instalação o regent irá detectar e exibir automaticamente em suas soluções que o módulo está disponível no item de configuração relacionado utilização de recursos do agent resource idle load disk 170mb cpu (single core) < 0,5% 3,5% max memory 32mb 50mb max network 0,5 kb/sec 10,9 kb/sec max