Pandora RC Installation

Go back to Pandora FMS documentation

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

We are working on the translation of the Pandora FMS documentation. Sorry for any inconvenience.

Pandora RC installation in MS Windows

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


Administrator permissions are required to install Pandora RC agent. Once downloaded it, run the installer. This agent has been tested on available Windows versions, from Windows XP to Windows 10. Since the installer is not signed, it may show you a warning on the installation, please proceed with the installation.

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

The next screen will only be displayed in this second case.


On this screen you will need to enter the username you have on Pandora RC platform so that the agent can provision and work correctly.

Also, and very importantly, an agent password can be set for this installation. This password may be added or changed at a later date. To set a password at this point, enter it in the text box at the end.

You will be asked if you want to start Pandora RC agent on that machine and add an icon to the desktop. If you correctly configured the agent (entering the provisioning user) and the agent has an internet connection, you may start using Pandora RC.

Installation will have been completed successfully


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

The green icon means that the agent is running and provisioned. Red means that it could not be provisioned. Right-click the icon to see some options:

You can only stop/restart subcomponents of Pandora RC if you started the manager (Pandora RC Agent Menu) with Administrator privileges. A user with no permissions will not be able to stop Pandora RC or change its settings. If you click “Show EKID” you will be able to see the EKID of that machine. The EKID is a unique number for each host managed by Pandora RC.

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

The Pandora RC agent has been installed as a service. This means that the machine, even if restarted, will restart Pandora RC services and will remain available.

Optional: Installing Mirror Driver

Mirror Driver is a free and open source third-party software that can be installed on the host to speed up data display, improving performance by approximately 25%.

To use it, the machine is installed and restarted.

http://www.demoforge.com/dfmirage.htm

This driver is compatible with the following versions of MS Windows®:

  • Windows 2008 R2®
  • Windows 7®
  • Windows 2008®
  • Windows Vista®
  • Windows 2003®
  • Windows XP®
  • Windows 2000®

Other untested versions: Windows 10® and Windows 11®.

http://www.driverscape.com/download/vnc-mirror-driver

Unattended installation on MS Windows

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

msiexec /i ehorus_agent_installer.msi /q PARAM1="value2" PARAM2="value2" ...

Example:

msiexec /i ehorus_agent_installer.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)


Important notice:

  • The mute 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 within those that already exist. Respect spaces only with double quotes that are always necessary.
  • The .NET 4.0 Framework must be installed for it to work on Windows XP and Windows Server 2003.

MS Windows agent update

Like the other platforms (GNU/Linux, Mac OS) 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.

Using the agent in stand-alone mode in MS Windows

MS Windows supports a use mode that does not require installation. This mode allows no software to be installed on the Windows system to be controlled.

1. Download the stand-alone agent for MS Windows (32 or 64 bits) from ehorus.com. It is a .ZIP file that contains an executable and a directory.

2. Run the “Pandora RC Standalone” file.

3. Enter the “user” of the person who has access to Pandora RC and it will connect to your computer (you).

The program does not stay installed, just running. It generates a unique EKID (identifier) for each run and a randomly generated password. If you provide those details (ID and password) you may connect to your computer:

When you are finished, when you click the “Disconnect” button, the agent will stop and no one else will be able to connect. The agent is not installed on the system, and the folder can be deleted. For all intents and purposes, no data is stored.

Pandora RC installation on Mac

OS X 10.8 or later is supported, it should work on 10.7. This installer is fully graphical, and once the process is finished, it will be registered and will remain running on the machine.

Download the installer for Mac OS in .DMG format and follow the steps in the screenshots below:


Double-click the “ehorus_agent.pkg” icon


Figure 1. Enter provision user


Figure 2. Enter the password to protect access to this system

The agent is already installed (and presumably running) on your Mac OS system.

Mojave, Catalina and higher versions (10.14.x)

For macOS 10.14 and higher versions (Mojave and Catalina) it is necessary to give the system permissions to allow remote desktop control. These actions must be done manually by the administrator and then restart the Pandora RC service on the computer.

Step 1. Go to Dashboard / Security

Step 2. Go to the privacy tab

Step 3. Accessibility

In the Catalina version, the section is called Screen recording.

Step 4. Unlock

Step 5. A new path is added A path is manually entered in the selector dialog by clicking COMAND-CAPS LOCK-G and the path /usr/local/ehorus_agent is placed:

Step 6. Verify that it is activated

Optional: You may perform steps 7, 8 and 9 or simply restart the computer.

Step 7 On the top right icon of Pandora RC, right-click and select “Enable admin actions”. Enter the password of the user with priviledges (root).


Step 8 Stop the Pandora RC service and restart it again.

Pandora RC deinstallation on Mac OS

Go to “Programs” and run the uninstaller called “eHorus uninstaller” which has the following icon:

Installing Pandora RC on GNU/Linux (Cent OS/RHEL)

You will have several RPM files depending on the RHEL/Cent OS version and its processor architecture (32 or 64 bits). Installation in any version and architecture is similar. Run the following command with administration permissions:

yum install ehorus_agent_redhat-centosX-xXXX.rpm

Since Remote Desktop is optional some dependencies will have to be manually installed. If you already have a desktop environment, these dependencies may already be installed. If it does not work, try reinstalling them, restart the Pandora RC agent and check if it works.

Run the following commands to install the necessary dependencies:

Centos 6.x

yum install tigervnc-server gnome-core
yum groupinstall Desktop

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

/etc/init.d/ehorus_agent_daemon start

Centos 7.x

yum install tigervnc-server gnome-core gnome-classic-session gnome-terminal \
nautilus-open-terminal control-center liberation-mono-fonts metacity

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

systemctl start ehorus_agent_daemon

Rocky Linux 8 and AlmaLinux 8

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

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

systemctl start ehorus_agent_daemon

Installing Pandora RC on GNU/Linux (Ubuntu)

You will have several DEB packages depending on your architecture (32 or 64 bits) for Ubuntu version 116.x . Installation in any later version and architecture is similar.

Run the following command with administration permissions:

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

Since remote desktop is optional some dependencies will have to be manually installed. If you already have a desktop environment, these dependencies may already be installed. If it doesn't work the first time, try reinstalling them, restart the Pandora RC agent, and check again.

Run the following command to install the necessary dependencies:

apt-get install vnc4server gnome-core gnome-panel gnome-settings-daemon metacity nautilus gnome-terminal

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

/etc/init.d/ehorus_agent_daemon start

Installing Pandora RC on GNU/Linux (Tarball)

To know the processor architecture:

uname -r

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

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

sudo -s

or either

su -

Run in the same directory where the tarball was downloaded:

tar xvzf ehorus_agent_installer-centos7-x64-1.X.X-160311.tgz
cd ehorus_agent
./ehorus_agent_installer --install

Additional installation options

./ehorus_agent_installer --install
  • –disabled: It performs the entire installation but the service is not configured and will not start automatically when the computer is started.

Uninstallation

To uninstall a tarball-installed Pandora RC agent you have to run the same script with the -uninstall option

./ehorus_agent_installer --uninstall

Service execution

Edit the /etc/ehorus/ehorus.conf file and replace the eh_user token with your eHorus user.

To start the service, run:

In CentOS:

service ehorus_agent_daemon start

In another GNU/Linux:

/etc/init.d/ehorus_agent_daemon start

Go back to Pandora FMS documentation index.