簡単インストールを使用してドメインに参加していない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も使用できます。詳細については、Create non-domain-joined Linux VDAs using MCSを参照してください。
    • 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 Runtime 6.0 のインストール

Linux VDA をインストールする前に、<https://docs.microsoft.com/ja-jp/dotnet/core/install/linux-package-managers> の手順に従って .NET Runtime 6.0 をインストールします。
.NET Runtime 6.0 をインストールした後、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公開鍵(/en-us/linux-virtual-delivery-agent/2311/media/gpg-key.png)
    公開鍵を使用して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.2/9.0およびRocky Linux 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 ドライバーをインストールします。

手順 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を使用します。
  • PostgreSQLのポート番号を設定するには、/etc/xdl/db.conf を使用することもできます。

ステップ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\>' – 簡単インストールを使用してドメインに参加していない 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 Runtime 6.0 をインストールするパス。デフォルトのパスは「/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 2311を参照してください。