Documentation Produit
NetScaler Console
14.1-Version actuelle 13.1
Voir PDF

Migrer NetScaler ADM sur site vers Citrix Cloud™

July 30, 2026
Contributeur: 
C C

Vous pouvez migrer NetScaler ADM 13.0 64.35 ou une version ultérieure sur site vers Citrix Cloud. Si votre 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.

Le service ADM 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.

  • Analyses basées sur l’apprentissage automatique pour la sécurité des applications et les bots, les performances et l’utilisation.

  • Diverses autres fonctionnalités actuellement prises en charge uniquement dans le service ADM, telles que l’analyse des périodes de pointe et creuses, l’analyse basée sur l’apprentissage automatique pour la sécurité des applications et les bots, l’analyse du processeur des applications, et bien d’autres.

Pour une migration réussie, vous devez :

  • Assurez-vous de disposer d’une connexion Internet dans l’ADM sur site pour l’accessibilité à Citrix Cloud

  • Configurer l’agent de service ADM

  • Obtenir le fichier CSV client et secret depuis Citrix Cloud

  • Valider la licence du service ADM

  • Migrer à l’aide d’un script

Après avoir migré de l’ADM sur site vers le service ADM, si vous souhaitez continuer à utiliser l’ADM sur site, vous pouvez utiliser le script de restauration. Pour plus d’informations, consultez Restaurer l’ADM sur site.

Configurer l’agent de service ADM

Pour permettre les communications entre les instances NetScaler et NetScaler ADM, 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 ADM sur site existant (autonome ou paire HA) n’a pas d’agents sur site configurés, vous devez configurer au moins un agent pour le service ADM.

  • Si votre ADM sur site existant (autonome ou paire HA) a été configuré avec des agents sur site pour des déploiements multisites, vous devez configurer le même nombre d’agents pour le service ADM.

Pour plus d’informations sur la configuration d’un agent, consultez la section Mise en route.

Obtenez le fichier CSV client et secret à partir de Citrix Cloud

Après avoir configuré l’agent, obtenez le fichier CSV client et secret à partir de la page Citrix Cloud :

  1. Connectez-vous à citrix.cloud.com

  2. Cliquez sur l’icône Accueil et sélectionnez Gestion des identités et des accès

  3. Dans l’onglet Accès API, saisissez un nom de client sécurisé et cliquez sur Créer un client.

  4. L’ID et le secret sont générés. Cliquez sur Télécharger et enregistrez le fichier CSV dans l’ADM sur site.

    Par exemple, enregistrez le fichier CSV dans le répertoire /var.

Validez les licences du service ADM

Vous devez obtenir des licences pour le service ADM.

  • Les licences VIP du service ADM doivent être supérieures ou égales aux licences VIP sur site.

    Remarque

    Si les licences VIP sont inférieures, les serveurs virtuels sont sélectionnés de manière aléatoire et la configuration au niveau VIP pour le service ADM échoue.

  • Si vous utilisez le déploiement ADM sur site comme serveur de licences, réaffectez vos licences au service ADM avant la migration. Pour plus d’informations, consultez Configurer un serveur ADM uniquement comme serveur de licences en pool et Comment réaffecter un fichier de licence.

  • Si vous utilisez les licences en pool dans ADM sur site, vous devez obtenir les licences en pool pour le service ADM, puis allouer des licences aux instances ADC. Pour plus d’informations, consultez (/fr-fr/netscaler-application-delivery-management-software/13-1/license-server/adc-pooled-capacity/configuring-adc-pooled-capacity). Les versions ADC prises en charge suivantes vous permettent de modifier l’allocation de licences à partir d’ADM :

    • 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

  • Avec la version ADM 82.x, vous pouvez sélectionner la fonctionnalité, puis migrer.

  • Pour les versions ADM 76.x ou ultérieures, les scripts de migration (servicemigrationtool.py et config_collect_onprem.py) sont disponibles dans la version, à l’adresse cd /mps/scripts.

  • Pour les versions ADM antérieures à 76.x, vous devez télécharger les scripts de migration et les copier dans ADM sur site.

    Remarque

    Assurez-vous que l’ADM sur site dispose d’une connectivité Internet pendant la migration.

  1. À l’aide d’un client SSH, connectez-vous à l’ADM sur site.

    Remarque

    Pour une paire HA ADM, connectez-vous au nœud principal.

  2. Tapez shell et appuyez sur Entrée pour passer en mode bash.

  3. Copiez le fichier CSV de l’ID client et du 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.

    Ajouter un fichier CSV

    Remarque

    Pour une paire HA ADM, copiez le fichier CSV dans le nœud principal.

  4. Pour la version 13.0 82.xx d’ADM, exécutez les commandes suivantes pour terminer la migration :

    1. cd /mps/scripts

    2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler ADM VM>

    Par exemple, python servicemigrationtool.py /var/secureclient.csv

    Après avoir exécuté le script de migration, l’outil affiche les options suivantes :

    Options de migration par fonctionnalité

    Selon le choix que vous fournissez, seule cette fonctionnalité est migrée vers le service ADM.

    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 :

    Achèvement de la migration

    La fonctionnalité Gestion et surveillance (M&M) comprend :

    • Instances ADC, balises, groupes d’instances, profils, applications personnalisées, tâches de configuration, SNMP, configurations syslog.

    • Sites, blocs 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énements.

    • Groupes, rôles et stratégies RBAC

    La fonctionnalité Analytics comprend :

    • Configuration Appflow® par vserver à partir des instances ADC.

    • Configuration Appflow par périphérique SDWAN.

    Remarque :

    • La fonctionnalité de gestion et de 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 verrez que les options StyleBooks, Pooled Licensing et All.

    • Lorsque vous migrez la licence en pool, elle migre tous les types, y compris les vservers.

  5. Pour la version ADM 13.0 76.xx, exécutez les commandes suivantes pour terminer la migration :

    1. cd /mps/scripts

    2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler ADM VM>

    Par exemple, python servicemigrationtool.py /var/secureclient.csv

  6. Pour ADM antérieur à la version 13.0 76.xx :

    1. 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.tgz

      Le fichier téléchargé comprend deux scripts de bundle, servicemigrationtool_27.py et config_collect_onprem_27.py.

    2. Enregistrez les deux scripts dans ADM sur site. Par exemple, enregistrez-les dans le répertoire /var

    3. Exécutez les commandes suivantes pour migrer :

      1. cd /var

      2. servicemigrationtool_27.py <path of ClientID/Secret File in on-premises ADM VM>

        Par exemple, python servicemigrationtool_27.py /var/secureclient.csv

