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 エージェント 2 の両方に適用されます。

1. ダウンロードした MSI ファイルをダブルクリックして、インストールを開始します。

2. エンドユーザーライセンス契約に同意します。

3. インストールする Zabbix コンポーネント(エージェントデーモン、Zabbix sender、Zabbix get)を選択します。

インストーラーが提供するデフォルトのインストール場所を使用することを推奨します。 必要な権限がない状態でカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。

Program Files ディレクトリ外のカスタムの場所を使用し、保存先フォルダーがすでに存在する場合、インストーラーはその権限を変更しません。 新規インストール時には、適切な権限を手動で設定するか、権限を変更せずに続行するかを選択するよう求められます。

4. 以下のパラメータを設定します。 これらの値は、Zabbix エージェント設定ファイルに設定されます。

Parameter Description
ホスト名 Zabbix エージェントをインストールするマシンのホスト名。Hostname パラメータを設定します。
Zabbix サーバーの IP/DNS カンマ区切りの IP アドレス(必要に応じて CIDR 表記)、または Zabbix サーバーや Zabbix プロキシの DNS 名のリスト。このパラメータは必須です。Server パラメータを設定します。
エージェントの待ち受けポート エージェントがサーバーからの接続を待ち受けるポート。ListenPort パラメータを設定します。
アクティブチェック用のサーバーまたはプロキシ アクティブチェックを取得する Zabbix サーバーまたはプロキシのアドレス、あるいはクラスタ設定。サーバーまたはプロキシのアドレスは、IP アドレスまたは DNS 名に、コロンで区切った任意のポートを付加したものです。ServerActive パラメータを設定します。
PSK を有効にする 事前共有鍵を使用して TLS サポートを有効にするには、チェックボックスを選択します。TLSConnect および TLSAccept パラメータを psk に設定します。
エージェントの場所を PATH に追加 チェックボックスを選択して、Zabbix エージェントの場所をシステムの PATH 変数に追加します。

既存の Zabbix エージェントが検出された場合、その設定ファイルのパラメータ値が表示されます。 また、インストール中に既存の設定ファイルの名前が変更され、新しい設定ファイルが作成されます。

5. 前の手順で PSK を有効にする チェックボックスを選択した場合は、PSK パラメータを設定します。 これらのパラメータも Zabbix エージェント設定ファイルに設定されます。

Parameter Description
事前共有鍵の識別子 事前共有鍵の識別子文字列。TLSPSKIdentity パラメータを設定します。
事前共有鍵の値 事前共有鍵の文字列値。鍵を含む 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 Vista/Server 2008 より前の Windows バージョンでは自動起動)する Windows サービスとして設定されます。

インストール中に別のバージョンの Zabbix エージェントが実行されている場合は、アプリケーションを終了して再起動を試みるか、開いたままにするかを選択するよう求められます。後者を選択した場合は、再起動が必要になります。

7. Finish ボタンをクリックして、セットアップウィザードを終了します。

コマンドラインからのインストール

Zabbix エージェントは、msiexec を使用して MSI インストーラーを実行することで、コマンドラインからインストールできます。 例:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.2.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1

この方法では、パラメータを使用して、無人インストールやカスタム設定を行えます。

サポートされているパラメータ

Zabbix エージェント MSI インストーラー パッケージは、Zabbix エージェントと Zabbix エージェント 2 の両方で、以下のパラメータをサポートしています。

Zabbix エージェント/エージェント 2 のパラメータは、インストール中に設定ファイルへ設定されます。 パラメータ名をクリックすると、Zabbix エージェント(Windows)ページで詳細な説明と設定例を確認できます。 Zabbix エージェント 2 については、Zabbix エージェント 2(Windows)ページを参照してください。

