使用状況メーターのアップグレードとライセンスキーの交換

販売終了 ：2025年10月31日をもって、新規のお客様による「 VMware Solutions 」サービスの新規導入は利用できなくなります。 既存のお客様は、引き続き IBM Cloud® 上で、稼働中の VMware® ワークロードを利用・拡張することができます。 詳細は VMware 、マーケティング終了 IBM Cloud を参照。

既存の VMware vCloud 使用量メーターを、バージョン 9.x 以降にアップグレードしてください。 VMware vCloud Usage Meterの最新バージョンは v9.1.0 です。 Usage Meter（ v4.8 ）の場合、アップグレード手順は、 IBM Cloud Usage Meter ポータルを通じて現在登録されている Usage Meter のアクセストークンを取得し、その後、 v9.0.1 へのインプレースアップグレードをまず行うという流れになります。 v9.0.1 への最初のアップグレード後は、 v9.x 以降へのさらなるアップグレードを行う際に、アクセストークンを指定する必要はありません。

Usage Meter v4.8 については、Usage Meter v4.8 から v9.1 への直接のアップグレードはサポートされていません。 まず、バージョン 4.8 からバージョン 9.0.1 にアップグレードし、その後、バージョン 9.1 にアップグレードする必要があります。 詳細については、「 アップグレードパス - 製品相互運用性マトリックス 」を参照してください。

バージョン 9 以降にアップグレードする前に、 VMware Cloud Foundation™ ( VCF ) ライセンス・キーを交換する必要があります。

ライセンスキーの交換手順

  1. 新しい Broadcom ライセンス・キーを取得し、 VMware Solutions コンソールから VMware Cloud Foundation ( VCF ) ライセンス・キーを取得します。 詳細については、 VCF ライセンスキーの取得を 参照してください。
  2. VMware アドオンキーを入手する。 詳細については、 VMware アドオンキーの入手を 参照のこと。
  3. 新しいライセンスキーをすべての VMware 製品に追加し、必要に応じてライセンスを割り当てます。 詳細については、 VMware 製品ライセンスの管理を 参照してください。

使用量メーターのアップグレード手順

Usage Meter をアップグレードするには、以下の手順を実行してください：

SSHログインを有効にする

  1. VMware vCloud Usage Meter アプライアンス管理コンソールに usagemeter ユーザーで https://<Usage Meter IP>:5480 からログインする。
  2. 左側のナビゲーションパネルから「 アクセス 」をクリックします。
  3. アクセス設定 ]で右上の[ 編集] をクリックします。
  4. Edit access settings（アクセス設定の編集） ウィンドウで、 Enable SSH login（SSHログインを有効にする ）スイッチをオンに切り替えます。 SSHログインが「 有効 」に変わる。

