Service NetScaler Console

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

January 25, 2024

Contributeur:

Un agent intégré est disponible sur les instances NetScaler MPX, VPX, Gateway exécutant la version 12.1.48.13 et les versions ultérieures et sur les instances NetScaler SDX exécutant les versions 13.0 61.x et ultérieures et 12.1 58.x et versions ultérieures. 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 la console NetScaler.

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 petits déploiements NetScaler autonomes ou par paires HA. Si vous possédez plusieurs instances NetScaler, 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.

La console NetScaler prend en charge la gestion et la surveillance des instances NetScaler à 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
HDX Insight
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.

Pré-requis

Avant de configurer un agent intégré sur l’instance NetScaler, assurez-vous de ce qui suit :

L’instance NetScaler (MPX, VPX ou Gateway) s’exécute sur la version ou une version ultérieure. 12.1.48.13 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 NetScaler.

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é NetScaler :

Sélectionnez l’option Agent intégré comme indiqué dans la section Démarrage.
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.

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

Connectez-vous à votre instance NetScaler. Pour plus d’informations, consultez la section Accès à un NetScaler.

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

Sur l’instance SDX

||Inscription avec le profil NetScaler|Inscription sans profil NetScaler| |—|—|—| |Prérequis|Avant de vous inscrire, créez un profil NetScaler. Pour plus d’informations, consultez Comment créer un profil NetScaler.| |Exécuter cette commande|./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile|./mastools_init.sh <user_name> <service-url> <activation-code> -sdx| | |Informations d’identification utilisateur|Entrez nsrootdans <device_profile_name>. Vous pouvez également utiliser un nom d’utilisateur doté des mêmes privilèges d’accès que nsroot.|Entrez nsrootdans <user_name>. Vous pouvez également utiliser un nom d’utilisateur doté des mêmes privilèges d’accès que nsroot.|

Remarque :

NetScaler Console 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 NetScaler est inférieure à 13.0 61.x ou 12.1 57.x, vous devez vérifier la mastoolsversion en saisissant la commandecat /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 enregistrer 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	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	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 doté des mêmes privilèges d’accès que nsroot.

Dans une paire HA, terminez 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.

Revenez à la page de la console NetScaler et cliquez sur Enregistrer l’instance.
Dans Ajouter des instances, affichez l’instance dans laquelle vous avez lancé l’agent intégré. Assurez-vous que l’instance est à l’état Actif et cliquez sur Suivant.
Cliquez sur Terminé.

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

Serveur virtuel et analyses: appliquez des licences à votre serveur virtuel pour gérer les instances NetScaler. 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 NetScaler et découvrez cette instance.

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

Dépannage

Vous pouvez consulter les journaux si l’enregistrement échoue ou s’il réussit mais que l’agent intégré n’apparaît pas dans l’interface graphique de la console NetScaler.

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 de la console NetScaler, vérifiez :
- Journaux MASTools_Upgrade dans /var/mastools/logs/mastools_upgrade.log
- Journaux binaires dans /var/log/mastoolsd.log.

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Cela vous a-t-il été utile ?

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

January 25, 2024

Contributeur:

January 25, 2024

Contributeur:

Cela vous a-t-il été utile ?