Automatiser le déploiement de l'agent NetScaler® sur VMware ESXi

Dernière publication : Oct 02, 2026
NetScaler Console vous permet d'automatiser le déploiement des agents NetScaler sur VMware ESXi.
En tant qu'administrateur, vous pouvez automatiser les actions suivantes :
  • Configurer l'agent NetScaler
  • Enregistrer l'agent NetScaler et modifier le mot de passe par défaut de l'agent.

Configurer l'agent NetScaler

Pour automatiser la configuration de l'agent, ajoutez les valeurs des paramètres suivants dans le fichier .ovf :
  1. IPAddress
  2. Netmask
  3. Gateway
  4. Nameserver
  5. Hostname
Remarque :
Le fichier .ovf est disponible dans le fichier image de l'agent. Pour télécharger le fichier de l'agent NetScaler, accédez à <https://www.citrix.com/downloads/citrix-application-management/>. Le modèle de nommage du fichier image de l'agent est le suivant : MASAGENT-ESX-releasenumber-buildnumber.zip

Enregistrer l'agent NetScaler et modifier le mot de passe par défaut

Remarque :
Avant d'enregistrer et de modifier le mot de passe par défaut, assurez-vous d'avoir ajouté les paramètres spécifiés dans Configurer l'agent NetScaler.
Pour automatiser l'enregistrement de l'agent NetScaler et la modification du mot de passe par défaut, ajoutez les valeurs des paramètres suivants dans le même fichier .ovf :
  1. NetScaler Console Server IP
  2. NetScaler Console Username
  3. NetScaler Console Password
  4. Agent New Password

Prérequis

Avant de commencer l'installation d'une appliance virtuelle, assurez-vous de :
  • Installez VMware vSphere 8.x sur un poste de travail de gestion qui répond aux exigences minimales du système.
  • Téléchargez les fichiers d'installation de NetScaler Console.

Comment configurer et enregistrer un agent NetScaler

Étape 1 : Télécharger et modifier le fichier .OVF

  1. Extrayez les fichiers de MASAGENT-ESX-releasenumber-buildnumber.zip vers l'emplacement souhaité. Les fichiers suivants sont extraits :
    • fichier .ovf
    • fichier .vmdk
    • fichier .ova
    • fichier .mf
  2. Ouvrez le fichier .ovf dans n'importe quel éditeur et ajoutez l'exemple de code <ProductSection>..</ProductSection> suivant après la balise </VirtualHardwareSection>
    <ProductSection>
    <Info>Information about the installed software</Info>
    <Product>Application Delivery management</Product>
    <Vendor>Citrix</Vendor>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.ip">
    <Label>IPAddress</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.netmask">
    <Label>Netmask</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.gateway">
    <Label>Gateway</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.nameserver">
    <Label>Nameserver</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.hostname">
    <Label>Hostname</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.ServerIP">
    <Label>NetScaler Console Server IP</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.ServerUname">
    <Label>NetScaler Console Username</Label>  
    </Property>

    <Property ovf:userConfigurable="true" ovf:password="true" ovf:value="VALUE"
    ovf:type="string" ovf:key="eth0.ServerPassword">
    <Label>NetScaler Console Password</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:password="true" ovf:value="VALUE"
    ovf:type="string" ovf:key="eth0.NewPassword">
    <Label>Agent New Password</Label>
    </Property>

    </ProductSection>
  3. Pour les paramètres que vous souhaitez configurer, ajoutez leurs valeurs correspondantes dans ovf:value="VALUE"
    • Pour configurer l'agent NetScaler, ajoutez les valeurs aux paramètres suivants :
      • IPAddress
      • Netmask
      • Gateway
      • Nameserver
      • Hostname
    • Pour enregistrer et modifier le mot de passe par défaut de l'agent NetScaler, ajoutez les valeurs aux paramètres suivants :
      • NetScaler Console Server IP
      • NetScaler Console Username
      • NetScaler Console Password
      • Agent New Password
    Remarque :
    • Vous devez configurer l'agent NetScaler avant d'enregistrer et de modifier le mot de passe par défaut de l'agent.
    • Si vous n'enregistrez pas et ne modifiez pas le mot de passe par défaut dans le fichier .ovf, effectuez ces actions manuellement après le déploiement de la VM.
    Modifier le fichier OVF
  4. Après avoir ajouté les paramètres et leurs valeurs, enregistrez le fichier .ovf.

