Cisco Software Manager Server User Guide

Cisco Systems, Inc.
170 Drive Tasman Ovest
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883

Prefazione

Nota

Stu pruduttu hà righjuntu u statu di a fine di a vita. Per più infurmazione, vede u Avvisi di fine di vita è di fine di vendita

Questa guida descrive cumu installà un servitore Cisco Software Manager (CSM).

Audience, a pagina iii
Cambiamenti à stu Documentu, in pagina iii

Ottenimentu di Documentazione è Invià una Richiesta di Serviziu, in a pagina iii

Audience

Questa guida hè per quelli rispunsevuli di installà u servitore Cisco Software Manager 4.0 è l'amministratori di sistema di i router Cisco.

Questa publicazione assume chì u lettore hà un sfondate sustinibili in l'installazione è a cunfigurazione di u router è hardware basatu in switch. U lettore deve ancu esse familiarizatu cù i circuiti elettronichi è e pratiche di cablaggio è sperimentatu cum'è tecnicu elettronicu o elettromeccanicu.

Cambiamenti à stu Documentu

Questa tavula lista i cambiamenti tecnichi chì sò fatti à stu documentu da quandu hè statu sviluppatu prima.

Tabella 1: Cambiamenti à stu Documentu

Data	Riassuntu
aprile 2020	Liberazione iniziale di stu documentu.

Ottenimentu di Documentazione è Invià una Richiesta di Serviziu

Per i seguenti scopi, vede ciò chì hè novu in a documentazione di u produttu Cisco, à: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

Ottene infurmazione nantu à ottene documentazione, utilizendu Cisco Bug Search Tool (BST)
Invia una dumanda di serviziu

Raccolta di informazioni supplementari

Abbonate à ciò chì hè novu in a documentazione di u produttu Cisco. Stu documentu elenca tutta a documentazione tecnica Cisco nova è rivista cum'è RSSfeed è furnisce u cuntenutu direttamente à u vostru desktop utilizendu una applicazione di lettore. I feed RSS sò servizii gratuiti, è Cisco supporta attualmente a versione RSS 2.0.

