Introduction
Ce document décrit la procédure à suivre pour modifier les valeurs des paramètres de facteur dans le jeu de réplicas Cisco Policy Suite (CPS).
Conditions préalables
Conditions requises
Cisco vous recommande de prendre connaissance des rubriques suivantes :
Cisco vous recommande de disposer d'un privilège d'accès racine à l'interface de ligne de commande CPS.
Composants utilisés
Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :
- CPS 20.2
- MongoDB v3.6.17
- UCS-B
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Informations générales
Facter est la bibliothèque de profils système multiplateforme de Puppet. Il détecte et rapporte les faits par noeud, qui sont disponibles dans votre manifeste de marionnette sous forme de variables. La marionnette prend en charge la rétention de plusieurs valeurs en tant que variable d'environnement. Cette fonctionnalité est prise en charge dans Puppet par l'utilisation de plus rapide. Dans Puppet, facter est un outil autonome qui contient la variable de niveau d'environnement. Il peut être considéré comme similaire à la variable env de Bash ou Linux. Parfois, il peut y avoir un chevauchement entre les informations stockées dans les faits et la variable d'environnement de la machine. Dans Puppet, la paire valeur-clé est appelée ” de faits “. Chaque ressource a ses propres faits et dans Puppet, l'utilisateur a l'avantage de construire ses propres faits personnalisés.
Le facteur de commande peut être utilisé pour répertorier toutes les variables d'environnement différentes et leurs valeurs associées.
La raison pour laquelle facter est important pour Puppet est que facter et faits sont disponibles dans tout le code de Puppet comme une variable globale, ce qui signifie qu'ils peuvent être utilisés dans le code à tout moment sans autre référence.
Problème
Supposons qu'un script CPS utilise des valeurs de paramètre facter à des fins telles que la définition d'une valeur de seuil pour la génération d'alertes. Si vous voulez affiner les valeurs de seuil en fonction de votre réseau, vous devez modifier la valeur de paramètre facter correspondante en conséquence.
Prenons l'exemple de script CPS /var/qps/install/20.2.0/scripts/bin/support/snmp-traps/process-traps/gen-gx-drop-trap.sh et le traitement CCR-X moyen des messages Gx d'alerte a augmenté.
Comme vous pouvez le voir, le script utilise la valeur facter au début s'il est configuré.
# If threshold configured in facter, get that value, else use default 20ms
TRAP_AVG_LEVEL=200
Ainsi, ici, le script ne considère pas l'entrée fournie comme TRAP_AVG_LEVEL=200 », alors qu'il prend en compte la valeur facter de 20 ms.
Exécutez cette commande à partir de pcrfclient pour afficher les valeurs des paramètres de facteur respectifs.
#facter | grep ccr
gx_alarm_ccr_i_avg_threshold => 20
gx_alarm_ccr_t_avg_threshold => 20
gx_alarm_ccr_u_avg_threshold => 20
Procédure de modification des valeurs de paramètre de facteur
Voici les étapes à suivre pour modifier les valeurs des paramètres facter à 200 ms.
1. Approche pour CPS hébergée dans OpenStack.
Étape 1. Sauvegarde de la configuration actuelle des facteurs.
Exécutez cette commande à partir du Gestionnaire de cluster (assurez-vous que le répertoire /mnt/backup existe).
# curl -X GET http://installer:8458/api/system/config/config/ -o /mnt/backup/ facter-config_$(date +%Y-%m-%d).yaml
Étape 2. Préparation du fichier YAML avec les valeurs de paramètre de seuil appropriées. Préparez un fichier .yaml dans ClusterManager.
# vi gx_alarm_threshold.yaml
gxAlarmCcrIAvgThreshold: "200"
gxAlarmCcrUAvgThreshold: "200"
gxAlarmCcrTAvgThreshold: "200"
Étape 3. Exécutez cette commande à partir du Gestionnaire de cluster pour mettre à jour les paramètres de seuil.
Note: Cette commande doit être exécutée à partir du même répertoire où le fichier gx_alarm_threshold.yaml est placé. Ici c'est /tmp.
[root@installer tmp]# curl -i -X PATCH http://installer:8458/api/system/config/config -H "Content-Type: application/yaml" --data-binary "@gx_alarm_threshold.yaml"
HTTP/1.1 200 OK
Date: Fri, 21 Jan 2022 06:45:20 GMT
Content-Length: 0
[root@installer tmp]
Étape 4. Vérifiez la modification des valeurs des paramètres de seuil. Exécutez cette commande à partir de pcrfclient.
#facter | grep ccr
Expected Output:
gx_alarm_ccr_i_avg_threshold => 200
gx_alarm_ccr_t_avg_threshold => 200
gx_alarm_ccr_u_avg_threshold => 200
2. Approche pour CPS hébergé dans VMWare.
Étape 1. Connectez-vous à ClusterManager et modifiez la valeur du paramètre nécessaire dans /var/qps/config/deploy/csv/Configuration.csv. Considérez ces exemples de paramètres ici avec une valeur actuelle de 20.
[root@installer ~]# cat /var/qps/config/deploy/csv/Configuration.csv | grep ccr
gx_alarm_ccr_i_avg_threshold,20,
gx_alarm_ccr_t_avg_threshold,20,
gx_alarm_ccr_u_avg_threshold,20,
[root@installer ~]#
Exécutez cette commande et modifiez la valeur d'exemples de paramètres dans le fichier Configuration.csv.
[root@installer ~]#vi /var/qps/config/deploy/csv/Configuration.csv
Exécutez cette commande pour vérifier si les valeurs sont modifiées dans le fichier Configuration.csv.
[root@installer ~]# cat /var/qps/config/deploy/csv/Configuration.csv|grep ccr
gx_alarm_ccr_i_avg_threshold,200,
gx_alarm_ccr_t_avg_threshold,200,
gx_alarm_ccr_u_avg_threshold,200,
[root@installer ~]#
Étape 2. Exécutez cette commande pour importer la nouvelle configuration dans ClusterManager.
[root@installer ~]# /var/qps/install/current/scripts/import/import_deploy.sh
Étape 3. Exécutez cette commande pour vérifier la modification des valeurs de facteur ClustManager.
[root@installer ~]# facter | grep -i ccr
gx_alarm_ccr_i_avg_threshold => 200
gx_alarm_ccr_t_avg_threshold => 200
gx_alarm_ccr_u_avg_threshold => 200
[root@installer ~]#
Étape 4. Exécutez cette commande pour reconstruire le package CPS.
[root@installer ~]# /var/qps/install/current/scripts/build_all.sh
Étape 5. Exécutez cette commande pour télécharger tous les scripts de marionnettes, le logiciel CPS /etc/hosts et mettre à jour chaque machine virtuelle avec le nouveau logiciel du Gestionnaire de clusters.
[root@installer ~]# /var/qps/install/current/scripts/upgrade/reinit.sh
Étape 6. Connectez-vous à pcrfclient et exécutez cette commande pour vérifier les modifications apportées aux valeurs de facteur.
[root@dc1-pcrfclient01 ~]# facter | grep ccr
gx_alarm_ccr_i_avg_threshold => 200
gx_alarm_ccr_t_avg_threshold => 200
gx_alarm_ccr_u_avg_threshold => 200
[root@dc1-pcrfclient01 ~]#