Horizon Agent for Linux のシステム要件

Horizon Agent for Linux をインストールするには、Linux オペレーティング システム、Linux 仮想マシン、Horizon 8 システム コンポーネント、vSphere プラットフォームの特定の要件を満たす必要があります。

Horizon Agent でサポートされる Linux ディストリビューション

Horizon Agent でサポートされているテスト済みの Linux オペレーティング システムのリストについては、ナレッジベースの記事「Horizon Linux Agent でサポートされているゲスト OS」を参照してください。

**注：**Horizon Agent は、一部の Linux ディストリビューションで依存パッケージを使用します。詳細については、「Horizon Agent 用依存パッケージのインストール」を参照してください。

一部の機能は、Linux オペレーティング システムのサブセットでのみサポートされます。詳細については、このドキュメントで特定の機能を説明するセクションを参照してください。

install_viewagent.sh インストール スクリプトの --force パラメータを使用すると、テスト サポート マトリックスにない Linux ディストリビューションに Horizon Agent を強制的にインストールできます。「Horizon Agent for Linux をインストールするコマンドライン オプション」を参照してください。

必須のプラットフォームとソフトウェア バージョン

Horizon Agent for Linux をインストールして使用するには、環境が vSphere プラットフォーム、Horizon Connection Server、Horizon Client ソフトウェアの特定の要件を満たしている必要があります。

プラットフォームとソフトウェア	サポートされているバージョン
vSphere プラットフォームのバージョン	vSphere 8.0 以降のリリース vSphere 7.0 以降のリリース
Horizon 8 環境	Horizon 8 リリースの Horizon Connection Server
Horizon Client ソフトウェア	Horizon 8 リリースの Horizon Client を使用します。 注：Horizon Web Client は、Horizon 8 バージョン 2412 以降で使用できます。Horizon 8 バージョン 2412 以前では、Horizon Web Client は「HTML Access」と呼ばれています。このページでは、Horizon Web Client と HTML Access の両方を表すため「Horizon Web Client」という名称を使用しています。 Horizon Blast プロトコルをサポートするゼロ クライアント 注：Teradici PCoIP ゼロ クライアントはサポートされていません。

Linux デスクトップで使用されるポート

接続セッションを有効にするには、Linux デスクトップが、Horizon Client デバイス、Unified Access Gateway、および Horizon Connection Server からの着信 TCP 接続をサポートする必要があります。

Ubuntu および Debian ディストリビューションでは、iptables ファイアウォールがデフォルトで構成されており、入力ポリシーが ACCEPT に設定されています。

RHEL および Rocky Linux ディストリビューションでは、可能な場合、Horizon Agent インストーラ スクリプトが、入力ポリシーを ACCEPT にして iptables ファイアウォールを構成します。着信接続を確実にサポートするには、Blast ポート 22443 を介した新しい接続に対して、iptables の入力ポリシーが ACCEPT に設定されていることを確認します。

Blast Secure Gateway (BSG) を有効にすると、クライアント接続は Horizon Connection Server の BSG を介して Horizon Client デバイスから Linux デスクトップに送られます。BSG を有効にしない場合、Horizon Client デバイスは Linux デスクトップに直接接続されます。

Linux デスクトップで Horizon Agent が使用するポートの詳細については、『Horizon セキュリティ』と「Horizon のネットワーク ポート ガイド」を参照してください。

Linux 仮想マシンにより使用される Linux アカウントの確認

次の表は、Linux 仮想マシンにより使用されるアカウント名とアカウント タイプを示しています。

アカウント名およびアカウント タイプ

アカウント名	アカウント タイプ	使用
ルート	Linux OS に組み込み	Java Standalone Agent、mksvchanserver、シェル スクリプト
hznblast	Linux Agent インストーラが作成	BlastServer
<current login user>	Linux OS に組み込み、Active Directory ユーザー、または LDAP ユーザー	Python スクリプト

デスクトップ環境

Horizon Agent for Linux は、異なる Linux ディストリビューションで複数のデスクトップ環境をサポートします。以下の表に、各 Linux ディストリビューションのデフォルトのデスクトップ環境と Horizon Agent for Linux でサポートされる他のデスクトップ環境の一覧を示します。

サポート対象のデスクトップ環境

