Update install-zabbix.sh to detect and remove old agents before reinstall

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Leonardo Biasoli 2026-09-22 11:44:07 -03:00
parent f446f73a85
commit 3e31478027
2 changed files with 386 additions and 122 deletions

View file

@ -40,22 +40,27 @@ sudo ./install-zabbix.sh
## O que o script faz
1. Valida se o sistema operacional é suportado.
2. Instala dependências (`wget`, `curl`, `ca-certificates`, `gnupg`).
3. Adiciona o repositório oficial do Zabbix e instala o pacote `zabbix-agent2`.
4. Configura `/etc/zabbix/zabbix_agent2.conf`:
1. **Detecta o sistema operacional** e valida se é suportado.
2. Instala dependências (`wget`, `curl`, `ca-certificates`, `gnupg`, `iproute2`).
3. **Detecta agentes Zabbix já instalados** (`zabbix-agent` clássico e/ou `zabbix-agent2`).
4. **Para e remove agentes antigos**: para e desabilita os serviços, encerra processos residuais (`SIGTERM` e, se necessário, `SIGKILL`) e desinstala os pacotes (`apt-get purge`).
5. **Remove configurações antigas** (`/etc/zabbix/zabbix_agentd.conf`, `/etc/zabbix/zabbix_agent2.conf` e os diretórios `.d` correspondentes).
6. **Verifica se a porta TCP 10050 está livre** antes de prosseguir; se algo ainda estiver escutando nela, o script para com erro.
7. Adiciona o repositório oficial do Zabbix e instala o pacote `zabbix-agent2`.
8. Configura `/etc/zabbix/zabbix_agent2.conf` do zero (remove entradas antigas/comentadas da chave e escreve o novo valor):
- `Server` = IP do Zabbix Server
- `ServerActive` = IP do Zabbix Server + porta 10051
- `Hostname` = hostname (FQDN) da máquina
- `Hostname` = hostname (FQDN) da máquina, detectado automaticamente
- `ListenPort` = 10050
- `ListenIP` = 0.0.0.0
- `Timeout` = 10
- Um backup do arquivo original é criado antes de qualquer alteração, no formato `zabbix_agent2.conf.backup.<data>`.
5. Habilita e reinicia o serviço `zabbix-agent2`.
6. Valida a instalação: versão instalada, status do serviço e se a porta 10050 está escutando.
9. **Valida a configuração** (`zabbix_agent2 -T`) antes de iniciar o serviço.
10. Habilita e reinicia o serviço `zabbix-agent2`, e valida a instalação: status do serviço, porta 10050 escutando e versão instalada.
## Observações
- O script precisa ser executado como root (`sudo`).
- É seguro executar o script mais de uma vez na mesma máquina: instalações/configurações anteriores (Agent clássico ou Agent 2) são detectadas e removidas antes da reinstalação.
- Se o hostname da máquina não corresponder a um host já cadastrado no Zabbix Server, o agent ficará ativo mas não enviará dados até que o host seja criado no servidor com o mesmo `Hostname` configurado.
- Em caso de falha ao iniciar o serviço, o script exibe automaticamente os últimos 50 logs (`journalctl -u zabbix-agent2`).
- Se a porta TCP 10050 continuar ocupada por outro processo após a remoção dos agentes antigos, o script para com erro — verifique manualmente o que está usando a porta.
- Em caso de falha ao iniciar o serviço, o script exibe automaticamente os últimos 100 logs (`journalctl -u zabbix-agent2`).

View file

