Configurer l'agent intégré pour gérer les instances

Dernière publication : Oct 02, 2026
Un agent intégré est disponible sur les instances NetScaler MPX, VPX, Gateway exécutant la version 12.1.48.13 et ultérieure, et sur les instances NetScaler SDX exécutant la version 13.0 61.x et ultérieure, ainsi que la version 12.1 58.x et ultérieure. Vous pouvez lancer cet agent sur l'instance NetScaler au lieu d'installer un agent dédié dans votre centre de données ou votre cloud public. L'agent intégré permet la communication entre l'instance et NetScaler Console.
Remarque :
L'agent intégré est disponible uniquement sur les types d'instances NetScaler suivants :
  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • NetScaler Gateway
L'agent intégré est idéal pour les déploiements NetScaler autonomes ou les paires HA de petite taille. Si vous avez plusieurs instances NetScaler, utilisez un agent dédié pour les déploiements. Cet agent garantit de meilleures capacités d'agrégation de données que l'agent intégré. Pour plus d'informations, consultez Installer un agent sur site.
L'agent intégré de NetScaler Console prend en charge la gestion des instances, la surveillance et les licences groupées ou flexibles. Cependant, les fonctionnalités suivantes ne sont pas prises en charge par l'agent intégré :
  • Tableau de bord des applications
  • Web Insight
  • SSL Insight
  • HDX™ Insight
  • Gateway Insight
  • Aperçu de la sécurité
  • Analyses avancées
  • Licences groupées ou flexibles (licences basées sur des fichiers)
Vous pouvez passer d'un agent intégré à un agent externe. Pour plus d'informations, consultez Transition d'un agent intégré vers un agent externe.

Prérequis

Avant de configurer un agent intégré sur l'instance NetScaler, assurez-vous des points suivants :
  • L'instance NetScaler (MPX, VPX ou Gateway) doit exécuter la version 12.1.48.13 ou ultérieure. L'instance SDX doit exécuter la version 13.0.61.x ou ultérieure.
  • Un serveur de noms DNS est ajouté sur l'instance NetScaler.
    Pour plus d'informations, consultez Ajouter un serveur de noms.
  • Vous disposez d'un compte Citrix Cloud. Pour plus d'informations, consultez S'inscrire à Citrix Cloud.
Remarque :
Pour toutes les informations relatives aux ports et autres exigences système, consultez Configuration système requise.

Configurer l'agent intégré

Effectuez les tâches suivantes pour configurer l'agent intégré NetScaler :
  1. Sélectionnez l'option Agent intégré comme indiqué dans Mise en route.
  2. Copiez l'URL du service et le code d'activation.
    L'agent utilise l'URL du service pour localiser le service et le code d'activation pour s'enregistrer auprès du service. Ignorez l'étape 7 si vous êtes un client MPX ou Gateway.
  3. Lancez l'agent intégré à l'aide d'un client SSH. Les utilisateurs de Gateway doivent ignorer cette étape.
    1. Connectez-vous à votre instance NetScaler. Pour plus d'informations, consultez Accéder à un NetScaler.
    2. Accédez au répertoire /var/mastools/scripts et tapez la commande suivante :
      Sur l'instance SDX
      Enregistrement avec un profil NetScaler Enregistrement sans profil NetScaler
      Prérequis Avant de vous enregistrer, créez un profil NetScaler. Pour plus d'informations, consultez Comment créer un profil NetScaler.
      Exécutez cette commande ./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile ./mastools_init.sh <user_name> <service-url> <activation-code> -sdx
      Identifiant utilisateur Saisissez nsroot dans <device_profile_name>. Vous pouvez également utiliser un nom d'utilisateur disposant des mêmes privilèges d'accès que nsroot. Saisissez nsroot dans <user_name>. Vous pouvez également utiliser un nom d'utilisateur disposant des mêmes privilèges d'accès que nsroot.
      Remarque :
      NetScaler Console découvre toutes les instances VPX exécutées sur cet SDX et vous n'avez pas besoin d'enregistrer les instances VPX individuellement.
      Sur les instances VPX non exécutées sur une appliance SDX et les instances MPX et Gateway :
      Si la version de l'image NetScaler est inférieure à 13.0 61.x ou 12.1 57.x, vous devez vérifier la version mastools en tapant la commande cat /var/mastools/version.txt. Si la sortie est 0.0-0.0, c'est la première fois.
      Tapez l'une des commandes suivantes en fonction de la version du logiciel.
      Remarque :
      Avant de vous inscrire avec un profil NetScaler, vous devez créer le profil. Pour plus d'informations, consultez Comment créer un profil NetScaler.
      Version de l'image NetScaler La version de mastools est-elle 0.0-0.0 ? Commande d'enregistrement avec profil Commande d'enregistrement sans profil
      Inférieure à 13.0 61.xx et 12.1 57.xx Oui ./mastools_init.sh <device_profile_name> <service_url> "MAS;<activation_code>" -profile ./mastools_init.sh <user_name> <pwd> <service_url> "MAS;<activation_code>"
      Inférieur à 13.0 61.xx et 12.1 57.xx Non ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      Supérieur à 13.0 61.x et 12.1 57.xx Non applicable ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
    Remarque :
    • Dans <device_profile_name> ou <user_name>, entrez nsroot. Vous pouvez également utiliser un nom d'utilisateur disposant des mêmes privilèges d'accès que nsroot.
    • Dans une paire HA, effectuez l'enregistrement sur le nœud principal. Si vous exécutez les commandes d'enregistrement sur le nœud secondaire, le message suivant apparaît : Veuillez exécuter la commande d'enregistrement sur le nœud principal.
  4. Retournez à la page NetScaler Console et cliquez sur Enregistrer l'instance.
  5. Dans Ajouter des instances, affichez l'instance où vous avez initié l'agent intégré. Assurez-vous que l'instance est à l'état Actif et cliquez sur Suivant.
  6. Cliquez sur Terminé.
