Upgrading From 6.13 to 6.14
The upgrade from Patriot 6.13 to Patriot 6.14 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.13 version must be installed before beginning the upgrade. Ensure that Patriot 6.13.12.1 or later is installed.
.NET Runtime
Patriot 6.14 requires .NET 10 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.14.
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 10 Runtime and the .NET 10 Runtime.
- For machines running only the Patriot Task Service, only the .NET 10 Runtime is required.
- For task services running on 64bit operating systems, the x86 32bit .NET 10 Runtime is also required, to support tasks running in 32bit mode.
Install the latest .NET 10.0.x version of each Runtime to receive the latest security fixes and other improvements from Microsoft.
SQL Server Minimum Version
Microsoft SQL Server 2016 SP3 and 2017 are no longer supported by Patriot 6.14. Patriot 6.14 supports SQL Server version 2019 and later.
If a Microsoft SQL Server upgrade is required, using the latest release of SQL Server will maximise the supported SQL product lifespan.
Encrypted Service Communication Changes
Two Data Service communication options have changed in Patriot 6.14:
- Encrypted now uses HTTPS, replacing the previous Windows-based encryption. Where this option is in use, a TLS certificate is required, and must be created and trusted by all workstations and task services before upgrading.
- Alternative Authentication is no longer supported.
See Service Communication - Encryption for more information.
Enabling Task Service Validation using API keys is also recommended.
Workstation Scheduled Reports
Scheduling automatic reports to run via a workstation is no longer supported. Any reports using the legacy client mode must be migrated to a Reports Task before upgrading.
Integration Legacy Features
The Display Legacy Features System-Wide Setting has been dropped, along with all the associated legacy features. If these features are in use, contact the Patriot support team before upgrading.
Preparation
Request Upgrade
Contact the Patriot support team to begin the upgrade process. The support team will issue a new 6.14 licence file and enable 6.14 downloads.
The 6.14 update is available on both the latest and stable channels from the Patriot Support Portal. An existing 6.13 system can be upgraded with the standard updater, so a new Patriot install is not required.
Patriot 6.14 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.13.12.1 or later installed
- .NET 10 runtimes installed on all Data Service and Task Service machines
- SQL Server 2019 or later installed
- TLS certificate created and trusted on all workstations and task services, if using the Encrypted option
- Workstation scheduled reports migrated to a Reports Task, if in use
- 6.14 Licence obtained
- Patriot 6.14 Updater downloaded
Install Licence
Copy the new 6.14 licence file into the Patriot Data Service installation folder.
Backup and remove the existing 6.13 licence before copying in the new Patriot 6.14 licence file.
Apply Update
Follow the standard Update Procedure to perform the upgrade. The Patriot 6.14 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.
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.