Auf dieser Seite wird das Easy Setup Tool (easyinstall_viewagent.sh) für Linux-Maschinen beschrieben. Dieses Tool führt alle Installationen und Systemkonfigurationen durch, die erforderlich sind, um eine Linux-Maschine für die Verwendung in einer VMware Horizon 8-Bereitstellung zur Verfügung zu stellen.

Überblick über das Easy Setup Tool

Das Easy Setup Tool ist ein geführtes Installationsprogramm, das die folgenden Vorgänge auf der Linux-Maschine ausführt.

  • Systemvorabprüfung

    Überprüft, ob die Maschine die folgenden Anforderungen erfüllt:

    Das Tool zeigt eine Benachrichtigung an, wenn die Maschine eine bestimmte Anforderung nicht erfüllt.

  • Systemkonfigurationen

    Führt die folgenden Systemkonfigurationen durch:

    • Konfiguriert DNS.
    • Konfiguriert NTP- und Hostnameneinstellungen und verbindet die Maschine mit einer angegebenen Active Directory Domäne.
      Hinweis: Diese Version des Easy Setup Tools führt nur die Authentifizierungsmethode des System Security Services Daemon (SSSD) für den Domänenbeitritt aus.
  • Horizon Agent-Installationsverzeichnis

    Führt die folgenden Vorgänge auf der Maschine durch:

    • Erstellt die folgenden Kernelmodule zur Unterstützung bestimmter Funktionen von Linux-Desktops:
      • V4L2Loopback-Treiber, der Echtzeit-Audio/Video (RTAV) unterstützt
      • USB-VHCI-Treiber, der die USB-Umleitung unterstützt
    • Installiert die obligatorischen Agent-Abhängigkeiten, wie in Installieren von Linux-Abhängigkeitspaketen für Horizon Agent aufgeführt.
    • Installiert Horizon Agent for Linux mit angegebenen Installationsoptionen.
Hinweis: Informationen zur Angabe von Installationsparametern, wie z. B. der Active Directory-Domäne, Optionen für die Agent-Installation und der Ebene der Eingabeaufforderungen des Installationsprogramms, finden Sie unter Konfigurationsparameter für das Easy Setup Tool.

Laden Sie das Easy Setup Tool herunter und führen Sie es aus

  1. Laden Sie das Installationspaket des Horizon Agent for Linux von der VMware-Download-Site unter https://my.vmware.com/web/vmware/downloads herunter.

    Navigieren Sie zur Downloadseite für die aktuelle Version von VMware Horizon und dann zur Downloadseite für VMware Horizon für 64-Bit-Linux.

    Laden Sie die TAR-Datei des Horizon Agent-Installationsprogramms mit dem Dateinamen VMware-horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz herunter, wobei YYMM als Marketingversionsnummer, y.y.y als interne Versionsnummer und xxxxxxx als Build-Nummer fungieren.

  2. Entpacken Sie die TAR-Datei für Ihre Linux-Verteilung. Beispiel:
    tar -xvzf VMware-horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz
  3. Navigieren Sie zum Ordner der TAR-Datei und führen Sie das Skript easyinstall.viewagent.sh als Root-Benutzer aus. Fügen Sie die Befehlszeilenparameter für alle Installationsoptionen an, die Sie einschließen möchten.

    Detaillierte Informationen finden Sie unter Befehlszeilenparameter für das Easy Setup Tool.

    Verwenden Sie die folgenden Befehlsbeispiele als Referenz:

    #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. Lassen Sie zu, dass das Easy Setup Tool unterbrechungsfrei fortgesetzt wird, und reagieren Sie nach Bedarf auf alle Eingabeaufforderungen des Installationsprogramms.
  5. Starten Sie nach Abschluss des Installationsvorgangs die Linux-Maschine neu, damit die Änderungen wirksam werden.
  6. Überprüfen Sie, ob der viewagent-Dienst gestartet wurde, indem Sie folgenden Befehl ausführen:
    sudo service viewagent status

