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

Remarque

Cette fonctionnalité est en avant-première technologique.

Le Générateur de configuration 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 configuration d’application d’une instance Citrix ADC vers une autre instance.

À l’aide de 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 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 sources suivantes :

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

  • Un ensemble de commandes CLI : Collez la configuration à partir dens.conf ouApplication 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 de l’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. En outre, il identifie les attributs de configuration qui nécessitent votre entrée. 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 StyleBooks

Une fois la migration terminée, 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 .

Vous ne pouvez sélectionner qu’une seule configuration d’application à dupliquer en même temps. Répétez le processus pour dupliquer les autres configurations d’application présentes dans la configuration source.

Fonctionnalités 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
  • Réécrire
  • Répondeur

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 d’application Citrix ADC dans Citrix ADM :

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

  2. Cliquez sur Migrer la configuration ADC.

  3. Cliquez sur Démarrer.

  4. Dans l’onglet 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 l’onglet Choisir une application, sélectionnez l’application à migrer et cliquez sur Suivant .

  8. Dans l’onglet 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 l’onglet 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 permettant de 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 avec succès, vous devez appliquer séparément les configurations manquées ou non prises en charge sur l’instance cible. Et cliquez sur Suivant.

  10. Dans l’onglet Migrer, spécifiez les détails 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 surveiller la liaison comme suit :

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

    L’erreur suivante apparaît :

     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 le groupe de services et le moniteur dans un format non valide. Ce problème est résolu à partir de Citrix ADC 12.1.52.15 build.

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