Pandora RC のインストール

Pandora FMS ドキュメント一覧に戻る

To install Pandora RC (formerly called eHorus), the installers must be downloaded according to the operating system used as a client.

Pandora RC (以前は eHorus と呼んでいました) をインストールするにあたって、クライアントとして利用するオペレーティングシステムに対応したインストーラをダウンロードする必要があります。

Download the agent for MS Windows® (32 or 64 bit CPU):

MS Windows® (32 または 64 bit CPU) 用のエージェントをダウンロードします。

You need administrator permissions to install the Pandora RC agent. Once downloaded, decompress and run the installer. This agent has been tested on the available versions of MS Windows®, from Windows XP® to Windows 10®. Since the installer is not signed, it may show a warning on installation and then proceed with the installation.

Pandora RC エージェントをインストールするには管理者権限が必要です。ダウンロードした後インストーラを展開して実行します。このエージェントは Windows XP® から Windows 10® までの利用可能なバージョンの MS Windows® でテストされています。インストーラは署名されていないためインストール時に警告が表示されるかもしれませんが、インストールを続行してください。

The license terms must be accepted:

ライセンス条件を承認してください。

For normal installations click Typical. To change the installation directory, click Custom.

通常インストールには 通常(Typical) をクリックしてください。インストールディレクトリを変更する場合は カスタム(Custom) をクリックしてください。

In this screen you will need to enter the user name that you have in the Pandora RC platform so that the agent can provision and work correctly.

エージェントがプロビジョニングされ正しく動作できるように、この画面で Pandora RC プラットフォームで使用するユーザー名を入力する必要があります。

In addition, and very important, an agent password can be set for this installation. This password can be added or modified later. To set a password at this point, enter it in the Password to protect access to this computer text box (image above).

加えて、とても重要ですが、本インストール時にエージェントパスワードを設定できます。このパスワードは後ほど追加や変更ができます。ここでパスワードを設定するには、このコンピュータへのアクセスを保護するパスワード(Password to protect access to this computer) 欄に入力します。(上図)

You will be asked if you want to start the Pandora RC agent on that machine and add a shortcut icon on the desktop:

Pandora RC エージェントを起動するか、デスクトップにショートカットアイコンを追加するかどうかを訊かれます。

If you have correctly configured the agent (setting the provision user) and the agent has internet connection, you can start using Pandora RC. The installation will be finished successfully.

エージェントを正常に設定(プロビジョニングユーザを設定)できインターネット接続がある場合、Pandora RC を起動できます。インストールが正常に完了します。

You should see the Pandora RC status icon in the MS Windows® notification area:

Pandora RC ステータスアイコンが MS Windows® の通知エリアに見えるはずです。

The green icon means that the agent is running and provisioned. Red means that it could not be provisioned.

緑のアイコンはエージェントが起動しプロビジョニング済みであることを意味します。赤いアイコンはプロビジョニングできなかったことを意味します。

Right-clicking on the icon displays the following options:

アイコンを右クリックすると以下オプションが表示されます。

You will only be able to stop/restart Pandora RC subcomponents if the manager (Pandora RC Agent Menu) has been started with Administrator privileges. A user without privileges cannot stop Pandora RC nor change its configuration. If you press Configuration you will be able to see the identifier of that machine. The EKID is a unique number for each host managed by Pandora RC.

マネージャー(Pandora RC エージェントメニュー(Pandora RC Agent Menu)) が管理者権限で開始している場合のみ Pandora RC サブコンポーネントを停止/起動できます。権限のないユーザーは Pandora RC の停止や設定変更ができません 。設定(Configuration) を押すとマシンの識別子が確認できます。EKID は Pandora RC が管理する各ホストのユニークな番号です。

This machine, already provisioned and connected, should be visible in the Pandora RC portal.

このマシンは既にプロビジョニング済みで接続されているので、Pandora RC ポータルで見えるはずです。

The Pandora RC agent has been installed as a service. This means that the machine, even if it is restarted, will start again the Pandora RC services and it will still be available.

Pandora RC エージェントはサービスとしてインストールされます。これはマシンを再起動しても Pandora RC サービスが再度起動し、引き続き利用可能となることを意味します。

It runs with a privileged user, usually the “Administrator” user, with several parameters (all optional):

特権ユーザー(通常は “Administrator” ユーザ)で、いくつかのパラメーター(全てオプション)とともに実行します。

msiexec /i pandorarc_installer_windows-XX.msi /q PARAM1="value2" PARAM2="value2" ...

Example:

例:

msiexec /i pandorarc_installer_windows-XX.msi /q EHUSER="userXXX"
EHKEY="`d877cb3c-82de-4b27-8dbf-1761f3345e7c`"
EHPASS="5555" EHORUSINSTALLFOLDER="C:\path\to\install"
STARTEHORUSSERVICE="1" DESKTOPSHORTCUT="0"

