4 MSIでWindowsエージェントのインストール

概要

Windows版Zabbixエージェントは、ダウンロード可能なWindows MSIインストーラーパッケージ (32bit版と64bit版)を使用してインストールできます。

Zabbixエージェント2のMSIインストールの最小要件はWindows 10 32-bit/Server 2016です。

Zabbix getおよびsenderユーティリティも、Zabbixエージェント/エージェント2と一緒または個別にインストールできます。

32bit版のパッケージは64bit版のWindowsにインストールすることはできません。

すべてのパッケージはTLSをサポートしていますが、TLSの設定はオプションです。

UIおよびコマンドラインベースのインストールに対応しています。

MSIインストーラーパッケージからのZabbixインストールは完全にサポートされていますが、適切なエラー処理のために少なくともMicrosoft .NET Framework 2をインストールすることをお勧めします。 Microsoft Download .NET Frameworkを参照してください。

適切な権限なしでカスタムパスを使用すると、インストールのセキュリティが損なわれる可能性があるため、インストーラーによって提供されるデフォルトのパスを使用することをお勧めします。

インストール手順

インストールするには、ダウンロードしたMSIファイルをダブルクリックします。

ライセンスに同意して次のステップに進みます。

以下のパラメーターを指定します。

パラメーター 説明
Host name ホスト名を指定します。
Zabbix server IP/DNS ZabbixサーバーのIP/DNSを指定します。
Agent listen port エージェントのリッスン ポートを指定します (デフォルトは10050)。
Server or Proxy for active checks アクティブエージェントチェック用のZabbixサーバー/プロキシのIP/DNSを指定します。
Enable PSK チェックボックスをマークして、事前共有キーによるTLSサポートを有効にします。
Add agent location to the PATH エージェントの場所をPATH変数に追加します。

事前共有鍵のIDと値を入力します。 このステップは、前のステップでEnable PSKをチェックした場合のみ利用できます。

インストールするZabbixコンポーネントを選択します - Zabbix agent daemonZabbix senderZabbix get

Zabbixコンポーネントと設定ファイルはProgram FilesのZabbix Agentフォルダにインストールされます。 zabbix_agentd.exeは自動起動のWindowsサービスとして設定されます。

コマンドラインベースのインストール

サポートするパラメーター

作成されたMSIでは、次のパラメーターのセットがサポートされています。

番号 パラメーター 説明
1 LOGTYPE
2 LOGFILE
3 SERVER
4 LISTENPORT
5 SERVERACTIVE
6 HOSTNAME
7 TIMEOUT
8 TLSCONNECT
9 TLSACCEPT
10 TLSPSKIDENTITY
11 TLSPSKFILE
12 TLSPSKVALUE
13 TLSCAFILE
14 TLSCRLFILE
15 TLSSERVERCERTISSUER
16 TLSSERVERCERTSUBJECT
17 TLSCERTFILE
18 TLSKEYFILE
19 LISTENIP
20 HOSTINTERFACE
21 HOSTMETADATA
22 HOSTMETADATAITEM
23 STATUSPORT Zabbixエージェント2のみ。
24 ENABLEPERSISTENTBUFFER Zabbixエージェント2のみ。
25 PERSISTENTBUFFERPERIOD Zabbixエージェント2のみ。
26 PERSISTENTBUFFERFILE Zabbixエージェント2のみ。
27 INSTALLFOLDER
28 ENABLEPATH
29 SKIP SKIP=fw - ファイアウォール例外ルールをインストールしないでください
30 INCLUDE ;で区切られた一連のインクルード
31 ALLOWDENYKEY ;で区切られた"AllowKey"と"DenyKey"パラメーターのシーケンス。区切り文字をエスケープするには\\;を使用します。
例: ALLOWDENYKEY="AllowKey=system.run[type c:];DenyKey=system.run[*]"| |32|ADDPROGRAM|インストールするプログラムのカンマ区切りのリスト。
利用可能な値:
AgentProgram,GetProgram,SenderProgram
例: ADDPROGRAM=AgentProgram,GetProgram| |33|ADDLOCAL|インストールするプログラムのカンマ区切りのリスト。
利用可能な値:
AgentProgram,GetProgram,SenderProgram
例: ADDLOCAL=AgentProgram,SenderProgram| |34|CONF|カスタム設定ファイルへのパスを指定します。例:
CONF=c:.conf`

インストールするには、次のように実行します。

SET INSTALLFOLDER=C:\Program Files\za
       
       msiexec /l*v log.txt /i zabbix_agent-6.0.0-x86.msi /qn^
        LOGTYPE=file^
        LOGFILE="%INSTALLFOLDER%\za.log"^
        SERVER=192.168.6.76^
        LISTENPORT=12345^
        SERVERACTIVE=::1^
        HOSTNAME=myHost^
        TLSCONNECT=psk^
        TLSACCEPT=psk^
        TLSPSKIDENTITY=MyPSKID^
        TLSPSKFILE="%INSTALLFOLDER%\mykey.psk"^
        TLSCAFILE="c:\temp\f.txt1"^
        TLSCRLFILE="c:\temp\f.txt2"^
        TLSSERVERCERTISSUER="My CA"^
        TLSSERVERCERTSUBJECT="My Cert"^
        TLSCERTFILE="c:\temp\f.txt5"^
        TLSKEYFILE="c:\temp\f.txt6"^
        ENABLEPATH=1^
        INSTALLFOLDER="%INSTALLFOLDER%"^
        SKIP=fw^
        ALLOWDENYKEY="DenyKey=vfs.file.contents[/etc/passwd]"

または

msiexec /l*v log.txt /i zabbix_agent-6.0.0-x86.msi /qn^
        SERVER=192.168.6.76^
        TLSCONNECT=psk^
        TLSACCEPT=psk^
        TLSPSKIDENTITY=MyPSKID^
        TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952

TLSPSKFILEとTLSPSKVALUEの両方が渡されると、TLSPSKVALUEがTLSPSKFILEに書き込まれます。