1. Introducció

Aquest manual està orientat per a les pissarres digitals tipus Smart o bé Starboard, el programari que tracta el manual serà diferent en cada cas, però el funcionament és similar i les diferències estan especificades segons el cas.

Per a poder utilitzar les pissarres digitals sobre Lliurex 19 s'han realitzat anvis de funcionament intern respecte a les versions anteriors atés que el programari natiu de les pissarres que proporcionen els fabricants està altamente desactualitzat amb les dependències necessàries.

Per a prestar suport, a grans trets es necessitaran diversos components que s'enumeraran i detallaran a continuació juntament amb les peculiaritats que siguen necessàries.

El procés d'instal·lació aquesta documentat de manera que s'enumeren diverses maneres de realitzar les instal·lacions, en manera gràfica o en manera text, segons l'usuari pot preferir-se utilitzar l'una o l'altra, en qualsevol cas el resultat serà el mateix. En cas d'un usuari expert o necessitat de depuració la manera text és el recomanat ja que pot oferir pistes o traces de mal funcionament o problemes.

Sempre es recomana mantindre el sistema actualitzat per a obtindre correccions del programari que puga presentar errors o *bugs, en *elcaso d'aquesta infraestructura que permet executar el programari antic de pissarres, s'ha de procedir a actualitzar la imatge del programari de la pissarra de manera independent a l'actualització del sistema, per a això seguir les instruccions de l'apartat actualització del programari en aquest manual.

Seran necessaris els següents components:

• Un motor de contenidors (Docker) en aquest cas.
• Una imatge preparada amb el programari de la pissarra electrònica.
• Un client per a poder executar les accions en el programari.
• Els connectors necessaris per a la detecció i correcte funcionament de la pissarra.
• Opcionalment i només per al cas que es desitger utilizar el programari en mod semi-lleuger, seran necesaris alguns serveis addicionals.

La majoria d'aquests components s'han preparat per a una instal·lació senzilla que no requerisca massa coneixements tècnics i puga ser realitzada per qualsevol usuari. Per a facilitar la tasca, es proveeixen entrades en Zero-Center que simplifiquen el procés. Per al cas, una mica més complex, que es desitge tindre aquest programari en mode semi-lleuger, es detallaran les instruccions en apartats específics per a aquest mode.

Per a poder realitzar la instal·lació del programari necessari, serà indispensable posseir permisos d'administració sobre l'equip. I encara que no és estrictament necessari, si el servidor, com és habitual, està configurat per defecte per a tindre-hi un mirror Lliurex. Per a realitzar la instal·lació d'aquest programari pot ser imprescindible tindre disponible un mirror en el servidor.

El procés d'instal·lació està documentat de manera que s'enumeren diverses maneres de realitzar les instal·lacions, en mode gràfica o en mode text, segons l'usuari, pot preferir-se utilitzar l'una o l'altra, en qualsevol cas el resultat serà el mateix. En cas d'un usuari expert o de necessitat de depuració el mode text és el recomanat ja que pot oferir pistes o traces de mal funcionament o de problemes.

Sempre es recomana mantindre el sistema actualitzat per a obtindre correccions del programari que puga presentar errors o bugs, en cas que aquesta infraestructura que permet executar el programari antic de pissarres, s'ha de procedir a actualitzar la imatge del programari de la pissarra de manera independent a l'actualització del sistema. Per a això, cal seguir les instruccions de l'apartat "Actualització del programari"  d'aquest manual.

2. Instalació del programari necessari

S'han d'instal·lar els següents paquets en l'equip segons el tipus de pissarra:

• Per a  ambdos tipus de pissarres:
  • zero-lliurex-docker (insta·lador docker-ce)
• Pissarres Smart:
  • lliurex-smart (client)
  • zero-lliurex-smart (instal·lador)
  • nwfermi-module (controladors)
  • xf86-input-nextwindow (controladors)
• Pissarres Starboard:
  • lliurex-starboard (client)
  • zero-lliurex-starboard (instal·lador)
  • starboard-modules (controladors)

Només si es desitja executar en semi-lleugers

• En ambdos tipus de pissarras:
  • zero-lliurex-docker (instal·lador docker-ce)
• Pissarres Smart:
  • lliurex-smart (client) (dins de la imatge)
  • zero-lliurex-smart (instal·lador) (dins de la imatge)
  • lliurex-smart-ltsp-client (servei) (dins de la imatge)
  • nwfermi-module (controladors) (dins de la imatge)
  • xf86-input-nextwindow (controladors)
  • lliurex-smart-ltsp-server (servei) (en el servidor d'aula)
• Pissarres Starboard:
  • lliurex-starboard (client) (dins de la imatge)
  • zero-lliurex-starboard (instal·lador) (dins de la imatge)
  • lliurex-starboard-ltsp-client (servei) (dins de la imatge)
  • starboard-modules (controladors)
  • lliurex-starboard-ltsp-server (servei) (en el servidor d'aula)

Instal·lació del motor de contenidors

Per a suportar aquesta tecnologia cal utilitzar contenidors que proporcionen imatges amb tot allò necessari per al funcionament del programari. En aquest cas caldrà utitlizar Docker com a tecnologia de contenidors.

Encara que siga necessari l'ús de Docker, en aquest manual no es cobreix, ni cal, el coneixement d'aquesta tecnologia, només és una dependància que l'usuari no necessita utilitzar directament, el client que es proporciona per a l'ús de la pissarra deixa de banda el requeriment de coneixement de l'ús intern de Docker.

Per a la instal·lació només caldrà executar des del panel de Zero-Center l'instal·lador corresponent:

Aquest instal·lador realitzarà totes les tasques necessàries per a tindre correctament configurat el sistema de contenidors 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”.

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, tenemos 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.

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