Introduction
Este documento descreve o procedimento para modificar os valores de parâmetros de fator no Conjunto de Réplicas do Cisco Policy Suite (CPS).
Prerequisites
Requirements
A Cisco recomenda que você tenha conhecimento destes tópicos:
A Cisco recomenda que você tenha acesso de raiz privilegiado à CLI do CPS.
Componentes Utilizados
As informações neste documento são baseadas nestas versões de software e hardware:
- 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. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
Informações de Apoio
Fábrica é a biblioteca de perfis de sistemas entre plataformas da Puppet. Ele descobre e relata fatos por nó, que estão disponíveis no manifesto de fantoche como variáveis. O Puppet suporta a retenção de vários valores como uma variável de ambiente. Este recurso é suportado no Puppet pelo uso de mais rapidez. No Puppet, facter é uma ferramenta independente que mantém a variável de nível de ambiente. Pode ser considerado semelhante à variável env de Bash ou Linux. Às vezes, pode haver uma sobreposição entre as informações armazenadas em fatos e a variável de ambiente da máquina. No Puppet, o par chave-valor é conhecido como "fato". Cada recurso tem seus próprios fatos e, no Puppet, o usuário tem a vantagem de criar seus próprios fatos personalizados.
O fator de comando pode ser usado para listar todas as variáveis de ambiente diferentes e seus valores associados.
A razão pela qual o fator é importante para o Puppet é que o fator e os fatos estão disponíveis em todo o código Puppet como uma variável global, o que significa que eles podem ser usados no código a qualquer momento sem qualquer outra referência.
Problema
Suponha que um script CPS use valores de parâmetro de facter para alguma finalidade, como definir um valor de limite para geração de alerta. Se você quiser ajustar os valores de limite com base na sua rede, então você deve modificar o respectivo valor de parâmetro de facter de acordo.
Considere o script CPS de exemplo /var/qps/install/20.2.0/scripts/bin/support/snmp-traps/process-traps/gen-gx-drop-trap.sh e o processamento CCR-X de mensagem Gx médio de alerta aumentou.
Como você pode ver, o script usa primeiro o valor do fator se configurado.
# If threshold configured in facter, get that value, else use default 20ms
TRAP_AVG_LEVEL=200
Portanto, aqui o script não considera a entrada fornecida como TRAP_AVG_LEVEL=200", enquanto considera o valor do fator de 20 ms.
Execute esse comando do pcrfclient para exibir os respectivos valores de parâmetros do fator.
#facter | grep ccr
gx_alarm_ccr_i_avg_threshold => 20
gx_alarm_ccr_t_avg_threshold => 20
gx_alarm_ccr_u_avg_threshold => 20
Procedimento para modificar valores de parâmetro do facter
Aqui estão as etapas para modificar os valores dos parâmetros do fator para 200ms.
1. Abordagem para CPS hospedado no OpenStack.
Etapa 1. Backup da configuração atual do fator.
Execute este comando a partir do Gerenciador de Clusters (verifique se o diretório /mnt/backup existe).
# curl -X GET http://installer:8458/api/system/config/config/ -o /mnt/backup/ facter-config_$(date +%Y-%m-%d).yaml
Etapa 2. Preparação do arquivo YAML com valores de parâmetro de limite adequados. Prepare um arquivo .yaml no ClusterManager.
# vi gx_alarm_threshold.yaml
gxAlarmCcrIAvgThreshold: "200"
gxAlarmCcrUAvgThreshold: "200"
gxAlarmCcrTAvgThreshold: "200"
Etapa 3. Execute esse comando do Gerenciador de clusters para atualizar os parâmetros de limite.
Note: Esse comando deve ser executado do mesmo diretório onde o arquivo gx_alarm_threshold.yaml é colocado. Aqui 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]
Etapa 4. Verifique a alteração nos valores dos parâmetros de limite. Execute esse comando do 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. Abordagem para CPS hospedado na VMWare.
Etapa 1. Efetue login no ClusterManager e modifique o valor do parâmetro necessário em /var/qps/config/deploy/csv/Configuration.csv. Considere estes parâmetros de exemplo aqui com um valor atual 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 ~]#
Execute esse comando e modifique o valor de parâmetros de exemplo no arquivo Configuration.csv.
[root@installer ~]#vi /var/qps/config/deploy/csv/Configuration.csv
Execute este comando para verificar se os valores foram alterados no arquivo 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 ~]#
Etapa 2. Execute esse comando para importar a nova configuração para o ClusterManager.
[root@installer ~]# /var/qps/install/current/scripts/import/import_deploy.sh
Etapa 3. Execute esse comando para verificar a alteração nos valores do facter do 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 ~]#
Etapa 4. Execute este comando para reconstruir o pacote CPS.
[root@installer ~]# /var/qps/install/current/scripts/build_all.sh
Etapa 5. Execute este comando para baixar todos os scripts Puppet, software CPS /etc/hosts e atualizar cada VM com o novo software do Cluster Manager.
[root@installer ~]# /var/qps/install/current/scripts/upgrade/reinit.sh
Etapa 6. Faça login no pcrfclient e execute esse comando para verificar as alterações nos valores do fator.
[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 ~]#
Feedback