CAPITOLU `1

À propositu di Cisco Software Manager Server

Stu capitulu furnisce un sopraview di u CiscoSoftware Managerserver. Stu capitulu elenca ancu e restrizioni à a so stallazione.

Introduzione, a pagina 1
Restrizioni, a pagina 2

Introduzione

U servitore CiscoSoftware Manager (CSM) hè un webstrumentu d'automatizazione basatu. Aiuta à gestisce è simultaneamente
pianificà l'aghjurnamenti di mantenimentu di u software (SMU) è i pacchetti di serviziu (SP) in più routers. Fornisce raccomandazioni chì riducenu u sforzu in a ricerca, l'identificazione è l'analisi manuali di SMU è SP chì sò necessarii per un dispositivu. Un SMU hè una correzione per un bug. Un SP hè una cullizzioni di SMU bundle in una file.

Per furnisce i cunsiglii, deve cunnette u servitore CSM deve via Internet à u duminiu cisco.com. CSM hè cuncepitu per cunnette parechji dispositi è furnisce a gestione di SMU è SP per parechje piattaforme è versioni Cisco IOS XR.

I plataformi chì sò supportati in CSM sò:

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)

Da a versione 4.0 in avanti, ci sò parechje cuntenituri Docker chì custituiscenu l'architettura CSM. Questi cuntenituri sò:

CSM
basa di dati
Supervisore

L'installazione di u servitore CSM attraversu Docker hè faciule. Pudete aghjurnà à l'ultima versione di u servitore CSM cù u clicu di un buttone d'aghjurnamentu nantu à a pagina di casa di u servitore CSM

Restrizzione

E seguenti restrizioni sò applicabili in quantu à l'installazione di u servitore CSM:

Questa guida d'installazione ùn hè micca applicabile à qualsiasi versione di u servitore CSM prima di a versione 4.0.
U servitore CSM deve esse capace di cunnette à Cisco.com per avè infurmatu nantu à l'ultime aghjurnamenti dispunibili.

CAPITOLU 2

Requisiti di preinstallazione

Stu capitulu furnisce infurmazioni nantu à u hardware è u software chì avete bisognu per installà u servitore CSM.

Requisiti hardware, a pagina 3
Requisiti di u software, in a pagina 3

Requisiti Hardware

I requisiti minimi di hardware per installà CSM server 4.0 sò:

2 CPU
8-GB di RAM
HDD da 30 GB

Nota

Per e grande rete, ricumandemu di aumentà u numeru di CPU per eseguisce più operazioni di installazione di rete à u stessu tempu.

Pudete aghjustà u spaziu di u discu duru per almacenà l'imaghjini è i pacchetti è i logs da l'operazioni.

Requisiti di u Software

I requisiti di u software per installà u servitore CSM 4.0 sò:

distribuzione Linux systemd cù Docker

Configurazione Docker Proxy (Opzionale)
Firewalld (opcional)

systemd

Per installà u servitore CSM, duvete aduprà systemd. Hè una suite chì furnisce i blocchi di costruzione per creà diversi sistemi operativi Linux. Per più dettagli nantu à systemd, riferite à Wikipedia.

Assicuratevi di risponde à i seguenti requisiti prima di procedere cù l'installazione di u servitore CSM 4.0:

Avete bisognu di privilegi di root per installà u servitore CSM perchè a cunfigurazione di u servitore CSM hè guardatu in /etc/csm.json file. U prucessu di stallazione crea u serviziu systemd per u so start automaticu. Per uttene privilegi di root, eseguite u script d'installazione cum'è utilizatore root o cum'è utilizatore cù l'accessu à u prugramma sudo.
Assicuratevi di stallà Docker in u sistema operatore host. Per più infurmazione, vede
https://docs.docker.com/install/. Cisco consiglia di utilizà Ubuntu, CentOS, o Red Hat Enterprise Linux cum'è sistema operatore ospite chì esegue u servitore CSM 4.0. CSM funziona cù Docker Community Edition (CE) è Docker Enterprise Edition (EE)

Docker

U servitore CSM funziona cù Docker Community Edition (CE) è Docker Enterprise Edition (EE). Per più infurmazione, riferite à a documentazione ufficiale di Docker, https://docs.docker.com/install/overview/.

Aduprate Docker 19.03 o versioni successive per installà u servitore CSM. Pudete aduprà u cumandimu seguitu per verificà a versione di u Docker:

versione $ docker
Cliente: Docker Engine - Community
Versione: 19.03.9
Versione API: 1.40
Versione Go: go1.13.10
Git cummit: 9d988398e7
Custruitu: Ven 15 May 00:25:34 2020
OS/Arch: linux/amd64
Sperimentale : falsu

Servitore: Docker Engine - Cumunità
Motore:

Versione: 19.03.9
Versione API: 1.40 (versione minima 1.12)
Versione Go: go1.13.10
Git cummit: 9d988398e7
Custruitu: Ven 15 May 00:24:07 2020
OS/Arch: linux/amd64
Sperimentale : falsu
containerd:
Versione: 1.2.13
GitCommit: 7ad184331fa3e55e52b890ea95e65ba581ae3429
runc:
Versione: 1.0.0-rc10
GitCommit: dc9208a3303feef5b3839f4323d9beb36df0a9dd
docker-init:
Versione: 0.18.0
GitCommit: fec3683

Configurazione Docker Proxy (Opzionale)
Sè installate u servitore CSM daretu à un proxy HTTPS, per esempiuample, in i paràmetri corporativi, duvete cunfigurà u serviziu di sistema Docker file cum'è seguita:

Crea un repertoriu systemd drop-in per u serviziu docker:
$ sudo mkdir -p /etc/systemd/system/docker.service.d
Crea a file intitulatu /etc/systemd/system/docker.service.d/https-proxy.conf chì aghjunghje a variabile d'ambiente HTTPS_PROXY. Questu file permette à u daemon Docker di tirà i cuntenituri da u repositoriu utilizendu u Proxy HTTPS:
[Serviziu] Ambiente = "HTTPS_PROXY = http://proxy.example.com:443/”
Nota
Hè una sorveglianza cumuni chì a variabile d'ambiente HTTPS_PROXY usa lettere maiuscule è u proxy URL principia cù http:// è micca https://.
Ricaricate i cambiamenti di cunfigurazione:
$ sudo systemctl daemon-reload

Riavvia u Docker:
$ sudo systemctl restart docker
Verificate chì avete caricatu a cunfigurazione:
$ systemctl show –property=Docker di l'ambiente
Ambiente=HTTPS_PROXY=http://proxy.example.com:443/

Verificate a cunfigurazione di Docker

Per verificà s'ellu avete installatu bè u Docker è per assicurà chì hè in funziunamentu, utilizate u cumandimu seguente:

$ systemctl is-active docker
attivu

Per verificà s'ellu avete cunfiguratu bè u demoniu Docker, è se u Docker hè capaci di tirà l'imaghjini da u repository è hè capaci di eseguisce u cuntainer di prova; aduprà u cumandimu seguente:

$ docker run -rm hello-world
Impossibile di truvà l'imaghjini "hello-world: latest" in u locu
l'ultime: Tira da a biblioteca / ciao-mondu
d1725b59e92d: Tira cumpletu
Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
Status: Scaricatu una nova immagine per hello-world: latest

Salutami da Docker!
Stu missaghju mostra chì a vostra installazione pare chì funziona bè.
Per generà stu missaghju, Docker hà fattu i seguenti passi:

U cliente Docker hà cuntattatu u daemon Docker.

U Daemon Docker hà tiratu l'imaghjini "hello-world" da u Docker Hub. (amd64)
U daemon Docker hà creatu un novu containeru da quella maghjina chì eseguisce l'eseguibile chì produce l'output chì site attualmente leghje.
U daemon Docker hà trasmessu quellu output à u cliente Docker, chì l'hà mandatu à u vostru terminal.

Per pruvà qualcosa di più ambiziosu, pudete eseguisce un containeru Ubuntu cù:
$ docker run -it ubuntu bash

Condividi l'imaghjini, automatizà i flussi di travagliu, è più cù un ID Docker gratuitu:
https://hub.docker.com/

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

Firewalld (opcional)

U servitore CSM pò eseguisce cù Firewalld. Firewalld hè furnitu in e seguenti distribuzioni Linux cum'è strumentu di gestione di firewall predeterminatu:

RHEL 7 è versioni successive
CentOS 7 è versioni successive

Fedora 18 è versioni successive
SUSE 15 è versioni successive
OpenSUSE 15 è versioni successive

Prima di eseguisce CSM cù firewalld, fate u seguente:

Eseguite u cumandamentu di l'indirizzu IP è poi move l'interfaccia eth0, chì hè a nostra interfaccia esterna per CSM, à a zona "esterna".
$ indirizzu ip
1: eccu: mtu 65536 qdisc noqueue state UNKNOWN gruppu predefinitu qlen
1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 portata host lo
valid_lft per sempre preferitu_lft per sempre
inet6 ::1/128 scope host
valid_lft per sempre preferitu_lft per sempre
2: eth0: mtu 1500 qdisc fq_codel state UP Group default
qlen 1000
link/ether 08:00:27:f5:d8:3b brd ff:ff:ff:ff:ff:ff
inet 10.0.2.15/24 brd 10.0.2.255 scope global dynamic eth0
valid_lft 84864sec preferitu_lft 84864sec
inet6 fe80::a00:27ff:fef5:d83b/64 scope link
valid_lft per sempre preferitu_lft per sempre
$ sudo firewall-cmd –permanent –zone=external –change-interface=eth0
Nota
Per automaticamente, l'interfaccia eth0 hè in una zona publica. Spostallu in una zona esterna permette di maschera per e cunnessione esterne à i cuntenituri di docker CSM
Permette u trafficu in entrata in u portu 5000 per TCP perchè u portu 5000 hè u portu predeterminatu di u portu. web interfaccia di u servitore CSM
Nota
In certi sistemi, deve spustà l'interfaccia "br-csm" à a zona "fiducia". L'interfaccia br-csm hè l'interfaccia di ponte interna chì hè creata da CSM è hè aduprata per a cumunicazione trà cuntenituri CSM. Questa interfaccia pò esse micca esistita prima di l'installazione CSM. Tuttavia, assicuratevi chì eseguite u cumandimu seguitu prima di u prucessu di stallazione CSM:
$ sudo firewall-cmd –permanent –zone=trusted –change-interface=br-csm

Ricaricate u daemon firewall cù una nova cunfigurazione
$ sudo firewall-cmd -reload
Nota
Se avete installatu u Docker prima di installà u firewalld, riavviate u daemon docker dopu avè fattu cambiamenti di firewalld.
Nota
Sè vo aduprate qualsiasi altra applicazione firewall fora di firewalld, cunfigurà cum'è necessariu è apre u portu 5000 per TCP per ogni trafficu entrante.

CAPITOLU 3

Installazione di u CSM Server

Stu capitulu furnisce infurmazioni nantu à a prucedura di installazione è disinstallazione di u servitore CSM. Stu capitulu descrive ancu cumu apre a pagina di u servitore CSM.

Procedura di installazione, a pagina 9
Apertura di a Pagina Server CSM, a pagina 10
Disinstallazione di u CSM Server, a pagina 11

Prucedura di stallazione

Per scaricà l'ultime informazioni nantu à i pacchetti software è SMU attualmente publicati, u servitore CSM necessita una cunnessione HTTPS à u situ Cisco. U servitore CSM verifica ancu periodicamente per una versione più nova di u CSM stessu.

Per installà u servitore CSM, eseguite u cumandimu seguitu per scaricà è eseguisce u script d'installazione: $ bash -c "$(curl - sL

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

Nota
Invece di scaricà è eseguisce u script, pudete ancu sceglie di scaricà u script seguente senza eseguisce. Dopu avè scaricatu u script, pudete eseguisce manualmente cù alcune opzioni supplementari se ne necessariu:

$ curl -Ls https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O $ chmod +x install.sh $ ./install.sh -help script d'installazione di u CSM Server: $ ./ install.sh [OPZIONI] Opzioni: -h Print help -d, –data
Selezziunate u repertoriu per a spartera di dati -no-prompt Modu micca interattivu -dry-run Dry run. I cumandamenti ùn sò micca eseguiti. - https-proxy URL Aduprate u Proxy HTTPS URL – disinstallate Uninstall CSM Server (Eliminate tutti i dati)

Nota
Se ùn eseguite micca u script cum'è un utilizatore "sudo/root", vi sò invitati à inserisce a password "sudo/root".

Apertura di a Pagina di u Servitore CSM

Aduprate i seguenti passi per apre a pagina di u servitore CSM:

PASSI SINTESI

Aprite a Pagina di u servitore CSM utilizendu questu URL: http://:5000 à a web navigatore, induve "server_ip" hè l'indirizzu IP o Hostname di u servitore Linux. U servitore CSM usa u portu TCP 5000 per furnisce l'accessu à l'interfaccia d'utilizatore grafica (GUI) di u servitore CSM.

Accedi à u servitore CSM cù e seguenti credenziali predeterminate.

PASSI DETTAGLIATI

	Cumandante o Azzione	Scopu
Passu 1	Aprite a Pagina di u servitore CSM utilizendu questu URL: http:// : 5000 à a web navigatore, induve "server_ip" hè l'indirizzu IP o Hostname di u servitore Linux. U servitore CSM usa u portu TCP 5000 per furnisce l'accessu à l'interfaccia grafica d'utilizatore (GUI) di u servitore CSM.	Nota Ci vole circa 10 minuti per installà è lancià a pagina di u servitore CSM.
Passu 2	Accedi à u servitore CSM cù e seguenti credenziali predeterminate.	Username : root • Password : root
		Nota Cisco vi ricumandemu fermamente di cambià a password predeterminata dopu u login iniziale.

Cosa da fà dopu
Per più infurmazione nantu à l'usu di u servitore CSM, cliccate Aiutu da a barra di menu superiore di a GUI di u servitore CSM, è selezziunate "Admin Tools".

Disinstalla u Servitore CSM

Per disinstallà u servitore CSM da u sistema di l'ospite, eseguite u script seguente in u sistema di l'ospite. Questu script hè
u listessu script d'installazione chì avete scaricatu prima cù: curl - Ls
https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O per stallà u servitore CSM.

$ ./install.sh -uninstall
20-02-25 15:36:32 AVVISU CSM Supervisor Startup Script: /usr/sbin/csm-supervisor
20-02-25 15:36:32 AVVISU CSM AppArmor Startup Script: /usr/sbin/csm-apparmor
20-02-25 15:36:32 AVVISU CSM Config file: /etc/csm.json
20-02-25 15:36:32 AVVISU Cartulare di dati CSM: /usr/share/csm
20-02-25 15:36:32 AVVISU CSM Supervisor Service: /etc/systemd/system/csm-supervisor.service
20-02-25 15:36:32 AVVISU CSM AppArmor Service: /etc/systemd/system/csm-apparmor.service
20-02-25 15:36:32 ATTENZIONE Stu cumandamentu ELIMINA tutti i cuntenituri CSM è e dati spartuti
cartulare da l'ospite
Sò sicuru chì vulete cuntinuà [iè|No]: iè
20-02-25 15:36:34 INFO A disinstallazione di CSM hà iniziatu
20-02-25 15:36:34 INFO Eliminazione di u Script di Startup Supervisor
20-02-25 15:36:34 INFO Eliminazione di AppArmor Startup Script
20-02-25 15:36:34 INFO Stopping csm-supervisor.service
20-02-25 15:36:35 INFO Disattivazione di csm-supervisor.service
20-02-25 15:36:35 INFO Eliminazione di csm-supervisor.service
20-02-25 15:36:35 INFO Stopping csm-apparmor.service
20-02-25 15:36:35 INFO Eliminazione di csm-apparmor.service
20-02-25 15:36:35 INFO Eliminazione di cuntenituri CSM Docker
20-02-25 15:36:37 INFO Eliminazione di l'imaghjini CSM Docker
20-02-25 15:36:37 INFO Eliminazione di a rete di ponte CSM Docker
20-02-25 15:36:37 INFO Eliminazione di a cunfigurazione CSM file: /etc/csm.json
20-02-25 15:36:37 ATTENZIONE Eliminazione di u cartulare di dati CSM (base di dati, logs, certificati, plugins,
repository locale): '/usr/share/csm'
Sò sicuru chì vulete cuntinuà [iè|No]: iè
20-02-25 15:36:42 INFO Cartulare di dati CSM eliminatu: /usr/share/csm
20-02-25 15:36:42 INFO CSM Server disinstallatu cù successu

Durante a disinstallazione, pudete salvà u cartulare di dati CSM rispondendu "No" à l'ultima quistione. Rispondendu "No", pudete disinstallà l'applicazione CSM è poi reinstallà cù i dati cunservati.

Documenti / Risorse

CISCO Cisco Software Manager Server [pdfGuida di l'utente
Cisco Software Manager Server, Software Manager Server, Manager Server, Server

Referenze

Manuale d'usu

Guida d'installazione per u Cisco Software Manager Server