Après l’exécution du script, celui-ci 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 ADM inférieure à la licence sur site.

Moins de licences sur site

Si vous sélectionnez Y, la migration se poursuit en attribuant une licence 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 ADC non prise en charge pour le serveur de licences en pool, le message suivant s’affiche :

Version ADC non prise en charge

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 compris entre quelques minutes et quelques heures. Une fois la migration terminée, le message suivant s’affiche :

Statut de migration terminée (/fr-fr/netscaler-application-delivery-management-software/media/migration-complete-status.png)

La migration est réussie une fois que toutes les instances ADC et leurs configurations respectives sont déplacées avec succès vers le service ADM. Après une migration réussie, le NetScaler® ADM 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

  • Emon planificateur

Revenir à l’ADM sur site

Si vous souhaitez revenir à l’ADM sur site, assurez-vous que les prérequis sont remplis.

Prérequis

Si votre ADM sur site (avant la migration vers le service ADM) est :

  • Utilisé comme serveur de licences en pool, assurez-vous de disposer des licences en pool requises dans l’ADM sur site.

  • Configuré avec des agents ADM sur site, 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 ADM sur site. Si vous avez apporté des modifications à ces configurations après la migration, ces modifications ne sont pas reflétées dans ADM sur site.

  • Pour les versions ADM 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 ADM 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 ADM sur site.

  1. À l’aide d’un client SSH, connectez-vous à l’ADM sur site.

  2. Tapez shell et appuyez sur Entrée pour passer en mode bash.

  3. Pour la version ADM 13.0 82.xx, exécutez les commandes suivantes pour terminer la restauration :

    1. cd /mps/scripts

    2. Python rollback_to_onprem.py <path of ClientID/Secret File in ADM on-prem VM>

      Par exemple, python rollback_to_onprem.py /var/ secureclient.csv.csv

      L’outil lance l’opération de restauration et une invite vous demande si vous souhaitez continuer. Tapez Y pour continuer.

      Rollback proceed

      Vous pouvez voir le message suivant une fois la restauration terminée.

      Rollback complete

  4. Pour ADM antérieur à la version 82.xx :

    1. 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

    2. Pour les versions ADM 79.xx et 76.xx, enregistrez le script dans /mps/scripts et exécutez les commandes suivantes pour restaurer :

      1. cd /mps/scripts

      2. python rollback_to_onprem.py < path of client/secret csv file in ADM on-prem>

        Par exemple, python rollback_to_onprem.py /var/ secureclient.csv

    3. Pour les versions ADM antérieures à 76.xx, enregistrez le script dans ADM sur site. Par exemple, enregistrez-le à l’emplacement /var et exécutez les commandes suivantes pour restaurer :

      1. cd /var

      2. python rollback_to_onprem_27.py < path of client/secret csv file in ADM 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.

Migrer NetScaler ADM sur site vers Citrix Cloud™
July 30, 2026
Contributeur: 
C C
July 30, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.