Migrer les packs de configuration d’un StyleBook vers un autre StyleBook
Dans NetScaler Console, les packs de configuration sont toujours liés au StyleBook à partir duquel ils sont créés. Toute mise à jour du pack de configuration ne peut être effectuée qu’à l’aide du StyleBook auquel il est lié. NetScaler Console 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 auquel le pack de configuration est lié. Ou bien, vous pouvez également migrer le pack de configuration vers un StyleBook entièrement différent.
Par exemple, vous avez créé un StyleBook nommé example-lb. Ce StyleBook est utilisé pour déployer une configuration d’équilibreur 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’incluait pas de configuration de surveillance. Vous avez donc créé un StyleBook nommé example-lb-mon. Ce StyleBook possède la même configuration d’équilibreur de charge que le StyleBook example-lb, mais ajoute la possibilité de configurer des moniteurs.
Vous souhaitez maintenant mettre à jour votre configuration existante, 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 toutes les configurations créées dans le pack de configuration CP1 sur une ou plusieurs instances NetScaler. Auparavant, vous deviez recréer un nouveau pack de configuration via le nouveau StyleBook en saisissant les valeurs de tous les paramètres.
Au lieu de cela, vous pouvez désormais migrer le pack de configuration 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 aux moniteurs sont ajoutés aux instances NetScaler où le pack de configuration a été déployé. Vous devez maintenant fournir uniquement les détails du moniteur. La configuration existante déployée sur les instances NetScaler qui n’a pas été modifiée reste inchangée.
Migrer les packs de configuration
Pour migrer un pack de configuration créé à l’aide du StyleBook example-lb vers le StyleBook example-lb-mon
-
Dans NetScaler Console, accédez à Applications > Configurations. La page Configurations affiche tous les packs de configuration présents dans le système.
-
Faites défiler vers le bas pour trouver le pack de configuration example-lb que vous auriez créé précédemment, 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 Console. Faites défiler vers le bas pour trouver le StyleBook example-lb-mon et cliquez sur Sélectionner le 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 des paramètres du nouveau StyleBook peuvent être nouveaux, ou leur structure peut avoir changé. Dans un tel cas, vous devez saisir manuellement les valeurs des paramètres du StyleBook. Par exemple, l’image suivante montre les paramètres du StyleBook example-lb.
L’image suivante montre les paramètres après la migration du pack de configuration vers le StyleBook example-lb-mon.
Dans ce cas, vous pouvez constater que les StyleBooks conservent les anciennes valeurs pour la configuration de l’équilibreur de charge de base. Cependant, 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écution à blanc. La page Objets affiche les objets qui seraient nouvellement créés, modifiés ou supprimés de la ou des instances NetScaler.
-
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 les instances NetScaler récemment découvertes. Ces instances sont alors instantanément disponibles dans la liste des instances de cette fenêtre. L’icône d’actualisation n’est actuellement disponible que sur NetScaler Console.
Vous pouvez également migrer un pack de configuration d’une version d’un StyleBook à la version suivante. Ici aussi, vous devrez peut-être saisir 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 plus ancienne 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 qui sont supprimés de la configuration.
Après une migration réussie, le pack de configuration est lié au nouveau StyleBook.
Vous pouvez constater que le nom du pack de configuration et l’ID du pack de configuration sont les mêmes qu’auparavant. Mais NetScaler Console met à jour le nom du StyleBook de example-lb à example-lb-mon.
Créez vos StyleBooks
Le contenu complet du StyleBook example-lb est fourni ci-dessous pour votre 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 du StyleBook example-lb-mon est fourni ci-dessous pour votre 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-->