1. Introducción

Este manual está orientado para las pizarras digitales tipo Smart obien Starboard, el software que trata el manual será diferente encada caso, pero el funcionamiento es similar y las diferencias estánespecificadas según el caso.

Para poder utilizar las pizarras digitales sobre Lliurex 19 se han realizado cambios defuncionamiento interno con respecto versiones anteriores dado que el software nativo de las pizarras que proporcionan los fabricantes está altamente des-actualizado con las dependencias necesarias.

Para prestar soporte, a grandes rasgos serán necesarios diversos componentes que serán enumerados y detallados a continuación junto con las peculiaridades que sean necesarias.

Será necesarios los siguientes componentes:

• Un motor de contenedores (Docker) en este caso.
• Una imagen preparada con el software de la pizarra electrónica.
• Un cliente para poder ejecutar las acciones en el software.
• Drivers que sean necesarios para la detección y correctofuncionamiento de la pizarra.
• Opcionalmente y solo para el caso de desear utilizar el software enmodo semi-ligero, serán necesarios unos servicios adicionales.

La mayoría de estos componentes se han preparado para una instalación sencilla que no requiera demasiados conocimientos técnicos y pueda ser realizada por parte de cualquier usuario. Para facilitar la tarea se proveen entradas en Zero-Center que simplifican el proceso. Para el caso un poco mas complejo de desear tener este software en modo semi-ligero, se detallarán las instrucciones en apartados específicos para dicho modo.

Para poder realizar la instalación del software necesario, será indispensable poseer permisos de administración sobre el equipo. Y aunque no es estrictamente necesario, si el servidor como es habitual está configurado por defecto para tener un mirror Lliurex en él, para realizar la instalación de este software puede ser imprescindible tener disponible un mirror en el servidor.

El proceso de instalación esta documentado de forma que se enumeran varias formas de realizar las instalaciones, en modo gráfico o en modo texto, según el usuario puede preferirse utilizar una u otra, en cualquier caso el resultado será el mismo. En caso de un usuario experto o necesidad de depuración el modo texto es el recomendado ya que puede ofrecer pistas o trazas de mal funcionamiento o problemas.

Siempre se recomienda mantener el sistema actualizado para obtener correcciones del software que pueda presentar errores o bugs, en elcaso de esta infraestructura que permite ejecutar el software antiguo de pizarras, se ha de proceder a actualizar la imagen del software de la pizarra de forma independiente a la actualización del sistema, para ello seguir las instrucciones del apartado actualización del software en este manual.

2. Instalación del software necesario

Los siguientes paquetes deben estar instalados en el equipo según el tipo de pizarra que se desee:

• Paras ambos tipos de pizarras:
  • zero-lliurex-docker (instalador docker-ce)
• Pizarras Smart:
  • lliurex-smart (cliente)
  • zero-lliurex-smart (instalador)
  • nwfermi-module (drivers)
  • xf86-input-nextwindow (drivers)
• Pizarras Starboard:
  • lliurex-starboard (cliente)
  • zero-lliurex-starboard (instalador)
  • starboard-modules (drivers)

Solo si se desea ejecutar en semi-ligeros

• En ambos tipos de pizarras:
  • zero-lliurex-docker (instalador docker-ce)
• Pizarras Smart:
  • lliurex-smart (cliente) (dentro de la imagen)
  • zero-lliurex-smart (instalador) (dentro de la imagen)
  • lliurex-smart-ltsp-client (servicio) (dentroa imagen)
  • nwfermi-module (drivers) (dentro de la imagen)
  • xf86-input-nextwindow (drivers)
  • lliurex-smart-ltsp-server (servicio) (en el servidor de aula)
• Pizarras Starboard:
  • lliurex-starboard (cliente) (dentro de la imagen)
  • zero-lliurex-starboard (instalador) (dentro de la imagen)
  • lliurex-starboard-ltsp-client (servicio) (dentro de la imagen)
  • starboard-modules (drivers)
  • lliurex-starboard-ltsp-server (servicio) (en el servidor de aula)

Instalación del motor de contenedores

Para soportar esta tecnología se hace necesario el uso de contenedores que proporcionan imágenes con todo lo necesario para el funcionamiento del software. En este caso será necesario utilizar Docker como tecnología de contenedores.

