製品ドキュメント
Linux Virtual Delivery Agent
Aktuelles Release 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 2201 2112 2110 2109 2107 2106 2104 2103 1912 LTSR 7.15
PDFを表示

イージーインストールを使用してドメインに参加していないLinux VDAを作成する（プレビュー）

August 3, 2026
寄稿者: 
C C

この記事では、イージーインストール方法を使用してCitrix DaaSでドメインに参加していないLinux VDAを作成する手順について説明します。

重要:

  • ドメインに参加していないVDAはCitrix DaaSでサポートされています。
    • コントロールプレーンはCitrix DaaSで展開する必要があります。
    • ドメインに参加していないVDAは、パブリッククラウドまたはオンプレミスのデータセンターに展開できます。ドメインに参加していないVDAは、Citrix DaaSのコントロールプレーンによって管理されます。
    • ドメインに参加していないVDAを作成するには、Citrix Gatewayサービスを使用しているお客様は、Rendezvous V2が有効になっていることを確認する必要があります。Cloud Connectorは、オンプレミスのハイパーバイザーにマシンをプロビジョニングする予定がある場合、またはWorkspaceでActive DirectoryをIDプロバイダーとして使用する場合にのみ必要です。
  • ドメインに参加していないVDAを作成するには、MCSも使用できます。詳細については、「MCSを使用してドメインに参加していないLinux VDAを作成する」を参照してください。
    • MCSはベアメタルサーバーをサポートしていません。
  • ドメインに参加していないLinux VDAでは、次の機能が利用可能です。

ステップ1：マシンカタログを作成する

マシンを含まない空のマシンカタログを作成します。たとえば、Citrix Remote PowerShell SDK を使用し、次のコマンドを実行して、Your-catalog-name という名前でシングルセッションOSマシンをサポートする空のマシンカタログを作成します。

New-BrokerCatalog -AllocationType 'Static' -Description 'Your description' -MinimumFunctionalLevel 'L7_20' -Name 'Your-catalog-name' -SessionSupport 'SingleSession' -PersistUserChanges 'OnLocal' -ProvisioningType 'Manual' -MachinesArePhysical $true
<!--NeedCopy-->

作成したカタログのUUIDを記録しておきます。UUIDは、後で登録トークンを作成するときに必要になります。

マシンカタログを作成し、Linux VDAマシンを追加するプロセスは、従来のWindows VDAのアプローチと似ています。これらのタスクを完了する方法の詳細については、「マシンカタログの作成」および「マシンカタログの管理」を参照してください。

Linux VDAマシンを含むマシンカタログを作成する場合、Windows VDAマシン用のマシンカタログを作成するプロセスとは異なるいくつかの制限があります。

  • オペレーティングシステムについては、以下を選択します。

    • ホスト型共有デスクトップ配信モデルの場合は、マルチセッションOSオプション。
    • VDI専用デスクトップ配信モデルの場合は、シングルセッションOSオプション。
  • 同じマシンカタログ内でLinux VDAマシンとWindows VDAマシンを混在させないでください。
  • 同じマシンカタログ内でドメイン参加マシンと非ドメイン参加マシンを混在させないでください。
  • Remote PC Accessマシンカタログは、ドメイン参加マシンのみがサポートされており、非ドメイン参加マシンはサポートされていません。

注：

Citrix Studioの初期バージョンでは、「Linux OS」という概念はサポートされていません。ただし、Windows Server OSまたはServer OSオプションを選択すると、同等のホスト型共有デスクトップ配信モデルが示唆されます。Windows Desktop OSまたはDesktop OSオプションを選択すると、マシンごとに1人のユーザーという配信モデルが示唆されます。

ステップ2：VDA登録トークンを作成する

簡易インストールを使用して非ドメイン参加VDAを作成するには、VDAをマシンカタログに登録し、Citrix Cloud™コントロールプレーンに対してVDAを認証するためのトークンファイルが必要です。Linux VDAは、電源管理されたマシンカタログへの登録にトークンファイルを使用することをサポートしていません。

登録トークンを作成するには、次のようなHTTP POSTメッセージをURL: [DdcServerAddress]/citrix/orchestration/api/techpreview/{customerid}/{siteid}/enrollmentsに送信します。

POST https://[DdcServerAddress]/citrix/orchestration/api/techpreview/[customerid]/[siteid]/enrollments HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
Authorization: Bearer <bearer-token>

