Edge
Update Patches to Mule
Patch updates are cumulative releases that include the latest bug fixes and security enhancements to a specific patch (x.y.z) version, plus all previously released features and fixes for that patch version.
A patch update version appends an update identifier such as -20210622
to
the release version, for example, 4.3.0-20210622
for the Mule 4.3.0 release.
You can find release notes for monthly Mule runtime engine patch updates in
MuleSoft Release Note Summary by Month.
For Mule 4.5 and later, the version naming convention for CloudHub, CloudHub 2.0, and Runtime Fabric changes following the schema for the new release channels, Edge and Long-term Support (LTS).
Major[numeric] . Minor[numeric] . Patch[numeric] : Build[numeric] Channel[e for edge, nothing for LTS]
Here are examples of the version numbers:
-
Edge: 4.5.0:1e
-
Edge: 4.6.0:1e
-
LTS: 4.6.0:1
In the case of Standalone (On-Premises), the Mule runtime versioning changes from date-based, for example, 4.4.0-20230317
to semVer as:
Major[numeric] . Minor[numeric] . Patch[numeric]
Here are examples of the version numbers:
-
4.5.1
-
4.5.2
-
4.5.3
Patch Update Schedule
For Mule 4.5 and Later Versions
Starting with Mule 4.5, MuleSoft introduces two new release channels, Edge and Long-term Support (LTS). Both release channels are available in all our deployment models: Anypoint Runtime Fabric, CloudHub, CloudHub 2.0, and Hybrid Standalone. Consider the following factors to determine the approach that best suits your requirements ahead of the Mule 4.4 End of Standard Support.
Channel Type | Release Cadence | Recommended Customer Profile | Differentiators | Support Coverage |
---|---|---|---|---|
Three times per year:
|
|
|
For versions 4.5 to 4.7:
For version 4.8 and later:
|
|
LTS |
Annual:
|
On-premises:
|
|
For version 4.6 and later:
|
In February, both Edge and LTS release with the same underlying version, including a minor Mule runtime version and new features.
For Mule 4.4. and Previous Versions
Each month, MuleSoft releases updates to selected Mule patch releases. In some cases, MuleSoft also releases updates outside of this timeframe, typically to expedite the delivery of more critical security updates.
Update strategies differ by product.
On-premises (Standalone) Mule | CloudHub | Anypoint Runtime Fabric | |
---|---|---|---|
On the first full week of the month, updates to Mule patches are available. MuleSoft provides updates only for patch versions that received bug fixes or security enhancements for the month. |
Yes |
Yes |
Yes |
You can continue to use a previous update to a Mule patch until the third full week of the month after the latest patch update is released. |
Yes |
Yes |
Yes |
Your new deployments require use of the latest patch update during the third full week of the month. |
No |
Yes |
Yes |
On the third full week of the month, MuleSoft automatically updates existing applications to the latest patch update of Mule. |
No |
Yes
See the monthly update schedule in CloudHub Runtime and Operating System Patch Update Release Notes. |
On-premises Mule, CloudHub, and Anypoint Runtime Fabric updates for a given Mule patch version receive the same Mule runtime engine fixes and enhancements. However, CloudHub and Anypoint Runtime Fabric patches can contain additional fixes and improvements that are specific to those products.
Apply Patch Updates
Before updating the patch version on which you are running your Mule applications, review the patch update schedule.
The update procedure and schedule differ by deployment environment, whether on-premises, CloudHub, or Anypoint Runtime Fabric. To perform the update, see:
Apply a Patch Update to an On-Premises (Standalone) Mule
For standalone Mule instances, which are hosted on-premises, you can use the Mule Upgrade Tool to automate the patching process or you can apply the patch manually to the instance.
MuleSoft typically releases monthly updates to the latest Mule minor versions and sometimes to earlier versions of Mule. Each Mule runtime patch update is posted to Release Note Summary by Month.
It is important to note that for on-premise deployments, a single instance of Mule can run one or more applications. When you patch an instance of Mule, the update applies simultaneously to all the applications deployed to that instance.
Standalone Mule installations do not undergo forced updates, but MuleSoft recommends that you apply the latest upgrades each month updates are available to benefit from the latest fixes and security enhancements.
For on-premises (standalone) Mule instances:
Download Standalone Mule for On-Premises Deployments
On the first full week of the month you can download new versions of updated Mule from your customer portal in the Help Center.
The portal provides links to full Mule distributions that apply the latest patch:
-
Installation files that follow the filename convention
mule-ee-distribution-standalone-x.y.z-YYYMMDD.zip
(for example,mule-ee-distribution-standalone-4.3.0-20210622.zip
) are for new Mule installations, rather than updates to existing installations. These installations contain all fixes and enhancements up to the specified month and year.If you need to install a full instance of Mule instead of applying a patch update to an existing Mule instance, unzip the file, and set the
MULE
environment variable. For general guidance, see Download, Install, Configure, and Upgrade Mule.