簡易インストールを使用した非ドメイン参加Linux VDAの作成（プレビュー）
この記事では、簡易インストール方法を使用して、Citrix DaaSまたはCitrix Virtual Apps and Desktops™ 2407以降のバージョンで、非ドメイン参加Linux VDAをマシンカタログに作成および登録する手順を説明します。
重要:
- Citrix DaaS™をご利用のお客様の場合:
- 非ドメイン参加VDAは、パブリッククラウドまたはオンプレミスのデータセンターに展開できます。非ドメイン参加VDAは、Citrix DaaSのコントロールプレーンによって管理されます。
- 非ドメイン参加VDAを作成するには、Citrix Gatewayサービスを利用しているお客様は、Rendezvous V2が有効になっていることを確認する必要があります。Cloud Connectorは、オンプレミスのハイパーバイザーにマシンをプロビジョニングする場合、またはWorkspaceでActive DirectoryをIDプロバイダーとして使用する場合にのみ必要です。
- 非ドメイン参加VDAを作成するには、MCSを使用することもできます。詳細については、「MCSを使用した非ドメイン参加Linux VDAの作成」を参照してください。
- MCSはベアメタルサーバーをサポートしていません。
- 非ドメイン参加Linux VDAで利用可能な機能は次のとおりです。
ステップ1：空のマシンカタログの作成
- Citrix Web Studio™にサインインし、マシンを含まない空のマシンカタログを作成します。Linux VDAは、電源管理されたマシンカタログへの登録にトークンファイルを使用することをサポートしていません。
- マシンカタログを作成し、Linux VDAマシンを追加するプロセスは、従来のWindows VDAのアプローチと似ています。これらのタスクを完了する方法の詳細については、「[マシンカタログの作成](/ja-jp/citrix-virtual-apps-desktops/install-configure/machine-catalogs-create.html)」および「[マシンカタログの管理](/ja-jp/citrix-virtual-apps-desktops/install-configure/machine-catalogs-manage.html)」を参照してください。
- Linux VDAマシンを含むマシンカタログを作成する場合、Windows VDAマシン用のマシンカタログを作成するプロセスとは異なるいくつかの制限があります。
-
オペレーティングシステムには、以下を選択します。
- ホストされた共有デスクトップ配信モデルの場合は、Multi-session OSオプション。
- VDI専用デスクトップ配信モデルの場合は、Single-session OSオプション。
- 同じマシンカタログ内でLinux VDAマシンとWindows VDAマシンを混在させないでください。
- 同じマシンカタログ内でドメイン参加マシンと非ドメイン参加マシンを混在させないでください。
- Remote PC Accessマシンカタログは、ドメイン参加マシンのみがサポートされており、非ドメイン参加マシンはサポートされていません。
注:
Citrix Studioの初期バージョンでは、「Linux OS」という概念はサポートされていません。ただし、Windows Server OSまたはServer OSオプションを選択すると、同等のホストされた共有デスクトップ配信モデルが意味されます。Windows Desktop OSまたはDesktop OSオプションを選択すると、マシンごとに単一ユーザーの配信モデルが意味されます。
ステップ2：登録トークンの作成
簡易インストールを使用して非ドメイン参加VDAを作成するには、VDAをマシンカタログに登録し、VDAをクラウドまたはオンプレミスのデリバリーコントローラーに対して認証するためのトークンファイルが必要です。Linux VDAは、電源管理されたマシンカタログへの登録にトークンファイルを使用することをサポートしていません。
登録トークンを作成するには、Citrix Web Studioで次の手順を完了します。
ヒント: - > Citrix DaaSでは、Web Studioは「Full Configuration」として知られています。
-
以前に作成した空のマシンカタログを選択し、アクションバーでManage Enrollment Tokensを選択します。
-
Manage Enrollment Tokensページで、Generateをクリックして登録トークンを作成します。または、有効な状態の既存のトークンを選択することもできます。
-
ウィザードに従って設定を完了します。
-
正常に作成されたトークンをダウンロードし、最小限の権限で安全な場所に保存します。後で簡易インストールスクリプトを実行する際に、CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE変数を使用して、VDAを登録するためのトークンファイルへのパスを指定できます。
ステップ3：.NETのインストール
.NET Runtimeに加えて、Linux VDAをインストールまたはアップグレードする前に、サポートされているすべてのLinuxディストリビューションに.ASP.NET Core Runtimeをインストールする必要があります。Amazon Linux 2にはバージョン6が必要です。その他のディストリビューションにはバージョン8が必要です。
お使いのLinuxディストリビューションに必要な.NETバージョンが含まれている場合は、組み込みのフィードからインストールします。そうでない場合は、Microsoftパッケージフィードから.NETをインストールします。詳細については、https://docs.microsoft.com/en-us/dotnet/core/install/linux-package-managersを参照してください。
.NETのインストール後、which dotnetコマンドを実行してランタイムパスを見つけます。
- コマンド出力に基づいて、.NETランタイムバイナリパスを設定します。たとえば、コマンド出力が/aa/bb/dotnetの場合、/aa/bbを.NETバイナリパスとして使用します。
ステップ4：自己署名CA証明書の追加
自己署名CA証明書をLinux VDAの/etc/ssl/certs/に保存し、お使いのLinuxディストリビューションに基づいて次のコマンドを実行してこれらの証明書を更新します。
-
RHEL、Rocky Linux、およびAmazon Linux 2の場合:
sudo update-ca-trust <!--NeedCopy--> -
SUSE、Ubuntu、およびDebianの場合:
sudo update-ca-certificates <!--NeedCopy-->
ステップ5：Linux VDAパッケージのダウンロード
- Citrix Virtual Apps and Desktopsダウンロードページにアクセスします。
- Citrix Virtual Apps™ and Desktopsの適切なバージョンを展開します。
-
Componentsを展開してLinux VDAを見つけます。例:
-
Linux VDAリンクをクリックして、Linux VDAダウンロードにアクセスします。
-
お使いの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> <!--NeedCopy--> -
DEBパッケージの場合、公開鍵をDEBデータベースにインポートし、パッケージの整合性を確認するために次のコマンドを実行します。
sudo apt-get install dpkg-sig gpg --import <path to the public key> dpkg-sig --verify <path to the Linux VDA package> <!--NeedCopy-->
-
-
ステップ 6: Linux VDA パッケージのインストール
Linux VDA の環境をセットアップするには、次のコマンドを実行します。
Amazon Linux 2、CentOS、RHEL、および Rocky Linux ディストリビューションの場合:
注:
RHEL および CentOS の場合、Linux VDA を正常にインストールする前に EPEL リポジトリをインストールしてください。EPEL のインストール方法については、https://docs.fedoraproject.org/en-US/epel/ の手順を参照してください。
RHEL 9.4/9.3/9.2 および Rocky Linux 9.4/9.3/9.2 に Linux VDA をインストールする前に、libsepol パッケージをバージョン 3.4 以降に更新してください。
sudo yum -y localinstall <PATH>/<Linux VDA RPM>
<!--NeedCopy-->
注:
GCP でホストされている RHEL 8.x/9.x および Rocky Linux 8.x/9.x に Linux VDA をインストールした後、VM の再起動後にイーサネット接続が失われ、Linux VDA に到達できなくなる可能性があります。この問題を回避するには、VM に初めてログオンするときに root パスワードを設定し、root として VM にログオンできることを確認してください。その後、VM を再起動してからコンソールで次のコマンドを実行します:
systemctl restart NetworkManager <!--NeedCopy-->
- Ubuntu/Debian ディストリビューションの場合:
sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
<!--NeedCopy-->
注:
Debian 11 ディストリビューションに必要な依存関係をインストールするには、
/etc/apt/sources.listファイルにdeb http://deb.debian.org/debian/ bullseye mainの行を追加します。
- GCP 上の Ubuntu 20.04 の場合、RDNS を無効にします。そのためには、
/etc/krb5.confの [libdefaults] の下に rdns = false の行を追加します。
-
SUSE ディストリビューションの場合:
-
- AWS、Azure、GCP 上の SUSE 15.5 の場合、以下を確認してください。
- libstdc++6 バージョン 12 以降を使用していること。
- /etc/sysconfig/windowmanager の Default_WM パラメーターが “gnome” に設定されていること。
-
- Linux VDA をインストールするには、次のコマンドを実行します。
zypper -i install <PATH>/<Linux VDA RPM> <!--NeedCopy-->
ステップ 7: NVIDIA GRID ドライバーのインストール
HDX™ 3D Pro を有効にするには、ハイパーバイザーと VDA マシンに NVIDIA GRID ドライバーをインストールする必要があります。
特定のハイパーバイザーに NVIDIA GRID Virtual GPU Manager（ホストドライバー）をインストールおよび構成するには、次のガイドを参照してください。
NVIDIA GRID ゲスト VM ドライバーをインストールおよび構成するには、次の一般的な手順を実行します。
- ゲスト VM がシャットダウンされていることを確認します。
- ハイパーバイザーのコントロールパネルで、VM に GPU を割り当てます。
- VM を起動します。
- VM にゲスト VM ドライバーをインストールします。
ステップ 8: 使用するデータベースの指定
Linux VDA パッケージのインストール後、/etc/xdl/db.conf を編集して、使用する SQLite または PostgreSQL を指定できます。
そのためには、sudo /opt/Citrix/VDA/sbin/ctxinstall.sh または /opt/Citrix/VDA/bin/easyinstall を実行する前に、/etc/xdl/db.conf を編集します。
注:
- SQLite は VDI モードでのみ使用することをお勧めします。
- Easy Install および MCS の場合、手動でインストールすることなく SQLite または PostgreSQL を使用するように指定できます。/etc/xdl/db.conf で特に指定がない限り、Linux VDA はデフォルトで PostgreSQL を使用します。
- /etc/xdl/db.conf を使用して PostgreSQL のポート番号を構成することもできます。
ステップ 9: Easy Install を実行して環境と VDA を構成し、インストールを完了する
Linux VDA パッケージのインストール後、ctxinstall.sh スクリプトを使用して実行環境を構成します。
注:
ランタイム環境をセットアップする前に、OS に en_US.UTF-8 ロケールがインストールされていることを確認してください。OS でロケールが利用できない場合は、sudo locale-gen en_US.UTF-8 コマンドを実行します。Debian の場合、/etc/locale.gen ファイルを編集して # en_US.UTF-8 UTF-8 の行のコメントを解除し、sudo locale-gen コマンドを実行します。
ctxinstall.sh
ctxinstall.sh は、いくつかの事前構成と VDA 実行環境変数の設定を行うための Easy Install スクリプトです。
-
このスクリプトは root のみが実行できます。
- Easy Install は、使用されるすべての環境変数の値を設定、保存、同期するための構成ファイルとして
/opt/Citrix/VDA/sbin/ctxinstall.confを使用します。テンプレート（ctxinstall.conf.tmpl）を注意深く読み、独自の ctxinstall.conf をカスタマイズすることをお勧めします。構成ファイルを初めて作成するときは、次のいずれかの方法を使用します。-
/opt/Citrix/VDA/sbin/ctxinstall.conf.tmplテンプレートファイルをコピーし、/opt/Citrix/VDA/sbin/ctxinstall.confとして保存する。 - ctxinstall.sh を実行する。ctxinstall.sh を実行するたびに、入力は
/opt/Citrix/VDA/sbin/ctxinstall.confに保存されます。
-
-
Easy Install はモジュール式実行をサポートしています。モジュールには、事前チェック、インストール、ドメイン構成、セットアップ、検証が含まれます。
-
このスクリプトのデバッグの詳細は、
/var/log/xdl/ctxinstall.logで確認できます。 - 詳細については、ヘルプコマンド ctxinstall.sh -h を使用してください。
注:
- 最小特権の原則に従い、ドメイン参加パスワードがファイルに設定されている可能性があるため、root ユーザーのみが /opt/Citrix/VDA/sbin/ctxinstall.conf を読み取れるようにしてください。
- Linux VDA をアンインストールすると、/opt/Citrix/VDA の下のファイルが削除されます。VDA をアンインストールする前に、/opt/Citrix/VDA/sbin/ctxinstall.conf をバックアップすることをお勧めします。
ctxinstall.sh は対話モードまたはサイレントモードで実行できます。スクリプトを実行する前に、次の環境変数を設定します。
-
CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – マシンをドメインに参加させるかどうか。デフォルト値は ‘n’ です。ドメインに参加しないシナリオでは、’y’ に設定します。
-
CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<path-to-token-file-on-vda-machine>‘ – Easy Install を使用してドメインに参加していない VDA を作成するには、Delivery Controller のマシンカタログに VDA を登録するためのトークンファイルが必要です。トークンは最小特権で安全な場所に保存してください。
- CTX_XDL_VDI_MODE=’y|n’ – マシンを専用デスクトップ配信モデル（VDI）またはホスト型共有デスクトップ配信モデルとして構成するかどうか。HDX 3D Pro 環境の場合は、値を ‘y’ に設定します。
-
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_START_SERVICE=’y|n’ – 構成完了時に Linux VDA サービスを開始するかどうかを決定します。
-
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_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate – セッションで使用する GNOME、GNOME Classic、または MATE デスクトップ環境を指定します。変数を指定しない場合、VDA に構成されているデフォルトのデスクトップが使用されます。
-
CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/kde/mate/xfce/’<none>‘ – セッションで使用するGNOME、GNOME Classic、KDE、MATE、またはXfceデスクトップ環境を指定します。’<none>‘に設定すると、VDAで構成されているデフォルトのデスクトップが使用されます。CTX_XDL_DESKTOP_ENVIRONMENT変数を使用して、セッションで使用するデスクトップ環境を指定できます。コマンドを実行するか、システムトレイを使用することで、デスクトップ環境を切り替えることもできます。詳細については、デスクトップ切り替えコマンドおよびシステムトレイを参照してください。
-
CTX_XDL_DOTNET_RUNTIME_PATH=’<path-to-install-dotnet-runtime>‘ – 新しいブローカーエージェントサービス（ctxvda）をサポートするために.NETをインストールするパス。デフォルトのパスは’/usr/bin’です。
- CTX_XDL_VDA_PORT=’<port-number>‘ – Linux VDAは、TCP/IPポートを介してDelivery Controllerと通信します。
対話モード
ctxinstall.shスクリプトを対話モードで実行するには、-Sオプションなしでsudo /opt/Citrix/VDA/sbin/ctxinstall.shコマンドを使用します。コマンドラインインターフェイスの各プロンプトで、関連する変数の値を入力します。変数がすでに設定されている場合、ctxinstall.shは変更するかどうかを確認します。
サイレントモード
サイレントモードでは、/opt/Citrix/VDA/sbin/ctxinstall.confまたはexportコマンドを使用して、前述の変数を設定する必要があります。その後、ctxinstall.sh -Sを実行します（ここでSは大文字であることに注意してください）。必要な変数がすべて設定されていないか、一部の値が無効な場合、デフォルト値がない限り、ctxinstall.shは実行を中止します。
設定した場合、各変数のエクスポートされた値は、/Citrix/VDA/sbin/ctxinstall.conf内の値を上書きします。更新されたすべての値は、/Citrix/VDA/sbin/ctxinstall.confに保存されます。
export CTX_XDL_NON_DOMAIN_JOINED='y'
export CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE='<token-file-path>'
export CTX_XDL_VDI_MODE='y|n'
export CTX_XDL_START_SERVICE='y|n'
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_DESKTOP_ENVIRONMENT=gnome|gnome-classic|kde|mate|xfce|'<none>'
export CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>'
export CTX_XDL_VDA_PORT='<port-number>'
sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh -S
<!--NeedCopy-->
sudoコマンドを実行する際は、既存の環境変数を新しく作成されるシェルに渡すために-Eオプションを入力します。最初の行に#!/bin/bashを記述して、前述のコマンドからシェルスクリプトファイルを作成することをお勧めします。
または、単一のコマンドを使用してすべての変数を指定することもできます。
VDA実行環境変数（’CTX_XDL_‘で始まる変数）を設定するには、ctxinstall.sh -sを実行します（ここでsは小文字であることに注意してください）。
手順 10: XDPingの実行
sudo /opt/Citrix/VDA/bin/xdpingを実行して、Linux VDA環境における一般的な構成の問題を確認します。詳細については、XDPingを参照してください。
手順 11: Linux VDAの実行
Linux VDAの開始:
Linux VDAサービスを開始するには:
sudo systemctl start ctxhdx.service
sudo systemctl start ctxvda.service
<!--NeedCopy-->
Linux VDAの停止:
Linux VDAサービスを停止するには:
sudo systemctl stop ctxvda.service
sudo systemctl stop ctxhdx.service
<!--NeedCopy-->
注:
ctxvdaサービスとctxhdxサービスを停止する前に、systemctl stop ctxmonitordコマンドを実行してモニターサービスデーモンを停止してください。そうしないと、モニターサービスデーモンが停止したサービスを再起動します。
Linux VDAの再起動:
Linux VDAサービスを再起動するには:
sudo systemctl stop ctxvda.service
sudo systemctl restart ctxhdx.service
sudo systemctl start ctxvda.service
<!--NeedCopy-->
Linux VDAのステータスの確認:
Linux VDAサービスの実行ステータスを確認するには:
sudo systemctl status ctxvda.service
sudo systemctl status ctxhdx.service
<!--NeedCopy-->
手順 12: デリバリーグループの作成
デリバリーグループを作成し、Linux VDAマシンを含むマシンカタログを追加するプロセスは、Windows VDAマシンとほぼ同じです。これらのタスクを完了する方法の詳細については、デリバリーグループの作成を参照してください。
Linux VDAマシンカタログを含むデリバリーグループを作成する場合、以下の制限が適用されます。
- 選択したADユーザーとグループが、Linux VDAマシンにログオンするように適切に構成されていることを確認する
- 認証されていない（匿名）ユーザーのログオンを許可しない
- デリバリーグループをWindowsマシンを含むマシンカタログと混在させない
重要:
アプリケーションの公開は、Linux VDAバージョン1.4以降でサポートされています。ただし、Linux VDAは、同じマシンへのデスクトップとアプリの配信をサポートしていません。
マシンカタログとデリバリーグループの作成方法については、Citrix Virtual Apps and Desktops 7 2407を参照してください。
手順 13: ローカルアカウントマッピングの有効化
ローカルアカウントマッピングが有効になっていない場合
ドメインに参加していないVDAでホストされているセッションは、ログオン時に失敗し、パスワードプロンプトが表示されますが、正しいパスワードを受け付けません。hdx.logには、次のようなエラーが見つかります。
2024-09-25 06:40:30.767979 [LOGIN_BOX:ERROR] <P124211:T58675:S4> citrix-ctxlogin: PamAuthenticate: pam authentication: Authentication failure. Can retry for user 'user3'
2024-09-25 06:40:30.768431 [LOGIN:ERROR] <P124211:T58675:S4> citrix-ctxlogin: LoginBoxValidate: Failed to validate user 'user3'. Due to INVALID_PASSWORD
2024-09-25 06:40:30.768947 [LOGIN_AUTH:INFO] <P124218:T58682:S4> citrix-ctxloginui: CalLabelFormat: Update username label on LoginUI from 'user3' to 'user3' (18)
2024-09-25 06:41:18.766196 [GFX_SLIDER:ERROR] <P124161:T58699:S4> citrix-ctxgfx: GfxCreateSliderListener: Failed to get user home dir.
<!--NeedCopy-->
ローカルアカウントマッピングの有効化
ユーザーがドメインに参加していないLinux VDAにログオンできるようにするには、次のコマンドを使用してローカルアカウントマッピングを有効にします。
Set-BrokerDesktopGroup -Name "<your delivery group name>" -MachineLogOnType LocalMappedAccount
<!--NeedCopy-->
オンプレミス展開の場合、Delivery Controllerで直接コマンドを実行します。Citrix DaaS展開の場合、Citrix Virtual Apps and Desktops Remote PowerShell SDKを介してコマンドを実行します。
この記事の概要
- ステップ1：空のマシンカタログの作成
- ステップ2：登録トークンの作成
- ステップ3：.NETのインストール
- ステップ4：自己署名CA証明書の追加
- ステップ5：Linux VDAパッケージのダウンロード
- ステップ 6: Linux VDA パッケージのインストール
- ステップ 7: NVIDIA GRID ドライバーのインストール
- ステップ 8: 使用するデータベースの指定
- ステップ 9: Easy Install を実行して環境と VDA を構成し、インストールを完了する
- 手順 10: XDPingの実行
- 手順 11: Linux VDAの実行
- 手順 12: デリバリーグループの作成
- 手順 13: ローカルアカウントマッピングの有効化