Skip to main content

2026 年 7 月 10 日

Easy Setup Tool を使用した Linux マシンの準備

このページでは、Linux マシン用の Easy Setup Tool (easyinstall_viewagent.sh) について説明します。このツールは、Linux マシンを Horizon 8 環境で使用するために必要なすべてのインストールとシステム構成を実行します。

Easy Setup Tool の概要

Easy Setup Tool は、Linux マシンで次の操作を実行するためのガイド付きインストーラです。

  • システムの事前チェック

    マシンが次の要件を満たしていることを確認します。

    マシンがこの要件を満たしていない場合、通知が表示されます。

  • システム構成

    次のシステム構成を実行します。

    • DNS を構成します。

    • NTP とホスト名の設定を構成して、指定された Active Directory ドメインにマシンを参加させます。

      **注:**このリリースの Easy Setup Tool は、ドメインへの参加方法として SSSD (System Security Services Daemon) 認証のみを使用します。

  • Horizon Agent のインストール

    マシンで次の操作を実行します。

    • Linux デスクトップの特定の機能をサポートするために、次のカーネル モジュールをビルドします。
      • リアルタイム オーディオビデオ (RTAV) をサポートする V4L2Loopback ドライバ
      • USB リダイレクトをサポートする USB VHCI ドライバ
    • Horizon Agent の Linux 依存パッケージのインストール」に記載されているように、必須エージェントの依存関係をインストールします。
    • インストール オプションを指定して、Horizon Agent for Linux をインストールします。

注: Active Directory ドメイン、エージェントのインストール オプション、インストーラ プロンプトのレベルなどのインストール パラメータの指定方法については、「Easy Setup Tool の構成パラメータ」を参照してください。

Easy Setup Tool のダウンロードと実行

  1. Omnissa Customer Connect から Horizon Agent for Linux インストーラ パッケージをダウンロードします。

    Horizon の現在のリリースのダウンロード ページに移動し、さらに、64 ビット Linux 用の Horizon のダウンロード ページに移動します。

    tar 形式の Horizon Agents Installer をダウンロードします。ファイル名の形式は horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz です。ここで、YYMM はマーケティング バージョン番号、y.y.y は内部バージョン番号、xxxxxxx はビルド番号です。

  2. tar 形式の Linux ディストリビューションを展開します。たとえば、インストーラ ファイル名が horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz の場合:

    tar -xvzf *horizonagent-linux-x86\_64-YYMM-y.y.y-xxxxxxx.tar.gz*
    
  3. tar 形式フォルダに移動して、easyinstall.viewagent.sh スクリプトを root ユーザーとして実行します。含めるインストール オプションのコマンドライン パラメータを追加します。

    詳細については、以下の「Easy Setup Tool のコマンドライン パラメータ」を参照してください。

    以下のコマンド例を参考にしてください。

    #Run the Easy Setup Tool with default prompts and installation options
    ./easyinstall_viewagent.sh
    
    #Run the tool in silent mode with installation options specified in easyinstall.conf
    ./easyinstall_viewagent.sh -s -f ./easyinstall.conf
    
  4. Easy Setup Tool を中断せずに続行し、必要に応じてインストーラのプロンプトに応答できるようにします。

  5. インストール プロセスが完了したら、Linux マシンを再起動して変更を有効にします。

  6. 次のコマンドを実行して、viewagent サービスが開始していることを確認します。

    sudo service viewagent status
    

Easy Setup Tool のコマンドライン パラメータ

次の表に、インストール オプションとプロンプト レベルを指定するために ./easyinstall_viewagent.sh run コマンドに追加できるコマンドライン パラメータを示します。

オプション説明
-s、--silent すべてのインストーラ プロンプトをバイパスして、Easy Setup Tool をサイレント モードで実行します。 必須のインストール オプションは、-f パラメータで指定した構成ファイルから取得されます。詳細については、このトピックの「Easy Setup Tool の構成パラメータ」セクションを参照してください。 コマンドの例:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-l、--prompt-level インストーラ プロンプトのレベルに応じて、ユーザーの操作レベルを指定します。 各プロンプト レベルの設定は、-f パラメータで指定された構成ファイルから取得されます。詳細については、「Easy Setup Tool の構成パラメータ」を参照してください。 使用できる値:
  • default - 基本的なインストール オプションのプロンプトのみが表示されます。-l パラメータが含まれていないか、構成されていない場合は、この default プロンプト レベルが使用されます。
  • advanced - default のプロンプトに加えて、リモート エクスペリエンス機能をインストールするかどうかなど、高度なインストール オプションを求めるプロンプトが表示されます。
  • expert - defaultadvanced のプロンプトに加えて、FIPS サポートをインストールするかどうかなど、エキスパートによるインストール オプションのプロンプトが表示されます。
