1 Instalação do agent do Windows a partir do MSI
Visão geral
O agent do Zabbix pode ser instalado no Windows usando pacotes de instalação MSI de 32 ou 64 bits, disponíveis para download.
Os requisitos mínimos do sistema operacional para instalação via MSI são:
- Para o agent do Zabbix: Windows XP (64 bits) ou Windows Server 2003
- Para o agent 2 do Zabbix: Windows 10 (32 bits) ou Windows Server 2016
Pacotes de 32 bits não podem ser instalados em sistemas de 64 bits.
Os pacotes incluem:
- Suporte a TLS (a configuração de TLS é opcional)
- Utilitários Zabbix get e Zabbix sender (podem ser instalados junto com o agent/agent 2 do Zabbix ou separadamente)
Os pacotes do agent 2 do Zabbix não incluem plugins carregáveis (MongoDB, PostgreSQL, MSSQL), que precisam ser baixados e instalados separadamente.
A instalação pode ser feita usando o Assistente de Instalação ou a linha de comando.
Embora a instalação usando pacotes MSI seja totalmente suportada, recomenda-se instalar pelo menos o Microsoft .NET Framework 2 para um tratamento adequado de erros.
Recomenda-se usar o local de instalação padrão fornecido pelo instalador. Usar um local personalizado sem as permissões necessárias pode comprometer a segurança da instalação.
Instalação pelo Assistente de Configuração
As etapas de instalação a seguir se aplicam tanto ao Zabbix agent quanto ao Zabbix agent 2.
1. Clique duas vezes no arquivo MSI baixado para iniciar a instalação:
2. Aceite o Contrato de Licença de Usuário Final:
3. Selecione os componentes do Zabbix (Agent daemon, Zabbix sender, Zabbix get) a serem instalados:
É recomendável usar o local de instalação padrão fornecido pelo instalador. Usar um local personalizado sem as permissões necessárias pode comprometer a segurança da instalação.
4. Configure os seguintes parâmetros. Seus valores serão definidos no arquivo de configuração do Zabbix agent:
| Parameter | Description |
|---|---|
| Host name | O nome do host da máquina onde o Zabbix agent está sendo instalado. Define o parâmetro Hostname. |
| Zabbix server IP/DNS | Uma lista de endereços IP separados por vírgula, opcionalmente em notação CIDR, ou nomes DNS de servers Zabbix ou proxies Zabbix. Este parâmetro é obrigatório. Define o parâmetro Server. |
| Agent listen port | O agent escutará nesta porta por conexões do server. Define o parâmetro ListenPort. |
| Server or Proxy for active checks | O endereço do server/proxy Zabbix ou a configuração de cluster de onde obter active checks. O endereço do server/proxy é um endereço IP ou nome DNS, com porta opcional separada por dois-pontos. Define o parâmetro ServerActive. |
| Enable PSK | Marque a caixa de seleção para habilitar o suporte a TLS usando chaves pré-compartilhadas. Define os parâmetros TLSConnect e TLSAccept como psk. |
| Add agent location to the PATH | Marque a caixa de seleção para adicionar o local do Zabbix agent à variável PATH do sistema. |
Se um Zabbix agent existente for detectado, os valores dos parâmetros do arquivo de configuração dele serão exibidos. Além disso, o arquivo de configuração existente será renomeado durante a instalação, e um novo arquivo de configuração será criado.
5. Configure os parâmetros de PSK se você marcou a caixa de seleção Enable PSK na etapa anterior. Esses parâmetros também serão definidos no arquivo de configuração do Zabbix agent:
| Parameter | Description |
|---|---|
| Pre-shared key identity | A string de identidade da chave pré-compartilhada. Define o parâmetro TLSPSKIdentity. |
| Pre-shared key value | O valor da string da chave pré-compartilhada. Cria o arquivo psk.key contendo a chave e define o parâmetro TLSPSKFile para o local da chave (padrão: C:\Program Files\Zabbix Agent\psk.key). É recomendável restringir o acesso ao arquivo da chave pré-compartilhada ajustando as configurações de segurança do arquivo para que somente o Zabbix agent (ou o usuário que executa o agent) possa lê-lo. |
6. Clique em Install para iniciar a instalação.
Todos os componentes do Zabbix selecionados e o arquivo de configuração do Zabbix agent serão instalados no local especificado (padrão: C:\Program Files\Zabbix Agent).
O mesmo se aplica ao Zabbix agent 2, exceto que arquivos de configuração adicionais para seus plugins integrados serão instalados na subpasta zabbix_agent2.d\plugins.d.
Além disso, zabbix_agentd.exe (ou zabbix_agent2.exe) será configurado como um serviço do Windows com inicialização automática atrasada (ou inicialização automática em versões do Windows anteriores ao Windows Vista/Server 2008).
Se uma versão diferente do Zabbix agent estiver em execução durante a instalação, você será solicitado a escolher entre fechar o aplicativo e tentar reiniciá-lo ou deixá-lo aberto, caso em que será necessário reiniciar o sistema.
7. Clique no botão Finish para sair do Assistente de Configuração.
Instalação pela linha de comando
O agent do Zabbix pode ser instalado pela linha de comando executando o instalador MSI com msiexec. Por exemplo:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1Esse método permite instalações sem intervenção e configurações personalizadas usando parâmetros.
Parâmetros suportados
Os pacotes de instalação MSI do Zabbix agent oferecem suporte aos seguintes parâmetros para o Zabbix agent e o Zabbix agent 2.
Os parâmetros do Zabbix agent/agent2 são definidos no arquivo de configuração durante a instalação. Clique no nome de um parâmetro para ver sua descrição detalhada e exemplos de configuração na página Zabbix agent (Windows). Para o Zabbix agent 2, consulte a página Zabbix agent 2 (Windows).
| Parameter | Description |
|---|---|
| ADDDEFAULT | Uma lista de componentes separados por vírgulas para instalar em sua configuração padrão. Para mais informações, consulte a propriedade ADDDEFAULT. Valores possíveis: AgentProgram, GetProgram, SenderProgram, ALLExemplo: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Uma lista de componentes separados por vírgulas para instalar localmente. Para mais informações, consulte a propriedade ADDLOCAL. Valores possíveis: AgentProgram, GetProgram, SenderProgram, ALLExemplo: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Uma lista de parâmetros AllowKey ou DenyKey separados por ponto e vírgula para restringir verificações do Zabbix agent. Se necessário, use uma barra invertida para escapar do delimitador (\;). Define os parâmetros AllowKey e DenyKey no arquivo de configuração do agent.Exemplo: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]" |
| CONF | O caminho completo para um arquivo de configuração de template do Zabbix agent. Durante a instalação, esse arquivo se tornará o arquivo de configuração do agent. O arquivo deve conter, no mínimo, os parâmetros Server e LogFile. Exemplo: CONF="C:\full\path\to\example.conf" |
| DONOTSTART | Use DONOTSTART=1 para impedir que o instalador MSI inicie o serviço do Zabbix agent.Compatível com pacotes de instalação MSI desde o Zabbix 7.0.22. |
| ENABLEPATH | Use ENABLEPATH=1 para adicionar o local do Zabbix agent à variável PATH do sistema. |
| ENABLEPERSISTENTBUFFER | Somente Zabbix agent 2. Habilita o uso de armazenamento persistente local para items ativos. |
| HOSTINTERFACE | Um parâmetro opcional que define a interface do host. |
| HOSTMETADATA | Um parâmetro opcional que define os metadados do host. |
| HOSTMETADATAITEM | Um parâmetro opcional que define um item usado para obter os metadados do host. |
| HOSTNAME | Um parâmetro opcional que define o hostname. |
| HOSTNAMEITEM | Um parâmetro opcional que define um item usado para obter o nome do host. Compatível com pacotes de instalação MSI desde o Zabbix 7.0.22. |
| INCLUDE | Uma lista de arquivos individuais ou de todos os arquivos em um diretório, separados por ponto e vírgula, para incluir no arquivo de configuração do Zabbix agent. |
| INSTALLFOLDER | O caminho completo para uma pasta onde os componentes do Zabbix e o arquivo de configuração do Zabbix agent serão instalados. Para o Zabbix agent 2, arquivos de configuração adicionais para plugins integrados serão instalados na subpasta zabbix_agent2.d\plugins.d.Exemplo: INSTALLFOLDER="C:\Program Files\Zabbix Agent" |
| LISTENIP | Uma lista de endereços IP separados por vírgulas nos quais o agent deve escutar. |
| LISTENPORT | O agent escutará nesta porta por conexões do server. |
| LOGFILE | O nome do arquivo de log do Zabbix agent. |
| LOGTYPE | O tipo de saída do log. |
| NONMSICONFNAME | O caminho completo para um arquivo de configuração personalizado do Zabbix agent. Durante a instalação, quaisquer parâmetros válidos de configuração do agent presentes neste arquivo (limitados aos listados nesta tabela) serão gravados no novo arquivo de configuração do agent criado. O arquivo deve conter, no mínimo, o parâmetro Server. Exemplo: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Somente Zabbix agent 2. O arquivo onde o Zabbix agent 2 deve manter o banco de dados SQLite. |
| PERSISTENTBUFFERPERIOD | Somente Zabbix agent 2. O período de tempo durante o qual os dados devem ser armazenados quando não houver conexão com o server ou proxy. |
| SERVER | Uma lista de endereços IP separados por vírgulas, opcionalmente em notação CIDR, ou nomes DNS de Zabbix servers ou Zabbix proxies. Este parâmetro é obrigatório, exceto quando STARTAGENTS estiver definido como 0. |
| SERVERACTIVE | O endereço do Zabbix server/proxy ou a configuração de cluster para obter verificações ativas. |
| SKIP | Use SKIP=fw para impedir que o instalador MSI adicione uma regra de exceção no Windows Firewall para o Zabbix agent. |
| SOURCEIP | O endereço IP de origem para conexões de saída para o Zabbix server ou Zabbix proxy, ou para estabelecer conexões ao executar alguns items (web.page.get, net.tcp.port, etc.). Compatível com pacotes de instalação MSI desde o Zabbix 7.0.22. |
| STARTAGENTS | O número de instâncias pré-fork de zabbix_agentd que processam verificações passivas. Se definido como 0, as verificações passivas serão desabilitadas e o agent não escutará em nenhuma porta TCP. Compatível com pacotes de instalação MSI desde o Zabbix 7.0.22. |
| STARTUPTYPE | Tipo de inicialização do serviço do Zabbix agent. Valores possíveis: automatic - inicia o serviço automaticamente na inicialização do Windows; delayed - (padrão) adia a inicialização do serviço após os serviços iniciados automaticamente concluírem a inicialização (disponível no Windows Vista/Server 2008 e versões posteriores); manual - inicia o serviço manualmente (por um usuário ou aplicativo); disabled - desabilita o serviço para que ele não possa ser iniciado por um usuário ou aplicativo. Exemplo: STARTUPTYPE=disabled |
| STATUSPORT | Somente Zabbix agent 2. Se definido, o agent escutará nesta porta por solicitações HTTP de status (http://localhost:<port>/status). |
| TIMEOUT | Especifica quanto tempo aguardar (em segundos) para estabelecer conexão e trocar dados com o Zabbix proxy ou server. |
| TLSACCEPT | As conexões de entrada a serem aceitas (usado para verificações passivas). Se definido como psk, então TLSCONNECT também será definido como psk (a menos que especificado de outra forma). |
| TLSCAFILE | O caminho completo para um arquivo contendo os certificados da CA de nível superior para verificação do certificado do par. |
| TLSCERTFILE | O caminho completo para um arquivo contendo o certificado do agent ou a cadeia de certificados. |
| TLSCONNECT | Como o agent deve se conectar ao Zabbix server ou proxy (usado para verificações ativas). Se definido como psk, então TLSACCEPT também será definido como psk (a menos que especificado de outra forma). |
| TLSCRLFILE | O caminho completo para um arquivo contendo certificados revogados. |
| TLSKEYFILE | O caminho completo para um arquivo contendo a chave privada do Zabbix agent. |
| TLSPSKFILE | O caminho completo para um arquivo contendo a chave pré-compartilhada do Zabbix agent. Se TLSPSKFILE e TLSPSKVALUE estiverem definidos, o valor de TLSPSKVALUE será gravado no arquivo especificado em TLSPSKFILE. É recomendado restringir o acesso ao arquivo da chave pré-compartilhada ajustando as configurações de segurança do arquivo para que somente o Zabbix agent (ou o usuário que executa o agent) possa lê-lo. |
| TLSPSKIDENTITY | A string de identidade da chave pré-compartilhada. |
| TLSPSKVALUE | O valor da string da chave pré-compartilhada. Se TLSPSKFILE e TLSPSKVALUE estiverem definidos, o valor de TLSPSKVALUE será gravado no arquivo especificado em TLSPSKFILE. Exemplo: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | O emissor do certificado do server (proxy) permitido. |
| TLSSERVERCERTSUBJECT | O subject do certificado do server (proxy) permitido. |
| UNSAFEUSERPARAMETERS | Permite que todos os caracteres sejam passados como argumentos para parâmetros definidos pelo usuário. Compatível com pacotes de instalação MSI desde o Zabbix 7.0.22. |
Exemplos
O exemplo a seguir instala o Zabbix agent com configuração personalizada. Ele também habilita suporte a TLS usando chaves pré-compartilhadas.
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+^
SERVER=192.0.2.1^
INSTALLFOLDER="C:\Program Files\Zabbix Agent"^
HOSTNAME=LAPTOP-IKP7S51S^
TLSACCEPT=psk^
TLSCONNECT=psk^
TLSPSKIDENTITY="PSK 001"^
TLSPSKFILE="C:\Program Files\Zabbix Agent\psk.key"^
TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952^
ENABLEPATH=1^
ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]"O próximo exemplo instala uma versão mais recente do Zabbix agent e usa um arquivo de configuração de template (CONF="C:\agent-template.conf").
Durante a instalação, esse arquivo se tornará o arquivo de configuração do agent.
Para herdar parâmetros do arquivo de configuração antigo, use placeholders de parâmetros (por exemplo, [AllowDenyKey]).
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ CONF="C:\agent-template.conf"
# exemplo de agent-template.conf:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]Como alternativa, você pode usar um arquivo de configuração personalizado (NONMSICONFNAME="C:\agent-custom.conf").
Durante a instalação, quaisquer parâmetros válidos de configuração do agent presentes nesse arquivo (limitados aos listados na tabela acima) serão gravados no novo arquivo de configuração do agent criado.
Para manter a configuração existente do agent, defina os parâmetros que devem ser preservados.
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"
# exemplo de agent-custom.conf:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2BPlugins carregáveis do Zabbix agent 2
Os plugins carregáveis do Zabbix agent 2 podem ser instalados no Windows usando pacotes de instalação MSI de 64 bits, disponíveis para download. O plugin Ember+ está incluído nesses pacotes desde o Zabbix 7.0.10.
Os requisitos mínimos do sistema operacional para a instalação via MSI são Windows 10 (64 bits) ou Windows Server 2016.
Assim como o Zabbix agent/agent2, os plugins carregáveis podem ser instalados usando o Assistente de Configuração ou a linha de comando.
Antes de instalar um plugin, verifique o arquivo README dele. Ele pode conter requisitos específicos e instruções de instalação.
Instalação pelo Assistente de Configuração
1. Clique duas vezes no arquivo MSI baixado para iniciar a instalação.
2. Aceite o Contrato de Licença do Usuário Final.
3. Selecione os plugins carregáveis do Zabbix agent 2 a serem instalados.
Recomenda-se usar o local de instalação padrão fornecido pelo instalador. Usar um local personalizado sem as permissões necessárias pode comprometer a segurança da instalação.
4. Clique em Instalar para iniciar a instalação.
Todos os plugins carregáveis do Zabbix agent 2 selecionados serão instalados no local especificado (padrão: C:\Program Files\Zabbix Agent 2), com seus arquivos de configuração instalados na subpasta zabbix_agent2.d.
5. Clique no botão Concluir para sair do Assistente de Configuração.
Instalação pela linha de comando
Os plugins carregáveis do Zabbix agent 2 podem ser instalados pela linha de comando executando o instalador MSI com msiexec. Por exemplo:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-7.0.0-windows-amd64.msi" /qn+Os pacotes do instalador MSI dos plugins carregáveis do Zabbix agent 2 oferecem suporte aos seguintes parâmetros.
| Parameter | Description |
|---|---|
| ADDDEFAULT | Uma lista de componentes separados por vírgulas para instalar em sua configuração padrão. Para mais informações, consulte ADDDEFAULT property. Valores possíveis: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginExemplo: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Uma lista de componentes separados por vírgulas para instalar localmente. Para mais informações, consulte ADDLOCAL property. Valores possíveis: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, PostgresqlPluginExemplo: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | O caminho completo para uma pasta onde os componentes do Zabbix serão instalados, com seus arquivos de configuração instalados na subpasta zabbix_agent2.d.Exemplo: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |