Desinstalar, registrar de novo e trocar de máquina

Desinstalar o Sentrya Connector revoga o conector no Sentrya e remove o programa da máquina. Esta página também mostra como registrar a mesma máquina de novo e como trocar de máquina, e o que muda no Sentrya em cada caso.

Desinstalar

Debian e Ubuntu — o pacote é protegido contra atualização de rotina, então libere-o antes de remover:

sudo apt-mark unhold sentrya-connector
sudo apt purge sentrya-connector

RHEL, Rocky, AlmaLinux, Oracle Linux e CentOS Stream:

sudo dnf remove sentrya-connector

Ao remover, o pacote primeiro revoga o conector no Sentrya (a chave dele deixa de valer na hora) e para o serviço. Depois apaga a configuração, os segredos do Zabbix, a chave do conector, o estado, a auditoria e o usuário do serviço.

Comando	Revoga no Sentrya	Apaga configuração e segredos
`apt purge` (Debian/Ubuntu)	Sim	Sim
`apt remove` (Debian/Ubuntu)	Sim	Não: `/etc/sentrya-connector` fica na máquina
`dnf remove` (família RHEL)	Sim	Sim

Sem internet na hora de remover, a revogação não acontece. A remoção não trava por isso: o programa sai da máquina, mas o conector continua registrado no Sentrya (aparece offline). Nesse caso, o administrador da empresa exclui o conector na página do Sentrya Connector, com a própria senha.

Remover também o repositório (opcional)

# Debian e Ubuntu
sudo rm -f /etc/apt/sources.list.d/sentrya.sources /usr/share/keyrings/sentrya-archive-keyring.gpg /etc/apt/apt.conf.d/80sentrya-proxy
# Família RHEL
sudo rm -f /etc/yum.repos.d/sentrya.repo /etc/pki/rpm-gpg/RPM-GPG-KEY-sentrya

O que acontece no Sentrya

O conector é revogado: ele não consegue mais se conectar, nem se alguém reinstalar os arquivos antigos.
Os Zabbix ligados a ele param de ser coletados e o servidor aparece com erro em Ajustes → Servidores Zabbix.
Os incidentes já coletados continuam no Sentrya. Para apagar o servidor e o histórico dele, veja Remover um servidor Zabbix.

Revogar sem desinstalar

sudo sentrya-connector deregister

Revoga o conector no Sentrya e apaga a identidade local, mas mantém o programa e a configuração. Os tokens de pessoa guardados no Connector também são apagados da máquina; os tokens Sentrya · … continuam no Zabbix até o Sentrya ou quem administra o Zabbix apagá-los. Para voltar a usar a máquina, registre de novo com um token novo.

Registrar a mesma máquina de novo

Use quando a chave da máquina pode ter vazado, ou quando a máquina deve passar para outra empresa. Gere um token novo e rode o comando abaixo; o assistente pede o token:

sudo sentrya-connector setup --force-enroll

O Connector gera uma chave nova, registra um conector novo e só então revoga o anterior (se o token novo falhar, o registro antigo continua valendo). Os tokens de pessoa guardados com a identidade anterior deixam de valer. Sem --force-enroll, o comando de instalação numa máquina já registrada mantém o registro atual. Se um token chegar a ela por opção ou arquivo, o assistente avisa e pergunta se é para Registrar esta máquina de novo com o token novo; o padrão é manter o registro atual.

Mova os Zabbix logo em seguida. No Sentrya, cada Zabbix fica ligado a um conector específico. Quando o conector antigo é revogado, a coleta e os alertas dos Zabbix desta máquina param até eles serem movidos para o conector novo. Assim que o conector novo aparecer online, mova-os (veja Trocar de máquina, passo 2): cada Zabbix continua sendo o mesmo servidor, com ouvintes, visões, grupos visíveis e histórico.

Trocar de máquina

Trocar de máquina não cria servidor novo: cada Zabbix é movido para o conector da máquina nova e continua sendo o mesmo servidor no Sentrya, com o histórico de incidentes, os ouvintes, as visões e os grupos visíveis. Nesta ordem, você não fica sem alerta em nenhum momento:

Instale na máquina nova Com um token de instalação novo, siga Instalar e configurar, usando os mesmos apelidos de Zabbix da máquina antiga. A máquina antiga continua coletando e avisando.
Mova os Zabbix para o conector novo Com o conector novo online, o administrador abre a página do Sentrya Connector, em Zabbix anunciados do conector novo, e usa Mover … para cá em cada Zabbix. Também dá para usar Trocar de conector no menu do servidor, em Servidores Zabbix. Antes de gravar, o Sentrya confere, pelo conector novo, que é o mesmo Zabbix (os eventos dos incidentes abertos do servidor têm de aparecer nele); se não for, nada muda. A coleta passa para a máquina nova em segundos, sem primeira coleta e sem alerta repetido. A troca de conector desfaz os vínculos das pessoas com o Zabbix naquele servidor: o token de cada pessoa só pode ir ao endereço em que foi criado, e cada uma vincula de novo.
Desinstale da máquina antiga Depois de conferir em Ajustes → Servidores Zabbix que os servidores estão coletando. A desinstalação revoga o conector antigo, que já não coleta nada.

Máquina perdida ou destruída. Se não dá mais para desinstalar pela máquina, instale um conector novo, mova os Zabbix para ele e então exclua o conector antigo na página do Sentrya Connector (o Sentrya recusa a exclusão enquanto houver Zabbix ligado a ele). A chave do conector excluído deixa de valer imediatamente. Até serem movidos, os Zabbix ficam com erro de coleta.