コマンドの例:

./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf
-f、--config-file 指定された構成ファイルから構成を読み取ります。詳細については、「Easy Setup Tool の構成パラメータ」を参照してください。 コマンドの例:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-p、--pre-check-only概要」で説明されている事前チェック操作のみを実行します。システム構成や Horizon Agent のインストールは実行しません。 コマンドの例:

./easyinstall_viewagent.sh -p
-c、--configure-only概要」で説明されているシステム構成のみを実行します。事前チェック操作や Horizon Agent のインストールは実行しません。 コマンドの例:

./easyinstall_viewagent.sh -c
-i、--install-agent-only概要」で説明されているように、Horizon Agent のインストールのみを実行します。事前チェック操作またはシステム構成は実行しません。 コマンドの例:

./easyinstall_viewagent.sh -i
-h、--help Easy Setup Tool のヘルプ情報を表示し、ツールを終了します。 コマンドの例:
./easyinstall_viewagent.sh -h

Easy Setup Tool の構成パラメータ

Easy Setup Tool の構成パラメータを指定する場合は、パラメータを構成ファイルに記述し、-f コマンドライン パラメータを使用して構成ファイルを取得します。

たとえば、次のコマンドは、easyinstall.conf 構成ファイルで指定されているように、advanced インストーラ プロンプトを表示してツールを実行します。


./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf

構成ファイルを作成する場合、次のルールと規則に従ってください。

  • easyinstall_viewagent.sh スクリプトを含む tar 形式フォルダにある構成テンプレート easyinstall.conf.template を参照します。

  • 構成ファイルを同じ tar 形式フォルダに保存します。

  • 構成パラメータは、defaultadvancedexpert の 3 つのインストーラ プロンプト レベルに対応するセットにグループ化されています。

  • プロンプトをバイパスするには、構成ファイルでそのプロンプトの構成パラメータをコメント アウトします。

  • 次の表で、「オプション」というラベルの付いたエントリは、オプションの入力を受け入れるプロンプトに対応しています。オプションのプロンプトは、入力を行わずにスキップできます。

  • 「y」または「n」の入力を受け入れるプロンプトの場合、大文字の設定はデフォルトの設定であることを表しています。

    たとえば、EASYINSTALL_AGENT_MANAGED パラメータのデフォルトの設定は「Y」です。これは、デフォルトでは Horizon Agent が管理対象モードでインストールされることを意味します。プロンプトをバイパスするか、Easy Setup Tool をサイレント モードで実行すると、デフォルトの設定が有効になります。

デフォルトなプロンプト レベルのパラメータ

構成パラメータ説明
EASYINSTALL_HOSTNAMEホストのホスト名を指定します(オプション)。
EASYINSTALL_DNS_LISTホストの DNS を指定します(オプション)。
EASYINSTALL_DOMAIN_FQDN参加する Active Directory ドメインの FQDN を指定します。
EASYINSTALL_DOMAIN_JOIN_USERドメイン参加に使用するユーザー アカウントを指定します。
EASYINSTALL_DOMAIN_JOIN_PASSWORDドメイン参加に使用するパスワードを指定します。
EASYINSTALL_PROXY構成プロセスで使用するプロキシ サーバを指定します(オプション)。
EASYINSTALL_AGENT_ACCEPT_GENERAL_TERMS 一般条項契約書に同意するかどうかを [Y/n] で指定します。 Easy Setup Tool を続行するには、一般条項に同意する必要があります。

高度なプロンプト レベルのパラメータ