Linux ディストリビューション	デフォルトのデスクトップ環境	Horizon Agent for Linux でサポートされるデスクトップ環境
Ubuntu	Gnome	Gnome Ubuntu、K デスクトップ環境 (KDE)、MATE
Debian	Gnome	Gnome、KDE、MATE
RHEL および Rocky Linux 8.x/9.x	Gnome	Gnome
SLED/SLES	Gnome	Gnome

**注：**Ubuntu ディストリビューションを使用している場合、ロックされた KDE セッションを SSO でロック解除することはできません。パスワードを入力して、手動でロックされているセッションを手動でロック解除する必要があります。

サポートされている Linux ディストリビューションのいずれかで使用するデフォルト デスクトップ環境を変更するには、次の手順に従って、Linux デスクトップに適切なコマンドを使用する必要があります。

1. デフォルトのデスクトップ環境の設定を使用して、サポートされている Linux ディストリビューションのオペレーティング システムをインストールします。

2. 以下の表を参照して、特定の Linux ディストリビューションに適切なコマンドを実行します。

3. 新しいデフォルトのデスクトップ環境を開始するには、デスクトップを再起動します。

   デスクトップ環境のインストール コマンド

   Linux ディストリビューション	新しいデフォルトのデスクトップ環境	デフォルトのデスクトップ環境を変更するコマンド
   Ubuntu	KDE	apt install plasma-desktop
   Ubuntu	MATE	apt install ubuntu-mate-desktop

複数のデスクトップ環境がインストールされている Linux デスクトップで SSO を有効にした場合は、次の情報を使用して、SSO セッションで使用するデスクトップ環境を選択します。

• Ubuntu の場合には、以下の表の情報を使用して、/etc/omnissa/viewagent-custom.conf ファイルに SSODesktopType オプションを設定し、SSO で使用するデスクトップ環境を指定します。

  SSODesktopType オプション

  デスクトップ タイプ	SSODesktopType オプションの設定
  MATE	SSODesktopType=UseMATE
  GnomeUbuntu	SSODesktopType=UseGnomeUbuntu
  GnomeFlashback	SSODesktopType=UseGnomeFlashback
  KDE	SSODesktopType=UseKdePlasma
  GnomeClassic	SSODesktopType=UseGnomeClassic

• RHEL および Rocky Linux 9.x/8.x で SSO ログイン セッションに Gnome Classic を使用する場合には、Gnome Classic スタートアップ ファイルを除く、すべてのデスクトップ スタートアップ ファイルを /usr/share/xsession ディレクトリから削除します。たとえば、root ユーザーとして次のコマンド セットを実行します。

  cd /usr/share/xsessions
  mkdir backup
  mv *.desktop backup
  mv backup/gnome-classic.desktop ./
  

  次の SSO セッションでデフォルトのデスクトップとして Gnome Classic を使用するには、初期セットアップの後、エンド ユーザーは Linux デスクトップからログアウトするか、システムを再起動する必要があります。

Ubuntu 24.04 で空白の画面が表示される場合、Wayland の構成が原因である可能性があります。空白の画面を修正するには、以下を確認します。

• /etc/gdm3/custom.conf を編集します。

  • daemon セクションで、WaylandEnable=false または WaylandEnable=true というコメントを入力します。

    • 例：

      [daemon]

      #WaylandEnable=false

• GDM サーバを再起動します。

  • service gdm3 restart

複数のデスクトップ環境がインストールされている Linux デスクトップで SSO を無効にした場合には、前述の手順を行う必要はありません。エンド ユーザーが Linux デスクトップにログインするときに、必要なデスクトップ環境を選択します。

ネットワーク要件

Horizon Blast Extreme は、UDP ( ユーザー データグラム プロトコル) と TCP (伝送制御プロトコル) の両方をサポートします。ネットワーク条件は、UDP と TCP のパフォーマンスに影響を及ぼします。最高のユーザー エクスペリエンスを実現するには、ネットワーク条件に応じて UDP または TCP を選択します。

• ローカル エリア ネットワーク (LAN) 環境など、ネットワーク条件が良好な場合には TCP を選択します。
• パケット ロスや遅延が発生するワイド エリア ネットワーク (WAN) 環境など、ネットワーク条件が良好でない場合には UDP を選択します。

