Skip to main content

10 juillet 2026

Préparer une machine Linux à l'aide d'Easy Setup Tool

Cette page décrit Easy Setup Tool (easyinstall_viewagent.sh) pour les machines Linux. Cet outil effectue toutes les installations et configurations système requises pour rendre une machine Linux disponible pour une utilisation dans un déploiement d'Horizon 8.

Présentation d'Easy Setup Tool

Easy Setup Tool est un programme d'installation guidé qui effectue les opérations suivantes sur la machine Linux.

  • Vérification préalable du système

    Vérifie que la machine agent répond aux conditions requises suivantes :

    L'outil affiche une notification si la machine ne répond pas à une condition requise donnée.

  • Configurations système

    Effectue les configurations système suivantes :

    • Configure DNS.

    • Configure les paramètres NTP et de nom d'hôte requis et joint la machine à un domaine Active Directory spécifié.

      Remarque : cette version d'Easy Setup Tool applique uniquement la méthode d'authentification SSSD (System Security Services Daemon) de jonction de domaine.

  • Installation d'Horizon Agent

    Effectue les opérations suivantes sur la machine :

    • Crée les modules de noyau suivants pour prendre en charge certaines fonctionnalités des postes de travail Linux :
      • Pilote V4L2Loopback, qui prend en charge l'Audio/Vidéo en temps réel (RTAV)
      • Pilote VHCI USB, qui prend en charge la redirection USB
    • Installe les dépendances d'agent obligatoires, comme indiqué dans Installer des modules de dépendance Linux pour Horizon Agent.
    • Installe Horizon Agent for Linux, avec les options d'installation spécifiées.

Remarque : pour plus d'informations sur la spécification des paramètres d'installation, tels que le domaine Active Directory, les options d'installation de l'agent et le niveau des invites du programme d'installation, reportez-vous à la section « Paramètres de configuration d'Easy Setup Tool ».

Télécharger et exécuter Easy Setup Tool

  1. Téléchargez le module du programme d'installation d'Horizon Agent for Linux à partir d'Omnissa Customer Connect.

    Accédez à la page de téléchargement de la version actuelle d'Horizon, puis à la page de téléchargement d'Horizon pour Linux 64 bits.

    Téléchargez le tarball du programme d'installation d'Horizon Agent dont le nom de fichier suit le modèle horizonagent-linux-x86_64-YYMM-y.y.y-xxxxxxx.tar.gz, dans lequel YYMM est le numéro de version marketing, y.y.y est le numéro de version interne et xxxxxxx est le numéro de build.

  2. Décompressez le tarball pour votre distribution Linux. Par exemple, avec le nom de fichier d'installation 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. Accédez au dossier tarball et exécutez le script easyinstall.viewagent.sh en tant qu'utilisateur racine. Ajoutez les paramètres de ligne de commande pour toutes les options d'installation à inclure.

    Pour obtenir des informations détaillées, reportez-vous à la section « Paramètres de ligne de commande d'Easy Setup Tool » ci-dessous.

    Utilisez les exemples de commandes suivants pour référence :

    #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. Autorisez Easy Setup Tool à poursuivre sans interruption et répondez à toutes les invites du programme d'installation si nécessaire.

  5. Une fois le processus d'installation terminé, redémarrez la machine Linux pour appliquer les modifications.

  6. Vérifiez que le service viewagent est démarré en exécutant la commande suivante.

    sudo service viewagent status
    

Paramètres de ligne de commande d'Easy Setup Tool

Le tableau suivant décrit les paramètres de ligne de commande que vous pouvez ajouter à la commande d'exécution ./easyinstall_viewagent.sh pour spécifier les options d'installation et les niveaux d'invite.

OptionDescription
-s, --silent Exécute Easy Setup Tool en mode silencieux en contournant toutes les invites du programme d'installation. Les options d'installation requises sont récupérées à partir du fichier de configuration spécifié par le paramètre -f. Pour plus d'informations, reportez-vous à la section « Paramètres de configuration d'Easy Setup Tool » dans cette rubrique. Exemple de commande :

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-l, --prompt-level Spécifie le niveau d'interaction utilisateur en fonction du niveau des invites du programme d'installation. Les paramètres de chaque niveau d'invite sont récupérés à partir du fichier de configuration spécifié par le paramètre -f. Pour plus d'informations, reportez-vous à la section « Paramètres de configuration d'Easy Setup Tool ». Valeurs autorisées :
  • default : affiche uniquement les invites pour les options d'installation de base. Lorsque le paramètre -l n'est ni inclus ni configuré, ce niveau d'invite default est utilisé.
  • advanced : outre les invites default, en affiche d'autres pour les options d'installation avancées, telles que l'installation ou non des fonctionnalités d'expérience à distance.
  • expert : outre les invites default et advanced, en affiche d'autres pour les options d'installation experte, telles que l'installation ou non de la prise en charge de FIPS.
