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

最終公開日 : Nov 13, 2026
この記事では、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では、次の機能が利用できます。
Related information
インストール概要

ステップ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
作成したカタログのUUIDを記録しておきます。このUUIDは、後で登録トークンを作成する際に必要になります。
マシンカタログを作成し、Linux VDAマシンを追加するプロセスは、従来のWindows VDAのアプローチと似ています。これらのタスクを完了する方法の詳細については、「マシンカタログの作成」および「マシンカタログの管理」を参照してください。
Linux VDAマシンを含むマシンカタログを作成する場合、Windows VDAマシン用のマシンカタログを作成するプロセスとは異なるいくつかの制限があります。
  • オペレーティングシステムについては、以下を選択します。
    • ホスト型共有デスクトップ配信モデルの場合は、Multi-session OSオプション。
    • VDI専用デスクトップ配信モデルの場合は、Single-session 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"
}
HTTP POSTメッセージで、CatalogIdを以前に作成したマシンカタログのUUIDに設定し、****を必要に応じて次のいずれかに設定します。
  • 商用 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. Citrix Virtual Apps and Desktops のダウンロードページ にアクセスします。
  2. Citrix Virtual Apps and Desktops の適切なバージョンを展開します。
  3. Components を展開して Linux VDA を見つけます。例:
    Citrix Virtual Apps and Desktops のコンポーネント
  4. Linux VDA リンクをクリックして、Linux VDA のダウンロードにアクセスします。
    Linux VDA のダウンロード
  5. お使いの Linux ディストリビューションに一致する Linux VDA パッケージをダウンロードします。
  6. Linux VDA パッケージの整合性を検証するために使用できる GPG 公開キーをダウンロードします。例:
    GPG公開キー
    公開キーを使用してLinux VDAパッケージの整合性を検証するには：
    • RPMパッケージの場合、公開キーをRPMデータベースにインポートし、パッケージの整合性を確認するには、次のコマンドを実行します：
      rpmkeys --import <path to the public key>
      rpm --checksig --verbose <path to the Linux VDA package>
    • DEBパッケージの場合、公開キーをDEBデータベースにインポートし、パッケージの整合性を確認するには、次のコマンドを実行します：
      sudo apt-get install dpkg-sig
      gpg --import <path to the public key>
      dpkg-sig --verify <path to the Linux VDA package>

ステップ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>
注:
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
Ubuntu/Debianディストリビューションの場合：
sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
注:
  • Debian 11ディストリビューションに必要な依存関係をインストールするには、/etc/apt/sources.listファイルにdeb http://deb.debian.org/debian/ bullseye mainの行を追加します。
  • GCP上のUbuntu 20.04では、RDNSを無効にします。これを行うには、/etc/krb5.confの**の下に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>

ステップ 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 を指定できます。
そのためには、sudo /opt/Citrix/VDA/sbin/ctxinstall.sh または /opt/Citrix/VDA/bin/easyinstall を実行する前に、/etc/xdl/db.conf を編集します。
注:
  • 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 をカスタマイズすることをお勧めします。構成ファイルを初めて作成するときは、次のいずれかの方法を使用します。
    • /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl テンプレートファイルをコピーし、/opt/Citrix/VDA/sbin/ctxinstall.conf として保存します。
    • ctxinstall.sh を実行します。ctxinstall.sh を実行するたびに、入力は /opt/Citrix/VDA/sbin/ctxinstall.conf に保存されます。
  • 簡単インストールはモジュール式の実行をサポートしています。モジュールには、事前チェック、インストール、ドメイン構成、セットアップ、検証が含まれます。
  • このスクリプトのデバッグの詳細は、/var/log/xdl/ctxinstall.log で確認できます。
詳細については、ヘルプコマンド ctxinstall.sh -h を使用してください。
注:
  • 最小権限の原則に従い、ドメイン参加パスワードがファイルに設定されている可能性があるため、ルートユーザーのみが /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\>' – easy installを使用してドメインに参加していない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 Virtual Desktopサービスが開始されます。
  • 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ポートを介してDelivery Controllerと通信します。

考慮事項

  • ターゲットセッションユーザーのデスクトップ環境は、次の手順を実行して変更することもできます。
    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
      • GNOME Classicデスクトップの場合
        GSESSION="$(type -p gnome-session)"  
        if [ -n "$GSESSION" ]; then  
        export GNOME_SHELL_SESSION_MODE=classic  
        exec gnome-session --session=gnome-classic  
        fi  
      • GNOMEデスクトップの場合
        GSESSION="$(type -p gnome-session)"  
        if [ -n "$GSESSION" ]; then  
        exec gnome-session  
        fi  
    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
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
Linux VDAを停止する:
Linux VDAサービスを停止するには:
sudo systemctl stop ctxvda.service

sudo systemctl stop ctxhdx.service
注:
ctxvdaサービスとctxhdxサービスを停止する前に、モニターサービスデーモンを停止するために、systemctl stop ctxmonitordコマンドを実行します。そうしないと、モニターサービスデーモンが停止したサービスを再起動します。
Linux VDAを再起動する:
Linux VDAサービスを再起動するには:
sudo systemctl stop ctxvda.service

sudo systemctl restart ctxhdx.service

sudo systemctl start ctxvda.service
Linux VDAのステータスを確認する:
Linux VDAサービスの実行ステータスを確認するには:
sudo systemctl status ctxvda.service

sudo systemctl status ctxhdx.service

ステップ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を参照してください。