アップグレード
Citrix ADM の各リリースでは、機能が強化された新機能および更新された機能が提供されます。Citrix ADM を最新リリースにアップグレードして、新機能とバグ修正を利用することをお勧めします。 すべてのリリース発表に付随するリリースノートには 、機能強化、既知の問題、およびバグ修正の包括的なリストが含まれています。また、アップグレードを開始する前に、ライセンスフレームワークと使用できるライセンスの種類を理解することも重要です。Citrix ADM のライセンス情報については、「ライセンス」を参照してください。
アップグレードパスの情報は、『 Citrix アップグレードガイド』にも記載されています。
アップグレードの前に
Citrix ADM ダウンロードページからアップグレードパッケージをダウンロードし、この記事の指示に従ってシステムを最新の13.1ビルドにアップグレードします。アップグレードプロセスが開始されると、ADM が再起動し、アップグレードが完了すると、既存の接続が終了して再接続されます。既存の構成は保持されますが、Citrix ADM はアップグレードが完了するまでデータを処理しません。
13.1 にアップグレードする前に注意すべき点:
-
バージョン 11.1 またはバージョン 12.0 56.x および以前のビルドからアップグレードする場合は、次の手順を実行します。
-
既存のバージョンから 12.0 ビルド 57.24 にアップグレードします。
-
バージョン 12.1 の最新ビルドにアップグレードします。
-
バージョン 13.1 にアップグレードしてください。
-
-
12.0 ビルド 57.24 以降からアップグレードする場合は、まず 12.1 にアップグレードしてから 13.1 にアップグレードします。
- 12.1 からアップグレードする場合は、13.1 に直接アップグレードできます。
- 13.0 64.xx より前のバージョンからアップグレードする場合は、ユーザエクスペリエンスを向上させるために、まず 13.0 64.xx にアップグレードしてから 13.1 にアップグレードします。
13.1 xx.xx 以降にアップグレードする前に注意すべき重要なポイント
ADM ソフトウェアをバージョン 13.1 xx.xx にアップグレードすると、ADM データベースも移行されます。このデータ移行は、ADM が PostgreSQL バージョン 10.11 を使用しているために発生します。
注
ADM ソフトウェアのダウングレードはサポートされていません。ダウングレードを試みないでください。
推奨される注意事項:
-
13.1 xx.xx 以降にアップグレードする場合は、Citrix ADM サーバーのスナップショットを作成します。
-
アップグレードする前に、Citrix ADM サーバーをバックアップしてください。
-
アップグレード後、Citrix ADM サーバーと管理対象インスタンス間の接続の再確立が必要になる場合があります。「続行すると接続に失敗する可能性がある」という旨を警告する確認メッセージが表示されます。
-
高可用性セットアップのCitrix ADM サーバーの場合、アップグレード時に、どちらのノードでも構成を変更しないでください。
警告
アップグレード処理が正常に完了するまでブラウザーを更新しないでください。アップグレードが完了するまでのおおよその時間を GUI で確認します。
-
アップグレード後、アクティブノードは高可用性ペアで変更できます。
単一のCitrix ADMサーバーを13.1-12.xにアップグレードする
-
管理者の資格情報を使用してCitrix ADM にログオンします。
-
［System］>［System Administrations］の順に選択します。[ システム管理 ] サブヘッダーで、[ Citrix ADM のアップグレード] をクリックします。
-
［Citrix ADM のアップグレード ］ページで、［ アップグレードの成功時にソフトウェアイメージをクリーンアップする ］チェックボックスをオンにして、アップグレード後にイメージファイルを削除します。このオプションを選択すると、アップグレード時にCitrix ADM イメージファイルが自動的に削除されます。
注
このオプションはデフォルトで選択されています。アップグレードプロセスを開始する前にこのチェックボックスをオンにしない場合は、イメージを手動で削除する必要があります。
-
その後、 ローカル (ローカルマシン ) または Applianceを選択して、新しいイメージファイルをアップロードできます。ビルドファイルは、Citrix ADM 仮想アプライアンス上に存在する必要があります。
-
［OK］ をクリックします。
-
[ Upgrade ADM ] ページには、ファイル名、選択したバージョン、完了までの推定時間など、いくつかの詳細が表示されます。 アップグレード] をクリックします。
アップグレードプロセスが開始されます。
設定を移行したら、ADM GUI にログオンできます。ログオンすると、履歴データはバックグラウンドで移行を開始しますが、ADM で作業を続行できます。
履歴データの移行中に、古いデータの一部が使用できない場合があります。データベースの移行にかかる時間は、データのサイズとテーブル数によって異なります。
ADM GUI を使用してデータベースの移行を監視できます。[ アップグレードの進行状況の表示 ] をクリックすると、[ データベース移行ステータス ] が表示されます。
アップグレードが完了すると、デフォルトの無料ライセンスが 2 つに減るというメッセージが表示されます。詳細については、[ 詳細の表示 ] をクリックしてください。
単一のCitrix ADMサーバーを13.1-4.xまたは13.1-9.xにアップグレードする
-
管理者の資格情報を使用してCitrix ADM にログオンします。
-
［System］>［System Administrations］の順に選択します。[ システム管理 ] サブヘッダーで、[ Citrix ADM のアップグレード] をクリックします。
-
［Citrix ADM のアップグレード ］ページで、［ アップグレードの成功時にソフトウェアイメージをクリーンアップする ］チェックボックスをオンにして、アップグレード後にイメージファイルを削除します。このオプションを選択すると、アップグレード時にCitrix ADM イメージファイルが自動的に削除されます。
注
このオプションはデフォルトで選択されています。アップグレードプロセスを開始する前にこのチェックボックスをオンにしない場合は、イメージを手動で削除する必要があります。
-
その後、 ローカル (ローカルマシン ) または Applianceを選択して、新しいイメージファイルをアップロードできます。ビルドファイルは、Citrix ADM 仮想アプライアンス上に存在する必要があります。
-
［OK］ をクリックします。 [ 確認] ダイアログボックスが表示されます。［Yes］ をクリックします。
アップグレードプロセスが開始されます。
設定を移行したら、ADM GUI にログオンできます。ログオンすると、履歴データはバックグラウンドで移行を開始しますが、ADM で作業を続行できます。
履歴データの移行中に、古いデータの一部が使用できない場合があります。データベースの移行にかかる時間は、データのサイズとテーブル数によって異なります。
ADM GUI を使用してデータベースの移行を監視できます。[ アップグレードの進行状況の表示 ] をクリックすると、[ データベース移行ステータス ] が表示されます。
データベース移行に関する問題のトラブルシューティング
13.1 xx.xx 以降へのアップグレードプロセス中に、Web Insight の履歴データの移行が停止しているように見えることがあります。このような場合、データ移行の詳細を確認するには、次の手順を実行します。
ADM シェルプロンプトにログオンし、次のコマンドを実行して、進行状況の詳細を確認します。
cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
<!--NeedCopy-->
出力の例を次に示します
bash-3.2# cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
Tue Oct 6 07:41:55 GMT 2020
157 out of 127346 done in 54 seconds
File
/var/mps/db_upgrade/hist_table_mig_data/Web_Insight/af_app_client_server_resp_second_l3p_d7_dump
bash-3.2#
<!--NeedCopy-->
この例では、 af_app_client_server_resp_second_l3p_d7 はアップグレード中のエントリです。また、127,346 のうち 157 エントリが 54 秒で移行されます。
高可用性ペアを 12.1 リリースから 13.1 リリースにアップグレードする
高可用性モードのCitrix ADM サーバーの場合、アクティブノードまたはフローティングIPアドレスにアクセスしてアップグレードできます。いずれかのサーバーでアップグレードプロセスを開始すると、両方のCitrix ADM サーバーが自動的に最新のビルドにアップグレードされます。
注
12.0以前のリリースから高可用性ペアをアップグレードする場合は、「 Citrix ADM 12.1のアップグレード」を参照してください。
Citrix ADM ディザスタリカバリ展開のアップグレード
Citrix ADM ディザスタリカバリ展開のアップグレードは、次の2ステップのプロセスです。
-
プライマリサイトの高可用性モードで構成されたCitrix ADM ノードをアップグレードします。後で災害復旧ノードをアップグレードする必要があります。
-
障害回復ノードをアップグレードする前に、高可用性で展開されているCitrix ADMサーバーをアップグレードしたことを確認してください。
Citrix ADM障害回復ノードをアップグレードする
-
CitrixダウンロードサイトからCitrix ADMアップグレードイメージファイルをダウンロードします。
-
nsrecover認証情報を使用して、このファイルを災害復旧ノードにアップロードします。 -
nsrecover認証情報を使用して災害復旧ノードにログオンします。 -
イメージファイルを配置したフォルダに移動し、ファイルを解凍します。
-
次のスクリプトを実行します。
./installmas
オンプレミスエージェントをマルチサイト展開用にアップグレードする
Citrix ADM エージェント展開のアップグレードは、3ステップのプロセスです。 オンプレミスエージェントをアップグレードする前に、次のタスクを完了していることを確認します。
-
高可用性で展開されているCitrix ADM サーバーをアップグレードします。
-
Citrix ADM 障害回復ノードをアップグレードします。
詳しくは、「 Citrix ADM ディザスタリカバリ展開のアップグレード」を参照してください。
オンプレミスエージェントのアップグレード
-
CitrixダウンロードサイトからCitrix ADMエージェントのアップグレードイメージファイルをダウンロードします。
-
nsrecover認証情報を使用して、このファイルをエージェントノードにアップロードします。 -
正しいエージェントアップグレードイメージをダウンロードしてください。
-
nsrecover資格情報を使用してオンプレミスエージェントにログオンします。 -
イメージファイルを配置したフォルダに移動し、ファイルを解凍します。
-
次のスクリプトを実行します。
./installmasagent
Citrix ADMサーバーにディスクを追加する
Citrix ADMストレージ要件がデフォルトのディスク容量（120 GB）を超える場合は、追加のディスクを接続できます。単一サーバーおよび高可用性環境の両方で、より多くのディスクを接続できます。
Citrix ADM をリリースバージョン12.1～13.1からアップグレードしても、以前のバージョンで追加ディスクに作成したパーティションは変わりません。パーティションは削除されず、サイズも変更されません。
アップグレードされたビルドでは、より多くのディスクを接続する手順は同じままです。Citrix ADM の新しいディスクパーティション作成ツールを使用して、新しく追加したディスクにパーティションを作成できるようになりました。このツールを使用して、既存のより多くのディスク内のパーティションのサイズを変更することもできます。 追加のディスクを接続する方法と新しいディスクパーティション分割ツールを使用する方法について詳しくは、「Citrix ADM に追加のディスクを接続する方法」を参照してください。
スタイルブックを使用してOpenStackでCitrix ADC インスタンスをプロビジョニングする
Citrix ADM 12.1ビルド49.23以降、OpenStackオーケストレーションワークフローのアーキテクチャが更新されました。ワークフローでは、Citrix ADM スタイルブックを使用してCitrix ADC インスタンスを構成するようになりました。バージョン 12.0 または 12.1 ビルド 48.18 から Citrix ADM 13.1 にアップグレードする場合は、次の移行スクリプトを実行する必要があります。
/mps/scripts/migration_scripts/migrate_configurations.py
<!--NeedCopy-->
os-cs-lb-mon StyleBookと移行スクリプトについて詳しくは、「 StyleBookを使用したOpenStackでのCitrix ADC VPXインスタンスのプロビジョニング」を参照してください。