簡易インストールを使用した迅速なインストール (推奨)

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

• ホスト名 - Linux VDAをインストールするマシンのホスト名
• ドメインネームサーバーのIPアドレス
• NTPサーバーのIPアドレスまたは文字列名
• ドメイン名 - ドメインのNetBIOS名
• レルム名 - Kerberosレルム名
• ドメインの完全修飾ドメイン名 (FQDN)

手順2：ハイパーバイザーを準備する

ステップ 3: 前提条件として .NET Runtime 6.0 をインストールする

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

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

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

• シトリックス ハイパーバイザー
• ヴイエムウェア ESX
• ニュータニックス AHV

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

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

• sudo /opt/Citrix/VDA/sbin/ctxinstall.shコマンドを実行し、コマンドラインインターフェイスの各プロンプトで関連するパラメーターを入力します。
• VDAのデスクトップ環境で/opt/Citrix/VDA/bin/easyinstallコマンドを実行し、簡易インストールGUIの指示に従います。

• システム環境を確認する
• 依存関係のインストール
• VDAを指定されたドメインに参加させる
• ランタイム環境を構成する

• 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 – ドメインユーザーのパスワードを指定します。ドメインへの参加に使用されます。

• 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 VDAサービスでは、システムファイアウォールを介した受信ネットワーク接続が許可されている必要があります。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 ad2.mycompany.com:3268 ad3.mycompany.com:3268。LDAP ポート番号を 389 と指定すると、Linux VDA は指定されたドメイン内の各 LDAP サーバーにポーリングモードでクエリを実行します。ポリシーの数が x、LDAP サーバーの数が y の場合、Linux VDA は合計で X かける Y のクエリを実行します。ポーリング時間がしきい値を超えると、セッションログオンが失敗する可能性があります。LDAP クエリを高速化するには、ドメインコントローラーで Global Catalog を有効にし、関連する LDAP ポート番号を 3268 と指定します。この変数はデフォルトで \<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' – Federated Authentication Service (FAS) サーバーは、AD グループポリシーを介して構成されます。Linux VDA は AD グループポリシーをサポートしていませんが、代わりにセミコロン区切りの FAS サーバーのリストを提供できます。シーケンスは AD グループポリシーで構成されているものと同じである必要があります。サーバーアドレスが削除された場合は、その空白を \<none\> テキスト文字列で埋め、サーバーアドレスの順序を変更しないでください。FAS サーバーと適切に通信するには、FAS サーバーで指定されているものと一致するポート番号を追加してください。例：CTX_XDL_FAS_LIST='fas_server_1_url:port_number; fas_server_2_url: port_number; fas_server_3_url: port_number'。
• CTX\_XDL\_DOTNET\_RUNTIME_PATH=path-to-install-dotnet-runtime – 新しいブローカーエージェントサービス (ctxvda) をサポートするために .NET Runtime 6.0 をインストールするパス。デフォルトのパスは /usr/bin です。
• CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate – セッションで使用する GNOME、GNOME Classic、または MATE デスクトップ環境を指定します。この変数を指定しない場合、VDA に現在インストールされているデスクトップが使用されます。ただし、現在インストールされているデスクトップが MATE の場合は、変数の値を mate に設定する必要があります。
  ターゲットセッションユーザーのデスクトップ環境は、次の手順で変更することもできます。
  1. VDA の $HOME/<username\> ディレクトリの下に .xsession または .Xclients ファイルを作成します。Amazon Linux 2 を使用している場合は、.Xclients ファイルを作成します。その他のディストリビューションを使用している場合は、.xsession ファイルを作成します。
     2\. ディストリビューションに基づいてデスクトップ環境を指定するために、.xsession または .Xclients ファイルを編集します。
     • Amazon Linux 2、Debian、RHEL 8、SUSE 15、および Ubuntu の MATE デスクトップの場合
        MSESSION="$(type -p mate-session)"

 if [ -n "$MSESSION" ]; then
   exec mate-session

 fi
     • Amazon Linux 2、CentOS、Debian、RHEL、SUSE 15、および Ubuntu の GNOME Classic デスクトップの場合
        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、CentOS、Debian、RHEL、SUSE 15、および Ubuntu の GNOME デスクトップの場合
        GSESSION="$(type -p gnome-session)"

 if [ -n "$GSESSION" ]; then
 exec gnome-session

 fi
  2. ターゲットセッションユーザーと 700 ファイル権限を共有します。
• CTX\_XDL\_START\_SERVICE=Y \| N – 構成が完了したときにLinux VDAサービスが開始されるかどうか。
• CTX\_XDL\_TELEMETRY\_SOCKET\_PORT – Citrix Scoutをリッスンするためのソケットポート。デフォルトポートは7503です。
• CTX\_XDL\_TELEMETRY\_PORT – Citrix Scoutと通信するためのポート。デフォルトポートは7502です。

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

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

ステップ 10：Citrix Virtual Apps または Citrix Virtual Desktops™ でマシンカタログを作成する

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

ステップ 11：Citrix Virtual Apps™ または Citrix Virtual Desktops でデリバリーグループを作成する

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

トラブルシューティング