Uživatelská příručka k serveru Cisco Software Manager

Společnost Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-SÍTĚ (6387)
Fax: 408 527-0883

Předmluva

Poznámka

Tento produkt dosáhl stavu konce životnosti. Pro více informací viz Oznámení o ukončení životnosti a ukončení prodeje

Tato příručka popisuje, jak nainstalovat server Cisco Software Manager (CSM).

Publikum, na straně iii
Změny tohoto dokumentu, na straně iii

Získání dokumentace a odeslání požadavku na službu, na straně iii

Publikum

Tato příručka je určena pro osoby odpovědné za instalaci serveru Cisco Software Manager 4.0 a systémové administrátory směrovačů Cisco.

Tato publikace předpokládá, že čtenář má dostatečné znalosti o instalaci a konfiguraci hardwaru založeného na směrovačích a přepínačích. Čtenář musí být také obeznámen s elektronickými obvody a postupy zapojení a musí mít zkušenosti jako elektronický nebo elektromechanický technik.

Změny tohoto dokumentu

Tato tabulka uvádí technické změny, které byly v tomto dokumentu provedeny od doby, kdy byl poprvé vyvinut.

Tabulka 1: Změny tohoto dokumentu

Datum	Shrnutí
dubna 2020	První vydání tohoto dokumentu.

Získání dokumentace a odeslání požadavku na službu

Pro následující účely viz Co je nového v dokumentaci produktu Cisco na adrese: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

Získání informací o získání dokumentace pomocí nástroje Cisco Bug Search Tool (BST)
Odeslání servisního požadavku

Shromažďování dalších informací

Přihlaste se k odběru Co je nového v dokumentaci k produktu Cisco. Tento dokument uvádí veškerou novou a revidovanou technickou dokumentaci Cisco jako zdroj RSS a dodává obsah přímo na vaši plochu pomocí aplikace pro čtení. Informační kanály RSS jsou bezplatná služba a Cisco v současné době podporuje RSS verze 2.0.

