Instalar e configurar

A instalação é um comando só: ele configura o repositório assinado do Sentrya, instala o pacote e abre um assistente que testa cada etapa na hora — conexão, registro e Zabbix — antes de ligar o serviço.

Antes de começar

Confira os requisitos, a rede e o firewall.
Tenha o token de instalação (começa com SNTRY-). O administrador da empresa gera o token no painel da empresa, em Conexões → Sentrya Connector, ou no Sentrya Web, em Ajustes → Sentrya Connector, em Instalar conector, e recebe o token e os comandos prontos. Ele vale 24 horas e registra uma única máquina.
Tenha a credencial do Zabbix: veja Preparar o usuário no Zabbix.

Instalar

Na máquina escolhida, rode o comando mostrado ao gerar o token:

curl -fsSL https://connector.flowbix.com/pkgs/install.sh | sudo bash -s -- --host connector.flowbix.com && sudo sentrya-connector setup --host connector.flowbix.com

O token não vai no comando. Na linha de comando ele ficaria no histórico do terminal, na lista de processos da máquina e no registro do sudo. O assistente pede o token na etapa de registro: cole o que apareceu ao gerar o token. A digitação aparece mascarada.

Se a rede só sai por um proxy, acrescente --proxy URL às duas partes do comando (veja Requisitos, rede e firewall).

O comando:

Identifica o sistema Distribuição, versão e arquitetura.
Configura o repositório assinado Instala a chave pública do repositório do Sentrya e o repositório (/etc/apt/sources.list.d/sentrya.sources ou /etc/yum.repos.d/sentrya.repo).
Instala o pacote Instala o sentrya-connector e o protege contra a atualização de rotina do sistema (apt-mark hold ou excludepkgs): quem atualiza o Connector é o atualizador dele, na versão que o Sentrya liberar.
Abre o assistente Com as perguntas descritas abaixo.

A saída do apt/dnf vai para /var/log/sentrya-connector-install.log e só aparece na tela se algo falhar. Rodar o comando de novo não duplica nada.

O assistente, etapa por etapa

Etapa	O que pergunta	O que confere na hora
1. Conexão com o Sentrya	Nada (o domínio vem do comando). Se o teste falhar: tentar de novo, usar um proxy ou corrigir o domínio.	DNS, saída 443, TLS e o relógio da máquina.
2. Registro deste conector	O token de instalação. Numa máquina já registrada, nada: o assistente mostra o registro atual e segue.	O formato do token e o registro no Sentrya. Token recusado pede outro, sem recomeçar.
3. Zabbix desta rede	Apelido, endereço do Zabbix, forma de entrar (token ou usuário e senha), a credencial e se o Sentrya pode reconhecer (ACK) incidentes.	Procura a API do Zabbix no endereço informado, testa a credencial, conta os hosts visíveis e confere as permissões do papel.
4. Atualizações e ativação	A política de atualização.	Grava a configuração, liga o serviço e espera ele ficar online no Sentrya.

Apelido: é como esse Zabbix aparece no Sentrya. Aceita letras minúsculas, números e - _ .; se você digitar "Zabbix Matriz", o assistente converte para zabbix-matriz.
Endereço do Zabbix: pode ser o mesmo endereço que você abre no navegador (ex.: http://10.0.0.5/zabbix). O assistente encontra a API sozinho (…/api_jsonrpc.php).
Setas ↑↓ escolhem as opções e Enter confirma. Tokens e senhas aparecem como ••••.

No fim aparece o resumo Sentrya Connector pronto, com o conector, a empresa, o Zabbix e a versão encontrados. O registro vale assim que a etapa 2 termina; a configuração do Zabbix e do serviço só é gravada no fim, depois de tudo validado. Se você cancelar (Ctrl+C) no meio, rode sudo sentrya-connector setup para continuar: a máquina já registrada não pede token de novo.

Depois de instalar

Cadastre o Zabbix A janela da instalação espera o Connector se registrar e mostra o Zabbix que ele anunciou: clique em Cadastrar este Zabbix. Se fechou a janela, o Zabbix aparece no botão de adicionar Zabbix, na opção Rede fechada, e na página do Sentrya Connector. O Operador também pode cadastrar um Zabbix de um conector já instalado; instalar é só do Admin.
Faça a primeira coleta Toque em Fazer primeira coleta no card do servidor e confirme. Veja Primeira coleta.
Crie os ouvintes A partir daqui, tudo funciona como num Zabbix conectado diretamente: Criar um ouvinte de Zabbix.

Instalar sem perguntas (automação)

Para configurar sem perguntar nada (útil em Ansible, Terraform ou imagem de VM), instale o pacote e rode o assistente com as opções. Os tokens vão em arquivos, nunca na linha de comando:

curl -fsSL https://connector.flowbix.com/pkgs/install.sh | sudo bash
sudo sentrya-connector setup --non-interactive \
  --token-file /root/sentrya.token \
  --ref zabbix-principal \
  --zabbix-url http://10.0.0.5/zabbix/api_jsonrpc.php \
  --zabbix-token-file /root/zabbix.token

Opções do instalador (install.sh):

--proxy URL
Proxy HTTP de saída (http://[usuário:senha@]proxy:3128).
--version X.Y.Z
Instala exatamente esta versão.
--channel stable|beta
Canal de atualização (padrão: stable).
--dry-run
Mostra o que faria, sem alterar nada (não precisa de root).

Opções do setup --non-interactive:

--token-file ARQUIVO
Arquivo com o token de instalação (registra a máquina).
--ref APELIDO
Apelido do Zabbix (padrão: zabbix).
--zabbix-url URL
URL da API do Zabbix (…/api_jsonrpc.php).
--zabbix-token-file ARQUIVO
Arquivo com o token de API do Zabbix.
--zabbix-user USUÁRIO e --zabbix-password-file ARQUIVO
Entrar com usuário e senha.
--no-ack
Somente leitura: o Sentrya não reconhece incidentes.
--proxy URL, --channel stable|beta, --update-policy auto|notify|manual e --update-window
Os mesmos ajustes do assistente.

Proteja os arquivos dos tokens. Use chmod 600 no arquivo do token de instalação e no do token do Zabbix. O assistente copia o token do Zabbix para /etc/sentrya-connector/secrets/, com acesso só do root e do serviço. Depois apague os dois arquivos originais: o token de instalação só vale uma vez.

Mais de um Zabbix na mesma rede

Um Connector atende até 64 Zabbix. No assistente, responda Sim em "Adicionar outro Zabbix?", ou depois rode:

sudo sentrya-connector zabbix add

O comando faz as mesmas perguntas e validações da etapa 3 e recarrega o serviço. Cada Zabbix novo aparece para cadastrar, como na instalação.

Máquina que já tem o pacote

Se o pacote já está instalado (por exemplo, depois de desinstalar só o registro), registre e configure com o comando abaixo. O assistente pede o token:

sudo sentrya-connector setup

Uma máquina é um conector. Numa máquina já registrada, o assistente mantém o registro atual e não pede token; o token gerado continua valendo até vencer, e você pode invalidá-lo no painel. Se um token chegar a uma máquina já registrada (por --token-file, por exemplo), ele não é usado: o assistente avisa e pergunta se você quer manter o registro atual ou registrar a máquina de novo. Veja Desinstalar, registrar de novo e trocar de máquina.