Pandora FMS エージェントのインストール [wiki.pandorafms.jp]

この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。
====== Pandora FMS エージェントのインストール ======

{{indexmenu_n>32}}

[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]

For the online installation of the Pandora FMS Software Agent, see the section "[[:en:documentation:pandorafms:installation:01_installing#online_installation_of_pandora_fms_software_agent|Online installation of Pandora FMS Software Agent]]".

Pandora FMS ソフトウエアエージェントのオンラインインストールは、"[[:ja:documentation:pandorafms:installation:01_installing#pandora_fms_ソフトウエアエージェントのオンラインインストール|Pandora FMS ソフトウエアエージェントのオンラインインストール]]" を参照してください。

<WRAP center round info 90%>

Please note that in order to encrypt the communications through the **Tentacle** protocol between the software agents and their respective PFMS servers, it will be necessary to have SSL certificates and keys. Please visit the section "[[[:en:documentation:pandorafms:technical_reference:09_tentacle#ks6_1|Communication encryption]]" in the **Tentacle** protocol technical reference.

</WRAP>

<WRAP center round info 90%>

ソフトウェアエージェントと対応する Pandora FMS サーバ間の **Tentacle** プロトコルを介した通信を暗号化するには、SSL 証明書と鍵が必要であることに注意してください。 Tentacle プロトコルテクニカルリファレンスの「[[:ja:documentation:pandorafms:technical_reference:09_tentacle#通信の暗号化|通信の暗号化]]」の章も参照してください。

</WRAP>

<wrap #ks1 />

===== エージェントの条件 =====

The Agent can run on any computer with the minimum required operating system, any of the following are valid:

リモートエージェントは、最低限の環境のオペレーティングシステムが動作している機器で実行可能です。

^Component^Operating System|
|Pandora Agent 4.0 \\ or later| RedHat Enterprise (RHEL) 9 \\ / Rocky Linux 9 . \\  RedHat Enterprise (RHEL) 6.x and 8. \\  Fedora 34. \\  CentOS 6.x, 7 and 8. \\  AlmaLinux. \\  SLES 11 SP1 or later. \\  OpenSUSE 11.x or later. \\  Debian 5.x or later. \\  Ubuntu Server or Desktop \\ version 11 or later. \\  Linux Mint. \\  Elementary OS. \\  Manjaro. HPUX B.11.11 or later, with Perl 5.8. \\  AIX 4.3.3 or later, with Perl 5.8. \\  AIX 7.1 and 7.2. \\  BSD Systems \\ (NetBSD, OpenBSD, FreeBSD), with Perl 5.8. \\  MacOS X 10.6 or later. \\  Solaris 8 or later, with Perl 5.8. \\  Windows NT4 (see special notes for this version). \\  Windows XP. \\  Windows 2000. \\  Windows 2003. \\  Windows 2008. \\  Windows 7. \\  Windows 8. \\  Windows 10. \\  Windows 11. \\  Windows 2012. \\  Windows server 2016. \\  Windows server 2019.|
|Pandora Android Agent 2.0 \\ or later|Android 6 or later|
|Pandora Embedded Agent 4.0 \\ or later|Embedded devices, \\ compilation required|

^コンポーネント  ^OS  |
|Pandora Agent 4.0 以上 |RedHat Enterprise (RHEL) 9 \\ / Rocky Linux 9 \\ RedHat Enterprise (RHEL) 6.x および 8. \\ Fedora 34. \\ CentOS 6.x, 7 および 8. \\ AlmaLinux. \\ SLES 11 SP1 以上 \\ OpenSUSE 11.x 以上 \\ Debian 5.x 以上 \\ Ubuntu Server または Desktop version 11 以上 \\ Linux Mint. \\ Elementary OS. \\ Manjaro. HPUX B.11.11 以上で Perl 5.8 以上 \\ AIX 4.3.3 以上で Perl 5.8 以上 \\ AIX 7.1 および 7.2. \\ BSD Systems (NetBSD, OpenBSD, FreeBSD), Perl 5.8 以上が必要 \\ MacOS X 10.6 以上 \\ Solaris 8 以上で Perl 5.8 以上 \\ Windows NT4 (このバージョンの注意事項を参照) \\ Windows XP. \\ Windows 2000. \\ Windows 2003. \\ Windows 2008. \\ Windows 7. \\ Windows 8. \\ Windows 10. \\ Windows 11. \\ Windows 2012. \\ Windows server 2016. \\ Windows server 2019. |
|Pandora Android Agent 2.0 以降 |Android 6 以上 |
|Pandora Embedded Agent 4.0 以降 |組み込みデバイス、コンパイルが必要 |

<WRAP center round tip 60%> There is a special agent for Windows NT, which is basically the Unix agent compiled for Windows, although its performance is much lower than that of a native Windows agent and native API access features are not available. </WRAP>

<WRAP center round tip 60%> Windows NT 用には、Unix エージェントを Windows 向けにコンパイルした特別なエージェントがあります。ただし、Windows ネイティブのエージェントよりパフォーマンスが低く、ネイティブの API アクセス機能がありません。 </WRAP>

In addition, in UNIX environments, the following must be installed:

UNIX 環境では、以下がインストールされている必要があります。

   * **Perl 5.8** or higher
   * It will also be necessary to install the following dependencies:

  * **Perl 5.8**  またはそれ以上
  * 以下の依存パッケージをインストール必要があります

<code>
perl-YAML-Tiny-1.73-2
perl-Sys-Syslog
unzip
</code>

   * Configure **logrotate**:

  * **logrotate** の設定:

<code>cat> /etc/logrotate.d/pandora_agent <<EO_LRA
/var/log/pandora/pandora_agent.log {
        su root apache
        weekly
        missingok
        size 300000
        rotate 3
        maxage 90
        compress
        notifempty
        copytruncate
}

EO_LRA</code>

<code>chmod 0644 /etc/logrotate.d/pandora_agent</code>

<wrap #ks2 />

===== RedHat Enterprise (RHEL) 9 および Rocky Linux 9 へのエージェントインストール =====

Download and install it through:

以下の方法でダウンロードしてインストールします。

<code bash>
dnf install -y https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_agent_linux_bin-7.0NG.x86_64.el9.rpm


</code>

If necessary, ''yum''  or ''rpm -i''  is used instead of ''dnf''.

必要に応じて、''dnf'' の代わりに ''yum'' または ''rpm -i'' を使用します。

The installation package installs the following dependencies:

インストールパッケージは、次の依存ファイルをインストールします。

<code>
perl wget curl perl-Sys-Syslog unzip libnsl libxcrypt-compat

</code>

These dependencies are required and, if necessary, must be installed separately.

これらの依存ファイルは必須であり、必要に応じて個別にインストールする必要があります。

For uninstalling [[#ks10|see the corresponding section]].

アンインストールに関しては、[[#ks10|こちらの章を参照してください]]。

<wrap #ks3 />

===== CentOS 8 / Rocky Linux / AlmaLinux へのエージェントインストール =====

Installation of dependencies:

依存ファイルのインストール:

<code>
yum install dnf-plugins-core -y
yum config-manager --set-enabled powertools -y
yum install -y perl-YAML-Tiny perl-Sys-Syslog unzip

</code>

If you are going to use the option [[:en:documentation:pandorafms:installation:05_configuration_agents#server_ssl|server_ssl]] install the following dependencies, enter in the terminal:

[[:ja:documentation:pandorafms:installation:05_configuration_agents#server_ssl|server_ssl]] オプションを利用する場合は、次のように依存ファイルをインストールします。

<code>

yum install perl-IO-Socket-SSL -y

</code>

Agent Installation:

エージェントインストール:

<code>
yum install -y https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_agent_linux-7.0NG.noarch.rpm

</code>

For uninstalling [[#ks10|see the corresponding section]].

アンインストールに関しては、[[#ks10|こちらの章を参照してください]]。

<wrap #ks4 />

===== CentOS 7 へのエージェントインストール =====

Installation of dependencies:

依存ファイルのインストール:

<code bash>
yum install dnf-plugins-core -y
yum install -y perl-YAML-Tiny perl-Sys-Syslog unzip

</code>

If you are going to use the option [[:en:documentation:pandorafms:installation:05_configuration_agents#server_ssl|server_ssl]] install the following dependencies, enter in the terminal:

[[:ja:documentation:pandorafms:installation:05_configuration_agents#server_ssl|server_ssl]] オプションを利用する場合は、次のように依存ファイルをインストールします。

<code bash>
yum install perl-IO-Socket-SSL -y

</code>

Software agent installation:

ソフトウエアエージェントインストール:

<code bash>
yum install -y https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_agent_linux-7.0NG.noarch.rpm

</code>

For uninstalling [[#ks10|see the corresponding section]].

アンインストールに関しては、[[#ks10|こちらの章を参照してください]]。

<wrap #ks5 />

===== Ubuntu Server 22.04 へのエージェントインストール =====

Installing the Software agent:

ソフトウエアエージェントインストール:

<code bash>
apt update
apt install -y perl coreutils wget curl unzip procps python3 python3-pip
wget http://firefly.pandorafms.com/pandorafms/latest/Tarball/pandorafms_agent_linux-7.0NG.tar.gz
tar xvzf pandorafms_agent_linux-7.0NG.tar.gz
cd unix
./pandora_agent_installer --install
cp -a tentacle_client /usr/local/bin/

</code>

Delete the ''unix'' directory.

''unix'' ディレクトリを削除します。

If you are going to use the option [[:en:documentation:pandorafms:installation:05_configuration_agents#server_ssl|server_ssl]] install the following dependencies, enter in the terminal:

[[:ja:documentation:pandorafms:installation:05_configuration_agents#server_ssl|server_ssl]] オプションを利用する場合は、次のように依存ファイルをインストールします。

<code bash>
apt install libio-socket-ssl-perl -y

</code>

Agent Configuration:

エージェント設定:

<code bash>
sed -i "s/^remote_config.*$/remote_config 1/g" $PANDORA_AGENT_CONF
/etc/init.d/pandora_agent_daemon start
systemctl enable pandora_agent_daemon

</code>

For uninstalling [[#ks9|see the corresponding section]].

アンインストールに関しては、[[#ks10|こちらの章を参照してください]]。

<wrap #ks6 />

===== tar ボールからのエージェントインストール =====

This version of the agent is ready to be installed on any Unix/Linux/macOS system.

このパッケージは、任意の Unix/Linux/MAC OS システムへインストールするのに使えます。

<WRAP center round download 90%>

[[https://firefly.pandorafms.com/pandorafms/latest/pandorafms_one_agent_linux-latest.tar.gz]]

</WRAP>

The agent does not require compilation or preparation, once you have downloaded the agent in ''.tar.gz'' format:

エージェントはコンパイルの必要はありません。エージェントの tar.gz ファイルをダウンロードしたら、次のようにします。

1. Elevate privileges to root. You are solely responsible for said key.

1. root 権限を取得します。

<code bash>
su -

</code>

2. Copy to ''/tmp'', change to that directory, and run:

2. ファイルを /tmp 以下に展開し、インストーラを実行します。

<code bash>
tar xvzf pandorafms_one_agent_linux-latest.tar.gz
cd unix
./pandora_agent_installer --install

</code>

3. Manually start the Agent:

3. エージェントを手動で起動します。

<code bash>
/etc/init.d/pandora_agent_daemon start

</code>

<wrap #ks6_1 />

==== エージェントのカスタムインストール ====

The Agent can be installed in a directory defined by the user in an integral way, this means that all the agent files will be put in that directory: logs, configuration files, binaries, help pages **man**, etc.

エージェントは、完全にカスタムなディレクトリにインストールすることができます。このカスタムディレクトリに、エージェントの設定ファイル、ログファイル、プラグインや **man** ページの全てが入ります。

To use that method, just run like the following example:

カスタムディレクトリを指定するには、次のように実行します。

<code>
./pandora_agent_installer --install /opt/pandora

</code>

The only file that Pandora FMS will create outside that directory defined by the user, is the agent launcher in ''/etc/init.d/pandora_agent_daemon'' (or equivalent in other Unix systems), and the link in the directory of the system boot level, for example ''/etc/rc.d/rc2.d/S90pandora_agent_daemon''.

指定したディレクトリ以外に作成されるファイルは、起動スクリプトの ''/etc/init.d/pandora_agent_daemon''  (UNIX の種類よって異なります) および、''/etc/rc.d/rc2.d/S90pandora_agent_daemon''  等のリンクファイルのみとなります。

In addition, you can configure the installation so that instead of running the Agent as root, it can be run as another user. For example, for the Agent to run with the user ''pandora'', it would be:

また、root 以外のユーザでエージェントを実行するようにインストールすることもできます。たとえば、''pandora'' ユーザで実行する場合は、次のようにインストールします。

<code>
./pandora_agent_installer --install /home/pandora pandora

</code>

When a custom user is specified, the Agent must be installed in a custom location where the user has write permissions (''/home/pandora'' in the previous example).

カスタムユーザを指定した場合は、ユーザに書き込み権限があるディレクトリを指定してインストールする必要があります(上記の例では ''/home/pandora'')。

<WRAP center round important 90%>

  * The user ''pandora'' is disabled by default, you must enable it by putting a valid shell in ''/etc/passwd''  if you want to use it to run the agent with that user.
  * For users running **MAC OS X version 10.11**  or higher (El Capitan or newer): Apple® has added a new layer of security to OS X. They are gone some root privileges. When installing the Pandora FMS Agent it will appear as a restricted process. Only restricted processes that are signed by Apple® will be able to modify these files. However, you can disable this security by booting into recovery mode and disabling it in a terminal by running: ''csrutil disable''.

</WRAP>

<WRAP center round important 90%>

  * ユーザ ''pandora''  は、セキュリティ上の理由によりほとんどの場合デフォルトでは無効化されています。エージェントの実行に pandora ユーザを利用したい場合は、''/etc/passwd''  ファイルで有効なシェルを設定する必要があります。 </WRAP>
  * **OS X 10.11**  またはそれ以上の場合: Apple により OS X に新たなセキュリティレイヤが追加されました。これにより root からいくつかの権限が外されています。Pandora FMS エージェントのインストール時に制限されたプロセスと表示されます。Apple によって承認されたプロセスでのみファイルの編集ができます。このセキュリティシステムは、リカバリモードで起動したときに、ターミナルで ''csrutil disable'' を実行することにより無効化できます。

</WRAP>

<wrap #ks7 />

===== NetBSD および FreeBSD へのエージェントインストール =====

The location of the files and the structure of the init script are different compared to Linux.

ファイルの場所と起動スクリプトは Linux とは異なります。

<WRAP center round download 90%>

[[https://firefly.pandorafms.com/pandorafms/latest/Tarball/pandorafms_agent_linux-7.0NG.tar.gz|https://firefly.pandorafms.com/pandorafms/latest/Tarball/pandorafms_agent_linux-7.0NG.tar. gz]]

</WRAP>

The peculiarities of the installation on FreeBSD would be the following:

FreeBSD へのエージェントインストールは次の通りです。

1. Acquire root permissions

1. root 権限を取得します。

<code bash>
su -

</code>

2. Copy the downloaded file to ''/tmp'' and once inside ''/tmp'' run:

2. ファイルを ''/tmp'' 以下に展開し、インストーラを実行します。

<code bash>
tar xvzf pandorafms_agent_linux-7.0NG.tar.gz
cd unix
./pandora_agent_installer --install

</code>

After installation, add the following line to ''/etc/rc.conf.''

インストール後、以下の行を ''/etc/rc.conf''  に追加する必要があります。

<code>
pandora_agent_enable="YES"

</code>

To enable the Pandora FMS agent, these settings are needed, otherwise the process will not start.

Pandora エージェントを有効化するにはこの設定が必要です。これを行わないとプロセスが自動起動しません。

If you want to start the agent manually, run this:

エージェントを手動で起動する場合は、次のように実行します。

<code bash>
/usr/local/etc/rc.d/pandora_agent start

</code>

FreeBSD は、Pandora エージェントのほとんどのファイルが /usr/local 以下にインストールされます。

Software agent:

ソフトウエアエージェント:

<code>
/usr/local/bin/pandora_agent

</code>

boot script:

起動スクリプト:

<code>
/usr/local/etc/rc.d/pandora_agent

</code>

Configuration file:

設定ファイル:

<code>
/usr/local/etc/pandora/pandora_agent.conf

</code>

Plugins:

プラグイン:

<code>
/usr/local/share/pandora_agent/plugins/*

</code>

Helps **man**:

**man** ファイル:

<code>
/usr/local/man/man1/*

</code>

Others: The ''data_in'' and ''log'' directories are the same as in GNU/Linux.

その他: ''data_in'' および ''log'' ディレクトリは、GNU/Linux と同じです。

<wrap #ks8 />

===== Windows へのエージェントインストール =====

The agent is delivered as [[https://firefly.pandorafms.com/pandorafms/latest/Windows/|a self-installer in executable format]] ( ''.exe'' ). To install Pandora FMS agent in MS Windows® download and execute it.

エージェントは、[[https://firefly.pandorafms.com/pandorafms/latest/Windows/|実行形式]] ( ''.exe'' ) のインストーラとして提供しています。基本的なインストールは、各ステップでオプションに答えるだけです。

<WRAP center round download 90%>

https://pandorafms.com/en/downloads/

</WRAP>

The installer will guide you through the necessary steps in the language you select. The following example shows the installation for Windows 10®. If you are running MS Windows® as a standard user you will need Administrator permissions, enter them when running the installer.

インストーラーは、選択した言語で必要な手順を案内します。 次の例は、Windows 10® でのインストールを示しています。 MS Windows® を標準ユーザとして実行している場合は、管理者権限が必要になります。インストーラーの実行時に管理者のパスワードを入力してください。

{{  :wiki:pfms-software_agent-ms_windows_.png  }}

Select the language:

言語を選択します。

{{ :wiki:pandora_agent_3.0_rc3_install_windows_01.png }}

Follow the installer steps:

インストーラのステップに従います。

{{ :wiki:pandora_agent_3.0_rc3_install_windows_021.png }}

Accept the license terms and click **Next**:

ライセンス条項に同意し、**Next** をクリックします。

{{ :wiki:pandora_agent_3.0_rc3_install_windows_031.png }}

Select the path where the Pandora FMS agent will be installed, by default it is installed in:

''%ProgramFiles%\pandora_agent''), you can change it by clicking **Browse…**. Then click **Next**:

Pandora FMS エージェントをインストールするパスを選択します。デフォルトでは ''%ProgramFiles%\pandora_agent'' です。**Browse..** をクリックすると変更できます。次に **Next** をクリックします。

{{ :wiki:pandora_agent_3.0_rc3_install_windows_04.png }}

Wait for the files to be copied.

ファイルがコピーされるのを待ちます。

{{ :wiki:pandora_agent_3.0_rc3_install_windows_061.png }}

Configure the data for the agent as the IP address (or name) of the Pandora FMS server that will receive the Agent data. To be able to change other parameters, such as changing the name of the agent (by default it takes the value of the hostname of the machine) or the path of the temporary files, you will have to manually edit the agent configuration.

エージェントからのデータを受け取る Pandora FMS サーバの IP アドレス(または名前)を設定します。 エージェント名(デフォルトではマシンのホスト名が使われます)やテンポラリファイルのパスなど、その他パラメータを変更するには、エージェントの設定ファイルを手動で編集する必要があります。

{{ :wiki:pandora_agent_3.0_rc3_install_windows_07.png }}

The remote configuration of the software agent is enabled by default. Check the options to be used such as basic security monitoring and/or security hardening and/or hardware and software inventory control. Set the minimum amount of free space for temporary files.

ソフトウェアエージェントのリモート設定はデフォルトで有効になっています。 基本的なセキュリティ監視、セキュリティ強化、ハードウェアおよびソフトウェアのインベントリ管理など、使用するオプションを確認します。 一時ファイルのための最小空き容量を設定します。

{{ :wiki:pandora_agent_remote_config.png }}

Start the Pandora FMS agent service, otherwise you will have to do it manually, or it will start when Windows restarts again.

Pandora FMS エージェントサービスを開始します。そうしない場合は、手動で行うか、Windows が再起動したときにサービスが開始されます。

{{ :wiki:pandora_agent_3.0_rc3_install_windows_08.png }}

The installation is finished, you can change the agent parameters in the ''pandora_agent.conf'' file or through the direct link in the Pandora FMS menu.

インストール完了です。エージェントのパラメータは ''pandora_agent.conf'' を編集するか、Pandora FMS メニューからのリンクで変更できます。

<wrap #ks8_1 />

==== Windows エージェントのコマンドラインインストール ====

As of Agent version **5.1**, the installer supports unattended mode. To carry out the installation, you simply have to execute the following:

**バージョン 5.1**  以降のエージェントでは、インストーラは(GUIを使わない)コマンドラインインストールが可能です。インストールには、次のコマンドを実行します。

<code>

"Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S

</code>

In case you want to install the Agent in a different path than the default one:

デフォルトとは異なるパスにエージェントをインストールする場合は、次のようにします。

<code>
"Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S /D=C:\PFMS_agent

</code>

You can also pass certain parameters to be written in the configuration file of the agent to create. Thanks to these options, the deployment of Pandora FMS agents is much more customizable. The command line options that are supported are the following:

作成するエージェントの設定ファイルに書き込まれるように特定のパラメータを渡すこともできます。これらのオプションにより、Pandora FMS エージェントのデプロイはカスタマイズ可能です。 サポートされているコマンドラインオプションは次のとおりです。

<code>
--ip

</code>

   * Corresponds to the token named **server_ip**.

  * **server_ip** トークンに対応します。

<code>
--group

</code>

   * Corresponds to the token named **group**.

  * **group** トークンに対応します。

<code>
--alias

</code>

   * Corresponds to the token named **agent_alias**.

  * **agent_alias** トークンに対応します。

<code>
--remote_config

</code>

   * Corresponds to the token named **remote_config**

  * **remote_config** トークンに対応します。

For example, if you want to create an agent that belongs to the Applications group, named Mifunne and that points to the server with the IP address 192.168.0.59, with the [[:en:documentation:03_monitoring:02_operations#remote_configuration|remote_configuration enabled]], the command would be:

例えば、//Mifunne//  という名前で、グループ //Applications//  に所属し、サーバの IP が //192.168.0.59//  のエージェントを[[:ja:documentation:03_monitoring:02_operations#リモート設定|リモート設定有効で]]作成したい場合は、次のようなコマンドを実行します。

<code>

"Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S --ip 192.168.0.59 --group Applications --alias Mifunne --remote_config 1

</code>

<wrap #ks8_2 />

==== コマンドラインでのアンインストール ====

The uninstaller, which is an executable called ''uninstall.exe'' that remains in the Pandora FMS installation directory, also allows **unattended uninstallation**, for this you have to run the uninstaller with the option ''**/S **''.

アンインストーラの実行ファイルは、インストールしたディレクトリ内にある ''uninstall.exe''  です。コマンドラインで実行することもできます。それには、アンインストーラを ''**/S**''  オプションをつけて実行します。

For example, assuming that Pandora FMS is installed in the default path:

例えば、デフォルトのパスに Pandora FMS エージェントがインストールされていたとします。

<code>
"%ProgramFiles%\pandora_agent\uninst.exe" /S

</code>

{{ :wiki:pfms-run-uninstall-software_agent.png }}

{{ :wiki:pfms-grant-uninstall-software_agent-.png }}

<wrap #ks8_3 />

==== コマンドラインからの PandoraAgent.exe の利用 ====

If you run:

<code bash>
pandoraagent.exe --help


</code>

will display something similar to this:

上記を実行すると、次のような表示がされます。

<code>
C:\Users\Jimmy>"%ProgramFiles%\pandora_agent\pandoraagent.exe" --help
Pandora agent for Windows v7.0NG.761 Build 220427

Usage: C:\Program Files\pandora_agent\pandoraagent.exe [OPTION]

Available options are:
         --install: Install the Pandora Agent service.
         --uninstall: Uninstall the Pandora Agent service.
         --test-ssh: Test the SSH Pandora Agent configuration.
         --test-ftp: Test the FTP Pandora Agent configuration.
         --process: Run the Pandora Agent as a user process instead of a service.

C:\Users\Jimmy>

</code>

To install the service (if it is not installed), just run the following in the directory where the executable is (geusually ''C:\Program Files'' or equivalent).

サービスをインストールする(インストールされていない場合)には、実行ファイルのインストール先ディレクトリ(通常は c:\program files 以下です)で次のようにします。

<code>
pandoraagent.exe --install

</code>

This will install the service on the machine, based on the path where the ''.exe'' is located.

''.exe'' ファイルが置かれている場所をもとに、サービスを有効化します。

To test if it connects via SSH with the Pandora FMS server:

Pandora FMS サーバへの SSH 接続を確認するには次のようにします。

<code>
C:\WINDOWS\system32>cd %PROGRAMFILES%

C:\Program Files>cd pandora_agent

C:\Program Files\pandora_agent>PandoraAgent.exe --test-ssh
Public key file C:\Program Files\pandora_agent\key\id_dsa.pub exists.
Private key file: C:\Program Files\pandora_agent\key\id_dsa exists.
Connecting with munchkin.pandorafms.com.
Authentication successful.
Host fingerprint:
Created a blank XML file in C:\Program Files\pandora_agent\temp\ssh.test
Remote copying C:\Program Files\pandora_agent\temp\ssh.test on server munchkin.pandorafms.com at /var/spool/pandora/data_in/ssh.test
Successfully file copied to remote host
Successfully disconnected from remote host
The SSH test was successful!

C:\Program Files\pandora_agent>

</code>

If you want to uninstall it, it's the same process but with a different option:

サービスのアンインストールには、次のようにします。

<code>
pandoraagent.exe --uninstall

</code>

<wrap #ks8_4 />

==== Pandora FMS Window エージェントをプロセスとして起動する ====

It is possible, for debugging, testing, and other unusual circumstances, to run the agent in "Process" mode. This is done by running it from the command line:

デバッグやテストその他のために、エージェントは "プロセス" として起動することができます。その場合は、コマンドラインから次のように実行します。

<code bash>
pandoraagent.exe --process

</code>

There are some limitations in running in process mode, since Pandora FMS is designed to run as a service and under the ''SYSTEM'' user. If you run it with another user without privileges, there will be functionalities that do not work correctly.

プロセスとして起動する場合は若干制約があります。Pandora FMS は、エージェントをサービスとして ''SYSTEM'' ユーザで実行する前提となっているため、権限が無い他のユーザで実行した場合は正しく動作しません。

<wrap #ks9 />

===== tar.gz 形式の Pandora FMS エージェントアンインストール =====

<WRAP center round info 90%>

It must be taken into account that in order to uninstall the Software Agent you must have the corresponding installation package. It is recommended to use the same package used for the initial installation.

</WRAP>

<WRAP center round info 90%>

ソフトウェア エージェントをアンインストールするには、対応するインストールパッケージが必要であることに注意してください。最初のインストールに使用したのと同じパッケージを使用することをお勧めします。

</WRAP>

If you do not have the installer initially used, you must download the corresponding version from:

最初に使用したインストーラーがない場合は、次の場所から対応するバージョンをダウンロードする必要があります。

<WRAP center round download 90%>

https://pandorafms.com/en/downloads/

</WRAP>

Once the ''.tar.gz'' package is downloaded and on the target system, it must be unzipped.

''.tar.gz'' パッケージをダウンロードして対象システムに配置したら、解凍する必要があります。

Elevating privileges to //root// or using a user with the highest privileges.

//root// 権限に昇格するか、同等の権限を持つユーザを使用します。

<code bash>
sudo su

</code>

Unzipping the installer:

インストーラーを展開します:

<code bash>
tar xvzf < pandora_agente_installer >.tar.gz

</code>

You must enter the ''unix'' directory that was generated after unzipping the installer:

インストーラーを展開した後に生成された ''unix'' ディレクトリに入ります。

<code bash>
cd unix

</code>

Once in this directory you will have access to the installer executable ''pandora_agent_installer'', if you execute it with the ''<nowiki>--help</nowiki>'' parameter, the available options will be shown. Among them there is an example of how to uninstall the agent when a custom location was used.

このディレクトリに移動すると、インストーラ実行ファイル ''pandora_agent_installer'' にアクセスできるようになります。''<nowiki>--help</nowiki>'' パラメータを付けて実行すると、使用可能なオプションが表示されます。その中に、カスタムの場所が指定された場合のエージェントをアンインストールする方法の例があります。

{{  :wiki:pfms_uninstall_software_agent_targz.png  }}

<WRAP center round info 90%>

If the installation was performed in a custom location, the corresponding option must be used for uninstallation. For this case it will be assumed that you have a standard installation in the default location.

</WRAP>

<WRAP center round info 90%>

インストールがカスタムの場所で実行された場合、アンインストールには対応するオプションを使用する必要があります。ここではデフォルトの場所に標準インストールが行われているものと想定します。

</WRAP>

Before starting the uninstallation process it is recommended to stop the Software Agent service:

アンインストール処理を開始する前に、ソフトウェアエージェントサービスを停止することをお勧めします。

<code bash>
systemctl stop pandora_agent_daemon

</code>

Subsequently, the uninstallation process can be started:

その後、アンインストール処理を開始できます。

<code>
./pandora_agent_installer --uninstall

</code>

Once this process is finished, you must reload ''systemctl'':

この処理が完了したら、''systemctl'' をリロードする必要があります。

<code bash>
systemctl daemon-reload

</code>

Finally, the following directories must be deleted:

最後に、次のディレクトリを削除する必要があります。

<file>
/etc/pandora
/var/log/pandora
/var/spool/mail/pandora
/var/spool/pandora
/usr/share/pandora_agent

</file>

This will complete the uninstall process of the PFMS Software Agent.

これにより、PFMS ソフトウェアエージェントのアンインストール処理が完了します。

<wrap #ks10 />

===== RPM 形式の Pandora エージェントアンインストール =====

The Pandora FMS Software Agent service should be stopped:

Pandora FMS ソフトウェアエージェントサービスを停止する必要があります。

<code bash>
systemctl stop pandora_agent_daemon.service

</code>

To start the uninstallation process, run:

アンインストール処理を開始するには、次のコマンドを実行します。

<code bash>
dnf remove pandorafms_agent_linux.noarch

</code>

If necessary, ''yum'' or ''rpm -e'' is used instead of ''dnf''.

必要に応じて、''dnf'' の代わりに ''yum'' または ''rpm -e'' を使用します。

Once this process is finished, you must reload ''systemctl'':

この処理が完了したら、''systemctl'' をリロードする必要があります。

<code bash>
systemctl daemon-reload

</code>

Finally, delete the following directories:

最後に、次のディレクトリを削除します。

<file>
/etc/pandora
/var/log/pandora
/var/spool/mail/pandora
/var/spool/pandora
/usr/share/pandora_agent

</file>

This completes the uninstall process of the Software Agent.

これで、ソフトウェアエージェントのアンインストール処理が完了します。

[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]