Guida per l'utente del server Cisco Software Manager

Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
U.S.A.
http://www.cisco.com
Telefono: 408 526-4000
800 553-RETI (6387)
Fax: 408 527-0883

Prefazione

Nota

Questo prodotto ha raggiunto lo stato di fine vita. Per ulteriori informazioni, vedere il Avvisi di fine vita e di fine vendita

Questa guida descrive come installare un server Cisco Software Manager (CSM).

Pubblico, a pagina iii
Modifiche al presente documento, a pagina iii
Come ottenere la documentazione e inviare una richiesta di servizio, a pagina iii

Pubblico

Questa guida è rivolta ai responsabili dell'installazione del server Cisco Software Manager 4.0 e agli amministratori di sistema dei router Cisco.

Questa pubblicazione presuppone che il lettore abbia una conoscenza approfondita dell'installazione e della configurazione di hardware basato su router e switch. Il lettore deve inoltre avere familiarità con i circuiti elettronici e le pratiche di cablaggio ed essere esperto come tecnico elettronico o elettromeccanico.

Modifiche a questo documento

Questa tabella elenca le modifiche tecniche apportate a questo documento da quando è stato sviluppato per la prima volta.

Tabella 1: Modifiche al presente documento

Data	Riepilogo
Aprile 2020	Versione iniziale di questo documento.

Ottenere la documentazione e inviare una richiesta di servizio

Per i seguenti scopi, vedere Novità nella documentazione del prodotto Cisco all'indirizzo: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

Ottenere informazioni su come ottenere la documentazione utilizzando Cisco Bug Search Tool (BST)

Invio di una richiesta di servizio
Raccolta di informazioni aggiuntive

Iscriviti alle novità nella documentazione del prodotto Cisco. Questo documento elenca tutta la documentazione tecnica Cisco nuova e rivista come feed RSS e fornisce i contenuti direttamente sul desktop utilizzando un'applicazione di lettura. I feed RSS sono un servizio gratuito e Cisco attualmente supporta la versione RSS 2.0.

CAPITOLO "1

Informazioni sul server Cisco Software Manager

Questo capitolo fornisce una panoramicaview del server Cisco Software Manager. Questo capitolo elenca anche le restrizioni alla sua installazione.

Introduzione, a pagina 1
Restrizioni, a pagina 2

Introduzione

Il server Cisco Software Manager (CSM) è un file webstrumento di automazione basato su. Ti aiuta a gestire e simultaneamente
pianificare gli aggiornamenti di manutenzione del software (SMU) e i service pack (SP) su più router. Fornisce consigli che riducono lo sforzo richiesto per la ricerca, l'identificazione e l'analisi manuale delle SMU e degli SP necessari per un dispositivo. Una SMU è una correzione per un bug. Un SP è una raccolta di SMU raggruppate in una sola file.

Per fornire i consigli, è necessario connettere il server CSM tramite Internet al dominio cisco.com. CSM è progettato per connettere più dispositivi e fornisce la gestione di SMU e SP per più piattaforme e versioni Cisco IOS XR.

Le piattaforme supportate su CSM sono:

IOS XR (ASR 9000, CRS)
IOS XR 64 bit (ASR 9000-X64, NCS 1000, NCS 4000, NCS 5000, NCS 5500, NCS 6000)
IOS XE (ASR902, ASR903, ASR904, ASR907, ASR920)
iOS (ASR901)

Dalla versione 4.0 in poi sono molteplici i contenitori Docker che costituiscono l'architettura CSM. Questi contenitori sono:

CSM
Banca dati
Supervisore

Installare il server CSM tramite Docker è semplice. È possibile eseguire l'aggiornamento alla versione più recente del server CSM facendo clic su un pulsante di aggiornamento sulla home page del server CSM

Restrizioni

Per quanto riguarda l'installazione del server CSM valgono le seguenti limitazioni:

Questa guida all'installazione non è applicabile ad alcuna versione del server CSM precedente alla versione 4.0.
Il server CSM dovrebbe essere in grado di connettersi a Cisco.com per ricevere notifiche sugli ultimi aggiornamenti disponibili.

CAPITOLO 2

Requisiti di preinstallazione

Questo capitolo fornisce informazioni sull'hardware e sul software necessari per installare il server CSM.

Requisiti hardware, a pagina 3
Requisiti software, a pagina 3

Requisiti hardware

I requisiti hardware minimi per installare CSM server 4.0 sono:

2 CPU
8 GB di RAM
Disco rigido da 30 GB

Nota

Per reti di grandi dimensioni si consiglia di aumentare il numero di CPU per eseguire più operazioni di installazione di rete contemporaneamente.
È possibile regolare lo spazio sul disco rigido per archiviare immagini, pacchetti e registri delle operazioni.

