Troubleshooting
      Back to home
      1. Knowledge Base
      2. Kiosks
      3. Troubleshooting

      Kiosk - Troubleshooting

      In this article we will explain the most common troubleshooting questions and answers for first level support. Remote access to the kiosk is required.

        Troubleshooting Table

        Issue

         

        Cause

         

        Fix

         

        “Kiosk Currently Unavailable” message showing

        Issue connecting POS to our service
        • Ensure the POS is connected to the internet. The kiosk should become active when the QikServe servers can be reached
        • Hard reboot of the kiosk, deleting the cache. See steps below

        Kiosk images and attract screens not loading

        Issue downloading assets from our servers
        • Sign in as kiosk admin
        • Navigate to: C:\QikServe

        • Delete cache and shadow cache 

        • Reboot the kiosk - see detailed steps below

        Kiosk is rebooting to Windows sign in

        Auto logon is not working

        • Sign in as kiosk admin

        • Navigate to:
          C:\QikServe\programs\sysinternals-auto-login

        • Run Autologon.exe

        • Enter the 'KioskUser' username and password and press enable

        • Do this twice to ensure it works

        • Reboot the kiosk to validate it now works as expected.

        Issues connecting to the kiosk, and kiosk not loading cache or shadow cache

        Disk space full

        • Sign in as kiosk admin

        • Navigate to: File explorer>This PC

        • Check disk space

        • Empty recycle bin

        • For Lane3000 PED:
          Delete the oldest DMP logs leaving recent ones: C:\ProgramData\FreedomPay\Freeway Commerce Connect\dmp

        Errors with individual items

        Incorrect configuration of products, or menus not aligned
        • If you manage your own menu on the QikServe Dashboard:
          • Check the external ID of the item that is erroring against what you have in the POS
          • Check that the dashboard menu and kiosk menu is aligned. Push the menu from the dashboard to the kiosk via 'Update External Menus' to be sure

        • Write to QikServe Support with the item that is erroring, with the item name, price and PLU for reference

        Printers not working

        Various

        • Verify that the printer is powered on and has the correct paper loaded

        • Contact support@QikServe.com

        Payments not working

        		 Various
        • Verify that the PED is connected to the kiosk terminal
        • Contract support@QikServe.com

        First Level Support

        Navigation

        The kiosks are all Windows OS devices and have two user profiles, Kiosk User and Kiosk Admin. The kiosks are set to boot into ‘Kiosk User’ and load the QikServe app automatically.

        All of the remote management platforms have various tools like reboot and an option to ‘Send Ctrl, Alt, Del’ in their toolbars which will allow you to switch users to the 'Kiosk Admin' user profile. The image below is from Teamviewer, our preferred remote access tool.

        MicrosoftTeams-image (13)


        All of the kiosks have the same base file structure so you will always find the cache, and shadow cache at the following file path 'C:\QikServe '. The cache and shadow cache are loaded from the QikServe servers periodically throughout the day.image-20230516-111408

        How to reboot a kiosk

        When rebooting a kiosk it is always recommended to delete the cache and shadow cache files on the device and then restart it.

        This is easiest to do when logged in to the kiosk remotely via TeamViewer, as to do it face to face with the kiosk you will need a keyboard attached. 

        Note that the kiosk will reboot and come online before the PED, so wait roughly 4-5 minutes to know if your kiosk is functional again. Once you reboot you do not have to do anything but wait.

        If you still experience the issue then please log a ticket with support@QikServe.com. See below for what information to provide.

        Via TeamViewer

        1. Click “Files & Extras” > “Open file transfer”
          The ‘File’ and ‘Extras’ menu may be split on your version of Teamviewer. If that is the case then ‘File Transfer’ will be in ‘File’

          Screenshot 2022-12-07 at 16.13.14

        2. Navigate to C:\QikServe in the address field on the right hand side and click enter, or click on the folders ‘C:’ and then ‘QikServe’
          Select both the “cache” and “shadowcache” folder if listed - it may only be the cache folder is there

          Screenshot 2022-12-07 at 16.13.46 

        3. Delete these two folders via the small bin icon

        4. Click ‘Actions' > 'Remote Reboot’ > 'Reboot' Screenshot 2023-09-21 at 15.28.52

        5. Restart the kiosk and wait 5 minutes to see if the issue has been fixed. If your issue is payment related then run a test payment.

        Windows Services

        You can check that background services are running from within Task Manager by pressing Ctrl,Alt,Del, or using the remote access toolbar. Some key services to check are running are:

        image-20230516-115617

        • Kiosk-daemon - QikServe kiosk service

        • FCC Server - Freedompay

        • FCC Client - Freedompay

        • IPCservice - Worldpay

        • Nxlog - Ensures we are logging to Datadog

        • CouchbaseServer - Payment Database

        Contacting QikServe Support

        Please get in touch with the QikServe support when these first-level troubleshooting steps fail to resolve an issue, being sure to include:

        • Timestamps

        • Kiosk number (can be found bottom right of the attract screen)

        • The steps you have taken so far to replicate and fix the issue

        • Screenshots if appropriate