Kiosk-FAQ en probleemoplossing

Avatar
Laura CARBO

Moeilijkheidsgraad: expert

Inhoud

Leerdoelen

Na het lezen van dit artikel kunt u:

  • Problemen in de Kiosk-app oplossen

 

zie Room Display-FAQ en probleemoplossing

FAQ

Vragen over het netwerk

Waarom moeten poorten 80 en 443 worden ingeschakeld in de firewall voor Qbic-apparaten?
  • Poort 80 wordt gebruikt voor HTTP 
  • ‪Poort 443 wordt gebruikt voor HTTPS 

De Workplace API en alle apps/touchpoints communiceren via https, dus 443 zou voldoende moeten zijn. 

‪ 

Specifiek voor Qbic-apparaten -> Het apparaatbeheerplatform (het eerste tabblad Device Control, specifiek voor Qbic) communiceert met de Qbic-apparaten voor hardwarebeheer via http (poort 80). Dit is simpelweg de manier waarop Qbic de API beschikbaar stelt, dus we kunnen dit niet wijzigen. Als poort 80 niet beschikbaar is, werkt het externe hardwarebeheer van Qbic niet. Dit is ook de reden waarom hardwarebeheer van Qbic alleen beschikbaar is voor pc's binnen hetzelfde netwerk. Het is een aanvullende beveiligingsvoorwaarde om te voorkomen dat externe apparaten via http toegang krijgen tot de Qbic-API.

 

Om vanuit Device Control configuratie naar QBIC-apparaten te pushen, moeten poorten 80 + 443 geopend zijn.

Als u Device Control niet wilt gebruiken om configuratie te pushen (geen Qbic maar een standalone kiosk; of u wilt geen Qbic-apparaten scannen in Device Control): vanuit puur Workplace-perspectief is alleen poort 443 nodig. Over het algemeen hebben pc's/apparaten poort 80 echter geopend voor webcommunicatie van andere apps/services, dus we weten niet zeker welke impact het sluiten ervan kan hebben. 

‪Klein voorbeeld: als u momenteel http://go.cobundu.com/ in uw browser invoert, wordt u automatisch doorgestuurd naar httpS://go.cobundu.com/ -> u vroeg om een onveilige URL, maar de applicatie of browser stuurde u automatisch door naar de beveiligde versie. 

‪Aan de andere kant kan uw http-verzoek in de browser eenvoudigweg de foutmelding "connection refused" tonen als poort 80 was uitgeschakeld, en wordt u niet meer doorgestuurd omdat poort 80 uw verzoek niet kon opvangen 

Welke URL's worden door de Kiosk-app gebruikt? We moeten ze op de whitelist zetten.

De Kiosk-app maakt verbinding met

Kiosk-app

Hoe meld ik me af bij de Kiosk-app?

Om u af te melden bij de Kiosk-app hebt u de inloggegevens van de kioskgebruiker nodig.

Info

Als Device Account Management is ingeschakeld, is het wachtwoord mogelijk door Workplace opnieuw ingesteld op een willekeurig, automatisch gegenereerd wachtwoord voor het apparaataccount.

 

Tik meerdere keren op het logo (linksboven op kiosks; op Meeting Room Displays linksonder of rechtsboven, afhankelijk van de gebruikte profielweergave)

U wordt gevraagd de inloggegevens van de kioskgebruiker op te geven

  • Return to Home: terugkeren naar het scherm van de Kiosk-app die in gebruik is
  • Re-Configure Device: de configuratie opnieuw starten (bijvoorbeeld wanneer u het profiel of thema wijzigt)
  • Force Reload Configuration (bijvoorbeeld wanneer u een locatienaam of afbeelding in IWMS hebt gewijzigd, of wanneer u aangepaste inhoud wilt pushen)
  • Exit: de app afsluiten
image-20221011-124013.png
Is het mogelijk om de Kiosk-app 90° te draaien en deze in portret-/verticale modus te bekijken?

De Kiosk-app schakelt naar de relevante liggende of staande modus op basis van de schermrotatie.

 

QBIC

Hoe upgrade ik de Android-versie van het QBIC-apparaat?

Info

