Migrer les packs de configuration d’un StyleBook vers un autre StyleBook
Dans NetScaler Application Delivery Management (ADM), les packs de configuration sont toujours liés au StyleBook à partir duquel ils ont été créés. Toute mise à jour du configpack ne peut être effectuée que via le StyleBook auquel le configpack est lié. NetScaler 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 configpack. Ou, vous pouvez également migrer le configpack vers un StyleBook complètement 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 NetScaler. Vous avez créé un pack de configuration CP1 à partir de ce StyleBook sur une instance NetScaler. 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.
Vous souhaitez maintenant mettre à jour votre configuration existante qui a été créée dans le 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 toutes les configurations créées dans le pack de configuration CP1 sur une ou plusieurs instances NetScaler. Auparavant, vous deviez recréer un nouveau configpack via le nouveau StyleBook en saisissant des valeurs pour tous les paramètres.
Au lieu de cela, vous pouvez désormais migrer le configpack CP1 existant vers le nouveau StyleBook example-lb-mon. Votre nouveau StyleBook peut configurer les détails des moniteurs. Seuls les objets de configuration liés au moniteur sont ajoutés aux instances NetScaler sur lesquelles 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 NetScaler qui n’a pas changé n’est pas affectée.
Migrer les packs de configuration
Pour migrer un pack de configuration créé à l’aide de example-lb StyleBook vers example-lb-mon StyleBook
-
Dans NetScaler ADM, accédez à Applications > Configurations. La page Configurations affiche tous les packs de configuration présents dans le système.
-
Faites défiler la page vers le bas pour trouver le pack de configuration example-lb que vous auriez créé plus tôt, puis cliquez sur Migrer le pack de configuration.
-
La page Choisir le StyleBook cible pour la migration s’ouvre et répertorie tous les StyleBooks disponibles dans NetScaler 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 example-lb-mon.
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 paramètres du nouveau StyleBook peuvent être nouveaux ou leur structure peut être modifiée. Dans ce cas, vous devez renseigner manuellement les valeurs des paramètres StyleBook. Par exemple, l’image suivante montre les paramètres de l’example-lb StyleBook.
L’image suivante montre les paramètres après la migration du configpack vers example-lb-mon StyleBook.
Dans ce cas, vous pouvez constater que les StyleBooks conservent les anciennes valeurs pour la configuration de base de l’équilibreur de charge. Toutefois, vous devez saisir manuellement les valeurs des paramètres du moniteur.
-
Saisissez les valeurs des nouveaux paramètres utilisés pour créer des moniteurs sur l’instance.
-
Sous Instances cibles, cliquez et sélectionnez l’adresse IP de l’instance NetScaler sur laquelle vous souhaitez exécuter la configuration. Notez que vous pouvez déployer la configuration sur plusieurs NetScaler, en spécifiant autant d’instances cibles que nécessaire.
-
Cliquez sur Exécuter à sec. La page Objets affiche les objets qui seraient récemment créés, modifiés ou supprimés des instances NetScaler.
-
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 NetScaler 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 NetScaler 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.
Une fois la migration réussie, le ConfigPack est lié au nouveau StyleBook.
Vous pouvez voir que le nom du configpack et l’ID du configpack sont les mêmes que précédemment. Mais NetScaler ADM met à jour le nom du StyleBook en 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 NetScaler 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-->