簡易インストールを使用したクイックインストール（推奨）

ステップ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 ドライバーをインストールする

• シトリックス ハイパーバイザー
• ヴイエムウェア イーエスエックス
• ニュータニックス 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 ドメインのルートに設定された検索ベースを介して 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\> テキスト文字列で埋め、サーバーアドレスの順序を変更しないでください。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
  3. ターゲットセッションユーザーと 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™ でマシンカタログを作成する

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

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

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

トラブルシューティング