Application Delivery Management

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 est utilisé pour créer une configuration d’application StyleBook à 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.

À 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 connaissances approfondies de la grammaire et des constructions de 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 sur 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 intégrées dans la configuration source. Lorsque vous sélectionnez la configuration d’application qui vous intéresse, le Générateur de configuration extrait l’ensemble des commandes CLI pour 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

Le générateur de configuration StyleBook 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 de débit
  • Réécriture
  • Répondeur
  • Pare-feu pour applications Web (WAF)

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

La procédure suivante permet de 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 Migrer la configuration ADC.

  3. Cliquez sur Commencer.

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

    • Importer depuis un ADC : Cette option permet de découvrir les applications actives sur l’instance ADC sélectionnée.

    • Importer à l’aide des commandes CLI : Cette option analyse les commandes de la CLI et extrait les applications des commandes de la 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 Modifier sur le serveur virtuel, le service ou le membre du groupe de services dans l’organigramme.

    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 réussir la migration de 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 Migrate, 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 dispose d’une configuration pour servicegroup et d’une liaison de surveillance 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" }]
     <!--NeedCopy-->
    

    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