Configurer l’agent intégré pour gérer les instances
Un agent intégré est disponible sur les instances NetScaler MPX, VPX, Gateway exécutant la version 12.1.48.13
et ultérieure, ainsi que sur les instances NetScaler SDX exécutant la version 13.0 61.x et ultérieure et 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 en paire 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.
NetScaler Console prend en charge la gestion et la surveillance des instances NetScaler à l’aide d’agents intégrés. 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
- Security Insight
- Analyses avancées
- Licences groupées/flexibles
Vous pouvez passer d’un agent intégré à un agent externe. Pour plus d’informations, consultez Passer d’un agent intégré à un agent externe.
Prérequis
Avant de configurer un agent intégré sur l’instance NetScaler, assurez-vous des éléments suivants :
-
L’instance NetScaler (MPX, VPX ou Gateway) exécute la version
12.1.48.13
ou ultérieure. L’instance SDX exécute la version13.0.61.x
et 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 Exigences système.
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 Mise en route.
-
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.
-
Lancez l’agent intégré à l’aide d’un client SSH. Les utilisateurs de Gateway doivent ignorer cette étape.
-
Connectez-vous à votre instance NetScaler. Pour plus d’informations, consultez Accéder à un NetScaler.
-
Accédez au répertoire
/var/mastools/scripts
et tapez la commande suivante :Sur l’instance SDX
Inscription avec 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é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 ayant les mêmes privilèges d’accès que nsroot.Saisissez nsroot
dans<user_name>
. Vous pouvez également utiliser un nom d’utilisateur ayant les mêmes privilèges d’accès que nsroot.Remarque :
NetScaler Console découvre toutes les instances VPX exécutées sur cette SDX et vous n’avez pas à 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 de
mastools
en tapant la commandecat /var/mastools/version.txt
. Si la sortie est0.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 pour l’inscription avec profil Commande pour l’inscription 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érieure à 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érieure à 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>
, saisisseznsroot
. Vous pouvez également utiliser un nom d’utilisateur ayant les 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.
-
-
Retournez à la page NetScaler Console et cliquez sur Enregistrer l’instance.
-
Dans Ajouter des instances, affichez l’instance où vous avez lancé l’agent intégré. Assurez-vous que l’instance est à l’état Actif et cliquez sur Suivant.
-
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 holistique. Pour plus d’informations, consultez Gestion des applications et tableau de bord.
-
Analyses d’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 Analyses d’infrastructure.
Configurer le serveur de licences via l’agent intégré NetScaler
Remarque :
Le rôle LSA ne peut pas être attribué à l’agent intégré NetScaler.
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 sur 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 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 binaires dans
/var/log/mastoolsd.log
.
- Les journaux Mastools_upgrade dans