アップグレードISOファイルのマウント

  1. 以下のリンクから「Usage Meter」のISOファイルをダウンロードしてください：

    • Usage Meter v4.8 （またはそれ以前のバージョン）から v9.0.1 へアップグレードするには、 https://ibm.biz/~V0YiDk0EP をご利用ください。
    • 「Usage Meter v9.0.1 」から「 v9.1.0 」へアップグレードするには、 https://ibm.biz/~aBF0Bw0fU をご利用ください。

  2. 以下の SHA-256 の値に基づいて、 SHA-2 のチェックサムを検証してください：

    • 「Usage Meter v4.8 」（またはそれ以前のバージョン）から「 v9.0.1 」へのアップグレードについては、 ec5c46b4bdae915cb4a289dfbb03077cb802f404692bb3f2501b59b448102797 を参照してください。
    • 「Usage Meter v9.0.1 」から「 v9.1.0 」へのアップグレードについては、 d1f79f1bcc711c7753c871bd95bc434e8a31bb8fc584fc7ac88b75398be445c1 を参照してください。

    Windows® でコマンドプロンプトを、 Linux® および MacOS でターミナルウィンドウを開き、次のコマンドを実行してください：

    • Windows の場合: certutil -hashfile <path-to-iso-file> SHA256
    • Linux の場合: sha256sum <path-to-iso-file>
    • macOS の場合: shasum -a 256 <path-to-iso-file>

  3. VMware vSphere® Web Clientで、 vCenter Serverインスタンスにログインします。

  4. ストレージ ］メニューで、使用量計仮想マシン（ VM ）が配置されているデータストアを選択します。

  5. VMs ］タブで［ Virtual machines ］をクリックし、［Usage Meter］がターゲットのデータストアにあることを確認します。

  6. Files タブで、 Upload filesをクリックします。 ISOファイルのアップロードが始まる。

    ホスト証明書に関するエラーが表示される場合があります。 この問題を解決するには、エラーに表示されている指定された URL を別のウェブブラウザのタブで開き、証明書を受け入れます。 ロードされない場合は、ホストが現在のデスクトップDNSにあることを確認し、 URL。

  7. アップロードが完了すると、ISOファイルがファイルリストに表示されます。

  8. ホストとクラスタ ]メニューで、[使用量メーター] VM を見つけて右クリックし、[ 設定の編集 ]を選択します。

  9. 仮想ハードウェア] タブの [ CD/DVD ドライブ ] で [ データストア ISO ファイル ] を選択し、[ OK] をクリックします。

    CD/DVDドライブのオプションが表示されていない場合は、[ 新しいデバイスを追加] をクリックします。

  10. Select file ウィンドウで、ISOファイルをアップロードしたデータストアを探します。

  11. ISOファイルを選択し、「 OK 」をクリックしてください。

  12. Edit settings ウィンドウの Virtual hardware タブで、 Connected チェックボックスを選択し、 OKをクリックする。

アップグレードコマンドの実行

利用状況メーターのアップグレードコマンドを実行する前に、以下の手順を完了してください：

  1. VMware vSphere® Web Clientで、 vCenter Serverインスタンスにログインします。
  2. ホストとクラスタ ]メニューで、[使用量メーター] VM を見つけて右クリックし、[ 設定の編集 ]を選択します。
  3. 仮想ハードウェア] タブの[ CD/DVDドライブ ]で、[ 接続済み] チェックボックスをオフにし、[ OK] をクリックします。
  4. ホストとクラスタ ]メニューで、[使用量メーター] VM を見つけて右クリックし、[ スナップショット]>[スナップショットを取得] を選択します。
  5. スナップショットの名前を入力し、「 作成 」をクリックします。

SSHを使用して使用量計アプライアンス VM にログインし、以下の手順を実行します：

  1. Windowsではコマンドプロンプトを、 Linux と MacOS ではターミナルウィンドウを開き、 root ユーザーとして以下のコマンドを実行する：

    1. mkdir /root/upgrade
    2. mount -o loop /dev/cdrom /root/upgrade
    3. bash /root/upgrade/upgrade-um.sh

    利用状況メーターをアップグレードするために mount -o loop /dev/cdrom /root/upgrade を実行する前に、 umount /root/upgrade を実行して以前のアップグレードをアンマウントする必要があるかもしれません VM。

  2. IBM Cloud® for VMware Solutions コンソールに、利用状況メーター用に生成されたアクセストークンを入力します。 詳しくは、 使用量メーターを IBM に登録するを ご覧ください。

  3. VCF IBM のプロバイダ組織の一部となることに同意する場合は、 y を入力してください。

  4. スナップショットが使用量メーター VM に作成されることを確認するには、 y を入力します。

    Usage Meterのホスト名に関するエラーメッセージが表示される場合があります。 アップグレードパスを続行するには y を入力します。

  5. アップグレードプロセスが開始され、完了したら y を入力して Usage Meter VM を再起動します。

  6. 再起動が完了したら、ウェブブラウザでUsage Meter URL を開き、ログインしてアップグレードされたバージョンを確認します。 次に、使用量計アプライアンスの健全性を確認する。

