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と一緒、または個別にインストール可能）

インストールは、セットアップウィザードまたはコマンドラインを使用して行うことができます。

MSIパッケージによるインストールは完全にサポートされていますが、適切なエラー処理のために少なくともMicrosoft .NET Framework 2のインストールを推奨します。

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

以下のインストール手順は、Zabbix agentおよびZabbix agent 2の両方に適用されます。

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

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

3. インストールするZabbixコンポーネント（Agent daemon、Zabbix sender、Zabbix get）を選択します。

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

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

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

選択したすべてのZabbixコンポーネントとZabbix agentの設定ファイルが、指定した場所（デフォルト: C:\Program Files\Zabbix Agent）にインストールされます。 Zabbix agent 2の場合も同様ですが、組み込みプラグイン用の追加設定ファイルがzabbix_agent2.d\plugins.dサブフォルダにインストールされます。

さらに、zabbix_agentd.exe（またはzabbix_agent2.exe）は、遅延自動起動（またはWindows Vista/Server 2008以前のWindowsバージョンでは自動起動）でWindowsサービスとしてセットアップされます。

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

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

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

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

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

この方法では、パラメータを使用して無人インストールやカスタム構成が可能です。

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

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

例

次の例では、カスタム設定でZabbixエージェントをインストールします。 また、事前共有鍵を使用したTLSサポートも有効にします。

mkdir "C:\Program Files\Zabbix Agent" 2>nul
       msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.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エージェントの新しいバージョンをインストールし、テンプレート設定ファイル（CONF="C:\agent-template.conf"）を使用します。 インストール中、このファイルがエージェントの設定ファイルになります。 古い設定ファイルからパラメータを継承するには、パラメータプレースホルダー（例：[AllowDenyKey]）を使用します。

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.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.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"
       
       # agent-custom.conf の例:
       Server=192.0.2.8
       Hostname=DESKTOP-X9F4A2B

Zabbix agent 2 ロード可能なプラグイン

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

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

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

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

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

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

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

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

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

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

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

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

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

Zabbix agent 2のロード可能なプラグインMSIインストーラーパッケージは、以下のパラメータをサポートしています。