{
  "TokenName": "string",
  "IssuedToUser": "string",
  "ExpirationDate": "2023-10-13T08:00:25.796Z",
  "NotValidBeforeDate": "2023-10-13T08:00:25.796Z",
  "NumMachinesAllowed": number,
  "CatalogId": "string"
}
<!--NeedCopy-->

HTTP POSTメッセージでは、CatalogIdを以前作成したマシンカタログのUUIDに設定し、[DdcServerAddress]を必要に応じて以下のいずれかに設定します。

  • 商用 https://[customerid].xendesktop.net
  • 日本 https://[customerid].apps.citrixworkspacesapi.jp
  • 政府 https://[customerid].xendesktop.us

ステップ3: .NETのインストール

Linux VDAをインストールする前に、システム要件に従って .NETをインストールします。

.NETのインストール後、which dotnetコマンドを実行してランタイムパスを見つけます。

コマンド出力に基づいて、.NETランタイムバイナリパスを設定します。たとえば、コマンド出力が/aa/bb/dotnetの場合、/aa/bbを.NETバイナリパスとして使用します。

ステップ4: Linux VDAパッケージのダウンロード

  1. シトリックス バーチャルアップス アンド デスクトップス ダウンロードページ(https://www.citrix.com/downloads/citrix-virtual-apps-and-desktops/)にアクセスします。
  2. シトリックス バーチャルアップス アンド デスクトップス の適切なバージョンを展開します。

  3. Componentsを展開してLinux VDAを見つけます。例:

    シトリックス バーチャル アプリケーションズ アンド デスクトップス の構成要素

  4. Linux VDAリンクをクリックして、Linux VDAダウンロードにアクセスします。

    Linux VDA のダウンロード

  5. お使いのLinuxディストリビューションに合ったLinux VDAパッケージをダウンロードします。

  6. Linux VDAパッケージの整合性を検証するために使用できるGPG公開鍵をダウンロードします。例：

    GPG公開鍵(/ja-jp/linux-virtual-delivery-agent/2402-ltsr/media/gpg-key.png)

    公開鍵を使用してLinux VDAパッケージの整合性を検証するには：

    • RPMパッケージの場合、公開鍵をRPMデータベースにインポートし、パッケージの整合性を確認するには、次のコマンドを実行します。

       rpmkeys --import <path to the public key>
 rpm --checksig --verbose <path to the Linux VDA package>
 <!--NeedCopy-->

    • DEBパッケージの場合、公開鍵をDEBデータベースにインポートし、パッケージの整合性を確認するには、次のコマンドを実行します。

       sudo apt-get install dpkg-sig
 gpg --import <path to the public key>
 dpkg-sig --verify <path to the Linux VDA package>
 <!--NeedCopy-->

ステップ5：Linux VDAパッケージをインストールする

Linux VDAの環境をセットアップするには、次のコマンドを実行します。

Amazon Linux 2、CentOS、RHEL、およびRocky Linuxといったディストリビューションの場合、以下の手順を実行します。

注：

  • RHELおよびCentOSの場合、Linux VDAを正常にインストールする前にEPELリポジトリをインストールしてください。EPELのインストール方法については、https://docs.fedoraproject.org/ja-jp/epel/の指示を参照してください。

  • RHEL 9.3/9.2/9.0およびRocky Linux 9.3/9.2/9.0にLinux VDAをインストールする前に、libsepolパッケージをバージョン3.4以降に更新してください。

sudo yum  -y localinstall   <PATH>/<Linux VDA RPM>
<!--NeedCopy-->

注：

GCPでホストされているRHEL 8.x/9.xおよびRocky Linux 8.x/9.xにLinux VDAをインストールした後、VMの再起動後にイーサネット接続が失われ、Linux VDAにアクセスできなくなる可能性があります。この問題を回避するには、VMに初めてログオンするときにrootパスワードを設定し、rootとしてVMにログオンできることを確認してください。その後、VMを再起動した後にコンソールで次のコマンドを実行します。

nmcli dev connect eth0
systemctl restart NetworkManager
<!--NeedCopy-->

Ubuntu/Debianディストリビューションの場合：

sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
<!--NeedCopy-->

注記:

  • Debian 11ディストリビューションに必要な依存関係をインストールするには、/etc/apt/sources.listファイルにdeb http://deb.debian.org/debian/ bullseye main行を追加します。

  • GCP上のUbuntu 20.04では、RDNSを無効にします。そのためには、/etc/krb5.confの[libdefaults]の下にrdns = false行を追加します。

SUSEディストリビューションの場合:

  1. AWS、Azure、GCP上のSUSE 15.5では、以下を確認してください:

    • libstdc++6バージョン12以降を使用していること。
    • /etc/sysconfig/windowmanager というパスに存在するファイルにおいて、Default_WM パラメーターは “gnome” という値に設定されています。

  2. Linux VDAをインストールするには、次のコマンドを実行します:

    zypper -i install <PATH>/<Linux VDA RPM>
<!--NeedCopy-->

ステップ6: NVIDIA GRIDドライバーをインストールする

HDX™ 3D Proを有効にするには、ハイパーバイザーとVDAマシンにNVIDIA GRIDドライバーをインストールする必要があります。

特定のハイパーバイザーにNVIDIA GRID Virtual GPU Manager（ホストドライバー）をインストールおよび構成するには、以下のガイドを参照してください:

NVIDIA GRIDゲストVMドライバーをインストールおよび構成するには、次の一般的な手順を実行します:

  1. ゲストVMがシャットダウンされていることを確認します。
  2. ハイパーバイザーのコントロールパネルで、VMにGPUを割り当てます。
  3. VMを起動します。
  4. VMにゲストVMドライバー（クラウドベンダーまたはNVIDIAから提供）をインストールします。

ステップ7：使用するデータベースを指定する

Linux VDAパッケージのインストール後、/etc/xdl/db.conf を編集して、使用するSQLiteまたはPostgreSQLを指定できます。

To do so, edit /etc/xdl/db.conf before running sudo /opt/Citrix/VDA/sbin/ctxinstall.sh or /opt/Citrix/VDA/bin/easyinstall.

注：

  • VDIモードでのみSQLiteを使用することをお勧めします。
  • 簡単インストールおよびMCSの場合、SQLiteまたはPostgreSQLを手動でインストールすることなく使用するように指定できます。/etc/xdl/db.conf で特に指定がない限り、Linux VDAはデフォルトでPostgreSQLを使用します。
  • また、/etc/xdl/db.conf を使用して、PostgreSQLのポート番号を構成することもできます。

ステップ8：簡単インストールを実行して環境とVDAを構成し、インストールを完了する

Linux VDAパッケージのインストール後、ctxinstall.shスクリプトを使用して実行環境を構成します。

注：

ランタイム環境をセットアップする前に、OSにen_US.UTF-8ロケールがインストールされていることを確認してください。OSでロケールが利用できない場合は、sudo locale-gen en_US.UTF-8コマンドを実行します。Debianの場合、/etc/locale.genファイルを編集して# en_US.UTF-8 UTF-8行のコメントを解除し、sudo locale-genコマンドを実行します。

ctxinstall.sh

ctxinstall.sh は、いくつかの事前設定と VDA 実行環境変数の設定を行うための簡易インストールスクリプトです。

  • このスクリプトは root のみが実行できます。

  • 簡易インストールでは、使用されるすべての環境変数の値を設定、保存、同期するための構成ファイルとして /opt/Citrix/VDA/sbin/ctxinstall.conf を使用します。テンプレート (ctxinstall.conf.tmpl) を注意深く読み、独自の ctxinstall.conf をカスタマイズすることをお勧めします。構成ファイルを初めて作成する場合は、次のいずれかの方法を使用します。
    • By copying the /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl template file and saving it as /opt/Citrix/VDA/sbin/ctxinstall.conf.
    • ctxinstall.sh スクリプトを実行することで。ctxinstall.sh を実行するたびに、入力内容は /opt/Citrix/VDA/sbin/ctxinstall.conf ファイルに保存されます。

  • 簡易インストールはモジュール実行をサポートしています。モジュールには、事前チェック、インストール、ドメイン構成、セットアップ、検証が含まれます。

  • このスクリプトのデバッグの詳細は、/var/log/xdl/ctxinstall.log で確認できます。

詳細については、ヘルプコマンド ctxinstall.sh -h を使用してください。

注：

  • 最小特権の原則に従い、ドメイン参加パスワードがファイルに設定されている可能性があるため、root ユーザーのみが /opt/Citrix/VDA/sbin/ctxinstall.conf を読み取れるようにしてください。
  • Linux VDA をアンインストールすると、/opt/Citrix/VDA の下のファイルが削除されます。VDA をアンインストールする前に、/opt/Citrix/VDA/sbin/ctxinstall.conf をバックアップすることをお勧めします。

ctxinstall.sh は対話モードまたはサイレントモードで実行できます。スクリプトを実行する前に、次の環境変数を設定してください。

  • CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – マシンをドメインに 参加させるかどうか。デフォルト値は ‘n’ です。ドメインに参加しないシナリオでは、’y’ に設定します。

  • CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<path-to-token-file-on-vda-machine>‘ – 簡易インストールを使用してドメインに参加していない VDA を作成するには、Delivery Controller のマシンカタログに VDA を登録するためのトークンファイルが必要です。トークンは、適切なパスの下で最小特権を持つファイルに保存してください。

  • CTX_XDL_VDI_MODE=’y|n’ – マシンを専用デスクトップ配信モデル (VDI) として構成するか、ホスト型共有デスクトップ配信モデルとして構成するか。HDX 3D Pro環境の場合は、値を「y」に設定します。

  • CTX_XDL_HDX_3D_PRO=’y|n’ – Linux VDAは、リッチグラフィックアプリケーションの仮想化を最適化するために設計されたGPUアクセラレーション技術のセットであるHDX 3D Proをサポートしています。HDX 3D Proが選択されている場合、VDAはVDIデスクトップ（シングルセッション）モード（つまり、CTX_XDL_VDI_MODE=’y’）に構成されます。

  • CTX_XDL_START_SERVICE=’y|n’ – 構成が完了したときにLinux VDAサービスを開始するかどうかを決定します。

  • CTX_XDL_REGISTER_SERVICE=’y|n’ – マシンの起動後にLinux仮想デスクトップサービスが開始されます。

  • CTX_XDL_ADD_FIREWALL_RULES=’y|n’ – Linux VDAサービスは、システムファイアウォールを介した受信ネットワーク接続を許可する必要があります。Linux Virtual Desktopの場合、必要なポート（デフォルトではポート80と1494）をシステムファイアウォールで自動的に開くことができます。

  • CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate – セッションで使用するGNOME、GNOME Classic、またはMATEデスクトップ環境を指定します。この変数を指定しない場合、VDAで構成されているデフォルトのデスクトップが使用されます。

  • CTX_XDL_DOTNET_RUNTIME_PATH=’<path-to-install-dotnet-runtime>‘ – 新しいブローカーエージェントサービス (ctxvda) をサポートするために.NETをインストールするパス。デフォルトのパスは「/usr/bin」です。

  • CTX_XDL_VDA_PORT=’<port-number>‘ – Linux VDA は、TCP/IP ポートを介してデリバリーコントローラーとの通信を行います。

考慮事項

  • 以下の手順を実行して、ターゲットセッションユーザーのデスクトップ環境を変更することもできます。

    1. VDA上の$HOME/<username>ディレクトリの下に、.xsessionまたは.Xclientsファイルを作成します。Amazon Linux 2を使用している場合は、.Xclientsファイルを作成します。その他のディストリビューションを使用している場合は、.xsessionファイルを作成します。

    2. ディストリビューションに基づいてデスクトップ環境を指定するために、.xsession または .Xclients ファイルを編集します。

      • MATEデスクトップの場合

         MSESSION="$(type -p mate-session)"
 if [ -n "$MSESSION" ]; then
 exec mate-session
 fi
 <!--NeedCopy-->

      • GNOME Classicデスクトップの場合

         GSESSION="$(type -p gnome-session)"
 if [ -n "$GSESSION" ]; then
 export GNOME_SHELL_SESSION_MODE=classic
 exec gnome-session --session=gnome-classic
 fi
 <!--NeedCopy-->

      • GNOMEデスクトップの場合

         GSESSION="$(type -p gnome-session)"
 if [ -n "$GSESSION" ]; then
 exec gnome-session
 fi
 <!--NeedCopy-->
    3. ターゲットセッションユーザーと700ファイル権限を共有します。

    バージョン2209以降、セッションユーザーはデスクトップ環境をカスタマイズできます。この機能を有効にするには、VDAに切り替え可能なデスクトップ環境を事前にインストールする必要があります。詳細については、「セッションユーザーによるカスタムデスクトップ環境」を参照してください。

対話モード

対話モードで ctxinstall.sh スクリプトを実行するには、-S オプションなしで sudo /opt/Citrix/VDA/sbin/ctxinstall.sh コマンドを使用します。コマンドラインインターフェイスの各プロンプトで関連する変数値を入力します。変数がすでに設定されている場合、ctxinstall.sh は変更するかどうかの確認を求めます。

サイレントモード

サイレントモードでは、/opt/Citrix/VDA/sbin/ctxinstall.conf または export コマンドを使用して、前述の変数を設定する必要があります。その後、ctxinstall.sh -S を実行します（ここで S は 大文字 であることに注意してください）。必要な変数がすべて設定されていないか、一部の値が無効な場合、デフォルト値がない限り、ctxinstall.sh は実行を中止します。

設定した場合、各変数のエクスポートされた値は /Citrix/VDA/sbin/ctxinstall.conf の値を上書きします。更新されたすべての値は /Citrix/VDA/sbin/ctxinstall.conf に保存されます。

export CTX_XDL_NON_DOMAIN_JOINED='y'
export CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE='<token-file-path>'
export CTX_XDL_VDI_MODE='y|n'
export CTX_XDL_START_SERVICE='y|n'
export CTX_XDL_REGISTER_SERVICE='y|n'
export CTX_XDL_ADD_FIREWALL_RULES='y|n'
export CTX_XDL_HDX_3D_PRO='y|n'
export CTX_XDL_DESKTOP_ENVIRONMENT= gnome | gnome-classic | mate | '<none>'
export CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>'
export CTX_XDL_VDA_PORT='<port-number>'
sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh -S
<!--NeedCopy-->

sudo コマンドを実行するときは、-E オプションを入力して、既存の環境変数を新しく作成されるシェルに渡します。前述のコマンドから、最初の行に #!/bin/bash を含むシェルスクリプトファイルを作成することをお勧めします。

または、単一のコマンドを使用してすべての変数を指定することもできます。

VDA実行環境変数（「CTX_XDL_」で始まる変数）を設定するには、ctxinstall.sh -s を実行します（ここで s は 小文字 であることに注意してください）。

ステップ9：XDPing を実行する

Linux VDA環境で一般的な構成の問題を確認するには、sudo /opt/Citrix/VDA/bin/xdping を実行します。詳細については、「XDPing」を参照してください。

ステップ10：Linux VDAを実行する

Linux VDAを起動します。

Linux VDAサービスを開始するには：

sudo systemctl start ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

リナックス VDA を停止する:

Linux VDA サービスを停止するには:

sudo systemctl stop ctxvda.service

sudo systemctl stop ctxhdx.service
<!--NeedCopy-->

注記:

ctxvda および ctxhdx サービスを停止する前に、モニターサービスデーモンを停止するために、systemctl stop ctxmonitord コマンドを実行します。そうしないと、モニターサービスデーモンが停止したサービスを再起動します。

Linux VDA を再起動する:

Linux VDA サービスを再起動するには:

sudo systemctl stop ctxvda.service

sudo systemctl restart ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

Linux VDA のステータスを確認する:

Linux VDA サービスの実行ステータスを確認するには:

sudo systemctl status ctxvda.service

sudo systemctl status ctxhdx.service
<!--NeedCopy-->

ステップ 11: デリバリーグループを作成する

デリバリーグループを作成し、Linux VDA マシンを含むマシンカタログを追加するプロセスは、Windows VDA マシンとほぼ同じです。これらのタスクを完了する方法の詳細については、「デリバリーグループを作成する」を参照してください。

Linux VDA マシンカタログを含むデリバリーグループを作成する場合、以下の制限が適用されます:

  • 選択した AD ユーザーとグループが、Linux VDA マシンにログオンするように適切に構成されていることを確認してください。
  • 認証されていない（匿名）ユーザーのログオンを許可しないでください。
  • デリバリーグループを Windows マシンを含むマシンカタログと混在させないでください。

重要:

アプリケーションの公開は、Linux VDAバージョン1.4以降でサポートされています。ただし、Linux VDAは、デスクトップとアプリを同じマシンに配信することをサポートしていません。

マシンカタログとデリバリーグループの作成方法については、「Citrix Virtual Apps and Desktops 7 2402 LTSR」を参照してください。

イージーインストールを使用してドメインに参加していないLinux VDAを作成する（プレビュー）
August 3, 2026
寄稿者: 
C C
August 3, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.