Linux Virtual Delivery Agent 2201

イージーインストールによる迅速なインストール (推奨)

April 20, 2026

寄稿者:

C C

Step 2

重要:

新規インストールの場合、迅速なインストールについてはこの記事を参照することをお勧めします。この記事では、イージーインストールを使用して Linux VDA をインストールおよび構成する方法を順を追って説明します。イージーインストールは、時間と労力を節約し、手動インストールよりもエラーが発生しにくいです。必要なパッケージをインストールし、構成ファイルを自動的にカスタマイズすることで、Linux VDA の稼働環境をセットアップするのに役立ちます。

ドメインに参加していない VDA を作成するには、Machine Creation Services (MCS) を使用する必要があります。詳細については、「Machine Creation Services (MCS) を使用した Linux VM の作成」を参照してください。

ドメインに参加していない VDA で利用可能な機能については、「ドメインに参加していない VDA」にアクセスしてください。

ステップ 1: 構成情報と Linux マシンの準備

イージーインストールに必要な次の構成情報を収集します。
ホスト名 - Linux VDA をインストールするマシンのホスト名
ドメインネームサーバーの IP アドレス
NTP サーバーの IP アドレスまたは文字列名
ドメイン名 - ドメインの NetBIOS 名
レルム名 - Kerberos レルム名
ドメインの完全修飾ドメイン名 (FQDN)

重要:

Linux VDA をインストールするには、Linux マシンにリポジトリが正しく追加されていることを確認します。

セッションを起動するには、X Window System とデスクトップ環境がインストールされていることを確認します。

考慮事項

ワークグループ名は、デフォルトでドメイン名です。環境でワークグループをカスタマイズするには、次の手順を実行します。

a. Linux VDA マシン上に /tmp/ctxinstall.conf ファイルを作成します。 b. ファイルに workgroup=<your workgroup> の行を追加し、変更を保存します。
- Centrify は純粋な IPv6 DNS 構成をサポートしていません。adclient が AD サービスを適切に検出するには、/etc/resolv.conf に IPv4 を使用する DNS サーバーが少なくとも 1 つ必要です。
- ログ:
```
 ADSITE   : Check that this machine's subnet is in a site known by AD   : Failed
          : This machine's subnet is not known by AD.
          : We guess you should be in the site Site1.
 
```
この問題は Centrify とその構成に固有のものです。この問題を解決するには、次の手順を実行します。

a. ドメインコントローラーで ［管理ツール］ を開きます。 b. ［Active Directory サイトとサービス］ を選択します。 c. ［サブネット］ に適切なサブネットアドレスを追加します。

VDA を特定の OU に参加させるには、次の手順を実行します。

1. 特定の OU がドメインコントローラーに存在することを確認します。
OU の例については、次のスクリーンショットを参照してください。
1. VDA 上に /tmp/ctxinstall.conf ファイルを作成します。 1. /tmp/ctxinstall.conf ファイルに ou=<your ou> の行を追加します。
OU の値は、AD の方法によって異なります。次の表を参照してください。

OS	Winbind	SSSD	Centrify	PBIS
Amazon Linux 2	`ou="Linux/amazon"`	`ou="Linux/amazon"`	`ou="XD.LOCAL/Linux/amazon"`	`ou="Linux/amazon"`
Debian	`ou="Linux/debian"`	`ou="Linux/debian"`	`ou="XD.LOCAL/Linux/debian"`	`ou="Linux/debian"`
RHEL 8	`ou="OU=redhat,OU=Linux"`	`ou="OU=redhat,OU=Linux"`	`ou="XD.LOCAL/Linux/redhat"`	`ou="Linux/redhat"`
RHEL 7	`ou="Linux/redhat"`	`ou="Linux/redhat"`	`ou="XD.LOCAL/Linux/redhat"`	`ou="Linux/redhat"`
SUSE	`ou="Linux/suse"`	`ou="Linux/suse"`	`ou="XD.LOCAL/Linux/suse"`	`ou="Linux/suse"`
Ubuntu	`ou="Linux/ubuntu"`	`ou="Linux/ubuntu"`	`ou="XD.LOCAL/Linux/ubuntu"`	`ou="Linux/ubuntu"`

イージーインストールは、Linux VDA 7.16 以降、純粋な IPv6 をサポートしています。次の前提条件と制限が適用されます。
マシンが純粋な IPv6 ネットワーク経由で必要なパッケージをダウンロードできるように、Linux リポジトリを構成する必要があります。
Centrify は純粋な IPv6 ネットワークではサポートされていません。

注:

ネットワークが純粋な IPv6 であり、すべての入力が適切な IPv6 形式である場合、VDA は IPv6 を介して Delivery Controller™ に登録されます。ネットワークが IPv4 と IPv6 のハイブリッド構成である場合、最初の DNS IP アドレスのタイプによって、登録に IPv4 と IPv6 のどちらが使用されるかが決まります。

ドメインに参加する方法として Centrify を選択した場合、ctxinstall.sh スクリプトには Centrify パッケージが必要です。ctxinstall.sh が Centrify パッケージを取得する方法は 2 つあります。
- イージーインストールは、Centrify パッケージをインターネットから自動的にダウンロードするのに役立ちます。各ディストリビューションの URL は次のとおりです。
  
  RHEL: wget http://edge.centrify.com/products/centrify-suite/2016-update-1/installers/centrify-suite-2016.1-rhel4-x86_64.tgz?_ga=1.178323680.558673738.1478847956

CentOS: wget http://edge.centrify.com/products/centrify-suite/2016-update-1/installers/centrify-suite-2016.1-rhel4-x86_64.tgz?_ga=1.186648044.558673738.1478847956

 SUSE: wget <http://edge.centrify.com/products/centrify-suite/2016-update-1/installers/centrify-suite-2016.1-suse10-x86_64.tgz?_ga=1.10831088.558673738.1478847956>

 Ubuntu/Debian: wget <https://downloads.centrify.com/products/infrastructure-services/19.9/centrify-infrastructure-services-19.9-deb8-x86_64.tgz?_ga=2.151462329.1042350071.1592881996-604509155.1572850145>

ローカルディレクトリから Centrify パッケージを取得します。Centrify パッケージのディレクトリを指定するには、次の手順を実行します。

a. Linux VDA サーバー上に /tmp/ctxinstall.conf ファイルが存在しない場合は作成します。 b. ファイルに「centrifypkgpath=<path name>」の行を追加します。

例:

 cat /tmp/ctxinstall.conf
 set "centrifypkgpath=/home/mydir"
 ls  -ls  /home/mydir
     9548 -r-xr-xr-x. 1 root root  9776688 May 13  2016 adcheck-rhel4-x86_64
 4140 -r--r--r--. 1 root root 4236714 Apr 21 2016 centrifyda-3.3.1-rhel4-x86_64.rpm
   33492 -r--r--r--. 1 root root 34292673 May 13  2016 centrifydc-5.3.1-rhel4-x86_64.rpm
     4 -rw-rw-r--. 1 root root     1168 Dec  1  2015 centrifydc-install.cfg
     756 -r--r--r--. 1 root root   770991 May 13  2016 centrifydc-ldapproxy-5.3.1-rhel4-x86_64.rpm
     268 -r--r--r--. 1 root root   271296 May 13  2016 centrifydc-nis-5.3.1-rhel4-x86_64.rpm
     1888 -r--r--r--. 1 root root  1930084 Apr 12  2016 centrifydc-openssh-7.2p2-5.3.1-rhel4-x86_64.rpm
     124 -rw-rw-r--. 1 root root   124543 Apr 19  2016 centrify-suite.cfg
     0 lrwxrwxrwx. 1 root root       10 Jul  9  2012 install-express.sh -> install.sh
     332 -r-xr-xr--. 1 root root   338292 Apr 10  2016 install.sh
     12 -r--r--r--. 1 root root    11166 Apr  9  2015 release-notes-agent-rhel4-x86_64.txt
     4 -r--r--r--. 1 root root     3732 Aug 24  2015 release-notes-da-rhel4-x86_64.txt
     4 -r--r--r--. 1 root root     2749 Apr  7  2015 release-notes-nis-rhel4-x86_64.txt
     12 -r--r--r--. 1 root root     9133 Mar 21  2016 release-notes-openssh-rhel4-x86_64.txt
 <!--NeedCopy-->

ドメイン参加方法として PBIS を選択した場合、ctxinstall.sh スクリプトには PBIS パッケージが必要です。ctxinstall.sh が PBIS パッケージを取得する方法は次の 2 つです。
- 簡易インストールは、インターネットから PBIS パッケージを自動的にダウンロードするのに役立ちます。各ディストリビューションの URL は次のとおりです。
  
  CentOS 7、RHEL 7、SUSE 12.5: wget https://github.com/BeyondTrust/pbis-open/releases/download/8.8.0/pbis-open-8.8.0.506.linux.x86_64.rpm.sh
  
  Amazon Linux 2、RHEL 8、SUSE 15.3、SUSE 15.2: wget https://github.com/BeyondTrust/pbis-open/releases/download/9.1.0/pbis-open-9.1.0.551.linux.x86_64.rpm.sh
  
  Debian、Ubuntu: wget https://github.com/BeyondTrust/pbis-open/releases/download/8.8.0/pbis-open-8.8.0.506.linux.x86_64.deb.sh