Where:

パラメーターの説明:

• EHUSER: Pandora RC user.
• EHKEY: Unique key.
• EHPASS: Agent password.
• STARTEHORUSSERVICE: Start the agent at the end of the installation (default 1).
• DESKTOPSHORTCUT: Create a shortcut on the desktop (default 1).
• EHORUSINSTALLFOLDER: Folder where you want to install the agent (default %ProgramFiles%\ehorus_agent)
• EHUSER: Pandora RC ユーザー
• EHKEY: ユニークなキー
• EHPASS: エージェントのパスワード
• STARTEHORUSSERVICE: インストール後にエージェントを開始する(デフォルトは1)
• DESKTOPSHORTCUT: デスクトップにショートカットを作成する(デフォルトは1)
• EHORUSINSTALLFOLDER: エージェントをインストールするフォルダ(デフォルトは %ProgramFiles%\ehorus_agent)

Important notice:

重要なお知らせ:

• The quiet installation of Pandora RC agent must always be executed from a terminal with administrator permissions.
• Hyphens are reserved character words in MSI installers, so you have to escape them. In the example given, EHKEY is escaped since in order for it to take the entire chain as a literal, you have to enter double quotation marks.
• EHORUSINSTALLFOLDER should not have single quotation marks inside the existing ones. Respect spaces only with double quotation marks, which are always necessary for this purpose.
• Microsoft Framework .NET 4.0® must be installed to run on Windows XP® and Windows Server 2003®:
• Pandora RC の無人インストールは常に管理者権限をもつターミナルで実行されなければいけません。
• ハイフンは MSI インストーラでの予約語のため、エスケープする必要があります。チェーン全体をリテラルとして扱うためにはダブルクォーテーションを入力する必要があるため、上記例では EHKEY がエスケープされています。
• EHORUSINSTALLFOLDER では既存のシングルクォーテーションの中にシングルクォーテーションを含めるべきでありません。ダブルクォーテーションの使用時はスペースに気をつけてください。ダブルクォーテーションはこの変数に常に必要です。

Like the other platforms (GNU/Linux®, macOS®) the MS Windows® agent can be updated centrally from the Web Console, but if it is required to be updated manually, it can be done with the same installation package. The system will detect that it is updating the software and will not overwrite the configuration files, updating only the code automatically.

他のプラットホーム (GNU/Linux®, macOS®) と同様 MS Windows® エージェントは Web コンソールから集中管理的にアップデートできますが、手動でアップデートする必要がある時は、同じインストールパッケージから行えます。システムはソフトウェアのアップデートを検知し、設定ファイルを上書きせず、コードだけを自動でアップデートします。

Several RPM files are available depending on the RHEL version and processor architecture (32-bit or 64-bit). Installation on any version and architecture is similar.

RHEL のバージョンやプロセッサーアーキテクチャ (32-bit か 64-bit か) に応じたいくつかの RPM ファイルが利用可能です。どのバージョンやアーキテクチャでもインストールは同様です。

Because the remote desktop is optional you will have to manually install some dependencies. It is possible that if you already have a desktop environment these dependencies are already installed. If it does not work, you should try to reinstall them, restart the Pandora RC agent and verify if it works.

リモートデスクトップはオプションであるため、いくつかの依存を手動でインストールする必要があります。デスクトップ環境が既にあれば依存が既にインストールされている可能性があります。もし動作しない場合は再インストールを試みて、Pandora RC エージェントを再起動して動作することを確認してください。

Install the following dependencies:

以下の依存をインストールします。

dnf install tigervnc-server gdm gnome-classic-session \
 gnome-terminal nautilus-open-terminal control-center \
 liberation-mono-fonts metacity libnsl

Install the RPM file (recommended):

RPM ファイルからインストールします。(推奨)

yum install pandorarc_agent-el8-x64-XX.rpm

Or by tarball:

または tarball からインストールします。

tar xvzf pandorarc_agent_linux-XX.tar.gz
cd ehorus_agent/
./ehorus_agent_installer --install

You must manually configure the provisioning user in the file /etc/ehorus/ehorus_agent.conf and start the service:

/etc/ehorus/ehorus_agent.conf を編集してプロビジョニングユーザーを手動で設定した後サービスを開始します。

systemctl start pandorarc_agent_daemon

Install the following dependencies:

下記の依存をインストールします。

dnf install \
  tigervnc-server gdm \
  gnome-classic-session \
  gnome-terminal nautilus-open-terminal \
  control-center liberation-mono-fonts gnome-kiosk libnsl

The RPM file is installed:

RPM ファイルをインストールします。

dnf install pandorarc_agent-el9-x64-XX.rpm

Or by tarball:

もしくは tarball からインストールします。

