---
schema_version: "1"
id: a08d7f2927c64de1771103570fff97e949ac2369790cc34870e046732d36e75b
title: Upgrading Runtime Fabric Using rtfctl
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/runtime-fabric/2.5/upgrade-self-managed.md
canonical_url: https://docs.mulesoft.com/runtime-fabric/2.5/upgrade-self-managed
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 7b6910568c9b81758eb443bcd32aac81063ffda6197c2a35e08043d11c2f1a9a
description: MuleSoft Documentation Site
release: "2.5"
latest: false
---
---
product: Runtime Fabric
version: 2.5
---

# Upgrading Runtime Fabric Using rtfctl

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

You can use the Runtime Fabric command line tool, `rtfctl`, to upgrade Anypoint Runtime Fabric on an
Amazon Elastic Kubernetes Service (Amazon EKS), Amazon Elastic Kubernetes Service Anywhere (Amazon
EKS-A), Azure Kubernetes Service (AKS) or Google Kubernetes Engine (GKE).

## About Component Upgrades

Upgrading Runtime Fabric components means upgrading services that:

- Facilitate communication to the control plane

- Provide load balancing

- Log and forward metrics

When component upgrades are available, you apply the upgrades within Runtime Manager via a button
that’s visible when an upgrade is available.

Runtime Fabric component upgrades do not require adding a node.

### Determine the Component Versions You Are Using

From a local workstation that has a `Kubeconfig` file and can access Kubernetes, or from a support
bastion, run the following command:

```copy
.rtfctl version
```

The output looks something like this:

```none
$ ./rtfctl version
COMPONENT    VERSION
rtfctl       0.3.122
agent        1.9.6
kubernetes   1.19.6-eks-49a6c0
```

- The `rtfctl` field shows the `rtfctl` command-line utility version.

- The `agent` field shows the the Runtime Fabric component version.

> [!NOTE] The Runtime Fabric component version that is in use is also displayed in the **Runtime
> Fabrics** tab in Runtime Manager. If an upgrade is available, Runtime Manager displays an
> **Upgrade to vx.x** message.

## About rtfctl Command-Line Utility Upgrades

Use the `rtfctl` command-line utility to manage Runtime Fabric and perform upgrades.

Upgrade the `rtfctl` utility from the command line.

Always use the most current version of the `rtfctl` command-line utility to ensure you have the
latest functionality.

## Apply the Upgrades

To upgrade Anypoint Runtime Fabric, you:

1.  Upgrade Runtime Fabric Components

2.  Upgrade the `rtfctl` command-line utility

Before upgrading your production environment, perform these steps on a nonproduction Runtime Fabric
instance to verify compatibility with your environment. Plan to upgrade when your team is not
deploying new applications or managing existing applications on Runtime Fabric. When your
nonproduction upgrade succeeds, perform these steps in your production environment.

### Upgrade Runtime Fabric Components

Review the
[Anypoint Runtime Fabric Release Notes](https://docs.mulesoft.com/release-notes/runtime-fabric/runtime-fabric-release-notes-2.x.x)
information to learn more about the most recent component versions.

1.  Navigate to your Runtime Fabric by selecting it on the **Runtime Fabrics** tab in Runtime
    Manager.

2.  Select **Upgrade to vx.x**. The status of the Runtime Fabric is updated to show that the upgrade
    procedure is in progress.

3.  Wait for the status to transition to **Active**.

In most cases, the upgrade takes fewer than 10 minutes. When the status transitions to **Active**
and the version of the Runtime Fabric reflects the new version, the component upgrade is complete.

If the Runtime Fabric and Runtime Manager connection disconnects during the upgrade, connectivity is
restored after the upgrade finishes.

After the upgrade, it’s normal for Runtime Fabric to report as “degraded” for a few minutes as it
synchronizes with the control plane. This state automatically resolves after approximately five
minutes.

### Upgrade the `rtfctl` Command-Line Utility

1.  From your terminal, run the following command:

    ```copy
    curl -L https://anypoint.mulesoft.com/runtimefabric/api/download/rtfctl/latest -o rtfctl
    ```

2.  Change file permissions for the `rtfctl` binary:

    ```copy
    chmod +x rtfctl
    ```

3.  Alternatively, to update `rtfctl` in place as a user who owns the `rtfctl` binary, run:

    ```copy
    `rtfctl update`
    ```