Als u de BOX PC uit de geïnstalleerde locatie verwijdert om deze upgrade uit te voeren, zorg er dan voor dat u een display aansluit.

  • Sluit de HDMI-kabel tussen de BOX PC en het display aan om de stappen weer te geven
  • Bij een touchscreen-display: sluit de USB-C-kabel tussen de BOX PC en het display aan om de touchscreenfunctionaliteit te gebruiken
  • Bij een normale monitor: sluit een toetsenbord en muis aan op de BOX PC

 

  1. Controleer de huidige firmwareversie/buildnummer via Settings > About Device
  2. Als de versie lager is dan v2.0.4, upgrade deze dan eerst naar versie v2.0.4.

    1. Maak een ticket aan bij Spacewell Support om het firmwarebestand v2.0.4 te ontvangen

  3. Push de firmware-upgrade (v2.0.4) via Device Control naar het QBIC-apparaat
  4. Controleer de firmwareversie op het apparaat
  5. Als de firmwareversie v2.0.4 is, kunt u beginnen met de upgrade naar Android 12

    1. Maak een ticket aan bij Spacewell Support om het Android 12 zipbestand te ontvangen

  6. Het wordt aanbevolen de “USB Drive method” te gebruiken om de Android-versie te upgraden; dit is een snel en eenvoudig proces. (We raden het gebruik van de URL voor een externe firmware-upgrade niet aan, omdat het veel tijd kost om het bestand te downloaden en te installeren.)
  7. Laad het Android 12-bestand op de USB-stick en sluit deze aan op het QBIC-apparaat.
  8. Ga nu naar "Settings" > "Firmware update" > "FIRMWARE UPDATE". Het apparaat wordt automatisch opnieuw opgestart en installeert de Android 12-versie.
  9. Controleer de Android-versie: ga naar Settings → About Device → Android Version.

 

image-20240419-122821.png

 

Als u tijdens de upgrade een ORA-fout krijgt, is er iets mis met het ZIP-bestand. Controleer of bestandsnaam, bestandsgrootte enzovoort exact overeenkomen met het weergegeven downloadbestand. Wijzig de naam van het bestand niet.

 

Als u na de upgrade een "authentication error" krijgt, gaat u naar de Android-instellingen om App Data en App Cache te legen

Probleemoplossing

Het Device Control Platform is een goede plek om te beginnen met het oplossen van problemen. Wanneer het apparaat geen verbinding kan maken met het platform (het apparaat is “offline”): lijkt probleemoplossing op locatie de enige mogelijke optie.

Info

Bij het oplossen van problemen is het raadzaam de appversie, profielen en thema's te noteren. We raden aan een schermafbeelding te maken van alle foutschermen die u tegenkomt, voor het geval ons supportteam helpt

De meest voorkomende fout heeft te maken met apparaten die offline gaan

Een Room Display kan om meerdere redenen offline gaan. In de onderstaande tabel staan de meest voorkomende scenario's, hoe de app op elk scenario reageert en of handmatige interventie nodig is om het apparaat weer online te brengen.

Offline-scenario

Foutpunt

Herstelmechanisme

Handmatige interventie vereist?

Internet-/netwerkverbinding verbroken

Netwerk/hardware/ISP

Kiosk controleert herhaaldelijk de verbinding totdat een succesvolle verbinding tot stand is gebracht.

 NEE

Geplande uit-/inschakeltijden op Qbic

Apparaat

Kiosk maakt automatisch opnieuw verbinding wanneer het apparaat wordt ingeschakeld

 NEE

Workplace API niet bereikbaar/Workplace niet beschikbaar

Workplace-backend

Afhankelijk van het type fout dat wordt ontvangen, controleert de Kiosk herhaaldelijk of de service beschikbaar is totdat een succesvolle verbinding tot stand is gebracht

 NEE

Apparaataccount uitgeschakeld

Apparaataccount

Een apparaataccount kan in de volgende gevallen worden uitgeschakeld:

  • Handmatig uitgeschakeld in Studio door een beheerder (bijvoorbeeld bij een beveiligingsinbreuk). Omdat dit een handmatige interventie is, vormt dit geen probleem.
  • Het apparaat probeert meerdere keren in te loggen met ongeldige inloggegevens. Dit moet correct worden afgehandeld in de app.

Automatisch herstel is niet mogelijk. Een beheerder moet het apparaataccount in Studio inschakelen. De app gaat terug naar het Wizard-scherm en herstelt niet.

 JA; EEN BEHEERDER KAN INLOGGEN BIJ STUDIO EN HET ACCOUNT OPNIEUW INSCHAKELEN. DE APP MAAKT BIJ DE VOLGENDE POGING AUTOMATISCH OPNIEUW VERBINDING.