Befehlszeilenparameter für das Easy Setup Tool

In der folgenden Tabelle werden die Befehlszeilenparameter beschrieben, die Sie an den Ausführungsbefehl ./easyinstall_viewagent.sh anhängen können, um Installationsoptionen und Eingabeaufforderungsebenen anzugeben.

Option Beschreibung
-s, --silent

Führt das Easy Setup Tool im unbeaufsichtigten Modus aus und umgeht alle Eingabeaufforderungen des Installationsprogramms.

Erforderliche Installationsoptionen werden aus der Konfigurationsdatei abgerufen, die durch den Parameter -f angegeben wurde. Weitere Informationen finden Sie unter Konfigurationsparameter für das Easy Setup Tool.

Befehlsbeispiel:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-l, --prompt-level

Gibt den Grad der Benutzerinteraktion basierend auf der Ebene der Eingabeaufforderungen des Installationsprogramms an.

Die Einstellungen für jede Eingabeaufforderungsebene werden aus der Konfigurationsdatei abgerufen, die durch den Parameter -f angegeben wurde. Weitere Informationen finden Sie unter Konfigurationsparameter für das Easy Setup Tool.

Zulässige Werte:

  • default – Zeigt nur die Eingabeaufforderungen für grundlegende Installationsoptionen an. Wenn der Parameter -l nicht enthalten oder nicht konfiguriert ist, wird diese default-Eingabeaufforderungsebene verwendet.
  • advanced – Zusätzlich zu default-Eingabeaufforderungen werden Eingabeaufforderungen für erweiterte Installationsoptionen angezeigt, z. B. ob Remote Experience-Funktionen installiert werden sollen.
  • expert – Zusätzlich zu default- und advanced-Eingabeaufforderungen werden Eingabeaufforderungen für Experteninstallationsoptionen angezeigt, z. B. ob die FIPS-Unterstützung installiert werden soll.

Befehlsbeispiel:

./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf
-f, --config-file

Liest Konfigurationen aus der angegebenen Konfigurationsdatei. Weitere Informationen finden Sie unter Konfigurationsparameter für das Easy Setup Tool.

Befehlsbeispiel:

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-p, --pre-check-only

Führt nur die in Überblick über das Easy Setup Tool beschriebenen Vorabprüfungsvorgänge durch. Führt keine Systemkonfigurationen oder Horizon Agent-Installation durch.

Befehlsbeispiel:

./easyinstall_viewagent.sh -p
-c, --configure-only

Führt nur die in Überblick über das Easy Setup Tool beschriebenen Systemkonfigurationen aus. Führt keine Vorabprüfungsvorgänge oder Horizon Agent-Installation durch.

Befehlsbeispiel:

./easyinstall_viewagent.sh -c
-i, --install-agent-only

Installiert nur Horizon Agent, wie in Überblick über das Easy Setup Tool beschrieben. Führt keine Vorabprüfungsvorgänge oder Systemkonfigurationen durch.

Befehlsbeispiel:

./easyinstall_viewagent.sh -i
-h, --help

Zeigt Hilfeinformationen zum Easy Setup Tool an und beendet das Tool.

Befehlsbeispiel:

./easyinstall_viewagent.sh -h

Konfigurationsparameter für das Easy Setup Tool

Sie können Konfigurationsparameter für das Easy Setup Tool angeben, indem Sie die Parameter in eine Konfigurationsdatei schreiben und dann die Datei mit dem Befehlszeilenparameter -f abrufen.

Beispielsweise führt der folgende Befehl die Tools mit advanced-Eingabeaufforderungen des Installationsprogramms aus, wie in der Konfigurationsdatei easyinstall.conf angegeben.

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