Wireshark などのネットワーク アナライザ ツールを使用して、Horizon Blast Extreme が TCP と UDP のどちらを使用するかを確認します。次の手順を行います。ここでは例として Wireshark を使用しています。

1. Linux 仮想マシンに Wireshark をダウンロードして、インストールします。

   RHEL または Rocky Linux の場合：

   sudo yum install wireshark
   

   Ubuntu の場合：

   sudo apt install tshark
   

2. Omnissa Horizon Client を使用して、Linux デスクトップに接続します。

3. ターミナル ウィンドウを開き、次のコマンドを実行します。Horizon Blast Extreme が使用する TCP パッケージまたは UDP パッケージが表示されます。

   sudo tshark -i any | grep 22443
   

USB リダイレクトとクライアント ドライブのリダイレクト (CDR) 機能はネットワーク条件に依存します。パケット ロスや遅延で帯域幅に制限があるなど、ネットワーク条件が良好でないと、ユーザー エクスペリエンスが低下します。このような場合、次のいずれかが発生する可能性があります。

• リモート ファイルのコピーが低速になる。この場合、サイズの小さいファイルを送信します。
• USB デバイスがリモートの Linux デスクトップに表示されない。
• USB データの転送が不完全になります。たとえば、サイズの大きいファイルをコピーした場合、元のファイルよりもサイズが小さくなる可能性があります。

USB リダイレクトのための VHCI ドライバ

**注：**VHCI ドライバの正しいインストール手順を決定するには、次のガイドラインに従います。

• .tar.gz tar 形式インストーラを使用して Horizon Agent をインストールする場合は、まず tar 形式インストーラをダウンロードして解凍し、次に VHCI ドライバをインストールしてから、USB リダイレクト機能のインストール パラメータを指定して Horizon Agent をインストールする必要があります。
• .rpm RPM インストーラを使用して Horizon Agent をインストールする場合は、まず Horizon Agent をインストールしてから VHCI ドライバをインストールし、USB リダイレクト機能を Horizon Agent 構成に追加する必要があります。

詳細については、「Linux マシンでの Horizon Agent のインストール」を参照してください。

USB リダイレクト機能は、USB VHCI (Virtual Host Controller Interface) カーネル ドライバに依存します。USB 3.0 と USB リダイレクト機能をサポートするには、次の手順を行い、VHCI ドライバをインストールする必要があります。

注： 次の手順では、特定のファイル名の代わりに agent-installer という名前を使用します。コマンドを使用するときは、使用しているファイルの名前に置き換えてください。

1. https://sourceforge.net/projects/usb-vhci/files/linux%20kernel%20module/ から USB VHCI ソース コードをダウンロードします。

2. Horizon Agent インストーラの形式に応じて、VHCI パッチ ファイルのフル パスを確認します。ガイドラインについては、次の例を参照してください。（例では、agent-installer はインストーラ ファイルの名前です。agent-installer の代わりに、Horizon Agent インストールの実際の名前に置き換えてください。）

   • （tar 形式インストーラ）tar 形式インストーラ agent-installer.tar.gz を /install_tmp/ ディレクトリに解凍した場合、full-path_to_patch-file は /install_tmp/agent-installer/resources/vhci/patch/vhci.patch です。
   • （RPM インストーラ）RPM インストーラ agent-installer.el8.x86_64.rpm をダウンロードして Horizon Agent をインストールした場合、full-path_to_patch-file は /usr/lib/omnissa/viewagent/resources/vhci/patch/vhci.patch です。

3. VHCI ドライバのソース コードをコンパイルして、その結果のバイナリを Linux システムにインストールするには、以下の表のコマンドを使用します。コマンドの full-path_to_patch-file を前の手順で特定したファイル パスに置き換えます。

   たとえば、ファイル パスが /install_tmp/agent-installer/resources/vhci/patch/vhci.patch の場合、patch コマンドは次のようになります。

   patch -p1 < /install_tmp/agent-installeri/resources/vhci/patch/vhci.patch
   

USB VHCI ドライバのコンパイルとインストール