@ -1,7 +1,10 @@
#!/usr/bin/env bash
# ============================================================
# Instalador Zabbix Agent 2
# Zabbix Agent 2 - Instalação / Reinstalação
#
# Zabbix Server: 10.15.0.120
# Zabbix: 7.4
#
# Compatível:
# Ubuntu 20.04
@ -10,8 +13,16 @@
# Debian 12
# Debian 13
#
# Zabbix Server: 10.15.0.120
# Zabbix: 7.4
# O script:
# 1. Detecta o sistema operacional
# 2. Detecta agentes Zabbix existentes
# 3. Para e remove agentes antigos
# 4. Remove configurações antigas
# 5. Verifica a porta TCP/10050
# 6. Instala Zabbix Agent 2
# 7. Configura Server/ServerActive
# 8. Configura hostname automaticamente
# 9. Inicia e valida o Agent 2
# ============================================================
set -euo pipefail
@ -19,6 +30,12 @@ set -euo pipefail
ZABBIX_SERVER="10.15.0.120"
ZABBIX_VERSION="7.4"
export DEBIAN_FRONTEND=noninteractive
# ============================================================
# Funções
# ============================================================
log() {
echo
echo "============================================================"
@ -26,53 +43,95 @@ log() {
echo "============================================================"
}
info() {
echo "[INFO] $1"
}
ok() {
echo "[ OK ] $1"
}
warn() {
echo "[AVISO] $1"
}
fail() {
echo
echo "ERRO: $1"
echo "[ERRO] $1"
exit 1
}
# ============================================================
# Verificações
# Verificações iniciais
# ============================================================
[ "$(id -u)" -eq 0 ] || fail "Execute este script como root."
[ -f /etc/os-release ] || fail "/etc/os-release não encontrado."
[ -f /etc/os-release ] || \
fail "Não foi possível identificar o sistema operacional."
source /etc/os-release
OS="${ID}"
OS_VERSION="${VERSION_ID}"
HOSTNAME_FQDN="$(hostname -f 2>/dev/null || hostname)"
# ============================================================
# Detectar hostname
# ============================================================
HOSTNAME_ZABBIX="$(hostname -f 2>/dev/null || true)"
if [ -z "${HOSTNAME_ZABBIX}" ] || \
[ "${HOSTNAME_ZABBIX}" = "localhost" ] || \
[ "${HOSTNAME_ZABBIX}" = "localhost.localdomain" ]; then
HOSTNAME_ZABBIX="$(hostname)"
# Caso hostname -f retorne localhost
if [ -z "${HOSTNAME_FQDN}" ] || [ "${HOSTNAME_FQDN}" = "localhost" ]; then
HOSTNAME_FQDN="$(hostname)"
fi
[ -n "${HOSTNAME_ZABBIX}" ] || \
fail "Não foi possível determinar o hostname."
# ============================================================
# Detectar IP
# ============================================================
IP_LOCAL="$(
hostname -I 2>/dev/null \
| tr ' ' '\n' \
| grep -E '^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$' \
| head -1 \
|| true
)"
log "Instalação Zabbix Agent 2"
echo "Sistema: ${PRETTY_NAME}"
echo "Hostname: ${HOSTNAME_FQDN}"
echo "Hostname: ${HOSTNAME_ZABBIX}"
echo "IP local: ${IP_LOCAL:-não detectado}"
echo "Zabbix Server: ${ZABBIX_SERVER}"
echo "Zabbix versão: ${ZABBIX_VERSION}"
echo "Zabbix: ${ZABBIX_VERSION}"
# ============================================================
# Validar sistema operacional
# [1/8] Validar sistema operacional
# ============================================================
log "[1/8] Validando sistema operacional"
case "${OS}" in
ubuntu)
case "${OS_VERSION}" in
20.04|22.04|24.04)
ok "Ubuntu ${OS_VERSION} suportado."
;;
*)
fail "Ubuntu ${OS_VERSION} não suportado."
;;
esac
REPO_URL="https://repo.zabbix.com/zabbix/${ZABBIX_VERSION}/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu${OS_VERSION}_all.deb"
@ -81,11 +140,15 @@ case "${OS}" in
debian)
case "${OS_VERSION}" in
12|13)
ok "Debian ${OS_VERSION} suportado."
;;
*)
fail "Debian ${OS_VERSION} não suportado."
;;
esac
REPO_URL="https://repo.zabbix.com/zabbix/${ZABBIX_VERSION}/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian${OS_VERSION}_all.deb"
@ -93,19 +156,16 @@ case "${OS}" in
*)
fail "Sistema '${OS}' não suportado."
fail "Sistema operacional '${OS}' não suportado."
;;
esac
# ============================================================
# [1/6] Dependências
# [2/8] Dependências
# ============================================================
log "[1/6] Instalando dependências"
export DEBIAN_FRONTEND=noninteractive
log "[2/8] Instalando dependências"
apt-get update
@ -113,21 +173,183 @@ apt-get install -y \
wget \
curl \
ca-certificates \
gnupg
gnupg \
iproute2
# ============================================================
# [2/6] Repositório Zabbix
# [3/8] Detectar e remover agentes antigos
# ============================================================
log "[2/6] Configurando repositório Zabbix"
log "[3/8] Verificando instalações anteriores"
OLD_AGENT_FOUND=0
# ------------------------------------------------------------
# Mostrar pacotes encontrados
# ------------------------------------------------------------
echo
echo "Pacotes Zabbix encontrados:"
echo
dpkg-query -W \
-f='${binary:Package} ${Version} ${Status}\n' \
'zabbix-agent*' \
2>/dev/null || echo "Nenhum."
echo
# ------------------------------------------------------------
# Verificar Agent clássico
# ------------------------------------------------------------
if dpkg-query -W \
-f='${Status}' \
zabbix-agent \
2>/dev/null \
| grep -q "install ok installed"
then
warn "Zabbix Agent clássico encontrado."
OLD_AGENT_FOUND=1
fi
# ------------------------------------------------------------
# Verificar Agent 2
# ------------------------------------------------------------
if dpkg-query -W \
-f='${Status}' \
zabbix-agent2 \
2>/dev/null \
| grep -q "install ok installed"
then
warn "Zabbix Agent 2 já está instalado."
OLD_AGENT_FOUND=1
fi
# ------------------------------------------------------------
# Parar serviços existentes
# ------------------------------------------------------------
info "Parando possíveis agentes existentes..."
systemctl stop zabbix-agent 2>/dev/null || true
systemctl stop zabbix-agent2 2>/dev/null || true
systemctl disable zabbix-agent 2>/dev/null || true
systemctl disable zabbix-agent2 2>/dev/null || true
# ------------------------------------------------------------
# Encerrar processos residuais
# ------------------------------------------------------------
pkill -TERM -x zabbix_agentd 2>/dev/null || true
pkill -TERM -x zabbix_agent2 2>/dev/null || true
sleep 2
# Se algum processo antigo não encerrou
pkill -KILL -x zabbix_agentd 2>/dev/null || true
pkill -KILL -x zabbix_agent2 2>/dev/null || true
sleep 1
# ------------------------------------------------------------
# Remover pacotes
# ------------------------------------------------------------
if dpkg-query -W zabbix-agent >/dev/null 2>&1; then
info "Removendo zabbix-agent..."
apt-get purge -y zabbix-agent || true
fi
if dpkg-query -W zabbix-agent2 >/dev/null 2>&1; then
info "Removendo zabbix-agent2..."
apt-get purge -y zabbix-agent2 || true
fi
apt-get autoremove -y
# ------------------------------------------------------------
# Remover configurações antigas
# ------------------------------------------------------------
info "Removendo configurações antigas do agente..."
rm -f /etc/zabbix/zabbix_agentd.conf
rm -f /etc/zabbix/zabbix_agent2.conf
rm -rf /etc/zabbix/zabbix_agentd.d
rm -rf /etc/zabbix/zabbix_agent2.d
# ------------------------------------------------------------
# Recarregar systemd
# ------------------------------------------------------------
systemctl daemon-reload
if [ "${OLD_AGENT_FOUND}" -eq 1 ]; then
ok "Instalação anterior removida."
else
info "Nenhum pacote de agente instalado foi encontrado."
fi
# ============================================================
# [4/8] Verificar porta 10050
# ============================================================
log "[4/8] Verificando porta TCP 10050"
PORT_CHECK="$(
ss -lntp 2>/dev/null \
| awk '$4 ~ /:10050$/ {print}' \
|| true
)"
if [ -n "${PORT_CHECK}" ]; then
echo
echo "A porta TCP 10050 continua ocupada:"
echo
echo "${PORT_CHECK}"
echo
fail "Existe outro processo utilizando a porta 10050."
fi
ok "Porta TCP 10050 disponível."
# ============================================================
# [5/8] Repositório Zabbix
# ============================================================
log "[5/8] Configurando repositório Zabbix ${ZABBIX_VERSION}"
echo "Repositório:"
echo "${REPO_URL}"
echo
rm -f /tmp/zabbix-release.deb
wget \
-q \
--quiet \
"${REPO_URL}" \
-O /tmp/zabbix-release.deb \
|| fail "Não foi possível baixar o repositório Zabbix."
@ -137,37 +359,26 @@ dpkg -i /tmp/zabbix-release.deb
apt-get update
# ============================================================
# [3/6] Zabbix Agent 2
# [6/8] Instalar Agent 2
# ============================================================
log "[3/6] Instalando Zabbix Agent 2"
log "[6/8] Instalando Zabbix Agent 2"
apt-get install -y zabbix-agent2
# ============================================================
# [4/6] Configuração
# ============================================================
log "[4/6] Configurando Zabbix Agent 2"
CONFIG="/etc/zabbix/zabbix_agent2.conf"
[ -f "${CONFIG}" ] \
|| fail "Arquivo ${CONFIG} não encontrado."
[ -f "${CONFIG}" ] || \
fail "Arquivo ${CONFIG} não encontrado."
# ============================================================
# [7/8] Configurar Agent 2
# ============================================================
log "[7/8] Configurando Zabbix Agent 2"
# ------------------------------------------------------------
# Backup
# ------------------------------------------------------------
BACKUP="${CONFIG}.backup.$(date +%Y%m%d-%H%M%S)"
cp -a "${CONFIG}" "${BACKUP}"
echo "Backup:"
echo "${BACKUP}"
# ------------------------------------------------------------
# Função para alterar configuração
# Função de configuração
# ------------------------------------------------------------
set_config() {
@ -175,133 +386,178 @@ set_config() {
local KEY="$1"
local VALUE="$2"
if grep -qE "^[#[:space:]]*${KEY}=" "${CONFIG}"; then
# Remove todas as ocorrências ativas/comentadas da opção
sed -i -E \
"s|^[#[:space:]]*${KEY}=.*|${KEY}=${VALUE}|" \
"/^[#[:space:]]*${KEY}[[:space:]]*=/d" \
"${CONFIG}"
else
# Adiciona uma única configuração
echo "${KEY}=${VALUE}" >> "${CONFIG}"
fi
}
# ============================================================
# Configurações principais
# ============================================================
# ------------------------------------------------------------
# Servidor Zabbix autorizado
# ------------------------------------------------------------
# Servidor autorizado para passive checks
set_config \
"Server" \
"${ZABBIX_SERVER}"
# Servidor para active checks
# ------------------------------------------------------------
# Active Checks
# ------------------------------------------------------------
set_config \
"ServerActive" \
"${ZABBIX_SERVER}:10051"
# Hostname que será enviado ao Zabbix
# ------------------------------------------------------------
# Hostname
# ------------------------------------------------------------
set_config \
"Hostname" \
"${HOSTNAME_FQDN}"
"${HOSTNAME_ZABBIX}"
# ------------------------------------------------------------
# Porta
# ------------------------------------------------------------
# Porta padrão Agent
set_config \
"ListenPort" \
"10050"
# Escutar em todas as interfaces
# ------------------------------------------------------------
# Interfaces
# ------------------------------------------------------------
set_config \
"ListenIP" \
"0.0.0.0"
# ------------------------------------------------------------
# Timeout
# ------------------------------------------------------------
set_config \
"Timeout" \
"10"
# ============================================================
# [5/6] Iniciar Agent
# Mostrar configuração
# ============================================================
log "[5/6] Ativando Zabbix Agent 2"
echo
echo "Configuração aplicada:"
echo
grep -E \
'^(Server|ServerActive|Hostname|ListenPort|ListenIP|Timeout)=' \
"${CONFIG}"
# ============================================================
# Validar configuração
# ============================================================
echo
info "Validando configuração..."
if ! zabbix_agent2 \
-c "${CONFIG}" \
-T
then
fail "Configuração do Zabbix Agent 2 inválida."
fi
ok "Configuração válida."
# ============================================================
# [8/8] Iniciar e validar
# ============================================================
log "[8/8] Iniciando Zabbix Agent 2"
systemctl daemon-reload
systemctl enable zabbix-agent2
systemctl restart zabbix-agent2
sleep 2
sleep 3
# ============================================================
# [6/6] Validação
# Status
# ============================================================
log "[6/6] Validando instalação"
if ! systemctl is-active --quiet zabbix-agent2; then
echo
echo "Versão:"
echo
zabbix_agent2 -V | head -1 || true
echo
echo "Status:"
echo
if systemctl is-active --quiet zabbix-agent2; then
echo "Zabbix Agent 2: ATIVO"
else
echo "Zabbix Agent 2: FALHOU"
echo
echo "O Zabbix Agent 2 não iniciou."
echo
echo "Últimos logs:"
echo
journalctl \
-u zabbix-agent2 \
-n 50 \
-n 100 \
--no-pager
exit 1
fail "Falha ao iniciar Zabbix Agent 2."
fi
# ------------------------------------------------------------
ok "Zabbix Agent 2 ativo."
# ============================================================
# Verificar porta
# ------------------------------------------------------------
# ============================================================
echo
echo "Porta TCP 10050:"
echo
if command -v ss >/dev/null 2>&1; then
ss -lntp | grep ':10050' || \
echo "AVISO: porta 10050 não encontrada."
fi
# ------------------------------------------------------------
# Informações finais
# ------------------------------------------------------------
IP_LOCAL="$(
hostname -I 2>/dev/null \
| awk '{print $1}' \
PORT_FINAL="$(
ss -lntp 2>/dev/null \
| awk '$4 ~ /:10050$/ {print}' \
|| true
)"
if [ -n "${PORT_FINAL}" ]; then
echo "${PORT_FINAL}"
else
fail "Agent está ativo, mas a porta TCP 10050 não foi encontrada."
fi
# ============================================================
# Versão
# ============================================================
echo
echo "Versão instalada:"
echo
zabbix_agent2 -V | head -1
# ============================================================
# Resultado
# ============================================================
echo
echo "============================================================"
echo " INSTALAÇÃO CONCLUÍDA"
echo " ZABBIX AGENT 2 INSTALADO COM SUCESSO"
echo "============================================================"
echo
echo "Sistema:"
echo " ${PRETTY_NAME}"
echo
echo "Hostname:"
echo " ${HOSTNAME_FQDN}"
echo " ${HOSTNAME_ZABBIX}"
echo
echo "IP:"
echo " ${IP_LOCAL:-não detectado}"
@ -309,16 +565,19 @@ echo
echo "Zabbix Server:"
echo " ${ZABBIX_SERVER}"
echo
echo "Agent:"
echo " TCP 10050"
echo "Passive checks:"
echo " ${ZABBIX_SERVER} -> ${IP_LOCAL:-HOST}:10050"
echo
echo "Active checks:"
echo " ${ZABBIX_SERVER}:10051"
echo " ${IP_LOCAL:-HOST} -> ${ZABBIX_SERVER}:10051"
echo
echo "Configuração:"
echo " ${CONFIG}"
echo
echo "Backup:"
echo " ${BACKUP}"
echo "Status:"
echo " systemctl status zabbix-agent2"
echo
echo "Logs:"
echo " journalctl -u zabbix-agent2 -f"
echo
echo "============================================================"