Exemple de commande :

./easyinstall_viewagent.sh -l advanced -f ./easyinstall.conf
-f, --config-file Lit les configurations à partir du fichier de configuration spécifié. Pour plus d'informations, reportez-vous à la section Paramètres de configuration d'Easy Setup Tool. Exemple de commande :

./easyinstall_viewagent.sh -s -f ./easyinstall.conf
-p, --pre-check-only Effectue uniquement les opérations de vérification préalable décrites dans la présentation. N'effectue ni les configurations système ni l'installation d'Horizon Agent. Exemple de commande :

./easyinstall_viewagent.sh -p
-c, --configure-only Effectue uniquement les configurations système décrites dans la présentation. N'effectue ni les opérations de vérification préalable ni l'installation d'Horizon Agent. Exemple de commande :

./easyinstall_viewagent.sh -c
-i, --install-agent-only Installe uniquement Horizon Agent, comme le décrit la présentation. N'effectue pas d'opérations de vérification préalable ou de configurations système. Exemple de commande :

./easyinstall_viewagent.sh -i
-h, --help Affiche les informations d'aide d'Easy Setup Tool et quitte celui-ci. Exemple de commande :
./easyinstall_viewagent.sh -h

Paramètres de configuration d'Easy Setup Tool

Vous pouvez spécifier les paramètres de configuration d'Easy Setup Tool en écrivant les paramètres dans un fichier de configuration, puis en récupérant celui-ci avec le paramètre de ligne de commande -f.

Par exemple, la commande suivante exécute les outils avec les invites du programme d'installation advanced, comme spécifié dans le fichier de configuration easyinstall.conf.


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

Observez les règles et conventions suivantes lors de l'écriture d'un fichier de configuration :

  • Reportez-vous au modèle de configuration easyinstall.conf.template, situé dans le même dossier tarball qui contient le script easyinstall_viewagent.sh.

  • Enregistrez votre fichier de configuration dans le même dossier tarball.

  • Les paramètres de configuration sont regroupés en ensembles correspondant aux trois niveaux d'invite du programme d'installation : default, advanced et expert.

  • Pour contourner une invite, commentez le paramètre de configuration de cette invite dans le fichier de configuration.

  • Dans les tableaux suivants, les entrées intitulées « Facultatif » correspondent aux invites qui acceptent une entrée facultative. Les utilisateurs peuvent ignorer une invite facultative sans saisir d'entrée.

  • Pour les invites qui acceptent l'entrée « y » ou « n », le paramètre en majuscules représente le paramètre par défaut.

    Par exemple, le paramètre EASYINSTALL_AGENT_MANAGED prend « Y » comme paramètre par défaut, ce qui signifie qu'Horizon Agent est installé en mode géré par défaut. Le paramètre par défaut est appliqué lors du contournement d'une invite ou de l'exécution d'Easy Setup Tool en mode silencieux.

Paramètres du niveau d'invite par défaut

Paramètre de configurationDescription
EASYINSTALL_HOSTNAMESpécifiez le nom de l'hôte (facultatif).
EASYINSTALL_DNS_LISTSpécifiez le DNS de l'hôte (facultatif).
EASYINSTALL_DOMAIN_FQDNSpécifiez le nom du domaine Active Directory complet à joindre.
EASYINSTALL_DOMAIN_JOIN_USERSpécifiez le compte d'utilisateur à utiliser pour la jonction de domaine.
EASYINSTALL_DOMAIN_JOIN_PASSWORDSpécifiez le mot de passe à utiliser pour la jonction de domaine.
EASYINSTALL_PROXYSpécifiez le serveur proxy à utiliser pendant le processus de configuration (facultatif).
EASYINSTALL_AGENT_ACCEPT_GENERAL_TERMS Indiquez s'il convient ou non d'accepter les Conditions générales du contrat [Oui/non]. Vous devez accepter Conditions générales pour continuer avec Easy Setup Tool.

Paramètres du niveau d'invite avancé

