Gid itilizatè Cisco Software Manager sèvè

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

Prefas

Remak

Pwodwi sa a te rive nan fen lavi. Pou plis enfòmasyon, gade nan Avi nan fen lavi ak nan fen vann

Gid sa a dekri kijan pou enstale yon sèvè Cisco Software Manager (CSM).

Odyans lan, nan paj iii
Chanjman nan Dokiman Sa a, nan paj iii

Jwenn Dokimantasyon ak Soumèt yon Demann Sèvis, nan paj iii

Odyans lan

Gid sa a se pou moun ki responsab pou enstale Cisco Software Manager sèvè 4.0 ak administratè sistèm nan routeurs Cisco.

Piblikasyon sa a sipoze ke lektè a gen yon background sibstansyèl nan enstale ak konfigirasyon routeur ak pyès ki nan konpitè ki baze sou switch. Lektè a dwe tou abitye ak sikwi elektwonik ak pratik fil elektrik ak eksperyans kòm yon teknisyen elektwonik oswa elektwomekanik.

Chanjman nan Dokiman sa a

Tablo sa a bay lis chanjman teknik yo te fè nan dokiman sa a depi li te premye devlope.

Tablo 1: Chanjman nan Dokiman Sa a

Dat	Rezime
Avril 2020	Premye Divilgasyon dokiman sa a.

Jwenn Dokimantasyon ak Soumèt yon Demann Sèvis

Pou rezon sa yo, gade Nouvo nan Dokimantasyon pwodwi Cisco, nan: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

Jwenn enfòmasyon sou jwenn dokiman, lè l sèvi avèk Zouti Cisco Bug Search Tool (BST)
Soumèt yon demann sèvis

Rasanble enfòmasyon adisyonèl

Abònman ak sa ki nouvo nan Dokimantasyon pwodwi Cisco. Dokiman sa a bay lis tout nouvo ak revize dokiman teknik Cisco kòm yon RSSfeed epi delivre kontni dirèkteman sou Desktop ou lè l sèvi avèk yon aplikasyon lektè. Flux RSS yo se sèvis gratis, ak Cisco kounye a sipòte RSS Version 2.0.