- インターネットから特定のバージョンの PBIS パッケージを取得します。これを行うには、/opt/Citrix/VDA/sbin/ctxinstall.sh ファイル内の “pbisDownloadPath” 行を PBIS パッケージの URL を指定するように変更します。
  
  例については、次のスクリーンショットを参照してください。

ステップ 2: ハイパーバイザーの準備

サポートされているハイパーバイザー上で Linux VDA を仮想マシンとして実行する場合、いくつかの変更が必要です。使用しているハイパーバイザープラットフォームに基づいて、次の変更を行ってください。Linux マシンをベアメタルハードウェアで実行している場合、変更は不要です。

Citrix Hypervisor™ での時刻同期の修正

Citrix Hypervisor のタイム同期機能が有効になっている場合、各パラバーチャライズド Linux VM 内で NTP と Citrix Hypervisor の両方がシステムクロックを管理しようとするため、問題が発生します。クロックが他のサーバーと同期しなくなるのを避けるため、各 Linux ゲスト内のシステムクロックが NTP と同期していることを確認してください。この場合、ホストの時刻同期を無効にする必要があります。HVM モードでは変更は不要です。

Citrix VM Tools がインストールされたパラバーチャライズド Linux カーネルを実行している場合、Linux VM 内から Citrix Hypervisor のタイム同期機能が存在し、有効になっているかどうかを確認できます。

su -

cat /proc/sys/xen/independent_wallclock
<!--NeedCopy-->

このコマンドは 0 または 1 を返します。

0 - タイム同期機能が有効になっており、無効にする必要があります。
1 - タイム同期機能が無効になっており、それ以上の操作は不要です。

/proc/sys/xen/independent_wallclock ファイルが存在しない場合、以下の手順は不要です。

有効になっている場合は、ファイルに 1 を書き込むことでタイム同期機能を無効にします。

sudo echo 1 > /proc/sys/xen/independent_wallclock
<!--NeedCopy-->

この変更を再起動後も永続的にするには、/etc/sysctl.conf ファイルを編集し、次の行を追加します。

xen.independent_wallclock = 1
これらの変更を確認するには、システムを再起動します。

su -

cat /proc/sys/xen/independent_wallclock
<!--NeedCopy-->

このコマンドは値 1 を返します。

Microsoft Hyper-V での時刻同期の修正

Hyper-V Linux Integration Services がインストールされている Linux VM は、Hyper-V の時刻同期機能を使用してホストオペレーティングシステムの時刻を使用できます。システムクロックの正確性を確保するには、NTP サービスと並行してこの機能を有効にする必要があります。

管理オペレーティングシステムから:

Hyper-V マネージャーコンソールを開きます。
Linux VM の設定で、[統合サービス] を選択します。
[時刻の同期] が選択されていることを確認します。

注:

このアプローチは、NTP との競合を避けるためにホストの時刻同期が無効になっている VMware や Citrix Hypervisor とは異なります。Hyper-V の時刻同期は、NTP の時刻同期と共存し、補完することができます。

ESX および ESXi での時刻同期の修正
VMware の時刻同期機能が有効になっている場合、各パラバーチャライズド Linux VM 内で NTP とハイパーバイザーの両方がシステムクロックを同期しようとするため、問題が発生します。クロックが他のサーバーと同期しなくなるのを避けるため、各 Linux ゲスト内のシステムクロックが NTP と同期していることを確認してください。この場合、ホストの時刻同期を無効にする必要があります。
VMware Tools がインストールされたパラバーチャライズド Linux カーネルを実行している場合:

vSphere Client を開きます。

1. Linux VM の設定を編集します。
1. [仮想マシンのプロパティ] ダイアログで、[オプション] タブを開きます。
1. [VMware Tools] を選択します。
1. [詳細設定] ボックスで、[ゲストの時刻をホストと同期] のチェックを外します。
ステップ 3: (Ubuntu 16.04 のみ) OpenJDK 11 のインストール
Ubuntu 16.04 に OpenJDK 11 をインストールするには、次の手順を実行します。
1. 最新の OpenJDK 11 を https://jdk.java.net/archive/ からダウンロードします。
1. tar zxf openjdk-11.0.2_linux-x64_bin.tar.gz コマンドを実行して、ダウンロードしたパッケージを解凍します。
1. (オプション) mv jdk-11.0.2/ <target directory> コマンドを実行して、OpenJDK をターゲットディレクトリに保存します。
1. update-alternatives --install /usr/bin/java java <custom directory>/bin/java 2000 コマンドを実行して、Java ランタイムを設定します。

java -version コマンドを実行して、Java のバージョンを確認します。

手順 4: Linux VDA パッケージのダウンロード

