Table of Contents
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 de SO 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 do Usuário Final:
3. Selecione os componentes do Zabbix (Agent daemon, Zabbix sender, Zabbix get) 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. Configure os seguintes parâmetros. Seus valores serão definidos no arquivo de configuração do Zabbix agent:
| Parâmetro | Descrição |
|---|---|
| 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 na notação CIDR, ou nomes DNS de Zabbix servers ou Zabbix proxies. Este parâmetro é obrigatório. Define o parâmetro Server. |
| Agent listen port | O agent irá escutar neste porto por conexões do server. Define o parâmetro ListenPort. |
| Server or Proxy for active checks | O endereço do Zabbix server/proxy ou configuração de cluster para obter verificações ativas. O endereço do server/proxy é um endereço IP ou nome DNS e 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 de seu arquivo de configuração 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 PSK se você marcou a caixa Enable PSK na etapa anterior. Esses parâmetros também serão definidos no arquivo de configuração do Zabbix agent:
| Parâmetro | Descrição |
|---|---|
| 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). É recomendado restringir o acesso ao arquivo da chave pré-compartilhada ajustando as configurações de segurança do arquivo para que apenas 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 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 embutidos 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, será solicitado que você escolha entre fechar o aplicativo e tentar reiniciá-lo ou deixá-lo aberto, caso em que será necessário reiniciar o computador.
7. Clique no botão Finish para sair do Assistente de Configuração.
Instalação pela linha de comando
O agent Zabbix pode ser instalado pela linha de comando executando o instalador MSI com o msiexec. Por exemplo:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0Este método permite instalações não assistidas e configurações personalizadas usando parâmetros.
Parâmetros suportados
Os pacotes do instalador MSI do Zabbix agent suportam os seguintes parâmetros tanto para o Zabbix agent quanto para 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 do 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).
| Parâmetro | Descrição |
|---|---|
| ADDDEFAULT | Uma lista de componentes separados por vírgula para instalar em sua configuração padrão. Para mais informações, veja propriedade ADDDEFAULT. Valores possíveis: AgentProgram, GetProgram, SenderProgram, ALLExemplo: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | Uma lista de componentes separados por vírgula para instalar localmente. Para mais informações, veja 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 o delimitador (\;). Define os parâmetros AllowKey e DenyKey no arquivo de configuração do agent.Exemplo: ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | O caminho completo para um arquivo de configuração de template para o Zabbix agent. Durante a instalação, este arquivo se tornará o arquivo de configuração do agent. O arquivo deve conter pelo menos os parâmetros Server e LogFile. Exemplo: CONF="C:\full\path\to\example.conf" |
| ENABLEPATH | Use ENABLEPATH=1 para adicionar a localização do Zabbix agent à variável PATH do sistema. |
| ENABLEPERSISTENTBUFFER | Somente para o Zabbix agent 2. Habilita o uso de armazenamento local persistente para itens ativos. |
| HOSTINTERFACE | Parâmetro opcional que define a interface do host. |
| HOSTMETADATA | Parâmetro opcional que define os metadados do host. |
| HOSTMETADATAITEM | Parâmetro opcional que define um item usado para obter os metadados do host. |
| HOSTNAME | Parâmetro opcional que define o nome do host. |
| INCLUDE | Uma lista de arquivos individuais separados por ponto e vírgula ou todos os arquivos em um diretório 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 embutidos 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írgula nos quais o agent deve escutar. |
| LISTENPORT | O agent irá 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 para o Zabbix agent. Durante a instalação, quaisquer parâmetros de configuração válidos do agent presentes neste arquivo (limitados aos listados nesta tabela) serão escritos no novo arquivo de configuração do agent. O arquivo deve conter pelo menos o parâmetro Server. Exemplo: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Somente para o Zabbix agent 2. O arquivo onde o Zabbix agent 2 deve manter o banco de dados SQLite. |
| PERSISTENTBUFFERPERIOD | Somente para o Zabbix agent 2. O período de tempo pelo 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írgula, opcionalmente em notação CIDR, ou nomes DNS de Zabbix servers ou Zabbix proxies. Este parâmetro é obrigatório. |
| SERVERACTIVE | O endereço do Zabbix server/proxy ou 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 Firewall do Windows para o Zabbix agent. |
| 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) atrasa o início do serviço após a inicialização dos serviços iniciados automaticamente (disponível no Windows Vista/Server 2008 e versões posteriores); manual - inicia o serviço manualmente (por um usuário ou aplicativo); disabled - desativa o serviço para que não possa ser iniciado por um usuário ou aplicativo. Exemplo: STARTUPTYPE=disabled |
| STATUSPORT | Somente para o Zabbix agent 2. Se definido, o agent irá escutar nesta porta por solicitações de status HTTP (http://localhost:<port>/status). |
| TIMEOUT | Especifica quanto tempo esperar (em segundos) para estabelecer conexão e trocar dados com o Zabbix proxy ou server. |
| TLSACCEPT | As conexões recebidas 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 de um arquivo contendo o(s) certificado(s) da(s) CA(s) de nível superior para verificação do certificado do par. |
| TLSCERTFILE | O caminho completo de um arquivo contendo o certificado do agent ou 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 de um arquivo contendo certificados revogados. |
| TLSKEYFILE | O caminho completo de um arquivo contendo a chave privada do Zabbix agent. |
| TLSPSKFILE | O caminho completo de um arquivo contendo a chave pré-compartilhada do Zabbix agent. Se ambos TLSPSKFILE e TLSPSKVALUE forem 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 apenas 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 ambos TLSPSKFILE e TLSPSKVALUE forem 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 assunto do certificado do server (proxy) permitido. |
Exemplos
O exemplo a seguir instala o agent Zabbix com configuração personalizada. Também habilita o 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-8.0.0-windows-amd64-openssl.msi" /qn+^
SERVER=192.0.2.0^
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 agent Zabbix e usa um arquivo de configuração de template (CONF="C:\agent-template.conf"). Durante a instalação, este arquivo se tornará o arquivo de configuração do agent. Para herdar parâmetros do arquivo de configuração antigo, use marcadores de parâmetro (por exemplo, [AllowDenyKey]).
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"
# Exemplo de agent-template.conf:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]Alternativamente, você pode usar um arquivo de configuração personalizado (NONMSICONFNAME="C:\agent-custom.conf"). Durante a instalação, quaisquer parâmetros de configuração válidos do agent presentes neste 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 a serem preservados.
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.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 instalador MSI de 64 bits, disponíveis para download.
Os requisitos mínimos do sistema operacional para instalação via MSI são Windows 10 (64 bits) ou Windows Server 2016.
Os pacotes incluem:
Os pacotes não incluem o plugin Ember+, que atualmente só está disponível para ser compilado a partir do código-fonte (tanto para Unix quanto para Windows).
Antes de instalar um plugin, verifique seu arquivo README. Ele pode conter requisitos adicionais e instruções de instalação específicas para o plugin.
Assim como o Zabbix agent/agent2, os plugins carregáveis podem ser instalados usando o Assistente de Configuração ou a linha de comando.
Instalação pelo Assistente de Instalaçã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 (plugin MongoDB, plugin PostgreSQL, plugin MSSQL) 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 Instalaçã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 o msiexec. Por exemplo:
Os pacotes do instalador MSI dos plugins carregáveis do Zabbix agent 2 suportam os seguintes parâmetros.
| Parâmetro | Descrição |
|---|---|
| ADDDEFAULT | Uma lista de componentes separados por vírgula para instalar em sua configuração padrão. Para mais informações, consulte propriedade ADDDEFAULT. Valores possíveis: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALLExemplo: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | Uma lista de componentes separados por vírgula para instalar localmente. Para mais informações, consulte propriedade ADDLOCAL. Valores possíveis: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALLExemplo: 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" |