Aunque sea necesario el uso de Docker, en este manual no se cubre ni es necesario el conocimiento de dicha tecnología, tan solo es una dependencia que el usuario no necesita utilizar directamente, el cliente que se proporciona para el uso de la pizarra abstrae todo requerimiento de conocimiento del uso interno de Docker.

Para la instalación tan solo será necesario ejecutar desde el panel de Zero-Center el instalador correspondiente:

Este instalador realizará todas las tareas necesarias para tener correctamente configurado el sistema de contenedores en la máquina.

Instalación en modo texto

Si se desea realizar la instalación en modo texto desde terminal se debe ejecutar con permisos de administración el siguiente comando:

user@lliurex ~ $ sudo epic install /usr/share/zero-lliurex-docker/docker.epi

Dicho instalador configurará los repositorios que proveen elsoftware de Docker e instalará los siguientes paquetes:

• docker-ce
• docker-ce-cli
• containerd.io

Instalación de drivers

Según el tipo de pizarra se requieren drivers específicos para su funcionamiento, estos drivers al ser módulos del kernel, se actualizan automáticamente cada vez que el kernel es actualizado y proporcionan las interfaces para que el software de la pizarra la detecte de forma óptima.

La instalación de estos driver se realiza automáticamente cuando se ejecuta el instalador desde zero-center.

Para el caso de pizarras Smart:
 
Para el caso de pizarras Starboard:
 

Instalación en modo texto

Si se desea instalar desde la terminal el software de pizarras se puede ejecutar lo siguiente:

Para el caso de pizarras Smart:

user@lliurex ~ $ sudo apt-get install lliurex-smart nwfermi-module xf86-input-nextwindow

Descarga de la imagen del software desde internet:

user@lliurex ~ $ sudo lliurex-smart -download

Para el caso de pizarras Starboard:

user@lliurex ~ $ sudo apt-get install lliurex-starboard starboard-modules

Descarga de la imagen del software desde internet:

user@lliurex ~ $ sudo lliurex-starboard -download

Instalación completa en sistemas semi-ligeros

Si se ha de ejecutar sobre sistemas semi-ligeros cualquiera de las dos pizarras, será necesario utilizar los instaladores en modo texto sobre la imagen creada.

Para realizar la instalación debemos crear una imagen de cliente Ltsp que actuará de sistema de solo-lectura para el aula, posteriormente deberemos editarla y regenerarla para que se actualice y ya pueda ser utilizada de forma completa.

Queda fuera de este manual como crear una imagen de cliente Ltsp, no obstante para el ejemplo supondremos que hemos creado desde Admin-Center en el servidor una imagen de cliente nombrada como “ClienteLTSP”.

El contenido de las imágenes Ltsp está ubicado en “/opt/ltsp”, dentro deberán haber carpetas con los nombres de las imágenes disponibles, por tanto podemos entrar a una terminal y posicionarnos en dicha carpeta:

Paso 0:

user@lliurex ~ $ cd /opt/ltsp

Para realizar la instalación del software dentro de la imagen se procederá de la siguiente forma:
Fijarse que el “promt” actual muestra que estamos en el
Paso 1:

user@lliurex /opt/ltsp $ sudo ltsp-chroot -m -a ClienteLTSP

Posteriormente cambiará el “promt” del sistema mostrando que el directorio actual es “/” y ya estamos editando el sistema de la imagen.
Paso 2:

root@lliurex:/# apt-get update

Según el tipo de pizarra instalaremos el software correspondiente, tenemos dos formas de realizarlo:
Opción A) Utilizando el instalador (zero-lliurex-smart o zero-lliurex-starboard están instalados):

Para Smart:
Paso 3 (Smart):

root@lliurex:/# epic install /usr/share/zero-lliurex-smart/lliurex-smart.epi

Para Starboard:
Paso 3 (Starboard):

root@lliurex:/# epic install /usr/share/zero-lliurex-smart/lliurex-starboard.epi

Opción Instalación manual (no están instalados los zero-lliurex-…) :
Para Smart:
Paso 3 (Smart):

