アップデートパッケージを使用した VMware Cloud Director アプライアンスのアップグレード

アップデートパッケージを使用することにより、VMware Cloud Director アプライアンスの最新バージョンへのアップグレードや、VMware Cloud Director アプライアンスへのパッチ適用ができます。

VMware Cloud Director アプライアンス環境へのアップグレード中に VMware Cloud Director サービスは動作を停止し、一定時間のダウンタイムが発生すると予想されます。ダウンタイムは、各 VMware Cloud Director アプライアンスをアップグレードし、VMware Cloud Director データベースアップグレードスクリプトを実行するための所要時間によって異なります。最後の VMware Cloud Director アプライアンスで VMware Cloud Director サービスを停止するまで、VMware Cloud Director サーバグループ内の動作中のセルの数は減少します。VMware Cloud Director HTTP エンドポイントの前に配置された、適切に構成されたロードバランサで、停止されたセルへのトラフィックのルーティングを停止する必要があります。

すべての VMware Cloud Director アプライアンスにアップグレードを適用し、データベースのアップグレードが完了したら、各 VMware Cloud Director アプライアンスを再起動する必要があります。

前提条件

プライマリ VMware Cloud Director アプライアンスのスナップショットを作成します。

バージョン 10.1 以降からアップグレードするとき、またはパッチを適用するときに、プライマリデータベースサービスの障害発生時の自動フェイルオーバーが有効になっている場合は、アップグレードの間、フェイルオーバーモードを Manual に変更します。アップグレードが終わったら、フェイルオーバーモードを Automatic に設定できます。VMware Cloud Director アプライアンスの自動フェイルオーバーを参照してください。
データベース高可用性クラスタのプライマリ VMware Cloud Director アプライアンスが配置されている vCenter Server インスタンスにログインします。
プライマリ VMware Cloud Director アプライアンスに移動して右クリックし、[パワー] > [ゲスト OS をシャットダウン] をクリックします。
アプライアンスを右クリックして、[スナップショット] > [スナップショットの作成]をクリックします。スナップショットの名前と、必要に応じて説明を入力し、[OK] をクリックします。
VMware Cloud Director アプライアンスを右クリックし、[パワー] > [パワーオン] をクリックします。
データベース高可用性構成に含まれているすべてのノードが良好な状態であることを確認します。VMware Cloud Director アプライアンスクラスタの健全性とフェイルオーバーモードの表示を参照してください。
VMware Cloud Director アプライアンスのバックアップ手順について理解します。VMware Cloud Director アプライアンスの組み込みデータベースのバックアップを参照してください。

手順

Web ブラウザで、VMware Cloud Director アプライアンスインスタンスのアプライアンス管理ユーザーインターフェイスにログインして、プライマリアプライアンス https://appliance_ip_address:5480 を特定します。
プライマリアプライアンス名を書き留めておきます。スタンバイセルとアプリケーションセルの前にプライマリアプライアンスをアップグレードする必要があります。データベースをバックアップする場合は、プライマリアプライアンスを使用する必要があります。
クラスタ内のすべてのアプライアンスで次のコマンドを実行して、VMware Cloud Director をシャットダウンします。
```
/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
```
アップデートパッケージを、アップグレードするアプライアンスにダウンロードします。

注：最初にプライマリアプライアンスをアップグレードする必要があります。
VMware Cloud Director は VMware_Cloud_Director_v という形式の名前で実行可能ファイルとして配布されます。v.v.v- nnnnnnnn_update. tar.gz。 v. v. v. v は製品バージョン、 nnnnnnnn はビルド番号を表します。たとえば、 VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz のようになります。
アップデートパッケージを抽出する local-update-package ディレクトリを作成します。
```
mkdir /tmp/local-update-package
```

新しく作成したディレクトリにアップデートパッケージを抽出します。

 tar -zxf VMware_Cloud_Director_v.v.v.v-nnnnnnnn_update.tar.gz \
				-C /tmp/local-update-package

local-update-package ディレクトリをアップデートリポジトリとして設定します。
```
vamicli	update --repo file:///tmp/local-update-package
```
アップデートを調べて、リポジトリが正しく設定されていることを確認します。
```
vamicli update --check
```
アップグレードリリースが Available Update として表示されます。
プライマリまたはスタンバイアプライアンスの管理ユーザーインターフェイスを使用してバックアップを作成します。
アプリケーションセルを使用してバックアップを実行することはできません。
使用可能なアップグレードを適用します。
```
vamicli update --install latest
```
残りのスタンバイセルとアプリケーションセルに手順 3 ～7 と手順 9 を繰り返します。
任意のアプライアンスから VMware Cloud Director データベース upgrade ユーティリティを実行します。
```
/opt/vmware/vcloud-director/bin/upgrade
```
各 VMware Cloud Director アプライアンスを再起動します。
```
shutdown -r now
```

次のタスク

アップグレードが成功したことを確認します。
- VMware Cloud Director Service Provider Admin Portal にログインします。
- VMware Cloud Director アプライアンス管理ユーザーインターフェイスにログインし、すべてのアプライアンスが Healthy ステータスで表示されていることを確認します。
アップグレード中に証明書変換エラーがログに表示されないことを確認します。証明書変換エラーがログにある場合は、VMware Cloud Director アプライアンスをバックアップできません。エラーが表示された場合は、アップグレードを再試行しないでください。エラーに応じて、convert コマンドを再度実行する前に問題を手動で解決してください。
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
エラーに応じて、次のように、異なる回避策があります。
- 証明書の変換プロセス中に /opt/vmware/var/log/vami/updatecli.log に次の例外が表示される場合は、ナレッジベースの記事 88372を参照してください。
```
 <JAVA_HOME>/lib/ext exists, extensions mechanism no longer supported; Use -classpath instead.
             .Error: Could not create the Java Virtual Machine.
              Error: A fatal exception has occurred. Program will exit. 
```
- /opt/vmware/var/log/vami/updatecli.log に証明書の変換プロセスでの不正なキーに関連するエラーがある場合、またはエラーの理由が記載されていない場合、可能な回避策は次のとおりです。
  - .pem および .key ファイルが準備されていない場合は、キーストアファイルがあることを確認します。キーストアファイルの場所は、global.properties ファイルに記述されています。
  - VMware Cloud Director によってキーストアファイルが検出された場合は、keytool ユーティリティまたは OpenSSL ツールを使用して、キーストアから .pem および .key ファイルを抽出します。
  - VMware Cloud Director によってキーストアファイルが検出されない場合は、証明書を完全に再構成します。証明書の作成の詳細については、VMware Cloud Director アプライアンスの SSL 証明書の作成と管理を参照してください。
  - ワイルドカード証明書に関連する .pem および .key ファイルが既にある場合は、ノード上の既存の証明書をワイルドカード証明書に置き換えるために、セル管理ツールの certificate コマンドを使用します。
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -j --cert /opt/vmware/vcloud-director/data/transfer/user.http.pem --key /opt/vmware/vcloud-director/data/transfer/user.http.key --key-password key_password
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -p --cert /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.pem --key /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.key --key-password key_password
```
アップグレードが成功した場合は、VMware Cloud Director アプライアンスのスナップショットを削除できます。
アップグレードに失敗した場合は、VMware Cloud Director アプライアンスを、アップグレード前に作成したスナップショットの状態にロールバックできます。アップグレードが失敗した場合の VMware Cloud Director アプライアンスのロールバックを参照してください。