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 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,
    "nodes": [
        {
            "uid": "50f344a7-a982-4380-b6ab-7cc8f26881ab",
            "name": "gke-cluster-1-default-pool-f4437ec2-7lkq",
            "kubeletVersion": "v1.24.9-gke.3200",
            "dockerVersion": "containerd://1.6.9",
            "role": "worker",
            "status": {
                "isHealthy": true,
                "isReady": true,
                "isSchedulable": true
            },
            "capacity": {
                "cpu": 0,
                "cpuMillis": 940,
                "memory": "2812Mi",
                "memoryMi": 2812,
                "pods": 110
            },
            "allocatedRequestCapacity": {
                "cpu": 0,
                "cpuMillis": 676,
                "memory": "2075Mi",
                "memoryMi": 2075,
                "pods": 9
            },
            "allocatedLimitCapacity": {
                "cpu": 2,
                "cpuMillis": 2383,
                "memory": "2940Mi",
                "memoryMi": 2940,
                "pods": 9
            }
        },
        {
            "uid": "31b86558-8009-44d9-985a-094952c11a78",
            "name": "gke-cluster-1-default-pool-f4437ec2-9mz7",
            "kubeletVersion": "v1.24.9-gke.3200",
            "dockerVersion": "containerd://1.6.9",
            "role": "worker",
            "status": {
                "isHealthy": true,
                "isReady": true,
                "isSchedulable": true
            },
            "capacity": {
                "cpu": 0,
                "cpuMillis": 940,
                "memory": "2812Mi",
                "memoryMi": 2812,
                "pods": 110
            },
            "allocatedRequestCapacity": {
                "cpu": 0,
                "cpuMillis": 708,
                "memory": "1310Mi",
                "memoryMi": 1310,
                "pods": 8
            },
            "allocatedLimitCapacity": {
                "cpu": 0,
                "cpuMillis": 900,
                "memory": "2040Mi",
                "memoryMi": 2040,
                "pods": 8
            }
        },
        {
            "uid": "a2e5d50b-e8a8-45df-a278-4bba4d30619f",
            "name": "gke-cluster-1-default-pool-f4437ec2-gr6e",
            "kubeletVersion": "v1.24.9-gke.3200",
            "dockerVersion": "containerd://1.6.9",
            "role": "worker",
            "status": {
                "isHealthy": true,
                "isReady": true,
                "isSchedulable": true
            },
            "capacity": {
                "cpu": 0,
                "cpuMillis": 940,
                "memory": "2812Mi",
                "memoryMi": 2812,
                "pods": 110
            },
            "allocatedRequestCapacity": {
                "cpu": 0,
                "cpuMillis": 488,
                "memory": "1350Mi",
                "memoryMi": 1350,
                "pods": 12
            },
            "allocatedLimitCapacity": {
                "cpu": 1,
                "cpuMillis": 1670,
                "memory": "2230Mi",
                "memoryMi": 2230,
                "pods": 12
            }
        }
    ],
    "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