Zabbix agent no IBM AIX

Visão geral

Os binários pré-compilados do Zabbix agent para IBM AIX estão disponíveis para download como um arquivo .tar.gz. Esta página descreve como instalar o agent a partir do arquivo, executá-lo manualmente ou com o System Resource Controller (SRC), iniciá-lo na inicialização do sistema e removê-lo do SRC.

Instalando o agent

O comando tar do AIX não oferece suporte à opção -z; portanto, descompacte o arquivo com gunzip. Use a opção -o do tar para que os arquivos extraídos pertençam ao usuário que os extrai, e não aos IDs numéricos de usuário e grupo armazenados no arquivo. Por exemplo, para colocar o agent em /opt/zabbix (execute como root; /opt/zabbix ainda não deve existir):

gunzip -c zabbix_agent-7.4.7-aix-7.2-powerpc-openssl.tar.gz | tar -xof -
mv zabbix_agent-7.4.7-aix-7.2-powerpc-openssl /opt/zabbix

No arquivo do AIX, o binário do agent está localizado em usr/sbin/ e o arquivo de configuração em etc/zabbix/. Antes de iniciar o agent, ajuste /opt/zabbix/etc/zabbix/zabbix_agentd.conf conforme necessário (pelo menos os parâmetros Server, ServerActive e Hostname).

Se iniciado como root, o agent muda para o usuário zabbix (ou para o usuário especificado pelo parâmetro User), a menos que AllowRoot=1 esteja definido no arquivo de configuração. Esse usuário deve existir no sistema; caso contrário, o agent não será iniciado. Se o usuário zabbix ainda não existir, crie-o junto com um grupo de mesmo nome:

mkgroup zabbix
mkuser pgrp=zabbix login=false rlogin=false zabbix

Os atributos login=false e rlogin=false impedem que a conta seja usada para login; o agent ainda pode ser executado como esse usuário.

Iniciando o agent manualmente

O agent pode ser iniciado manualmente:

/opt/zabbix/usr/sbin/zabbix_agentd -c /opt/zabbix/etc/zabbix/zabbix_agentd.conf

Executando o agent com SRC

Registrando o agent

O agent também pode ser registrado no System Resource Controller (SRC). Quando iniciado pelo SRC, o agent deve ser executado no modo foreground (a opção -f). Caso contrário, o SRC perderá o controle do processo do agent e não poderá interrompê-lo. Por exemplo (execute como root):

mkssys \
  -s zabbix_agentd \
  -p /opt/zabbix/usr/sbin/zabbix_agentd \
  -a "-c /opt/zabbix/etc/zabbix/zabbix_agentd.conf -f" \
  -u zabbix \
  -G tcpip \
  -S -n 15 -f 9 \
  -R

Neste exemplo:

  • -s define o nome do subsistema usado com os comandos do SRC;
  • -p define o caminho completo para o binário do agent;
  • -a define os argumentos de linha de comando do agent como uma única string entre aspas; o SRC divide essa string em argumentos separados ao iniciar o agent (somente uma opção -a é aceita);
  • -u define o usuário com o qual o agent é executado; o nome do usuário é convertido em um ID de usuário numérico quando o subsistema é criado, portanto, o usuário já deve existir;
  • -G adiciona o agent ao grupo de subsistemas tcpip, para que os comandos do grupo também se apliquem a ele (por exemplo, stopsrc -g tcpip também interrompe o agent);
  • -S -n 15 -f 9 faz com que o SRC controle o agent com sinais: stopsrc envia SIGTERM (15) para uma interrupção normal e SIGKILL (9) para uma interrupção forçada (stopsrc -f);
  • -R faz com que o SRC reinicie o agent se ele for encerrado de forma anormal (por exemplo, se um de seus processos falhar); o agent não é reiniciado após stopsrc.

Como o ID de usuário é armazenado na definição do subsistema, atualize a definição se o usuário zabbix for recriado com um ID de usuário diferente:

chssys -s zabbix_agentd -u zabbix
Iniciando e parando o agent

O agent pode ser iniciado, consultado e parado com startsrc, lssrc e stopsrc:

startsrc -s zabbix_agentd
lssrc -s zabbix_agentd
stopsrc -s zabbix_agentd

Evite a parada forçada (stopsrc -f). Ela encerra apenas o processo principal do agent; os outros processos do agent continuam em execução e mantêm a porta de escuta aberta. Portanto, o agent não poderá ser iniciado novamente até que esses processos sejam encerrados manualmente (por exemplo, com kill -9).

Iniciando o agent na inicialização do sistema

Registrar o agent no SRC não faz com que ele seja iniciado na inicialização do sistema. Para iniciar o agent automaticamente durante a inicialização, adicione uma entrada ao /etc/inittab:

mkitab "zabbix_agentd:2:once:/usr/bin/startsrc -s zabbix_agentd >/dev/console 2>&1"

Removendo o agent do SRC

Para remover o agent da inicialização do sistema e do SRC:

stopsrc -s zabbix_agentd
rmitab zabbix_agentd
rmssys -s zabbix_agentd