---
title: Instalação
slug: aiops2/wyx5-instalacao
description: Learn how to install and configure the SimonOps platform with this comprehensive document. It covers everything from installing dependencies like repositories, Python3, Docker, and Docker Compose to installing and updating the Simon Control CLI tool. Whet
docTags: 
createdAt: 2023-10-20T12:48:33.867Z
---

A instalação da solução poderá ser de forma centralizada ou distribuída, conforme necessidade.

Pode-se instalar em modo Standalone conectando em toda a rede ou de forma distribuída, tendo diversos servidores de coleta e depois centralizando os dados em um único local, eliminando dificuldades na infraestrutuda por conta de firewals, proxys, realizando balanceamento de carga, etc. A forma de instalação dependerá como o Arquiteto da Infraestruturá irá definir. 

### Instalar e configurar as dependências

```shell
curl -ksSL https://repo.simonops.com/deployments/installer/simon-managed-install.sh | 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 simonctl)
- Instalação do Docker + Docker Compose
- Preparação do disco (/dados)
- Simon Client (simonctl)

:::hint{type="warning"}
Observar se apos o comando acima (*simon-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`     |

### 
Simon Control *(simonctl)*

Utilize os comandos a seguir para instalar/atualizar o cli `simonctl`

```shell
# para realizar a instalação:
curl -ksSL https://repo.simonops.com/deployments/setup.sh -o /tmp/setup.sh && chmod +x /tmp/setup.sh && /tmp/setup.sh update

# para realizar a atualização (quando necessário):
simonctl update
```

## Standalone *(singlenode)*

Caso esteja utilizando o modo em Standalone o comando a seguir deverá ser utilizado:

```shell
simonctl 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 simonctl masternode
```

2 - Configura variaveis de ambiente (simon.env):

```shell
sudo vi /dados/etc/simon.env
```

3 - Prepara banco de dados (inicialização):

```shell
sudo simonctl database
```

4 - Realiza a migração de tabelas (*database schema*):

```shell
sudo simonctl migrate
```

5 - Inicia a configuração da licença:

```shell
sudo simonctl license
```

6 - Inicia os serviços essenciais:

```shell
sudo simonctl start_services
```

7 - Instalação do proxy (base):

```shell
sudo simonctl proxy
```

8 - Instalação do proxy-cert Let's Encrypt *(opcional)*:

```shell
sudo simonctl proxycert
```

9 - Configura repositório dos Agents:

Seguir com a configuração: [Sphere Agent](docId\:vRQe0zUGS3LN_Sy65y70l)

# Servidor #2 *(db-worker)*

1 - Instala os serviços da db-worker:

```shell
sudo simonctl dbworker
```

2 - Inicia os serviços:

```shell
sudo simonctl 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 um ambiente separado do Simon, 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 simonctl 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 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 simonctl 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 *(trace-worker)*

1 - Instala os serviços do trace-worker (APM):

```shell
sudo simonctl traceworker
```

 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:

***

# Instalando Agent Linux

Para mais informações sobre a instalação e configuração dos agents, acesse o link: [https://docs.simonops.com/sphere-agent](https://docs.simonops.com/sphere-agent)

### Instalando o agent:

```shell
curl -k http://HOST-OU-IP-DO-SIMON/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-SIMON/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-SIMON/repo/update-sphere-agent.ps1](http://host-ou-ip-do-simon/repo/update-sphere-agent.ps1)

```shell
powershell.exe -ExecutionPolicy Bypass -File .\update-sphere-agent.ps1
```