Pandora RC のインストール
To install Pandora RC (formerly called eHorus), the installers must be downloaded according to the operating system used as a client.
Pandora RC (以前は eHorus と呼んでいました) をインストールするにあたって、クライアントとして利用するオペレーティングシステムに対応したインストーラをダウンロードする必要があります。
MS Windows への Pandora RC インストール
MS Windows への通常インストール
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 サービスが再度起動し、引き続き利用可能となることを意味します。
MS Windows での無人インストール
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 では既存のシングルクォーテーションの中にシングルクォーテーションを含めるべきでありません。ダブルクォーテーションの使用時はスペースに気をつけてください。ダブルクォーテーションはこの変数に常に必要です。
MS Windows エージェントのアップデート
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 コンソールから集中管理的にアップデートできますが、手動でアップデートする必要がある時は、同じインストールパッケージから行えます。システムはソフトウェアのアップデートを検知し、設定ファイルを上書きせず、コードだけを自動でアップデートします。
GNU/Linux へのインストール
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 エージェントを再起動して動作することを確認してください。
Rocky Linux / RHEL 8
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
Pandora RC is not currently compatible with Wayland, so it should be disabled by placing the parameter WaylandEnable=False
in the file /etc/gdm/custom.conf
. This change may require a reboot.
Pandora RC は現在のところ Wayland と互換性がないため、 /etc/gdm/custom.conf
に WaylandEnable=False
パラメータを記載して無効化してください。この変更は再起動が必要な可能性があります。
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
Rocky Linux / RHEL 9
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
Pandora RC is not currently compatible with Wayland, so it should be disabled by placing the parameter WaylandEnable=False
in the file /etc/gdm/custom.conf
. This change may require a reboot.
Pandora RC は現在のところ Wayland と互換性がないため、/etc/gdm/custom.conf
に WaylandEnable=False
パラメータを記載して無効化してください。この変更は再起動が必要になる可能性があります。
Manually configure the provisioning user in the file:
プロビジョニングユーザを手動で設定します。
/etc/ehorus/ehorus_agent.conf
And start the service:
その後サービスを開始します。
systemctl start pandorarc_agent_daemon
Ubuntu 22.04 へのインストール
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 を再起動し再確認してください。
Pandora RC is not currently compatible with Wayland, so you should disable it by setting the WaylandEnable=False
parameter in the file:
/etc/gdm3/custom.conf
This change may require a reboot.
Pandora RC は現在のところ Wayland と互換性がないため、下記ファイルで WaylandEnable=False
パラメータを設定して無効化してください。
/etc/gdm3/custom.conf
この変更は再起動が必要になる可能性があります。
GNU/Linux へのインストール (Tarball)
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
Tarball でのアンインストール
To uninstall a Pandora RC agent installed by tarball, it has to be executed:
tarball でインストールした Pandora RC をアンインストールするには、以下を実行します。
./ehorus_agent_installer --uninstall
macOS へのインストール
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で選択した別のディレクトリにありますので、以降のステップではそれを考慮してください)
The Full Disk Access permission is optional, and is only required for file transfers.
フルディスクアクセス(Full Disk Access) 権限はオプションで、ファイル転送でのみ必要になります。
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 combinationCMD + Shift + .
) and choose the fileehorus_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 combinationCMD + Shift + G
) and drag and drop the executableehorus_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:
メニューに再度アクセスすると、エージェントが停止して再起動します。
tarball でのインストール
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
It is recommended to install with a normal user (not root).
一般ユーザ(root 以外) でのインストールが推奨されています。
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
macOS での Pandora RC アンインストール
Access Programs and run the uninstaller named Pandora RC uninstaller.
プログラム(Programs) にアクセスし Pandora RC アンインストーラ(Pandora RC uninstaller) というアンインストーラを実行します。