Skip to main content

16. April 2026

Verwenden des Easy Setup Tools zum Vorbereiten einer Linux-Maschine

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 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-Installation

    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 für Horizon Agent for Linux vonOmnissa Customer Connect herunter.

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

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

  2. Entpacken Sie die TAR-Datei für Ihre Linux-Distribution. Beispiel: Gehen Sie unter der Annahme, dass die Installationsdatei den Namen horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz aufweist, folgendermaßen vor:

    tar -xvzf *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.

    Ausführliche Informationen finden Sie unter „Befehlszeilenparameter für das Easy Setup Tool“ weiter unten.

    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.

OptionBeschreibung
-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 im Abschnitt „Konfigurationsparameter für das Easy Setup Tool“ in diesem Thema. 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 der Übersicht 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 der Übersicht beschriebenen Systemkonfigurationen durch. 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 der Übersicht 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.

Parameter für die Standard-Eingabeaufforderungsebene

KonfigurationsparameterBeschreibung
EASYINSTALL_HOSTNAMEGeben Sie den Hostnamen für den Host an (optional).
EASYINSTALL_DNS_LISTGeben Sie den DNS für den Host an (optional).
EASYINSTALL_DOMAIN_FQDNGeben Sie den FQDN der Active Directory-Domäne an, der Sie beitreten möchten.
EASYINSTALL_DOMAIN_JOIN_USERGeben Sie das Benutzerkonto an, das für den Domänenbeitritt verwendet werden soll.
EASYINSTALL_DOMAIN_JOIN_PASSWORDGeben Sie das Kennwort an, das für den Domänenbeitritt verwendet werden soll.
EASYINSTALL_PROXYGeben 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.

Parameter für die erweiterte Eingabeaufforderungsebene

Name der KonfigurationBeschreibung
EASYINSTALL_NTPGeben Sie die IP-Adresse des NTP-Servers ein (optional).
EASYINSTALL_DOMAIN_JOINGeben Sie an, ob Sie der Active Directory-Domäne beitreten möchten [Y/n].
EASYINSTALL_AGENT_MANAGEDGeben Sie an, ob Horizon Agent im verwalteten Modus [Y/n] installiert werden soll.
EASYINSTALL_AGENT_MULTIPLE_SESSIONGeben Sie an, ob die Unterstützung für mehrere Sitzungen [Y/n] installiert werden soll.
EASYINSTALL_AGENT_WEBCAMGeben Sie an, ob die Webcam-Umleitungsfunktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_AUDIO_INGeben Sie an, ob die Unterstützung für die Audioeingabeumleitung [y/N] installiert werden soll.
EASYINSTALL_AGENT_USB_REDIRECTIONGeben Sie an, ob die USB-Umleitungsfunktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_CLIENT_DRIVE_REDIRECTIONGeben Sie an, ob die Funktion der Clientlaufwerksumleitung [Y/n] installiert werden soll.
EASYINSTALL_AGENT_CLIPBOARD_REDIRECTIONGeben Sie an, ob die Funktion zur Zwischenablagenumleitung [Y/n] installiert werden soll.
EASYINSTALL_AGENT_PRINTER_REDIRECTIONGeben Sie an, ob die Druckerumleitungsfunktion [Y/n] installiert werden soll.
EASYINSTALL_AGENT_SKIP_BUILD_MODULESGeben Sie an, ob die Erstellung erforderlicher Module [y/N] übersprungen werden soll.
EASYINSTALL_AGENT_SINGLE_SIGN_ONGeben Sie an, ob die Unterstützung für Single Sign-On [Y/n] installiert werden soll.
EASYINSTALL_AGENT_RESTART_AFTER_INSTALLATIONGeben Sie an, ob die Maschine nach der Installation [y/N] automatisch neu gestartet werden soll.
EASYINSTALL_HORIZON_CONNECTION_SERVER_ADDRESSGeben Sie den FQDN oder die IP-Adresse des Verbindungsservers ein (nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_ADMIN_DOMAINGeben Sie den Administratordomänennamen des Verbindungsservers ein (nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_ADMIN_USERGeben Sie den Administratornamen des Verbindungsservers ein (nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_ADMIN_PASSWORDGeben Sie das Administratorkennwort des Verbindungsservers ein (nur für den nicht verwalteten Modus).

Parameter für die Eingabeaufforderungsebene für Experten

Name der KonfigurationBeschreibung
EASYINSTALL_AGENT_FIPSGeben Sie an, ob die Unterstützung für den FIPS-Modus [y/N] installiert werden soll.
EASYINSTALL_AGENT_IPV6Geben Sie an, ob die Unterstützung für IPv6-Netzwerke [y/N] installiert werden soll.
EASYINSTALL_AGENT_NO_HOSTED_APPGeben Sie an, ob Einzelsitzungs-Anwendungspools [y/N] nicht zulässig sind.
Führen Sie den Hilfebefehl aus, um den Namen dieses Parameters (./easyinstall_viewagent.sh -h) abzurufen.Geben Sie an, ob der Horizon Greeter deaktiviert werden soll, der die True SSO- und Smartcard-SSO-Funktionen [y/N] unterstützt.
EASYINSTALL_AGENT_SMARTCARD_REDIRECTIONGeben Sie an, ob die Smartcard-Umleitungsfunktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_TRUE_SSOGeben Sie an, ob die True SSO-Funktion [y/N] installiert werden soll.
EASYINSTALL_AGENT_SELF_SIGNED_CERT_SUBJECT_DNGeben Sie den Antragsteller-DN des bevorzugten selbstsignierten Zertifikats ein (optional).
EASYINSTALL_AGENT_JMS_SSL_KEYSTORE_PASSWORDGeben Sie das bevorzugte JMS-SSL-Keystore-Kennwort ein (optional).
EASYINSTALL_AGENT_VHCI_SOURCE_DOWNLOAD_PATHGeben Sie den Dateipfad des VHCI-Quellpakets an (optional).
EASYINSTALL_AGENT_V4L2LOOPBACK_SOURCE_DOWNLOAD_PATHGeben Sie den Dateipfad des V4L2Loopback-Quellpakets an (optional).
EASYINSTALL_HORIZON_ADMIN_KDCGeben Sie das Kerberos Key Distribution Center (KDC) für die Horizon 8-Administratordomäne an (optional, nur für nicht verwalteten Modus).
EASYINSTALL_HORIZON_CONNECTION_SERVER_KDCGeben Sie das KDC für die Verbindungsserver-Domäne an (optional, nur für den nicht verwalteten Modus).
EASYINSTALL_HORIZON_CONNECTION_SERVER_DOMAINGeben 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.

War diese Seite hilfreich?

Feedback zu diesem Thema geben

War dieses Thema hilfreich?

Bitte geben Sie keine personenbezogenen oder vertraulichen Daten an.

Link wird erstellt…