Mule ライセンスキーの置き換え

Mule ライセンスの期限が切れた場合、Mule ライセンスキーを置き換える必要があります。また、インストール中に正しくないライセンスキーを入力した場合もこの手順を使用します。

インストールを開始するために使用したコントローラーノードで次の手順を実行します。Azure および AWS インストールでは、このノードの名前はデフォルトで ​rtf-controller-1​ に設定されます。

rtfctl のインストール

Runtime Fabric の Mule ライセンスキーを置き換えるには、​rtfctl​ ユーティリティが必要です。続行する前に、​rtfctl をインストール​する手順を実行します。

rtfctl​ バイナリが現在の作業ディレクトリとユーザーの ​$PATH​ に存在することを確認します。

特権ユーザーとして ​rtfctl​ コマンドを実行します。

手順

  1. MuleSoft から提供された新しい Mule ​.lic​ ライセンスファイルを Base64 でエンコードします。

    • MacOS では、次のコマンドをターミナルで実行します。

      BASE64_ENCODED_LICENSE=$(base64 -b0 -i license.lic)
    • Unix では、次のコマンドを実行します。

      BASE64_ENCODED_LICENSE=$(base64 -w0 license.lic)
    • Windows では、次のいずれかを選択します。

      • base64 ツールが含まれる WSL または Cygwin シェルを使用し、上記の Unix コマンドを使用します。

      • Windows git (​C:\Program Files\Git\usr\bin​) と一緒に含まれている ​base64.exe​ プログラムを使用します。

      • 次の Powershell コマンドを使用します。

        $BASE64_ENCODED_LICENSE=[convert]::ToBase64String((Get-Content -path "license.lic" -Encoding byte))
  2. rtfctl​ ユーティリティを使用して、ライセンスキーの Base64 値を適用します。​rtfctl​ コマンドについての詳細は、​「rtfctl のコマンド」​を参照してください。

    rtfctl apply mule-license $BASE64_ENCODED_LICENSE
  3. Mule ライセンスキーが正しく適用されたことを確認するには、​rtfctl​ ユーティリティを使用してコンテンツを取得します。

    rtfctl get mule-license
最新の変更済みライセンスを取得するには、Runtime Fabric Mule アプリケーションを再起動する必要があります。

ライセンスの有効期限の取得

GET​ fabric API ​(/organizations/{organizationId}/fabrics/{id})​ の応答には、省略可能な ​licenseExpiryDate​ 項目が含まれます。

{
    "id": "fabric_id",
    "name": "anna-qa-gke-rtf-1",
    "region": "us-east-1",
    "vendor": "gke",
    "vendorMetadata": {},
    "organizationId": "organization_id",
    "version": "2.2.9",
    "status": "Active",
    "desiredVersion": "2.2.9",
    "availableUpgradeVersion": "2.2.29",
    "createdAt": 1679684859167,
    "secondsSinceHeartbeat": 192,
    "kubernetesVersion": "v1.24.11-gke.1000",
    "licenseExpiryDate": 1653523200000,
    "isManaged": false,
    "isHelmManaged": true,
    "clusterConfigurationLevel": "production",
    "features": {
        "enhancedSecurity": true,
        "persistentStore": false
    },
    "ingress": {
        "domains": []
    }
}

Runtime Fabric の ​[Mule License Expiry Date (Mule ライセンス有効期限)]​ は Runtime Manager UI でも公開され、​[License is expiring soon (ライセンスの有効期限がもうすぐ切れます)]​ という警告通知が伴います。

「Mule License Expiry Date (Mule ライセンス有効期限)」 の警告通知が含まれる Runtime Manager UI