4 MSIでWindowsエージェントのインストール
概要
Windows版Zabbixエージェントは、ダウンロード可能なWindows MSIインストーラーパッケージ (32bit版と64bit版)を使用してインストールできます。
32bit版のパッケージは64bit版のWindowsにインストールすることはできません。
MSIインストールの最小要件は次のとおりです。
- Zabbixエージェントの場合: Windows XP 64-bitまたはWindows Server 2003
- Zabbixエージェント2の場合: Windows 10 32-bitまたはWindows Server 2016
32bitパッケージは、64bitシステムにインストールできません。
パッケージは以下を含みます。
- TLSサポート (TLS構成はオプションです)
- Zabbix getおよびZabbix senderユーティリティ (Zabbixエージェント/エージェント2と一緒または別々にインストールできます）
Zabbixエージェント2パッケージには、ダウンロードしてインストールを個別に必要とする必要があるロード可能なプラグイン(MongoDB、PostgreSQL、MSSQL)は含まれていません。
インストールは、セットアップウィザードまたはコマンドラインを使用して実行できます。
MSIパッケージを使用したインストールは完全にサポートされていますが、適切なエラー処理のため、少なくともMicrosoft .NET Framework 2をインストールすることをお勧めします。
インストーラーが提供するデフォルトのインストール場所を使用することをお勧めします。 必要な権限なしでカスタムロケーションを使用すると、インストールのセキュリティが損なわれる場合があります。
セットアップウィザードからのインストール
以下のインストール手順は、Zabbix エージェントと Zabbix エージェント 2 の両方に適用されます。
1. ダウンロードした MSI ファイルをダブルクリックして、インストールを開始します。
2. エンドユーザー使用許諾契約書に同意します。
3. インストールする Zabbix コンポーネント（Agent daemon、Zabbix sender、Zabbix get）を選択します。
インストーラーが提供するデフォルトのインストール先を使用することを推奨します。 必要な権限のないカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。
4. 以下のパラメータを設定します。 これらの値は Zabbix エージェントの設定ファイルに設定されます。
| Parameter | Description |
|---|---|
| Host name | Zabbix エージェントをインストールするマシンのホスト名です。Hostname パラメータを設定します。 |
| Zabbix server IP/DNS | カンマ区切りの IP アドレス一覧（CIDR 表記も可）または Zabbix サーバーもしくは Zabbix プロキシの DNS 名です。このパラメータは必須です。Server パラメータを設定します。 |
| Agent listen port | エージェントがサーバーからの接続を待ち受けるポートです。ListenPort パラメータを設定します。 |
| Server or Proxy for active checks | アクティブチェックの取得元となる Zabbix サーバー/プロキシのアドレス、またはクラスタ設定です。サーバー/プロキシのアドレスは、IP アドレスまたは DNS 名と、必要に応じてコロンで区切ったポート番号です。ServerActive パラメータを設定します。 |
| Enable PSK | チェックボックスをオンにすると、事前共有鍵の使用による TLS サポートを有効にします。TLSConnect および TLSAccept パラメータを psk に設定します。 |
| Add agent location to the PATH | チェックボックスをオンにすると、Zabbix エージェントの場所をシステムの PATH 変数に追加します。 |
既存の Zabbix エージェントが検出された場合、その設定ファイルのパラメータ値が表示されます。 さらに、インストール中に既存の設定ファイルはリネームされ、新しい設定ファイルが作成されます。
5. 前の手順で Enable PSK チェックボックスをオンにした場合は、PSK パラメータを設定します。 これらのパラメータも Zabbix エージェントの設定ファイルに設定されます。
| Parameter | Description |
|---|---|
| Pre-shared key identity | 事前共有鍵の識別文字列です。TLSPSKIdentity パラメータを設定します。 |
| Pre-shared key value | 事前共有鍵の文字列値です。鍵を含む psk.key ファイルを作成し、TLSPSKFile パラメータを鍵の場所（デフォルト: C:\Program Files\Zabbix Agent\psk.key）に設定します。ファイルのセキュリティ設定を調整し、Zabbix エージェント（またはエージェントを実行するユーザー）のみが事前共有鍵ファイルを読み取れるようにして、事前共有鍵ファイルへのアクセスを制限することを推奨します。 |
6. Install をクリックしてインストールを開始します。
選択したすべての Zabbix コンポーネントと Zabbix エージェントの設定ファイルが、指定した場所（デフォルト: C:\Program Files\Zabbix Agent）にインストールされます。
Zabbix エージェント 2 についても同様ですが、その組み込みプラグイン用の追加設定ファイルは zabbix_agent2.d\plugins.d サブフォルダにインストールされます。
さらに、zabbix_agentd.exe（または zabbix_agent2.exe）は、遅延自動開始の Windows サービスとして設定されます（Windows Vista/Server 2008 より前の Windows バージョンでは自動開始）。
インストール中に別バージョンの Zabbix エージェントが実行中の場合は、アプリケーションを閉じて再起動を試みるか、そのまま開いたままにするかを選択するよう求められます。後者の場合は再起動が必要になります。
7. Finish ボタンをクリックしてセットアップウィザードを終了します。
コマンドラインからのインストール
Zabbixエージェントは、msiexec を使用して MSI インストーラーを実行することで、コマンドラインからインストールできます。例:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0この方法では、パラメータを使用して無人インストールやカスタム設定を行うことができます。
サポートされるパラメータ
Zabbix エージェントおよび Zabbix エージェント 2 の両方について、Zabbix エージェント MSI インストーラーパッケージは以下のパラメータをサポートしています。
Zabbix エージェント/agent2 のパラメータは、インストール時に設定ファイルへ設定されます。 パラメータ名をクリックすると、Zabbix agent (Windows) ページで詳細な説明と設定例を確認できます。 Zabbix エージェント 2 については、Zabbix agent 2 (Windows) ページを参照してください。
| Parameter | Description |
|---|---|
| ADDDEFAULT | デフォルト設定でインストールするコンポーネントのカンマ区切りリスト。詳細は ADDDEFAULT property を参照してください。 指定可能な値: AgentProgram, GetProgram, SenderProgram, ALL例: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | ローカルにインストールするコンポーネントのカンマ区切りリスト。詳細は ADDLOCAL property を参照してください。 指定可能な値: AgentProgram, GetProgram, SenderProgram, ALL例: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Zabbix エージェントのチェックを制限するための、セミコロン区切りの AllowKey または DenyKey パラメータのリスト。必要に応じて、区切り文字 (\;) をエスケープするためにバックスラッシュを使用してください。エージェント設定ファイル内の AllowKey および DenyKey パラメータを設定します。例: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]" |
| CONF | Zabbix エージェント用のテンプレート設定ファイルへのフルパス名。インストール時に、このファイルがエージェント設定ファイルになります。このファイルには少なくとも Server および LogFile パラメータが含まれている必要があります。 例: CONF="C:\full\path\to\example.conf" |
| DONOTSTART | DONOTSTART=1 を使用すると、MSI インストーラーが Zabbix エージェントサービスを起動しないようにします。Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされています。 |
| ENABLEPATH | ENABLEPATH=1 を使用すると、Zabbix エージェントの場所をシステムの PATH 変数に追加します。 |
| ENABLEPERSISTENTBUFFER | Zabbix エージェント 2 のみ。アクティブアイテム用のローカル永続ストレージの使用を有効にします。 |
| HOSTINTERFACE | ホストインターフェースを定義する任意のパラメータです。 |
| HOSTMETADATA | ホストメタデータを定義する任意のパラメータです。 |
| HOSTMETADATAITEM | ホストメタデータの取得に使用するアイテムを定義する任意のパラメータです。 |
| HOSTNAME | ホスト名を定義する任意のパラメータです。 |
| HOSTNAMEITEM | ホスト名の取得に使用するアイテムを定義する任意のパラメータです。 Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされています。 |
| INCLUDE | Zabbix エージェント設定ファイルに含める、個別ファイルまたはディレクトリ内のすべてのファイルのセミコロン区切りリスト。 |
| INSTALLFOLDER | Zabbix コンポーネントおよび Zabbix エージェント設定ファイルをインストールするフォルダへのフルパス名。Zabbix エージェント 2 では、組み込みプラグイン用の追加設定ファイルが zabbix_agent2.d\plugins.d サブフォルダにインストールされます。例: INSTALLFOLDER="C:\Program Files\Zabbix Agent" |
| LISTENIP | エージェントが待ち受ける IP アドレスのカンマ区切りリスト。 |
| LISTENPORT | エージェントはこのポートでサーバーからの接続を待ち受けます。 |
| LOGFILE | Zabbix エージェントログファイルの名前。 |
| LOGTYPE | ログ出力の種類。 |
| NONMSICONFNAME | Zabbix エージェント用のカスタム設定ファイルへのフルパス名。インストール時に、このファイル内に存在する有効なエージェント設定パラメータ（この表に記載されているものに限る）が、新しく作成されるエージェント設定ファイルに書き込まれます。このファイルには少なくとも Server パラメータが含まれている必要があります。 例: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Zabbix エージェント 2 のみ。Zabbix エージェント 2 が SQLite データベースを保持するファイル。 |
| PERSISTENTBUFFERPERIOD | Zabbix エージェント 2 のみ。サーバーまたはプロキシへの接続がない場合にデータを保存しておく期間。 |
| SERVER | Zabbix サーバーまたは Zabbix プロキシの IP アドレス（CIDR 表記を任意で使用可能）または DNS 名のカンマ区切りリスト。このパラメータは、STARTAGENTS が 0 に設定されている場合を除き、必須 です。 |
| SERVERACTIVE | アクティブチェックの取得元となる Zabbix サーバー/プロキシのアドレスまたはクラスタ設定。 |
| SKIP | SKIP=fw を使用すると、MSI インストーラーが Zabbix エージェント用の Windows Firewall 例外ルールを追加しないようにします。 |
| SOURCEIP | Zabbix サーバーまたは Zabbix プロキシへの送信接続、または一部のアイテム（web.page.get、net.tcp.port など）の実行時に接続を行うための送信元 IP アドレス。 Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされています。 |
| STARTAGENTS | パッシブチェックを処理する zabbix_agentd の事前 fork されたインスタンス数。 0 に設定すると、パッシブチェックは無効になり、エージェントはいかなる TCP ポートでも待ち受けを行いません。 Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされています。 |
| STARTUPTYPE | Zabbix エージェントサービスの起動タイプ。指定可能な値: automatic - Windows 起動時にサービスを自動的に開始します。 delayed - (デフォルト) 自動起動するサービスの起動完了後に、サービスの開始を遅延させます（Windows Vista/Server 2008 以降で利用可能）。 manual - サービスを手動で開始します（ユーザーまたはアプリケーションによる）。 disabled - ユーザーまたはアプリケーションが開始できないようにサービスを無効化します。 例: STARTUPTYPE=disabled |
| STATUSPORT | Zabbix エージェント 2 のみ。設定すると、エージェントはこのポートで HTTP ステータスリクエストを待ち受けます (http://localhost:<port>/status)。 |
| TIMEOUT | Zabbix プロキシまたはサーバーとの接続確立およびデータ交換を待機する時間（秒）を指定します。 |
| TLSACCEPT | 受け入れる受信接続（パッシブチェックに使用）。psk に設定すると、TLSCONNECT も psk に設定されます（別途指定されていない場合）。 |
| TLSCAFILE | ピア証明書の検証に使用する最上位 CA 証明書を含むファイルへのフルパス名。 |
| TLSCERTFILE | エージェント証明書または証明書チェーンを含むファイルへのフルパス名。 |
| TLSCONNECT | エージェントが Zabbix サーバーまたはプロキシへどのように接続するか（アクティブチェックに使用）。psk に設定すると、TLSACCEPT も psk に設定されます（別途指定されていない場合）。 |
| TLSCRLFILE | 失効した証明書を含むファイルへのフルパス名。 |
| TLSKEYFILE | Zabbix エージェントの秘密鍵を含むファイルへのフルパス名。 |
| TLSPSKFILE | Zabbix エージェントの事前共有鍵を含むファイルへのフルパス名。TLSPSKFILE と TLSPSKVALUE の両方が設定されている場合、TLSPSKVALUE の値が TLSPSKFILE で指定されたファイルに書き込まれます。事前共有鍵ファイルへのアクセスは、Zabbix エージェント（またはエージェントを実行するユーザー）のみが読み取れるよう、ファイルのセキュリティ設定を調整して制限することを 推奨 します。 |
| TLSPSKIDENTITY | 事前共有鍵の識別文字列。 |
| TLSPSKVALUE | 事前共有鍵の文字列値。TLSPSKFILE と TLSPSKVALUE の両方が設定されている場合、TLSPSKVALUE の値が TLSPSKFILE で指定されたファイルに書き込まれます。 例: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | 許可されるサーバー（プロキシ）証明書の発行者。 |
| TLSSERVERCERTSUBJECT | 許可されるサーバー（プロキシ）証明書のサブジェクト。 |
| UNSAFEUSERPARAMETERS | ユーザー定義パラメータの引数にすべての文字を渡せるようにします。 Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされています。 |
例
次の例では、カスタム設定でZabbix エージェントをインストールします。 また、事前共有鍵を使用した TLSサポートも有効にします。
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.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[*]"次の例では、新しいバージョンのZabbix エージェントをインストールし、テンプレート設定ファイル（CONF="C:\agent-template.conf"）を使用します。
インストール中に、このファイルはエージェント設定ファイルになります。
古い設定ファイルからパラメータを引き継ぐには、パラメータプレースホルダー（例: [AllowDenyKey]）を使用します。
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"
# agent-template.conf example:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]または、カスタム設定ファイル（NONMSICONFNAME="C:\agent-custom.conf"）を使用することもできます。
インストール中、このファイルに含まれる有効なエージェント設定パラメータ（上の表に記載されているものに限定）は、新しく作成されるエージェント設定ファイルに書き込まれます。
既存のエージェント設定を保持するには、保持するパラメータを定義してください。
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"
# agent-custom.conf example:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2BZabbix agent 2 のロード可能なプラグイン
Zabbix agent 2 のロード可能なプラグインは、ダウンロード可能な64ビットMSIインストーラーパッケージを使用して、Windowsにインストールできます。
MSIインストールの最小OS要件は、Windows 10（64ビット）または Windows Server 2016 です。
Zabbix agent/agent2 と同様に、ロード可能なプラグインはセットアップウィザードまたはコマンドラインを使用してインストールできます。
プラグインをインストールする前に、READMEファイルを確認してください。 そこには、固有の要件やインストール手順が記載されている場合があります。
セットアップウィザードからのインストール
1. ダウンロードしたMSIファイルをダブルクリックして、インストールを開始します。
2. エンドユーザー使用許諾契約書に同意します。
3. インストールするZabbixエージェント 2のロード可能プラグインを選択します。
インストーラーが提供するデフォルトのインストール先を使用することを推奨します。 必要な権限のないカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。
4. Install をクリックして、インストールを開始します。
選択したすべてのZabbixエージェント 2ロード可能プラグインは、指定した場所（デフォルト: C:\Program Files\Zabbix Agent 2）にインストールされ、設定ファイルは zabbix_agent2.d サブフォルダにインストールされます。
5. Finish ボタンをクリックして、セットアップウィザードを終了します。
コマンドラインからのインストール
Zabbixエージェント 2 のロード可能なプラグインは、msiexec を使用して MSI インストーラーを実行することで、コマンドラインからインストールできます。例:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-7.4.0-windows-amd64.msi" /qn+Zabbixエージェント 2 のロード可能なプラグイン用 MSI インストーラーパッケージは、以下のパラメータをサポートしています。
| Parameter | Description |
|---|---|
| ADDDEFAULT | デフォルト設定でインストールするコンポーネントのカンマ区切りリストです。詳細は ADDDEFAULT property を参照してください。 指定可能な値: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin例: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | ローカルにインストールするコンポーネントのカンマ区切りリストです。詳細は ADDLOCAL property を参照してください。 指定可能な値: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin例: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Zabbix コンポーネントをインストールするフォルダの完全パス名です。設定ファイルは zabbix_agent2.d サブフォルダにインストールされます。例: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |