Instalación de Pandora RC

Para instalar Pandora RC (antes llamado eHorus) se deben descargar los instaladores de acuerdo al sistema operativo utilizado como cliente.

Instalación en MS Windows

Instalación normal para MS Windows

Descargue el agente para MS Windows® (CPU 32 ó 64 bits):

Se necesitan permisos de administrador para instalar el agente de Pandora RC. Una vez descargado, se descomprime y ejecuta el instalador. Este agente ha sido probado en las versiones disponibles de MS Windows®, desde Windows XP® hasta Windows 10®. Dado que el instalador no está firmado, puede que se muestre una advertencia en la instalación y luego se prosigue con la instalación.

Se deben aceptar los términos de la licencia:

Para instalaciones normales haga clic en Tipica (Typical). Para cambiar el directorio de instalación, haga clic en Personalizada (Custom).

En esta pantalla se necesitará introducir el nombre de usuario que tiene en la plataforma Pandora RC para que el agente pueda provisionar y funcionar correctamente.

Además, y muy importante, se puede establecer una contraseña de agente para esta instalación. Esta contraseña podrá ser añadida o modificada posteriormente. Para establecer una contraseña en este punto se introduce en la caja de texto Password to protect access to this computer (imagen anterior).

Se le preguntará si se quiere iniciar el agente de Pandora RC en esa máquina y añadir un icono de acceso directo en el escritorio:

Si ha configurado correctamente el agente (poniendo el usuario de provisión) y el agente tiene conexión a internet, se podrá comenzar a usar Pandora RC. La instalación habrá finalizado con éxito.

Se debería ver el icono de estado de Pandora RC en el área de notificación de MS Windows®:

El icono en verde significa que el agente está corriendo y provisionado. En rojo significa que no ha podido ser provisionado.

Haciendo clic en el icono con el botón secundario muestra las siguientes opciones:

Solamente podrá detener/reiniciar subcomponentes de Pandora RC si se ha iniciado el gestor (Pandora RC Agent Menu) con privilegios de Administrador. Un usuario sin privilegios no podrá detener Pandora RC ni cambiar su configuración. Si pulsa Configuration podrá ver el identificador de esa máquina. El EKID es un número único por cada host gestionado por Pandora RC.

Esta máquina, ya aprovisionada y conectada deberá estar visible en el portal Pandora RC.

El agente de Pandora RC, ha sido instalado como servicio. Esto significa que la máquina, aunque sea reiniciada, iniciará de nuevo los servicios de Pandora RC y seguirá disponible.

Instalación desatendida en MS Windows

Se ejecuta con un usuario con privilegios, generalmente el usuario “Administrador”, con varios parámetros (todos opcionales):

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

Ejemplo:

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"

Donde:

  • EHUSER: Usuario de Pandora RC.
  • EHKEY: Clave única.
  • EHPASS: Contraseña del agente.
  • STARTEHORUSSERVICE: Iniciar el agente al terminar la instalación (por defecto 1).
  • DESKTOPSHORTCUT: Crear un acceso directo en el escritorio (por defecto 1).
  • EHORUSINSTALLFOLDER: Carpeta donde se quiere instalar el agente (por defecto %ProgramFiles%\ehorus_agent).

Importante:

  • La instalación silenciosa del agente de Pandora RC se debe ejecutar siempre desde una terminal con permisos de administrador.
  • Los guiones son palabras caracteres reservados en los instaladores MSI, con lo cual hay que escapar su sintaxis. En el ejemplo dado, EHKEY está escapado ya que para que tome toda la cadena como un literal hay que meter comillas graves.
  • EHORUSINSTALLFOLDER no debe llevar comillas simples dentro de las que ya hay. Respeta los espacios únicamente con las dobles comillas, las cuales siempre son necesarias para ello.
  • Para que funcione en Windows XP® y Windows Server 2003® debe estar instalado el Microsoft Framework .NET 4.0®:

Actualización del agente de MS Windows