Après une configuration réussie de l'agent intégré, vous pouvez accéder aux fonctionnalités de NetScaler Console telles que :
  • Serveur virtuel et analyses – Appliquez des licences à votre serveur virtuel pour gérer les instances NetScaler. Pour plus d'informations, consultez Gérer les abonnements.
  • Tableau de bord des applications – Pour afficher toutes les applications de manière globale. Pour plus d'informations, consultez Gestion des applications et tableau de bord.
  • Analyse de l'infrastructure – Cette fonctionnalité vous aide à visualiser les facteurs qui ont entraîné ou pourraient entraîner un problème sur les instances. Pour plus d'informations, consultez Analyse de l'infrastructure.

Configurer le serveur de licences via l'agent intégré NetScaler®

Remarque :
L'agent intégré NetScaler ne peut pas se voir attribuer le rôle LSA.
Si vous avez un agent de serveur de licences (LSA) configuré sur un site et que vous souhaitez utiliser le même LSA à partir d'autres sites, vous pouvez utiliser un agent intégré NetScaler. Lors de l'utilisation de l'agent intégré, vous devez configurer le serveur de licences à l'aide de la commande suivante sur l'instance NetScaler.
add licenseserver 127.0.0.1 -port 27000
Dans cette configuration, NetScaler peut atteindre l'agent de serveur de licences (LSA) via le service Console.
Remarque :
Vous pouvez également configurer l'agent intégré en accédant à la page Infrastructure > Instances > Agents > Générer le code d'activation. Copiez et collez l'URL et le code d'activation dans une instance NetScaler et découvrez cette instance.
Une fois l'agent intégré initié, accédez à Infrastructure > Instances > NetScaler. Cette page affiche les détails de l'instance gérée découverte à l'aide de l'agent intégré.

Dépannage

Vous pouvez vérifier les journaux si l'enregistrement échoue ou si l'enregistrement réussit mais que l'agent intégré n'apparaît pas dans l'interface graphique de NetScaler Console.
  • Si l'enregistrement échoue, vérifiez les journaux dans /var/mastools/logs/mastools_reg.py.log
  • Si l'enregistrement réussit, mais que l'agent intégré n'apparaît pas dans l'interface graphique de NetScaler Console, vérifiez :
    • Les journaux Mastools_upgrade dans /var/mastools/logs/mastools_upgrade.log
    • Les journaux Binary dans /var/log/mastoolsd.log.