tar xvzf pandorarc_agent_linux-XX.tar.gz
cd ehorus_agent/
./ehorus_agent_installer --install

Manually configure the provisioning user in the file:

プロビジョニングユーザを手動で設定します。

/etc/ehorus/ehorus_agent.conf

And start the service:

その後サービスを開始します。

systemctl start pandorarc_agent_daemon

Because the remote desktop is optional, a number of dependencies will have to be installed manually. To do this, run the following command:

リモートデスクトップはオプションであるため、いくつかの依存を手動でインストールする必要があります。そのために、下記コマンドを実行します。

apt install tigervnc-standalone-server gnome-core gnome-panel \
 gnome-settings-daemon metacity nautilus gnome-terminal

Run the following command with administrative permissions:

下記コマンドを管理者権限で実行します。

dpkg -i pandorarc_agent_installer-x64-1.X.X.deb

Or install the tarball if you prefer:

もしくはお好みで tarball からインストールします。

tar xvzf pandorarc_agent_linux-XX.tar.gz
cd ehorus_agent/
./ehorus_agent_installer --install

Manually configure the provisioning user in the file /etc/ehorus/ehorus_agent.conf and restart the service:

/etc/ehorus/ehorus_agent.conf ファイルでプロビジョニングユーザーを手動で設定しサービスを再起動します。

/etc/init.d/pandorarc_agent_daemon start

It is possible that, if you already have a desktop environment, these dependencies are already installed. If you cannot connect to the desktop with Pandora RC the first time, try to reinstall them, restart the Pandora RC agent and check again.

既にデスクトップ環境があれば、依存がインストールされている可能性があります。初回に Pandora RC でデスクトップに接続できなかった場合は、再インストールして Pandora RC を再起動し再確認してください。

/etc/gdm3/custom.conf

/etc/gdm3/custom.conf

Depending on the distro (Rocky Linux / RHEL 8, RHEL 9 or Ubuntu 22.04) the dependencies must be installed manually.

各ディストリビューション(Rocky Linux / RHEL 8, RHEL 9 or Ubuntu 22.04)に合わせた依存を手動でインストールする必要があります。

To know the processor architecture:

プロセッサーアーキテクチャを調べるには以下を実行します。

uname -p

If it shows x86_64 it is 64-bit, otherwise 32-bit.

x86_64 と表示される場合は 64-bit、そうでない場合は 32-bit です。

After downloading, copy the tarball file (*.tgz) to a temporary directory, open a terminal window with root rights (via su or sudo):

ダウンロード後、tarball ファイル (*.tgz) を一時ディレクトリにコピーし、(su または sudo で) root 権限のターミナルウィンドウで開きます。

sudo -s

または

su -

Execute where the tarball file was copied:

tarball をコピーした場所で実行します。

tar xvzf pandorarc_agent_linux-XX.tar.gz
cd ehorus_agent/
./ehorus_agent_installer --install

Syntax:

文法:

./ehorus_agent_installer --install <option>

Options:

オプション:

• To specify the user to which the agent will connect:
• エージェントが接続するユーザを指定

--eh_user <user>

• To specify the identification key to be used by the agent (only for advanced users):
• エージェントが使用する識別キーを指定(上級者向け)

--eh_key <key>

• So that the installer does not create the ehorus user (only recommended if you are not going to use the Display function):
• インストーラが ehorus ユーザを作成しない (ディスプレイ(Display) 機能を使用しない場合のみ推奨)

--no_user

• Configure the custom temporary directory for the agent:
• エージェントの一時ディレクトリを変更

Useful in case you have the /tmp directory (default) and it is mounted with the noexec parameter:

/tmp ディレクトリ(デフォルト)を noexec パラメータ付きでマウントしている場合に有用です。

--tmp_dir <custom_folder>

• Perform the entire installation without configuring the service and without starting it automatically when the computer starts:
• インストール中にサービス設定を行わず、コンピュータ起動時に自動で開始しないようにする

--disabled

The file /etc/ehorus/ehorus_agent.conf is edited and the token eh_user is replaced by its user in Pandora RC.

/etc/ehorus/ehorus_agent.conf を編集し eh_user トークンを Pandora RC のユーザに置き換えます。

To start the service:

以下でサービスを起動します。

systemctl start pandorarc_agent_daemon

To stop the service:

以下でサービスを停止します。

systemctl stop pandorarc_agent_daemon

To uninstall a Pandora RC agent installed by tarball, it has to be executed:

tarball でインストールした Pandora RC をアンインストールするには、以下を実行します。

./ehorus_agent_installer --uninstall

macOS 11 or later is supported.

macOS 11 以降をサポートしています。

This installer is fully graphical, and once the process is finished, it will register and stay running on the machine.

このインストーラはフルグラフィックで、プロセスが完了するとマシンに登録され起動し続けます。