root@lliurex:/# apt-get install lliurex-smart zero-lliurex-smart lliurex-smart-ltsp-client nwfermi-module xf86-input-nextwindow

Para Starboard:
Paso 3 (Starboard):

root@lliurex:/# apt-get install lliurex-starboard zero-lliurex-starboard lliurex-starboard-ltsp-client starboard-modules

Paso 4:

root@lliurex:/# epic install /usr/share/zero-lliurex-docker/docker.epi

Posteriormente ya podemos salir de la edición de imagen pulsando <Ctrl + D> hasta que aparezca el prompt habitual de usuario (user@lliurex /opt/ltsp $) e instalar el software en el servidor
Paso 5 (Smart):

user@lliurex /opt/ltsp $ sudo apt-get install lliurex-smart-ltsp-server

Paso 5 (Starboard):

user@lliurex /opt/ltsp $ sudo apt-get install lliurex-starboard-ltsp-server

Para el paso 6, se ha de descargar de internet la imagen necesaria, es un proceso que puede durar unos minutos según la conexión a internet que se disponga.
Paso 6 (Smart):

user@lliurex /opt/ltsp $ sudo nbd-lliurex-smart install-server

Paso 6 (Starboard):

user@lliurex /opt/ltsp $ sudo nbd-lliurex-starboard install-server

Paso 7: Debemos regenerar la imagen desde Admin-Center.

Comportamiento de los clientes

Funcionamiento general del cliente de pizarra

Según el tipo de pizarra debemos utilizar el cliente correspondiente lliurex-smart o lliurex-starboard, ambos funcionan de forma similar.

Cada cliente se ejecuta con algún parámetro, normalmente utilizaremos los siguientes parámetros según el uso:

• start : Inicia el software
• -stop : Apaga el software
• -download : Descarga de internet la imagen del software
• -clean : Borra la instancia del software del usuario actual
• -purge : Borra las instancias y la imagen del sistema
• -clearconfig : Borra los directorios de configuración globales del sistema que utilizan todas las instancias

El funcionamiento del cliente es abstraer el uso de contenedores al usuario, no obstante a modo de información el cliente y la tecnología ofrece es:

• Permite tener una imagen del software de la que se generan instancias por usuario ejecutando el software de forma completamente aislada y controlada.
• Al utilizar el software de forma aislada, se crean carpetas mapeadas para poder traspasar información del software de la pizarra y el home del usuario. Por ello cada usuario que ejecute el software de pizarra dispone de un directorio en su home que permite dejar o tomar ficheros generados por el software de la pizarra.

• $HOME/lliurex-smart-storage ↔ /root/lliurex-smart-storage
• $HOME/lliurex-starboard-storage ↔ /root/lliurex-starboard-storage

Si el usuario desea leer un fichero con el software de la pizarra debe depositarlo en dicha carpeta, de forma análoga si el software de la pizarra genera ficheros, estos deben ser guardados en dicha carpeta para ser leídos desde otra utilidad.

• La configuración de la pizarra es global para todos los usuarios y cualquiera de ellos puede ajustarla.
• En el caso de lliurex-smart, se auto ejecuta en cada entrada de la sesión gráfica que ejecute un usuario del sistema.

Actualización del software

Para actualizar el software de la pizarra, se procederá de la siguiente forma, ejemplo para lliurex-smart, de forma análoga se puede utilizar el cliente lliurex-starboard:

• Eliminar las instancias de usuarios y la imagen actual y bajar una imagen nueva actualizada.
  • Ejecutar:

user@lliurex ~ $ sudo lliurex-smart -purge
          user@lliurex ~ $ sudo lliurex-smart -download

Solución de problemas conocidos Q/A

Q: - Pizarras Smart que dejan de poder realizar trazos sobre la pantalla.
A: - En ocasiones puede corromperse la configuración global de la pizarra, ocasionando que no se active el modo de realizar trazos sobre la pantalla, para solucionarlo se puede intentar lo siguiente:
1. Apagar el software de la pizarra saliendo desde el applet en la barra de tareas
2. Ejecutar:

user@lliurex ~ $ lliurex-smart -clearconfig
       user@lliurex ~ $ lliurex-smart -start