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
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 

 
 SIGUIENTE > 

  

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 

 < ANTERIOR SIGUIENTE >

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 

 < ANTERIOR SIGUIENTE>

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  

 < ANTERIOR SIGUIENTE >

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 

 

 < ANTERIOR SIGUIENTE >

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 

 < ANTERIOR SIGUIENTE> 

  

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 

 < ANTERIOR SIGUIENTE >

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 

 < ANTERIOR