easy install を使用したクイックインストール (推奨)
重要:
新規インストールの場合、迅速なインストールについてはこの記事を参照することをお勧めします。この記事では、easy install を使用して Linux VDA をインストールおよび構成する方法を順を追って説明します。easy install は、手動インストールよりも時間と労力を節約でき、エラーが発生しにくくなります。必要なパッケージをインストールし、構成ファイルを自動的にカスタマイズすることで、Linux VDA の実行環境をセットアップするのに役立ちます。
ステップ 1: 構成情報と Linux マシンを準備する
easy install に必要な以下の構成情報を収集します。
-
ホスト名 - Linux VDA をインストールするマシンのホスト名
-
ドメインネームサーバーの IP アドレス
-
NTP サーバーの IP アドレスまたは文字列名
-
ドメイン名 - ドメインの NetBIOS 名
-
レルム名 - Kerberos レルム名
-
ドメインの完全修飾ドメイン名 (FQDN)
重要:
-
Linux VDA をインストールするには、リポジトリが Linux マシンに正しく追加されていることを確認します。
-
セッションを起動するには、X Window システムとデスクトップ環境がインストールされていることを確認します。
考慮事項
-
ワークグループ名は、デフォルトでドメイン名です。環境内のワークグループをカスタマイズするには、次の手順を実行します。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に参加させるには、次の手順を実行します。
-
ドメインコントローラーに特定のOUが存在することを確認します。OUの例については、次のスクリーンショットを参照してくださいOUの例の画像(/en-us/linux-virtual-delivery-agent/2112/media/example-ou.png)
-
VDA上に/tmp/ctxinstall.confファイルを作成します。
-
/tmp/ctxinstall.confファイルにou=\<your ou\>の行を追加します。OUの値はADメソッドによって異なります。次の表を参照してください。
OS Winbind (ウィンバインド) SSSD Centrify (セントリファイ) PBIS アマゾン Linux 2 ou="Linux/amazon"ou="Linux/amazon"ou="XD.LOCAL/Linux/amazon"ou="Linux/amazon"デビアン 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"ウブントゥ 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
-
-
ドメインに参加する方法として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アマゾン リナックス 2、セントオーエス 8、RHEL 8、スーゼ 15.3、スーゼ 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デビアン、ウブントゥ：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モードでは変更は不要です。
一部のLinuxディストリビューションでは、Citrix VM Toolsがインストールされた準仮想化Linuxカーネルを実行している場合、Linux VM内からCitrix Hypervisorの時刻同期機能が存在し、有効になっているかどうかを確認できます。
su -
cat /proc/sys/xen/independent_wallclock
このコマンドは0または1を返します。
-
0 - タイム同期機能が有効になっており、無効にする必要があります。
-
1 - タイム同期機能は無効になっており、それ以上の操作は不要です。
/proc/sys/xen/independent\_wallclock ファイルが存在しない場合、以下の手順は不要です。
有効になっている場合は、ファイルに 1 を書き込むことでタイム同期機能を無効にします。
sudo echo 1 > /proc/sys/xen/independent_wallclock
この変更を永続化し、再起動後も維持するには、/etc/sysctl.conf ファイルを編集して次の行を追加します。
xen.independent_wallclock = 1
これらの変更を確認するには、システムを再起動します。
su -
cat /proc/sys/xen/independent_wallclock
このコマンドは値 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を開きます。
-
Linux VMの設定を編集します。
-
仮想マシンプロパティダイアログで、オプションタブを開きます。
-
VMware Toolsを選択します。
-
詳細ボックスで、ゲストの時刻をホストと同期のチェックを外します。
ステップ3: (Ubuntu 16.04のみ) OpenJDK 11をインストールする
Ubuntu 16.04で、次の手順を実行してOpenJDK 11をインストールします。
-
<https://jdk.java.net/archive/>から最新のOpenJDK 11をダウンロードします。 -
tar zxf openjdk-11.0.2_linux-x64_bin.tar.gzコマンドを実行して、ダウンロードしたパッケージを解凍します。 -
(オプション)
mv jdk-11.0.2/ <target directory>コマンドを実行して、OpenJDKをターゲットディレクトリに保存します。 -
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 を展開し、**「Components」**をクリックして、お使いの Linux ディストリビューションに一致する Linux VDA パッケージをダウンロードします。
手順 5：Linux VDA パッケージをインストールする
Linux VDA の環境をセットアップするには、次のコマンドを実行します。
RHEL および CentOS ディストリビューションの場合：
sudo yum -y localinstall <PATH>/<Linux VDA RPM>
Ubuntu/Debian ディストリビューションの場合：
sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
注:
Debian ディストリビューションに必要な依存関係をインストールするには、
deb http://deb.debian.org/debian/ oldstable main の行を /etc/apt/sources.list ファイルに追加します。
SUSE ディストリビューションの場合：
zypper -i install <PATH>/<Linux VDA RPM>
手順 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は、27MBを超える.NET Core Runtimeをダウンロードしている間、応答がないように見えることがあります。ダウンロードの進行状況については、/var/log/ctxinstall.logを確認してください。
対話モード:
手動で構成するには、次のコマンドを実行し、各プロンプトで関連するパラメーターを入力します。
sudo /opt/Citrix/VDA/sbin/ctxinstall.sh
サイレントモード:
サイレントモードで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 ドメインのルートに設定された検索ベースを介して LDAP にクエリを実行します（例: DC=mycompany,DC=com）。検索パフォーマンスを向上させるために、検索ベース（例: 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 Core Runtime 3.1 のインストールパス。デフォルトのパスは /usr/bin です。 -
CTX_XDL_DESKTOP_ENVIRONMENT=gnome/mate – セッションで使用するGNOMEまたはMATEデスクトップ環境を指定します。この変数を指定しない場合、VDAに現在インストールされているデスクトップが使用されます。ただし、現在インストールされているデスクトップがMATEである場合は、変数の値をmateに設定する必要があります。注:ターゲットセッションユーザーのデスクトップ環境は、次の手順で変更することもできます。
-
VDA上の**$HOME/<username\>**ディレクトリの下に
.xsessionファイルを作成します。 -
ディストリビューションに基づいてデスクトップ環境を指定するように、
.xsessionファイルを編集します。CentOS、Ubuntu、およびDebian上のMATEデスクトップの場合MSESSION="$(type -p mate-session)"
exec mate-session\> fi**CentOS上のGNOMEデスクトップの場合**
GSESSION="$(type -p gnome-session)"export GNOME_SHELL_SESSION_MODE=classic\> exec gnome-session --session=gnome-classicfi
**UbuntuおよびDebian上のGNOMEデスクトップの場合**
GSESSION="$(type -p gnome-session)"exec gnome-session\> fi-
ターゲットセッションユーザーと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 Core Runtime 3.1をインストールするパスについてユーザー入力を求めます。
サイレントモードでは、環境変数を設定し、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
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
ステップ8：XDPingを実行する
Linux VDA環境における一般的な構成の問題を確認するには、
sudo /opt/Citrix/VDA/bin/xdpingを実行します。詳細については、XDPingを参照してください。
ステップ9：Linux VDAを実行する
Linux VDAを開始する：
Linux VDAサービスを開始するには：
sudo /sbin/service ctxhdx start
sudo /sbin/service ctxvda start
Linux VDAを停止する：
Linux VDAサービスを停止するには：
sudo /sbin/service ctxvda stop
sudo /sbin/service ctxhdx stop
注:
ctxvdaおよびctxhdxサービスを停止する前に、service ctxmonitorservice stopコマンドを実行してモニターサービスデーモンを停止してください。そうしないと、モニターサービスデーモンが停止したサービスを再起動します。
Linux VDAを再起動する：
Linux VDAサービスを再起動するには：
sudo /sbin/service ctxvda stop
sudo /sbin/service ctxhdx restart
sudo /sbin/service ctxvda start
Linux VDAのステータスを確認する：
Linux VDAサービスの実行ステータスを確認するには：
sudo /sbin/service ctxvda status
sudo /sbin/service ctxhdx status
Step 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オプションを選択すると、マシンごとに1人のユーザーという配信モデルが意味されます。
ヒント:
マシンをActive Directoryドメインから削除して再参加させる場合、そのマシンをマシンカタログから削除し、再度追加する必要があります。
Step 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.
/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.
ヒント:
この問題の根本原因は、ドメイン管理者のホームディレクトリが作成されていないことです。
この問題を解決するには：
-
コマンドラインから「pam-auth-update」と入力します。
-
表示されるダイアログで、「Create home directory login」が選択されていることを確認します。
セッションが起動しない、または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.
または、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
一部のグループまたはモジュールは、再起動するまで有効になりません。ログに 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
この問題を解決するには:
-
/etc/selinux/config に次の変更を加えて SELinux を無効にします。SELINUX=無効
-
VDA を再起動します。