Beachten Sie beim Schreiben einer Konfigurationsdatei die folgenden Regeln und Konventionen:

  • Weitere Informationen finden Sie in der Konfigurationsvorlage easyinstall.conf.template, die sich im selben TAR-Dateiordner befindet, der das easyinstall_viewagent.sh-Skript enthält.
  • Speichern Sie Ihre Konfigurationsdatei im selben TAR-Dateiordner.
  • Konfigurationsparameter sind in Sätzen gruppiert, die den drei Aufforderungsebenen des Installationsprogramms entsprechen: default, advanced und expert.
  • Um eine Eingabeaufforderung zu umgehen, kommentieren Sie den Konfigurationsparameter für diese Eingabeaufforderung in der Konfigurationsdatei aus.
  • In den folgenden Tabellen entsprechen Einträge mit der Bezeichnung „Optional“ den Eingabeaufforderungen, die optionale Eingaben akzeptieren. Benutzer können eine optionale Eingabeaufforderung überspringen, ohne etwas einzugeben.
  • Für Eingabeaufforderungen, die die Eingabe „y“ oder „n“ akzeptieren, stellt die Großbuchstabeneinstellung die Standardeinstellung dar.

    Der Parameter EASYINSTALL_AGENT_MANAGED verwendet beispielsweise „Y“ als Standardeinstellung, d. h., Horizon Agent wird standardmäßig im verwalteten Modus installiert. Die Standardeinstellung wird wirksam, wenn Sie eine Eingabeaufforderung umgehen oder das Easy Setup Tool im unbeaufsichtigten Modus ausführen.

Tabelle 1. Parameter für die Standard-Eingabeaufforderungsebene
Konfigurationsparameter Beschreibung
EASYINSTALL_HOSTNAME Geben Sie den Hostnamen für den Host an (optional).
EASYINSTALL_DNS_LIST Geben Sie den DNS für den Host an (optional).
EASYINSTALL_DOMAIN_FQDN Geben Sie den FQDN der Active Directory-Domäne an, der Sie beitreten möchten.
EASYINSTALL_DOMAIN_JOIN_USER Geben Sie das Benutzerkonto an, das für den Domänenbeitritt verwendet werden soll.
EASYINSTALL_DOMAIN_JOIN_PASSWORD Geben Sie das Kennwort an, das für den Domänenbeitritt verwendet werden soll.
EASYINSTALL_PROXY Geben Sie den Proxy-Server an, der während des Konfigurationsvorgangs verwendet werden soll (optional).
EASYINSTALL_AGENT_ACCEPT_GENERAL_TERMS

Geben Sie an, ob Sie die Allgemeinen Bedingungen akzeptieren möchten [J/N].

