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 ## O que o script faz
1. Valida se o sistema operacional é suportado. 1. **Detecta o sistema operacional** e valida se é suportado.
2. Instala dependências (`wget`, `curl`, `ca-certificates`, `gnupg`). 2. Instala dependências (`wget`, `curl`, `ca-certificates`, `gnupg`, `iproute2`).
3. Adiciona o repositório oficial do Zabbix e instala o pacote `zabbix-agent2`. 3. **Detecta agentes Zabbix já instalados** (`zabbix-agent` clássico e/ou `zabbix-agent2`).
4. Configura `/etc/zabbix/zabbix_agent2.conf`: 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 - `Server` = IP do Zabbix Server
- `ServerActive` = IP do Zabbix Server + porta 10051 - `ServerActive` = IP do Zabbix Server + porta 10051
- `Hostname` = hostname (FQDN) da máquina - `Hostname` = hostname (FQDN) da máquina, detectado automaticamente
- `ListenPort` = 10050 - `ListenPort` = 10050
- `ListenIP` = 0.0.0.0 - `ListenIP` = 0.0.0.0
- `Timeout` = 10 - `Timeout` = 10
- Um backup do arquivo original é criado antes de qualquer alteração, no formato `zabbix_agent2.conf.backup.<data>`. 9. **Valida a configuração** (`zabbix_agent2 -T`) antes de iniciar o serviço.
5. Habilita e reinicia o serviço `zabbix-agent2`. 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.
6. Valida a instalação: versão instalada, status do serviço e se a porta 10050 está escutando.
## Observações ## Observações
- O script precisa ser executado como root (`sudo`). - 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. - 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 #!/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: # Compatível:
# Ubuntu 20.04 # Ubuntu 20.04
@ -10,8 +13,16 @@
# Debian 12 # Debian 12
# Debian 13 # Debian 13
# #
# Zabbix Server: 10.15.0.120 # O script:
# Zabbix: 7.4 # 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 set -euo pipefail
@ -19,6 +30,12 @@ set -euo pipefail
ZABBIX_SERVER="10.15.0.120" ZABBIX_SERVER="10.15.0.120"
ZABBIX_VERSION="7.4" ZABBIX_VERSION="7.4"
export DEBIAN_FRONTEND=noninteractive
# ============================================================
# Funções
# ============================================================
log() { log() {
echo echo
echo "============================================================" echo "============================================================"
@ -26,53 +43,95 @@ log() {
echo "============================================================" echo "============================================================"
} }
info() {
echo "[INFO] $1"
}
ok() {
echo "[ OK ] $1"
}
warn() {
echo "[AVISO] $1"
}
fail() { fail() {
echo echo
echo "ERRO: $1" echo "[ERRO] $1"
exit 1 exit 1
} }
# ============================================================ # ============================================================
# Verificações # Verificações iniciais
# ============================================================ # ============================================================
[ "$(id -u)" -eq 0 ] || fail "Execute este script como root." [ "$(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 source /etc/os-release
OS="${ID}" OS="${ID}"
OS_VERSION="${VERSION_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 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" log "Instalação Zabbix Agent 2"
echo "Sistema: ${PRETTY_NAME}" 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 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 case "${OS}" in
ubuntu) ubuntu)
case "${OS_VERSION}" in case "${OS_VERSION}" in
20.04|22.04|24.04) 20.04|22.04|24.04)
ok "Ubuntu ${OS_VERSION} suportado."
;; ;;
*) *)
fail "Ubuntu ${OS_VERSION} não suportado." fail "Ubuntu ${OS_VERSION} não suportado."
;; ;;
esac 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" 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) debian)
case "${OS_VERSION}" in case "${OS_VERSION}" in
12|13) 12|13)
ok "Debian ${OS_VERSION} suportado."
;; ;;
*) *)
fail "Debian ${OS_VERSION} não suportado." fail "Debian ${OS_VERSION} não suportado."
;; ;;
esac 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" 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 esac
# ============================================================ # ============================================================
# [1/6] Dependências # [2/8] Dependências
# ============================================================ # ============================================================
log "[1/6] Instalando dependências" log "[2/8] Instalando dependências"
export DEBIAN_FRONTEND=noninteractive
apt-get update apt-get update
@ -113,21 +173,183 @@ apt-get install -y \
wget \ wget \
curl \ curl \
ca-certificates \ 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 "Repositório:"
echo "${REPO_URL}" echo "${REPO_URL}"
echo
rm -f /tmp/zabbix-release.deb rm -f /tmp/zabbix-release.deb
wget \ wget \
-q \ --quiet \
"${REPO_URL}" \ "${REPO_URL}" \
-O /tmp/zabbix-release.deb \ -O /tmp/zabbix-release.deb \
|| fail "Não foi possível baixar o repositório Zabbix." || fail "Não foi possível baixar o repositório Zabbix."
@ -137,37 +359,26 @@ dpkg -i /tmp/zabbix-release.deb
apt-get update 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 apt-get install -y zabbix-agent2
# ============================================================
# [4/6] Configuração
# ============================================================
log "[4/6] Configurando Zabbix Agent 2"
CONFIG="/etc/zabbix/zabbix_agent2.conf" CONFIG="/etc/zabbix/zabbix_agent2.conf"
[ -f "${CONFIG}" ] \ [ -f "${CONFIG}" ] || \
|| fail "Arquivo ${CONFIG} não encontrado." fail "Arquivo ${CONFIG} não encontrado."
# ============================================================
# [7/8] Configurar Agent 2
# ============================================================
log "[7/8] Configurando Zabbix Agent 2"
# ------------------------------------------------------------ # ------------------------------------------------------------
# Backup # Função de configuração
# ------------------------------------------------------------
BACKUP="${CONFIG}.backup.$(date +%Y%m%d-%H%M%S)"
cp -a "${CONFIG}" "${BACKUP}"
echo "Backup:"
echo "${BACKUP}"
# ------------------------------------------------------------
# Função para alterar configuração
# ------------------------------------------------------------ # ------------------------------------------------------------
set_config() { set_config() {
@ -175,133 +386,178 @@ set_config() {
local KEY="$1" local KEY="$1"
local VALUE="$2" local VALUE="$2"
if grep -qE "^[#[:space:]]*${KEY}=" "${CONFIG}"; then # Remove todas as ocorrências ativas/comentadas da opção
sed -i -E \ sed -i -E \
"s|^[#[:space:]]*${KEY}=.*|${KEY}=${VALUE}|" \ "/^[#[:space:]]*${KEY}[[:space:]]*=/d" \
"${CONFIG}" "${CONFIG}"
else # Adiciona uma única configuração
echo "${KEY}=${VALUE}" >> "${CONFIG}" echo "${KEY}=${VALUE}" >> "${CONFIG}"
fi
} }
# ============================================================ # ------------------------------------------------------------
# Configurações principais # Servidor Zabbix autorizado
# ============================================================ # ------------------------------------------------------------
# Servidor autorizado para passive checks
set_config \ set_config \
"Server" \ "Server" \
"${ZABBIX_SERVER}" "${ZABBIX_SERVER}"
# Servidor para active checks # ------------------------------------------------------------
# Active Checks
# ------------------------------------------------------------
set_config \ set_config \
"ServerActive" \ "ServerActive" \
"${ZABBIX_SERVER}:10051" "${ZABBIX_SERVER}:10051"
# Hostname que será enviado ao Zabbix # ------------------------------------------------------------
# Hostname
# ------------------------------------------------------------
set_config \ set_config \
"Hostname" \ "Hostname" \
"${HOSTNAME_FQDN}" "${HOSTNAME_ZABBIX}"
# ------------------------------------------------------------
# Porta
# ------------------------------------------------------------
# Porta padrão Agent
set_config \ set_config \
"ListenPort" \ "ListenPort" \
"10050" "10050"
# Escutar em todas as interfaces # ------------------------------------------------------------
# Interfaces
# ------------------------------------------------------------
set_config \ set_config \
"ListenIP" \ "ListenIP" \
"0.0.0.0" "0.0.0.0"
# ------------------------------------------------------------
# Timeout # Timeout
# ------------------------------------------------------------
set_config \ set_config \
"Timeout" \ "Timeout" \
"10" "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 enable zabbix-agent2
systemctl restart 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
echo "Versão:" echo "O Zabbix Agent 2 não iniciou."
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
echo "Últimos logs:" echo "Últimos logs:"
echo echo
journalctl \ journalctl \
-u zabbix-agent2 \ -u zabbix-agent2 \
-n 50 \ -n 100 \
--no-pager --no-pager
exit 1 fail "Falha ao iniciar Zabbix Agent 2."
fi fi
# ------------------------------------------------------------ ok "Zabbix Agent 2 ativo."
# ============================================================
# Verificar porta # Verificar porta
# ------------------------------------------------------------ # ============================================================
echo echo
echo "Porta TCP 10050:" echo "Porta TCP 10050:"
echo echo
if command -v ss >/dev/null 2>&1; then PORT_FINAL="$(
ss -lntp 2>/dev/null \
ss -lntp | grep ':10050' || \ | awk '$4 ~ /:10050$/ {print}' \
echo "AVISO: porta 10050 não encontrada."
fi
# ------------------------------------------------------------
# Informações finais
# ------------------------------------------------------------
IP_LOCAL="$(
hostname -I 2>/dev/null \
| awk '{print $1}' \
|| true || 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 "============================================================" echo "============================================================"
echo " INSTALAÇÃO CONCLUÍDA" echo " ZABBIX AGENT 2 INSTALADO COM SUCESSO"
echo "============================================================" echo "============================================================"
echo echo
echo "Sistema:"
echo " ${PRETTY_NAME}"
echo
echo "Hostname:" echo "Hostname:"
echo " ${HOSTNAME_FQDN}" echo " ${HOSTNAME_ZABBIX}"
echo echo
echo "IP:" echo "IP:"
echo " ${IP_LOCAL:-não detectado}" echo " ${IP_LOCAL:-não detectado}"
@ -309,16 +565,19 @@ echo
echo "Zabbix Server:" echo "Zabbix Server:"
echo " ${ZABBIX_SERVER}" echo " ${ZABBIX_SERVER}"
echo echo
echo "Agent:" echo "Passive checks:"
echo " TCP 10050" echo " ${ZABBIX_SERVER} -> ${IP_LOCAL:-HOST}:10050"
echo echo
echo "Active checks:" echo "Active checks:"
echo " ${ZABBIX_SERVER}:10051" echo " ${IP_LOCAL:-HOST} -> ${ZABBIX_SERVER}:10051"
echo echo
echo "Configuração:" echo "Configuração:"
echo " ${CONFIG}" echo " ${CONFIG}"
echo echo
echo "Backup:" echo "Status:"
echo " ${BACKUP}" echo " systemctl status zabbix-agent2"
echo
echo "Logs:"
echo " journalctl -u zabbix-agent2 -f"
echo echo
echo "============================================================" echo "============================================================"