Upgrading From 6.11 to 6.12
The upgrade from Patriot 6.11 to Patriot 6.12 contains some additional requirements and steps compared to a normal minor version update.
Please review the entire upgrade document carefully before proceeding with the upgrade.
Planning
Prerequisites
Starting Version
The latest 6.11 version must be installed before beginning the upgrade. Ensure that Patriot 6.11.43.1 or later is installed.
.NET Runtime
Patriot 6.12 requires .NET 8 to be installed on all machines running the Patriot Data Service or Task Service. These .NET runtime components should be installed before beginning the upgrade to Patriot 6.12.
The .NET runtime components can be downloaded from Microsoft .NET Runtime Downloads
Ensure the appropriate runtimes for the operating system are installed (x64 for 64bit systems, x86 for 32bit systems):
- For machines running the Patriot Data Service, install the ASP.NET Core Runtime 8 and the .NET Runtime 8.
- For machines running only the Patriot Task Service, only the .NET Runtime 8 is required.
- For task services running on 64bit operating systems, the x86 32bit runtime is also required, to support tasks running in 32bit mode.
Task services hosting more than 30 tasks on servers with fewer than 30 logical processors may be affected by performance issues. Contact the Patriot support team before upgrading these servers.
Patriot Configurator
A new 6.12-compatible version of the Patriot Configurator is required, as the format of the Data Service and Task Service configuration files has changed in Patriot 6.12.
Download the 6.12 Patriot Configurator Installer and copy it onto all Data Service and Task Service machines before beginning the upgrade. The 6.12 Configurator is needed to edit the service configuration after the Patriot 6.12 upgrade.
Review the updated configuration settings documentation for more information on the updated configuration file format.
Task Service Component Installation
The following tasks now require installation of additional components.
Review the documentation for each task in use, and install the required components before the Patriot upgrade.
Workstation Client Files for these tasks are not affected by this change.
Lone Worker Task
The Lone Worker Task and associated Patriot Lone Worker App are no longer supported in Patriot 6.12.
If these features are in use, contact the Patriot support team before upgrading to discuss migrating to the Plink app lone worker feature.
Preparation
Request Upgrade
Contact the Patriot support team to begin the upgrade process. The support team will issue a new 6.12 licence file and enable 6.12 downloads.
The 6.12 update is available on both the latest and stable channels from the Patriot Support Portal. An existing 6.11 system can be upgraded with the standard updater, so a new Patriot install is not required.
Patriot 6.12 has continued to receive changes since its initial release. Review the update changelog for additional important information before applying the update.
Upgrading
Checklist
- Patriot 6.11.43.1 or later installed
- .NET 8 runtimes installed on all Data Service and Task Service machines
- Patriot Configurator installer placed on all Data Service and Task Service machines
- Required Task Service components installed
- 6.12 Licence obtained
- Patriot 6.12 Updater downloaded
Install Licence
Copy the new 6.12 licence file into the Patriot Data Service installation folder.
Backup and remove the existing 6.11 licence before copying in the new Patriot 6.12 licence file.
Apply Update
Follow the standard Update Procedure to perform the upgrade. The Patriot 6.12 updater will upgrade the existing Patriot install.
Automatic Workstation Updates are not supported for major version upgrades. The update must be run on each operator workstation to upgrade the Patriot client.
Upgrade Configurator
Once Patriot has been upgraded, install the new Patriot 6.12-compatible Configurator on each service machine.
Deferring Upgrade
Please notify the Patriot support team if the upgrade is delayed or cancelled for any reason, so that the support team has an accurate record of which version is in use.