Contact Us 1-800-596-4880

Replace a Mule License Key

When your Mule license expires, you must replace your Mule license key. Also use this procedure if you entered an incorrect license key during installation.

Perform the following steps on the controller node used to start the installation. For Azure and AWS installations, this node is named rtf-controller-1 by default.

Install rtfctl

The rtfctl utility is required to replace your Mule license key on Runtime Fabric. Follow the steps in Install rtfctl before continuing.

Procedure

  1. Base64 encode the new Mule .lic license file provided by MuleSoft:

    • On MacOS, run the following command in the terminal:

      base64 -b0 license.lic
    • On Unix, run the following command:

      base64 -w0 license.lic
    • On Windows, a shell terminal emulator (such as cygwin) or access to a Unix-based computer is required.

      1. Transfer to your Unix environment if necessary.

      2. Run the following command to Base64 encode the license key:

        base64 -w0 license.lic
  2. On the controller node acting as the leader during installation (the installer node), use the rtfctl utility with the Base64 value of your license key. For more information on the rtfctl command, refer to rtfctl commands.

    sudo ./rtfctl apply mule-license BASE64_ENCODED_LICENSE
  3. To verify the Mule license key has applied correctly, retrieve the contents using the rtfctl utility:

    sudo ./rtfctl get mule-license

See Also