Citrix Application Delivery Management Service

Configurer l’agent intégré ADC pour gérer les instances

Un agent intégré est disponible sur les instances Citrix ADC MPX, VPX, Gateway exécutant la version 12.1.48.13 et les versions ultérieures et sur les instances Citrix ADC SDX exécutant la version 13.0 61.x et les versions ultérieures et 12.1 58.x et ultérieures. Vous pouvez lancer cet agent sur l’instance ADC au lieu d’installer un agent dédié dans votre centre de données ou cloud public. L’agent intégré permet la communication entre l’instance et Citrix ADM.

Remarque

L’agent intégré est disponible uniquement sur les types d’instances Citrix ADC suivants :

  • Citrix ADC MPX
  • Citrix ADC VPX
  • Citrix ADC SDX
  • Citrix Gateway

L’agent intégré est idéal pour les déploiements ADC autonomes ou de paires HA plus petits. Si vous disposez de plusieurs instances ADC, utilisez un agent dédié pour les déploiements. Cet agent garantit que vous disposez de meilleures capacités d’agrégation de données que l’agent intégré. Pour plus d’informations, voir Installer un agent sur site.

Citrix ADM prend en charge la gestion et la surveillance des instances Citrix ADC à l’aide d’agents intégrés. Toutefois, les fonctionnalités suivantes ne sont pas prises en charge dans l’agent intégré :

  • Tableau de bord de l’application
  • Web Insight
  • Perspectives SSL
  • Perspectives HDX
  • Perspectives de
  • Informations sur la sécurité
  • Analyses avancées
  • Licences groupées

Vous pouvez passer d’un agent intégré à un agent externe. Pour plus d’informations, voir Transition d’un agent intégré vers un agent externe.

Conditions préalables

Avant de configurer un agent intégré sur l’instance Citrix ADC, vérifiez ce qui suit :

  • L’instance Citrix ADC (MPX, VPX ou Gateway) s’exécute sur la version 12.1.48.13 ou une version ultérieure. L’instance SDX exécute la version 13.0.61.x et les versions ultérieures.

  • Un serveur de noms DNS est ajouté sur l’instance Citrix ADC.

    Pour plus d’informations, voir Ajouter un serveur de noms.

  • Vous disposez d’un compte Citrix Cloud. Pour de plus amples informations, consultez la section S’inscrire à Citrix Cloud.

Remarque

Pour toutes les informations relatives aux ports et aux autres exigences du système, consultez la section Configuration système requise.

Configurer l’agent intégré

Effectuez les tâches suivantes pour configurer l’agent intégré ADC :

  1. Sélectionnez l’option Agent intégré comme indiqué dans la section Démarrage.

  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’inscrire auprès du service. Ignorez l’étape 7 si vous êtes client MPX ou Gateway.

    Copier l'URL du service et le code d'activation

  3. Lancez l’agent intégré à l’aide d’un client SSH. Les utilisateurs de la passerelle doivent ignorer cette étape.

    1. Connectez-vous à votre instance Citrix ADC. Pour plus d’informations, consultez la section Accéder à un Citrix ADC.

    2. Accédez au /var/mastools/scripts répertoire et tapez la commande suivante :

      Sur l’instance SDX

      ./mastools_init.sh <user_name> <service-url> <activation-code> -sdx
      <!--NeedCopy-->
      
      • Dans <user_name>, entrez le nom d’utilisateur Citrix ADC.
      ./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile
      
      <!--NeedCopy-->
      

      Remarque :

      Citrix ADM découvre toutes les instances VPX exécutées sur ce SDX et vous n’avez pas à enregistrer les instances VPX individuellement.

      Sur les instances VPX qui ne s’exécutent pas sur une appliance SDX et sur les instances MPX et Gateway :

      Si la version de l’image ADC est inférieure à 13.0 61.x ou 12.1 57.x, vous devez vérifier la mastools version en saisissant 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 indiquées ci-dessous, en fonction de la version du logiciel.

      Version de l’image ADC Est-ce que mastools_version 0.0-0.0 ? Commande pour l’enregistrement avec le profil Commande pour l’enregistrement sans profil
      Inférieur à 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 Sans objet ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      • Dans <user_name>, entrez le nom d’utilisateur Citrix ADC.

    Remarque

    Dans une paire HA, terminez l’enregistrement sur le nœud principal. Si vous exécutez l’enregistrement sur le nœud secondaire, le message suivant s’affiche :

    Exécutez la commande d’enregistrement sur le nœud principal.

  4. Retournez sur la page Citrix ADM et cliquez sur Enregistrer une instance.

  5. Dans Ajouter des instances, affichez l’instance dans laquelle vous avez lancé l’agent intégré. Assurez-vous que l’instance est dans l’état Up et cliquez sur Suivant.

    Ajouter des instances

  6. Cliquez sur Terminé.

Configuration complète de l'agent intégré

Une fois la configuration de l’agent intégré réussie, vous pouvez accéder aux fonctionnalités de Citrix ADM telles que :

  • Serveur virtuel et analytique  : appliquez des licences à votre serveur virtuel pour gérer les instances ADC. Pour plus d’informations, consultez la section Gérer les abonnements.

  • Tableau de bord des applications  : permet d’afficher toutes les applications d’une manière holistique. Pour plus d’informations, voir 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 Infrastructure Analytics.

Remarque

Vous pouvez également configurer l’agent intégré en accédant à la page Infrastructure > Instances > Agents > Générer un code d’activation . Copiez et collez l’URL et le code d’activation dans une instance ADC et découvrez cette instance.

Une fois l’agent intégré lancé, accédez à Infrastructure > Instances > Citrix ADC. Cette page affiche les détails sur l’instance gérée découverte à l’aide de l’agent intégré.

Résolution des problèmes

Vous pouvez consulter 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 Citrix ADM.

  • Si l’enregistrement échoue, vérifiez les journaux dans /var/mastools/logs/mastools_reg.py.log
  • Si l’enregistrement aboutit, mais que l’agent intégré n’apparaît pas dans l’interface graphique Citrix ADM, vérifiez :
    • MASTools_Upgrade journaux dans /var/mastools/logs/mastools_upgrade.log
    • Journaux binaires/var/log/mastoolsd.log.
Configurer l’agent intégré ADC pour gérer les instances