Updating TORO
When there's a new version of TORO waiting for your store, you can install it yourself from the register in a couple of clicks. This article walks through what happens when you do, what the Stations with Heartbeat window is asking of you, and what each message means if the update doesn't go ahead.
Before You Start
- Finish any sale in progress. TORO won't update in the middle of a sale. If one is open you'll see "You must finish the open transaction prior to updating TORO." Complete or cancel the sale and try again.
- Start with your main station. Your main station is the register TORO treats as the store's main computer. The other registers can't update until the main one has, so do that one first, then the rest.
- Pick a quiet moment. TORO closes itself to install the update, and on the main station the other registers need to be closed too.
Starting the Update
- On the register you want to update, open the Help menu. (On the modern home screen, Help is in the left sidebar.)
- Click Update TORO...
- If nobody is logged in, TORO asks you to log in first.
What happens next depends on whether you're on the main station or one of the other registers.
On the Main Station
Closing the other registers: the Stations with Heartbeat window
Every register running TORO keeps checking in with the store's database, and that check-in is called its heartbeat. When it's shut down properly, the heartbeat stops. Before the main station updates, TORO makes sure every other register has stopped, because the update can change the database they all share.
If any other register still has a heartbeat, the Stations with Heartbeat window opens. The red message across the top says what to do: shut down TORO on each register listed, and if TORO isn't actually running on one, start it back up and close it properly with the X in the top right corner.
The list shows, for each register:
- Station Name — which register it is
- Last Heartbeat — the date and time it last checked in
- Minutes Since Last Heartbeat — how long ago that was. A register that's really running checks in all the time, so a small number here means TORO is almost certainly still open on it. A big number usually means that computer was switched off or crashed without closing TORO properly.
Go to each register in the list and close TORO with the X. Then come back and click Refresh. Each register you closed drops off the list, and once the list is empty the window closes by itself and the update carries on.
If you click Close while registers are still listed, the update simply doesn't start. Nothing is changed; just run Update TORO... again when they're closed.
When a register won't leave the list: Kill Selected Stations
Sometimes a register is listed even though TORO isn't running on it — the computer lost power, or TORO was closed some other way than the X. The best fix is the one in the red message: start TORO on that register and close it properly.
If you can't get to that computer, select it in the list and click Kill Selected Stations. This doesn't shut anything down on the other computer — it just clears TORO's "still running" mark for that register so the update can go ahead.
- If every register you selected last checked in 2 or more minutes ago, they're cleared from the list straight away.
- If any of them checked in more recently than that, TORO treats it as still running and says so ("You can only kill stations that have a heartbeat that hasn't been registered in the last minute."). Then:
- If the update includes database changes, TORO won't let you skip ahead. It tells you that you must shut TORO down properly on all machines.
- Otherwise TORO asks Admin User Override?, warning that this "is not recommended and can cause sync issues." Answer Yes and log in as an admin, and the selected registers are cleared. TORO warns that a register that really is still running may check in again, so close the window quickly to carry on with the update.
Only use this for a register you're sure isn't in the middle of selling something.
The backup step
If the new version includes changes to your database, the main station offers to protect your data first:
- With the Backup Module, TORO explains that a backup will be made to keep your data safe, that it could take several minutes, and asks Proceed? Answer Yes and it backs up, then updates. Answer No and nothing is installed.
- Without the Backup Module, TORO strongly suggests you make your own backup first and asks Continue? Make your outside backup before you answer Yes. Answering No stops the update.
Updates without database changes skip this step. See Backup Module for how backups work.
On Any Other Register
The other registers go straight to the update — no heartbeat check and no backup question. The main station has already done both.
While It Installs
A progress window headed Updating TORO shows each step as it goes: checking whether an update is available, downloading it, and Update downloaded! when it's ready. Then TORO closes itself and the TORO updater takes over to install the new version and start TORO again. Leave the computer alone until TORO is back up.
If It Doesn't Update
The Updating TORO window tells you why. The common ones:
- Station is up to date. — this register already has the newest version. Nothing to do.
- Station cannot be updated yet. — a new version is coming, and the next line tells you the date and time it becomes available.
- Must update Main Station first. — you're on one of the other registers. The next line names your main station; update that one, then come back.
- Must update Main Station first, but update not available until a date and time — the main station's update isn't open yet either. Try again after that time.
- Main station is up to date, but at version... — the main station is on an older version than this register is trying to install. Update the main station first.
- Updates disabled for this station! Contact Support! — updates are switched off for this register. Call support; the next line gives the reason.
- Contact Support with Error 'UPDATE-42F' — the download failed. Check the internet connection and try again, and call support if it keeps happening.
If the TORO updater itself shows an error once TORO has closed, or the register can't reach TORO's servers, use the Diagnostics button in the updater window. It's covered in Getting Help and Support.
Common Questions
The Stations with Heartbeat window lists a register we don't use any more. Its heartbeat was never cleared because TORO wasn't closed properly on it the last time it ran. Select it and click Kill Selected Stations; if it last checked in more than a couple of minutes ago it clears straight away.
I closed every register but one is still listed. Click Refresh — the list doesn't update on its own. If it's still there, TORO didn't close properly on that register; open it and close it with the X.
Can I update the other registers first? No. They'll tell you "Must update Main Station first." Update the main station, then the rest.