Documentation
Table of Contents
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コンポーネント(エージェントデーモン、Zabbix sender、Zabbix get)を選択します:
インストーラーによって提供されるデフォルトのインストール場所を使用することをお勧めします。 必要な権限のないカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。
4. 次のパラメーターを設定します。 これらの値は、Zabbixエージェント設定ファイルで設定されます:
| パラメーター | 説明 |
|---|---|
| ホスト名 | Zabbixエージェントがインストールされているマシンのホスト名。 ホスト名パラメーターを設定します。 |
| ZabbixサーバーのIP/DNS | ZabbixサーバーまたはZabbixプロキシのカンマ区切りのIPアドレス(オプションでCIDR表記)またはDNS名のリスト。このパラメーターは必須です。サーバーパラメーターを設定します。 |
| エージェントのlistenポート | エージェントは、サーバーからの接続をこのポートでlistenします。ListenPortパラメーターを設定します。 |
| アクティブチェック用のサーバーまたはプロキシ | アクティブチェックを取得するZabbixサーバー/プロキシアドレスまたはクラスター構成。サーバー/プロキシアドレスは、コロンで区切られたIPアドレスまたはDNS名とオプションのポートです。ServerActiveパラメーターを設定します。 |
| PSKを有効にする | チェックボックスをオンにして、TLSサポート事前共有キーを使用を有効にします。TLSConnectおよびTLSAcceptパラメーターをpskに設定します。 |
| エージェントの場所をPATHに追加する | チェックボックスをオンにして、Zabbixエージェントの場所をシステムPATH変数に追加します。 |
既存のZabbixエージェントが検出されると、その設定ファイルのパラメーター値が表示されます。 さらに、インストール中に既存の設定ファイルの名前が変更され、新しい設定ファイルが作成されます。
5. 前の手順でPSKを有効にするチェックボックスをオンにした場合は、PSKパラメーターを構成します。
これらのパラメーターは、Zabbixエージェント設定ファイルでも設定されます:
| パラメーター | 説明 |
|---|---|
| 事前共有キーID | 事前共有キーID文字列。TLSPSKIdentityパラメーターを設定します。 |
| 事前共有キー値 | 事前共有キー文字列値。キーを含むpsk.keyファイルを作成し、TLSPSKFileパラメーターをキーの場所(デフォルト: C:\Program Files\Zabbix Agent\psk.key)に設定します。ファイルのセキュリティ設定を調整して、Zabbixエージェント(またはエージェントを実行しているユーザー)のみが読み取れるようにすることで、事前共有キーファイルへのアクセスを制限することが推奨されます。 |
6. インストールをクリックしてインストールを開始します。
選択したすべての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. 完了ボタンをクリックして、セットアップウィザードを終了します。
コマンドラインからのインストール
Zabbixエージェントは、msiexecを使用してMSIインストーラーを実行することで、コマンドラインからインストールできます。例:
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0この方法では、無人インストールと、パラメーターを使用したカスタム構成が可能です。
サポートするパラメーター
ZabbixエージェントMSIインストーラーパッケージは、ZabbixエージェントとZabbixエージェント2の両方の次のパラメーターをサポートしています。
Zabbix Agent/Agent2パラメーターは、インストール中に設定ファイルに設定されます。 パラメーター名をクリックして、Zabbixエージェント(Windows)ページで詳細な説明と設定の例を表示します。 Zabbixエージェント2については、Zabbixエージェント2(Windows)ページを参照してください。
| パラメーター | 説明 |
|---|---|
| ADDDEFAULT | デフォルトの構成にインストールするプログラムのカンマ区切りのリスト。詳細については、ADDDEFAULT propertyを参照してください。 利用可能な値: AgentProgram、GetProgram、SenderProgram、ALL例: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | ローカルにインストールするプログラムのカンマ区切りのリスト。詳細については、ADDDEFAULT propertyを参照してください。 利用可能な値: AgentProgram、GetProgram、SenderProgram、ALL例: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | Zabbixエージェントチェックを制限ためのセミコロンで区切られた"AllowKey"と"DenyKey"パラメーターのリスト。必要に応じてバックスラッシュを使用して区切り文字をエスケープしてください(\;)。例: ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | Zabbixエージェントのカスタム設定ファイルへの完全パス名。インストール中、このファイルは、新規または既存のエージェント設定ファイルのコンテンツを完全に置き換えます。ファイルには、少なくともServerおよびLogFileパラメーターを含める必要があります。 例: CONF="C:\full\path\to\example.conf" |
| ENABLEPATH | ENABLEPATH=1を使用して、Zabbixエージェントの場所をシステムPATH変数に追加します。 |
| ENABLEPERSISTENTBUFFER | Zabbixエージェント2のみ。アクティブなアイテムに対してローカル永続ストレージの使用を有効にします。 |
| HOSTINTERFACE | ホストインターフェースを定義するオプションのパラメーター。 |
| HOSTMETADATA | ホストインターフェースを定義するオプションのパラメーター。 |
| HOSTMETADATAITEM | ホストのメタデータを取得するために使用されるアイテムを定義するオプションのパラメーター。 |
| HOSTNAME | ホスト名を定義するオプションのパラメーター。 |
| 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名のリスト。このパラメーターは必須です。 |
| SERVERACTIVE | アクティブなチェックを取得するZabbixサーバー/プロキシのアドレスまたはクラスター構成。 |
| SKIP | SKIP=fwを使用して、MSIインストーラーがZabbixエージェントにWindowsファイアウォール例外ルールを追加しないようにします。 |
| STARTUPTYPE | Zabbixエージェントサービスのスタートアップの種類。利用可能な値: automatic - Windowsの起動時にサービスを自動的に開始します。 delayed - (デフォルト) 自動的に開始されるサービスの起動が完了するまで、サービスの開始を遅らせます (Windows Server 2008/Vista以降のバージョンで利用可能)。 manual - サービスを手動で開始します (ユーザーまたはアプリケーションによって)。 disabled - サービスを無効にして、ユーザーまたはアプリケーションがサービスを開始できないようにします。 例: STARTUPTYPE=disabled |
| STATUSPORT | Zabbixエージェント2のみ。設定されている場合、エージェントはこのポートでHTTPステータス要求 (http://localhost:<port>/status) をリッスンします。 |
| TIMEOUT | Zabbixプロキシまたはサーバーと接続を確立しデータを交換するのに待つ時間を秒単位で指定します。 |
| TLSACCEPT | 受け入れる受信接続(パッシブチェックに使用)。pskに設定されている場合、TLSCONNECT もpskに設定されます(特に指定されていない限り)。 |
| TLSCAFILE | ピア証明書検証用のトップレベルCA証明書を含むファイルの完全パス名。 |
| TLSCERTFILE | エージェント証明書または証明書チェーンを含むファイルの完全パス名。 |
| TLSCONNECT | エージェントがZabbixサーバーまたはプロキシに接続する方法(アクティブチェックに使用)。pskに設定されている場合、TLSCONNECT もpskに設定されます(特に指定されていない限り)。 |
| TLSCRLFILE | 取り消された証明書を含むファイルの完全パス名。 |
| TLSKEYFILE | Zabbixエージェントの秘密キーを含むファイルのフルパス名。 |
| TLSPSKFILE | Zabbixエージェント事前共有キーを含むファイルのフルパス名。TLSPSKFILEとTLSPSKVALUEの両方が設定されている場合、TLSPSKVALUEcの値はTLSPSKFILEで指定されたファイルに書き込まれます。Zabbixエージェント(またはエージェントを実行しているユーザー)のみが読み取ることができるように、ファイルのセキュリティ設定を調整して、事前共有キーファイルへのアクセスを制限する推奨です。 |
| TLSPSKIDENTITY | 事前共有キーのID文字列。 |
| TLSPSKVALUE | 事前共有キーの値文字列。TLSPSKFILEとTLSPSKVALUEの両方が設定されている場合、TLSPSKVALUEcの値はTLSPSKFILEで指定されたファイルに書き込まれます。 例: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | 許可されたサーバー(プロキシ)証明書の発行者。 |
| TLSSERVERCERTSUBJECT | 許可されたサーバー(プロキシ)証明書のサブジェクト。 |
例
次の例では、カスタム構成でZabbixエージェントをインストールします。 また、TLSサポート事前共有キーを使用も有効にします。
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.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[*]"次の例では、新しいバージョンのZabbixエージェントをインストールし、カスタム設定ファイルを使用して、既存のエージェント設定ファイル内の特定のパラメーター(例: Hostname=LAPTOP-IKP7S51S,DESKTOP-X9F4A2B)を置き換えます。
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.10-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"Zabbixエージェント2ロード可能プラグイン
Zabbixエージェント2ロード可能プラグインは、ダウンロードで入手可能な64bit MSIインストーラーパッケージを使用してWindowsにインストールできます。
MSIインストールの最小OS要件は、Windows 10 (64bit)またはWindows Server 2016です。
パッケージには以下が含まれます:
パッケージにはEmber+ プラグインは含まれません。このプラグインは現在、ソースからビルドすることしかできません (UnixとWindows の両方)。
プラグインをインストールする前に、READMEファイルを確認してください。 プラグイン固有の追加要件とインストール手順が含まれている場合があります。
Zabbixエージェント/エージェント2と同様に、ロード可能なプラグインはセットアップウィザードまたはコマンド ラインを使用してインストールできます。
セットアップウィザードからのインストール
1. ダウンロードしたMSIファイルをダブルクリックしてインストールを開始します。
2. エンドユーザーライセンス契約に同意します。
3. インストールするZabbixエージェント2のロード可能なプラグイン(MongoDBプラグイン、PostgreSQLプラグイン、MSSQLプラグイン)を選択します。
インストーラーによって提供されるデフォルトのインストール場所を使用することをお勧めします。 必要な権限なしでカスタムの場所を使用すると、インストールのセキュリティが損なわれる可能性があります。
4. インストールをクリックしてインストールを開始します。
選択したすべてのZabbixエージェント2ロード可能プラグインは、指定した場所(デフォルト: C:\Program Files\Zabbix Agent 2)にインストールされ、その設定ファイルはzabbix_agent2.dサブフォルダーにインストールされます。
5. 完了ボタンをクリックして、セットアップウィザードを終了します。
コマンドラインからのインストール
Zabbixエージェント2のロード可能なプラグインは、msiexecを使用してMSIインストーラーを実行することで、コマンドラインからインストールできます。例:
Zabbixエージェント2のロード可能なプラグインMSIインストーラーパッケージは、次のパラメーターをサポートしています。
| パラメーター | 説明 |
|---|---|
| ADDDEFAULT | デフォルト構成でインストールするカンマ区切りのコンポーネントのリスト。詳細については、ADDDEFAULTプロパティを参照してください。 利用可能な値: MongodbPlugin、PostgresqlPlugin、MssqlPlugin、ALL例: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | ローカルにインストールするカンマ区切りのコンポーネントのリスト。詳細については、ADDLOCALプロパティを参照してください。 利用可能な値: MongodbPlugin、PostgresqlPlugin、MssqlPlugin、ALL例: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Zabbixコンポーネントがインストールされるフォルダーのフルパス名。設定ファイルはzabbix_agent2.dサブフォルダーにインストールされます。例: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |