1. Introducció

Aquest manual està orientat a les pissarres digitals tipus Smart o 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 21, s'han realitzat canvis de funcionament intern respecte a les versions anteriors, atés que el programari natiu de les pissarres que proporcionen els fabricants està molt desactualitzat en les dependències necessàries.

Nota prèvia important: A causa de canvis en el nucli del sistema en versions del nucli superiors a la 5.5 inclòs en les actualitzacions de Lliurex 21, l'instal·lador del controlador per a pissarres Starboard no és funcional, per això fallarà la instal·lació del paquet que conté el controlador (starboard-modules), en cas de fallada haurà d'eliminar-se el programari instal·lat per a evitar avisos d'errors o instal·lacions incompletes. En cas de requerir la seua instal·lació pot instal·lar-se un nucli de versió 5.4 a través de First Aid Kit i posteriorment instal·lar a través de APT o qualsevol interfície del gestor de paquets l'instal·lador (zero-lliurex-starboard) per a poder llançar-ho des de Zero-Center.

Per a prestar suport, a grans trets seran necessaris diversos components que seran enumerats i detallats a continuació juntament amb les peculiaritats que siguen necessàries, no obstant això la instal·lació està prevista per simplicitat per a ser realitzada tan sols prement l'accés en la subfinestra Zero-Center

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.
• De manera opcional, i només per al cas que es desitge utilitzar el programari en mode semilleuger, seran necessaris 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 semilleuger, es detallaran les instruccions en apartats específics per a aquest mode.

Nota: Els instal·ladors per a Zero-Center solen anar inclosos i preinstal·lats en la distribució (zero-lliurex-smart, zero-lliurex-smart-ng, zero-lliurex-starboard) no obstant això sobre Lliurex 21 que utilitza nuclis superiors a la versió 5.5 l'instal·lador per a Starboard (zero-lliurex-starboard) resulta problemàtic i no estarà instal·lat per defecte, encara que continua estant disponible en el repositori, pot ser instal·lat a través de APT o qualsevol de les seues interfícies gràfiques.

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 una rèplica LliureX, per a realitzar la instal·lació d'aquest programari pot ser imprescindible tindre disponible una rèplica 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àfic o en mode text, segons les preferències de l'usuari. 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 permeta 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. Instal·lació del programari necessari

Per a instal·lar automàticament zero-lliurex-smart (l’accés de zero-center que instal·la el botó "Smart") shan d'instal·lar els següents paquets en l'equip segons el tipus de pissarra:

2.1. Pissarres Smart:

• zero-lliurex-docker (insta·lador docker-ce)
• lliurex-smart (client)
• zero-lliurex-smart (instal·lador)
• nwfermi-module (controladors)
• xf86-input-nextwindow (controladors)

2.2. Pissarres Starboard:

• zero-lliurex-docker (insta·lador docker-ce)
• lliurex-starboard (client)
• zero-lliurex-starboard (instal·lador)
• starboard-modules (controladors)

2.3. Només si es desitja executar en semilleugers

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

2.3.2. Pissarres Starboard:

• zero-lliurex-docker (insta·lador docker-ce)
• 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)

3. 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à utilitzar 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 tauler 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.

3.1. Instal·lació en mode text (avançat, manual)

Si es desitja realitzar la instal·lació en mode text des del terminal, s'ha d'executar amb permisos d'administració la següent ordre:

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

Aquest instal·lador configurarà els repositoris que proveeixen el programari de Docker i instal·larà els següents paquets:

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

4. Instal·lació de controladors

Segons el tipus de pissarra, es requereixen controladors específics per al seu funcionament. Aquests controladors , en ser mòduls del nucli (kernel), s'actualitzen automàticament cada vegada que el nucli és actualitzat i proporcionen interfícies perquè el programari de la pissarra la detecte de forma òptima.

La instal·lació d'aquests controladors es realitza automàticament quan s'executa l'instal·lador des de zero-center.

Per al cas de pissarres Smart:

Per al cas de pissarres Starboard:

Nota: Només inclòs per defecte en Lliurex 19, en Lliurex 21 actualitzada amb el nucli superior al 5.5 no estarà instal·lat per defecte, haurà d'instal·lar-se manualment (zero-lliurex-starboard) a través de APT o la interfície del gestor de paquets preferida.

4.1. Instal·lació en mode text

Si es desitja instal·lar des de la terminal el programari de pissarres, es pot executar el següent:

Per al cas de pissarres Smart:

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

Descàrrega de la imatge del programari des d'internet:

user@lliurex ~ $ sudo lliurex-smart -download

Per al cas de pissarres Starboard:

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

Descàrrega de la imatge del programari des d'internet:

user@lliurex ~ $ sudo lliurex-starboard -download

4.2. Instal·lació completa en sistemes semilleugers

Si s'ha d'executar sobre sistemes semilleugers qualsevol de les dues pissarres, caldrà utilitzar els instal·ladors en mode text sobre la imatge creada.

Per a realitzar la instal·lació hem de crear una imatge de client Ltsp que actuarà de sistema de només lectura per a l'aula, posteriorment hem d'editar-la i regenerar-la perquè s'actualitze i puga ser utilitzada de forma completa.

Queda fora d'aquest manual com crear una imatge de client Ltsp; no obstant això, per exemple, suposarem que hem creat des d'Admin-Center, en el servidor, una imatge de client anomenada “ClientLTSP”.

Si necessitem executar una terminal dins de la imatge, podem realitzar-ho des d'Admin-center:

Però també podem realitzar-ho de forma manual, ja que aquest mètode és, potser, més ràpid:

El contingut de les imatges Ltsp està ubicat en “/opt/ltsp”, dins haurà d'haver-hi carpetes amb els noms de les imatges disponibles; per tant, podem entrar en una terminal i col·locar-nos en aquesta carpeta:

Pas 0:

user@lliurex ~ $ cd /opt/ltsp

Per a realitzar la instal·lació del programari dins de la imatge, es procedirà de la següent forma:
Fixeu-vos que l'indicador (promt) actual mostra que estem en aquest.

Pas 1:

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

Posteriorment canviarà l'indicador (promt) del sistema i mostrarà que el directori actual és “/” tem editant el sistema de la imatge.
Pas 2:

root@lliurex:/# apt-get update

Segons el tipus de pissarra, instal·larem el programari que corresponga; podem fer-ho de dues maneres:

Opció A: Utilitzant l'instal·lador (zero-lliurex-smart o zero-lliurex-starboard estan instal·lats):

Per a Smart:

Pas 3A (Smart):

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

Per a Starboard:

Pas 3A (Starboard):

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

Opció B: Instal·lació manual (no estan instal·lats els zero-lliurex-…) :

Per a Smart:

Pas 3B (Smart):

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

Per a Starboard:

Pas 3B (Starboard):

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

Pas 4:

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

Posteriorment podrem eixir de l'edició d'imatge prement fins que aparega l'indicador (prompt) habitual d'usuari (user@lliurex /opt/ltsp $) i podrem instal·lar el programari en el servidor
Pas 5 (Smart):

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

Pas 5 (Starboard):

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

Per al pas 6, s'ha de descarregar d'internet la imatge necessària. És un procés que pot durar alguns minuts segons la connexió a internet de què es dispose.
Pas 6 (Smart):

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

Pas 6 (Starboard):

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

Pas 7:

Hem de regenerar la imatge des d'Admin-Center.

4.3. Comportament dels clients

4.3.1. Funcionament general del client de pissarra

Segons el tipus de pissarra, hem d'utilitzar el client corresponent lliurex-smart o lliurex-starboard, ambdós funcionen de forma semblant.

Cada client s'executa amb algun paràmetre, normalment utilitzarem els següents paràmetres, segons l'ús:

• start : Inicia el programari (si no hi ha imatge, es realitzarà automàticament la descàrrega des d’internet, tardarà un poc més)
• stop : Apaga el programari
• download : Descarrega d'internet la imatge del programari
• clean : Elimina la instància del programari de l'usuari actual
• purge : Elimina les instàncies i la imatge del sistema
• clearconfig : Elimina els directoris de configuració globals del sistema que utilitzen totes les instàncies

Exemple per a eliminar totes les instàncies i tornar a executar una arrancada neta (útil si hi ha problemes o no tenim l'última versió):

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

El funcionament del client consisteix a abstraure l'ús de contenidors a l'usuari; no obstant això, a manera d'informació, el client i la tecnologia ofereixen:

• Permetre tindre una imatge del programari de la qual es generen instàncies per usuari que executa el programari de forma completament aïllada i controlada.
• En utilitzar el programari de forma aïllada, es creen carpetes mapades per a poder traspassar informació del programari de la pissarra i de la carpeta d'inici de l'usuari(home). Per això, cada usuari que execute el programari de pissarra disposa d'un directori en la seua carpeta d'inici (home) que permet deixar o agafar fitxers generats pel programari de la pissarra.
  • $HOME/lliurex-smart-storage ↔ /root/lliurex-smart-storage
  • $HOME/lliurex-starboard-storage ↔ /root/lliurex-starboard-storage

Si l'usuari desitja llegir un fitxer amb el programari de la pissarra, ha de depositar-lo en aquesta carpeta; de forma anàloga, si el programari de la pissarra genera fitxers, aquests han de ser guardats en aquesta carpeta perquè siguen llegits des d'altra utilitat.

• La configuració de la pissarra és global per a tots els usuaris i qualsevol d'ells pot ajustar-la.
• En el cas de lliurex-smart, s'autoexecuta en cada entrada de la sessió gràfica que execute un usuari del sistema.

4.4. Actualització del programari

Per a actualitzar el programari de la pissarra, es procedirà de la següent forma (l'exemple és per a lliurex-smart però, de forma anàloga, es pot utilitzar el client lliurex-starboard):

• Cal eliminar les instàncies d'usuaris i la imatge actual i baixar una imatge nova actualitzada.

Cal executar:

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

4.5. Desinstal·lació del programari

Per a eliminar el programari, pot realitzar-se el mateix procediment que si es desitjara realitzar la instal·lació. L'instal·lador epigtk que s'obri quan és premut el botó Zero-Center permet la desinstal·lació del programari prement el botó Desinstal·la a la cantonada inferior esquerra.

5. Solució de problemes coneguts P/R

P: - Pissarres Smart que deixen de poder realitzar traços damunt de la pantalla.
R: - A vegades pot corrompre's la configuració global de la pissarra i provocar que no s'active el mode de realitzar traços sobre la pantalla. Per a solucionar-ho, es pot intentar el següent:

1. Cal apagar el programari de la pissarra, eixint des de la miniaplicació en la barra de tasques
2. Cal executar:

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

Q: - En tindre instal·lat el programari d’Smart, es desactiva el botó esquerre d'un ratolí connectat a l'equip impossibilitant realitzar clics.
A: - La pissarra pot simular només mitja pulsació sense acabar-la, bloquejant altres esdeveniments de pulsació, prémer novament la pissarra diverses vegades perquè allibere l'esdeveniment i puguen realitzar-se nous clics.

Q: - El moviment fa salts o no cal en pissarres Smart.
A: - Algunes condicions ambientals o de posició poden provocar un funcionament inadequat de la pissarra quan és usada, com ara objectes que siguen presents tocant la pissarra en altres zones o estiguen molt a prop, llum intensa que estiga projectada de forma no uniforme en zones de la pissarra, alguns problemes poden millorar allunyant objectes tocant la pissarra o revisant la posició de la pissarra respecte a finestres pròximes.

Q: - No funciona la pissarra immediatament després de connectar o quan a l'inici es realitza una pulsació.
A: - El programari que permet utilitzar la pissarra pot tardar 30 segons a començar a reaccionar i moure el ratolí quan es comença a utilitzar, encara no es coneix solució, es recomana realitzar pulsacions en la pissarra fins que comence a funcionar i es moga el ratolí.

Q: - La pissarra no es detecta només es connecta.
A: - El programari lliurex-smart tarda a detectar la pissarra uns 30 segons amb un funcionament normal. S’ha d’esperar i la miniaplicació passarà a detectar-la passat el període de temps inicial, si no funciona, pot realitzar-se un apagat des de la miniaplicació i tornar a llançar-lo; en cas contrari, revisar la longitud o la qualitat del cable USB que s’utilitza per a connectar-la.

Q: - No funciona l'eina de calibratge.
A: - És un problema conegut, actualment sense solució. Es recomana, en cas que siga possible, que la projecció coincidisca amb les dimensions de la pissarra per a poder utilitzar-la sense necessitat de calibratge.

Q: - Falla la instal·lació a través de Zero-Center o dona una fallada d'instal·lació el paquet *starboard-modules, que puc fer?
A: - Si es posseeix un nucli superior al 5.5 (es pot comprovar executant 'uname -r'), pot instal·lar-se un inferior com per exemple el 5.4 a través de l'eina First Aid Kit, si es desitja eliminar la instal·lació problemàtica pot eliminar-se el paquet mitjà-instal·lat (starboard-modules).