Planning your upgrade from 10.2 Patch 24+ to 10.3 ahead will help minimize the impact on operations and prevent emergency troubleshooting. Perform the upgrade during a scheduled maintenance window in your off-peak hours.
You can upgrade from 10.2 Patch 24 and later. To upgrade from an earlier version, you must first upgrade to 10.2 Patch 24, and then to 10.3.
Your MyQ provider can perform the upgrade for you or assist you with the procedure. This will minimize the downtime of your printing and document processing services.
Prepare For Upgrade
Before upgrading, verify that your server meets the hardware and software requirements, including free storage requirements, and that you have an active Software Assurance plan. Make sure that the additional packages or applications that are used in the your environment are available and are compatible with MyQ X 10.3.
Check Software Assurance Validity
The minimum support requirement is the Standard Software Assurance plan, with validity to date stated in the release notes. You must have a valid software assurance plan before you upgrade.
To check the validity of your software assurance plan, go to MyQ > Settings > License. If your plan has expired, purchase and activate the new plan and then perform the upgrade.
Free Storage Requirements
During the upgrade process, migration of the data and log databases can require significantly more storage space. Verify that both the system volume (which stores temporary files) and the application data volume have at least four times the storage space available than the total size of the data and log databases.
We strongly recommend using an SSD hard drive for the installation of both the program and data parts of the application.
To view your current storage usage, check the size of your application data folder. The default location is C:\ProgramData\MyQ, or view the location in Easy Config > Settings > Data folder.
The database files are MYQ.fdb and MYQLOG.fdb.
Running out of storage during an upgrade can break your MyQ server and may make the host operating system unstable.
Customizations and Custom Reports
If any customizations are running in the current installation, such as customized reports, scripts, or anything else that is not included in the standard setup, contact MyQ support first to verify whether they are compatible with version 10.3.
After finishing the upgrade, verify the MyQ Main Log to observe any errors and warnings, including those about incompatible customizations, and also test the customized functionality yourself.
Order of Component Upgrades
In a Central-Site configuration, always upgrade the Central Server before the Site Servers. Older Site Server versions continue to work with a newer Central Server, so sites can be upgraded gradually.
Upgrade MyQ components, as they apply to your environment, in the following order:
-
Central Server
-
Print Server (Standalone and Site Servers)
-
Other server applications – e.g. Mobile Print Agent, MyQ Document Processor, Scan Review.
-
Client applications – Desktop Client, Mobile Client, etc.
Always upgrade server components before client applications. Newer servers remain backward compatible with older clients and Site Servers, but the reverse is not guaranteed – upgrading clients before servers may cause issues due to backend changes such as REST API updates or new compatibility requirements.
Replace Helper URL in Manually Connected Cloud Services
MyQ X 10.3 uses a new helper URL for cloud services.
If your organization has registered applications in third-party cloud services that are configured in Manual mode (in MyQ > Settings > Network > Connections), you must update those registered applications with the new helper URL (helper2.myq-solution.com) before upgrading to ensure uninterrupted service.
Migrate Custom Traefik Rules
MyQ X 10.3 upgrades the bundled Traefik reverse proxy from c2.x to v3.6.x. The MyQ configuration is migrated automatically, but custom rules must be migrated manually.
These rules are in the file traefik.custom.rules.yaml in your application data folder (default location is C:\ProgramData\MyQ\). If that file is absent or empty, no action is needed. If you maintain custom rules, you must modify them to use Traefik v3 syntax before upgrading. For more information, see Migrate Custom Traefik Rules.