Scroll to Top

Table of Contents

Overview

This user guide will walk you through upgrading the operating system on a ReadyTouch from Ubuntu 14.04 to Ubuntu 20.04 or newer. Operating systems must be periodically upgraded to ensure that they will receive maintenance updates from the OS vendor. This includes essential security patches.

To determine if your devices are eligible for this upgrade, please see the article Determining If Device Requires Update – V5 & Ready Touch.

Ubuntu 20.04 USB Upgrade

Before Upgrade

Preparation before going onsite: Make sure you have login credentials for ADM and a Cashier/Staff PIN to cash out the ReadyTouch before upgrading if the cash drawer is present. Be aware that your device must be online to upgrade. Have the serial number readily available in case it cannot be found on the kiosk itself.
Verify Your Parts Kit and Tools:
- Ubuntu bootable USB flash drive (ordered from 365)
- Mobile phone with a camera (optional: used for lighting and taking a picture of the serial number)
- Wire Cutter (optional: used to cut zip ties if needed)
- USB keyboard and mouse (wired is recommended)
- Spare OptConnect (used for a backup internet connection)
Locate Your Serial Number: Once you are on-site, look for the ReadyTouch serial number sticker on the removable plate/port cover (underneath the screen and held on by two clips on the lower back of the screen). To remove the plate, press on both clips at the same, time then pull the cover. This will expose the ports available, along with the Serial Number sticker. The clips are highlighted in yellow in the picture below.
Check All Peripherals: Check all peripherals to ensure they are in good working order before the upgrade. If there is a peripheral not working, determine the cause and try to resolve that issue first.
Cash Out: If the ReadyTouch has a cash drawer, you need to run a cash-out before upgrading.

Upgrading to Ubuntu 20.04 Using the Bootable USB

Once the ReadyTouch’s port cover is open, insert the provided Bootable USB Flash drive into any available USB port. If a port is not available, one of the other peripherals may be temporarily unplugged.
Plug in your USB keyboard
Reboot the ReadyTouch
While the device is powering back up, press the F11 key repeatedly until you reach the boot options screen.
- If a password is requested at this stage, please proceed to Step 7
From this screen, navigate to the USB option and hit enter. The USB might be listed as “USB” or the actual brand of the USB you are using. In the examples below, you can see one is listed as “USB” and another one is labeled as “Sandisk”.
At this point, you will see a list of options on a white and orange screen. Make sure the first option is selected, which it should be by default, then press Enter. If you do not press Enter, it will automatically select that option after 30 seconds, which is also fine.
A passphrase will be requested at this point. When you are typing it, nothing will populate. This is normal. The password is Chipsandadrink8! If the password is entered incorrectly, please see the troubleshooting section Incorrect Password.
Once the password has been entered correctly, the PC will begin re-imaging to the new operating system. It will go through multiple different screens. Some examples are shown below.

Ensure that the PC does not lose power during this process: turning off the power while reimaging the PC will make the PC unusable.
Once the imaging is complete, the device will power down. You may now remove the USB Flash drive, but keep the keyboard plugged in.
Power on the device and while it is booting up, repeatedly press the “delete” key on your keyboard. This will take you to the BIOS.
Navigate to the “Boot” tab using the right arrow key.
Navigate down to the “Set Boot Priority” section. Select the “1st Boot” option and hit enter.
A list of options will populate. Select the option that begins with “Hard Disk: ” in the name and press enter.
Navigate to the “Save & Exit” tab at the top.
Hit enter on “Save Changes & Exit” then hit “Yes”.
Your device will boot up and you can now proceed with the provisioning process to complete the upgrade.

If the "Insert Boot Media" error appears, repeat from step 11 onwards. If the issue persists or if you require further assistance, please contact 365 Support at (888) 365-6282.

Configuring the ReadyTouch after Upgrade – Running the Provisioner

There are two flows/processes that a kiosk might go through in order to be provisioned. It will either go through Flow 1 or Flow 2, both of which are shown below.

Provisioning Process - Initials Steps