Citrix Virtual Apps and Desktops ダウンロードページにアクセスします。適切なバージョンの Citrix Virtual Apps and Desktops を展開し、[コンポーネント] をクリックして、お使いの Linux ディストリビューションに一致する Linux VDA パッケージをダウンロードします。

手順 5: Linux VDA パッケージのインストール

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

RHEL および CentOS ディストリビューションの場合:

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

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

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

注:

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

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

-  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 ドライバーをインストールして構成するには、次の一般的な手順を実行します。

ゲスト VM がシャットダウンされていることを確認します。
ハイパーバイザーのコントロールパネルで、VM に GPU を割り当てます。
VM を起動します。
VM にゲスト VM ドライバーをインストールします。

手順 7: インストールを完了するためのランタイム環境のセットアップ

注:

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

Linux VDA パッケージをインストールした後、ctxinstall.sh スクリプトを使用して実行環境を構成します。このスクリプトは、対話モードまたはサイレントモードで実行できます。

注:

Easy Install は、27 MB を超える .NET ランタイムをダウンロードしている間、応答しないように見える場合があります。ダウンロードの進行状況については、/var/log/ctxinstall.log を確認してください。

対話モード:

手動で構成するには、次のコマンドを実行し、各プロンプトで関連するパラメーターを入力します。

sudo /opt/Citrix/VDA/sbin/ctxinstall.sh
<!--NeedCopy-->

サイレントモード:

サイレントモードで Easy Install を使用するには、ctxinstall.sh を実行する前に次の環境変数を設定します。

CTX_EASYINSTALL_HOSTNAME=host-name – Linux VDA サーバーのホスト名を示します。
- CTX_EASYINSTALL_DNS=ip-address-of-dns – DNS の IP アドレス。
- CTX_EASYINSTALL_NTPS=address-of-ntps – NTP サーバーの IP アドレスまたは文字列名。
CTX_EASYINSTALL_DOMAIN=domain-name – ドメインの NetBIOS 名。
CTX_EASYINSTALL_REALM=realm-name – Kerberos レルム名。
CTX_EASYINSTALL_FQDN=ad-fqdn-name
CTX_EASYINSTALL_ADINTEGRATIONWAY=winbind | sssd | centrify | pbis – Active Directory 統合方法を示します。
CTX_EASYINSTALL_USERNAME=domain-user-name – ドメインユーザーの名前を示します。ドメインへの参加に使用されます。
CTX_EASYINSTALL_PASSWORD=password – ドメインユーザーのパスワードを指定します。ドメインへの参加に使用されます。

ctxsetup.sh スクリプトは次の変数を使用します。

CTX_XDL_SUPPORT_DDC_AS_CNAME=Y | N – Linux VDA は、DNS CNAME レコードを使用して Delivery Controller 名を指定することをサポートしています。
CTX_XDL_DDC_LIST=’list-ddc-fqdns’ – Linux VDA は、Delivery Controller に登録するために、スペースで区切られた Delivery Controller の完全修飾ドメイン名 (FQDN) のリストを必要とします。少なくとも 1 つの FQDN または CNAME を指定する必要があります。
CTX_XDL_VDA_PORT=port-number – Linux VDA は、TCP/IP ポートを介して Delivery Controller と通信します。
CTX_XDL_REGISTER_SERVICE=Y | N – Linux Virtual Desktop サービスは、マシンの起動後に開始されます。
CTX_XDL_ADD_FIREWALL_RULES=Y | N – Linux Virtual Desktop サービスでは、システムファイアウォールを介した受信ネットワーク接続が許可されている必要があります。Linux Virtual Desktop のシステムファイアウォールで、必要なポート (デフォルトではポート 80 および 1494) を自動的に開くことができます。
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_VDI_MODE=Y | N – マシンを専用デスクトップ配信モデル (VDI) として構成するか、ホスト型共有デスクトップ配信モデルとして構成するか。HDX 3D Pro 環境の場合は、値を Y に設定します。
CTX_XDL_SITE_NAME=dns-name – Linux VDA は DNS を介して LDAP サーバーを検出します。DNS 検索結果をローカルサイトに制限するには、DNS サイト名を指定します。不要な場合は、<none> に設定します。
CTX_XDL_LDAP_LIST=’list-ldap-servers’ – Linux VDA は DNS にクエリを実行して LDAP サーバーを検出します。DNS が LDAP サービスレコードを提供できない場合は、LDAP ポートを含むスペース区切りの LDAP FQDN のリストを指定できます。例: ad1.mycompany.com:389。不要な場合は、<none> に設定します。
CTX_XDL_SEARCH_BASE=search-base-set – Linux VDA は、Active Directory ドメインのルート (例: DC=mycompany,DC=com) に設定された検索ベースを介して LDAP にクエリを実行します。検索パフォーマンスを向上させるには、検索ベース (例: OU=VDI,DC=mycompany,DC=com) を指定できます。不要な場合は、<none> に設定します。
CTX_XDL_FAS_LIST=’list-fas-servers’ – フェデレーション認証サービス (FAS) サーバーは、AD グループポリシーを介して構成されます。Linux VDA は AD グループポリシーをサポートしていませんが、代わりにセミコロンで区切られた FAS サーバーのリストを提供できます。シーケンスは、AD グループポリシーで構成されているものと同じである必要があります。サーバーアドレスが削除された場合は、その空白をテキスト文字列 <none> で埋め、サーバーアドレスの順序を変更しないでください。
CTX_XDL_DOTNET_RUNTIME_PATH=path-to-install-dotnet-runtime – 新しいブローカーエージェントサービス (ctxvda) をサポートするための .NET Runtime 6.0 をインストールするパス。デフォルトのパスは /usr/bin です。
CTX_XDL_DESKTOP_ENVIRONMENT=gnome/mate – セッションで使用する GNOME または MATE デスクトップ環境を指定します。変数を指定しない場合、VDA に現在インストールされているデスクトップが使用されます。ただし、現在インストールされているデスクトップが MATE の場合は、変数の値を mate に設定する必要があります。
注:

ターゲットセッションユーザーのデスクトップ環境は、次の手順を実行して変更することもできます。
1. VDA の $HOME/<username> ディレクトリの下に .xsession または .Xclients ファイルを作成します。Amazon Linux 2 を使用している場合は、.Xclients ファイルを作成します。他のディストリビューションを使用している場合は、.xsession ファイルを作成します。
2. .xsession または .Xclients ファイルを編集して、ディストリビューションに基づいてデスクトップ環境を指定します。
- Amazon Linux 2、CentOS、Debian、RHEL、SUSE 15、および Ubuntu の MATE デスクトップの場合
  MSESSION="$(type -p mate-session)" > if [ -n "$MSESSION" ]; then > exec mate-session > fi > >- **CentOS、RHEL、SUSE 15、SUSE 12.5 の GNOME デスクトップの場合** > > GSESSION="$(type -p gnome-session)" > if [ -n "$GSESSION" ]; then > export GNOME_SHELL_SESSION_MODE=classic exec gnome-session --session=gnome-classic fi
- Amazon Linux 2、Ubuntu、Debian の GNOME デスクトップの場合
  GSESSION="$(type -p gnome-session)" if [ -n "$GSESSION" ]; then exec gnome-session fi 1. ターゲットセッションユーザーと 700 ファイル権限を共有します。
**CTX_XDL_START_SERVICE=Y N** – 構成完了時に Linux VDA サービスを開始するかどうか。
CTX_XDL_TELEMETRY_SOCKET_PORT – Citrix Scout のリスニング用ソケットポート。デフォルトポートは 7503。
CTX_XDL_TELEMETRY_PORT – Citrix Scout との通信用ポート。デフォルトポートは 7502。
パラメーターが設定されていない場合、インストールは対話モードにロールバックされ、ユーザー入力が求められます。すべてのパラメーターが環境変数を通じてすでに設定されている場合でも、ctxinstall.sh スクリプトは .NET Runtime 6.0 のインストールパスについてユーザー入力を求めます。

サイレントモードでは、環境変数を設定し、その後 ctxinstall.sh スクリプトを実行するために、次のコマンドを実行する必要があります。

export CTX_EASYINSTALL_HOSTNAME=host-name

export CTX_EASYINSTALL_DNS=ip-address-of-dns

export CTX_EASYINSTALL_NTPS=address-of-ntps

export CTX_EASYINSTALL_DOMAIN=domain-name

export CTX_EASYINSTALL_REALM=realm-name

export CTX_EASYINSTALL_FQDN=ad-fqdn-name

-  export CTX_EASYINSTALL_ADINTEGRATIONWAY=winbind | sssd | centrify | pbis

export CTX_EASYINSTALL_USERNAME=domain-user-name

export CTX_EASYINSTALL_PASSWORD=password

export CTX_XDL_SUPPORT_DDC_AS_CNAME=Y | N

export CTX_XDL_DDC_LIST='list-ddc-fqdns'

export CTX_XDL_VDA_PORT=port-number

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_VDI_MODE=Y | N

export CTX_XDL_SITE_NAME=dns-site-name | '<none>'

export CTX_XDL_LDAP_LIST='list-ldap-servers' | '<none>'

export CTX_XDL_SEARCH_BASE=search-base-set | '<none>'

export CTX_XDL_FAS_LIST='list-fas-servers' | '<none>'

