Introduzione
Questo documento descrive la procedura per aggiungere, eliminare o modificare le voci /ETC/HOSTS in un Cisco Policy Suite (CPS).
Prerequisiti
Requisiti
Cisco raccomanda la conoscenza dei seguenti argomenti:
Nota: Cisco consiglia di disporre del privilegio di accesso root alla CLI di CPS.
Componenti usati
Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:
- CPS 20.2
- MongoDB v3.6.17
- Unified Computing System (UCS)-B
Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.
Premesse
Per inviare il traffico di rete a un host, è necessario conoscere l'indirizzo IP numerico dell'host. Tradizionalmente, l'indirizzo IP viene scritto come xxx.xxx.xxx.xxx, dove ciascun xxx rappresenta un valore compreso tra 0 e 255 per un indirizzo di rete IPv4. I computer richiedono questi indirizzi, ma gli esseri umani trovano difficile ricordare i valori numerici. Su un sistema Linux, questi nomi leggibili vengono convertiti nei loro equivalenti IP numerici dalla Libreria del resolver, contenuta nei file libresolve.so forniti come parte del pacchetto glibc RPM. I programmi che devono cercare l'indirizzo IP numerico per un problema di nome chiamano questa libreria.
I nomi degli host e i relativi indirizzi IP sono disponibili in diverse posizioni. Uno di questi è il file /ETC/HOSTS.
Il file /ETC/HOSTS contiene i nomi e gli indirizzi degli host IP per l'host locale e altri host della rete Internet. Questo file viene utilizzato per risolvere un nome in un indirizzo, ovvero per tradurre un nome host nel relativo indirizzo 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
Ogni volta che è necessario aggiungere, eliminare o aggiornare le informazioni degli host locali o dei peer in CPS, è necessario aggiungere, eliminare o modificare i relativi dettagli host in /ETC/HOSTS.
Procedura per aggiungere, eliminare o modificare le voci /ETC/HOSTS
1. Approccio per CPS ospitato in OpenStack.
Passaggio 1. Backup di /ETC/HOSTS e altri file.
Eseguire i seguenti comandi da Gestione cluster:
# 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
Passaggio 2. Verificare lo stato del sistema.
Eseguire questo comando da Gestione cluster:
#curl -s http://installer:8458/api/system
Expected Output:
{"state":"deployed"}
Passaggio 3. Backup della configurazione corrente degli host aggiuntivi.
Eseguire questo comando da Gestione cluster:
$ curl -k -X GET http://installer:8458/api/system/config/additional-hosts > /var/tmp/additional_hosts_$(date +%Y-%m-%d).yaml
Passaggio 4. Preparazione del file yaml con i dettagli host aggiuntivi richiesti.
Eseguire questo comando da Gestione cluster:
# cp /var/tmp/additional_hosts_$(date +%Y-%m-%d).yaml /var/tmp/additional_hosts_new.yaml
Aggiungere, eliminare o modificare la voce in additional_hosts_new.yaml.
Ad esempio:
$ 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"
Passaggio 5. Eseguire il comando PUT API call da Gestione cluster per aggiungere i dettagli degli host richiesti in /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"
Nota: Questo comando deve essere eseguito dalla stessa directory in cui è posizionato il file additional_hosts_new.yaml.
Passaggio 6. Verifica dei dettagli dell'host in glibc /ETC/HOSTS.
Eseguire questo comando da macchine virtuali di bilanciamento del carico (VM) e verificare i dettagli dell'host.
#cat /etc/hosts
Passaggio 7. Riavviare tutti i processi Qns su entrambi i LB.
Eseguire questo comando per riavviare il processo Qns LB.
Command Syntax:
#monit stop {Process Name}
#monit start {Process name}
Command example:
#monit stop qns-1
#monit start qns-1
2. Approccio per CPS ospitato in VMware.
Passaggio 1. Accedere a Cluster Manager e aggiungere, eliminare o modificare i dettagli dell'host locale in /var/qps/config/deploy/csv/Hosts.csv e i dettagli peer in /var/qps/config/deploy/csv/AdditionalHosts.csv rispettivamente in base al requisito.
Eseguire questo comando per aggiungere, eliminare o modificare i dettagli dell'host locale nel file Hosts.csv.
#vi /var/qps/config/deploy/csv/Hosts.csv.
Eseguire questo comando per aggiungere, eliminare o modificare i dettagli dei peer nel file AdditionalHosts.csv.
#vi /var/qps/config/deploy/csv/AdditionalHosts.csv.
Passaggio 2. Eseguire questo comando per importare la nuova configurazione in Gestione cluster.
#/var/qps/install/current/scripts/import/import_deploy.sh
Passaggio 3. Eseguire questo comando per verificare la modifica in Cluster Manager /ETC/HOSTS.
#cat /etc/hosts
Passaggio 4. Eseguire questo comando da Gestione cluster per ricompilare il pacchetto CPS.
[root@installer ~]# /var/qps/install/current/scripts/build_all.sh
Passaggio 5. Eseguire questo comando per scaricare tutti gli script Puppet, il software CPS, i file /ETC/HOSTS e aggiornare ciascuna VM con il nuovo software da Cluster Manager.
[root@installer ~]# /var/qps/install/current/scripts/upgrade/reinit.sh
Passaggio 6. Eseguire questo comando per verificare la modifica in LB/ETC/HOSTS.
#cat /etc/hosts
Passaggio 7. Riavviare tutti i processi Qns su entrambi i LB.
Eseguire questo comando per riavviare il processo Qns LB.
Command Syntax:
#monit stop {Process Name}
#monit start {Process name}
Command exampls:
#monit stop qns-1
#monit start qns-1
Feedback