--- title: Portas e Serviços por Instância slug: aiops/portas-e-servicos-por-instancia docTags: createdAt: 2024-08-21T15:53:48.324Z --- ## Instalar e configurar as dependências ```shell curl -ksSL https://repo.aiops.com/deployments/installer/aiop-managed-install -o - | sudo bash ``` O comando acima irá instalar/configurar os seguintes itens: - Instalação dos repositórios principais (Ex: epel-release, docker-repo, etc) - Configurações do kernel (sysctl) - Instalação do Python3 (para uso do aiopsctl) - Instalação do Docker + Docker Compose - Preparação do disco (/dados) - Aiops Client (aiopsctl) :::hint{type="warning"} Observar se apos o comando acima (*aiops-managed-install.sh*), as versões correspondentes estão de acordo com a referência abaixo: ::: ## Versões exigidas no repositório | **Produto** | **Versão minima** | **Comando** | | ------------- | ----------------- | ---------------- | | Docker Engine | 19.+ | `docker version` | | Python | 3.6.8+ | `python3 -V` | ## AIOPS Control *(aiopsctl)* Utilize os comandos a seguir para instalar/atualizar o cli `aiopsctl` ```shell # para realizar a instalação: curl -ksSL https://repo.aiops.com/deployments/setup -o - | bash -s update # para realizar a atualização (quando necessário): aiopsctl update ``` ## Standalone *(singlenode)* Caso esteja utilizando o modo em Standalone o comando a seguir deverá ser utilizado: ```shell aiopsctl standalone ``` Neste comando será realizado a instalação dos seguintes itens na mesma máquina (*singlenode*): - Instalação da **masternode ** - Instalação da **dbworker** - Instalação do **proxy** Caso seja necessário instalar os demais serviços (opcionais): **atomworker** e **traceworker. **Você poderá conferir a seguir a instalação dos servidores 3 e 4). *** # Distributed # Servidor #1* (master-node)* 1 - Instala os serviços da master-node ```shell sudo aiopsctl masternode ``` 2 - Configurar variaveis de Ambiente (aiops.env): ```shell sudo vi /dados/etc/aiops.env ``` 3 - Prepara banco de dados (inicialização): ```shell sudo aiopsctl database ``` 4 - Realiza a migração de tabelas (*database schema*): ```shell sudo aiopsctl migrate ``` 5 - Inicia a configuração da licença: ```shell sudo aiopsctl license ``` 6 - Inicia os serviços essenciais: ```shell sudo aiopsctl start_services ``` 7 - Instalação do proxy (base): ```shell sudo aiopsctl proxy ``` 8 - Instalação do proxy-cert Let's Encrypt *(opcional)*: ```shell sudo aiopsctl proxycert ``` 9 - Instalação do grafana *(opcional)*: ```shell sudo aiopsctl grafana ``` 10 - Configura repositório dos Agents: Seguir com a configuração: [Sphere Agent](docId:-IjoB146AQpQDsz0mOPwe) # Servidor #2 *(db-worker)* 1 - Instala os serviços da db-worker: ```shell sudo aiopsctl dbworker ``` 2 - Inicia os serviços: ```shell sudo aiopsctl start_services ``` # Servidor #3 *(atom-worker)* :::hint{type="info"} Ao seguir os passos abaixo, você será capaz de implantar e configurar uma instância Atom Worker com sucesso. **A instalação pode ser realizada em múltiplos ambientes separados do AIOPS, permitindo executar coletas de forma isolada**. ::: ### 1 - Instala os serviços da atom-worker: Para começar, você precisará instalar os serviços Atom Worker. Siga os seguintes passos: ```shell sudo aiopsctl atomworker ``` Este comando instalará os serviços Atom Worker no seu sistema. ### 2 - Configura variaveis de ambiente (atom.env): Agora, é necessário configurar as variáveis de ambiente para a instância Atom Worker. Abra o arquivo **'atom.env'**com um editor de texto. Neste exemplo, usaremos o editor **'vi'**, mas você pode usar qualquer editor de texto de sua preferência: ```shell sudo vi /dados/etc/atom.env ``` Dentro do arquivo **'atom.env'**, [configure as variáveis de ambiente](https://docs.simonops.com/knowledge-base-internal/dependencias-de-ambiente#2j2Ql) necessárias para a instância Atom Worker, como URLs, chaves de autenticação ou quaisquer outras configurações específicas do seu ambiente. Certifique-se de salvar as alterações após a configuração. ### 3 - Inicia os serviços: Após configurar as variáveis de ambiente, você pode iniciar os serviços da instância Atom Worker. Execute o seguinte comando: ```shell sudo aiopsctl start_services ``` Isso iniciará os serviços Atom Worker com base nas configurações que você definiu no arquivo **'atom.env'**. Certifique-se de que os serviços estejam em execução corretamente. # Servidor #4 - APM Worker 1 - Instala os serviços da apm worker (APM): ```shell sudo aiopsctl apmworker ```  2 - Configura variaveis de ambiente (trace.yaml): ```shell sudo vi /dados/etc/trace.yaml ``` - Adicionar ao arquivo a chave de acesso gerado no Atmos: (Página: /atmos/settings/group-api-key) - Modificar o ip do hostname, para o ip do Server da Masternode 3 - Configura variaveis de ambiente no arquivo (/dados/etc/divedot-agent.env): - Adicionar ao arquivo a chave gerado no Divedot (Página: /divedot/settings/api-keys) 4 - Inicia os serviços: ```shell sudo aiopsctl start_services ``` *** # Instalando Agent Linux Para mais informações sobre a instalação e configuração dos agents, acesse o link: [Sphere Agent](docId:-IjoB146AQpQDsz0mOPwe) ### Instalando o agent: ```shell curl -k http://HOST-OU-IP-DO-AIOPS/repo/update-sphere-agent.sh | sudo sh ``` Caso o firewall bloqueie (.sh) utilizar a extensão -linux.txt: ```shell curl -k http://HOST-OU-IP-DO-AIOPS/repo/update-sphere-agent-linux.txt | sudo sh ``` # Instalando Agent Windows ### Baixe o arquivo para o diretório e rode o comando no Powershell: http\://HOST-OU-IP-DO-AIOPS/repo/update-sphere-agent.ps1 ```shell powershell.exe -ExecutionPolicy Bypass -File .\update-sphere-agent.ps1 ``` Este documento descreve o processo de instalação, configuração e ativação do módulo de inventário (**Xventory**), bem como a instalação de seus agentes em diferentes sistemas operacionais. # Instalando XVentory ### Parte 1: Preparação dos artefatos para configuração da Integração com AIOps *Antes* de instalar o módulo, é necessário configurar a comunicação entre a plataforma AIOps e o Xventory. 1. **Gerar Chave de API no AIOps:** - Acesse a área de configurações de API da sua plataforma AIOps (https\://\/simon/settings/group-api-key), e gere a chave conforme descrito na documentação: - [Chaves de acesso](docId:50FPEoTsUlrG0U92onxCG) - Crie uma nova chave de API com perfil de administrador. Dê um nome descritivo, como por exemplo `webhook-inv-api`. Guarde o valor da chave gerada para os próximos passos. ### Parte 2: Instalação do Módulo Xventory Com as configurações da plataforma AIOps prontas, prossiga com a instalação do módulo. 1. **Executar o Instalador:** - Execute o comando de instalação do inventário ```bash simonctl inventory ``` 2. **Configurar Arquivos de Ambiente:** - O instalador criará links simbólicos para os arquivos de configuração. O principal é o `/dados/etc/x.env`, que é linkado em `/opt/apps/simon/docker-inventory/x.env`. - Edite o arquivo `/dados/etc/x.env` e preencha as seguintes variáveis: ```bash # URL da API do OCS (geralmente aponta para o IP do container Master) OCS_API_URL=http:///ocsapi/v1 # Chave de API gerada no AIOps para permitir a comunicação X_API_KEY_ALLOWED= # URL do Webhook para onde o inventário enviará os dados (DESCOMENTAR E ALTERAR) WEBHOOK_URL=https:///events/webhook/ ``` - No arquivo /dados/etc/simon.env, verifique se as variáveis para o webhook do inventário estão configuradas. Elas geralmente vêm comentadas: - ```bash # Webhook inventory WEBHOOK_INVENTORY_API_KEY= WEBHOOK_INVENTORY_URL="http://localhost/inventory/api/sync/webhook/simon/" ``` 3. **Configurar e Iniciar os Serviços Docker:** - Descomente a seção do serviço inv-clickhouse para habilitar o banco de dados do inventário. As portas `8123` e `9000` serão expostas. - No mesmo diretório (`/opt/apps/simon/docker-inventory/`), suba os containers: ```bash docker compose up -d ``` - Verifique se todos os containers estão em execução: - ```bash docker ps -a ``` ### Parte 3: Instalação dos Agentes de Inventário Veja mais em [Sphere Agent](docId:-IjoB146AQpQDsz0mOPwe)