Linux VDAのセルフアップデート

最終公開日 : Nov 13, 2026
この機能は、Linux VDAソフトウェアを即時またはスケジュールされた時間に自動的に更新するのに役立ちます。これは、Citrix Virtual Apps and Desktops Standard for AzureでLinux VDAを作成する場合に特に役立ちます。AzureのVMに対する管理者権限はありません。詳細については、「Citrix Virtual Apps and Desktops Standard for AzureでLinux VDAを作成する」を参照してください。
Related information
Linux VDA を構成する

構成

この機能を使用するには、次の手順を完了します。

手順1：更新情報と新しいVDAパッケージをAzureコンテナにアップロードする

手順1a：Azureストレージアカウントの下にコンテナを作成し、コンテナのアクセスレベルを**Blob (Anonymous read access for blobs only)**に設定します。
注:
AzureコンテナとBLOBは、お客様が排他的に保持および管理します。Citrix®は、それらに関するセキュリティ問題について責任を負いません。データセキュリティとコスト効率を確保するため、各セルフアップデート後にコンテナのアクセスレベルを**Private (no anonymous access)**に設定してください。
手順1b：VDAの更新情報をUpdateInfo.jsonという名前のJSONファイルに組み込みます。ファイル形式の例については、次のブロックを参照してください。
{
 "Version": "21.04.200.4",
"Distributions":[
{
"TargetOS": "RHEL7_9",
"PackageName": "",
"PackageHash": ""
},
{
"TargetOS": "RHEL8_3",
"PackageName": "XenDesktopVDA-21.04.200.4-1.el8_x.x86_64.rpm",
"PackageHash": "a6f2aba23b84bbc3a4640294a8bb92474e0cacbab1e5ae33416c0a4473a28d73"
},
{
"TargetOS": "UBUNTU16_04",
"PackageName": "",
"PackageHash": ""
},
{
"TargetOS": "UBUNTU18_04",
"PackageName": "xendesktopvda_21.04.200.4-1.ubuntu18.04_amd64.deb",
"PackageHash": "4148cc3f25d3717e3cbc19bd953b42c72bd38ee3fcd7f7034c2cd6f2b15b3c5a"
},
{
"TargetOS": "UBUNTU20_04",
"PackageName": "",
"PackageHash": ""
}
]
}
ここで、**"Version"は新しいVDAバージョンを示し、"Distributions"**は更新オブジェクトの配列です。各オブジェクトには3つの項目が含まれます。
  • "TargetOS"：「RHEL7_9」（RHEL 7およびCentOS 7の場合）、「RHEL8_3」、「UBUNTU16_04」、「UBUNTU18_04」、または「UBUNTU20_04」である必要があります。ctxmonitorserviceは他のディストリビューションを認識しません。
  • "PackageName"：指定されたバージョンのVDAパッケージのフルネーム。
  • "PackageHash"：shasum -a 256 <pkgname>コマンドを使用して計算するSHA-256値。
手順1c：JSONファイルと新しいバージョンのLinux VDAパッケージをAzureコンテナにアップロードします。

手順2：マスターイメージまたは各VDAでセルフアップデート機能を有効にする

デフォルトでは、セルフアップデートは無効になっています。Citrix Virtual Apps and Desktops™ Standard for AzureでLinux VDAを作成する場合、機能の有効化はマスターイメージで行う必要があります。それ以外の場合は、各ターゲットVDAで直接機能を有効にします。
セルフアップデートを有効にするには、HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\SelfUpdateにあるレジストリキーを編集するために、次のようなコマンドを実行します。
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_DWORD" -v "fEnabled" -d "0x00000001" –force

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_SZ" -v "ScheduledTime" -d "Immediately" –force

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_SZ" -v "Url" -d "<Your-Azure-Container-Url>" –force

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\SelfUpdate" -t "REG_SZ" -v "CaCertificate" -d "<Local-Certificate-Path-of-PortalAzureCom>" --force
次の表は、レジストリ設定について説明しています。
レジストリ設定 説明
fEnabled この設定は必須です。デフォルトでは値は0で、セルフアップデートが無効であることを意味します。セルフアップデートを有効にするには、1に設定します。
Url この設定は必須です。更新情報と新しいVDAパッケージを取得するためのAzureコンテナのURLを設定します。
ScheduledTime この設定は必須です。ImmediatelyまたはNextStartに設定できます。Immediatelyは、VDAパッケージのダウンロード後すぐにアップデートを実行することを意味します。このオプションは、ダウンロード速度が速く、アップデートが緊急である場合に適しています。ただし、パッケージのダウンロード中にライブセッションがある場合、ユーザーエクスペリエンスを妨げる可能性があります。NextStartは、ctxmonitorserviceの次回の起動時にアップデートを実行することを意味します。このオプションは、ダウンロード速度が速くなく、アップデートが緊急でない場合に適しています。
CaCertificate この設定はオプションです。AzureコンテナのURLを検証するためのPEM証明書のフルパスを設定します。Azure BLOBの場合、ブラウザから取得し、PEMに変換されたportal.azure.comの証明書を使用できます。セキュリティのため、このレジストリ設定を追加することをお勧めしますが、Ubuntuでのみサポートされています。RHELでは、curlコマンド用のNSSライブラリの一部がリンクされていません。証明書の権限を最小限に設定するようにしてください。
ctxmonitorserviceが再起動すると、まずUrlを照会してUpdateInfo.jsonファイルを取得し、JSONファイルから更新バージョンを取得します。次に、ctxmonitorserviceは更新バージョンを現在のバージョンと比較します。現在のバージョンが古い場合、サービスはAzureからVDAパッケージの新しいバージョンをダウンロードし、ローカルに保存します。その後、ScheduledTimeの設定に従ってアップデートを実行します。オンプレミス展開の場合、ctxmonitorserviceを直接再起動してアップデートをトリガーできます。ただし、VMに対する管理者権限がないCitrix Virtual Apps and Desktops Standard for Azureでは、ctxmonitorserviceはVDAマシンが再起動された後にのみ再起動できます。アップデートが失敗した場合、VDAは既存のバージョンにロールバックされます。
注:
  • マスターイメージで構成したレジストリ設定は変更できません。
  • 環境内のすべてのVMが同時にパッケージをダウンロードすると、ローカルネットワークが混雑する可能性があります。
  • アップデートとロールバックの両方が失敗した場合、ユーザーデータは失われます。
  • アップデートが失敗してもロールバックが成功した場合、同じネットワーク上のユーザーは異なるバージョンのLinux VDAを使用する可能性があります。このケースは最適ではありません。
  • アップデートの完了には通常数分かかります。Citrix Studio にはステータスインジケーターはありません。