パラメータ 説明
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 MSI インストーラーによる Zabbix エージェントサービスの起動を防止するには、DONOTSTART=1 を使用します。
ENABLEPATH Zabbix エージェントの場所をシステムの PATH 変数に追加するには、ENABLEPATH=1 を使用します。
ENABLEPERSISTENTBUFFER Zabbix エージェント 2 のみ。アクティブなアイテムでローカルの永続ストレージを使用できるようにします。
HOSTINTERFACE ホストインターフェースを定義するオプションのパラメータ。
HOSTMETADATA ホストメタデータを定義するオプションのパラメータ。
HOSTMETADATAITEM ホストメタデータの取得に使用するアイテムを定義するオプションのパラメータ。
HOSTNAME ホスト名を定義するオプションのパラメータ。
HOSTNAMEITEM ホスト名の取得に使用するアイテムを定義するオプションのパラメータ。
INCLUDE Zabbix エージェント設定ファイルに含める個別のファイル、またはディレクトリ内のすべてのファイルをセミコロン区切りで指定したリスト。
IGNOREALREADYEXISTSFOLDER 新規インストールの場合、Program Files ディレクトリ外にある既存の保存先フォルダーへのインストールを許可するには、IGNOREALREADYEXISTSFOLDER=1 を使用します。このパラメータを指定しない場合、そのような保存先フォルダーがすでに存在するとインストールに失敗します。
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 MSI インストーラーによる Zabbix エージェント用 Windows ファイアウォール例外ルールの追加を防止するには、SKIP=fw を使用します。
SOURCEIP Zabbix サーバーまたは Zabbix プロキシへの送信接続、または一部のアイテム(web.page.get、net.tcp.port など)の実行中に接続を確立する際に使用する送信元 IP アドレス。
STARTAGENTS パッシブチェックを処理する、フォーク済みの zabbix_agentd インスタンス数。
0 に設定すると、パッシブチェックが無効になり、エージェントはいずれの TCP ポートでも待ち受けなくなります。
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 エージェントをインストールします。 また、事前共有鍵を使用して TLS サポートを有効にします。

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.2.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-8.2.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"

# agent-template.conf の例:
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-8.2.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"

# agent-custom.conf の例:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

Zabbixエージェント2のロード可能なプラグイン

Zabbixエージェント2のロード可能なプラグインは、ダウンロード可能な64ビットMSIインストーラーパッケージを使用してWindowsにインストールできます。

MSIインストールの最小OS要件は、Windows 10(64ビット)またはWindows Server 2016です。

プラグインをインストールする前に、そのREADMEファイルを確認してください。 特定の要件やインストール手順が記載されている場合があります。

Zabbixエージェント/エージェント2と同様に、ロード可能なプラグインはセットアップウィザードまたはコマンドラインを使用してインストールできます。

セットアップウィザードからのインストール

1. ダウンロードした MSI ファイルをダブルクリックして、インストールを開始します。

2. エンドユーザーライセンス契約に同意します。

3. インストールする Zabbix エージェント 2 のロード可能なプラグインを選択します。

インストーラーで指定されているデフォルトのインストール先を使用することを推奨します。 必要な権限がない状態でカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。

4. Install をクリックして、インストールを開始します。

選択したすべての Zabbix エージェント 2 のロード可能なプラグインが指定した場所(デフォルト: C:\Program Files\Zabbix Agent 2)にインストールされ、設定ファイルは zabbix_agent2.d サブフォルダーにインストールされます。

5. Finish ボタンをクリックして、セットアップウィザードを終了します。

コマンドラインからのインストール

Zabbix agent 2のロード可能なプラグインは、msiexecを使用してMSIインストーラーを実行することで、コマンドラインからインストールできます。 例:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-8.2.0-windows-amd64.msi" /qn+

Zabbix agent 2のロード可能なプラグインのMSIインストーラーパッケージでは、次のパラメータがサポートされています。

Parameter Description
ADDDEFAULT デフォルト設定でインストールするコンポーネントをカンマ区切りで指定したリスト。詳細については、ADDDEFAULT propertyを参照してください。
指定可能な値: ALL、CephPlugin、EmberplusPlugin、MongodbPlugin、MssqlPlugin、NvidiagpuPlugin、PostgresqlPlugin
例: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL ローカルにインストールするコンポーネントをカンマ区切りで指定したリスト。詳細については、ADDLOCAL propertyを参照してください。
指定可能な値: ALL、CephPlugin、EmberplusPlugin、MongodbPlugin、MssqlPlugin、NvidiagpuPlugin、PostgresqlPlugin
例: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Zabbixコンポーネントをインストールするフォルダーの完全なパス名。設定ファイルはzabbix_agent2.dサブフォルダーにインストールされます。
例: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"