CHAPIT `1

Konsènan Cisco Software Manager Server

Chapit sa a bay yon souview nan CiscoSoftware Managerserver la. Chapit sa a tou lis restriksyon yo nan enstalasyon li yo.

Entwodiksyon, nan paj 1
Restriksyon, nan paj 2

Entwodiksyon

Sèvè CiscoSoftware Manager (CSM) se yon web- ki baze sou zouti automatisation. Li ede ou jere ak ansanm
pwograme amelyorasyon antretyen lojisyèl (SMU) ak pake sèvis (SP) atravè plizyè routeur. Li bay rekòmandasyon ki diminye efò nan rechèch, idantifye ak analize SMU ak SP ki nesesè pou yon aparèy. Yon SMU se yon ranje pou yon ensèk. Yon SP se yon koleksyon SMU yo mete nan yon sèl file.

Pou bay rekòmandasyon yo, ou dwe konekte sèvè CSM dwe atravè entènèt la nan domèn cisco.com. CSM fèt pou konekte plizyè aparèy epi li bay SMU ak jesyon SP pou plizyè platfòm Cisco IOS XR ak degaje.

Platfòm yo ki sipòte sou CSM yo se:

IOS XR (ASR 9000, CRS)

IOS XR 64 ti jan (ASR 9000-X64, NCS 1000, NCS 4000, NCS 5000, NCS 5500, NCS 6000)
IOS XE (ASR902, ASR903, ASR904, ASR907, ASR920)

IOS (ASR901)

Soti nan vèsyon 4.0 ivè, gen plizyè resipyan Docker ki konstitye achitekti CSM la. Kontenè sa yo se:

CSM
Baz done
Sipèvizè

Enstale sèvè CSM atravè Docker se fasil. Ou ka ajou ak dènye vèsyon sèvè CSM la ak klike sou yon bouton ajou nan paj lakay sèvè CSM la

Restriksyon yo

Restriksyon sa yo aplikab konsènan enstalasyon sèvè CSM la:

Gid enstalasyon sa a pa aplikab pou nenpòt vèsyon sèvè CSM anvan vèsyon 4.0.
Sèvè CSM a ta dwe kapab konekte ak Cisco.com pou jwenn enfòmasyon sou dènye mizajou ki disponib yo.

CHAPIT 2

Kondisyon anvan enstalasyon

Chapit sa a bay enfòmasyon sou pyès ki nan konpitè ak lojisyèl ou bezwen pou enstale sèvè CSM la.

Kondisyon Materyèl, nan paj 3
Kondisyon lojisyèl, nan paj 3

Kondisyon pyès ki nan konpitè

Kondisyon minimòm pyès ki nan konpitè pou enstale CSM sèvè 4.0 yo se:

2 CPU
8-GB RAM
30-GB HDD

Remak

Pou gwo rezo, nou rekòmande pou ou ogmante kantite CPU pou fè plis operasyon enstalasyon rezo an menm tan.

Ou ka ajiste espas ki gen kapasite ki di pou sere imaj ak pakè ak mòso bwa ki soti nan operasyon yo.

Kondisyon lojisyèl

Kondisyon lojisyèl yo pou enstale CSM sèvè 4.0 yo se:

systemd distribisyon Linux ak Docker

Konfigirasyon Docker Proxy (Si ou vle)
Firewalld (Si ou vle)

systemd

Pou enstale sèvè CSM a, ou dwe itilize systemd. Li se yon suite ki bay blòk bilding yo pou kreye divès sistèm opere Linux. Pou plis detay sou systemd, al gade nan Wikipedya.

Asire w ke ou ranpli kondisyon sa yo anvan ou kontinye ak enstalasyon CSM sèvè 4.0:

Ou bezwen privilèj rasin pou enstale sèvè CSM la paske konfigirasyon sèvè CSM la estoke nan /etc/csm.json. file. Pwosesis enstalasyon an kreye sèvis systemd pou demaraj otomatik li yo. Pou jwenn privilèj rasin, kouri script enstalasyon an kòm yon itilizatè rasin oswa kòm yon itilizatè ki gen aksè nan pwogram sudo.
Asire w ke ou enstale Docker sou sistèm opere lame a. Pou plis enfòmasyon, gade
https://docs.docker.com/install/. Cisco rekòmande pou itilize Ubuntu, CentOS, oswa Red Hat Enterprise Linux kòm sistèm opere lame ki kouri CSM sèvè 4.0. CSM travay ak tou de Docker Community Edition (CE) ak Docker Enterprise Edition (EE)

Docker

Sèvè CSM a travay ak Docker Community Edition (CE) ak Docker Enterprise Edition (EE). Pou plis enfòmasyon, al gade nan dokiman ofisyèl Docker, https://docs.docker.com/install/overview/.

Sèvi ak Docker 19.03 oswa vèsyon pita pou enstale sèvè CSM la. Ou ka itilize kòmandman sa a pou tcheke vèsyon Docker la:

$ vèsyon docker
Kliyan: Docker Engine - Kominote
Vèsyon: 19.03.9
Vèsyon API: 1.40
Ale vèsyon: go1.13.10
Git komèt: 9d988398e7
Bati: Ven 15 Me 00:25:34 2020
OS/Arch: linux/amd64
Eksperimantal: fo

Sèvè: Docker Engine - Kominote
Motè:

Vèsyon: 19.03.9
API vèsyon: 1.40 (minimòm vèsyon 1.12)
Ale vèsyon: go1.13.10
Git komèt: 9d988398e7
Bati: Ven 15 Me 00:24:07 2020
OS/Arch: linux/amd64
Eksperimantal: fo
containerd:
Vèsyon: 1.2.13
GitCommit: 7ad184331fa3e55e52b890ea95e65ba581ae3429
runc:
Vèsyon: 1.0.0-rc10
GitCommit: dc9208a3303feef5b3839f4323d9beb36df0a9dd
docker-init:
Vèsyon: 0.18.0
GitCommit: fec3683

Konfigirasyon Docker Proxy (Si ou vle)
Si ou enstale sèvè CSM la dèyè yon proxy HTTPS, pa egzanpample, nan anviwònman antrepriz, ou dwe konfigirasyon sèvis la Docker systemd file jan sa a:

Kreye yon anyè systemd drop-in pou sèvis docker la:
$ sudo mkdir -p /etc/systemd/system/docker.service.d
Kreye yon file ki gen tit /etc/systemd/system/docker.service.d/https-proxy.conf ki ajoute varyab anviwònman HTTPS_PROXY. Sa a file pèmèt demon Docker la rale resipyan yo soti nan depo a lè l sèvi avèk HTTPS Proxy la:
[Sèvis] Anviwònman =”HTTPS_PROXY=http://proxy.example.com:443/”
Remak
Li komen sipèvizyon ke HTTPS_PROXY anviwònman varyab itilize lèt majiskil ak prokurasyon an URL kòmanse ak http:// epi li pa https://.
Rechaje chanjman konfigirasyon yo:
$ sudo systemctl daemon-reload

Rekòmanse Docker la:
$ sudo systemctl rekòmanse docker
Verifye ke ou te chaje konfigirasyon an:
$ systemctl show –property=Docker Anviwònman
Anviwònman=HTTPS_PROXY=http://proxy.example.com:443/

Verifye konfigirasyon Docker la

Pou tcheke si ou te byen enstale Docker a epi asire ke li kanpe ak kouri, sèvi ak lòd sa a:

$ systemctl is-active docker
aktif

Pou verifye si ou te byen konfigirasyon demon an Docker, epi si Docker a kapab rale imaj yo soti nan depo a epi li kapab egzekite veso tès la; sèvi ak lòd sa a:

$ docker kouri –rm alo-mond
Pa kapab jwenn imaj 'hello-world:latest' lokalman
dènye: Rale nan bibliyotèk/alo-mond
d1725b59e92d: Rale konplè
Dijere: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
Estati: Telechaje nouvo imaj pou hello-world:latest

Bonjou soti nan Docker!
Mesaj sa a montre ke enstalasyon w parèt ap travay kòrèkteman.
Pou jenere mesaj sa a, Docker te pran etap sa yo:

Kliyan Docker la kontakte demon Docker la.

Daemon Docker la rale imaj "bonjou mond lan" soti nan Docker Hub la. (amd64)
Daemon Docker te kreye yon nouvo veso ki soti nan imaj sa a ki kouri ègzekutabl la ki pwodui pwodiksyon w ap li kounye a.
Daemon Docker te difize pwodiksyon sa a nan kliyan Docker la, ki te voye li nan tèminal ou a.

Pou eseye yon bagay ki pi anbisye, ou ka kouri yon veso Ubuntu ak:
$ docker kouri -it ubuntu bash

Pataje imaj, otomatize workflows, ak plis ankò ak yon ID Docker gratis:
https://hub.docker.com/

Pou plis ansyenamples ak lide, vizite:
https://docs.docker.com/get-started/

Firewalld (Si ou vle)

Sèvè CSM ka kouri ansanm ak Firewalld. Firewalld yo bay nan distribisyon Linux sa yo kòm zouti jesyon firewall default:

RHEL 7 ak vèsyon pita
CentOS 7 ak vèsyon pita

Fedora 18 ak vèsyon pita
SUSE 15 ak vèsyon pita
OpenSUSE 15 ak vèsyon pita yo

Anvan ou kouri CSM ak firewalld, fè bagay sa yo:

Kouri kòmand adrès IP la epi deplase koòdone eth0 a, ki se koòdone ekstèn nou an pou CSM, nan zòn "ekstèn lan".
$ adrès ip
1:lo: mtu 65536 qdisc noqueue eta UNKNOWN gwoup default qlen
1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 dimansyon lame lo
valid_lft pou tout tan
inet6 ::1/128 dimansyon lame
valid_lft pou tout tan
2:eth0: mtu 1500 qdisc fq_codel eta UP gwoup default
qlen 1000
lyen/etè 08:00:27:f5:d8:3b brd ff:ff:ff:ff:ff:ff
inet 10.0.2.15/24 brd 10.0.2.255 dimansyon mondyal dinamik eth0
valid_lft 84864sec préféré_lft 84864sec
inet6 fe80::a00:27ff:fef5:d83b/64 scope link
valid_lft pou tout tan
$ sudo firewall-cmd -pèmanan -zòn = ekstèn -chanje-koòdone = eth0
Remak
Pa default, koòdone eth0 a se nan yon zòn piblik. Deplase li nan yon zòn ekstèn pèmèt maskarasyon pou koneksyon ekstèn nan resipyan docker CSM yo
Pèmèt trafik fèk ap rantre sou pò 5000 pou chak TCP paske pò 5000 se pò default la. web koòdone nan sèvè CSM la
Remak
Sou kèk sistèm, ou dwe deplase koòdone "br-csm" nan zòn "fè konfyans". Koòdone br-csm se koòdone pon entèn ki kreye pa CSM epi ki itilize pou kominikasyon ant resipyan CSM. Koòdone sa a ka pa egziste anvan enstalasyon CSM la. Sepandan, asire w ke ou kouri lòd sa a anvan pwosesis enstalasyon CSM la:
$ sudo firewall-cmd –permanent –zone=fè konfyans –change-interface=br-csm

Rechaje demon firewall la ak nouvo konfigirasyon
$ sudo firewall-cmd –rechaje
Remak
Si ou te enstale Docker a anvan ou enstale firewalld, rekòmanse demon docker a apre ou fin fè chanjman firewalld.
Remak
Si w ap itilize nenpòt lòt aplikasyon firewall apa de firewalld, konfigirasyon li jan sa nesesè epi louvri pò 5000 pou chak TCP pou nenpòt trafik fèk ap rantre.

CHAPIT 3

Enstale sèvè CSM

Chapit sa a bay enfòmasyon sou pwosedi enstalasyon ak dezenstalasyon sèvè CSM. Chapit sa a tou dekri kijan pou louvri paj sèvè CSM la.

Pwosedi Enstalasyon, nan paj 9
Louvri paj sèvè CSM la, nan paj 10
Dezenstalasyon sèvè CSM la, nan paj 11

Pwosedi enstalasyon

Pou telechaje dènye enfòmasyon yo sou pakè lojisyèl ak SMU yo afiche kounye a, sèvè CSM a mande pou yon koneksyon HTTP sou sit Cisco a. Sèvè CSM la tcheke tou detanzantan pou yon nouvo vèsyon CSM nan tèt li.

Pou enstale sèvè CSM la, kouri kòmandman sa a pou telechaje epi egzekite script enstalasyon an: $ bash -c “$(curl -sL

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

Remak
Olye pou yo telechaje ak egzekite script la, ou ka chwazi tou telechaje script sa a san yo pa egzekite li. Apre telechaje script la, ou ka manyèlman kouri li ak kèk opsyon adisyonèl si sa nesesè:

$ curl -Ls https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O $ chmod +x install.sh $ ./install.sh – ede script enstalasyon sèvè CSM: $ ./ install.sh [OPSYON] Opsyon: -h Enprime èd -d, -data
Chwazi anyè a pou pataje done –no-prompt Mòd ki pa entèaktif –dry-run Dry run. Kòmandman yo pa egzekite. –https-proxy URL Sèvi ak HTTPS Proxy la URL – dezenstalasyon Unenstal CSM Server (Retire tout done)

Remak
Si ou pa kouri script la kòm yon itilizatè "sudo/rasin", yo mande w pou antre modpas "sudo/rasin".

Louvri paj sèvè CSM la

Sèvi ak etap sa yo pou louvri paj sèvè CSM la:

REZIME ETAP

Louvri paj sèvè CSM lè w itilize sa a URL: http://:5000 nan a web navigatè, kote "server_ip" se adrès IP oswa Hostname sèvè Linux la. Sèvè CSM la sèvi ak pò TCP 5000 pou bay aksè a `Graphical User Interface (GUI) sèvè CSM la.