Apparaataccount – wachtwoord gewijzigd/ moet worden gewijzigd omdat het is verlopen

Apparaataccount

Een wachtwoord voor een apparaataccount kan op de volgende manieren verlopen of wijzigen:

  • Een beheerder heeft het expliciet gewijzigd door met hetzelfde account in te loggen bij Go of Studio.
  • De optie “must change password” of “Force all users to change password” is geactiveerd in Studio.
  • De “maximum password age” is verstreken.

Automatisch herstel is niet mogelijk. Een beheerder moet het wachtwoord wijzigen en nieuwe inloggegevens pushen. De app gaat terug naar het Wizard-scherm en herstelt niet.

Als "Allow Kiosk to manage it’s own device account" eerder is ingeschakeld, zou het probleem niet moeten optreden.

 JA, HOEWEL “ALLOW KIOSK TO MANAGE ITS OWN DEVICE ACCOUNT” BESCHIKBAAR IS VIA DEVICE CONTROL > SETTINGS.

Captcha-invoer gevraagd door server

Service van derde partij (ReCAPTCHA)

Captcha-invoer is vereist wanneer er binnen korte tijd te veel pogingen zijn gedaan om in te loggen met ongeldige inloggegevens. Dit houdt op een bepaalde manier verband met het vorige scenario.

Omdat Captcha-invoer op IP-adresniveau nodig is, moet deze alleen op het apparaat worden uitgevoerd.

 JA

Apparaataccount verwijderd

Workplace-backend

Kan niet automatisch worden hersteld. Er moet een nieuw account worden aangemaakt en de app moet opnieuw worden geconfigureerd.

 JA

Andere veelvoorkomende fouten en oplossingen worden in de onderstaande tabel weergegeven

Fout

Probleemoplossing

Fout bij de laatste configuratiedownload (bijvoorbeeld wanneer afbeeldingen niet konden worden gedownload)
uitvouwen

Selecteer de apparaten in Device Control en klik in de onderste balk op “ force reload configuration”

image-20220818-132235.png

Opmerking: Met force re-load configuration wordt niet onmiddellijk een configuratiepush van Device Control naar de app afgedwongen.

De tijd/klok in de app klopt niet voor de locatie
Controleer de geconfigureerde tijdzone (in Spacewell Workplace)

1. Controleer de tijdzoneconfiguratie in IWMS (controleer bijvoorbeeld het bovenliggende gebouw)

2. Controleer de tijdzoneconfiguratie in Studio > Settings > Regional Settings