Requisiti software

I requisiti software per installare CSM server 4.0 sono:

distribuzione Linux systemd con Docker
Configurazione proxy Docker (facoltativo)
Firewall (facoltativo)

sistemad

Per installare il server CSM, è necessario utilizzare systemd. È una suite che fornisce gli elementi costitutivi per creare vari sistemi operativi Linux. Per ulteriori dettagli su systemd, fare riferimento a Wikipedia.

Assicurarsi di soddisfare i seguenti requisiti prima di procedere con l'installazione del server CSM 4.0:

Sono necessari i privilegi di root per installare il server CSM perché la configurazione del server CSM è archiviata in /etc/csm.json file. Il processo di installazione crea il servizio systemd per il suo avvio automatico. Per ottenere i privilegi di root, esegui lo script di installazione come utente root o come utente con accesso al programma sudo.
Assicurati di installare Docker sul sistema operativo host. Per ulteriori informazioni, vedere
https://docs.docker.com/install/. Cisco consiglia di utilizzare Ubuntu, CentOS o Red Hat Enterprise Linux come sistema operativo host che esegue CSM Server 4.0. CSM funziona sia con Docker Community Edition (CE) che con Docker Enterprise Edition (EE)

Portare

Il server CSM funziona sia con Docker Community Edition (CE) che con Docker Enterprise Edition (EE). Per ulteriori informazioni, fare riferimento alla documentazione ufficiale di Docker, https://docs.docker.com/install/overview/.

Utilizzare Docker 19.03 o versioni successive per installare il server CSM. È possibile utilizzare il comando seguente per verificare la versione del Docker:

$ versione docker
Cliente: Docker Engine – Comunità
Versione: 19.03.9
Versione API: 1.40
Vai versione: go1.13.10
Commit Git: 9d988398e7
Costruito: venerdì 15 maggio 00:25:34 2020
Sistema operativo/Arch: linux/amd64
Sperimentale: falso

Server: Docker Engine – Comunità
Motore:

Versione: 19.03.9
Versione API: 1.40 (versione minima 1.12)
Vai versione: go1.13.10
Commit Git: 9d988398e7
Costruito: venerdì 15 maggio 00:24:07 2020
Sistema operativo/Arch: linux/amd64
Sperimentale: falso
contenitore:
Versione: 1.2.13
GitCommit: 7ad184331fa3e55e52b890ea95e65ba581ae3429
esecuzione:
Versione: 1.0.0-rc10
GitCommit: dc9208a3303feef5b3839f4323d9beb36df0a9dd
docker-init:
Versione: 0.18.0
GitCommit: fec3683

Configurazione proxy Docker (facoltativo)
Se installi il server CSM dietro un proxy HTTPS, ad esample, nelle impostazioni aziendali, è necessario configurare il servizio Docker systemd file come segue:

Crea una directory drop-in systemd per il servizio Docker:
$ sudo mkdir -p /etc/systemd/system/docker.service.d
Crea un file intitolato /etc/systemd/system/docker.service.d/https-proxy.conf che aggiunge la variabile di ambiente HTTPS_PROXY. Questo file consente al demone Docker di estrarre i contenitori dal repository utilizzando il proxy HTTPS:
[Servizio] Ambiente = "HTTPS_PROXY = http://proxy.example.com:443/”
Nota
È una svista comune che la variabile di ambiente HTTPS_PROXY utilizzi lettere maiuscole e il proxy URL inizia con http:// e non https://.
Ricaricare le modifiche alla configurazione:
$ sudo systemctl daemon-reload
Riavviare la finestra mobile:
$ sudo systemctl riavvia la finestra mobile
Verifica di aver caricato la configurazione:
$ systemctl show –property=Docker dell'ambiente
Ambiente=HTTPS_PROXY=http://proxy.example.com:443/

Verificare la configurazione del Docker

Per verificare se hai installato correttamente Docker e assicurarti che sia attivo e funzionante, utilizza il seguente comando:

$ systemctl è la finestra mobile attiva
attivo

Per verificare se hai configurato correttamente il demone Docker e se Docker è in grado di estrarre le immagini dal repository ed eseguire il contenitore di test; utilizzare il seguente comando:

$ docker esegui –rm ciao-mondo
Impossibile trovare l'immagine "hello-world:latest" localmente
ultimo: Prelevando dalla biblioteca/ciao-mondo
d1725b59e92d: Estrazione completata
Digerire: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
Stato: Scaricata un'immagine più recente per hello-world:latest

Ciao da Docker!
Questo messaggio indica che l'installazione sembra funzionare correttamente.
Per generare questo messaggio, Docker ha eseguito i seguenti passaggi:

