DifficultyMoeilijkheidsgraad: expert
Inhoud
Table of Contents | ||||
---|---|---|---|---|
|
Learning Objectives
After reading this article, you’ll be able to:
Troubleshoot issues on Kiosk App
Leerdoelen
Na het lezen van dit artikel zul je in staat zijn om:
Problemen met Kiosk-apps oplossen
zie Room Display FAQ and troubleshooting
FAQ
Network related questionsNetwerk gerelateerde vragen
Expand | ||||
---|---|---|---|---|
|
| |||
Workplace API en alle apps/touchpoints communiceren via https, d.w.z. 443 zou goed genoeg moeten zijn.
Specifiek voor Qbic-apparaten -> Het apparaatbedieningsplatform (1e tabblad Apparaatbediening, specifiek voor Qbic) communiceert met de Qbic-apparaten voor hardwarebediening via http (poort 80). Dit is hoe Qbic de API beschikbaar stelt, dus dat kunnen we niet veranderen. Als poort 80 niet beschikbaar is, zal Qbic remote hardwarebeheer niet werken. Dit is ook de reden waarom Qbic hardwarebeheer alleen beschikbaar is voor PC's binnen hetzelfde netwerk. Het is een extra beveiligingsvoorwaarde Zodat externe apparaten geen toegang hebben tot de Qbic API via http. Om configuratie naar QBIC-apparaten te pushen vanuit Device Control: poorten 80 + 443 moeten open staan. Als je Device Control niet wilt gebruiken om configuratie te pushen (geen Qbic maar staande kiosk; of je wilt geen Qbic-apparaten scannen in Device Control): vanuit een puur Workplace-perspectief is alleen poort 443 nodig. Over het algemeen hebben PC's/apparaten echter allemaal poort 80 openstaan voor webcommunicatie vanuit andere apps/services, dus we weten niet zeker wat voor invloed het sluiten hiervan zou kunnen hebben. Klein voorbeeld: als je momenteel http://go.cobundu.com/ on your op uw browser, you are automatically redirected to wordt u automatisch doorgestuurd naar httpS://go.cobundu.com/ -> you asked for an insecure URL, but either the application or the browser automatically redirected you to the secure one. On the other hand, if port 80 was disabled, your http request might just show an error "connection refused" on the browser - and not redirect anymore, because port 80 could not capture your request | ||||
Expand | ||||
| ||||
Kiosk app reaches out toje hebt om een onveilige URL gevraagd, maar de applicatie of de browser heeft je automatisch omgeleid naar de veilige URL. Aan de andere kant, als poort 80 was uitgeschakeld, zou je http-verzoek een foutmelding "connection refused" (verbinding geweigerd) kunnen tonen op de browser - en niet meer doorsturen, omdat poort 80 je verzoek niet kon afvangen. |
Expand | ||
---|---|---|
| ||
Kiosk-app bereikt |
Kiosk-app
Expand | ||||||
---|---|---|---|---|---|---|
|
Info |
---|
If Device Account Management is enabled, the password might have been reset by Workplace to a random, auto-generated device account password. |
Tap multiple times on the Logo (top left on Kiosks; Meeting Room Displays either bottom left or top right depending on the used profile view)
You will be prompted to provide the Kiosk user login details
Return to Home: return to the Kiosk App-in-use screen
Re-Configure Device: re-start configuration (for example when you change the profile or theme)
Force Reload Configuration (for example when you changed a location name or picture in IWMS, or if you want to push custom content)
Hoe log ik uit bij de Kiosk-app? |
Om uit te loggen uit de Kiosk-app heb je de inloggegevens van de kioskgebruiker nodig.
Info |
---|
Als Accountbeheer voor apparaten is ingeschakeld, is het wachtwoord mogelijk gereset door Workplace naar een willekeurig, automatisch gegenereerd accountwachtwoord voor het apparaat. |
Tik meerdere keren op het Logo (linksboven op Kiosken; Meeting Room Displays linksonder of rechtsboven, afhankelijk van de gebruikte profielweergave)
U wordt gevraagd om de inloggegevens van de Kiosk-gebruiker op te geven
Terug naar Home: terugkeren naar het scherm van de Kiosk App-in-gebruik
Apparaat opnieuw configureren: configuratie opnieuw starten (bijvoorbeeld wanneer u het profiel of thema wijzigt)
Forceer herladen van configuratie (bijvoorbeeld als je een locatienaam of afbeelding hebt gewijzigd in IWMS, of als je aangepaste inhoud wilt pushen)
Afsluiten: De app afsluiten
Expand | ||||
---|---|---|---|---|
| The Kiosk app will switch to the relevant Landscape or Portrait mode based on the screen rotation
| |||
De Kiosk-app zal schakelen naar de relevante Liggende of Staande modus op basis van de schermrotatie. |
QBIC
Expand | |||||
---|---|---|---|---|---|
| |||||
Push the firmware
Check the current Firmware Version/Build number in Settings > About Device If the version is lower than v2.0.4, then first upgrade it to v2.0.4 version.
If you get an "authentication error" after the upgrade, go to Android settings to empty App Data and App Cache |
Troubleshooting
The Device Control Platform is a good place to start troubleshooting. When the device is not able to connect to the Platform (device is “offline”): troubleshooting on site seems to be the only possible option.
Info |
---|
When troubleshooting, it’s advisable to take note of the app version, profiles and themes. We recommend to take a screenshot of all the error screens you encounter in case our support team is helping |
The most common error is related to devices going offline
A Room Display can go offline due to multiple reasons. The below table lists the most common scenarios, how the app reacts to each, and whether a manual intervention is needed to bring it back online.
Offline scenario
Point of failure
Recovery mechanism
Requires manual intervention?
Internet/network connection lost
Network/hardware/ISP
Kiosk re-checks for connectivity iteratively until a successful connection is established.
No
Scheduled off/on times on Qbic
Device
Kiosk re-connects automatically when device switches on
No
Als je een "authenticatiefout" krijgt na de upgrade, ga dan naar Android-instellingen om App Data en App Cache te legen. |
Problemen oplossen
Het Device Control Platform is een goede plek om te beginnen met het oplossen van problemen. Als het apparaat geen verbinding kan maken met het Platform (apparaat is "offline"): is probleemoplossing ter plaatse de enige mogelijke optie.
Info |
---|
Bij het oplossen van problemen is het raadzaam om de app-versie, profielen en thema's te noteren. We raden aan om een schermafdruk te maken van alle foutschermen die je tegenkomt, voor het geval ons ondersteuningsteam je helpt. |
De meest voorkomende fout is gerelateerd aan apparaten die offline gaan
Een Kamerdisplay kan om verschillende redenen offline gaan. In de onderstaande tabel staan de meest voorkomende scenario's, hoe de app op elk van deze scenario's reageert en of er een handmatige ingreep nodig is om het scherm weer online te krijgen.
Error
Troubleshooting
Error in the last configuration download (for example when pictures failed to download)
Expand | ||
---|---|---|
| ||
Select the device(s) in device control and click on “ force reload configuration” in the bottom bar Note: The force re-load configuration does NOT force an immediate configuration push from device control to the app. |
Offline scenario | Faalpunt | Herstelmechanisme | Handmatige tussenkomst vereist? |
---|---|---|---|
Internet-/netwerkverbinding verbroken | Netwerk/hardware/ISP | De Kiosk controleert herhaaldelijk op connectiviteit totdat er een succesvolle verbinding tot stand is gebracht. | Geen |
Geplande uit/aan tijden op Qbic | Apparaat | Kiosk maakt automatisch opnieuw verbinding als apparaat wordt ingeschakeld | Geen |
Workplace API niet bereikbaar/Workplace down | Workplace back-end | Depending on the kind of error received, the Kiosk re-checks for service availability iteratively until a successful connection is established | No |
Device account disabled | Device account A device account can get disabled in the below cases:
| Automatic recovery not possible. An admin needs to enable the device account in Studio. The app navigates back to the Wizard screen and does not recover. | Yes; An administrator can login into studio and re-enable the account. The app will reconnect automatically at the next attempt. |
Device account – password changed/ needs to be changed because it has expired | Device account A device account password can expire or change in the following ways:
| Automatic recovery not possible. An admin needs to change the password and push new credentials. The app navigates back to the Wizard screen and does not recover. If "Allow Kiosk to manage it’s own device account" has been enabled in the past, then the issue should not occur. | Yes, although “Allow Kiosk to manage its own device account” is available under Device Control > Settings. |
Captcha input requested by server | 3rd party service (ReCAPTCHA) | Captcha input is mandated when there have been too many attempts to login with invalid credentials within a short duration. This, in a way, relates back to the previous scenario. As Captcha input is needed at an IP address level, it needs to be performed on the Device only. | Yes |
Device account deleted | Workplace back-end | Cannot be recovered automatically. A new account should be created, and the app should be configured again. | Yes |
Other common errors and solutions are shown in the table below
Afhankelijk van het soort ontvangen fout controleert de Kiosk de beschikbaarheid van de service herhaaldelijk totdat een succesvolle verbinding tot stand is gebracht. | Geen | ||
Apparaataccount uitgeschakeld | Apparaat account Een apparaataccount kan in de volgende gevallen worden uitgeschakeld:
| Automatisch herstel niet mogelijk. Een beheerder moet het apparaataccount inschakelen in Studio. De app navigeert terug naar het scherm Wizard en herstelt niet. | Ja; Een beheerder kan inloggen in studio en de account opnieuw inschakelen. De app zal bij de volgende poging automatisch opnieuw verbinding maken. |
---|---|---|---|
Apparaat account - wachtwoord gewijzigd/ moet worden gewijzigd omdat het verlopen | Apparaat account Het wachtwoord van een apparaataccount kan op de volgende manieren verlopen of veranderen:
| Automatisch herstel niet mogelijk. Een beheerder moet het wachtwoord wijzigen en nieuwe gegevens invoeren. De app navigeert terug naar het scherm Wizard en herstelt niet. Als "Allow Kiosk to manage it's own device account" in het verleden is ingeschakeld, dan zou het probleem niet moeten optreden. | Ja, hoewel "Kiosk toestaan zijn eigen apparaataccount te beheren" beschikbaar is onder Apparaatbeheer > Instellingen. |
Captcha invoer gevraagd door server | 3rd partijservice (ReCAPTCHA) | Captcha-invoer wordt verplicht wanneer er binnen een korte tijd te veel pogingen zijn geweest om in te loggen met ongeldige gegevens. Dit heeft in zekere zin te maken met het vorige scenario. Aangezien Captcha-invoer nodig is op IP-adresniveau, moet het alleen op het Apparaat worden uitgevoerd. | Ja |
Apparaataccount verwijderd | Workplace back-end | Kan niet automatisch worden hersteld. Er moet een nieuwe account worden aangemaakt en de app moet opnieuw worden geconfigureerd. | Ja |
Andere veelvoorkomende fouten en oplossingen staan in de onderstaande tabel
Fout | Problemen oplossen | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Fout bij het downloaden van de laatste configuratie (bijvoorbeeld als het downloaden van afbeeldingen mislukt) |
| |||||||||||
De tijd/klok in de app is niet correct voor de locatie |
| |||||||||||
"Scherm ontgrendelen: typ je wachtwoord" |
| |||||||||||
"niet in staat om boekingen te krijgen" |
| |||||||||||
"Help ons alsjeblieft met identificeren, ben je een robot?" |
| |||||||||||
" account is uitgeschakeld". |
| |||||||||||
Code "XML niet correct geïnstalleerd". |
| |||||||||||
"Niet afspelen, ongeldige URL" |
| |||||||||||
“This device is already registered with another account”"Dit apparaat is al geregistreerd bij een andere account". |
| |||||||||||
" Configuratie niet gevonden. Configureer het apparaat". |
| |||||||||||
Het apparaat gaat offline |
| |||||||||||
Het apparaat is geroot | Kiosk app is not able to run on rooted devices. If this message appears on a QBIC device, contact Spacewell Support. | “This device has not been setup” | After resetting an ELO kiosk to factory settings, instead of showing the option to select eloview kiosk mode versus the android home page, the device might state it’s not been setup. We found following these steps helped to solve the issue-app kan niet draaien op gerootte apparaten. Neem contact op met Spacewell Support als dit bericht wordt weergegeven op een QBIC-apparaat. | |||||||||
"Dit apparaat is niet ingesteld". | Na het resetten van een ELO kiosk naar fabrieksinstellingen, in plaats van de optie te tonen om eloview kiosk modus te selecteren op de android startpagina, kan het apparaat aangeven dat het niet is ingesteld. We ontdekten dat deze stappen hielpen om het probleem op te lossen: 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 Home screenStartscherm |
|
Couldn’t find your error in the table above? Then try to empty the cache of the device:
Go to the device and close the Kiosk app. Go to settings > advanced settings
|
Kunt u uw fout niet vinden in de bovenstaande tabel? Probeer dan de cache van het apparaat te legen:
Ga naar het apparaat en sluit de Kiosk-app. Ga naar instellingen > geavanceerde instellingen > apps > kiosk > "clear Cache wissen" and en "Clear dataGegevens wissen"
Go back to the home screen on the display and launch the Kiosk app (if needed reboot the device)
Once the Kiosk app is launched, on Device Control Platform, scan for the device on "Qbic devices" tab.
Reconfigure the device with location, profile and theme.
Nothing worked? Then try a tabula rasa and clean install
On the Device Control Platform, unlink the device
Reboot (on device or through Device Control)
Go to the device and close the Kiosk app. Go to settings > advanced settings .
Ga terug naar het beginscherm op het scherm en start de Kiosk-app (indien nodig start het apparaat opnieuw op).
Zodra de Kiosk-app is gestart, scant u op het Device Control Platform naar het apparaat op het tabblad "Qbic-apparaten".
Herconfigureer het apparaat met locatie, profiel en thema.
Heeft niets gewerkt? Probeer dan een tabula rasa en schone installatie
Ontkoppel het apparaat op het Device Control Platform
Opnieuw opstarten (op apparaat of via Apparaatbeheer)
Ga naar het apparaat en sluit de Kiosk-app. Ga naar instellingen > geavanceerde instellingen > apps > kiosk > "clear Cache wissen" and en "Clear dataGegevens wissen".
Factory reset the Qbic device
In display settings: Check date/time toggle to “take from server” (Time server set to time.google; Time zone set to relevant time zoneHet Qbic-apparaat resetten
In weergave-instellingen: Vink datum/tijd aan bij "take from server" (Tijdserver ingesteld op time.google; Tijdzone ingesteld op relevante tijdzone)
In Studio: disablegebruiker uitschakelen + enable user + reset password
Device Control Tab Qbic Devices > IP scan: install latest version of the app (through “remote upgrade XML”) + config push
Device Control Tab Devices: link devices
inschakelen + wachtwoord opnieuw instellen
Tabblad Apparaatbediening Qbic-apparaten > IP-scan: nieuwste versie van de app installeren (via "upgrade XML op afstand") + push-configuratie
Tabblad Apparaatbediening Apparaten: apparaten koppelen
Zoek op
Live Search |
---|