Pandora FMS RPI Viewer
Herramienta para poder ver un dashboard o una consola visual utilizando una Raspberry PI conectada a un dispositivo HDMI, Monitor, Television, etc.
- Requerimientos
- Preparacion Tarjeta SD
- Configuración de RED y Acceso SSH
- Booteo Inicial
- Script de Instalación
- Booteo Raspberry PI Viewer
- Cambiar la URL desde el navegador WEB
- Cambiar URL desde SSH
Requerimientos
Para poder utilizar este complemento de la libreria se requieren los siguientes componentes:
- Raspberry PI 3 o superior
- Tarjeta SD de al menos 16 GB
- Monitor HDMI
- Internet
- Dashboard o Consola Visual de PandoraFMS
Preparacion Tarjeta SD
Una vez que tenemos nuestro equipo lo primero que tenemos que hacer es preparar nuestra tarjeta SD, para esto vamos a utilizar la herramienta oficial Raspberry PI Imager que la vamos de descargar desde la pagina oficial
https://www.raspberrypi.org/software/
Descargamos Raspberry PI Imager, para la plataforma en la que estemos trabajando
Lo descargamos y lo instalamos y abrimos la aplicación
Seleccionamos CHOOSE OS y luego Raspberry PI OS (other)
Seleccionamos -> Raspberry PI OS Lite (32-bit)
NOTA: Para que el script funcione se debe utilizar Raspberry Pi OS Lite (32-bit), es un requerimiento fundamental para que todo funcione en forma correcta
Seleccionamos -> CHOOSE SD CARD
Seleccionamos -> Nuestra Tarjeta SD
Seleccionamos -> WRITE
Seleccionamos -> YES
NOTA: como nos informa la herramienta la herramienta formatea la tarjeta SD y borra todo el contendio
Ponemos la contraseña del usuario, en este ejemplo se utiliza la herramienta en MAC
Esperamos que la herramienta finalice (esta operación demora unos minutos)
Al finalizar sacamos la tarjeta SD y la volvemos a conectar para montarla en nuestro equipo y poder continuar con el siguiente paso
Configuración de RED y Acceso SSH
La Raspberry PI tiene conectividad por cable de RED, ese caso solo con enchufar el cable rapidamente el equipo tendra conectividad pero en caso de que quieran utilizar una red WIFI vamos a ver los pasos necesarios para hacerlo
Con la tarjeta SD montada en nuestro equipo si vamos a utilizar WIFI debemos crear un archivo que se llame
wpa_supplicant.conf el archivo tiene que tener el siguiente contenido
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=AR
network={
ssid="MyWIFI"
psk="Passwd"
}
En el caso de usuarios MAC la tarjeta SD esta montada en /Volumes/boot, para usuarios windows se debe crear el archivo en el directorio raiz de la tarjeta SD utilizando cualquier editor de texto
Para habilitar el acceso SSH se debe crear un archivo con nombre ssh
Para usuarios MAC o Linux se puede utilizar el comando en nuestra tarjeta SD
touch ssh
De esta forma quedan los archivos en nuestra tarjeta SD, luego de esto hemos terminado y estamos en condiciones de realizar el booteo inicial de nuestra Raspberry PI
Booteo Inicial
Luego de poner la Tarjeta SD que preparamos en el paso anterior, conectamos nuestra Raspberry PI al monitor HDMI le damos corriente y esperamos que el proceso termine veremos algo como esto
Este proceso demora unos minutos y reinicia nuestra raspberry al menos 2 veces
Al finalizar podremos ver la dirección IP de nuestro equipo en este ejemplo es 192.168.200.224
NOTA: si el equipo no muestra una direccion IP, si se utilizo un cable de red validar que este correctamente conectado y si es por wifi validar que los parametros en el archivo wpa_supplicant.conf sean los correctos
Script de Instalación
Para realizar la instalación vamos a conectarnos a nuestra Raspberry PI por ssh utilizando los siguientes datos
Usuario: pi
Password: raspberry
USUARIO: pi
PASSWORD: raspberry
Para Windows se puede utilizar putty o cualquier otro cliente ssh
Una vez que entramos por una seguridad es importante cambiar la contraseña del usuario pi para esto utilizamos el comando
passwd
Para tener acceso de root ejecutamos el comando
sudo -s
Descagamos el script desde la libreria de PandoraFMS con el comando
wget https://pandorafms.com/library/wp-content/uploads/2021/04/pandorafms-rpi-viewer.tgz
Ejecutamos los siguientes comandos para descomprimir el archivo y entrar en la carpeta
tar xvzf pandorafms-rpi-viewer.tgz
cd pandorafms-rpi-viewer
Para poder continuar es necesario tener copiada la url que queremos utilizar para que se visualice en Pandora FMS PI Viewer
Para esto en cualquier dashboard o consola visual buscamos el icono Mostrar el enlace al dashboard publico
NOTA: es importante utilizar el enlace publico ya que el mismo no pide usuario y contraseña
Copiamos la URL desde la barra del navegador
Para utilizarla con el instalador, para finalizar con la instalación simplemente se debe ejecutar el comando install.sh con el parámetro de la url que vamos a utilizar para nuestro ejemplo utilizaremos la pagina de PandoraFMS
./install.sh "https://pandorafms.sitssoluciones.com/pandora_console/index.php?sec=operation/dashboard/dashboard&sec2=operation/dashboard/dashboard&dashboardId=7"
Luego de ejecutar el comando comenzara el proceso de instalación
El proceso demora varios minutos dependiendo de su conexión de internet y es indispensable tener internet para que el script pueda descargar los paquetes
Finalizado el proceso se reinicia nuestra Raspberry PI
Booteo Raspberry PI Viewer
Al finalizar la instalación veremos una nueva secuencia de booteo
Para el ejemplo se utilizo una televisor de 32 Pulgadas
Ya tenemos configurada nuestra Raspberry PI para ver nuestro dashboard o consola visual de PandoraFMS
Cambiar la URL desde el navegador WEB
Luego de que pasa el tiempo es posible realizar nuevos dashboard o consolas visuales en PandoraFMS y necesitar cambiar la url de visualización para esto la herramienta cuenta con una herramienta WEB que nos permite realizar el cambio para esto solo abrimos el navegador y ponemos la IP de nuestra Raspberry PI en este ejemplo la IP es 192.168.200.220
En nuestra consola de PandoraFMS buscamos el dashboard o la consola visual que queremos utilizar buscamos el icono Mostrar el enlace al dashboard publico
NOTA: es importante utilizar el enlace publico ya que el mismo no pide usuario y contraseña
Copiamos la URL desde la barra del navegador
Pegamos la URL y presionamos el boton Cambiar
Se reinicia nuestra Raspberry PI y podremos ver la nueva URL
Cambiar URL desde SSH
Luego de que pasa el tiempo es posible realizar nuevos dashboard o consolas visuales en PandoraFMS y necesitar cambiar la url de visualización para esto la herramienta cuenta con un script que nos permite realizar el cambio para esto nos conectamos por ssh a la IP de nuestra Raspberry PI en este ejemplo la IP es 192.168.200.220
En nuestra consola de PandoraFMS buscamos el dashboard o la consola visual que queremos utilizar buscamos el icono Mostrar el enlace al dashboard publico
NOTA: es importante utilizar el enlace publico ya que el mismo no pide usuario y contraseña
Copiamos la URL desde la barra del navegador
Nos conectamos por SSH a nuestra Raspberry PI
Una vez que entramos por una seguridad es importante cambiar la contraseña del usuario pi para esto utilizamos el comando changeurl poniendo como parametro nuestra nueva URL, antes ejecutamos el comando sudo -s para tener acceso como root
sudo -s
changeurl "https://pandorafms.sitssoluciones.com/pandora_console/operation/dashboard/public_dashboard.php?dashboardId=2&hash=a6dab6878679d68194775f4657d1b4ec8464e91385197e1705ec31048ae5c5dc&id_user=gsanchez&pure=1"
Nuestra Raspberry PI se reinicia y veremos el cambio reflejado en forma correcta