Il client Docker ha contattato il demone Docker.
Il demone Docker ha estratto l'immagine "ciao mondo" dal Docker Hub. (amd64)
Il demone Docker ha creato un nuovo contenitore da quell'immagine che esegue l'eseguibile che produce l'output che stai attualmente leggendo.
Il demone Docker ha trasmesso l'output al client Docker, che lo ha inviato al tuo terminale.

Per provare qualcosa di più ambizioso, puoi eseguire un container Ubuntu con:
$ docker esegui -it ubuntu bash

Condividi immagini, automatizza i flussi di lavoro e altro ancora con un Docker ID gratuito:
https://hub.docker.com/

Per più example e idee, visitare:
https://docs.docker.com/get-started/

Firewall (facoltativo)

Il server CSM può funzionare insieme a Firewalld. Firewalld è fornito nelle seguenti distribuzioni Linux come strumento di gestione del firewall predefinito:

RHEL 7 e versioni successive
CentOS 7 e versioni successive
Fedora 18 e versioni successive
SUSE 15 e versioni successive
OpenSUSE 15 e versioni successive

Prima di eseguire CSM con firewalld, procedi come segue:

Esegui il comando dell'indirizzo IP e quindi sposta l'interfaccia eth0, che è la nostra interfaccia esterna per CSM, nella zona "esterna".
$ indirizzo IP
1: ecco: mtu 65536 qdisc noqueue stato SCONOSCIUTO gruppo predefinito qlen
1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 ambito host lo
valid_lft per sempre preferito_lft per sempre
inet6 ::1/128 host dell'ambito
valid_lft per sempre preferito_lft per sempre
2: eth0: mtu 1500 qdisc fq_codel stato gruppo UP predefinito
qlen 1000
link/etere 08:00:27:f5:d8:3b brd ff:ff:ff:ff:ff:ff
inet 10.0.2.15/24 brd 10.0.2.255 ambito dinamico globale eth0
valid_lft 84864sec preferito_lft 84864sec
inet6 fe80::a00:27ff:fef5:d83b/64 scope link
valid_lft per sempre preferito_lft per sempre
$ sudo firewall-cmd –permanent –zone=esterno –change-interface=eth0
Nota
Per impostazione predefinita, l'interfaccia eth0 si trova in una zona pubblica. Lo spostamento in una zona esterna consente il mascheramento per le connessioni esterne ai contenitori docker CSM
Consenti il traffico in entrata sulla porta 5000 per TCP perché la porta 5000 è la porta predefinita di web interfaccia del server CSM
Nota
Su alcuni sistemi, è necessario spostare l'interfaccia “br-csm” nella zona “attendibile”. L'interfaccia br-csm è l'interfaccia bridge interna creata da CSM e utilizzata per la comunicazione tra i contenitori CSM. Questa interfaccia potrebbe non esistere prima dell'installazione di CSM. Tuttavia, assicurati di eseguire il seguente comando prima del processo di installazione di CSM:
$ sudo firewall-cmd –permanent –zone=trusted –change-interface=br-csm
Ricaricare il demone del firewall con la nuova configurazione
$ sudo firewall-cmd –reload
Nota
Se hai installato Docker prima di installare firewalld, riavvia il demone docker dopo aver apportato le modifiche a firewalld.
Nota
Se utilizzi qualsiasi altra applicazione firewall oltre a firewalld, configurala come richiesto e apri la porta 5000 per TCP per qualsiasi traffico in entrata.

CAPITOLO 3

Installazione del server CSM

Questo capitolo fornisce informazioni sulla procedura di installazione e disinstallazione del server CSM. Questo capitolo descrive anche come aprire la pagina del server CSM.

Procedura di installazione, a pagina 9
Apertura della pagina del server CSM, a pagina 10
Disinstallazione del server CSM, a pagina 11

Procedura di installazione

Per scaricare le informazioni più recenti sui pacchetti software e sulle SMU attualmente pubblicati, il server CSM richiede una connessione HTTPS al sito Cisco. Il server CSM controlla periodicamente anche la presenza di una versione più recente del CSM stesso.

Per installare il server CSM, eseguire il comando seguente per scaricare ed eseguire lo script di installazione: $ bash -c “$(curl -sL

https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh)”

Nota
Invece di scaricare ed eseguire lo script, puoi anche scegliere di scaricare lo script seguente senza eseguirlo. Dopo aver scaricato lo script, puoi eseguirlo manualmente con alcune opzioni aggiuntive, se necessario:

$curl -Ls https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O $ chmod +x install.sh $ ./install.sh –help Script di installazione del server CSM: $ ./ install.sh [OPZIONI] Opzioni: -h Stampa la guida -d, –data
Seleziona la directory per la condivisione dei dati –no-prompt Modalità non interattiva –dry-run Prova di prova. I comandi non vengono eseguiti. –https-proxy URL Utilizza il proxy HTTPS URL –uninstall Disinstalla Server CSM (rimuove tutti i dati)

