1. Introducción

Este manual está orientado para las pizarras digitales tipo Smart o bien Starboard; el software que trata el manual será diferente en cada caso, pero el funcionamiento es similar y las diferencias están especificadas según el caso.

Para poder utilizar las pizarras digitales sobre Lliurex 21 se han realizado cambios de funcionamiento interno con respecto versiones anteriores dado que el software nativo de las pizarras que proporcionan los fabricantes está altamente desactualizado en las dependencias necesarias.

Nota previa importante: Debido a cambios en el núcleo del sistema en versiones del núcleo superiores a la 5.5 incluido en las actualizaciones de Lliurex 21, el instalador del driver para pizarras Starboard no es funcional, por ello fallará la instalación del paquete que contiene el driver (starboard-modules), en caso de fallo deberá eliminarse el software instalado para evitar avisos de errores o instalaciones incompletas. En caso de requerir su instalación puede instalarse un núcleo de versión 5.4 a través de First Aid Kit y posteriormente instalar a través de APT o cualquier interfaz del gestor de paquetes el instalador (zero-lliurex-starboard) para poder lanzarlo desde Zero-Center.

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, no obstante la instalación está prevista por simplicidad para ser realizada tan sólo pulsando el acceso en el panel zero-center.

Serán 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 correcto funcionamiento de la pizarra.
• Opcionalmente, y solo para el caso de desear utilizar el software en modo 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 que 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.

Nota: Los instaladores para Zero-Center suelen ir incluidos y preinstalados en la distribución (zero-lliurex-smart, zero-lliurex-smart-ng, zero-lliurex-starboard) no obstante sobre Lliurex 21 que utiliza núcleos superiores a la versión 5.5 el instalador para Starboard (zero-lliurex-starboard) resulta problemático y no estará instalado por defecto, aunque sigue estando disponible en el repositorio, puede ser instalado a través de APT o cualquiera de sus interfaces gráficas.

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 está documentado de forma que se enumeran varias formas de realizar las instalaciones, en modo gráfico o en modo texto, según prefiera el usuario 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 el caso 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:

2.1. Pizarras Smart:

• zero-lliurex-docker (instalador docker-ce)
• lliurex-smart (cliente)
• zero-lliurex-smart (instalador)
• nwfermi-module (drivers)
• xf86-input-nextwindow (drivers)

2.2. Pizarras Starboard:

• zero-lliurex-docker (instalador docker-ce)
• lliurex-starboard (cliente)
• zero-lliurex-starboard (instalador)
• starboard-modules (drivers)

2.3. Solo si se desea ejecutar en semi-ligeros

2.3.1. Pizarras Smart:

• zero-lliurex-docker (instalador docker-ce)
• lliurex-smart (cliente) (dentro de la imagen)
• zero-lliurex-smart (instalador) (dentro de la imagen)
• lliurex-smart-ltsp-client (servicio) (dentro de la imagen)
• nwfermi-module (drivers) (dentro de la imagen)
• xf86-input-nextwindow (drivers)
• lliurex-smart-ltsp-server (servicio) (en el servidor de aula)

2.3.2. 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)

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

3.1. Instalación en modo texto (avanzado,manual)

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 el software de Docker e instalará los siguientes paquetes:

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

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

Nota: La instalación de los driver para pizarras Starboard presenta fallos si son utilizados núcleos de versión superior a la 5.5, debe instalarse un kernel versión 5.4 desde First Aid Kit previamente.

La instalación de estos driver se realiza automáticamente cuando se ejecuta el instalador desde zero-center (debe estar instalado el instalador, en caso que no aparezca deberá instalarse con APT o desde el gestor de paquetes preferido).

Para el caso de pizarras Smart:

Para el caso de pizarras Starboard:

Nota: Solo incluido por defecto en Lliurex 19, en Lliurex 21 actualizada con kernel superior al 5.5 no estará instalado por defecto, deberá instalarse manualmente (zero-lliurex-starboard) a través de APT o la interfaz del gestor de paquetes preferida.

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

4.2. 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”.

Si necesitamos ejecutar una terminal dentro de la imagen podemos realizarlo desde Admin-center:

Pero también podemos realizarlo de forma manual, ya que este método quizás es mas rápido:

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 él.

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. Existen dos formas de realizarlo:

Opción A: Utilizando el instalador (zero-lliurex-smart o zero-lliurex-starboard están instalados):

Para Smart:

Paso 3A (Smart):

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

Para Starboard:

Paso 3A (Starboard):

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

Opción B: Instalación manual (no están instalados los zero-lliurex-…) :

Para Smart:

Paso 3B (Smart):

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

Para Starboard:

Paso 3B (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 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.

4.3. Comportamiento de los clientes

4.3.1. 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 ( si no hay imagen, se realizará automáticamente la descarga desde internet, tardará un poco mas)
• stop : Apaga el software
• download : Descarga de internet la imagen del software
• clean : Borra la instancia del software del usuario actual
• purge : Borra todas las instancias en el sistema y la imagen
• clearconfig : Borra los directorios de configuración globales del sistema que utilizan todas las instancias

Ejemplo para eliminar todas las instancias y volver a ejecutar un arranque limpio (útil si hay problemas o no tenemos la última versión):

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

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

• Se 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.

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

4.4. Desinstalación del software

Para eliminar el software, puede realizarse el mismo procedimiento que si se deseara realizar la instalación, el instalador epigtk que se abre cuando es pulsado el botón zero-center permite la desinstalación del software pulsando el botón "desinstalar" en la esquina inferior izquierda.

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

Q: - Al tener instalado el software de Smart, se desactiva el boton izquierdo de un ratón conectado al equipo imposibilitando realizar clicks
A: - La pizarra puede simular solo media pulsación sin terminarla, bloqueando otros eventos de pulsación, pulsar nuevamente la pizarra varias veces para que libere el evento y puedan realizarse nuevos clicks.

Q: - El movimiento da saltos o no es preciso en pizarras Smart
A: - Algunas condiciones ambientales o de posición pueden provocar un funcionamiento inadecuado de la pizarra cuando es usada, tales como objetos que estén presentes tocando la pizarra en otras zonas o estén muy cerca, luz intensa que esté proyectada de forma no uniforme en zonas de la pizarra, algunos problemas pueden mejorar alejando objetos tocando la pizarra o revisando la posicion de la pizarra respecto a ventanas cercanas.

Q: - No funciona la pizarra inmediatamente después de conectar o cuando al inicio se realiza una pulsación
A: - El software que permite utilizar la pizarra puede tardar 30 segundos en comenzar a reaccionar y mover el ratón cuando se comienza a utilizar, todavía no se conoce solución, se recomienda realizar pulsaciones en la pizarra hasta que comience a funcionar y se mueva el ratón.

Q: - La pizarra no se detecta nada mas ser conectada.
A: - El software lliurex-smart tarda en detectar la pizarra unos 30 segundos con un funcionamiento normal, esperar y el applet pasará a detectarla pasado el periodo de tiempo inicial, si no funciona, puede realizarse un apagado desde el applet y volver a lanzarlo, en caso contrario, revisar la longitud o la calidad del cable USB que es utilizado para conectarla.

Q: - No funciona la herramienta de calibrado
A: - Es un problema conocido, actualmente sin solución, se recomienda en caso de ser posible que la proyección coincida con las dimensiones de la pizarra para poder utilizarla sin necesidad de calibrado.

Q: - Falla la instalación a través de Zero-Center o da un fallo de instalación el paquete starboard-modules, ¿que puedo hacer?
A: - Si se posee un kernel superior al 5.5 (se puede comprobar ejecutando 'uname -r'), puede instalarse uno inferior como por ejemplo el 5.4 a través de la herramienta First Aid Kit, si se desea eliminar la instalación problemática puede eliminarse el paquete medio-instalado (starboard-modules).