Migrer la console NetScaler sur site vers Citrix Cloud
Vous pouvez migrer NetScaler ADM 13.0 64.35 ou une version ultérieure vers Citrix Cloud. Si votre NetScaler ADM dispose de la version 12.1 ou d’une version antérieure, vous devez d’abord effectuer une mise à niveau vers 13.0 64.35 ou une version ultérieure , puis migrer vers Citrix Cloud. Pour plus d’informations, consultez la section Mise à niveau .
Note:
Le service NetScaler ADM est désormais renommé service NetScaler Console. L’interface utilisateur et la documentation de notre produit sont actuellement en cours de mise à jour pour refléter ces changements. Pendant cette période, vous pourrez rencontrer des noms plus anciens et plus récents référencés de manière interchangeable. Nous vous remercions de votre compréhension durant cette transition.
Le service NetScaler Console via Citrix Cloud vous permet d’obtenir :
-
Des versions plus rapides, environ toutes les deux semaines avec les dernières mises à jour des fonctionnalités.
-
Analyse basée sur l’apprentissage automatique pour la sécurité des applications et des robots, les performances et l’utilisation.
-
Diverses autres fonctionnalités actuellement prises en charge uniquement dans le service NetScaler Console, telles que l’analyse des périodes de pointe et de creux, l’analyse basée sur l’apprentissage automatique pour la sécurité des applications et des bots, l’analyse du processeur des applications et bien d’autres.
Pour une migration réussie, vous devez :
-
Assurez-vous d’avoir une connexion Internet dans la console NetScaler sur site pour l’accessibilité à Citrix Cloud
-
Configurer l’agent NetScaler
-
Obtenez le fichier CSV client et secret depuis Citrix Cloud
-
Valider la licence de la console NetScaler
-
Migrer à l’aide d’un script
Après avoir migré de NetScaler Console sur site vers le service NetScaler Console, si vous souhaitez continuer avec NetScaler Console sur site, vous pouvez utiliser le script de restauration. Pour plus d’informations, voir Revenir à la console NetScaler sur site.
Configurer l’agent NetScaler
Pour activer les communications entre les instances NetScaler et le service NetScaler Console, vous devez configurer un agent. Les agents NetScaler sont, par défaut, automatiquement mis à niveau vers la dernière version. Vous pouvez également sélectionner une heure spécifique pour la mise à niveau de l’agent. Pour plus d’informations, voir Configuration des paramètres de mise à niveau de l’agent.
-
Si votre console NetScaler existante sur site (autonome ou paire HA) n’a aucun agent configuré, vous devez configurer au moins un agent pour le service de console NetScaler.
-
Si votre console NetScaler existante sur site (autonome ou paire HA) est configurée avec des agents sur site pour les déploiements multisites, vous devez configurer le même nombre d’agents pour le service de console NetScaler.
Pour plus d’informations sur la configuration d’un agent, consultez la section Mise en route .
Obtenez le fichier CSV client et secret depuis Citrix Cloud
Après avoir configuré l’agent, récupérez le fichier CSV client et secret à partir de la page Citrix Cloud :
-
Connectez-vous à citrix.cloud.com
-
Cliquez sur l’icône Accueil et sélectionnez Gestion des identités et des accès
-
Dans l’onglet Accès API , saisissez un nom de client sécurisé et cliquez sur Créer un client.
-
L’ID et le secret sont générés. Cliquez sur Télécharger et enregistrez le fichier CSV dans la console NetScaler sur site.
Par exemple, enregistrez le fichier CSV dans le répertoire /var.
Valider les licences de service de la console NetScaler
Vous devez obtenir licences pour le service NetScaler.
- Les licences VIP du service NetScaler Console doivent être supérieures ou égales aux licences VIP sur site.
Note
Si les licences VIP sont inférieures, les serveurs virtuels sont sélectionnés de manière aléatoire et la configuration de niveau VIP pour le service NetScaler Console échoue.
-
Si vous utilisez le déploiement sur site de NetScaler Console comme serveur de licences, réallouez vos licences au service NetScaler Console avant la migration. Pour plus d’informations, voir Comment réaffecter un fichier de licence.
-
Si vous utilisez les licences groupées dans NetScaler Console sur site, vous devez obtenir les licences groupées pour le service NetScaler Console, puis allouer des licences aux instances NetScaler. Pour plus d’informations, voir Configurer les licences groupées. Les versions NetScaler prises en charge suivantes vous permettent de modifier l’allocation de licence à partir de la console NetScaler :
-
NetScaler SDX : 13.0 74.11 ou versions ultérieures.
-
NetScaler VPX et MPX : versions 13.0 47.24 ou ultérieures, 12.1 58.14 ou ultérieures et 11.1 65.10 ou ultérieures.
-
Migrer à l’aide d’un script
-
À l’aide de la version NetScaler Console 82.x, vous pouvez sélectionner la fonctionnalité, puis migrer.
-
Pour les versions NetScaler Console 76.x ou ultérieures, les scripts de migration (
servicemigrationtool.pyetconfig_collect_onprem.py) sont disponibles dans le cadre de la version, disponible à l’adressecd /mps/scripts. -
Pour les versions NetScaler Console antérieures à 76.x, vous devez télécharger les scripts de migration et copier les scripts dans NetScaler Console sur site.
Note
Assurez-vous que la console NetScaler sur site dispose d’une connectivité Internet pendant la migration.
-
À l’aide d’un client SSH, connectez-vous à la console NetScaler sur site.
Note
Pour une paire NetScaler Console HA, connectez-vous au nœud principal.
-
Tapez shell et appuyez sur Entrez pour passer en mode bash.
-
Copiez l’ID client et le fichier CSV secret. Par exemple, copiez le fichier dans le répertoire /var.
Après avoir copié le fichier CSV, vous pouvez vérifier si le fichier CSV est présent.
Note
Pour une paire NetScaler Console HA, copiez le fichier CSV dans le nœud principal.
-
Pour NetScaler Console on-prem 13.0 82.xx version, exécutez les commandes suivantes pour terminer la migration :
-
cd /mps/scripts -
python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler Console VM>
Par exemple,
python servicemigrationtool.py /var/secureclient.csvAprès avoir exécuté le script de migration, l’outil affiche les options suivantes :
En fonction du choix que vous fournissez, seule cette fonctionnalité est migrée vers le service NetScaler Console.
Dans l’exemple, l’option 1 est sélectionnée. L’outil termine la migration de gestion et de surveillance (M&M) et affiche le message suivant :
La fonctionnalité Gestion et surveillance (M&M) comprend :
-
Instances NetScaler, balises, groupes d’instances, profils, applications personnalisées, tâches de configuration, SNMP, configurations syslog.
-
Sites, blocages IP, rapports réseau, seuils d’analyse, paramètres de notification, paramètres d’élagage des données.
-
Configurez les modèles d’audit, les intervalles d’interrogation, les règles d’événement et les paramètres.
-
Groupes, rôles et politiques RBAC
La fonctionnalité Analytics comprend :
-
Configuration Appflow par vserver à partir d’instances NetScaler.
-
Configuration Appflow par périphérique SDWAN.
Note:
-
La fonctionnalité Gestion et surveillance (M&M) est automatiquement migrée, même si vous sélectionnez une autre fonctionnalité (2, 3 ou 4).
-
Vous ne pouvez spécifier qu’une seule fonctionnalité à la fois.
-
Une fois la migration d’une fonctionnalité terminée, si vous souhaitez migrer une autre fonctionnalité ultérieurement, la fonctionnalité déjà migrée n’apparaît pas dans la liste. Par exemple, si vous terminez d’abord la migration de la fonctionnalité Analytics , la prochaine fois que vous exécuterez le script de migration, vous ne pourrez voir que les options StyleBooks, Pooled Licensinget All .
-
Lorsque vous migrez des licences groupées, elles migrent tous les types, y compris les serveurs virtuels.
-
-
Pour NetScaler Console on-prem 13.0 76.xx version, exécutez les commandes suivantes pour terminer la migration :
-
cd /mps/scripts -
python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler Console VM>
Par exemple,
python servicemigrationtool.py /var/secureclient.csv -
-
Pour la console NetScaler sur site antérieure à la version 13.0 76.xx :
-
Téléchargez le script de migration à partir de l’emplacement suivant :
https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgzLe fichier téléchargé comprend deux scripts groupés,
servicemigrationtool_27.pyetconfig_collect_onprem_27.py. -
Enregistrez les deux scripts dans la console NetScaler sur site. Par exemple, enregistrez dans le répertoire /var
-
Exécutez les commandes suivantes pour migrer :
-
cd /var -
servicemigrationtool_27.py <path of ClientID/Secret File in NetScaler Console on-prem VM>Par exemple,
python servicemigrationtool_27.py /var/secureclient.csv
-
-
Après avoir exécuté le script, il vérifie les conditions préalables, puis procède à la migration. Le script vérifie d’abord la disponibilité de la licence. Le message suivant s’affiche uniquement si vous disposez d’une licence de service NetScaler Console inférieure à la licence locale.
Si vous sélectionnez Y, la migration continue en attribuant une licence au VIP de manière aléatoire. Si vous sélectionnez N, le script arrête la migration.
Si vous disposez d’une version d’instance NetScaler non prise en charge pour le serveur de licences groupées, le message suivant s’affiche :
Si vous sélectionnez Y, le processus de migration continue en changeant le serveur de licences. Si vous sélectionnez N, le script vous demande si vous souhaitez procéder au reste de la migration. Le script arrête la migration si vous sélectionnez N.
Selon la configuration sur site, le temps approximatif nécessaire à la migration est compris entre quelques minutes et quelques heures. Une fois la migration terminée, vous voyez le message suivant :
La migration est réussie une fois que toutes les instances NetScaler et leurs configurations respectives sont déplacées avec succès vers le service NetScaler Console. Après une migration réussie, la console NetScaler sur site arrête de traiter les événements d’instance suivants :
-
Certificats SSL
-
Messages Syslog
-
Sauvegarde
-
Groupe d’agents
-
Rapports de performance
-
Audit de configuration
-
Emonplanificateur
Revenir à la console NetScaler sur site
Si vous souhaitez revenir à la console NetScaler sur site, assurez-vous que les conditions préalables sont remplies.
Prérequis
Si votre console NetScaler sur site (avant la migration vers le service NetScaler Console) est :
-
Utilisé comme serveur de licences groupées, assurez-vous de disposer des licences groupées requises dans la console NetScaler sur site.
-
Configuré avec les agents NetScaler, assurez-vous que les agents sont disponibles avec l’état « UP ».
Utiliser le script de restauration
Note
Après la restauration, les mêmes configurations (avant la migration) dans Analytics, SNMP et les licences groupées sont à nouveau disponibles dans la console NetScaler sur site. Si vous avez apporté des modifications à ces configurations après la migration, ces modifications ne sont pas reflétées dans la console NetScaler sur site.
-
Pour les versions NetScaler Console 82.xx ou ultérieures , le script de restauration est disponible dans le cadre de la version et accessible à l’adresse
/mps/scripts. -
Pour les versions NetScaler Console antérieures à 79.xx , vous pouvez soit effectuer une mise à niveau vers la version 82.x et utiliser le script de restauration, soit télécharger le script de restauration et copier le script dans NetScaler Console sur site.
-
À l’aide d’un client SSH, connectez-vous à la console NetScaler sur site.
-
Tapez shell et appuyez sur Entrée pour passer en mode bash.
-
Pour la version NetScaler Console 13.0 82.xx , exécutez les commandes suivantes pour terminer la restauration :
-
cd /mps/scripts
-
python rollback_to_onprem.py
<path of ClientID/Secret File in NetScaler Console on-prem VM>Par exemple,
python rollback_to_onprem.py /var/ secureclient.csv.csvL’outil lance l’opération de restauration et une invite vous demande si vous souhaitez continuer. Tapez Y pour continuer.
Vous pouvez voir le message suivant une fois la restauration terminée.
-
-
Pour la console NetScaler antérieure à la version 82.xx :
-
Téléchargez le script de restauration à partir de l’emplacement suivant :
https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgz -
Pour les versions NetScaler Console 79.xx et 76.xx, enregistrez le script dans
/mps/scriptset exécutez les commandes suivantes pour revenir en arrière :-
cd /mps/scripts -
python rollback_to_onprem.py < chemin du fichier csv client/secret dans la console NetScaler sur site>Par exemple,
python rollback_to_onprem.py /var/ secureclient.csv
-
-
Pour les versions NetScaler Console antérieures à 76.xx, enregistrez le script dans NetScaler Console sur site. Par exemple, enregistrez-le dans l’emplacement
/varet exécutez les commandes suivantes pour revenir en arrière :-
cd /var -
python rollback_to_onprem_27.py < chemin du fichier csv client/secret dans la console NetScaler sur site>Par exemple,
python rollback_to_onprem_27.py /var/secureclient.csv
L’outil lance l’opération de restauration et une invite vous demande si vous souhaitez continuer. Tapez Y pour continuer.
-
-