Gestore di u flussu di travagliu incruciatu
“
Specificazioni
- Nome di u produttu: Dispositivu di soluzioni Cisco Crosswork Workflow Manager
Onboarding - Funziunalità: Integrazione di u dispusitivu è zero-touch
pruvisione - Compatibilità: Cisco Crosswork Workflow Manager (CWM) è Cisco
Orchestratore di Servizi di Rete (NSO)
Istruzzioni per l'usu di u produttu
Pacchettu d'integrazione di u dispusitivu finituview
U pacchettu di Device Onboarding hè cuncipitu per furnisce à distanza
dispositivi di rete installendu l'immagine di avvio è u ghjornu iniziale 0
cunfigurazione. Utilizza l'applicazione Cisco-ZTP per questu
scopu.
Prerequisiti di integrazione di u dispositivu
Prima di principià u prucessu d'integrazione di u dispusitivu, assicuratevi di
avè l'intenzione ZTP necessaria catturata è l'API di u cliente DO
cunfiguratu. I mudelli di dati DO aiutanu à creà basati nantu à i roli
ZTP-profiles per ogni dispusitivu.
Prucessu d'integrazione di u dispusitivu
- Crea ZTP profiles cù cunfigurazioni di ghjornu 0 è opzionale
paràmetri di l'imagine di u software. - Assucià u ZTP profiles cù dispusitivi chì utilizanu un mudellu di serviziu
chjamata mappa, chì specifica identificatori unichi cum'è numeri seriali
numeri. - Monitorà u prugressu di l'integrazione di u dispusitivu cù u serviziu di mappa ZTP
dati di u pianu.
Flussu d'integrazione di u dispusitivu
U prucessu ZTP implica u scaricamentu è l'esecuzione di un bootstrap
file nantu à i dispusitivi supportati cum'è Cisco IOS XR, IOS XE, è Nexus. U
bootstrap file pò esse un script simplice o un script più cumplessu per
Implementazioni di suluzioni Cisco-ZTP.
FAQ
D: Chì sò i prerequisiti per aduprà l'Integrazione di u Dispositivu
pacchettu?
A: Assicuratevi chì l'intenzione ZTP sia catturata, l'API di u cliente DO sò
cunfigurati, è mudelli di dati necessarii per creà ZTP profiles sò
in locu.
D: Quali dispositivi sò supportati per l'integrazione di dispositivi cù questu
pacchettu?
A: I dispusitivi supportati includenu Cisco IOS XR, IOS XE è Nexus
dispusitivi chì ponu eseguisce script bash, script python, o cumandamenti iOS
files cum'è bootstrap files.
"'
Onboarding di u dispositivu
Prefazione
Questa sezione cuntene i seguenti temi:
· Prefazione, à pagina 1 · Soluzioni Cisco Crosswork Workflow Manager, à pagina 1 · Pacchettu di Onboarding di u Dispositivu, à pagina 2 · Onboarding di u Dispositivu (DO) è Zero-Touch Provisioning (ZTP), à pagina 2 · Example: Aduprà l'integrazione di u dispositivu per integrà un dispositivu di rete, à pagina 13
Astrattu
Stu documentu hè a guida di l'utente per a versione autonoma di u pacchettu di integrazione di u dispositivu Cisco Crosswork Workflow Manager Solutions.
Audience
Stu documentu descrive cumu cunfigurà è aduprà l'integrazione di i dispositivi di Crosswork Workflow Manager Solutions. Stu documentu hè destinatu à i sviluppatori di Cisco Advanced Services, l'ingegneri di rete è l'ingegneri di sistema chì cunfiguranu è furniscenu e funzionalità di Crosswork Workflow Manager Solutions à i clienti Cisco.
Documentazione addiziale
Questa ducumentazione richiede à u lettore una bona cunniscenza di Cisco Crosswork è Cisco NSO è di u so usu, cum'è descrittu in a ducumentazione Cisco. Per più infurmazioni nantu à i prudutti NSO, andate à: https://developer.cisco.com/docs/nso/.
Soluzioni di Gestione di Flussu di Lavoro Cisco Crosswork
CWM Solutions hè una cullezzione di casi d'usu cumuni cuncipiti per fà e persunalizazione di u campu simplici è dirette. Hè custruitu cù Cisco Crosswork Workflow Manager (CWM) è Cisco Network Services.
Integrazione di u dispusitivu 1
Pacchettu d'integrazione di u dispusitivu
Onboarding di u dispositivu
Orchestrator (NSO). Stu documentu spiega cumu aduprà u casu d'usu Device Onboarding per migliurà l'efficienza è a velocità cù a quale si integranu i novi dispositivi di rete. Nota: Cliccate nantu à sti ligami per più infurmazioni nantu à l'usu di Cisco CWM è Cisco NSO.
Pacchettu d'integrazione di u dispusitivu
U casu d'usu di CWM Solutions Device Onboarding hè un pacchettu funzionale chì utilizza l'applicazione Cisco-ZTP per furnisce à distanza i dispositivi di rete installendu l'immagine di avvio è a cunfigurazione iniziale di u ghjornu 0.
Integrazione di u Dispositivu (DO) è Provisioning Zero-Touch (ZTP)
L'applicazione Device Onboarding (DO) usa Cisco Zero-Touch Provisioning (ZTP). ZTP automatizza l'installazione è l'aghjurnamentu di l'imagine di u software è ancu l'installazione di a cunfigurazione di u ghjornu 0. files mentre si implementanu dispositivi Cisco o di terze parti per a prima volta. A suluzione Cisco-ZTP offre flessibilità supportendu una varietà di dispositivi, cumpresi Cisco IOS XR, IOS XE è Nexus. A suluzione Cisco-ZTP aduprata in DO comprende quattru cumpunenti: un servitore DHCP, un client (script ZTP), un servitore HTTP è un pacchettu di funzioni NSO. Nota: Tutti i cumpunenti devenu esse installati è cunnessi à u dispositivu. Per i dettagli, vede Prerequisiti di integrazione di u dispositivu.
Prerequisiti di integrazione di u dispositivu
Per chì l'Onboarding di i Dispositivi funziona currettamente, questi prerequisiti devenu esse presenti è funzionali. · Dispositivi abilitati cù ZTP. · Dispositivi capaci di eseguisce script Python o Shell cum'è parte di u prucessu ZTP. · Connettività di rete da i dispositivi à i servitori NSO, DHCP è HTTP/TFTP. · U spaziu di l'indirizzu IP hè sufficiente per accoglie tutti i dispositivi necessarii. · U DHCP hè cunfiguratu per rilevà u tipu di dispositivu è furnisce a pusizione adatta di u script di l'agente di u dispositivu. · Versione minima NSO 6.1 o superiore. · U pacchettu DO (Cisco-ztp) hè installatu nantu à NSO. · Script Python o Shell sò dispunibili, unu per ogni tipu di dispositivu ZTP, chì implementanu i callback DO (Cisco-ZTP), l'aghjurnamentu di l'immagine di u dispositivu è a cunfigurazione Day-0. · (Opzionale) I pacchetti NED sò dispunibili per l'onboarding di i dispositivi.
Pacchettu di Funzioni d'Integrazione di u Dispositivu
U pacchettu funziunale Cisco Device Onboarding (DO) definisce l'interfaccia per catturà l'intenzione ZTP è l'API per l'interazzione di u cliente DO (script di bootstrap in esecuzione nantu à u dispusitivu). I mudelli di dati DO vi permettenu di custruisce un catalogu di ZTP-pro basati nantu à i roli.files chì catturanu ognunu u ghjornu-0, l'imagine di u software (opzionale), è
Integrazione di u dispusitivu 2
Onboarding di u dispositivu
Cumpunenti di u Pacchettu
paràmetri integrati di u dispusitivu. Quessi prufileI sò tandu assuciati à u dispusitivu per mezu di un mudellu di serviziu chjamatu mappa. Ogni entrata di mappa deve specificà qualchì infurmazione identificabile in modu unicu di u dispusitivu (per esempiuampie, un numeru di serie) inseme cù u ZTP-profile utilizatu per u dispusitivu. L'ID unicu vi permette di verificà è validà u dispusitivu quandu aduprate i punti finali di l'API NSO ZTP. U pacchettu funzionale DO monitorizza u prugressu di un dispusitivu è pò esse monitoratu aduprendu i dati di u pianu di serviziu di mappa ZTP.
Cumpunenti di u Pacchettu
· Template di ghjornu 0: Quandu create un mudellu di ghjornu 0 file, ci sò quattru variabili chì sò pupulate automaticamente cù valori specifici elencati quì. Vede u mudellu Day-0. · DEV_CUSTOMER_USERNAME
· PASSWORD_CLIENTE_DI_SVILUPPU
· DEV_CUSTOMER_ENABLED_PASSWORD
· INDIRIZZU_IP_GISTIONE
Nota: E variabili DEV_CUSTOMER_ENABLED_PASSWORD è MGMT_IP_ADDRESS dipendenu da u ZTP profile, a dispunibilità di e variabili management-ip-address è sec-password.
· Gruppu d'autentificazione: U gruppu d'autentificazione hè necessariu per cunnettassi à NSO.
· Impostazioni di integrazione di u dispositivu: Queste impostazioni sò verificate è validate durante u prucessu di integrazione.
· (Opzionale) Imagine di u Software: U software stessu chì esegue u dispusitivu.
Flussu d'integrazione di u dispusitivu
L'integrazione di u dispusitivu cù u flussu di l'agente Cisco-ZTP hà trè fasi. · Ottenimentu di l'infurmazioni Bootstrap: U dispusitivu emette una dumanda à u servitore DHCP per ottene a pusizione (URL) di u bootstrap file (script). U dispusitivu scarica è esegue tandu u script.
· Verificazione di a Cunfurmità di l'Imagine è/o di l'Aghjurnamentu: Una volta chì u bootstrap hè statu iniziatu file (script) hè statu eseguitu, a cunfigurazione hè applicata à u dispusitivu sia cù una nova cunfigurazione (s'ellu hè statu aghjuntu di recente) sia cù l'aghjurnamentu di u dispusitivu esistente.
· Validazione è applicazione di a nova cunfigurazione (ghjornu 0): A cunfigurazione hè tandu sottumessa à prucessi di verificazione è validazione basati annantu à u rolu ZTP.
Nota: U bootstrap file pò esse un script simplice chì applica una cunfigurazione di ghjornu 0 o un script elaboratu chì agisce cum'è un cliente di suluzione Cisco-ZTP. Di solitu, u script file hè più adattatu per l'implementazioni di suluzioni Cisco-ZTP.
Integrazione di u dispusitivu 3
Flussu d'integrazione di u dispusitivu
Onboarding di u dispositivu
U prucessu ZTP scarica u file è l'esegue. I dispusitivi Cisco IOS XR, IOS XE è Nexus supportanu bash, script python è un file chì cuntene cumandamenti iOS cum'è bootstrap fileNota: U bootstrap file pò esse un script simplice chì applica una cunfigurazione di ghjornu 0 o un script elaboratu chì agisce cum'è un cliente di suluzione Cisco-ZTP. Di solitu, u script file hè più adattatu per l'implementazioni di soluzioni DO (Cisco-ZTP).
Integrazione di u dispusitivu 4
Onboarding di u dispositivu
Cumu funziona l'integrazione di u dispositivu
Cumu funziona l'integrazione di u dispositivu
Questa sezione descrive cumu funziona l'Onboarding di u Dispositivu. A prossima sezione vi guida à traversu i Passi per l'Onboarding di un Dispositivu Gestitu.
Template di u ghjornu 0
U mudellu di ghjornu 0 hè un mudellu di cunfigurazione riutilizzabile cù parechje variabili placeholder. I valori per queste variabili facenu parte di u prufile definizione. Stu mudellu vi permette di riutilizà e cunfigurazioni di u ghjornu 0 per altri prughjetti d'integrazione di i dispositivi. I valori di i placeholder sò definiti durante u serviziu di mappa ZTP (e variabili di placeholder sò specifiche di u dispositivu è sò incluse in u ZTP-profile) quandu create a mappa ZTP. Quessi fattori vi danu un cuntrollu più grande nantu à cumu un mudellu di cunfigurazione di ghjornu 0 hè resu per un dispositivu datu.
Questu hè cum'èample di un mudellu di ghjornu 0 per un dispusitivu Cisco IOX XR.
ncs0-ghjornu540 !! nome d'utilizatore IOS XR ${DEV_CUSTOMER_USERNAME} gruppu root-lr password 0 ${DEV_CUSTOMER_PASSWORD} ! nome di l'ospite ${HOST_NAME} ! vrf Mgmt-intf famiglia d'indirizzi ipv0 unicast ! nome di duminiu cisco.com servitore di nomi di duminiu ricerca di duminiu interfaccia-surgente MgmtEth4/RP0/CPU0/0 interfaccia MgmtEth0/RP0/CPU0/0 indirizzu ipv0 ${MGMT_IP_ADDRESS} 4
! router indirizzu staticu famiglia-ipv4 unicast
0.0.0.0/0
! ! ! servitore ssh v2 servitore ssh vrf Mgmt-intf
Integrazione di u dispusitivu 5
Pool di risorse
Onboarding di u dispositivu
Pool di risorse
ZTP usa risorse IP chì sò raggruppate in un pool cumunu chjamatu pool di risorse. Un pool di risorse hè cunfiguratu cù un indirizzu IP o una sotturete. U pool di risorse usa u pacchettu resource-manager in NSO per assignà l'indirizzi IP.
U gestore di risorse furnisce un serviziu di mappa ZTP chì gestisce l'assegnazione di l'indirizzu IP di gestione. Pudete ancu sceglie di furnisce esplicitamente l'indirizzu IP di gestione nantu à u serviziu di mappa ZTP per un dispositivu datu. In i dui casi, l'applicazione ZTP pupula automaticamente a variabile placeholder MGMT_IP_ADDRESS mentre rende a cunfigurazione di u ghjornu 0 per un dispositivu.
Nota: Un pool di risorse hè necessariu solu quandu si usa un indirizzu IP dinamicu. Sè vo aduprate un indirizzu IP staticu, a variabile di u pool di risorse ùn hè micca necessaria. Per i dettagli, riferitevi à Caricà u pool di risorse (Passu 6).
Profiles è infurmazione di a carta di serviziu
U ProfileU catalogu cuntene un inseme di parametri di cunfigurazione, cum'è u ghjornu 0 files, i paràmetri d'integrazione di u dispusitivu è a versione di u software applicata à i dispusitivi. A suluzione d'integrazione di u dispusitivu associa u ZTP-profiles cù i dispusitivi chì utilizanu a mappa di serviziu. A mappa cuntene l'infurmazioni necessarie è applica queste informazioni à u dispusitivu durante u prucessu di Device Onboarding (DO). Ogni entrata di mappa cuntene alcune informazioni uniche identificabili di u dispusitivu inseme cù u ZTP-profile utilizatu per u dispusitivu. I dati di u pianu di serviziu di mappa mostranu u prugressu di u dispusitivu.
A versione di u software di u sistema operativu è i dettagli di l'imagine definiti in u ZTP-profile sò dispunibili per u script di u cliente ZTP per paragunà a versione di u software è inizià l'aghjurnamentu di l'immagine. U pacchettu ZTP ùn processa nè usa l'infurmazioni di u sistema operativu cunfiguratu. Una volta chì u prucessu ZTP hè cumpletu, u serviziu di mappa ZTP integra i dispositivi in l'arburu di dispositivi NSO per cuntinuà à cunfigurà i dispositivi cù qualsiasi suluzione di pacchetti di funzioni principali dispunibili.
Per integrà u dispusitivu, l'attributu gestitu in u profile deve esse impostu à veru, vede u passu 8 Caricà u serviziu (Mappa), è u tipu di dispusitivu (NED, portu è gruppu d'autentificazione) deve ancu esse impostu. S'ellu ùn ci hè micca una impostazione di gruppu d'autentificazione sottu à u tipu di dispusitivu, allora l'attributi nome d'utilizatore, password è password sec devenu esse furniti.
Bootstrap d'integrazione di u dispusitivu
U pacchettu Device Onboarding definisce duie API d'azione di callback per l'interazioni Device Onboarding-client. L'azione di callback get-bootstrap-data restituisce a cunfigurazione di bootstrapping, a cunfigurazione di u ghjornu 0 generata per u dispusitivu è l'infurmazioni di l'immagine di u sistema operativu cum'è cunfigurate nantu à u ZTP-pro.fileU script di u cliente di Device Onboarding processa tandu i dettagli di l'imagine di u sistema operativu è applica a cunfigurazione di u ghjornu 0 à u dispusitivu.
Durante u prucessu di bootstrap, u script Device Onboarding-client segnala u prugressu aduprendu l'azione di callback report-progress. L'azzioni get-bootstrap-data è report-progress devenu cuntene l'identificatore unicu di u dispusitivu. A chjama API get-bootstrap-data include ancu: u venditore di u dispusitivu, u mudellu, u nome di u sistema operativu è a versione di u sistema operativu. In listessu modu, a chjama API report-progress include un missaghju facultativu.
Sè e cunfigurazioni di u pool di risorse di gestione è di l'indirizzu IP di gestione esplicita ùn sò micca impostate è u Device Onboarding-profile definisce u dispusitivu cum'è gestitu, u script Device Onboarding-client deve recuperà l'indirizzu IP di gestione da u dispusitivu è publicallu in NSO per mezu di a richiamata di l'azione report-progress.
Questu hè cum'èample di u script di richiamata get-bootstrapping-data.
curl -i -u ztpclient:topsecret -H “Tipu di cuntenutu: applicazione / dati yang + json” -X POST -d '{“input”:{ “modellu” : “CSR1KV”, “nome di u sistema operativu” : “cisco-ioxr”, “venditore” : “Cisco”, “id unicu” : “AAO124GF”, “versione di u sistema operativu” : “12.1”}}'
Integrazione di u dispusitivu 6
Onboarding di u dispositivu
Passi per l'integrazione di un dispositivu gestitu
http://nsoztpserver:8090/restconf/operations/cisco-ztp:ztp/classic/get-bootstrapping-data
<< Corpu di a risposta >> { "cisco-ztp:output": { "bootstrap-information": { "boot-image": { "os-name": "cisco-ioxr", "os-version": "12.3", "download-uri": "http://sample.domain/8894-235/ios-xr12.3.tar.gz”, “md5-hash-value”: “195b174c9a13de04ca44f51c222d14b0” }, “day-0-configuration”: “!! IOS XRnusername adminn gruppu root-lrn password 0 adminn!nhostname xr_2n!nvrf Mgmt-intfn address-family ipv4 unicastn!ninterface MgmtEth0/RSP0/CPU0/0n vrf Mgmt-intfn ipv4 address 192.168.20.1 255.255.255.0n!nrouter staticn vrf Mgmt-intfn address- family ipv4 unicastn 0.0.0.0/0 192.168.122.1 110n !n!nssh server v2nssh server vrf Mgmt-intfnn” } } } ** report-progress callback ** curl -i -u ztpclient:topsecret -H “Tipu di cuntenutu: applicazione / dati-yang + json” -X POST -d '{“input” : {“id-unicu”: “AAO124GF”, “tipu di prugressu”: “bootstrap- cumpletu”}}' http://nsoztpserver: 8090 / restconf / operations / cisco-ztp: ztp / classic / report-progress << Intestazione di risposta >> HTTP / 1.1 204 Nisun cuntenutu
Passi per l'integrazione di un dispositivu gestitu
Questa hè a sequenza di passi chì utilizate Device Onboarding per aghjurnà un dispositivu gestitu da NSO utilizendu un indirizzu IP dinamicu o staticu.
PASSI SINTESI
1. Mudificà/Aghjurnà ncs.conf file 2. Creà una Autentificazione Locale (per NSO) 3. Creà un Authgroup 4. Creà una Regola Net Cam file 5. Caricà u Payload d'Onboarding cù u mudellu Day-0 6. Caricà u Pool di Risorse (sè vo aduprate un indirizzu IP dinamicu. Sè vo aduprate un indirizzu IP staticu, saltate u passu 6. 7. Caricà Profile 8. Caricà u serviziu (Mappa). Sè vo aduprate un indirizzu IP staticu chì ùn hè micca gestitu da NSO, saltate u Passu 6, è
caricate una mappa di serviziu separata cù l'indirizzu IP staticu in u Passu 8.
PASSI DETTAGLIATI
Prucedura
Passu 1 Passu 2
Cumanda o Azione Mudificà/Aghjurnà ncs.conf file Creà una autenticazione lucale (per NSO)
Scopu
Integrazione di u dispusitivu 7
Mudificà/Aghjurnà ncs.conf file
Onboarding di u dispositivu
Passu 3 Passu 4 Passu 5 Passu 6
Passu 7 Passu 8
Cumandante o Azzione
Scopu
Crea un gruppu d'autentificazione
Crea una Regola di Net Cam file
Caricà u Caricu d'Integrazione cù u mudellu Day-0
Caricà u Pool di Risorse (sè utilizate un indirizzu IP dinamicu. Sè utilizate un indirizzu IP staticu, saltate u passu 6.
Caricà Profile
Caricà u serviziu (Mappa). Sè vo aduprate un indirizzu IP staticu chì ùn hè micca gestitu da NSO, saltate u Passu 6, è caricate una mappa di serviziu separata cù l'indirizzu IP staticu in u Passu 8.
Mudificà/Aghjurnà ncs.conf file
Aduprate questi sample per aghjurnà a restconf cù un novu portu tcp è l'autentificazione lucale per pudè cunnettassi à NSO. Nota: Questu hèample usa 8080 per u numeru di portu è dopu l'aghjurnamentu file, riavvia nsc.
Aghjunghje un portu tcp (portu predefinitu 8080)
veru veru <8080>
Crea una autenticazione lucale
Autentificazione locale
veru
Crea un gruppu d'autentificazione
Gruppu d'autentificazione predefinitu.xml predefinitu
Integrazione di u dispusitivu 8
Onboarding di u dispositivu
Crea una Regola di Net Cam
Cisco123#
Crea una Regola di Net Cam
65534 65534 /var/ncs/homes/public/.ssh /var/ncs/homes/public nigà nigà nigà ztp ztp ztp azzione-richiama cisco-ztp /cisco-ztp:ztp/cisco-ztp:classic * permessu
">*
Integrazione di u dispusitivu 9
Caricà u Caricu d'Integrazione cù u mudellu Day-0
Onboarding di u dispositivu
Caricà u Caricu d'Integrazione cù u mudellu Day-0
ncs0-ghjornu540 !! nome d'utilizatore IOS XR ${DEV_CUSTOMER_USERNAME} gruppu root-lr password 0 ${DEV_CUSTOMER_PASSWORD} ! nome di l'ospite ${HOST_NAME} ! vrf Mgmt-intf famiglia-indirizzu ipv0 unicast ! nome di duminiu cisco.com servitore-di-nome-di-dominiu 4 ricerca di duminiu interfaccia-source MgmtEth171.70.168.183/RP0/CPU0/0 interfaccia MgmtEth0/RP0/CPU0/0 indirizzu ipv0 ${MGMT_IP_ADDRESS} 4
! router indirizzu staticu famiglia-ipv4 unicast
0.0.0.0/0
! ! ! servitore ssh v2 servitore ssh vrf Mgmt-intf
Caricà u pool di risorse (sè si usa un indirizzu IP dinamicu)
piscina ztp
Integrazione di u dispusitivu 10
Onboarding di u dispositivu
Caricà Profile (per l'indirizzu IP dinamicu di u payload gestitu)
indirizzu_ip_fine>
Caricà Profile (per l'indirizzu IP dinamicu di u payload gestitu)
<profile> ncs540-profilecisco-ioxr 7.10.2 > piscina ztp ncs5-ghjornu0 Cisco540# veru cisco-iosxr-cli-0file>
Nota ProfileI carichi utili di l'indirizzu IP staticu ùn includenu micca u pool di risorse.
<profile> ncs540-profilecisco-ioxr 7.10.2 > ncs5-ghjornu0 veru
Integrazione di u dispusitivu 11
Caricà a mappa di serviziu (indirizzu IP dinamicu)
Onboarding di u dispositivu
cisco-iosxr-cli-7.53file>
Caricà a mappa di serviziu (indirizzu IP dinamicu)
ncs540 FOC2712R3D6file>ncs540-profile</profile> NOME_OSPITE NCS540-2
Caricà a mappa di serviziu (indirizzu IP staticu)
ncs540 FOC2712R3D6file>ncs540-profile</profile> NOME_OSPITE NCS540-2
Cum'è opzione, pudete ancu integrà u dispusitivu nantu à un NSO remoto. Un servitore ZTP NSO hè un servitore gestitu chì hà NSO installatu cù l'applicazione Device Onboarding. Un NSO remoto hè un servitore micca gestitu induve pudete integrà un dispusitivu dopu u prucessu ZTP. Stu servitore NSO alternativu hè utilizatu per l'integrazione di i dispusitivi micca gestiti. L'usu di un servitore NSO micca gestitu segrega e funzioni specifiche di Device Onboarding da a suluzione di rete più larga. Per attivà sta funziunalità, Device Onboarding definisce un mudellu YANG chì cattura u servitore nso remoto.
Integrazione di u dispusitivu 12
Onboarding di u dispositivu
Integrazione di un dispositivu micca gestitu
Integrazione di un dispositivu micca gestitu
A prucedura aduprata per aghjurnà un dispusitivu micca gestitu da NSO hè assai simile à a prucedura per l'integrazione à un servitore gestitu da NSO. L'unica differenza hè di stabilisce a variabile gestita à veru (gestita) o falsu (micca gestita) quandu si scarica u Pro.file. Questu sample mostra a variabile di gestione impostata à falsu per un dispositivu micca gestitu.
<profile> ncs540-profilecisco-ioxr 7.10.2 > piscina ztp ncs5-ghjornu0 Cisco540# falsu cisco-iosxr-cli-0file>
Example: Aduprà l'Integrazione di u Dispositivu per Imbarcà un Dispositivu di Rete
Questa sezione furnisce un example di cumu furnisce u flussu di travagliu di Device Onboarding.
Prerequisites
· Un OVA Crosswork Workflow Manager (CWM) hè in esecuzione. · Un sistema Network Service Orchestrator (NSO) (versione 6.1.9 o successiva) hè installatu è in esecuzione. · Un sicretu di u servitore NSO hè creatu per esse adupratu in u CWM. · U flussu di travagliu Map-service-create-poll-plan.sw.jason hè caricatu in CWM.
Prucedura di flussu di travagliu
Prucedura
Passu 1
Crea un pool di risorse aduprendu stu payload.
Integrazione di u dispusitivu 13
Prucedura di flussu di travagliu
Onboarding di u dispositivu
Passu 2 Passu 3
piscina ztp indirizzu_ip1.0
Crea un gruppu d'autentificazione cù stu script.
predefinitu amministratore
Crea un mudellu Day-0 aduprendu stu script.
!! nome d'utilizatore IOS XR ${DEV_CUSTOMER_USERNAME} gruppu root-lr password 1.0 ${DEV_CUSTOMER_PASSWORD} ! nome di l'ospite ${HOST_NAME} ! vrf Mgmt-intf famiglia d'indirizzi ipv0 unicast ! nome di duminiu cisco.com servitore di nomi di duminiu ricerca di duminiu interfaccia-surgente MgmtEth0/RP4/CPU0/0 interfaccia MgmtEth0/RP0/CPU0/0 indirizzu ipv0 ${MGMT_IP_ADDRESS} ! router indirizzu staticu famiglia-ipv0 unicast 4/4 ! ! ! servitore ssh v0.0.0.0 servitore ssh vrf Mgmt-intf
Integrazione di u dispusitivu 14
Onboarding di u dispositivu
Prucedura di flussu di travagliu
Passu 4
Passu 5 Passu 6 Passu 7
Creà un ZTP-profile aduprendu stu script.
<profile> ncs5501-profilecisco-ioxr 7.9.2 http://172.22.143.63/xr-5500-792/ncs5500-golden-x7.9.2-v1.iso 5b195c174a9de13ca04f44c51d222b14 piscina ztp ncs0-ghjornu5 veru cisco-iosxr-cli-0file>
Dopu à u gruppu di risorse, l'authcode, u day-0-template è ZTP-profile sò stati creati, create u serviziu di mappa ztp nantu à nso utilizendu l'interfaccia utente CWM.
Cunnettatevi à CWM è sceglite a tabulazione Workflows.
Cliccate nant'à Crea un novu flussu di travagliu.
a) (Obbligatoriu) Scrivite u nome di u flussu di travagliu.
Integrazione di u dispusitivu 15
Prucedura di flussu di travagliu
b) (Obbligatoriu) Scrivite a versione di u flussu di travagliu.
Onboarding di u dispositivu
Integrazione di u dispusitivu 16
Onboarding di u dispositivu
Passu 8
Cliccate nant'à Crea un flussu di travagliu. U flussu di travagliu hè listatu in a tavula di u flussu di travagliu.
Prucedura di flussu di travagliu
Integrazione di u dispusitivu 17
Prucedura di flussu di travagliu
Onboarding di u dispositivu
Passu 9
Passu 10 Passu 11
k u Nome di u Flussu di travagliu per apre a schermata di u Flussu di travagliu. (A tabulazione Dettagli hè l'opzione predefinita.) L'ID di definizione di u flussu di travagliu è a Data di aghjurnamentu sò riempiti automaticamente.
(Opzionale) Scrivite qualsiasi Tags.
Cliccate nant'à a tabulazione Codice per view u script per a mappa.
Integrazione di u dispusitivu 18
Onboarding di u dispositivu
Passu 12
Cliccate nant'à Eseguisce, a finestra Eseguisce u travagliu si apre.
Prucedura di flussu di travagliu
Integrazione di u dispusitivu 19
Esecuzione di a Carta
Onboarding di u dispositivu
Passu 13 Passu 14
Passu 15 Passu 16
(Opzionale) Scrivite qualsiasi TagsScrivite e variabili d'entrata. Es.ample hè mostratu quì:
{ "nsoInstance": "NSO", "ztp": { "mappa": { "id": "NCS_5", "unique-id": "FOC2712R3D6", "profile": "ncs540-profile", "variabile": { "nome": "NOME_HOST", "valore": "NCS_5" } } } }
(Opzionale) in a sezzione Quandu cunfigurate l'ora, a frequenza è l'ordine di esecuzione di a mappa. a) (Opzionale) Principià direttamente (predefinitu). b) Pianificà per una data è un'ora specifiche. c) (Se una data è un'ora specifiche sò selezziunate) Selezziunate Frequenza. d) (Se u script deve esse eseguitu in ordine cronologicu) Selezziunate Cron.
Cliccate nant'à Eseguisce u travagliu.
Esecuzione di a Carta
Dopu avè cliccatu Eseguisce u travagliu. Prucedura
Passu 1 Selezziunate Gestione di travaglii > Travaglii attivi.
Integrazione di u dispusitivu 20
Onboarding di u dispositivu
Passu 2 Cliccate nant'à u nome di u travagliu chì vulete apre. (In questu esempiuampvale à dì, u statutu di u travagliu hè in esecuzione.)
Esecuzione di a Carta
Passu 3
Una volta chì u prucessu ZTP hè finitu nant'à u dispusitivu XR. Sceglite a tabulazione Job Manager > Completed Jobs. U travagliu hè listatu in u
un Passu 4
Cliccate nant'à u Nome di u Travagliu. A pagina di u Travagliu si apre mustrendu i dettagli di u travagliu è u Registru di l'Eventi di u Travagliu.
Integrazione di u dispusitivu 21
Esecuzione di a Carta
Onboarding di u dispositivu
Passu 5 In a sezzione Job Event Log, cliccate nant'à u segnu più (+) à manca di WorkflowExecution (ultimu avvenimentu in u
i
l
Nota A variabile MapCreatedStatus hè impostata à veru è a variabile PlanStatusResult hè impostata à mostra righjunta, ciò chì significa chì a mappa ZTP hè in u statu righjunta.
Integrazione di u dispusitivu 22
Onboarding di u dispositivu
Esecuzione di a Carta
Passu 6 Nant'à NSO, u dispusitivu XR hè integratu è a mappa; u statutu di u pianu hè righjuntu. A lettura mostra chì u dispusitivu hè integratu.
Integrazione di u dispusitivu 23
Esecuzione di a Carta
Onboarding di u dispositivu
Integrazione di u dispusitivu 24
Documenti / Risorse
 |
Gestore di u flussu di travagliu Crosswork CISCO [pdfGuida di l'utente Manager di u Flussu di Travagliu Crosswork, Manager di u Flussu di Travagliu, Manager |