Konekte sou sèvè CSM la ak kalifikasyon default sa yo.

ETAP DETAYE

	Kòmand oswa Aksyon	Objektif
Etap 1	Louvri paj sèvè CSM lè w itilize sa a URL:http:// :5000 nan a web navigatè, kote "server_ip" se adrès IP oswa Hostname sèvè Linux la. Sèvè CSM la sèvi ak pò TCP 5000 pou bay aksè nan Entèfas Itilizatè Grafik (GUI) sèvè CSM la.	Remak Li pran apeprè 10 minit pou enstale ak lanse paj sèvè CSM la.
Etap 2	Konekte sou sèvè CSM la ak kalifikasyon default sa yo.	Non itilizatè: rasin • Modpas: rasin
		Remak Cisco rekòmande pou w chanje modpas default apre premye koneksyon an.

Kisa pou w fè annapre
Pou plis enfòmasyon sou itilizasyon sèvè CSM la, klike sou Èd nan ba meni anlè entèfas sèvè CSM la, epi chwazi "Zouti Admin".

Dezenstalasyon sèvè CSM la

Pou dezenstale sèvè CSM la nan sistèm lame a, kouri script sa a nan sistèm lame a. Script sa a se
menm script enstalasyon ke ou telechaje pi bonè ak: curl -Ls
https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O enstale sèvè CSM la.