Linux ディストリビューション	USB VHCI ドライバのコンパイルとインストールの手順
Ubuntu	依存パッケージをインストールします。 <pre><code>sudo apt-get install make sudo apt-get install gcc sudo apt-get install libelf-dev （Ubuntu 22.04/24.04）カーネル ヘッダー ファイルをインストールします。 <pre><code>sudo apt-get install linux-headers-$(uname -r)</code></pre></li> VHCI ドライバをコンパイルし、インストールします。 <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file make clean && make && sudo make install 仮想マシンで拡張ファームウェア インターフェイス (EFI) と UEFI セキュア ブートを有効にしている場合は、VHCI ドライバの署名を設定します。 <ol> <li>VHCI ドライバの SSL キー ペアを作成します。 <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre> </li> <li>VHCI ドライバに署名します。 <pre><code>sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko UEFI セキュア ブートにキーを登録します。 <pre><code>sudo mokutil --import MOK.der</code></pre> <strong>注：</strong>このコマンドは、UEFI セキュア ブートのマシン所有者キー (MOK) のパスワードを設定するように要求します。 </li> <li>vSphere コンソールで UEFI セキュア ブートを設定するには、システムを再起動します。詳細については、<a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a> を参照してください。 </li> </ol></li>
Debian	依存パッケージをインストールします。 <pre><code>sudo apt install -y patch g++ make linux-headers-$(uname -r)</code></pre></li> VHCI ドライバをコンパイルし、インストールします。 <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file mkdir -p linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core cp /lib/modules/$(uname -r)/source/include/linux/usb/hcd.h linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core make clean && make && sudo make install
RHEL 8.x/9.x Rocky Linux 8.x/9.x	依存パッケージをインストールします。 <pre><code>sudo yum install gcc-c++ sudo yum install kernel-devel-$(uname -r) sudo yum install kernel-headers-$(uname -r) sudo yum install patch sudo yum install elfutils-libelf-devel VHCI ドライバをコンパイルし、インストールします。 <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file make clean && make && sudo make install （RHEL および Rocky Linux 9.x/8.x）VHCI ドライバが USB リダイレクトで正常に動作するようには、ドライバの署名を設定します。 <ol> <li>VHCI ドライバの SSL キー ペアを作成します。 <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre> </li> <li>VHCI ドライバに署名します。 <pre><code>sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko UEFI セキュア ブートにキーを登録します。 <pre><code>sudo mokutil --import MOK.der</code></pre> <strong>注：</strong>このコマンドは、UEFI セキュア ブートのマシン所有者キー (MOK) のパスワードを設定するように要求します。 </li> <li>vSphere コンソールで UEFI セキュア ブートを設定するには、システムを再起動します。詳細については、<a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a> を参照してください。 </li> </ol></li>
SLED/SLES	現在のカーネル パッケージのバージョンを検索します。 <pre><code>rpm -qa | grep kernel-default-$(echo $(uname -r) | cut -d '-' -f 1,2)</code></pre> 現在インストールされているカーネル パッケージの名前が出力されます。たとえば、パッケージ名が <code>kernel-default-3.0.101-63.1</code> の場合、現在のカーネル パッケージのバージョンは 3.0.101-63.1 になります。</li> kernel-devel、kernel-default-devel、kernel-macros、patch パッケージをインストールします。 <pre><code>sudo zypper install --oldpackage kernel-devel-<em>&lt;kernel-package-version&gt;</em> \ kernel-default-devel-<kernel-package-version> kernel-macros-<kernel-package-version> patch 例： sudo zypper install --oldpackage kernel-devel-4.4.21-90.1 kernel-default-devel-4.4.21-90.1 kernel-macros-4.4.21-90.1 patch VHCI ドライバをコンパイルし、インストールします。 <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file mkdir -p linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core cp /lib/modules/$(uname -r)/source/include/linux/usb/hcd.h linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core make clean && make && sudo make install VHCI ドライバが USB リダイレクトで正常に動作するようには、ドライバの署名設定を行います。 <ol> <li>VHCI ドライバの SSL キー ペアを作成します。 <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre> </li> <li>VHCI ドライバの署名ファイルのパスを検索します。 <pre><code>sudo find / -name sign-file</code></pre> このコマンドを実行すると、システム上にあるすべての署名ファイルへのパスが返されます。VHCI ドライバの署名ファイルのパスは、次のようになります。 <pre><code>/usr/src/linux-5.3.18-24.9-obj/x86_64/default/scripts/</code></pre> </li> <li>VHCI ドライバに署名します。次のコマンドで、&lt;sign-file-path&gt; は、手順 4b で確認した署名ファイルのパスです。 <pre><code>sudo /&lt;sign-file-path&gt;/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko sudo /<sign-file-path>/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko UEFI セキュア ブートにキーを登録します。 <pre><code>sudo mokutil --import MOK.der</code></pre> <strong>注：</strong>このコマンドは、UEFI セキュア ブートのマシン所有者キー (MOK) のパスワードを設定するように要求します。 </li> <li>vSphere コンソールで UEFI セキュア ブートを設定するには、システムを再起動します。詳細については、<a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a> を参照してください。 </li> </ol></li>