Étape 2 : Installer l'appliance virtuelle NetScaler Console sur VMware ESXi

  1. Connectez-vous au VMWare vSphere Client et saisissez les informations d'identification de l'administrateur. Cliquez sur Login.
    Connexion vSphere
  2. Sélectionnez votre serveur ESXi, puis cliquez avec le bouton droit de la souris pour sélectionner Deploy OVF Template.
    Déployer le modèle OVF
  3. Dans la page Deploy OVF Template :
    1. Sélectionner un modèle OVF : Sélectionnez Fichier local et accédez à l'emplacement où vous avez enregistré le fichier .ovf modifié et le fichier .vmdk. Sélectionnez les fichiers et cliquez sur Ouvrir pour les télécharger. Cliquez sur Suivant.
      Sélectionner un modèle OVF
    2. Sélectionner un nom et un dossier : Ajoutez un nom pour l'appliance virtuelle et sélectionnez l'emplacement sur l'ESXi où vous souhaitez déployer la machine virtuelle. Cliquez sur Suivant.
      Sélectionner un nom et un dossier
    3. Sélectionner une ressource de calcul : Sélectionnez une ressource sur laquelle exécuter le modèle après son déploiement. Cliquez sur Suivant.
      Sélectionner une ressource de calcul
    4. Vérifier les détails : Vérifiez les détails du modèle OVF. Cliquez sur Suivant.
      Vérifier les détails
    5. Sélectionner le stockage : Sélectionnez une banque de données pour stocker le modèle OVF. Cliquez sur Suivant.
      Sélectionner le stockage
    6. Sélectionner les réseaux : Poursuivez avec les paramètres par défaut. Cliquez sur Suivant.
      Sélectionner le réseau
    7. Personnaliser le modèle : Passez en revue toutes les propriétés du modèle OVF. Tous les paramètres et valeurs que vous avez ajoutés dans le fichier .ovf dans la section Télécharger et modifier le fichier .OVF sont affichés.
      Vérifier le modèle
    8. Prêt à terminer : Pour enregistrer les paramètres et démarrer le processus de déploiement, cliquez sur Terminer.
      Déploiement terminé
    Attendez que le déploiement soit terminé. Une fois que l'état de l'opération Déployer le modèle OVF est terminé à 100 %, votre agent est déployé.
    État du déploiement OVF
    Important :
    Ne mettez pas sous tension l'appliance virtuelle avant de modifier les paramètres.
  4. Cliquez sur la nouvelle appliance virtuelle que vous avez installée et accédez à Configurer > Paramètres > Options vApp > Modifier.
  5. Dans la fenêtre Modifier les options vApp, accédez à Dans les détails OVF > Transport de l'environnement OVF, et sélectionnez VMware Tools. Cliquez sur OK.
    Configurer les paramètres
  6. Cliquez avec le bouton droit sur la machine virtuelle et cliquez sur Mettre sous tension. Alternativement, vous pouvez sélectionner l'onglet Résumé de la machine virtuelle et cliquer sur Mettre sous tension.
    Mettre la VM sous tension
  7. Dans l'onglet Résumé, sélectionnez Lancer la console Web. Dans la fenêtre Lancer la console, sélectionnez Console Web. Cliquez sur Lancer.
    Lancer la consoleSélectionner la console Web
  8. Dans la console, un message d'enregistrement réussi s'affiche une fois que l'agent NetScaler est enregistré auprès du serveur NetScaler Console. Pour vérifier que l'agent NetScaler a été déployé et que le mot de passe par défaut a été modifié, connectez-vous avec le nom d'utilisateur de l'agent NetScaler et le nouveau mot de passe.
    Message de succès d'enregistrement de l'agent

Étape 3 : Vérifier

Pour vérifier que l'agent NetScaler est déployé :
  1. Une fois l'agent NetScaler déployé, accédez à l'interface graphique de NetScaler Console en saisissant l'adresse IP du serveur NetScaler Console dans le navigateur.
  2. Connectez-vous au serveur avec vos identifiants.
  3. Accédez à Infrastructure > Instances > Agents. Le nouvel agent déployé s'affiche dans la plateforme ESX.