KAPITOLA `1

O serveru Cisco Software Manager Server

Tato kapitola poskytuje konecview serveru CiscoSoftware Manager. Tato kapitola také uvádí omezení jeho instalace.

Úvod, na straně 1
Omezení na straně 2

Zavedení

Server CiscoSoftware Manager (CSM) je a web-založený automatizační nástroj. Pomáhá vám spravovat a současně
naplánovat aktualizace údržby softwaru (SMU) a aktualizace Service Pack (SP) na více směrovačích. Poskytuje doporučení, která snižují námahu při ručním vyhledávání, identifikaci a analýze SMU a SP, které jsou pro zařízení vyžadovány. SMU je oprava chyby. SP je sbírka malých a středních podniků sdružených v jednom file.

Chcete-li poskytnout doporučení, musíte server CSM připojit přes internet k doméně cisco.com. CSM je navržen pro připojení více zařízení a poskytuje SMU a správu SP pro více platforem a verzí Cisco IOS XR.

Platformy, které jsou podporovány na CSM, jsou:

IOS XR (ASR 9000, CRS)

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

IOS (ASR901)

Od verze 4.0 dále existuje několik kontejnerů Docker, které tvoří architekturu CSM. Tyto nádoby jsou:

CSM
Databáze
Vedoucí

Instalace CSM serveru přes Docker je snadná. Můžete upgradovat na nejnovější verzi serveru CSM kliknutím na tlačítko aktualizace na domovské stránce serveru CSM

Omezení

Následující omezení platí s ohledem na instalaci serveru CSM:

Tato instalační příručka se nevztahuje na žádné verze serveru CSM před verzí 4.0.
Server CSM by měl být schopen se připojit k Cisco.com a dostávat upozornění na nejnovější dostupné aktualizace.

KAPITOLA 2

Předinstalační požadavky

Tato kapitola poskytuje informace o hardwaru a softwaru, které potřebujete k instalaci serveru CSM.

Hardwarové požadavky, na straně 3
Softwarové požadavky, na straně 3

Hardwarové požadavky

Minimální hardwarové požadavky pro instalaci CSM serveru 4.0 jsou:

2 CPU
8 GB RAM
30 GB HDD

Poznámka

U velkých sítí doporučujeme zvýšit počet CPU, aby bylo možné spustit více operací síťové instalace současně.

Můžete upravit místo na pevném disku pro ukládání obrázků a balíčků a protokolů z operací.

Softwarové požadavky

Softwarové požadavky pro instalaci serveru CSM 4.0 jsou:

systemd distribuce Linuxu s Dockerem

Konfigurace Docker Proxy (volitelné)
Firewall (volitelné)

systemd

Chcete-li nainstalovat server CSM, musíte použít systemd. Jedná se o sadu, která poskytuje stavební bloky pro vytváření různých operačních systémů Linux. Další podrobnosti o systemd viz Wikipedie.

Než budete pokračovat v instalaci serveru CSM 4.0, ujistěte se, že splňujete následující požadavky:

K instalaci serveru CSM potřebujete oprávnění root, protože konfigurace serveru CSM je uložena v souboru /etc/csm.json file. Instalační proces vytvoří službu systemd pro její automatické spuštění. Chcete-li získat práva root, spusťte instalační skript jako uživatel root nebo jako uživatel s přístupem k programu sudo.
Ujistěte se, že jste Docker nainstalovali na hostitelský operační systém. Více informací viz
https://docs.docker.com/install/. Cisco doporučuje používat Ubuntu, CentOS nebo Red Hat Enterprise Linux jako hostitelský operační systém se serverem CSM 4.0. CSM funguje s Docker Community Edition (CE) a Docker Enterprise Edition (EE)

Přístavní dělník

Server CSM funguje s Docker Community Edition (CE) i Docker Enterprise Edition (EE). Další informace naleznete v oficiální dokumentaci Docker, https://docs.docker.com/install/overview/.

K instalaci serveru CSM použijte Docker 19.03 nebo novější verze. Ke kontrole verze Dockeru můžete použít následující příkaz:

$ verze dockeru
Klient: Docker Engine – Community
Verze: 19.03.9
Verze API: 1.40
Go verze: go1.13.10
Git commit: 9d988398e7
Vyrobeno: Pá 15. května 00:25:34 2020
OS/Arch: linux/amd64
Experimentální: nepravdivé

Server: Docker Engine – Community
Motor:

Verze: 19.03.9
Verze API: 1.40 (minimální verze 1.12)
Go verze: go1.13.10
Git commit: 9d988398e7
Vyrobeno: Pá 15. května 00:24:07 2020
OS/Arch: linux/amd64
Experimentální: nepravdivé
v kontejnerech:
Verze: 1.2.13
GitCommit: 7ad184331fa3e55e52b890ea95e65ba581ae3429
runc:
Verze: 1.0.0-rc10
GitCommit: dc9208a3303feef5b3839f4323d9beb36df0a9dd
docker-init:
Verze: 0.18.0
GitCommit: fec3683

Konfigurace Docker Proxy (volitelné)
Pokud nainstalujete server CSM za HTTPS proxy, napřample, v podnikovém nastavení musíte nakonfigurovat službu Docker systemd file následovně:

Vytvořte drop-in adresář systemd pro službu docker:
$ sudo mkdir -p /etc/systemd/system/docker.service.d
Vytvořte a file s názvem /etc/systemd/system/docker.service.d/https-proxy.conf, který přidává proměnnou prostředí HTTPS_PROXY. Tento file umožňuje démonovi Docker stáhnout kontejnery z úložiště pomocí HTTPS proxy:
[Service] Environment=”HTTPS_PROXY=http://proxy.example.com:443/”
Poznámka
Je běžné, že proměnná prostředí HTTPS_PROXY používá velká písmena a proxy URL začíná http:// a ne https://.
Znovu načtěte změny konfigurace:
$ sudo systemctl daemon-reload

Restartujte Docker:
$ sudo systemctl restart docker
Ověřte, že jste načetli konfiguraci:
$ systemctl show –property=Ukotvitelný panel prostředí
Prostředí=HTTPS_PROXY=http://proxy.example.com:443/

Ověřte konfiguraci Dockeru

Chcete-li zkontrolovat, zda jste správně nainstalovali Docker a ujistit se, že je v provozu, použijte následující příkaz:

$ systemctl is-active docker
aktivní

Chcete-li ověřit, zda jste správně nakonfigurovali démona Docker a zda je Docker schopen stáhnout obrázky z úložiště a je schopen spustit testovací kontejner; použijte následující příkaz:

$ docker run –rm hello-world
Lokálně nelze najít obrázek 'hello-world:latest'
nejnovější: Vytahování z knihovny/hello-světa
d1725b59e92d: Vytažení dokončeno
Strávit: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
Postavení: Stažen novější obrázek pro hello-world:latest

Zdravíme vás z Dockeru!
Tato zpráva ukazuje, že vaše instalace zřejmě funguje správně.
K vygenerování této zprávy provedl Docker následující kroky:

Klient Docker kontaktoval démona Docker.

Démon Docker stáhl obrázek „hello-world“ z centra Docker. (amd64)
Démon Docker vytvořil z tohoto obrazu nový kontejner, který spouští spustitelný soubor, který vytváří výstup, který právě čtete.
Démon Docker streamoval tento výstup do klienta Docker, který jej odeslal do vašeho terminálu.

Chcete-li vyzkoušet něco ambicióznějšího, můžete spustit kontejner Ubuntu s:
$ docker run -it ubuntu bash

Sdílejte obrázky, automatizujte pracovní postupy a další pomocí bezplatného Docker ID:
https://hub.docker.com/

Pro více exampinformace a nápady, navštivte:
https://docs.docker.com/get-started/

Firewall (volitelné)

CSM server může běžet společně s Firewallem. Firewalld je poskytován v následujících distribucích Linuxu jako výchozí nástroj pro správu brány firewall:

RHEL 7 a novější verze
CentOS 7 a novější verze

Fedora 18 a novější verze
SUSE 15 a novější verze
OpenSUSE 15 a novější verze

Před spuštěním CSM s firewallem proveďte následující:

Spusťte příkaz IP address a poté přesuňte rozhraní eth0, což je naše externí rozhraní pro CSM, do „externí“ zóny.
$ IP adresa
1: lo: mtu 65536 qdisc noqueue state UNKNOWN výchozí skupina qlen
1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 rozsah hostitele lo
valid_lft navždy preferovaný_lft navždy
hostitel rozsahu inet6 ::1/128
valid_lft navždy preferovaný_lft navždy
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 rozsah globální dynamický eth0
valid_lft 84864sec přednost_lft 84864sec
inet6 fe80::a00:27ff:fef5:d83b/64 scope link
valid_lft navždy preferovaný_lft navždy
$ sudo firewall-cmd –permanent –zone=external –change-interface=eth0
Poznámka
Ve výchozím nastavení je rozhraní eth0 ve veřejné zóně. Přesunutí do externí zóny umožňuje maskování pro externí připojení ke kontejnerům CSM dockerů
Povolit příchozí provoz na portu 5000 na TCP, protože port 5000 je výchozí port web rozhraní CSM serveru
Poznámka
Na některých systémech musíte přesunout rozhraní „br-csm“ do „důvěryhodné“ zóny. Rozhraní br-csm je interní mostové rozhraní, které je vytvořeno CSM a používá se pro komunikaci mezi kontejnery CSM. Toto rozhraní nemusí existovat před instalací CSM. Ujistěte se však, že jste před procesem instalace CSM spustili následující příkaz:
$ sudo firewall-cmd –permanent –zone=důvěryhodný –change-interface=br-csm

Znovu načtěte démona brány firewall s novou konfigurací
$ sudo firewall-cmd – znovu načíst
Poznámka
Pokud jste Docker nainstalovali před instalací firewallu, restartujte démona dockeru po provedení změn firewallu.
Poznámka
Pokud používáte jinou firewallovou aplikaci kromě firewalld, nakonfigurujte ji podle potřeby a otevřete port 5000 na TCP pro jakýkoli příchozí provoz.

KAPITOLA 3

Instalace serveru CSM

Tato kapitola poskytuje informace o postupu instalace a odinstalace CSM serveru. Tato kapitola také popisuje, jak otevřít stránku serveru CSM.

Postup instalace, na straně 9
Otevření stránky serveru CSM, na straně 10
Odinstalace serveru CSM, na straně 11

Postup instalace

Chcete-li stáhnout nejnovější informace o aktuálně zveřejněných softwarových balíčcích a SMU, server CSM vyžaduje připojení HTTPS k webu Cisco. Server CSM také pravidelně kontroluje, zda není k dispozici novější verze samotného CSM.

Chcete-li nainstalovat server CSM, spusťte následující příkaz ke stažení a spuštění instalačního skriptu: $ bash -c “$(curl -sL

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

Poznámka
Namísto stahování a spouštění skriptu můžete také zvolit stažení následujícího skriptu bez jeho spuštění. Po stažení skriptu jej můžete v případě potřeby ručně spustit s některými dalšími možnostmi:

$ curl -Ls https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O $ chmod +x install.sh $ ./install.sh –help Instalační skript CSM Server: $ ./ install.sh [MOŽNOSTI] Možnosti: -h Tisk nápovědy -d, –data
Vyberte adresář pro sdílení dat – bez výzvy Neinteraktivní režim – suchý běh Suchý běh. Příkazy se neprovádějí. – https-proxy URL Použijte HTTPS proxy URL –odinstalovat Odinstalovat CSM Server (Odstranit všechna data)

Poznámka
Pokud skript nespustíte jako uživatel „sudo/root“, budete vyzváni k zadání hesla „sudo/root“.

Otevření stránky serveru CSM

Pomocí následujících kroků otevřete stránku serveru CSM:

SOUHRNNÉ KROKY

Pomocí tohoto otevřete stránku serveru CSM URL: http://:5000 na a web browser, kde „server_ip“ je IP adresa nebo název hostitele linuxového serveru. Server CSM používá port TCP 5000 k poskytování přístupu ke grafickému uživatelskému rozhraní (GUI) serveru CSM.

Přihlaste se k serveru CSM pomocí následujících výchozích přihlašovacích údajů.

PODROBNÉ KROKY

	Příkaz nebo Akce	Účel
Krok 1	Pomocí tohoto otevřete stránku serveru CSM URL:http:// :5000 v a web browser, kde „server_ip“ je IP adresa nebo název hostitele linuxového serveru. Server CSM používá port TCP 5000 k poskytování přístupu ke grafickému uživatelskému rozhraní (GUI) serveru CSM	Poznámka Instalace a spuštění stránky serveru CSM trvá přibližně 10 minut.
Krok 2	Přihlaste se k serveru CSM pomocí následujících výchozích přihlašovacích údajů.	Uživatelské jméno: root • Heslo: root
		Poznámka Společnost Cisco důrazně doporučuje změnit výchozí heslo po prvním přihlášení.

Co dělat dál
Chcete-li získat další informace o používání serveru CSM, klikněte na Nápověda v horní liště GUI serveru CSM a vyberte „Nástroje pro správu“.

Odinstalování serveru CSM

Chcete-li odinstalovat server CSM z hostitelského systému, spusťte v hostitelském systému následující skript. Tento skript je
stejný instalační skript, který jste si dříve stáhli pomocí: curl -Ls
https://devhub.cisco.com/artifactory/software-manager-install-group/install.sh -O pro instalaci serveru CSM.

$ ./install.sh –odinstalovat
20-02-25 15:36:32 UPOZORNĚNÍ Spouštěcí skript správce CSM: /usr/sbin/csm-supervisor
20-02-25 15:36:32 UPOZORNĚNÍ CSM AppArmor Startup Script: /usr/sbin/csm-apparmor
20-02-25 15:36:32 UPOZORNĚNÍ CSM Config file: /etc/csm.json
20-02-25 15:36:32 UPOZORNĚNÍ Složka dat CSM: /usr/share/csm
20-02-25 15:36:32 UPOZORNĚNÍ Služba CSM Supervisor: /etc/systemd/system/csm-supervisor.service
20-02-25 15:36:32 UPOZORNĚNÍ Služba CSM AppArmor: /etc/systemd/system/csm-apparmor.service
20-02-25 15:36:32 VAROVÁNÍ Tento příkaz SMAŽE všechny kontejnery CSM a sdílená data
složku z hostitele
Jste si jisti, že chcete pokračovat [ano|Ne]: ano
20-02-25 15:36:34 INFO Odinstalace CSM zahájena
20-02-25 15:36:34 INFO Odebrání spouštěcího skriptu správce
20-02-25 15:36:34 INFO Odebrání AppArmor Startup Script
20-02-25 15:36:34 INFO Zastavení služby csm-supervisor.service
20-02-25 15:36:35 INFO Deaktivace csm-supervisor.service
20-02-25 15:36:35 INFO Odebírání csm-supervisor.service
20-02-25 15:36:35 INFO Zastavení csm-apparmor.service
20-02-25 15:36:35 INFO Odebírání csm-apparmor.service
20-02-25 15:36:35 INFO Odstranění kontejnerů CSM Docker
20-02-25 15:36:37 INFO Odebírání obrázků CSM Docker
20-02-25 15:36:37 INFO Odstranění sítě CSM Docker bridge
20-02-25 15:36:37 INFO Odebírání CSM config file: /etc/csm.json
20-02-25 15:36:37 VAROVÁNÍ Odebírání datové složky CSM (databáze, protokoly, certifikáty, plugins,
místní úložiště): '/usr/share/csm'
Jste si jisti, že chcete pokračovat [ano|Ne]: ano
20-02-25 15:36:42 INFO Složka dat CSM smazána: /usr/share/csm
20-02-25 15:36:42 INFO CSM Server byl úspěšně odinstalován

Během odinstalace můžete uložit datovou složku CSM tak, že na poslední otázku odpovíte „Ne“. Odpovědí „Ne“ můžete aplikaci CSM odinstalovat a poté ji znovu nainstalovat se zachovanými daty

Dokumenty / zdroje

CISCO Server Cisco Software Manager [pdfUživatelská příručka
Cisco Software Manager Server, Software Manager Server, Manager Server, Server

Reference

Uživatelská příručka

Instalační příručka pro Cisco Software Manager Server