Nom de la configurationDescription
EASYINSTALL_NTPEntrez l'adresse IP du serveur NTP (facultatif).
EASYINSTALL_DOMAIN_JOINSpécifiez s'il convient de joindre le domaine Active Directory [Oui/non].
EASYINSTALL_AGENT_MANAGEDSpécifiez s'il convient d'installer Horizon Agent en mode géré [Oui/non].
EASYINSTALL_AGENT_MULTIPLE_SESSIONSpécifiez s'il convient d'installer la prise en charge de plusieurs sessions [Oui/non].
EASYINSTALL_AGENT_WEBCAMSpécifiez s'il convient d'installer la fonctionnalité de redirection de webcam [Oui/non].
EASYINSTALL_AGENT_AUDIO_INSpécifiez s'il convient d'installer la prise en charge de la redirection d'entrée audio [Oui/non].
EASYINSTALL_AGENT_USB_REDIRECTIONSpécifiez s'il convient d'installer la fonctionnalité de redirection USB [Oui/non].
EASYINSTALL_AGENT_CLIENT_DRIVE_REDIRECTIONSpécifiez s'il convient d'installer la fonctionnalité de redirection du lecteur client [Oui/non].
EASYINSTALL_AGENT_CLIPBOARD_REDIRECTIONSpécifiez s'il convient d'installer la fonctionnalité de redirection du Presse-papiers [Oui/non].
EASYINSTALL_AGENT_PRINTER_REDIRECTIONSpécifiez s'il convient d'installer la fonctionnalité de redirection d'imprimante [Oui/non].
EASYINSTALL_AGENT_SKIP_BUILD_MODULESSpécifiez s'il convient d'ignorer la création des modules requis [Oui/non].
EASYINSTALL_AGENT_SINGLE_SIGN_ONSpécifiez s'il convient d'installer la prise en charge de Single Sign-On [Oui/non].
EASYINSTALL_AGENT_RESTART_AFTER_INSTALLATIONSpécifiez s'il convient de redémarrer la machine automatiquement après l'installation [Oui/non].
EASYINSTALL_HORIZON_CONNECTION_SERVER_ADDRESSEntrez le nom de domaine complet ou l'adresse IP du Serveur de connexion (pour le mode non géré uniquement).
EASYINSTALL_HORIZON_ADMIN_DOMAINEntrez le nom de domaine de l'administrateur du Serveur de connexion (pour le mode non géré uniquement).
EASYINSTALL_HORIZON_ADMIN_USEREntrez le nom de l'administrateur du Serveur de connexion (pour le mode non géré uniquement).
EASYINSTALL_HORIZON_ADMIN_PASSWORDEntrez le mot de passe de l'administrateur du Serveur de connexion (pour le mode non géré uniquement).

Paramètres du niveau d'invite expert

Nom de la configurationDescription
EASYINSTALL_AGENT_FIPSSpécifiez s'il convient d'installer la prise en charge du mode FIPS [Oui/non].
EASYINSTALL_AGENT_IPV6Spécifiez s'il convient d'installer la prise en charge de la mise en réseau IPv6 [Oui/non].
EASYINSTALL_AGENT_NO_HOSTED_APPSpécifiez s'il convient d'interdire les pools d'applications de session unique [Oui/non].
Exécutez la commande d'aide pour obtenir le nom de ce paramètre (./easyinstall_viewagent.sh -h)Spécifiez s'il convient de désactiver l'écran d'accueil d'Horizon, qui prend en charge les fonctionnalités True SSO et SSO par carte à puce [Oui/non].
EASYINSTALL_AGENT_SMARTCARD_REDIRECTIONSpécifiez s'il convient d'installer la fonctionnalité de redirection de carte à puce [Oui/non].
EASYINSTALL_AGENT_TRUE_SSOSpécifiez s'il convient d'installer la fonctionnalité True SSO [Oui/non].
EASYINSTALL_AGENT_SELF_SIGNED_CERT_SUBJECT_DNEntrez le nom unique de sujet du certificat auto-signé préféré (facultatif).
EASYINSTALL_AGENT_JMS_SSL_KEYSTORE_PASSWORDEntrez le mot de passe du keystore SSL JMS préféré (facultatif).
EASYINSTALL_AGENT_VHCI_SOURCE_DOWNLOAD_PATHSpécifiez le chemin d'accès au fichier du module source VHCI (facultatif).
EASYINSTALL_AGENT_V4L2LOOPBACK_SOURCE_DOWNLOAD_PATHSpécifiez le chemin d'accès au fichier du module source V4L2Loopback (facultatif).
EASYINSTALL_HORIZON_ADMIN_KDCSpécifiez le centre de distribution de clés (KDC) Kerberos pour le domaine d'administrateur d'Horizon 8 (facultatif, pour le mode non géré uniquement).
EASYINSTALL_HORIZON_CONNECTION_SERVER_KDCSpécifiez le KDC pour le domaine du Serveur de connexion (facultatif, pour le mode non géré uniquement).
EASYINSTALL_HORIZON_CONNECTION_SERVER_DOMAINEntrez le nom de domaine du Serveur de connexion (facultatif, pour le mode non géré uniquement).

Considérations relatives aux fonctionnalités d'Easy Setup Tool

Les considérations et limitations suivantes s'appliquent à Easy Setup Tool.

Cette page vous a-t-elle été utile ?

Envoyer un commentaire sur cette rubrique

Cette rubrique vous a-t-elle été utile ?

N'indiquez aucune information personnelle ou confidentielle.

Génération du lien…