$ ./install.sh –uninstall
20-02-25 15:36:32 AVI CSM Sipèvizè Script demaraj: /usr/sbin/csm-supervisor
20-02-25 15:36:32 AVI Script demaraj CSM AppArmor: /usr/sbin/csm-apparmor
20-02-25 15:36:32 AVI CSM Config file: /etc/csm.json
20-02-25 15:36:32 AVI Dosye Done CSM: /usr/share/csm
20-02-25 15:36:32 AVI Sèvis Sipèvizè CSM: /etc/systemd/system/csm-supervisor.service
20-02-25 15:36:32 AVI CSM AppArmor Sèvis: /etc/systemd/system/csm-apparmor.service
20-02-25 15:36:32 AVÈTISMAN Kòmandman sa a pral EFASE tout kontenè CSM yo ak done pataje yo.
katab soti nan lame a
Èske w sèten ou vle kontinye [wi|Non]: wi
20-02-25 15:36:34 ENFO CSM dezenstalasyon kòmanse
20-02-25 15:36:34 ENFO Retire Script demaraj Sipèvizè
20-02-25 15:36:34 ENFO Retire AppArmor Startup Script
20-02-25 15:36:34 ENFO Sispann csm-supervisor.service
20-02-25 15:36:35 ENFO Enfim csm-supervisor.service
20-02-25 15:36:35 ENFO Retire csm-supervisor.service
20-02-25 15:36:35 ENFO Sispann csm-apparmor.service
20-02-25 15:36:35 ENFO Retire csm-apparmor.service
20-02-25 15:36:35 ENFO Retire kontenè CSM Docker
20-02-25 15:36:37 ENFO Retire imaj CSM Docker
20-02-25 15:36:37 ENFO Retire rezo pon CSM Docker
20-02-25 15:36:37 ENFO Retire CSM konfigirasyon file: /etc/csm.json
20-02-25 15:36:37 AVÈTISMAN Retire Dosye Done CSM (baz done, mòso bwa, sètifika, plugins,
repozitwa lokal): '/usr/share/csm'
Èske w sèten ou vle kontinye [wi|Non]: wi
20-02-25 15:36:42 ENFO CSM Done Dosye efase: /usr/share/csm
20-02-25 15:36:42 ENFO Sèvè CSM dezenstale avèk siksè

Pandan dezenstalasyon, ou ka sove dosye done CSM la lè w reponn "Non" nan dènye kesyon an. Lè w reponn "Non", ou ka dezenstale aplikasyon CSM la epi re-enstale li ak done yo konsève.

Dokiman / Resous

CISCO Cisco Software Manager Server [pdfGid Itilizatè
Cisco Software Manager Server, Software Manager Server, Manager Server, Server

Referans

Manyèl itilizatè

Gid enstalasyon pou sèvè manadjè lojisyèl Cisco