Upgrading Mule Runtime and Connectors

This guide walks you through upgrading your Mule projects, covering both intra-version upgrades within Mule 4 and major migrations from Mule 3 to Mule 4.

1. Upgrading Within Mule 4 (e.g., 4.4 to 4.9)

To upgrade a Mule project from one Mule 4 version to another:

1. Select Repository

   • Open the repository selector and choose the one you want to upgrade.

2. Provide Upgrade Prompt

   • In the description field, add a prompt like: “Upgrade the Mule flow from version 4.4 to 4.9.”

3. Configure Runtime Settings

   • Choose your desired Mule version and runtime configurations.

4. Submit Upgrade

   • Click Submit. The upgrade process will be handled automatically.

5. Review Upgrade Output

   • Once processed, the tool shows the changes, including:
     • Updates to the mule-artifact.json indicating new runtime version.
     • Updates in pom.xml covering dependencies and connectors.

6. Approve or Provide Feedback

   • You can review the diff and:
     • Leave comments if changes are needed.
     • Click Approve if satisfied with the update.

---

2. Migrating from Mule 3 to Mule 4

To migrate a Mule 3 project to Mule 4:

1. Access the Migration Accelerator

   • Navigate to the Migration Agents tab.
   • Select the repository and branch for migration.

2. Select Platform and Submit

   • Choose MuleSoft 3 from the platform dropdown.
   • Click Submit to start migration.

3. Migration Automation

   • The system upgrades your project for Mule 4 compatibility.
   • Some input may be needed (e.g., endpoint selections).

4. Endpoint Configuration

   • You’ll be asked to choose the endpoint (e.g., getServiceHealth) to migrate.

5. Code Generation

   • After selection, Mule 4 compatible code is generated automatically.
   • Example: mule-artifact.json updated with version 4.9.0.3.

6. Download Output

   • You can download:
     • Migrated code
     • Updated pom.xml
     • Patch files
     • Generated API spec and migration documentation

---

Summary

Both runtime upgrades and full-scale migrations are handled automatically, with options for feedback, manual approval, and final download. The upgrade system ensures your Mule projects stay up-to-date with minimal manual intervention, while preserving compatibility and version integrity.