構成名説明
EASYINSTALL_NTPNTP サーバの IP アドレスを入力します(オプション)。
EASYINSTALL_DOMAIN_JOINActive Directory ドメイン [Y/n] に参加するかどうかを指定します。
EASYINSTALL_AGENT_MANAGEDHorizon Agent を管理対象モードでインストールするかどうかを [Y/n] で指定します。
EASYINSTALL_AGENT_MULTIPLE_SESSION複数のセッションのサポートをインストールするかどうかを [Y/n] で指定します。
EASYINSTALL_AGENT_WEBCAMWeb カメラ リダイレクト機能をインストールするかどうかを [y/N] で指定します。
EASYINSTALL_AGENT_AUDIO_INオーディオ入力リダイレクトのサポートをインストールするかどうかを [y/N] で指定します。
EASYINSTALL_AGENT_USB_REDIRECTIONUSB リダイレクト機能 [y/N] をインストールするかどうかを指定します。
EASYINSTALL_AGENT_CLIENT_DRIVE_REDIRECTIONクライアント ドライブ リダイレクト機能をインストールするかどうかを [Y/n] で指定します。
EASYINSTALL_AGENT_CLIPBOARD_REDIRECTIONクリップボード リダイレクト機能をインストールするかどうかを [Y/n] で指定します。
EASYINSTALL_AGENT_PRINTER_REDIRECTIONプリンタ リダイレクト機能 [Y/n] をインストールするかどうかを指定します。
EASYINSTALL_AGENT_SKIP_BUILD_MODULES必要なモジュールの構築をスキップするかどうかを [y/N] で指定します。
EASYINSTALL_AGENT_SINGLE_SIGN_ONシングル サインオンのサポートをインストールするかどうかを [Y/n] で指定します。
EASYINSTALL_AGENT_RESTART_AFTER_INSTALLATIONインストール後にマシンを自動的に再起動するかどうかを [y/N] で指定します。
EASYINSTALL_HORIZON_CONNECTION_SERVER_ADDRESSConnection Server の FQDN または IP アドレスを入力します(管理対象外モードの場合のみ)。
EASYINSTALL_HORIZON_ADMIN_DOMAINConnection Server の管理者ドメイン名を入力します(管理対象外モードの場合のみ)。
EASYINSTALL_HORIZON_ADMIN_USERConnection Server の管理者名を入力します(管理対象外モードの場合のみ)。
EASYINSTALL_HORIZON_ADMIN_PASSWORDConnection Server の管理者パスワードを入力します(管理対象外モードの場合のみ)。

エキスパートなプロンプト レベルのパラメータ

構成名説明
EASYINSTALL_AGENT_FIPSFIPS モードのサポートをインストールするかどうかを [y/N] で指定します。
EASYINSTALL_AGENT_IPV6IPv6 ネットワークのサポートをインストールするかどうかを [y/N] で指定します。
EASYINSTALL_AGENT_NO_HOSTED_APP単一セッション アプリケーション プールを禁止するかどうかを [y/N] で指定します。
help コマンドを実行して、このパラメータの名前を取得します (./easyinstall_viewagent.sh -h)。True SSO およびスマート カード SSO 機能をサポートする Horizon ログイン画面を無効にするかどうかを [y/N] で指定します。
EASYINSTALL_AGENT_SMARTCARD_REDIRECTIONスマートカード リダイレクト機能をインストールするかどうかを [y/N] で指定します。
EASYINSTALL_AGENT_TRUE_SSOTrue SSO 機能 [y/N] をインストールするかどうかを指定します。
EASYINSTALL_AGENT_SELF_SIGNED_CERT_SUBJECT_DN優先する自己署名証明書のサブジェクト DN を入力します(オプション)。
EASYINSTALL_AGENT_JMS_SSL_KEYSTORE_PASSWORD優先 JMS SSL キーストアのパスワードを入力します(オプション)。
EASYINSTALL_AGENT_VHCI_SOURCE_DOWNLOAD_PATHVHCI ソース パッケージのファイル パスを指定します(オプション)。
EASYINSTALL_AGENT_V4L2LOOPBACK_SOURCE_DOWNLOAD_PATHV4L2Loopback ソース パッケージのファイル パスを指定します(オプション)。
EASYINSTALL_HORIZON_ADMIN_KDCHorizon 8 管理者ドメインの Kerberos Key Distribution Center (KDC) を指定します(管理対象外モードの場合にのみオプション)。
EASYINSTALL_HORIZON_CONNECTION_SERVER_KDCConnection Server ドメインの KDC を指定します(管理対象外モードの場合にのみオプション)。
EASYINSTALL_HORIZON_CONNECTION_SERVER_DOMAINConnection Server のドメイン名を入力します(管理対象外モードの場合にのみオプション)。

Easy Setup Tool の機能に関する考慮事項

Easy Setup Tool には、次の考慮事項と制限事項が適用されます。

このページは役に立ちましたか?

このトピックについてフィードバックを送信

このトピックは役に立ちましたか?

個人情報や機密情報は入力しないでください。

リンクを生成しています…