1. The installer for MacOS in .DMG format can be downloaded from the Pandora FMS website.

1. .DMG フォーマットの MacOS インストーラは Pandora FMS ウェブサイトからダウンロードできます。

When opening this file you will find the Pandora RC installer named pandorarc_agent.pkg which should also be opened.

ファイルを開くと pandorarc_agent.pkg という名前の Pandora RC インストーラがあります。

2. You must accept the license terms and choose the installation folder, by default /usr/local/ehorus_agent/ (important).

2. ライセンス条件を承認してインストールフォルダを選択します。デフォルトでは /usr/local/ehorus_agent/ です。(重要です)

3. Enter the user name previously created on the Pandora RC website.

3. Pandora RC ウェブサイトで作成したユーザー名を入力します。

4. It is recommended to provide a password to access the agent. This password is only used for your private use and is not stored in the Pandora RC website.

4. エージェントへのアクセスにはパスワードを渡すのが推奨されます。このパスワードはプライベートな使用に限られ Pandora RC ウェブサイトには保存されません。

5. Access the Privacy & Security menu in Settings. The Accessibility, Screen Recording and Full Disk Access permissions should be assigned to the Pandora RC agent executable, located in the default directory /usr/local/ehorus_agent/ (or the different directory chosen in step number one, take into account for the following steps).

5. 設定の プライバシー&セキュリティ(Privacy & Security) メニューにアクセスします。アクセシビリティ(Accessibility) 、画面録画(Screen Recording) 、フルディスクアクセス(Full Disk Access) 権限が Pandora RC エージェント実行ファイルに割り当てられている必要があります。デフォルトでは /usr/local/ehorus_agent/ にあります。(あるいはステップ1で選択した別のディレクトリにありますので、以降のステップではそれを考慮してください)

These permissions can be assigned in two ways:

3つの権限は2通りの方法で割り当てできます。

• Manually find the directory from the + button of the accessibility menu (the folder /usr/local/ is a system folder, so to access it you must press the key combination CMD + Shift + .) and choose the file ehorus_agent.
• You can open the folder /usr/local/ehorus_agent (or the different directory chosen in step number one) in another window with the utility Finder (the key combination CMD + Shift + G) and drag and drop the executable ehorus_agent onto the corresponding permission in Settings.
• アクセシビリティメニューの + ボタンから手動でディレクトリを探し(/usr/local/ フォルダはシステムフォルダなので、CMD + Shift + . の組み合わせを押さなければいけません)、ehorus_agent ファイルを選択します。
• /usr/local/ehorus_agent フォルダ(またはステップ1で選択した別のフォルダ)を別途 ファインダー(Finder) ウィンドウ(CMD + Shift + G)で開き、ehorus_agent 実行ファイルを設定の対応する権限にドラッグ・ドロップすることもできます。

Accessibility permits:

アクセシビリティ権限:

Screen recording permissions:

画面録画権限:

Data storage access permissions:

データストレージアクセス権限:

6. Once the three permissions have been added, the only thing left to do is to restart the Pandora RC agent. To do this, start Pandora RC Menu from the Applications menu, access the tray icon and activate the administrator actions by entering the respective password:

6. 3つの権限を追加すれば、後は Pandora RC エージェントを再起動するだけです。アプリケーションメニューの Pandora RC メニュー(Pandora RC Menu) を開始し、トレイアイコンにアクセスし管理者アクションをそれぞれのパスワードを入力して有効化します。

7. The menu is accessed again, the agent is stopped and restarted:

メニューに再度アクセスすると、エージェントが停止して再起動します。

The installer for macOS in tarball format can be downloaded from the Pandora FMS website.

macOS 向けの tarball フォーマットインストーラは Pandora FMS ウェブサイトからダウンロードできます。

The file must be unzipped with:

ファイルを以下のように展開します。

tar -xvzf pandorarc_agent_installer-darwin-XXX.tgz

Enter the unzipped folder with:

以下のように展開したフォルダに移動します。

cd ehorus_agent

Install with:

以下でインストールします。

./ehorus_agent_installer --install

macOS has two custom options, one to specify the user to which the agent will connect:

macOS では2つのカスタムオプションがあります。1つはエージェントが接続するユーザを指定するものです。

--eh_user <user>

And another advanced option to specify the identification key to be used by the agent:

もう1つの高度なオプションはエージェントが使用する識別キーを指定するものです。

--eh_key <key>

Start the service:

サービスを開始します。

launchctl bootstrap system /Library/LaunchDaemons/com.pandorafms.pandorarc_agent.plist

Stop the service:

サービスを停止します。

launchctl bootout system /Library/LaunchDaemons/com.pandorafms.pandorarc_agent.plist

Access Programs and run the uninstaller named Pandora RC uninstaller.

Pandora FMS ドキュメント一覧に戻る