Nota
Se non esegui lo script come utente "sudo/root", ti verrà richiesto di inserire la password "sudo/root".

Apertura della pagina del server CSM

Utilizzare i seguenti passaggi per aprire la pagina del server CSM:

FASI SOMMARIE

Apri la pagina del server CSM utilizzando questo URL: http://:5000 a web browser, dove “server_ip” è l'indirizzo IP o il nome host del server Linux. Il server CSM utilizza la porta TCP 5000 per fornire l'accesso all'interfaccia utente grafica (GUI) del server CSM.
Accedi al server CSM con le seguenti credenziali predefinite.

FASI DETTAGLIATE

	Comando o azione	Scopo
Passo 1	Apri la pagina del server CSM utilizzando questo URL:http:// :5000 a web browser, dove “server_ip” è l'indirizzo IP o il nome host del server Linux. Il server CSM utilizza la porta TCP 5000 per fornire l'accesso all'interfaccia utente grafica (GUI) del server CSM	Nota Sono necessari circa 10 minuti per installare e avviare la pagina del server CSM.
Passo 2	Accedi al server CSM con le seguenti credenziali predefinite.	Nome utente: root • Password: root
		Nota Cisco consiglia vivamente di modificare la password predefinita dopo l'accesso iniziale.

Cosa fare dopo
Per ulteriori informazioni sull'utilizzo del server CSM, fare clic su Guida nella barra dei menu in alto della GUI del server CSM e selezionare "Strumenti di amministrazione".

Disinstallazione del server CSM

Per disinstallare il server CSM dal sistema host, eseguire il seguente script nel sistema host. Questa sceneggiatura lo è
lo stesso script di installazione scaricato in precedenza con: curl -Ls
https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O per installare il server CSM.

$ ./install.sh –disinstallazione
20-02-25 15:36:32 AVVISO Script di avvio di CSM Supervisor: /usr/sbin/csm-supervisor
20-02-25 15:36:32 AVVISO Script di avvio di CSM AppArmor: /usr/sbin/csm-apparmor
20-02-25 15:36:32 AVVISO CSM Config file: /etc/csm.json
20-02-25 15:36:32 AVVISO Cartella dati CSM: /usr/share/csm
20-02-25 15:36:32 AVVISO Servizio supervisore CSM: /etc/systemd/system/csm-supervisor.service
20-02-25 15:36:32 AVVISO Servizio CSM AppArmor: /etc/systemd/system/csm-apparmor.service
20-02-25 15:36:32 ATTENZIONE Questo comando eliminerà tutti i contenitori CSM e i dati condivisi
cartella dall'host
Sei sicuro di voler continuare [sì|No]: sì
20-02-25 15:36:34 Iniziata la disinstallazione di INFO CSM
20-02-25 15:36:34 INFO Rimozione dello script di avvio del supervisore
20-02-25 15:36:34 INFO Rimozione dello script di avvio di AppArmor
20-02-25 15:36:34 INFO Arresto di csm-supervisor.service
20-02-25 15:36:35 INFO Disabilitazione csm-supervisor.service
20-02-25 15:36:35 INFO Rimozione csm-supervisor.service
20-02-25 15:36:35 INFO Arresto di csm-apparmor.service
20-02-25 15:36:35 INFO Rimozione csm-apparmor.service
20-02-25 15:36:35 INFO Rimozione contenitori Docker CSM
20-02-25 15:36:37 INFO Rimozione immagini CSM Docker
20-02-25 15:36:37 INFO Rimozione della rete bridge Docker CSM
20-02-25 15:36:37 INFO Rimozione config. CSM file: /etc/csm.json
20-02-25 15:36:37 ATTENZIONE Rimozione della cartella dati CSM (database, registri, certificati, plugins,
repository locale): '/usr/share/csm'
Sei sicuro di voler continuare [sì|No]: sì
20-02-25 15:36:42 Cartella dati INFO CSM eliminata: /usr/share/csm
20-02-25 15:36:42 INFO Server CSM disinstallato correttamente

Durante la disinstallazione è possibile salvare la cartella dati CSM rispondendo “No” all'ultima domanda. Rispondendo “No” è possibile disinstallare l'applicazione CSM e successivamente reinstallarla con i dati conservati

Documenti / Risorse

Server CISCO Cisco Software Manager [pdf] Guida utente
Cisco Software Manager Server, Software Manager Server, Manager Server, Server

Riferimenti

Manuale d'uso

Guida all'installazione per Cisco Software Manager Server