export CTX_XDL_DOTNET_RUNTIME_PATH=path-to-install-dotnet-runtime

export CTX_XDL_DESKTOP_ENVIRONMENT= gnome | mate | '<none>'

export CTX_XDL_TELEMETRY_SOCKET_PORT=port-number

export CTX_XDL_TELEMETRY_PORT=port-number

export CTX_XDL_START_SERVICE=Y | N

sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh
<!--NeedCopy-->

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

または、単一のコマンドを使用してすべてのパラメーターを指定することもできます。

sudo CTX_XDL_SUPPORT_DDC_AS_CNAME=Y|N \

CTX_XDL_DDC_LIST='list-ddc-fqdns' \

CTX_XDL_VDA_PORT=port-number \

CTX_XDL_REGISTER_SERVICE=Y|N \

CTX_XDL_ADD_FIREWALL_RULES=Y|N \

CTX_XDL_AD_INTEGRATION=1|2|3|4 \

CTX_XDL_HDX_3D_PRO=Y|N \

CTX_XDL_VDI_MODE=Y|N \

CTX_XDL_SITE_NAME=dns-name \

CTX_XDL_LDAP_LIST='list-ldap-servers' \

CTX_XDL_SEARCH_BASE=search-base-set \

CTX_XDL_FAS_LIST='list-fas-servers' \

CTX_XDL_DOTNET_RUNTIME_PATH=path-to-install-dotnet-runtime \

CTX_XDL_DESKTOP_ENVIRONMENT=gnome | mate \

CTX_XDL_TELEMETRY_SOCKET_PORT=port-number \

CTX_XDL_TELEMETRY_PORT=port-number \

CTX_XDL_START_SERVICE=Y|N \

/opt/Citrix/VDA/sbin/ctxsetup.sh
<!--NeedCopy-->

ステップ 8: XDPing の実行

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

ステップ 9: Linux VDA の実行

Linux VDA の開始:

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

sudo /sbin/service ctxhdx start

sudo /sbin/service ctxvda start
<!--NeedCopy-->

Linux VDA の停止:

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

sudo /sbin/service ctxvda stop

sudo /sbin/service ctxhdx stop
<!--NeedCopy-->

注:

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

Linux VDA の再起動:

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

sudo /sbin/service ctxvda stop

sudo /sbin/service ctxhdx restart

sudo /sbin/service ctxvda start
<!--NeedCopy-->

Linux VDA のステータスの確認:

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

sudo /sbin/service ctxvda status

sudo /sbin/service ctxhdx status
<!--NeedCopy-->

ステップ 10: Citrix Virtual Apps または Citrix Virtual Desktops™ でのマシンカタログの作成

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

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

オペレーティングシステムには、以下を選択します。
- ホスト型共有デスクトップ配信モデルの場合は、Multi-session OS オプション
- VDI 専用デスクトップ配信モデルの場合は、Single-session OS オプション
同じマシンカタログ内で Linux VDA マシンと Windows VDA マシンを混在させないでください。

注:

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

ヒント:

マシンを Active Directory ドメインから削除して再参加させる場合は、マシンをマシンカタログから削除して再度追加する必要があります。

ステップ 11: Citrix Virtual Apps™ または Citrix Virtual Desktops でのデリバリーグループの作成

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

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

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

重要:

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

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

トラブルシューティング

このセクションの情報を使用して、簡易インストール機能の使用から生じる可能性のある問題のトラブルシューティングを行います。

SSSD を使用したドメイン参加の失敗

ドメインへの参加を試行すると、次のような出力でエラーが発生する場合があります（画面出力についてはログを確認してください）。

Step 6: join Domain!Enter ctxadmin's password:Failed to join domain: failed to lookup DC info for domain 'CITRIXLAB.LOCAL' over rpc: The network name cannot be found

/var/log/xdl/vda.log:

2016-11-04 02:11:52.317 [INFO ] - The Citrix Desktop Service successfully obtained the following list of 1 delivery controller(s) with which to register: 'CTXDDC.citrixlab.local (10.158.139.214)'.
2016-11-04 02:11:52.362 [ERROR] - RegistrationManager.AttemptRegistrationWithSingleDdc: Failed to register with http://CTXDDC.citrixlab.local:80/Citrix/CdsController/IRegistrar. Error: General security error (An error occurred in trying to obtain a TGT: Client not found in Kerberos database (6))
2016-11-04 02:11:52.362 [ERROR] - The Citrix Desktop Service cannot connect to the delivery controller 'http://CTXDDC.citrixlab.local:80/Citrix/CdsController/IRegistrar' (IP Address '10.158.139.214')
Check the following:- The system clock is in sync between this machine and the delivery controller.
-  The Active Directory provider (e.g. winbind daemon) service is running and correctly configured.
-  Kerberos is correctly configured on this machine.
If the problem persists, please refer to Citrix Knowledge Base article CTX117248 for further information.
Error Details:
Exception 'General security error (An error occurred in trying to obtain a TGT: Client not found in Kerberos database (6))' of type 'class javax.xml.ws.soap.SOAPFaultException'.
2016-11-04 02:11:52.362 [INFO ] - RegistrationManager.AttemptRegistrationWithSingleDdc: The current time for this VDA is Fri Nov 04 02:11:52 EDT 2016.
Ensure that the system clock is in sync between this machine and the delivery controller.
Verify the NTP daemon is running on this machine and is correctly configured.
2016-11-04 02:11:52.364 [ERROR] - Could not register with any controllers. Waiting to try again in 120000 ms. Multi-forest - false
2016-11-04 02:11:52.365 [INFO ] - The Citrix Desktop Service failed to register with any controllers in the last 470 minutes.
<!--NeedCopy-->

/var/log/messages:

Nov 4 02:15:27 RH-WS-68 [sssd[ldap_child[14867]]]: Failed to initialize credentials using keytab [MEMORY:/etc/krb5.keytab]: Client 'RH-WS-68$@CITRIXLAB.LOCAL' not found in Kerberos database. Unable to create GSSAPI-encrypted LDAP connection.Nov 4 02:15:27 RH-WS-68 [sssd[ldap_child[14867]]]: Client 'RH-WS-68$@CITRIXLAB.LOCAL' not found in Kerberos database

この問題を解決するには:

rm -f /etc/krb5.keytab コマンドを実行
net ads leave $REALM -U $domain-administrator コマンドを実行
Delivery Controller でマシンカタログとデリバリーグループを削除
/opt/Citrix/VDA/sbin/ctxinstall.sh を実行
Delivery Controller でマシンカタログとデリバリーグループを作成

Ubuntuデスクトップセッションのグレースクリーン表示

この問題は、セッションを起動した後に空白のデスクトップでブロックされる場合に発生します。さらに、ローカルユーザーアカウントを使用してログオンすると、マシンのコンソールにもグレースクリーンが表示されます。

この問題を解決するには:

sudo apt-get update コマンドを実行
sudo apt-get install unity lightdm コマンドを実行
/etc/lightdm/lightdm.conf に次の行を追加 greeter-show-manual-login=true

ホームディレクトリの欠落によるUbuntuデスクトップセッション起動の失敗

/var/log/xdl/hdx.log:

2016-11-02 13:21:19.015 <P22492:S1> citrix-ctxlogin: StartUserSession: failed to change to directory(/home/CITRIXLAB/ctxadmin) errno(2)

2016-11-02 13:21:19.017 <P22227> citrix-ctxhdx: logSessionEvent: Session started for user ctxadmin.

2016-11-02 13:21:19.023 <P22492:S1> citrix-ctxlogin: ChildPipeCallback: Login Process died: normal.

2016-11-02 13:21:59.217 <P22449:S1> citrix-ctxgfx: main: Exiting normally.
<!--NeedCopy-->

ヒント:

この問題の根本原因は、ドメイン管理者のホームディレクトリが作成されていないことです。

この問題を解決するには:

コマンドラインから **pam-auth-update** と入力
表示されるダイアログで、**Create home directory login** が選択されていることを確認

Ubuntuセッションを起動できません

dbusエラーによるセッションの起動失敗または即時終了

/var/log/messages (RHELまたはCentOSの場合):

Oct 27 04:17:16 CentOS7 citrix-ctxhdx[8978]: Session started for user CITRIXLAB\ctxadmin.

Oct 27 04:17:18 CentOS7 kernel: traps: gnome-session[19146] trap int3 ip:7f89b3bde8d3 sp:7fff8c3409d0 error:0

Oct 27 04:17:18 CentOS7 gnome-session[19146]: ERROR: Failed to connect to system bus: Exhausted all available authentication mechanisms (tried: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS) (available: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS)#012aborting...

Oct 27 04:17:18 CentOS7 gnome-session: gnome-session[19146]: ERROR: Failed to connect to system bus: Exhausted all available authentication mechanisms (tried: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS) (available: EXTERNAL, DBUS_COOKIE_SHA1, ANONYMOUS)

Oct 27 04:17:18 CentOS7 gnome-session: aborting...

Oct 27 04:17:18 CentOS7 citrix-ctxgfx[18981]: Exiting normally.

Oct 27 04:17:18 CentOS7 citrix-ctxhdx[8978]: Session stopped for user CITRIXLAB\ctxadmin.
<!--NeedCopy-->

