Citrix Application Delivery Management service

Migrer le configpack d’un StyleBook vers un autre StyleBook

Dans Citrix Application Delivery Management (ADM), les configpacks sont toujours liés au StyleBook à partir duquel ils sont créés. Toute mise à jour du configpack ne peut être effectuée que via le StyleBook auquel le configpack est lié. Citrix ADM vous permet désormais de migrer un configpack existant vers un nouveau StyleBook. Le nouveau StyleBook peut être une version plus originale du StyleBook actuel qui est lié au configpack. Vous pouvez également migrer le configpack vers un StyleBook entièrement différent.

Par exemple, vous avez créé un StyleBook appelé example-lb. Ce StyleBook est utilisé pour déployer une configuration d’équilibrage de charge de base sur une instance Citrix ADC. Vous avez créé un configpack CP1 à partir de ce StyleBook sur une instance de Citrix ADC. Plus tard, vous avez réalisé que votre StyleBook n’inclut pas de configuration de surveillance. Vous avez donc créé un StyleBook appelé example-lb-mon. Ce StyleBook a la même configuration d’équilibrage de charge que l’exemple lb StyleBook, mais il ajoute la possibilité de configurer des moniteurs.

Maintenant, vous voulez mettre à jour votre configuration existante qui a été créée dans configpack CP1 pour ajouter des moniteurs. Auparavant, vous deviez supprimer le configpack CP1 et créer un configpack CP2 à partir du nouveau StyleBook pour ajouter des moniteurs à votre configuration. La suppression de CP1 entraîne la suppression de toute la configuration créée dans configpack CP1 sur une ou plusieurs instances Citrix ADC. Auparavant, vous deviez recréer un nouveau configpack via le nouveau StyleBook en tapant des valeurs pour tous les paramètres.

Au lieu de cela, vous pouvez maintenant migrer le configpack CP1 existant vers le nouveau StyleBook exemple-lb-mon. Votre nouveau StyleBook peut configurer les détails des moniteurs. Seuls ces objets de configuration liés au moniteur sont ajoutés aux instances Citrix ADC dans lesquelles le configpack a été déployé. Vous devez fournir juste les détails du moniteur maintenant. La configuration existante déployée sur les instances Citrix ADC qui n’a pas été modifiée reste inchangée.

Migration des configpacks

Pour migrer un configpack créé à l’aide de example-lb StyleBook vers example-lb-mon StyleBook

  1. Dans Citrix ADM, accédez à Applications > Configurations. La page Configurations affiche tous les configpacks présents dans le système.

  2. Faites défiler vers le bas pour trouver le configpack example-lb que vous auriez créé précédemment, puis cliquez sur Migrate Configpack.

    image localisée

  3. La page Choisir un StyleBook cible pour la migration s’ouvre, qui répertorie tous les StyleBooks disponibles dans Citrix ADM. Faites défiler vers le bas pour trouver le StyleBook exemple-lb-mon et cliquez sur Sélectionner un StyleBook. Vous pouvez également rechercher le StyleBook en tapant example-lb-mon.

    image localisée

    Si vous migrez d’un StyleBook à un autre, tous les paramètres des deux StyleBooks peuvent ne pas avoir la même structure. Si la structure des paramètres est similaire, les valeurs précédentes sont automatiquement conservées dans les champs des paramètres. Quelques-uns des paramètres du nouveau StyleBook peuvent être nouveaux, ou il peut y avoir un changement dans leur structure. Dans ce cas, vous devez remplir manuellement les valeurs des paramètres StyleBook. Par exemple, l’image suivante montre les paramètres de l’exemple lb StyleBook.

    image localisée

    L’image suivante montre les paramètres après la migration du configpack vers example-lb-mon StyleBook.

    image localisée

    Dans ce cas, vous pouvez voir que les StyleBooks conservent les anciennes valeurs pour la configuration de base de l’équilibreur de charge. Mais, vous devez taper manuellement les valeurs des paramètres du moniteur.

  4. Saisissez les valeurs des nouveaux paramètres utilisés pour créer des moniteurs sur l’instance.

  5. Sous Instances cibles, cliquez sur et sélectionnez l’adresse IP de l’instance Citrix ADC dans laquelle vous souhaitez exécuter la configuration. Notez que vous pouvez déployer la configuration sur plusieurs Citrix ADC, en spécifiant autant d’instances cibles que nécessaire.

  6. Cliquez sur Exécuter à sec. La page Objets affiche les objets qui seraient nouvellement créés, modifiés ou supprimés de la ou des instances Citrix ADC.

  7. Cliquez sur Créer pour créer ou mettre à jour la configuration des instances sélectionnées. Le configpack est créé si les instances cibles sont nouvelles. Sinon, les configurations existantes déployées sur les instances sont mises à jour.

    Remarque

    Vous pouvez également cliquer sur l’icône d’actualisation pour ajouter des instances Citrix ADC récemment découvertes. Ces instances sont donc instantanément disponibles dans la liste des instances de cette fenêtre. L’icône d’actualisation est actuellement disponible uniquement sur Citrix ADM.

Vous pouvez également migrer un configpack d’une version d’un StyleBook vers la version suivante. Ici aussi, vous devrez peut-être taper les valeurs de tous les nouveaux paramètres requis présents dans la nouvelle version. Vous pouvez également migrer le configpack vers une ancienne version du StyleBook. Dans ce cas, les paramètres supplémentaires qui ne sont pas présents dans l’ancien StyleBook sont supprimés. La page Objets affiche tous les objets supprimés de la configuration.

Après une migration réussie, le ConfigPack est lié au nouveau StyleBook.

image localisée

Vous pouvez voir que le nom du configpack et l’ID du configpack sont les mêmes que précédemment. Mais Citrix ADM met à jour le nom de StyleBook à example-lb-mon à partir de example-lb.

Créez vos StyleBooks

Le contenu complet de example-lb StyleBook est fourni ci-dessous à titre de référence :

name: example-lb
namespace: examples.stylebooks
version: "1.0"
display-name: Basic Load Balancer App
description: This is an example StyleBook that creates a load balancer application
schema-version: "1.0"
import-stylebooks:
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
parameters-default-sources:
  - stlb::lb
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters

Le contenu complet de example-lb-mon StyleBook est fourni ci-dessous à titre de référence :

name: example-lb-mon
namespace: examples.stylebooks
version: "1.0"
description: This is an example StyleBook that creates a load balancer application with monitors
display-name: Basic Load Balancer App with Monitors
schema-version: "1.0"
import-stylebooks:
  -
    namespace: netscaler.nitro.config
    prefix: ns
    version: "10.5"
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
  -
    namespace: com.citrix.adc.commontypes
    prefix: cmtypes
    version: "1.0"
parameters-default-sources:
  - stlb::lb
parameters:
  -
    name: monitors
    label: "List of Monitors"
    description: "List of Monitors to monitor Application Servers"
    type: cmtypes::monitor[]
substitutions:
  mon-name(appname, monname): $appname + "-mon-" + $monname
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters
  -
    name: monitors-comp
    type: cmtypes::monitor
    condition: $parameters.monitors
    repeat: $parameters.monitors
    repeat-item: mon
    repeat-index: ndx
    description: Builds a list of Citrix ADC monitor objects and binds them to the servicegroup of this LB config
    properties-default-sources:
      - $mon
    properties:
        monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
    components:
      -
        name: monitor-svcg-binding-comp
        condition:  $parameters.svc-servers
        type: ns::servicegroup_lbmonitor_binding
        properties:
          servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
          monitor_name: $parent.properties.monitorname

Migrer le configpack d’un StyleBook vers un autre StyleBook