Al igual que el resto de plataformas (GNU/Linux®, Mac OS®) el agente de MS Windows® se puede actualizar de forma centralizada desde la Consola web, pero si se requiere actualizarlo manualmente, se puede hacer con el mismo paquete de instalación. El sistema detectará que está actualizando el software y dejará intactos los ficheros de configuración, actualizando únicamente el código de forma automática.

Instalación GNU/Linux

Se disponen de varios ficheros RPM en función de la versión de RHEL y la arquitectura de procesador (32 ó 64 bits). La instalación en cualquier versión y arquitectura es similar.

Debido a que el escritorio remoto es opcional se tendrán que instalar manualmente algunas dependencias. Es posible que si ya se tiene un entorno de escritorio estas dependencias ya estén instaladas. Si no funciona se debe probar a reinstalarlas, reiniciar el agente de Pandora RC y verificar si funciona.

Rocky Linux / RHEL 8

Instale las siguientes dependencias:

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

Instale el archivo RPM (recomendado):

yum install pandorarc_agent-el8-x64-XX.rpm

O el tarball:

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

Pandora RC no es compatible actualmente con Wayland, por lo que se deberá desactivar colocando el parámetro WaylandEnable=False en el archivo /etc/gdm/custom.conf. Este cambio puede requerir reiniciar el equipo.

Se debe configurar manualmente el usuario de provisión en el fichero /etc/ehorus/ehorus_agent.conf e iniciar el servicio:

systemctl start pandorarc_agent_daemon

Rocky Linux / RHEL 9

Instale las siguientes dependencias:

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

Se instala el archivo RPM:

dnf install pandorarc_agent-el9-x64-XX.rpm

O el tarball:

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

Pandora RC no es compatible actualmente con Wayland, por lo que se deberá desactivar colocando el parámetro WaylandEnable=False en el archivo /etc/gdm/custom.conf. Este cambio puede requerir reiniciar el equipo.

Configure manualmente el usuario de provisión en el fichero:

/etc/ehorus/ehorus_agent.conf

E inicie el servicio:

systemctl start pandorarc_agent_daemon

Instalación en Ubuntu 22.04

Debido a que el escritorio remoto es opcional, se tendrá que instalar una serie de dependencias manualmente. Para ello, ejecute el siguiente comando:

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

Ejecute el siguiente comando con permisos de administración:

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

O instale el tarball si lo prefiere:

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

Configure manualmente el usuario de provisión en el fichero /etc/ehorus/ehorus_agent.conf y reinicie el servicio:

systemctl start pandorarc_agent_daemon

Es posible que, si ya tiene un entorno de escritorio, estas dependencias ya estén instaladas. Si no puede conectarse al escritorio con Pandora RC a la primera, pruebe a reinstalarlas, reinicie el agente Pandora RC y compruebe de nuevo.

Pandora RC no es compatible actualmente con Wayland, por lo que deberá desactivarlo colocando el parámetro WaylandEnable=False en el archivo:

/etc/gdm3/custom.conf

Este cambio puede requerir reiniciar el equipo.

Instalación de Pandora RC en GNU/Linux (Tarball)

Dependiendo de la distro (Rocky Linux / RHEL 8, Rocky Linux / RHEL 9 o Ubuntu 22.04) se deben instalar las dependencias de forma manual.

Para saber la arquitectura de procesador:

uname -p

Si muestra x86_64 es de 64 bits, en caso contrario de 32 bits.

Luego de descargar se copia el fichero tarball (*.tgz) en un directorio temporal, abra una ventana terminal con derechos de root (vía su o sudo):

sudo -s

O bien

su -

Ejecute en donde se copió el fichero tipo tarball:

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

Opciones adicionales de instalación

Sintaxis:

./ehorus_agent_installer --install < option >

Opciones:

  • Para especificar el usuario al que conectará el agente:
--eh_user < user >
  • Para especificar la clave de identificación que usará el agente (solamente para usuarios avanzados):
--eh_key < key >
  • Para que el instalador no cree el usuario ehorus (solamente recomendable si no se va a usar la función Display):
--no_user
  • Configurar el directorio temporal personalizado para el agente:

Útil en caso de tener el directorio /tmp (por defecto) y esté montado con el parámetro noexec:

--tmp_dir < custom_folder >
  • Realizar toda la instalación sin configurar el servicio y sin arrancar automáticamente cuando se inicie el equipo:
--disabled

Ejecución del servicio

Se edita el fichero /etc/ehorus/ehorus_agent.conf y se reemplaza el token eh_user por su usuario en Pandora RC.

Para iniciar el servicio:

systemctl start pandorarc_agent_daemon

Para detener el servicio:

systemctl stop pandorarc_agent_daemon

Desinstalación de tarball

Para desinstalar un agente de Pandora RC instalado mediante tarball se tiene que ejecutar:

./ehorus_agent_installer --uninstall

Instalación en Mac OS

Se soporta OS X 11 o posterior.

Instalación normal

Este instalador es totalmente gráfico, y una vez terminado el proceso, se registrará y se quedará ejecutando en la máquina.

1. El instalador para Mac OS en formato .DMG se puede descargar desde el sitio web de Pandora FMS.

Al abrir dicho fichero se encontrará el instalador de Pandora RC denominado pandorarc_agent.pkg el cual se debe abrir también.

2. Se deben aceptar los términos de la licencia y elegir la carpeta de instalación, por defecto /usr/local/ehorus_agent/ (importante).

3. Se introduce el nombre de usuario previamente creado en el sitio web de Pandora RC.

4. Se recomienda indicar una contraseña de acceso al agente. Esta contraseña es únicamente utilizada para su uso privado y no es almacenada en el sitio web Pandora RC.

5. Se debe acceder al menú Privacidad y Seguridad (Privacy & Security) en Ajustes. Se deberán asignarse los permisos Accessibility, Screen Recording y Full Disk Access al ejecutable del agente Pandora RC, localizado en el directorio por defecto /usr/local/ehorus_agent/ (o el directorio distinto elegido en el paso número uno, tómese en cuenta para los siguientes pasos).

El permiso Full Disk Access es opcional, y solamente es necesario para la transferencia de ficheros.

Estos permisos se pueden asignar de dos maneras:

  • Buscar manualmente el directorio desde el botón + del menú de accesibilidad (la carpeta /usr/local/ es de sistema, por lo que para poder acceder se deberá pulsar la combinación de teclas CMD + Shift + .) y escoger el archivo ehorus_agent.
  • Se puede abrir la carpeta /usr/local/ehorus_agent (o el directorio distinto elegido en el paso número uno) en otra ventana con la utilidad Finder (la combinación de teclas CMD + Shift + G) y arrastrar y soltar el ejecutable ehorus_agent sobre el permiso correspondiente en Ajustes.

Permisos de accesibilidad:

Permisos de grabación de pantalla:

Permisos de acceso a almacenamiento de datos:

6. Una vez añadidos los tres permisos, solamente queda por reiniciar el agente Pandora RC. Para ello, se inicia Pandora RC Menu desde el menú de Aplicaciones, se accede al icono de la bandeja y se activan las acciones de administrador introduciendo la contraseña respectiva:

7. Se accede nuevamente al menú, se detiene el agente y se vuelve a iniciar:

Instalación por tarball

El instalador para Mac OS en formato tarball se puede descargar desde el sitio web de Pandora FMS.

Se debe descomprimir el fichero con:

tar -xvzf pandorarc_agent_installer-darwin-XXX.tgz

Entrar a la carpeta descomprimida con

cd ehorus_agent

Se recomienda instalar con un usuario normal (no root).

Instalar con:

./ehorus_agent_installer --install

Opciones de instalación

Mac OS tiene dos opciones personalizadas, una para especificar el usuario al que conectará el agente:

--eh_user < user >

Y otra opción avanzada para especificar la clave de identificación que usará el agente:

--eh_key < key >

Ejecución del servicio

Iniciar el servicio:

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

Detener el servicio:

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

Desinstalación de Pandora RC en Mac OS

Se accede Programas y se ejecuta el desinstalador llamado Pandora RC uninstaller.

Volver al índice de documentación de Pandora FMS