1 MSIからのWindowsエージェントのインストール
概要
Zabbixエージェントは、32ビットまたは64ビットのMSIインストーラーパッケージを使用してWindowsにインストールできます。これらはダウンロードできます。
MSIインストールの最小OS要件は以下の通りです。
- Zabbixエージェントの場合: Windows XP (64ビット) または Windows Server 2003
- Zabbix agent 2の場合: Windows 10 (32ビット) または Windows Server 2016
32ビットパッケージは64ビットシステムにはインストールできません。
パッケージには以下が含まれます。
- TLSサポート（TLSの設定は任意）
- Zabbix get および Zabbix sender ユーティリティ（Zabbixエージェント/agent 2と一緒、または個別にインストール可能）
Zabbix agent 2パッケージにはロード可能なプラグイン（MongoDB、PostgreSQL、MSSQL）は含まれていません。これらは別途ダウンロードしてインストールする必要があります。
インストールは、セットアップウィザードまたはコマンドラインを使用して行うことができます。
MSIパッケージによるインストールは完全にサポートされていますが、適切なエラー処理のために少なくともMicrosoft .NET Framework 2のインストールを推奨します。
インストーラーが提供するデフォルトのインストール場所を使用することを推奨します。 必要な権限がないカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。
セットアップウィザードからのインストール
以下のインストール手順は、Zabbix エージェントと Zabbix agent 2 の両方に適用されます。
1. ダウンロードした MSI ファイルをダブルクリックして、インストールを開始します:
2. エンドユーザー使用許諾契約に同意します:
3. インストールする Zabbix コンポーネント (Agent daemon、Zabbix sender、Zabbix get) を選択します:
インストーラーが提供する既定のインストール先を使用することを推奨します。 必要な権限がないカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。
Program Files ディレクトリ外のカスタムの場所を使用し、かつ配置先フォルダがすでに存在する場合、インストーラーはその権限を変更しません。
新規インストール時には、適切な権限を手動で設定するか、権限を変更せずに続行するかを選択するよう求められます。
4. 次のパラメーターを設定します。 その値は Zabbix エージェントの設定ファイルに設定されます:
| Parameter | Description |
|---|---|
| Host name | Zabbix エージェントをインストールするマシンのホスト名です。Hostname パラメーターを設定します。 |
| Zabbix server IP/DNS | Zabbix サーバーまたは Zabbix プロキシの IP アドレス（カンマ区切り、必要に応じて CIDR 表記可）または 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 agent 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.1この方法では、パラメーターを使用した無人インストールとカスタム設定が可能です。
サポートされるパラメーター
Zabbix agent MSI インストーラーパッケージは、Zabbix agent と Zabbix agent 2 の両方で次のパラメーターをサポートします。
Zabbix agent/agent2 のパラメーターは、インストール時に設定ファイルで指定されます。 パラメーター名をクリックすると、詳細な説明と設定例を Zabbix agent (Windows) ページで確認できます。 Zabbix agent 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 agent のチェックを制限する ための、セミコロン区切りの AllowKey または DenyKey パラメーター一覧です。必要に応じて、区切り文字はバックスラッシュでエスケープしてください (\;)。agent の設定ファイル内の AllowKey および DenyKey パラメーターを設定します。例: ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]" |
| CONF | Zabbix agent の テンプレート設定ファイル への完全なパス名です。インストール時に、このファイルは agent の設定ファイルになります。ファイルには少なくとも Server と LogFile パラメーターが含まれている必要があります。 例: CONF="C:\full\path\to\example.conf" |
| DONOTSTART | DONOTSTART=1 を使用すると、MSI インストーラーが Zabbix agent サービスを開始しないようにできます。Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされます。 |
| ENABLEPATH | ENABLEPATH=1 を使用すると、Zabbix agent の場所をシステムの PATH 変数に追加できます。 |
| ENABLEPERSISTENTBUFFER | Zabbix agent 2 のみ。アクティブアイテムに対してローカルの永続ストレージの使用を有効にします。 |
| HOSTINTERFACE | ホストインターフェースを定義する任意のパラメーターです。 |
| HOSTMETADATA | ホストメタデータを定義する任意のパラメーターです。 |
| HOSTMETADATAITEM | ホストメタデータを取得するために使用するアイテムを定義する任意のパラメーターです。 |
| HOSTNAME | ホスト名を定義する任意のパラメーターです。 |
| HOSTNAMEITEM | ホスト名を取得するために使用するアイテムを定義する任意のパラメーターです。 Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされます。 |
| INCLUDE | Zabbix agent の設定ファイルに含める、セミコロン区切りの個別ファイルまたはディレクトリ内のすべてのファイルの一覧です。 |
| IGNOREALREADYEXISTSFOLDER | 新規インストール時に、IGNOREALREADYEXISTSFOLDER=1 を使用すると、Program Files ディレクトリ外の既存の配置先フォルダーへのインストールを許可できます。このパラメーターを指定しない場合、そのような配置先フォルダーがすでに存在するとインストールは失敗します。 |
| INSTALLFOLDER | Zabbix コンポーネントと Zabbix agent の設定ファイルをインストールするフォルダーへの完全なパス名です。Zabbix agent 2 では、組み込みプラグイン 用の追加設定ファイルが zabbix_agent2.d\plugins.d サブフォルダーにインストールされます。例: INSTALLFOLDER="C:\Program Files\Zabbix Agent" |
| LISTENIP | agent が待ち受ける、カンマ区切りの IP アドレス一覧です。 |
| LISTENPORT | agent はこのポートでサーバーからの接続を待ち受けます。 |
| LOGFILE | Zabbix agent のログファイル名です。 |
| LOGTYPE | ログ出力の種類です。 |
| NONMSICONFNAME | Zabbix agent の カスタム設定ファイル への完全なパス名です。インストール時、このファイルに含まれる有効な agent 設定パラメーター（この表に記載されているものに限定されます）は、新しく作成される agent の設定ファイルに書き込まれます。ファイルには少なくとも Server パラメーターが含まれている必要があります。 例: NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | Zabbix agent 2 のみ。Zabbix agent 2 が SQLite データベースを保持するファイルです。 |
| PERSISTENTBUFFERPERIOD | Zabbix agent 2 のみ。サーバーまたはプロキシへの接続がない場合にデータを保存する期間です。 |
| SERVER | Zabbix server または Zabbix proxy の IP アドレス（必要に応じて CIDR 表記）または DNS 名の、カンマ区切り一覧です。このパラメーターは、STARTAGENTS が 0 に設定されている場合を除き、必須です。 |
| SERVERACTIVE | アクティブチェックを取得するための Zabbix server/proxy のアドレス、またはクラスタ構成です。 |
| SKIP | SKIP=fw を使用すると、MSI インストーラーが Zabbix agent 用の Windows Firewall 例外ルールを追加しないようにできます。 |
| SOURCEIP | Zabbix server または Zabbix proxy への送信接続、または一部のアイテム（web.page.get、net.tcp.port など）を実行する際の接続に使用する送信元 IP アドレスです。 Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされます。 |
| STARTAGENTS | パッシブチェックを処理する、事前 fork された zabbix_agentd インスタンスの数です。 0 に設定すると、パッシブチェックは無効になり、agent はいかなる TCP ポートでも待ち受けしません。 Zabbix 7.4.6 以降の MSI インストーラーパッケージでサポートされます。 |
| STARTUPTYPE | Zabbix agent サービスの起動種類です。指定可能な値: automatic - Windows の起動時にサービスを自動的に開始します; delayed - (既定) 自動起動サービスの起動完了後にサービスの開始を遅延します（Windows Vista/Server 2008 以降で利用可能）; manual - サービスを手動で開始します（ユーザーまたはアプリケーションによる）; disabled - サービスを無効にし、ユーザーまたはアプリケーションが開始できないようにします。 例: STARTUPTYPE=disabled |
| STATUSPORT | Zabbix agent 2 のみ。設定されている場合、agent は HTTP ステータス要求（http://localhost:<port>/status）をこのポートで待ち受けます。 |
| TIMEOUT | Zabbix proxy または server との接続確立およびデータ交換を待機する時間（秒）を指定します。 |
| TLSACCEPT | 受け入れる受信接続です（パッシブチェックで使用）。psk に設定すると、TLSCONNECT も psk に設定されます（別途指定されていない場合）。 |
| TLSCAFILE | ピア証明書の検証に使用する最上位 CA 証明書を含むファイルへの完全なパス名です。 |
| TLSCERTFILE | agent 証明書または証明書チェーンを含むファイルへの完全なパス名です。 |
| TLSCONNECT | agent が Zabbix server または proxy に接続する方法です（アクティブチェックで使用）。psk に設定すると、TLSACCEPT も psk に設定されます（別途指定されていない場合）。 |
| TLSCRLFILE | 失効した証明書を含むファイルへの完全なパス名です。 |
| TLSKEYFILE | Zabbix agent の秘密鍵を含むファイルへの完全なパス名です。 |
| TLSPSKFILE | Zabbix agent の事前共有鍵を含むファイルへの完全なパス名です。TLSPSKFILE と TLSPSKVALUE の両方が設定されている場合、TLSPSKVALUE の値は TLSPSKFILE で指定されたファイルに書き込まれます。事前共有鍵ファイルへのアクセスは、ファイルのセキュリティ設定を調整して Zabbix agent（または agent を実行するユーザー）のみが読み取れるように制限することを 推奨 します。 |
| TLSPSKIDENTITY | 事前共有鍵の識別文字列です。 |
| TLSPSKVALUE | 事前共有鍵の文字列値です。TLSPSKFILE と TLSPSKVALUE の両方が設定されている場合、TLSPSKVALUE の値は TLSPSKFILE で指定されたファイルに書き込まれます。 例: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | 許可される server（proxy）証明書の発行者です。 |
| TLSSERVERCERTSUBJECT | 許可される server（proxy）証明書のサブジェクトです。 |
| 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.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[*]"次の例では、より新しいバージョンの 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 のロード可能なプラグインは、Windows では 64 ビット MSI インストーラーパッケージを使用してインストールできます。これらはダウンロード可能です。
MSI インストールの最小 OS 要件は、Windows 10 (64 ビット) または Windows Server 2016 です。
Zabbix agent/agent2 と同様に、ロード可能なプラグインはセットアップウィザードまたはコマンドラインを使用してインストールできます。
プラグインをインストールする前に、README ファイルを確認してください。 そこには、特定の要件やインストール手順が記載されている場合があります。
セットアップウィザードからのインストール
1. ダウンロードしたMSIファイルをダブルクリックしてインストールを開始します。
2. エンドユーザーライセンス契約に同意します。
3. インストールするZabbix agent 2のロード可能なプラグインを選択します。
インストーラーが提供するデフォルトのインストール場所を使用することを推奨します。 必要な権限がないカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。
4. インストール をクリックしてインストールを開始します。
選択したすべてのZabbix agent 2のロード可能なプラグインが指定した場所（デフォルト: C:\Program Files\Zabbix Agent 2）にインストールされ、設定ファイルは zabbix_agent2.d サブフォルダーにインストールされます。
5. 完了 ボタンをクリックしてセットアップウィザードを終了します。
コマンドラインからのインストール
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" |