Power up the kiosk in Provisioner Mode. You should see the Welcome! screen.
Click OK and the Network Setup screen will display, which runs a Network Check. If successful, you will see all green check marks. The last green check mark, Software Updates, can take anywhere between 10 to 20 minutes, depending on internet connectivity and how out of date the software is.
- If the Network Check fails, press the Check for Updates button. Once the update is completed, the current screen will restart and go through it's checks again. If the update was successful, then the Network Check will not fail again.
Click Next once you have all green check marks. The Commission Kiosk screen will display. Note: If Services displays a red X and says, "Failed to reach services", follow the steps in time segment 0:51-4:00 of Troubleshooting an Offline Kiosk. If it continues to fail, contact 365 Support at (888) 365-6282.
Scan or type the kiosk serial number/barcode, then select Next

At this point, your device may do one of two things: display a new message, or begin downloading and syncing.

If your kiosk displays a message stating that the Kiosk already exists, you can follow the steps found in the Provisioning Process Flow 1 - "Kiosk Already Exists" section of this article

If your kiosk begins installing and syncing data, please proceed to the Provisioning Process Flow 2 - Installation Begins section of this article

Provisioning Process Flow 1 - "Kiosk Already Exists"

If your kiosk has displayed the message "Kiosk Already Exists," complete the following steps.

Select the red “Clear Deploy Date” button
It will then take you to a screen that asks for a PIN. Enter the PIN “365” and select “Submit”. It will take you back to the “Kiosk already exists” screen. It could hover on that screen for up to a minute before moving on to the next page. This is normal and no need to press the “clear deploy date” button again.
Ince that minute has passed, it will ask you to verify the kiosk’s information. If the presented information looks correct, select “Next.”
At this point, it will start syncing and updating kiosk information. This can take 10 to 15 minutes. It is possible it will fail to sync. If this occurs, select the “Next” button again. This portion might take several attempts.

Provisioning Process Flow 2 - Installation Begins

If your device did not display the "Kiosk already exists" screen, it will instead start installing some key pieces of software and begin syncing the data to the kiosk.

When the download and sync is done, you should see a “Success” message. Click OK to continue.
Enter your email and password for ADM to continue. These are the same credentials you use to log in to ADM. You can tap on the eye Icon in the password field to show your password to confirm you have typed in the correct password.
The Select a Device to Copy screen will display. You should only see the Orgs and Locations you have access to in ADM. You will want to choose the location you are currently upgrading along with the device.
Select Next after you have chosen your Org, Location, and Device.
The Confirm Setup screen will display. It provides an overview of the device you want to copy and the device and location where you are going to copy it. Choose Confirm & Finalize if everything looks good. If there is something you want to change, select Back.

Provisioning Process - Final Steps

Now that you have handled the "Kiosk Already Exists" screen or the Installation Begins process, you can continue with the final provisioning steps.

Now you will test the peripherals. Deselect any devices that might not be applicable to your kiosk. Select Begin Testing to start testing your peripherals. You will need cash to properly test the Bill Acceptor. When testing each device, you will get a green check mark if the test was successful. When you have that green check mark, you can hit the “Next” button on the bottom right screen, which also might be displayed as a “Skip” button.
If the upgrade has been successful, then all devices will have passed, and you will see all green check marks. This means your kiosk is ready to go. If one or more devices fail the test, you will see a red X next to that device. Contact 365 Support at (888) 365-6282 for help with the failed device. If this device is not crucial to the operation of your market, you may proceed to the next steps.
Select Start Kiosk to start up the POS (Point of Sale).
Verify your kiosk shows online via ADM or from the kiosk itself. See Legacy, V5, and MM6 - Network Connectivity Verification and Troubleshooting - Operator Guide for instructions on verifying the network connectivity status remotely or on-site

After Upgrades - Destruction of USBs

A single Bootable USB Flash Drive can be used to upgrade multiple kiosks. When you have completed ALL your upgrades, any flash drives you still have in your possession should be physically destroyed. For example, the drive could be physically smashed with a hammer or drilled into with a drill bit. Be sure to take safety precautions before physically destroying a drive.

If you are not comfortable destroying the flash drive at the end of your project, please ship them back to 365, who will securely destroy them.

Troubleshooting