また、次のガイドラインに従ってください。

• Linux カーネルが新しいバージョンが変更された場合は、VHCI ドライバを再コンパイルして再インストールする必要がありますが、Horizon Agent for Linux を再インストールする必要はありません。
• また、Ubuntu システムの場合、次の例に類似した手順で動的カーネル モジュール サポート (DKMS) を VHCI ドライバに追加できます。

  1. カーネル ヘッダーをインストールします。

     sudo apt install linux-headers-`uname -r`
     

  2. 次のコマンドを使用して、dkms をインストールします。

     sudo apt install dkms
     

  3. VHCI TAR ファイルを展開し、パッチを適用します。

     tar xzvf vhci-hcd-1.15.tar.gz
     cd vhci-hcd-1.15
     patch -p1 *<full-path_to_patch-file>*
     cd ..
     

  4. 展開した VHCI ソース ファイルを /usr/src ディレクトリにコピーします。

     sudo cp -r vhci-hcd-1.15 /usr/src/usb-vhci-hcd-1.15
     

  5. dkms.conf という名前のファイルを作成し、/usr/src/usb-vhci-hcd-1.15 ディレクトリに配置します。

     sudo touch /usr/src/usb-vhci-hcd-1.15/dkms.conf
     

  6. 次の行を dkms.conf ファイルに追加します。

     PACKAGE_NAME="usb-vhci-hcd"
     PACKAGE_VERSION=1.15
     MAKE_CMD_TMPL="make KVERSION=$kernelver"
         
     CLEAN="$MAKE_CMD_TMPL clean"
         
     BUILT_MODULE_NAME[0]="usb-vhci-iocifc"
     DEST_MODULE_LOCATION[0]="/kernel/drivers/usb/host"
     MAKE[0]="$MAKE_CMD_TMPL"
         
     BUILT_MODULE_NAME[1]="usb-vhci-hcd"
     DEST_MODULE_LOCATION[1]="/kernel/drivers/usb/host"
     MAKE[1]="$MAKE_CMD_TMPL"
         
     AUTOINSTALL="YES"
     

  7. この VHCI ドライバを dkms に追加します。

     sudo dkms add usb-vhci-hcd/1.15
     

  8. VHCI ドライバをビルドします。

     sudo dkms build usb-vhci-hcd/1.15
     

  9. VHCI ドライバをインストールします。

     sudo dkms install usb-vhci-hcd/1.15
     

2D グラフィックスの仮想マシン設定

Horizon 8 環境に特定の Linux 仮想マシンを作成するときに、パフォーマンス要件を満たすために vCPU と仮想メモリ設定の変更が必要になることがあります。

NVIDIA GRID vGPU を使用するように設定されている仮想マシンでは、NVIDIA の物理グラフィック アクセラレータをベースとする NVIDIA 仮想グラフィック カードを使用します。これらの仮想マシンの vCPU と仮想メモリの設定を変更する必要はありません。

2D グラフィックスの使用が設定された仮想マシンは、vSphere ベースの仮想グラフィック カードを使用します。また、デスクトップのパフォーマンスを向上させるため、vCPU と仮想メモリの設定を変更する必要があります。次のガイドラインを使用します。

• 2D デスクトップのパフォーマンスを向上させるには、Linux 仮想マシン用で vCPU と仮想メモリを増設します。たとえば、2 つの vCPU と 2 GB の仮想メモリを設定します。
• 4 台のモニターがある場合など、マルチモニターを使用して大画面にする場合、仮想マシンに 4 つの vCPU と 4 GB の仮想メモリを設定します。
• 2D デスクトップでのビデオ再生を向上させるため、仮想マシンに 4 つの vCPU と 4 GB の仮想メモリを設定します。