+

We are no longer updating this version of the documentation. You can switch to the latest version, or use the version selector in the left navigation.

Install rtfctl

Install the rtfctl utility to locally manage Runtime Fabrics. The rtfctl utility supports the following actions:

  • Get the status of a Runtime Fabric.

  • Perform a heap dump or a thread dump of a running application.

  • Display memory usage of a running application.

  • Manage proxy settings.

  • Manage secure properties.

  • Manage a Mule license.

  • Manage the alert sender email address.

Install rtfctl

To perform this procedure, you must have root privileges to a controller node running Runtime Fabric.
  1. Download the latest version of the rtfctl command-line utility:

    1. On a controller node, use your terminal to run the following command:

      cd /opt/anypoint/runtimefabric
      sudo curl -L https://anypoint.mulesoft.com/runtimefabric/api/download/rtfctl/latest -o rtfctl
    2. Change file permissions for the rtfctl binary:

      sudo chmod +x rtfctl

Supported Commands

Table 1. Supported rtfctl commands
Command Description

appliance

Specifies an appliance on which to perform operations.

apply

Applies changes to a Runtime Fabric configuration.

backup

Backs up the local Runtime Fabric state.

disk

Displays the disk space used by an application.

get

Displays one or more resources.

heapdump

Triggers a JVM heap dump.

help

Displays help for a command.

memory

Displays the JVM memory usage in a pod.

package

Creates a debugging information package for an application.

ping

Tests network connectivity.

report

Generates a diagnostics report.

restart

Restarts an application.

restore

Restores the local Runtime Fabric state from a backup.

status

Displays status of Runtime Fabric.

test

Tests Runtime Fabric environment.

threaddump

Displays the JVM thread dump for an application.

update

Updates rtfctl.

upgrade-cluster

Upgrades the Runtime Fabric cluster.

version

Displays version information.

Table 2. rtfctl Flags
Flag Description

-h, --help

Displays rtfctl help information.

-n, --namespace string

If present, displays the namespace scope.

--pod string

If present, displays the pod name.

Usage

  • To list all supported commands, run rtfctl -h.

  • For more information about a specific command, run rtfctl <command> -h.

  • To install a Mule license:

    1. Make sure to base64 encode the license, following the instructions in Base64 Encode your Mule License Key.

    2. Run the following command:

      $ sudo ./rtfctl apply mule-license '<license-key-information>'
      Updating rtf namespace... OK
Was this article helpful? Thanks for your feedback!
View on GitHub