Usage Meter VM を移行した後、アップグレード処理中にエラー Connection control operation failed for disk が発生することがあります。 この問題は、マウントされたCD/DVDデバイスのロックを保持するアクティブなスナップショットが原因で発生する可能性があります。 この問題を解決するには、以下の手順のいずれかを実行してください。 しかし、 VM の移行を成功させるためには、これらすべてを完了させる必要があるかもしれません。

  1. 既存のスナップショットをすべて削除します ：

    1. VMware vSphere Web Client で、管理者として vCenter Server インスタンスにログインします。
    2. ホストとクラスタ ]メニューで、[使用量メーター] VM を選択します。
    3. スナップショット］ タブで ［すべて削除］を選択するか、CD/DVDドライブがマウントされているスナップショットを指定して ［削除］を選択します。
    4. 「OK」 をクリックします。

  2. マウントされているドライブを外す ：

    1. vSphere Web Client で、管理者として vCenter Server インスタンスにログインします。
    2. ホストとクラスタ ]メニューで、[使用量メーター] VM を見つけて右クリックし、[ 設定の編集 ]を選択します。
    3. ISOアップグレードファイルをマウントしたCD/DVDドライブのボックスをクリアします。
    4. 「OK」 をクリックします。

  3. マウントされているドライブをホストされているESXiから切り離します ：

    1. vSphere Web Client で、管理者として vCenter Server インスタンスにログインします。
    2. ホストとクラスタ ]メニューで、[使用量メーター] VM を選択します。
    3. Summary] タブで、 [Related]オブジェクトを探し、 VM がどのホストにあるかを確認する。
    4. rootまたは管理者としてESXiホストにログインします。
    5. 仮想マシンを選択し、リスト内のUsage Meter VM を右クリックします。
    6. 「設定の編集」をクリックします。
    7. CD/DVDドライブ ]の[ 接続] チェックボックスをオフにします。
    8. 保存 をクリックします。

使用量計証明書の交換

アップグレード後、Usage Meter URL にアクセスできない場合、またはダッシュボードにログインできない場合は、以下の手順を実行して、互換性のないホスト名のために Usage Meter 証明書を交換してください：

  1. SSH を使用して、 usagemeter ユーザー名で使用量計 VM にログインします。

  2. コマンド stop.sh All を実行し、すべてのサービスを停止する。

  3. rootユーザーでコマンド hostnamectl hostname <new hostname> を実行し、ホスト名を正しい値に更新する。

  4. コマンド export $(grep -v '^#' "/opt/vmware/cloudusagemetering/platform/conf/env.properties" | xargs) と mv /opt/vmware/cloudusagemetering/platform/security/keystore /opt/vmware/cloudusagemetering/platform/security/keystore.backup を実行して、環境変数をエクスポートし、既存のキーストアをバックアップする。

  5. FIPSが有効になっている場合は、コマンド keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}" を実行する。 無効になっている場合は、コマンド keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}" を実行する。

    FIPSが有効な状態でFIPS無効版を実行すると、エラー keytool error: java.security.KeyStoreException: Unrecognized keystore format.。 それを解決するには、指定されたタイプでロードする。

  6. NGINX 変数用に一時ディレクトリを作成し、 export NGINX_FOLDER=$(mktemp -d) コマンドを実行して cloudusagemetering ディレクトリに移動し、 cd /opt/vmware/cloudusagemetering を実行して新しいディレクトリにアクセスする。

  7. コマンド ./platform/bin/create-keystore.sh を実行し、新しいキーストアを作成する。

  8. コマンド rm -rf $NGINX_FOLDER と rm /opt/vmware/cloudusagemetering/platform/security/keystore.backup を実行して、一時バックアップ・ファイルを削除する。

  9. FIPSが有効になっている場合は、コマンド keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}" を実行してバックアップ・キーストアを削除する。 無効になっている場合は、コマンド keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}" を実行する。

  10. コマンド chmod 0640 /opt/vmware/cloudusagemetering/platform/security/keystore を実行して新しいキーストアのパーミッションを更新し、Usage Meter VM を再起動する。

    ホスト名が変更されたため、DNSエントリーを新しいホスト名に更新するか、存在しない場合は追加する必要があるかもしれません。 ログインページにリダイレクトされ、 OAuth エラーが表示される場合は、Usage Meter の既存の DNS エントリをすべてクリアしてから、もう一度やり直してください。

  11. 再起動が完了したら、ウェブブラウザでUsage Meter URL を開き、アップグレードされたバージョンを確認します。