Migrer NetScaler Console 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 est en version 12.1 ou antérieure, vous devez d’abord effectuer une mise à niveau vers la version 13.0 64.35 ou ultérieure, puis migrer vers Citrix Cloud. Pour plus d’informations, consultez la section Mise à niveau.
Remarque :
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, il est possible que les anciens et les nouveaux noms soient utilisés de manière interchangeable. Nous vous remercions de votre compréhension pendant 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 de fonctionnalités.
-
Des analyses basées sur l’apprentissage automatique pour la sécurité des applications et des bots, les performances et l’utilisation.
-
Diverses autres fonctionnalités qui ne sont actuellement prises en charge que dans le service NetScaler Console, telles que l’analyse des périodes de pointe et de faible activité, l’analyse basée sur l’apprentissage automatique pour la sécurité des applications et des bots, l’analyse du CPU des applications, et bien d’autres.
Pour une migration réussie, vous devez :
-
Assurez-vous que NetScaler Console sur site dispose d’une connexion Internet pour l’accessibilité à Citrix Cloud.
-
Configurer l’agent NetScaler
-
Obtenir le fichier CSV client et secret depuis Citrix Cloud
-
Valider la licence NetScaler Console
-
Migrer à l’aide d’un script
Après avoir migré de NetScaler Console sur site vers le service NetScaler Console, si vous souhaitez revenir à NetScaler Console sur site, vous pouvez utiliser le script de restauration. Pour plus d’informations, consultez Revenir à NetScaler Console sur site.
Configurer l’agent NetScaler
Pour permettre 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, consultez Configuration des paramètres de mise à niveau de l’agent.
-
Si votre NetScaler Console sur site existant (autonome ou paire HA) n’a pas d’agents configurés, vous devez configurer au moins un agent pour le service NetScaler Console.
-
Si votre NetScaler Console sur site existant (autonome ou paire HA) est configuré avec des agents sur site pour des déploiements multisites, vous devez configurer le même nombre d’agents pour le service NetScaler Console.
Pour plus d’informations sur la configuration d’un agent, consultez la section Mise en route.
Obtenir le fichier CSV client et secret depuis Citrix Cloud
Après avoir configuré l’agent, obtenez le fichier CSV client et secret depuis 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 NetScaler Console sur site.
Par exemple, enregistrez le fichier CSV dans le répertoire /var.
Valider les licences du service NetScaler Console
Vous devez obtenir des licences pour le service NetScaler.
-
Les licences VIP du service NetScaler Console doivent être supérieures ou égales aux licences VIP sur site.
Remarque
Si le nombre de licences VIP est insuffisant, les serveurs virtuels sont sélectionnés aléatoirement et la configuration au niveau VIP pour le service NetScaler Console échoue.
-
Si vous utilisez le déploiement NetScaler Console sur site comme serveur de licences, réallouez vos licences au service NetScaler Console avant la migration. Pour plus d’informations, consultez Comment réallouer un fichier de licence.
-
Si vous utilisez les licences en pool dans NetScaler Console sur site, vous devez obtenir les licences en pool pour le service NetScaler Console, puis allouer des licences aux instances NetScaler. Pour plus d’informations, consultez Configurer les licences en pool. Les versions NetScaler prises en charge suivantes vous permettent de modifier l’allocation de licences depuis NetScaler Console :
-
NetScaler SDX : 13.0 74.11 ou versions ultérieures.
-
NetScaler VPX et MPX : 13.0 47.24 ou versions ultérieures, 12.1 58.14 ou versions ultérieures, et 11.1 65.10 ou versions ultérieures.
-
Migrer à l’aide d’un script
-
À l’aide de la version 82.x de NetScaler Console, vous pouvez sélectionner la fonctionnalité, puis migrer.
-
Pour les versions 76.x ou ultérieures de NetScaler Console, les scripts de migration (
servicemigrationtool.pyetconfig_collect_onprem.py) sont disponibles dans la version, à l’adressecd /mps/scripts. -
Pour les versions de NetScaler Console antérieures à 76.x, vous devez télécharger les scripts de migration et les copier dans NetScaler Console sur site.
Remarque
Assurez-vous que NetScaler Console sur site dispose d’une connectivité Internet pendant la migration.
-
À l’aide d’un client SSH, connectez-vous à NetScaler Console sur site.
Remarque
Pour une paire HA NetScaler Console, connectez-vous au nœud principal.
-
Tapez shell et appuyez sur Entrée pour passer en mode bash.
-
Copiez le fichier CSV d’ID client et de secret. Par exemple, copiez le fichier dans le répertoire /var.
Après avoir copié le fichier CSV, vous pouvez vérifier s’il est présent.
Remarque
Pour une paire HA NetScaler Console, copiez le fichier CSV dans le nœud principal.
-
Pour la version 13.0 82.xx de NetScaler Console sur site, 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 :
Selon le 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 la gestion et de la 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, blocs d’adresses IP, rapports réseau, seuils d’analyse, paramètres de notification, paramètres d’élagage des données.
-
Modèles d’audit de configuration, intervalles d’interrogation, règles et paramètres d’événement.
-
Groupes, rôles et stratégies RBAC
La fonctionnalité Analyse comprend :
-
Configuration Appflow par vserver à partir des instances NetScaler.
-
Configuration Appflow® par périphérique SDWAN.
Remarque :
-
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é Analyse, la prochaine fois que vous exécuterez le script de migration, vous ne verrez que les options StyleBooks, Licences en pool et Tout.
-
Lorsque vous migrez les licences en pool, tous les types, y compris les vservers, sont migrés.
-
-
Pour NetScaler Console sur site version 13.0 76.xx, 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 NetScaler Console 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 de bundle,
servicemigrationtool_27.pyetconfig_collect_onprem_27.py. -
Enregistrez les deux scripts dans NetScaler Console sur site. Par exemple, enregistrez-les 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 prérequis, 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 sur site.
Si vous sélectionnez Y, la migration se poursuit 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 en pool, le message suivant s’affiche :
Si vous sélectionnez Y, le processus de migration se poursuit en modifiant le serveur de licences. Si vous sélectionnez N, le script vous demande si vous souhaitez poursuivre le 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 de quelques minutes à quelques heures. Une fois la migration terminée, le message suivant s’affiche :
La migration est réussie une fois que toutes les instances NetScaler et leurs configurations respectives ont été déplacées avec succès vers le service NetScaler Console. Après une migration réussie, la NetScaler Console sur site cesse de traiter les événements d’instance suivants :
-
Certificats SSL
-
Messages Syslog
-
Sauvegarde
-
Cluster d’agents
-
Rapports de performances
-
Audit de configuration
-
Planificateur
Emon
Revenir à NetScaler Console sur site
Si vous souhaitez revenir à NetScaler Console sur site, assurez-vous que les prérequis sont remplis.
Prérequis
Si votre NetScaler Console sur site (avant la migration vers le service NetScaler Console) est :
-
Utilisé comme serveur de licences en pool, assurez-vous de disposer des licences en pool requises dans NetScaler Console sur site.
-
Configuré avec des agents NetScaler, assurez-vous que les agents sont disponibles avec le statut « UP ».
Utiliser le script de restauration
Remarque
Après la restauration, les mêmes configurations (avant la migration) dans Analytics, SNMP, et les licences en pool sont à nouveau disponibles dans NetScaler Console sur site. Si vous avez apporté des modifications à ces configurations après la migration, ces modifications ne sont pas reflétées dans NetScaler Console sur site.
-
Pour les versions de NetScaler Console 82.xx ou ultérieures, le script de restauration est inclus dans la version et accessible à l’adresse
/mps/scripts. -
Pour les versions de 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 le copier dans NetScaler Console sur site.
-
À l’aide d’un client SSH, connectez-vous à NetScaler Console sur site.
-
Tapez shell et appuyez sur Entrée pour passer en mode bash.
-
Pour la version 13.0 82.xx de NetScaler Console, exécutez les commandes suivantes pour effectuer 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 que la restauration est terminée.
-
-
Pour NetScaler Console 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 79.xx et 76.xx de NetScaler Console, enregistrez le script dans
/mps/scriptset exécutez les commandes suivantes pour restaurer :-
cd /mps/scripts -
python rollback_to_onprem.py < path of client/secret csv file in NetScaler Console on-prem>Par exemple,
python rollback_to_onprem.py /var/ secureclient.csv
-
-
Pour les versions de NetScaler Console antérieures à 76.xx, enregistrez le script dans NetScaler Console sur site. Par exemple, enregistrez-le à l’emplacement
/varet exécutez les commandes suivantes pour restaurer :-
cd /var -
python rollback_to_onprem_27.py < path of client/secret csv file in NetScaler Console on-prem>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.
-
-