Introduction
Este documento descreve o procedimento para adicionar, excluir ou modificar entradas /ETC/HOSTS em um Cisco Policy Suite (CPS).
Prerequisites
Requirements
A Cisco recomenda que você tenha conhecimento destes tópicos:
Note: 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
- Unified Computing System (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
Para enviar tráfego de rede a um host, o endereço IP numérico desse host deve ser conhecido. Tradicionalmente, o endereço IP é escrito como xxx.xxx.xxx.xxx, onde cada xxx representa um valor de 0 a 255, para um endereço de rede IPv4. Os computadores exigem esses endereços, mas os humanos acham difícil lembrar dos valores numéricos. Em um sistema Linux, esses nomes legíveis são convertidos em seus equivalentes IP numéricos pela Biblioteca de Resolvedores, contidos nos arquivos libresolve.so que são fornecidos como parte do pacote RPM de glibc. Os programas que precisam pesquisar o endereço IP numérico para uma chamada de problema de nome para esta biblioteca.
Os nomes de hosts e seus endereços IP podem ser encontrados em vários lugares. Um deles é o arquivo /ETC/HOSTS.
O arquivo /ETC/HOSTS contém os nomes e endereços IP do host local e de outros hosts na rede de Internet. Esse arquivo é usado para resolver um nome em um endereço (ou seja, para converter um nome de host em seu endereço de Internet).
[root@installer ~]# cat /etc/hosts
127.0.0.1 localhost
#BEGIN_QPS_LOCAL_HOSTS
xxx.xxx.xxx.xxx lb01 dc1-lb01
xxx.xxx.xxx.xxx lb02 dc1-lb02
xxx.xxx.xxx.xxx sessionmgr01 dc1-sessionmgr01
xxx.xxx.xxx.xxx sessionmgr02 dc1-sessionmgr02
xxx.xxx.xxx.xxx qns01 dc1-qns01
xxx.xxx.xxx.xxx qns02 dc1-qns02
xxx.xxx.xxx.xxx pcrfclient01 dc1-pcrfclient01
xxx.xxx.xxx.xxx pcrfclient02 dc1-pcrfclient02
#END_QPS_LOCAL_HOSTS
#BEGIN_QPS_OTHER_HOSTS
xxx.xxx.xxx.xxx ntp-primary ntp
xxx.xxx.xxx.xxx ntp-secondary btp
xxx.xxx.xxx.xxx lbvip01 lbvip01
xxx.xxx.xxx.xxx lbvip02 lbvip02
xxx.xxx.xxx.xxx arbitervip arbitervip
#END_QPS_OTHER_HOSTS
xxx.xxx.xxx.xxx installer
[root@installer ~]#
Problema
Sempre que houver um requisito para adicionar, excluir ou atualizar hosts locais ou informações de colegas para o CPS, seus detalhes de host devem ser adicionados, excluídos ou modificados em /ETC/HOSTS.
Procedimento para adicionar, excluir ou modificar entradas /ETC/HOSTS
1. Abordagem para CPS hospedado no OpenStack.
Etapa 1. Backup de /ETC/HOSTS e outros arquivos.
Execute estes comandos a partir do Cluster Manager:
# cp /etc/hosts /var/tmp/hosts_bkp_$(date +%Y-%m-%d)
# cp /var/qps/config/deploy/json/AdditionalHosts.js /var/tmp/AdditionalHosts.js_bkp
# cp /qsb_config/features/system/system.json /var/tmp/system.json_bkp
Etapa 2. Verifique o status do sistema.
Execute este comando a partir do Gerenciador de Cluster:
#curl -s http://installer:8458/api/system
Expected Output:
{"state":"deployed"}
Etapa 3. Backup da configuração de hosts adicionais atual.
Execute este comando a partir do Gerenciador de Cluster:
$ curl -k -X GET http://installer:8458/api/system/config/additional-hosts > /var/tmp/additional_hosts_$(date +%Y-%m-%d).yaml
Etapa 4. Preparação do arquivo yaml com detalhes adicionais de hosts necessários.
Execute este comando a partir do Gerenciador de Cluster:
# cp /var/tmp/additional_hosts_$(date +%Y-%m-%d).yaml /var/tmp/additional_hosts_new.yaml
Adicione, exclua ou modifique a entrada em adicional_hosts_new.yaml.
Por exemplo:
$ vi /var/tmp/additional_hosts_new.yaml
---
- name: "ntp-primary"
ipAddress: "xxx.xxx.xxx.xxx"
alias: "ntp-primary"
- name: "ntp-secondary"
ipAddress: "xxx.xxx.xxx.xxx"
alias: "ntp-secondary"
- name: "corporate_nms_ip"
ipAddress: "xxx.xxx.xxx.xxx"
alias: "corporate_nms_ip"
- name: "corporate_syslog_ip"
ipAddress: "xxx.xxx.xxx.xxx"
alias: "corporate_syslog_ip"
Etapa 5. Execute o comando PUT API call a partir do Cluster Manager para adicionar os detalhes de hosts necessários em /ETC/HOSTS.
curl -i -X PUT http://installer:8458/api/system/config/additional-hosts -H "Content-Type: application/yaml" --data-binary "@additional_hosts_new.yaml"
Note: Este comando deve ser executado do mesmo diretório onde é colocado o arquivo adicional_hosts_new.yaml.
Etapa 6. Verificação dos detalhes do host na glibc /ETC/HOSTS.
Execute este comando em VMs (Virtual Machines, Máquinas Virtuais de Balanceamento de Carga) e verifique os detalhes do host.
#cat /etc/hosts
Passo 7. Reinicie todos os processos do Qns em ambos os LBs.
Execute este comando para reiniciar o processo LB Qns.
Command Syntax:
#monit stop {Process Name}
#monit start {Process name}
Command example:
#monit stop qns-1
#monit start qns-1
2. Abordagem para CPS hospedado no VMware.
Etapa 1. Faça login no Cluster Manager e adicione, exclua ou modifique os detalhes do host local em /var/qps/config/deploy/csv/Hosts.csv e os detalhes do peer em /var/qps/config/deploy/csv/AdditionalHosts.csv, respectivamente, de acordo com o requisito.
Execute este comando para adicionar, excluir ou modificar detalhes do host local no arquivo Hosts.csv.
#vi /var/qps/config/deploy/csv/Hosts.csv.
Execute este comando para adicionar, excluir ou modificar detalhes do peer no arquivo AdditionalHosts.csv.
#vi /var/qps/config/deploy/csv/AdditionalHosts.csv.
Etapa 2. Execute esse comando para importar a nova configuração para o Gerenciador de clusters.
#/var/qps/install/current/scripts/import/import_deploy.sh
Etapa 3. Execute este comando para verificar a alteração no Cluster Manager /ETC/HOSTS.
#cat /etc/hosts
Etapa 4. Execute esse comando do Gerenciador de clusters para recriar 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. Execute este comando para verificar a alteração em LB /ETC/HOSTS.
#cat /etc/hosts
Passo 7. Reinicie todos os processos do Qns em ambos os LBs.
Execute este comando para reiniciar o processo LB Qns.
Command Syntax:
#monit stop {Process Name}
#monit start {Process name}
Command exampls:
#monit stop qns-1
#monit start qns-1
Feedback