Citrix Application Delivery Management

Migrer le pack de configuration d’un StyleBook vers un autre StyleBook

Dans Citrix Application Delivery Management (ADM), les packs de configuration sont toujours liés au StyleBook à partir duquel ils sont créés. Toute mise à jour du pack de configuration peut être effectuée uniquement via le StyleBook à lequel le pack de configuration est lié. Citrix ADM vous permet désormais de migrer un pack de configuration existant vers un nouveau StyleBook. Le nouveau StyleBook peut être une version plus originale du StyleBook actuel lié au pack de configuration. Vous pouvez également migrer le pack de configuration 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 pack de configuration CP1 à partir de ce StyleBook sur une instance Citrix ADC. Plus tard, vous avez réalisé que votre StyleBook n’inclut pas de configuration de surveillance. Donc, vous avez maintenant 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.

Vous souhaitez maintenant mettre à jour votre configuration existante qui a été créée dans le pack de configuration CP1 pour ajouter des moniteurs. Auparavant, vous deviez supprimer le pack de configuration CP1 et créer un pack de configuration 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 le pack de configuration CP1 sur une ou plusieurs instances Citrix ADC. Auparavant, vous deviez recréer un nouveau pack de configuration via le nouveau StyleBook en tapant des valeurs pour tous les paramètres.

Au lieu de cela, vous pouvez désormais migrer le pack de configuration existant CP1 vers le nouveau styleBook example-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 où le pack de configuration 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.

Migrer le pack de configuration

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

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

  2. Faites défiler l’écran vers le bas pour trouver le pack de configuration exemple-lb que vous auriez créé précédemment, puis cliquez sur Migrer Configpack.

    Image localisée

  3. La page Choisir un StyleBook cible pour la migration s’ouvre et répertorie tous les StyleBooks disponibles dans Citrix ADM. Faites défiler la page vers le bas pour trouver l’ example-lb-mon StyleBook et cliquez sur Sélectionner StyleBook . Vous pouvez également rechercher le StyleBook en tapant exemple-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 de paramètres. Certains 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’example-lb StyleBook.

    Image localisée

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

    Image localisée

    Dans ce cas, vous pouvez voir que les StyleBooks conservent les anciennes valeurs pour la configuration d’équilibrage de charge de base. 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 sur laquelle vous souhaitez exécuter la configuration. Notez que vous pouvez déployer la configuration sur plus d’un 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 d’Citrix ADC.

  7. Cliquez sur Créer pour créer ou mettre à jour la configuration des instances sélectionnées. Le pack de configuration 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 immédiatement 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 pack de configuration 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 pack de configuration vers une version antérieure 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 pack de configuration et l’ID du pack de configuration sont identiques à ceux précédents. 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-lbStyleBook 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
<!--NeedCopy-->

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
<!--NeedCopy-->
Migrer le pack de configuration d’un StyleBook vers un autre StyleBook