⚠️ Important: Please Only Follow These Steps If You Have Been Asked To ⚠️
Please only follow the steps in this article if OneAdvanced or your ICB's centralised IT team has asked you to.
If you haven't been asked, there's nothing you need to do. Your current versions will keep working as they are.
Install the new versions of the Patchs Toolbar and the Patchs SystmOne Agent by hand, and go back to the previous versions if you have a problem.
New versions of the Patchs Toolbar (3.0.2) and the Patchs SystmOne Agent (3.0.4) are available. This article explains how to remove the old versions, install the new ones and set them up again. It also explains how to go back to your previous versions if something does not work.
Who Needs to Update
- Patchs SystmOne Agent: only practices that use SystmOne need to update the agent. If your practice does not use SystmOne, you can skip the agent steps.
- Patchs Toolbar: every practice that uses the toolbar needs to update it.
Why We Are Asking You to Do This
- Security updates: the new versions include a number of security improvements.
- Preparing for new features: they lay the groundwork for features we will be releasing.
- A change to how our software is signed: since Patchs became part of OneAdvanced, our installers are signed with a OneAdvanced code-signing certificate. Because of this, the new versions need to be installed by hand and cannot arrive through the automatic updater.
This is a one-off. If your area has been receiving updates to these programs automatically until now, you will not normally need to update by hand again. Once you are on the new versions, we expect future updates to arrive without you having to do anything.
We know a manual update is extra work for you, and we are sorry for the inconvenience. We are working on a better way to roll out updates to these programs, and we will tell you about it later.
Before You Start
- Check that you have been asked to do this (see the note at the top of this article).
- You need a Windows account that can install and remove software. If you do not have one, ask your IT team to help.
- You need to be able to log in to Patchs on each machine you are setting up.
- Update the Patchs SystmOne Agent on your Gateway machine, and the Patchs Toolbar on each machine that uses it. You can do them in either order.
- Close the Patchs Toolbar before you remove it.
How to Update
1. Remove the old versions
Do this for each program you are updating. Open Settings, then Apps, then Installed apps. On older versions of Windows, open Control Panel, then Programs and Features.
Find the Patchs Toolbar or the Patchs SystmOne Agent in the list, choose Uninstall and follow the prompts. If Windows asks for an administrator password, ask your IT team to do this step.
Note: Make a note of the version you are removing. You will need it if you decide to go back.
2. Install the new versions
Download each installer and run it. Windows may ask for an administrator password.
- Patchs SystmOne Agent 3.0.4, for the Gateway machine
- Patchs Toolbar 3.0.2
The installers are digitally signed. To check, right-click the downloaded file, choose Properties, then open the Digital Signatures tab. You should see a valid signature.
Note: If your IT team checks downloads, the SHA256 checksums are: Patchs Toolbar 3.0.2, 2bf3df4f58e1e38615f060d1b5bb1133ad15af92ae20bc75e71adca5482496c2; Patchs SystmOne Agent 3.0.4, 74012002af2400d3d6c9d323466fcd352197eb1aa4703a6d94223a968114bb6c.
3. Set up the Patchs SystmOne Agent
Do this on the Gateway machine, with SystmOne running. Log in to Patchs and go to Edit Practice, then open the TPP installation tab.
Under Which version of the Patchs SystmOne Agent is installed?, choose Version 3.x. Then click Set up Patchs on your Gateway machine.
If your browser asks whether to open the Patchs SystmOne Agent, allow it. After a few seconds, a black window appears with the words "Patchs SystmOne Agent connected! Listening for requests...". This means the agent is working.
Note: If the window says "Setup link expired or already used", go back to the TPP installation tab and click Set up Patchs on your Gateway machine again to get a new link.
4. Set up the Patchs Toolbar
Log in to SystmOne or EMIS with the account you want to link to Patchs. Then open the menu with your name at the top right of Patchs and choose Toolbar Settings.
Click Reset Patchs toolbar. If your browser asks to open the Patchs Toolbar, allow it. Then click Setup Single Sign On. If you are asked, choose Open in the "Open Patchs Toolbar" window.
The Patchs Toolbar opens and logs you in. It should show as connected.
Note: The patient buttons in the toolbar only work when a patient record is open in SystmOne or EMIS.
If You Have a Problem: Going Back to the Previous Versions
If something does not work, you can go back to the versions you had before. Please also tell us what went wrong (see "Tell Us What Happened" below), because it helps us fix it for everyone.
Go back to Patchs SystmOne Agent 2.0.2
- Remove the 3.x agent, as in step 1 above.
- Download and install Patchs SystmOne Agent 2.0.2.
- In Patchs, go to Edit Practice, then the TPP installation tab. Choose Version 2.x and click Set up Patchs on your Gateway machine.
- Check that the black window appears with the words "Patchs SystmOne Agent connected! Listening for requests...".
Go back to Patchs Toolbar 2.1.19
- Remove the 3.x toolbar, as in step 1 above. Do this before you install the older version.
- Download and install Patchs Toolbar 2.1.19.
- Open Toolbar Settings in Patchs, click Reset Patchs toolbar, then click Setup Single Sign On, as in step 4 above.
Tell Us What Happened
Please tell whoever asked you to do this update (OneAdvanced or your ICB's centralised IT team), and tell us:
- which program had the problem (the Patchs Toolbar or the Patchs SystmOne Agent), and which version you installed,
- what you did and what you expected to happen,
- what happened instead. A screenshot or the text of any error message helps.
Still Stuck?
If going back does not work, or you keep having problems, contact OneAdvanced Support:
- Online: https://services.oneadvanced.com/hub
- Phone: 0330 343 5000