3. Controleer de tijdzoneconfiguratie op het apparaat (controleer in de display-instellingen de datum/tijd-schakelaar op “take from server” (tijdserver ingesteld op time.google)

Controleer de geconfigureerde NTP (op het klantnetwerk)

Zorg ervoor dat het Network Time Protocol correct is in het klantnetwerk waarmee het display is verbonden.

Vergeet niet dat als er 2 wifi-netwerken op het apparaat zijn geconfigureerd en deze verschillende instellingen/configuraties hebben, het apparaat tussen de wifi-netwerken kan schakelen afhankelijk van de signaalsterkte. Zorg er in dat geval voor dat de apparaten altijd verbinding maken met het juiste netwerk en laat het apparaat het foutieve netwerk vergeten.

“unlock screen: type your password”

image-20220818-124619.png

 
uitvouwen

Wanneer u de Kiosk-app probeert te verlaten, toont het systeem het bericht “unlock screen: type your password” wanneer u Security for Qbic Devices hebt ingeschakeld op het Device Control Platform van de Kiosk-app. Zoals op die site (en in de onderstaande schermafbeelding) wordt vermeld: met deze instelling voorkomt u onbevoegde wijzigingen van apparaatinhoud op het apparaat zelf. Wijzigingen moeten via Device Control worden uitgevoerd.

Als het apparaat offline is in (en daardoor niet bereikbaar is via) het Device Control Platform, wordt het volgende aanbevolen:

Schakel de bovenstaande instelling uit. Omdat de verbinding tussen het apparaat en het Device Control Platform is verbroken, wordt deze wijziging echter niet onmiddellijk naar het apparaat doorgegeven.

Wanneer u nu de app afsluit (om naar het scherm met het bericht “unlock screen: type your password” te gaan), zou het mogelijk moeten zijn het apparaat te vinden door het relevante IP-bereik te scannen in Device Control Platform > Qbic Devices.

Push de (huidige) apparaatconfiguratie.

Het apparaat zou nu als “live” moeten verschijnen op het tabblad Devices van het Device Control Platform

Het blijkt dat het apparaat mogelijk een oude versie van de app start in plaats van de nieuwe. Volg in dat geval de stappen om de app te verwijderen en opnieuw te installeren (ga naar de instellingen op het apparaat > Apps en verwijder de momenteel geïnstalleerde app. Ontkoppel het apparaat vervolgens van de tenant en installeer het opnieuw vanaf het begin als een nieuw apparaat.)

Vergeet niet de beveiligingsinstelling op het Device Control Platform weer in te schakelen wanneer u klaar bent met het oplossen van problemen

“unable to get bookings”

image-20220818-124705.png

 
uitvouwen

1. Controleer of het Kiosk-gebruikersaccount in IWMS over alle juiste rechten beschikt om met Reservations te werken, bijvoorbeeld voor MCS:

2. Controleer of de MCS API-connector in Studio de nieuwste versie is (als dit niet het geval is: maak een ticket aan bij het Workplace Core-team)

3. Als dit het probleem nog steeds niet oplost, ligt het waarschijnlijk aan de Workplace-backend. Log in bij

http://go.cobundu.com > web kiosk (mogelijk moet u dit eerst configureren) en probeer met dezelfde gebruiker een reservering te maken. Zo kunnen we bepalen wie het probleem kan oplossen: ligt het probleem bij mobiel of bij de Workplace-backend?

“please help us identify, are you a robot?”

image-20220818-124727.png
uitvouwen

Als het apparaat offline is in (en daardoor niet bereikbaar is via) het Device Control Platform, wordt het volgende aanbevolen:

1. Zoek het apparaat door het relevante IP-bereik te scannen in Device Control Platform > Qbic Devices.

2. Push de (huidige) apparaatconfiguratie.

3. Het apparaat zou nu als “live” moeten verschijnen op het tabblad Devices van het Device Control Platform

Het blijkt dat het apparaat mogelijk een oude versie van de app start in plaats van de nieuwe. Volg in dat geval de stappen om de app te verwijderen en opnieuw te installeren (ga naar de instellingen op het apparaat > Apps en verwijder de momenteel geïnstalleerde app. Ontkoppel het apparaat vervolgens van de tenant en installeer het opnieuw vanaf het begin als een nieuw apparaat.)

Vergeet niet de beveiligingsinstelling op het Device Control Platform weer in te schakelen wanneer u klaar bent met het oplossen van problemen.

“ account is disabled”

image-20220818-124744.png

 
uitvouwen

1. Controleer of zowel de Workplace- als IWMS-accounts die aan dit apparaat zijn gekoppeld nog steeds zijn ingeschakeld. Schakel ze indien nodig in.

2. Mogelijk is het wachtwoord voor het account eerder opnieuw ingesteld en/of is de functionaliteit “Force all users to change passwords” in Studio > Settings > Security gepusht en is het wachtwoord van het apparaataccount sindsdien niet gewijzigd. Het wordt aanbevolen het wachtwoord voor het apparaat opnieuw in te stellen via Studio > Users.

3. Controleer of het Kiosk-gebruikersaccount in IWMS alle juiste rechten heeft om met Reservations te werken, bijvoorbeeld voor MCS:

4. Zoek het apparaat door het relevante IP-bereik te scannen in Device Control Platform > Qbic Devices.

5. Push de apparaatconfiguratie (met het gewijzigde wachtwoord).

6. Het apparaat zou nu als “live” moeten verschijnen op het tabblad Devices van het Device Control Platform

Code “XML not installed correctly”

image-20220818-124806.png

 
uitvouwen

Bij het pushen van de configuratie naar de Qbic (na het scannen van het IP-bereik op apparaten) kunt u ervoor kiezen het APK-bestand van de Kiosk-app in te voeren (selecteer “Spacewell Kiosk app” onder “What app are you installing”), zodat dit op het apparaat wordt geïnstalleerd; of de XML-URL in te voeren, waarmee de app automatisch wordt bijgewerkt wanneer een nieuwe versie in de Spacewell Appstore wordt gepubliceerd.

Als u de verkeerde combinatie selecteert van “upload file” en “What app are you installing”, kan het scherm uit de afbeelding verschijnen – met code over XML.

Dit is eenvoudig op te lossen door de juiste apparaatconfiguratie in te vullen (bijvoorbeeld "App > Remote Upgrade XML > Others > enter URL") en deze opnieuw naar het apparaat te pushen.

“Fail to play, invalid URL”

image-20220818-124823.png

 
uitvouwen

Geef een correcte URL op

“This device is already registered with another account”

image-20220818-124852.png

 
uitvouwen

Wanneer u een apparaat aan een nieuwe ruimte wilt koppelen, moet u ervoor zorgen dat u de koppeling tussen het apparaat en de bestaande configuratie verwijdert/ontkoppelt via Device Control > QBIC Devices.

“ Configuration not found. Please configure the device”

image-20220818-124924.png

 
uitvouwen

Zorg er bij het uitvoeren van de installatiewizard voor dat u de vereiste configuratie hebt ingesteld via Device Control > QBIC Devices.

Het apparaat gaat offline
uitvouwen

1. Hoe vaak gaat het apparaat offline? Is er een patroon te herkennen?

2. Noteer de stappen die u mogelijk hebt uitgevoerd om het apparaat weer online te brengen

3. Controleer de status in Device Control; wat ziet u in de momentopname van de app?

4. probeer de appconfiguratie voor het apparaat opnieuw te laden

5. Schakel het apparaat uit en weer in? Is de stekker uit het stopcontact gehaald?

6. verwijder de app en installeer deze opnieuw

Het apparaat is geroot

image-20240301-102655.png

De Kiosk-app kan niet op geroote apparaten worden uitgevoerd.

Als dit bericht op een QBIC-apparaat verschijnt, neemt u contact op met Spacewell Support.

 

“This device has not been setup”

image-20240531-083241.png

Na het terugzetten van een ELO-kiosk naar de fabrieksinstellingen kan het apparaat aangeven dat het niet is ingesteld, in plaats van de optie te tonen om de eloview-kioskmode of de Android-homepage te selecteren.

We hebben vastgesteld dat de volgende stappen het probleem hielpen oplossen: https://getbite.zendesk.com/hc/en-us/articles/360060235371-Switching-EloView-between-Kiosk-and-Android-Mode#:~:text=Switching%20EloView%20between%20Kiosk%20and%20Android%20Mode%201,automatically%20reboot%20and%20display%20the%20Android%20Home%20screen.

Android-homepage
  • Settings > Player Settings > Switch to Native Android Mode: instelling moet UIT zijn = uitgeschakeld
  • Settings > Default Home App: selecteer QuickLauncher

Kiosk-app start niet na het configureren van de URL

Zie https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357489986/Device+Control+for+QBIC#Good-to-know

 

Kunt u uw fout niet vinden in de bovenstaande tabel? Probeer dan de cache van het apparaat te legen:

  1. Ga naar het apparaat en sluit de Kiosk-app. Ga naar settings > advanced settings > apps > kiosk > "clear Cache" en "Clear data"
  2. Ga terug naar het startscherm op het display en start de Kiosk-app (start het apparaat indien nodig opnieuw op)
  3. Zodra de Kiosk-app is gestart, scant u op het Device Control Platform naar het apparaat op het tabblad "Qbic devices".
  4. Configureer het apparaat opnieuw met locatie, profiel en thema.

 

Heeft niets gewerkt? Probeer dan een tabula rasa en een schone installatie

  1. Ontkoppel het apparaat op het Device Control Platform
  2. Start het apparaat opnieuw op (op het apparaat of via Device Control)
  3. Ga naar het apparaat en sluit de Kiosk-app. Ga naar settings > advanced settings > apps > kiosk > "clear Cache" en "Clear data".
  4. Zet het Qbic-apparaat terug naar de fabrieksinstellingen
  5. Controleer in de display-instellingen de datum/tijd-schakelaar op “take from server” (tijdserver ingesteld op time.google; tijdzone ingesteld op de relevante tijdzone)
  6. In Studio: schakel de gebruiker uit en weer in + stel het wachtwoord opnieuw in
  7. Device Control-tabblad Qbic Devices > IP scan: installeer de nieuwste versie van de app (via “remote upgrade XML”) + push de configuratie
  8. Device Control-tabblad Devices: koppel de apparaten

 

 

 

Artikelen in deze sectie