Skip to main content
xorlab follows semantic versioning using the Major.Minor.Patch format. For example, X.Y.2 means patch no. 2 to minor release Y of major version X of the software.
Prerequisites
xorlab follows semantic versioning using the Major.Minor.Patch format. To apply only a patch increment, see Upgrading to a Patch Release instead.
Wait for Release AnnouncementReleases are always rolled out gradually to SaaS customers first and are closely monitored for any unexpected issues. For xorlab on-prem, please wait to upgrade until the release has been officially announced via email.

​
Release support lifecycle

xorlab follows a time-based release support lifecycle. Each major release is supported for 9 months after its initial public release. Customers are expected to upgrade xorlab at least twice per year to remain within a supported release. Please refer to the Release Lifecycle Support page to verify support timelines and end-of-support dates.

​
Reading the changelog

Before starting with the upgrade, read through the most important parts of the Changelog:
  1. Read the Highlights
  2. Read the Breaking Changes

​
Upgrade xorlab

To upgrade xorlab, run the following command as the admin user on all xorlab hosts in the provided order:
Upgrade order:
  1. Sandbox (only applicable for on-prem DANA appliances)
  2. XCC
  3. MTA
After you ran the command on all hosts, the upgrade is finished. You can use docker ps on each host to verify that the new version is running.

​
Post-upgrade check

After the upgrade, review the migration logs for any warnings or errors that may occur. To do this, use the following link (be sure to replace <xcc_domain:xcc.customer.tld> with your actual XCC domain in the browser):

​
New features configuration

After upgrading, review the documentation pages below for the new features introduced in this release and apply configurations as needed.
  • The SSQ now supports archiving emails. By default, all SSQ users get access to this functionality. However, if you use custom roles, make sure to add the permission xcc_quarantine_archive to any role that should have access to this feature.
  • By default, all analyst users have access to the retrospective email scanning feature. If you use custom roles, add the xcc_mail_import_read permission to let users view the status of import jobs, or xcc_mail_import_update to let them manage import jobs.

​
Troubleshooting

If you experience issues or have questions, refer to the support documentation or contact our support team at support@xorlab.com.