または、Ubuntuディストリビューションの場合は、/var/log/syslog ログを使用します:

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25326]: [pulseaudio] pid.c: Stale PID file, overwriting.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25326]: [pulseaudio] bluez5-util.c: Failed to get D-Bus connection: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25326]: [pulseaudio] hashmap.c: Assertion 'h' failed at pulsecore/hashmap.c:116, function pa_hashmap_free(). Aborting.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25352]: [pulseaudio] core-util.c: Failed to connect to system bus: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25352]: message repeated 10 times: [ [pulseaudio] core-util.c: Failed to connect to system bus: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.]

Nov  3 11:03:52 user01-HVM-domU pulseaudio[25352]: [pulseaudio] pid.c: Daemon already running.Nov  3 11:03:58 user01-HVM-domU citrix-ctxgfx[24693]: Exiting normally
<!--NeedCopy-->

一部のグループまたはモジュールは、再起動するまで有効になりません。ログに **dbus** エラーメッセージが表示される場合は、システムを再起動して再試行することをお勧めします。

SELinuxによるSSHDのホームディレクトリへのアクセス妨害

ユーザーはセッションを起動できますが、ログオンできません。

/var/log/ctxinstall.log:

Jan 25 23:30:31 yz-rhel72-1 setroubleshoot[3945]: SELinux is preventing /usr/sbin/sshd from setattr access on the directory /root. For complete SELinux messages. run sealert -l 32f52c1f-8ff9-4566-a698-963a79f16b81

Jan 25 23:30:31 yz-rhel72-1 python[3945]: SELinux is preventing /usr/sbin/sshd from setattr access on the directory /root.

*****  Plugin catchall_boolean (89.3 confidence) suggests   ******************

If you want to allow polyinstantiation to enabled

   Then you must tell SELinux about this by enabling the 'polyinstantiation_enabled' boolean.

You can read 'None' man page for more details.

    Do

       setsebool -P polyinstantiation_enabled 1

*****  Plugin catchall (11.6 confidence) suggests   **************************

If you believe that sshd should be allowed setattr access on the root directory by default.

Then you should report this as a bug.

You can generate a local policy module to allow this access.

      Do

       allow this access for now by executing:

       # grep sshd /var/log/audit/audit.log | audit2allow -M mypol

# semodule -i mypol.pp
<!--NeedCopy-->

この問題を解決するには:

/etc/selinux/config に次の変更を加えてSELinuxを無効にする。

SELINUX=disabled
VDAを再起動

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

イージーインストールによる迅速なインストール (推奨)

April 20, 2026

寄稿者:

C C

April 20, 2026

寄稿者:

C C

この記事の概要

ステップ 1: 構成情報と Linux マシンの準備
ステップ 2: ハイパーバイザーの準備
ステップ 3: (Ubuntu 16.04 のみ) OpenJDK 11 のインストール
手順 4: Linux VDA パッケージのダウンロード
手順 5: Linux VDA パッケージのインストール
手順 6: NVIDIA GRID ドライバーのインストール
手順 7: インストールを完了するためのランタイム環境のセットアップ
ステップ 8: XDPing の実行
ステップ 9: Linux VDA の実行
ステップ 10: Citrix Virtual Apps または Citrix Virtual Desktops™ でのマシンカタログの作成
ステップ 11: Citrix Virtual Apps™ または Citrix Virtual Desktops でのデリバリーグループの作成
トラブルシューティング

イージーインストールによる迅速なインストール (推奨)

ステップ 1: 構成情報と Linux マシンの準備

考慮事項

ステップ 2: ハイパーバイザーの準備

Citrix Hypervisor™ での時刻同期の修正

Microsoft Hyper-V での時刻同期の修正

ESX および ESXi での時刻同期の修正

ステップ 3: (Ubuntu 16.04 のみ) OpenJDK 11 のインストール

手順 4: Linux VDA パッケージのダウンロード

手順 5: Linux VDA パッケージのインストール

手順 6: NVIDIA GRID ドライバーのインストール

手順 7: インストールを完了するためのランタイム環境のセットアップ

ステップ 8: XDPing の実行

ステップ 9: Linux VDA の実行

ステップ 10: Citrix Virtual Apps または Citrix Virtual Desktops™ でのマシンカタログの作成

ステップ 11: Citrix Virtual Apps™ または Citrix Virtual Desktops でのデリバリーグループの作成

トラブルシューティング

SSSD を使用したドメイン参加の失敗

Ubuntuデスクトップセッションのグレースクリーン表示

ホームディレクトリの欠落によるUbuntuデスクトップセッション起動の失敗

dbusエラーによるセッションの起動失敗または即時終了

SELinuxによるSSHDのホームディレクトリへのアクセス妨害

この記事の概要