easy install を使用したクイックインストール (推奨)

手順 1：構成情報と Linux マシンを準備する

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

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

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

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

1. Citrix Virtual Apps and Desktopsダウンロードページにアクセスします。
2. Citrix Virtual Apps and Desktopsの適切なバージョンを展開します。
3. 「Components」をクリックして、お使いのLinuxディストリビューションに一致するLinux VDAパッケージと、Linux VDAパッケージの整合性を検証するために使用できるGPG公開キーをダウンロードします。
   公開キーを使用して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パッケージをインストールする

ステップ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クエリを有効にするには、ドメインコントローラーでグローバルカタログを有効にし、関連する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' – フェデレーション認証サービス（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 ファイルを編集して、ディストリビューションに基づいてデスクトップ環境を指定します。
     • 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に切り替え可能なデスクトップ環境を事前にインストールする必要があります。詳しくは、「セッションユーザーによるカスタムデスクトップ環境」を参照してください。
• 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 VDAマシンとWindows VDAマシンを混在させないでください。

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

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

トラブルシューティング