Sie müssen die Allgemeinen Bedingungen akzeptieren, um mit dem Easy Setup Tool fortzufahren.
Tabelle 2. Parameter für die erweiterte Eingabeaufforderungsebene
Name der Konfiguration Beschreibung
EASYINSTALL_NTP Geben Sie die IP-Adresse des NTP-Servers ein (optional).
EASYINSTALL_DOMAIN_JOIN Geben Sie an, ob Sie der Active Directory-Domäne beitreten möchten [Y/n].
EASYINSTALL_AGENT_MANAGED Geben Sie an, ob Horizon Agent im verwalteten Modus [Y/n] installiert werden soll.
EASYINSTALL_AGENT_MULTIPLE_SESSION Geben Sie an, ob die Unterstützung für mehrere Sitzungen [Y/n] installiert werden soll.
EASYINSTALL_AGENT_WEBCAM Geben Sie an, ob die Webcam-Umleitungsfunktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_AUDIO_IN Geben Sie an, ob die Unterstützung für die Audioeingabeumleitung [y/N] installiert werden soll.
EASYINSTALL_AGENT_USB_REDIRECTION Geben Sie an, ob die USB-Umleitungsfunktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_CLIENT_DRIVE_REDIRECTION Geben Sie an, ob die Funktion der Clientlaufwerksumleitung [Y/n] installiert werden soll.
EASYINSTALL_AGENT_CLIPBOARD_REDIRECTION Geben Sie an, ob die Funktion zur Zwischenablagenumleitung [Y/n] installiert werden soll.
EASYINSTALL_AGENT_PRINTER_REDIRECTION Geben Sie an, ob die Druckerumleitungsfunktion [Y/n] installiert werden soll.
EASYINSTALL_AGENT_SKIP_BUILD_MODULES Geben Sie an, ob die Erstellung erforderlicher Module [y/N] übersprungen werden soll.
EASYINSTALL_AGENT_SINGLE_SIGN_ON Geben Sie an, ob die Unterstützung für Single Sign-On [Y/n] installiert werden soll.
EASYINSTALL_AGENT_RESTART_AFTER_INSTALLATION Geben Sie an, ob die Maschine nach der Installation [y/N] automatisch neu gestartet werden soll.
EASYINSTALL_HORIZON_CONNECTION_SERVER_ADDRESS Geben Sie den FQDN oder die IP-Adresse des Verbindungsservers ein (nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_ADMIN_DOMAIN Geben Sie den Administratordomänennamen des Verbindungsservers ein (nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_ADMIN_USER Geben Sie den Administratornamen des Verbindungsservers ein (nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_ADMIN_PASSWORD Geben Sie das Administratorkennwort des Verbindungsservers ein (nur für den nicht verwalteten Modus).
Tabelle 3. Parameter für die Eingabeaufforderungsebene für Experten
Name der Konfiguration Beschreibung
EASYINSTALL_AGENT_FIPS Geben Sie an, ob die Unterstützung für den FIPS-Modus [y/N] installiert werden soll.
EASYINSTALL_AGENT_IPV6 Geben Sie an, ob die Unterstützung für IPv6-Netzwerke [y/N] installiert werden soll.
EASYINSTALL_AGENT_NO_HOSTED_APP Geben Sie an, ob Einzelsitzungs-Anwendungspools [y/N] nicht zulässig sind.
EASYINSTALL_AGENT_DISABLE_VMWGREETER Geben Sie an, ob der VMware Greeter deaktiviert werden soll, der die True SSO- und Smartcard-SSO-Funktionen [y/N] unterstützt.
EASYINSTALL_AGENT_SMARTCARD_REDIRECTION Geben Sie an, ob die Smartcard-Umleitungsfunktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_TRUE_SSO Geben Sie an, ob die True SSO-Funktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_SELF_SIGNED_CERT_SUBJECT_DN Geben Sie den Antragsteller-DN des bevorzugten selbstsignierten Zertifikats ein (optional).
EASYINSTALL_AGENT_JMS_SSL_KEYSTORE_PASSWORD Geben Sie das bevorzugte JMS-SSL-Keystore-Kennwort ein (optional).
EASYINSTALL_AGENT_VHCI_SOURCE_DOWNLOAD_PATH Geben Sie den Dateipfad des VHCI-Quellpakets an (optional).
EASYINSTALL_AGENT_V4L2LOOPBACK_SOURCE_DOWNLOAD_PATH Geben Sie den Dateipfad des V4L2Loopback-Quellpakets an (optional).
EASYINSTALL_HORIZON_ADMIN_KDC Geben Sie das Kerberos Key Distribution Center (KDC) für die VMware Horizon 8-Administratordomäne an (optional, nur für nicht verwalteten Modus).
EASYINSTALL_HORIZON_CONNECTION_SERVER_KDC Geben Sie das KDC für die Verbindungsserver-Domäne an (optional, nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_CONNECTION_SERVER_DOMAIN Geben Sie den Domänennamen des Verbindungsservers ein (optional, nur für den nicht verwalteten Modus).

Funktionsüberlegungen für das Easy Setup Tool

Die folgenden Überlegungen und Einschränkungen gelten für das Easy Setup Tool.