Password requested in boot options

Make sure the device is fully powered on
Close out the Point of Sale (POS) application with your keyboard using the keys ALT and F4 at the same time. This will take you to the desktop.
With the POS closed, press ALT + CTRL + T at the same time. This will bring up the Terminal window.
If the Terminal does not populate, you will have to navigate to it in one of two ways:
- First Method: Select the “Applications” menu in the top left-hand corner. If you still don’t see it, then scroll down to “System Tools” and the “Terminal” application should pop up. Launch the terminal and proceed to the next step.
- Second Method: Select “Applications” in the top left-hand corner, then select “Accessories”. From here you should see the “Terminal” application.
With the terminal window selected, type the command shown below and press enter. It should take around 5 seconds to run the command.
```
sudo kiosk-updater.sh --update-scripts
```
There are two spaces in the command shown below. One space is between “sudo” and “kiosk-udpater.sh”. The second space is between “Kiosk-updater.sh” and “—udpate-scripts”.
Signs of a typo in the command line: kiosk asks for a password after the command is inputted, or if the command runs in about one second.
Once the command has completed compiling, type in the next command shown below:
```
sudo kiosk-updater.sh --run-kiosk-fix-script=add-grub-clonezilla-usb-boot
```
There are only two spaces in the command below, one between sudo and kiosk. The other space is between “updater.sh” and “—run”.
Once this command is done running, reboot the kiosk.
When the kiosk boots back up, it should be on a screen like the one shown below. Navigate to the “Clonezilla USB” option using your keyboard's arrow keys. While the USB option is selected, hit enter. The screen might have a green background but should still have a similar list of options.

Incorrect Password

If you enter the password incorrectly, your screen will look like the one below. If so, press Enter.

You will then be taken to the Chose Mode screen. Navigate to the ”rerun” option and hit enter. This will take you back to the original screen that asks for the passphrase. Enter the correct passphrase, and you will now be able to proceed to Step 8.

Tips And Tricks

Never unplug the kiosk if it is on. Always use the Power
Always take a picture before you start disassembling.
It is easier to disconnect and connect the devices if the PC is slightly angled forward.
You will need a #1 screwdriver to remove the appropriate screws.
Use a “Roller Stand” or a similar product to support the front of the kiosk during service.
Watch for pinched cables.
Hold wire cutters upside down to avoid damaging cables.
It is very easy to accidentally turn off the router's power: avoid if at all possible
If the Fingerprint Reader is not giving clear readings, clean it:
- For the 4xxx Readers, clean the gel surface with sticky tape.
- Gently dab it with the sticky side of the tape. Do not rub it with paper or get it wet.
- Do not use industrial cleaners or solvents.
- Click Cleaning Instructions for Multiple Devices for more information about cleaning your fingerprint reader.
When disconnecting a serial / DVI / VGA connector, often the post becomes unscrewed, use a 3/16” nut driver to fasten it.
Zip ties can be curled to make it easier to loop them through the holes.
Make sure the 2x screws on the back of the kiosk are in when the service is done.

FAQ

Do we need to upgrade?
Yes. Once the operating systems reach the end of support, there will no longer be vendor updates. These updates can include things like security patches, drivers, and improvements for compatibility with the overall OS.
What are we upgrading from and to?
ReadyTouch devices will be upgrading from Ubuntu 14.04 to Ubuntu 20.04 or newer.
When do these upgrades need to be completed?
ReadyTouch devices running Ubuntu 14.04 have support until April 2024.
What if the upgrades do not happen until after support ends? Will the markets stop working?
Markets that are not upgraded will continue to function. However, these devices will not receive critical security patches offered by the vendor, leaving them vulnerable to new security threats.
How are these devices going to be upgraded?
There will need to be a technician onsite to complete the upgrade. They will follow the respective documentation depending on the device being upgraded. All devices will be upgraded via flash drive/USB.
Which kiosks do not qualify and what happens with those kiosks?
Devices that do not qualify are either already up to date with the latest OS or the hardware is too old. Devices that are too old will need to be replaced.
Is there a cost for these upgrades?
The USBs are currently free and there are no charges or fees.