Citrix Application Delivery Management service

Migrer la configuration de l’application Citrix ADC à l’aide de StyleBooks Configuration Builder

Remarque

Cette fonctionnalité est en aperçu technique.

Le Générateur de configuration de StyleBooks permet de créer un StyleBook de configuration d’application à partir d’une configuration Citrix ADC existante. Cette fonctionnalité automatise également la migration de la configuration de l’application d’une instance Citrix ADC vers une autre instance.

Grâce à Configuration Builder, vous pouvez simplifier la création d’un StyleBook personnalisé. Cette fonctionnalité vous permet de créer un StyleBook sans connaissance approfondie de la grammaire et des constructions StyleBooks. Sinon, la connaissance de la grammaire et des constructions de StyleBooks est nécessaire pour créer un StyleBook.

Le Générateur de configuration crée également un ConfigPack qui reflète la même configuration ADC sur une nouvelle instance ADC. Avec ce ConfigPack, la configuration ADC initiale d’une instance ADC peut être dupliquée vers une autre instance ADC. La source de configuration initiale peut être l’une des suivantes :

  • Une instance Citrix ADC : spécifiez l’instance dans laquelle la configuration de l’application que vous souhaitez dupliquer est hébergée.

    Le Générateur de configuration convertit la configuration ADC en StyleBook et ConfigPack même si vous ne spécifiez pas l’instance cible. Vous pouvez ensuite utiliser ce configpack pour migrer la configuration ADC vers d’autres instances ADC.

  • Un ensemble de commandes CLI : Collez la configuration à partir de ns.conf ou Application config.

Le Générateur de configuration identifie la liste des applications distinctes incorporées dans la configuration source. Lorsque vous sélectionnez la configuration d’application qui vous intéresse, Configuration Builder extrait l’ensemble des commandes CLI de l’application sélectionnée. Ces commandes CLI sont extraites de la configuration source. Il identifie également les attributs de déploiement et de configuration qui peuvent nécessiter votre entrée.

  • Attributs de déploiement  : vous pouvez afficher et modifier l’adresse IP et le port des serveurs virtuels, des services et des membres du groupe de services à partir de la configuration d’origine.

  • Attributs de configuration - Ces attributs peuvent être des mots de passe ou des certificats spécifiés dans la configuration source.

Après avoir spécifié les informations nécessaires, commencez à migrer ou à dupliquer la configuration de l’application sur une instance ADC cible.

Workflow du Générateur de configuration de StyleBooks

Une fois que vous avez terminé la création et la migration de l’application, un ConfigPack est créé dans Citrix ADM avec son StyleBook correspondant. Ce ConfigPack représente la configuration de l’application sur l’instance ADC cible. Pour afficher le ConfigPack créé, accédez à Applications > StyleBooks > Configurations.

Fonctionnalités de Citrix ADC prises en charge

StyleBook Configuration Builder reconnaît et prend en charge les fonctionnalités Citrix ADC suivantes dans la configuration source :

  • Commutation de contenu
  • Équilibrage de charge
  • Surveillance
  • Déchargement SSL
  • Limitation du taux
  • Réécrire
  • Répondeur
  • Pare-feu d’application Web (WAF)

Créer un StyleBook pour migrer la configuration de l’application Citrix ADC

La procédure suivante consiste à créer un StyleBook qui migre la migration de l’application Citrix ADC dans Citrix ADM :

  1. Accédez à Applications > StyleBooks > Configurations.

  2. Cliquez sur Migration de la configuration ADC.

  3. Cliquez sur Démarrer.

  4. Dans Spécifier la configuration, sélectionnez la source de configuration :

    • Importer à partir d’un ADC : cette option détecte les applications actives sur l’instance ADC sélectionnée.

    • Importer à l’aide des commandesCLI : Cette option analyse les commandes CLI et extrait les applications des commandes CLI.

  5. Spécifiez l’instance ADC source à partir de laquelle vous souhaitez migrer ou dupliquer la configuration de l’application.

  6. Spécifiez l’instance ADC cible vers laquelle vous souhaitez migrer ou dupliquer la configuration de l’application.

  7. Dans Définir une application,

    1. Dans Nom de l’application, spécifiez le nom de l’application.

    2. Sélectionnez les serveurs virtuels à migrer.

    3. Cliquez sur Suivant.

  8. Dans Commandes CLI équivalentes, passez en revue les commandes et cliquez sur Suivant.

    Ces commandes sont spécifiques à la configuration de l’application sélectionnée.

  9. Dans Attributs de déploiement, vous pouvez afficher et modifier l’adresse IP et le port des serveurs virtuels, des services et des membres du groupe de services.

    Pour modifier l’adresse IP et le port, cliquez sur l’icône de modification sur le serveur virtuel, le service ou le membre du groupe de services dans le diagramme de flux.

    Modifier les attributs de déploiement

    Cet onglet n’apparaît que dans les cas suivants :

    • Les instances source et cible sont différentes.
    • Importez des configurations à l’aide des commandes CLI.
  10. Dans Attributs de configuration, spécifiez les détails nécessaires et cliquez sur Suivant.

    Cet onglet répertorie les secrets tels que les clés pour déchiffrer les mots de passe et les certificats.

    Remarque

    Avant de commencer la migration, les configurations manquées ou non prises en charge sont affichées dans l’un des onglets suivants : Configurations

    non prises en charge Configurations**globales

    non prises en charge

    Pour migrer ces configurations, vous devez appliquer les configurations manquantes ou non prises en charge séparément sur l’instance cible. Et, cliquez sur **Suivant.

  11. Dans Migration, spécifiez les détails du StyleBook requis. Cliquez sur Migrate.

Limitations

  • Les expressions nommées et responderhtmlpages mentionnées dans l’instance source ne sont pas identifiées. Assurez-vous de configurer les expressions nommées et responderhtmlpages sur l’instance cible avant la migration.

  • Si la source a une configuration pour servicegroup et surveille la liaison comme suit :

    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>

    L’erreur suivante s’affiche :

     CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
    

    Cette erreur se produit car Citrix ADC enregistre la liaison entre Service Group et Monitor dans un format non valide. Ce problème est résolu à partir de la version 12.1.52.15 de Citrix ADC.

Migrer la configuration de l’application Citrix ADC à l’aide de StyleBooks Configuration Builder