CISCO Crea modelli per automatizzare la Guida per l'utente del software del dispositivo

Cisco DNA Center fornisce un hub di modelli interattivo per creare modelli CLI. È possibile progettare facilmente modelli con una configurazione predefinita utilizzando elementi o variabili parametrizzati. Dopo aver creato un modello, puoi utilizzarlo per distribuire i tuoi dispositivi in uno o più siti configurati ovunque nella tua rete.
Con Template Hub puoi:

View l'elenco dei modelli disponibili.

Crea, modifica, clona, importa, esporta ed elimina un modello.
Filtra il modello in base a Nome progetto, Tipo di modello, Lingua del modello, Categoria, Famiglia di dispositivi, Serie di dispositivi, Stato di commit e Stato di fornitura.

View i seguenti attributi del modello nella finestra Template Hub, sotto la tabella Templates:
- Nome: nome del modello CLI.
- Progetto: progetto in base al quale viene creato il modello CLI.
Tipo: tipo di modello CLI (normale o composito).

Versione: numero di versioni del modello CLI.
Stato di commit: mostra se è stata eseguita la commit della versione più recente del modello. Puoi view le seguenti informazioni nella colonna Stato impegno:
- Il tempoamp dell'ultima data impegnata.
- Un'icona di avviso indica che il modello è stato modificato ma non confermato.
- Un'icona di controllo indica che è stata confermata la versione più recente del modello.

Nota
L'ultima versione del modello deve essere impegnata per eseguire il provisioning del modello sui dispositivi.

Stato della fornitura: puoi view le seguenti informazioni nella colonna Stato fornitura:
- Il numero di dispositivi su cui viene eseguito il provisioning del modello.
- Un'icona di controllo visualizza il numero di dispositivi per i quali è stato eseguito il provisioning del modello CLI senza errori.
- Un'icona di avviso visualizza il numero di dispositivi per i quali non è stato ancora eseguito il provisioning della versione più recente del modello CLI.
- Un'icona a forma di croce mostra il numero di dispositivi per i quali la distribuzione del modello CLI non è riuscita.
Potenziali conflitti di progettazione: visualizza i potenziali conflitti nel modello CLI.

Professionista della retefiles: Visualizza il numero del professionista di retefiles a cui è allegato un modello CLI. Utilizzare il collegamento sotto Network Profiles per allegare un modello CLI a network profiles.
Azioni: fare clic sui puntini di sospensione sotto la colonna Azioni per clonare, confermare, eliminare o modificare un modello; modificare un progetto; oppure allega un modello a un professionista della retefile.

Allega modelli a Network ProfileS. Per ulteriori informazioni, consulta Collegare un modello CLI a Network Profiles, a pagina 10.
View il numero di rete profiles a cui è allegato un modello CLI.

Aggiungi comandi interattivi.
Salva automaticamente i comandi CLI.

Controlla la versione dei modelli a scopo di tracciamento.
Puoi view le versioni di un modello CLI. Nella finestra Template Hub, fare clic sul nome del modello e fare clic sulla scheda Cronologia modelli per view la versione del modello.
Rileva errori nei modelli.

Simulare modelli.
Definire le variabili.
Rileva potenziali conflitti di progettazione e conflitti di runtime.

Nota
Fai attenzione che il tuo modello non sovrascriva una configurazione dell'intento di rete inviata da Cisco DNA Center.

Crea progetti

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Fai clic su Aggiungi nell'angolo in alto a destra della finestra e scegli Nuovo progetto dall'elenco a discesa. Viene visualizzato il riquadro a scorrimento Aggiungi nuovo progetto.
Passo 3 Inserisci un nome univoco nel campo Nome progetto.
Passo 4 (Facoltativo) Inserisci una descrizione per il progetto nel campo Descrizione progetto.
Passo 5 Fare clic su Continua.
Il progetto viene creato e viene visualizzato nel riquadro sinistro.

Cosa fare dopo
Aggiungi un nuovo modello al progetto. Per ulteriori informazioni, consulta Creare un modello regolare, a pagina 3 e Creare un modello composito, a pagina 5.

Crea modelli

I modelli forniscono un metodo per predefinire facilmente le configurazioni utilizzando elementi parametrici e variabili.
I modelli consentono a un amministratore di definire una configurazione di comandi CLI che possono essere utilizzati per configurare in modo coerente più dispositivi di rete, riducendo i tempi di distribuzione. Le variabili nel modello consentono la personalizzazione di impostazioni specifiche per dispositivo.

Crea un modello regolare

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Nota Per impostazione predefinita, il progetto Configurazione onboarding è disponibile per la creazione di modelli day-0. Puoi creare i tuoi progetti personalizzati. I modelli creati in progetti personalizzati sono classificati come modelli giorno-N.
Passo 2 Nel riquadro sinistro, fai clic su Nome progetto e seleziona il progetto in cui stai creando i modelli.
Passo 3 Fai clic su Aggiungi in alto a destra nella finestra e scegli Nuovo modello dall'elenco a discesa.
Nota Il modello creato per il giorno-0 può essere applicato anche per il giorno-N.
Passo 4 Nel riquadro a scorrimento Aggiungi nuovo modello, configurare le impostazioni per il modello normale.
Nell'area Dettagli modello, procedi come segue:
UN. Inserisci un nome univoco nel campo Nome modello.
B. Scegli il nome del progetto dall'elenco a discesa.
C. Tipo di modello: fare clic sul pulsante di opzione Modello regolare.
D. Lingua del modello: scegli la lingua Velocity o Jinja da utilizzare per il contenuto del modello.

Velocità: utilizza il Velocity Template Language (VTL). Per informazioni, vedere http://velocity.apache.org/engine/devel/vtl-reference.html.
Il framework del modello Velocity limita l'uso di variabili che iniziano con un numero. Assicurati che il nome della variabile inizi con una lettera e non con un numero.
Nota Non utilizzare il simbolo del dollaro ($) durante l'utilizzo dei modelli di velocità. Se hai utilizzato il segno del dollaro ($), qualsiasi valore dietro di esso viene trattato come una variabile. Per esample, se una password è configurata come "$a123$q1ups1$va112", l'hub modelli la tratta come variabili "a123", "q1ups" e "va112".
Per risolvere questo problema, utilizzare lo stile della shell Linux per l'elaborazione del testo con i modelli Velocity.
Nota Utilizzare il segno del dollaro ($) nei modelli di velocità solo quando si dichiara una variabile.
Jinja: Usa la lingua Jinja. Per informazioni, vedere https://www.palletsprojects.com/p/jinja/.

e. Scegli il tipo di software dall'elenco a discesa.
Nota È possibile selezionare il tipo di software specifico (come IOS-XE o IOS-XR) se sono presenti comandi specifici per questi tipi di software. Se selezioni IOS come tipo di software, i comandi si applicano a tutti i tipi di software, inclusi IOS-XE e IOS-XR. Questo valore viene utilizzato durante il provisioning per verificare se il dispositivo selezionato conferma la selezione nel modello.

Nell'area Dettagli tipo dispositivo effettuare le seguenti operazioni:
UN. Fare clic sul collegamento Aggiungi dettagli dispositivo.
B. Scegli Famiglia di dispositivi dall'elenco a discesa.
C. Fare clic sulla scheda Serie di dispositivi e selezionare la casella di controllo accanto alla serie di dispositivi preferita.
D. Fare clic sulla scheda Modelli dispositivo e selezionare la casella di controllo accanto al modello del dispositivo preferito.
e. Fare clic su Aggiungi.

Nell'area Dettagli aggiuntivi, procedi come segue:
UN. Scegli il dispositivo Tags dall'elenco a discesa.
Nota
Tags sono come parole chiave che ti aiutano a individuare più facilmente il tuo modello.
Se usi tags per filtrare i modelli, è necessario applicare lo stesso tags al dispositivo a cui desideri applicare i modelli. In caso contrario, durante il provisioning viene visualizzato il seguente errore:
Impossibile selezionare il dispositivo. Non compatibile con il modello
B. Immettere la versione del software nel campo della versione del software.
Nota
Durante il provisioning, Cisco DNA Center verifica se il dispositivo selezionato dispone della versione software elencata nel modello. Se è presente una mancata corrispondenza, non viene effettuato il provisioning del modello.
C. Inserisci la descrizione del modello.

Passo 5 Fare clic su Continua.
Il modello viene creato e visualizzato nella tabella Modelli.
Passo 6 Puoi modificare il contenuto del modello selezionando il modello creato, facendo clic sui puntini di sospensione nella colonna Azioni e scegliendo Modifica modello. Per ulteriori informazioni sulla modifica del contenuto del modello, vedere Modifica modelli, a pagina 7.

Comandi dell'elenco bloccati
I comandi dell'elenco bloccato sono comandi che non possono essere aggiunti a un modello o forniti tramite un modello.
Se si utilizzano comandi dell'elenco bloccato nei modelli, verrà visualizzato un avviso nel modello che potrebbe potenzialmente entrare in conflitto con alcune delle applicazioni di provisioning di Cisco DNA Center.
I seguenti comandi sono bloccati in questa versione:

router lisp

nome host

Sampi modelli

Fare riferimento a questi sampmodelli di file per le opzioni durante la creazione delle variabili per il modello.

Configura il nome host
nome host$nome

Configura interfaccia
interfaccia $nomeinterfaccia
descrizione $descrizione

Configura NTP sui controller wireless Cisco
ora di configurazione intervallo ntp $intervallo

Crea un modello composito
Due o più modelli regolari vengono raggruppati in un modello di sequenza composita. È possibile creare un modello sequenziale composito per una serie di modelli, che vengono applicati collettivamente ai dispositivi. Per esample, quando si distribuisce un ramo, è necessario specificare le configurazioni minime per il router del ramo. I modelli creati possono essere aggiunti a un singolo modello composito, che aggrega tutti i singoli modelli necessari per il router di filiale. È necessario specificare l'ordine in cui i modelli presenti nel modello composito vengono distribuiti ai dispositivi.

Nota
È possibile aggiungere solo un modello confermato a un modello composito.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Nel riquadro sinistro, fai clic su Nome progetto e seleziona il progetto in cui stai creando i modelli.
Passo 3 Fai clic su Aggiungi in alto a destra nella finestra e scegli Nuovo modello dall'elenco a discesa.
Viene visualizzato il riquadro a scorrimento Aggiungi nuovo modello.
Passo 4 Nel riquadro a scorrimento Aggiungi nuovo modello, configurare le impostazioni per il modello composito.
Nell'area Dettagli modello, procedi come segue:
a) Immettere un nome univoco nel campo Nome modello.
b) Scegli il nome del progetto dall'elenco a discesa.
c) Tipo di modello: scegli il pulsante di opzione Sequenza composita.
d) Scegliere il tipo di software dall'elenco a discesa.
Nota
È possibile selezionare il tipo di software specifico (come IOS-XE o IOS-XR) se sono presenti comandi specifici per questi tipi di software. Se selezioni IOS come tipo di software, i comandi si applicano a tutti i tipi di software, inclusi IOS-XE e IOS-XR. Questo valore viene utilizzato durante il provisioning per verificare se il dispositivo selezionato conferma la selezione nel modello.

Passo 5 Fare clic su Continua.
Viene visualizzata la finestra del modello composito, che mostra l'elenco dei modelli applicabili.
Passo 6 Fare clic sul collegamento Aggiungi modelli e fare clic su + per aggiungere i modelli e fare clic su Fine.
Viene creato il modello composito.
Passo 7 Seleziona la casella di controllo accanto al modello composito che hai creato, fai clic sui puntini di sospensione nella colonna Azioni e scegli Salva per confermare il contenuto del modello.

Modifica modelli

Dopo aver creato un modello, puoi modificarlo per includere contenuti.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Nel riquadro di sinistra, scegli il Nome progetto e seleziona il modello che desideri modificare.
Viene visualizzato il modello scelto.
Passo 3 Inserisci il contenuto del modello. È possibile avere un modello con una configurazione a riga singola o una configurazione a selezione multipla.
Passo 4 Fare clic su Proprietà accanto al nome del modello nella parte superiore della finestra per modificare Dettagli modello, Dettagli dispositivo e Dettagli aggiuntivi. Fare clic su Modifica accanto alla rispettiva area.
Passo 5 Il modello viene salvato automaticamente. Puoi anche scegliere di modificare l'intervallo di tempo del salvataggio automatico, facendo clic sulla ricorrenza temporale accanto a Salvataggio automatico.
Passo 6 Fare clic su Cronologia modelli per view le versioni del modello. Inoltre, puoi fare clic su Confronta con view la differenza nelle versioni del modello.
Passo 7 Fare clic sulla scheda Variabili per view le variabili dal modello CLI.
Passo 8 Fare clic sul pulsante di attivazione/disattivazione Mostra conflitti di progettazione per view potenziali errori nel modello.
Cisco DNA Center te lo consente view, errori potenziali ed errori di runtime. Per ulteriori informazioni, consulta Rilevamento potenziale di conflitti di progettazione tra il modello CLI e l'intento di provisioning del servizio, a pagina 21 e Rilevamento del conflitto di runtime del modello CLI, a pagina 21.
Passo 9 Fare clic su Salva nella parte inferiore della finestra.
Dopo aver salvato il modello, Cisco DNA Center verifica eventuali errori nel modello. Se sono presenti errori di sintassi, il contenuto del modello non viene salvato e tutte le variabili di input definite nel modello vengono identificate automaticamente durante il processo di salvataggio. Le variabili locali (variabili utilizzate nei cicli for, assegnate tramite un set e così via) vengono ignorate.
Passo 10 Fare clic su Salva per salvare il modello.
Nota Puoi associare solo un modello impegnato a un professionista della retefile.
Passo 11 Fare clic su Collega a Network Profile collegamento, per allegare il modello creato a un professionista della retefile.

Simulazione del modello
La simulazione interattiva del modello consente di simulare la generazione CLI di modelli specificando i dati di test per le variabili prima di inviarli ai dispositivi. È possibile salvare i risultati della simulazione del test e utilizzarli in seguito, se necessario.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Nel riquadro di sinistra, scegli un progetto e fai clic su un modello per il quale desideri eseguire una simulazione.
Viene visualizzato il modello.
Passo 3 Fare clic sulla scheda Simulazione.
Passo 4 Fare clic su Crea simulazione.
Viene visualizzato il riquadro a scorrimento Crea simulazione.
Passo 5 Immettere un nome univoco nel campo Nome simulazione.

Nota
Se nel modello sono presenti variabili implicite, seleziona un dispositivo dall'elenco a discesa Dispositivo per eseguire la simulazione rispetto a dispositivi reali in base ai tuoi collegamenti.

Passo 6 Fare clic su Importa parametri modello per importare i parametri del modello oppure fare clic su Esporta parametri modello per esportare i parametri del modello.
Passo 7 Per utilizzare le variabili dell'ultimo provisioning del dispositivo, fare clic su Utilizza valori variabili dal collegamento Ultimo provisioning. Le nuove variabili devono essere aggiunte manualmente.
Passo 8 Scegli i valori delle variabili, facendo clic sul collegamento e fai clic su Esegui.

Esporta modello/i

Puoi esportare uno o più modelli in uno solo file, in formato JSON.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Seleziona una casella di controllo o più caselle di controllo accanto al nome del modello per selezionare un modello o più modelli che desideri esportare.
Passo 3 Dall'elenco a discesa Esporta, scegli Esporta modello.
Passo 4 (Facoltativo) È possibile filtrare i modelli in base alle categorie nel riquadro di sinistra.
Passo 5 Viene esportata la versione più recente del modello.
Per esportare una versione precedente del modello, procedi come segue:
UN. Fare clic sul nome del modello per aprire il modello.
B. Fare clic sulla scheda Cronologia modelli.
Viene visualizzato il riquadro a scorrimento Cronologia modelli.
C. Scegli la versione preferita.
d. Clic View pulsante sotto la versione.
Viene visualizzato il modello CLI di quella versione.
e. Fai clic su Esporta nella parte superiore del modello.

Viene esportato il formato JSON del modello.

Importa modelli

Puoi importare un modello o più modelli in un progetto.

Nota
È possibile importare modelli solo da una versione precedente di Cisco DNA Center a una versione più recente. Non è però consentito il contrario.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Nel riquadro di sinistra, scegli il progetto per il quale desideri importare i modelli, in Nome progetto e scegli Importa> Importa modello.
Passo 3 Viene visualizzato il riquadro a scorrimento Importa modelli.
UN. Scegli il nome del progetto dall'elenco a discesa.
B. Carica il JSON file eseguendo una delle seguenti azioni:

Trascina e rilascia il file nell'area di trascinamento della selezione.
Fare clic, scegliere a file, accedere alla posizione del file JSON filee fare clic su Apri.

File la dimensione non deve superare i 10 Mb.
C. Selezionare la casella di controllo per creare una nuova versione del modello importato, se nella gerarchia esiste già un modello con lo stesso nome.
D. Fare clic su Importa.
Il modello CLI è stato importato con successo nel progetto scelto.

Clonare un modello

Puoi creare una copia di un modello per riutilizzarne alcune parti.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Fare clic sui puntini di sospensione nella colonna Azione e scegliere Clona.
Passo 3 Viene visualizzato il riquadro a scorrimento Modello clone.
Procedere come segue:
UN. Inserisci un nome univoco nel campo Nome modello.
B. Scegli il nome del progetto dall'elenco a discesa.
Passo 4 Fare clic su Clona.
L'ultima versione del modello viene clonata.
Passo 5 (Facoltativo) In alternativa, puoi clonare il modello facendo clic sul nome del modello. Viene visualizzato il modello. Clic
Clona sopra il modello.
Passo 6 Per clonare una versione precedente del modello, procedi come segue:
UN. Selezionare il modello facendo clic sul nome del modello.
B. Fare clic sulla scheda Cronologia modelli.
Viene visualizzato il riquadro a scorrimento Cronologia modelli.
C. Fare clic sulla versione preferita.
Viene visualizzato il modello CLI scelto.
D. Fai clic su Clona sopra il modello.

Allega un modello CLI a Network Profiles

Per eseguire il provisioning di un modello CLI, è necessario collegarlo a un professionista della retefile. Utilizzare questa procedura per allegare un modello CLI a un professionista di retefile o più professionisti della retefiles.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Viene visualizzata la finestra Hub modelli.
Passo 2 Fare clic su Allega in Network Profile colonna per allegare un modello al network profile.
Nota
In alternativa, puoi fare clic sui puntini di sospensione nella colonna Azioni e scegliere Allega a Profile oppure puoi allegare un modello a network profile da Progettazione> Rete ProfileS. Per ulteriori informazioni, vedere Associare modelli a Network Profiles, a pagina 19.
Collega a Network Profile viene visualizzato il riquadro a scorrimento.
Passo 3 Seleziona la casella di controllo accanto al professionista della retefile nome e fare clic su Salva.
Il modello CLI è collegato al Network Pro sceltofile.
Passo 4 Sotto Network Pro viene visualizzato un numerofile colonna, che mostra il numero di rete profiles a cui è allegato un modello CLI. Fare clic sul numero a view il professionista della retefile dettagli.
Passo 5 Per collegare più professionisti della retefiles a un modello CLI, effettuare le seguenti operazioni:
UN. Fare clic sul numero sotto Network Profile colonna.
In alternativa, puoi fare clic sui puntini di sospensione nella colonna Azioni e scegliere Allega a Profile.
Il professionista della retefileViene visualizzato il riquadro a scorrimento.
B. Fare clic su Collega a Network Profile in alto a destra nel riquadro a scorrimento e seleziona la casella di controllo accanto a Network Profile nome e fare clic su Allega.

Fornire modelli CLI

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Seleziona la casella di controllo accanto al modello di cui desideri effettuare il provisioning e fai clic su Provision Templates nella parte superiore della tabella.
Puoi scegliere di fornire più modelli.
Verrai reindirizzato al flusso di lavoro del modello di provisioning.
Passo 3 Nella finestra Inizia, inserisci un nome univoco nel campo Nome attività.
Passo 4 Nella finestra Seleziona dispositivi, scegli i dispositivi dall'elenco dei dispositivi applicabili, che si basano sui dettagli del dispositivo definiti nel modello e fai clic su Avanti.
Passo 5 Lì dentroview Finestra Modelli applicabili, rifview i dispositivi e i modelli ad esso allegati. Se necessario, è possibile rimuovere i modelli di cui non si desidera venga eseguito il provisioning sul dispositivo.
Passo 6 Configurare le variabili del modello per ciascun dispositivo, nella finestra Configura variabili del modello.
Passo 7 Selezionare il dispositivo da preview la configurazione di cui viene effettuato il provisioning sul dispositivo, in Preview Finestra di configurazione.
Passo 8 Nella finestra Pianifica attività, seleziona se effettuare il provisioning del modello adesso o pianificare il provisioning per un momento successivo e fare clic su Avanti.
Passo 9 Nella finestra Riepilogo, review le configurazioni del modello per i tuoi dispositivi, fai clic su Modifica per apportare eventuali modifiche; altrimenti clicca su Invia.
I tuoi dispositivi verranno forniti con il modello.

Esporta progetto(i)

Puoi esportare uno o più progetti, inclusi i relativi modelli, in un unico progetto file in formato JSON.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Nel riquadro sinistro, seleziona un progetto o più progetti che desideri esportare in Nome progetto.
Passo 3 Dall'elenco a discesa Esporta, scegli Esporta progetto.
Passo 4 Fare clic su Salva, se richiesto.

Importa progetti

È possibile importare uno o più progetti con i relativi modelli nell'hub modelli di Cisco DNA Center.

Nota
È possibile importare progetti solo da una versione precedente di Cisco DNA Center a una versione più recente. Non è però consentito il contrario.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Dall'elenco a discesa Importa, scegli Importa progetto.
Passo 3 Viene visualizzato il riquadro Importa progetti.
UN. Carica il JSON file eseguendo una delle seguenti azioni:

Trascina e rilascia il file nell'area di trascinamento della selezione.

Fare clic su Scegli a file, accedere alla posizione del file JSON filee fare clic su Apri.

File la dimensione non deve superare i 10 Mb.
B. Selezionare la casella di controllo per creare una nuova versione del modello, nel progetto esistente, se il progetto con lo stesso nome esiste già nella gerarchia.
C. Fare clic su Importa.
Il progetto è stato importato con successo.

Variabili modello

Le variabili del modello vengono utilizzate per aggiungere ulteriori informazioni sui metadati alle variabili del modello nel modello. È inoltre possibile utilizzare le variabili per fornire convalide per variabili quali lunghezza massima, intervallo e così via.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Nel riquadro di sinistra, scegli un progetto e fai clic su un modello.
Viene visualizzato il modello.
Passo 3 Fare clic sulla scheda Variabili.
Ti consente di aggiungere metadati alle variabili del modello. Vengono visualizzate tutte le variabili identificate nel modello.
È possibile configurare i seguenti metadati:

Scegli la variabile dal riquadro di sinistra e fai clic sul pulsante di attivazione/disattivazione Variabile se desideri che la stringa venga considerata come una variabile.
Nota
Per impostazione predefinita la stringa è considerata come una variabile. Fare clic sul pulsante di attivazione/disattivazione se non si desidera che la stringa venga considerata come una variabile.
Selezionare la casella di controllo Variabile richiesta se questa è una variabile richiesta durante il provisioning. Per impostazione predefinita, tutte le variabili sono contrassegnate come obbligatorie, il che significa che è necessario immettere il valore per questa variabile al momento del provisioning. Se il parametro non è contrassegnato come variabile richiesta e non si passa alcun valore al parametro, verrà sostituito con una stringa vuota in fase di esecuzione. La mancanza di una variabile può portare al fallimento del comando, che potrebbe non essere sintatticamente corretto.
Se vuoi rendere facoltativo un intero comando basato su una variabile non contrassegnata come Variabile obbligatoria, utilizza il blocco if-else nel modello.

Immettere il nome del campo in Nome campo. Questa è l'etichetta utilizzata per il widget dell'interfaccia utente di ciascuna variabile durante il provisioning.
Nell'area Valore dati variabile, scegli l'Origine dati variabile facendo clic sul pulsante di opzione. È possibile scegliere Valore definito dall'utente o Valore associato a origine per contenere un valore specifico.

Se scegli Valore definito dall'utente, procedi come segue:
UN. Scegli il Tipo di variabile dall'elenco a discesa: Stringa, Intero, Indirizzo IP o Indirizzo Mac
B. Scegli il tipo di immissione dati dall'elenco a discesa: Campo di testo, Selezione singola o Selezione multipla.
C. Immettere il valore della variabile predefinita nel campo Valore variabile predefinita.
D. Selezionare la casella di controllo Valore sensibile per il valore sensibile.
e. Immettere il numero di caratteri consentiti nel campo Numero massimo di caratteri. Ciò è applicabile solo per il tipo di dati stringa.
F. Inserisci il testo del suggerimento nel campo Testo suggerimento.
G. Inserisci eventuali informazioni aggiuntive nella casella di testo Informazioni aggiuntive.
Se scegli Vincolo al valore di origine, procedi come segue:
UN. Scegli il tipo di immissione dati dall'elenco a discesa: Campo di testo, Selezione singola o Selezione multipla.
B. Scegli la Sorgente dall'elenco a discesa: Network Profile, Impostazioni comuni, Connessione cloud e Inventario.
C. Scegli l'entità dall'elenco a discesa.
D. Scegli l'attributo dall'elenco a discesa.
e. Immettere il numero di caratteri consentiti nel campo Numero massimo di caratteri. Ciò è applicabile solo per il tipo di dati stringa.
F. Inserisci il testo del suggerimento nel campo Testo suggerimento.
G. Inserisci eventuali informazioni aggiuntive nella casella di testo Informazioni aggiuntive.
Per ulteriori dettagli sul valore Associato a origine, vedere Associazione variabile, a pagina 13.

Passo 4 Dopo aver configurato le informazioni sui metadati, fare clic su Riview Forma per riview l'informazione variabile.
Passo 5 Fare clic su Salva.
Passo 6 Per confermare il modello, scegli Commetti. Viene visualizzata la finestra Commetti. È possibile inserire una nota di commit nella casella di testo Nota di commit.

Rilegatura variabile
Durante la creazione di un modello, è possibile specificare variabili che vengono sostituite contestualmente. Molte di queste variabili sono disponibili nel Template Hub.

Template Hub fornisce un'opzione per associare o utilizzare variabili nel modello con i valori dell'oggetto di origine durante la modifica o tramite i miglioramenti del modulo di input; per esample, server DHCP, server DNS e server syslog.
Alcune variabili sono sempre legate alla fonte corrispondente e il loro comportamento non può essere modificato. A view l'elenco delle variabili implicite, fare clic sul modello e quindi sulla scheda Variabili.
I valori oggetto predefiniti possono essere uno dei seguenti:

Professionista della retefile
•SSID
• Politica profile
• Gruppo AP
• Gruppo flessibile
• Flexprofile
• Sito tag
• Politica tag
Impostazioni comuni
• Server DHCP
• Server syslog
• Ricevitore di trap SNMP
• Server NTP
• Sito del fuso orario
• Banner del dispositivo
• Server DNS
• Raccoglitore NetFlow
• Server di rete AAA
• Server endpoint AAA
• Rete pan di server AAA
• Endpoint pan del server AAA
• Informazioni sulla WLAN
• RF professionalefile informazioni
Cloud Connect
• Router cloud: 1 tunnel IP
• Router cloud: 2 tunnel IP
• Router cloud: 1 IP di loopback
• Router cloud: 2 IP di loopback
• Router di filiale-1 Tunnel IP
• Router di filiale-2 Tunnel IP
• Router cloud: 1 IP pubblico
• Router cloud: 2 IP pubblico
• Router di filiale-1 IP
• Router di filiale-2 IP
• IP privato della sottorete 1
• IP privato della sottorete 2
• Maschera IP sottorete privata 1
• Maschera IP sottorete privata 2

Inventario
• Dispositivo
• Interfaccia
• Gruppo AP
• Gruppo flessibile
• Wi-Fi
• Politica profile
• Flexprofile
• Webmappa dei parametri di autenticazione
• Sito tag
• Politica tag
• RF professionalefile

• Impostazioni comuni: Impostazioni disponibili in Design> Impostazioni di rete> Rete. L'associazione della variabile delle impostazioni comuni risolve i valori basati sul sito a cui appartiene il dispositivo.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Passo 2 Scegli il modello e fai clic sulla scheda Variabili per associare le variabili nel modello alle impostazioni di rete.
Passo 3 Selezionare le variabili nel riquadro di sinistra e selezionare la casella di controllo Variabile richiesta per associare le variabili alle impostazioni di rete.
Passo 4 Per associare le variabili alle impostazioni di rete, seleziona ciascuna variabile dal riquadro di sinistra e scegli il pulsante di opzione Associato a origine, in Origine dati variabile ed effettua le seguenti operazioni:
UN. Dall'elenco a discesa Tipo di immissione dati, scegli il tipo di widget dell'interfaccia utente da creare al momento del provisioning: Campo di testo, Selezione singola o Selezione multipla.
B. Scegli Sorgente, Entità e Attributo dai rispettivi elenchi a discesa.
C. Per il tipo di origine CommonSettings, scegli una di queste entità: dhcp.server, syslog.server, snmp.trap.receiver, ntp.server, timezone.site, device.banner, dns.server, netflow.collector, aaa.network. server, aaa.endpoint.server, aaa.server.pan.network, aaa.server.pan.endpoint, wlan.info o rfprofile.informazioni.
È possibile applicare un filtro sugli attributi dns.server o netflow.collector per visualizzare solo l'elenco pertinente di variabili di associazione durante il provisioning dei dispositivi. Per applicare un filtro su un attributo, seleziona un attributo dall'elenco a discesa Filtra per. Dall'elenco a discesa Condizione, seleziona una condizione che corrisponda al Valore.
D. Per l'origine digitare NetworkProfile, scegli SSID come tipo di entità. L'entità SSID popolata è definita in Design> Network Profile. L'associazione genera un nome SSID di facile utilizzo, che è una combinazione di nome SSID, sito e categoria SSID. Dall'elenco a discesa Attributi, scegli wlanid o wlanProfileNome. Questo attributo viene utilizzato durante le configurazioni CLI avanzate al momento del provisioning del modello.
e. Per il tipo di origine Inventario, scegli una di queste entità: Dispositivo, Interfaccia, Gruppo AP, Gruppo Flex, WLAN, Policy Profile,FlexProfile, Webauth Mappa parametri, Sito Tag, Politica Tago RF Profile. Per il tipo di entità Dispositivo e interfaccia, l'elenco a discesa Attributo mostra gli attributi del dispositivo o dell'interfaccia. La variabile si risolve nel nome del gruppo AP e del gruppo Flex configurato sul dispositivo a cui viene applicato il modello.
È possibile applicare il filtro sugli attributi Dispositivo, Interfaccia o WLAN per visualizzare solo l'elenco pertinente di variabili di associazione durante il provisioning dei dispositivi. Per applicare un filtro su un attributo, seleziona un attributo dall'elenco a discesa Filtra per. Dall'elenco a discesa Condizione, seleziona una condizione che corrisponda al Valore.

Dopo aver associato le variabili a un'impostazione comune, quando assegni i modelli a un professionista wirelessfile e fornisci il modello, le impostazioni di rete definite in Impostazioni di rete> Rete verranno visualizzate nell'elenco a discesa. È necessario definire questi attributi in Impostazioni di rete> Rete al momento della progettazione della rete.

Passo 5
Se il modello contiene associazioni di variabili che si associano ad attributi specifici e il codice del modello accede direttamente a tali attributi, è necessario effettuare una delle seguenti operazioni:

Modificare l'associazione all'oggetto anziché agli attributi.

Aggiorna il codice del modello per non accedere direttamente agli attributi.

Per esempioample, se il codice del modello è il seguente, dove $interfaces si lega ad attributi specifici, è necessario aggiornare il codice come mostrato nel seguente example o modificare l'associazione all'oggetto invece che agli attributi.
Vecchi sampil codice:

#foreach ($interfaccia in $interfacce)
$interfaccia.nomeporta
descrizione “qualcosa”
#FINE

Notiziaampil codice:

#foreach ($interfaccia in $interfacce)
interfaccia $interfaccia
descrizione “qualcosa”
#FINE

Parole chiave speciali

Tutti i comandi eseguiti tramite i modelli sono sempre in modalità configurazione. Pertanto, non è necessario specificare esplicitamente i comandi abilita o configt nel modello.
I modelli Day-0 non supportano parole chiave speciali.

Abilita comandi modalità
Specificare il comando #MODE_ENABLE se si desidera eseguire qualsiasi comando al di fuori del comando configt.

Utilizza questa sintassi per aggiungere comandi di abilitazione modalità ai tuoi modelli CLI:
#MODALITÀ_ABILITA
< >
#MODALITÀ_END_ABILITA

Comandi interattivi
Specificare #INTERACTIVE se si desidera eseguire un comando in cui è richiesto l'input dell'utente.
Un comando interattivo contiene l'input che è necessario immettere dopo l'esecuzione di un comando. Per immettere un comando interattivo nell'area Contenuto CLI, utilizzare la seguente sintassi:

Comando CLI domanda interattiva 1 risposta al comando 1 domanda interattiva 2 risposta al comando 2
Dove E tags valutare il testo fornito rispetto a quanto visualizzato sul dispositivo.
La domanda interattiva utilizza espressioni regolari per verificare se il testo ricevuto dal dispositivo è simile al testo inserito. Se le espressioni regolari immesse nel file tags vengono trovati, quindi la domanda interattiva passa e viene visualizzata una parte del testo di output. Ciò significa che è necessario inserire una parte della domanda e non l'intera domanda. Inserendo Sì o No tra E tags è sufficiente ma è necessario assicurarsi che nella domanda emessa dal dispositivo appaia la scritta Sì o No. Il modo migliore per farlo è eseguire il comando sul dispositivo e osservare l'output. Inoltre, è necessario assicurarsi che tutti i metacaratteri delle espressioni regolari o i ritorni a capo immessi siano utilizzati in modo appropriato o evitati completamente. I metacaratteri comuni delle espressioni regolari sono . ( ) [ ] { } | *+? \$^: &.

Per esempioample, il seguente comando ha un output che include metacaratteri e ritorni a capo.

Switch(config)# nessun punto di fiducia pki crittografico DNAC-CA
% La rimozione di un punto di fiducia registrato distruggerà tutti i certificati ricevuti dalla relativa autorità di certificazione
Sei sicuro di volerlo fare? [si No]:

Per inserirlo in un modello, è necessario selezionare una porzione che non contenga metacaratteri o ritorni a capo.
Ecco alcuni esempiampmeno di ciò che potrebbe essere utilizzato.

#INTERATTIVO
nessun punto di fiducia pki crittografico DNAC-CA si No SÌ
#ENDS_INTERACTIVE

#INTERATTIVO
nessun punto di fiducia pki crittografico DNAC-CA Rimozione di un iscritto SÌ
#ENDS_INTERACTIVE

#INTERATTIVO
nessun punto di fiducia pki crittografico DNAC-CA Sei sicuro di volerlo fare? SÌ
#ENDS_INTERACTIVE

#INTERATTIVO
la chiave crittografica genera chiavi generali rsa si No NO
#ENDS_INTERACTIVE

Dove E tags fanno distinzione tra maiuscole e minuscole e devono essere inseriti in maiuscolo.

Nota
In risposta alla domanda interattiva dopo aver fornito una risposta, se il carattere di nuova riga non è richiesto, è necessario inserire il carattere tag. Includere uno spazio prima di tag. Quando entri nel tag, IL tag si apre automaticamente. Puoi eliminare il tag perché non è necessario.

Per esempioampon:
#INTERATTIVO
configurazione timer avanzati ap-fast-heartbeat abilitazione locale 20 Candidarsi (sì/no)? sì
#ENDS_INTERACTIVE

Combinazione dei comandi della modalità di attivazione interattiva
Utilizzare questa sintassi per combinare i comandi interattivi della modalità Abilita:

#MODALITÀ_ABILITA
#INTERATTIVO
comandi domanda interattiva risposta
#ENDS_INTERACTIVE
#MODALITÀ_END_ABILITA

#MODALITÀ_ABILITA
#INTERATTIVO
mkdir Crea rubrica xyz
#ENDS_INTERACTIVE
#MODALITÀ_END_ABILITA

Comandi multilinea
Se desideri che più righe nel modello CLI vengano racchiuse, utilizza MLTCMD tags. Altrimenti il comando viene inviato riga per riga al dispositivo. Per immettere comandi su più righe nell'area Contenuto CLI, utilizzare la seguente sintassi:

prima riga del comando multilinea
seconda riga del comando multilinea
…
…
ultima riga del comando multilinea

Dove E fanno distinzione tra maiuscole e minuscole e devono essere in maiuscolo.

I comandi multiriga devono essere inseriti tra i E tags.
IL tags non può iniziare con uno spazio.
IL E tags non può essere utilizzato in un'unica riga.

Associa modelli a Network Profiles

Prima di iniziare
Prima di effettuare il provisioning di un modello, assicurati che il modello sia associato a un professionista della retefile e il profile è assegnato a un sito.
Durante il provisioning, quando i dispositivi vengono assegnati a siti specifici, i modelli vengono associati al sito tramite la rete profile appaiono nella configurazione avanzata.

Passo 1

Fare clic sull'icona del menu () e scegli Design> Rete Profiles e fare clic su Aggiungi Profile.
I seguenti tipi di profilesono disponibili:

Assurance: fare clic qui per creare un professionista Assurancefile.
Firewall: fare clic qui per creare un firewall professionalefile.
Routing: fare clic qui per creare un professionista del routingfile.

Cambio: fare clic qui per creare un professionista del cambiofile.
• Fare clic su Modelli di onboarding o Modelli Giorno-N, come richiesto.
• Nel professionistafile Campo del nome, inserisci il professionistafile nome.
• Fai clic su +Aggiungi modello e scegli il tipo di dispositivo, tage il modello dal Tipo di dispositivo, Tag Elenchi a discesa Nome e Modello.
Se non vedi il modello che ti serve, crea un nuovo modello in Template Hub. Vedere Creare un modello regolare, a pagina 3.
• Fare clic su Salva.
Dispositivo di telemetria: fare clic qui per creare un dispositivo di telemetria Cisco DNA Traffic Profile.
Wireless: fare clic qui per creare un professionista wirelessfile. Prima di assegnare un professionista della rete wirelessfile a un modello, assicurati di aver creato gli SSID wireless.
• Nel professionistafile Campo del nome, inserisci il professionistafile nome.
• Fare clic su+ Aggiungi SSID. Gli SSID creati in Impostazioni di rete >Wireless vengono popolati.
• In Allega modello/i, dall'elenco a discesa Modello, scegliere il modello di cui si desidera effettuare il provisioning.
• Fare clic su Salva.

Nota
Puoi view il professionista di commutazione e wirelessfiles nelle carte e nella tabella view.

Passo 2 Il professionista della retefileLa finestra di s elenca quanto segue:

Professionistafile Nome

Tipo
Versione
Creato da

Siti: fare clic su Assegna sito per aggiungere siti al professionista selezionatofile.

Passo 3
Per il provisioning Giorno N, scegli Provision > Dispositivi di rete > Inventario ed esegui le seguenti operazioni:
a) Seleziona la casella di controllo accanto al nome del dispositivo di cui desideri effettuare il provisioning.
b) Dall'elenco a discesa Azioni, scegliere Provisioning.
c) Nella finestra Assegna sito, assegnare un sito a cui il professionistafilesono allegati.
d) Nel campo Scegli un Sito inserire il nome del sito al quale si vuole associare il titolare del trattamento, oppure sceglierlo dall'elenco a tendina Scegli un Sito.
e) Fare clic su Avanti.
f) Viene visualizzata la finestra di configurazione. Nel campo Posizioni AP gestite, inserire le posizioni AP gestite dal controller. Puoi modificare, rimuovere o riassegnare il sito. Questo è applicabile solo per Wireless Profiles.
g) Fare clic su Avanti.
h) Viene visualizzata la finestra Configurazione avanzata. I modelli associati al sito tramite la rete profile appaiono nella configurazione avanzata.

Seleziona la casella di controllo Provisioning di questi modelli anche se sono stati distribuiti in precedenza se hai sovrascritto eventuali configurazioni dall'intento nel modello e desideri che le modifiche vengano sovrascritte. (Questa opzione è disabilitata di default.)

L'opzione Copia la configurazione in esecuzione nella configurazione di avvio è abilitata per impostazione predefinita, il che significa che dopo aver distribuito la configurazione del modello, verrà applicata la scrittura mem. Se non desideri applicare la configurazione in esecuzione alla configurazione di avvio, devi deselezionare questa casella di controllo.
Utilizza la funzione Trova per cercare rapidamente il dispositivo inserendo il nome del dispositivo oppure espandi la cartella dei modelli e seleziona il modello nel riquadro di sinistra. Nel riquadro di destra selezionare i valori per gli attributi associati all'origine.
Per esportare le variabili del modello in un CSV file durante la distribuzione del modello, fare clic su Esporta nel riquadro di destra.
Puoi utilizzare il CSV file per apportare le modifiche necessarie alla configurazione della variabile e importarla in Cisco DNA Center in un secondo momento facendo clic su Importa nel riquadro di destra.

i) Fare clic su Avanti per distribuire il modello.
j) Scegli se desideri distribuire il modello adesso o pianificarlo per dopo.
La colonna Stato nella finestra Inventario dispositivi mostra SUCCESSO una volta completata la distribuzione.

Passo 4 Fai clic su Esporta CSV di distribuzione per esportare le variabili del modello da tutti i modelli in un unico modello file.
Passo 5 Fai clic su Importa CSV di distribuzione per importare le variabili del modello da tutti i modelli in un unico modello file.
Passo 6 Per il provisioning Day-0, scegli Provision> Plug and Play ed esegui le seguenti operazioni:
a) Scegli un dispositivo dall'elenco a discesa Azioni e scegli Rivendica.
b) Fare clic su Avanti e nella finestra Assegnazione sito scegliere un sito dall'elenco a discesa Sito.
c) Fare clic su Avanti e nella finestra Configurazione, scegliere l'immagine e il modello Day-0.
d) Fare clic su Avanti e nella finestra Configurazione avanzata, inserire la posizione.
e) Fare clic su Avanti a view i Dettagli dispositivo, Dettagli immagine, Configurazione giorno 0 Previewe modello CLI Preview.

Rileva conflitti in un modello CLI

Cisco DNA Center consente di rilevare i conflitti in un modello CLI. Puoi view potenziali conflitti di progettazione e conflitti di runtime per il passaggio, l'accesso SD o l'infrastruttura.

Rilevamento potenziale di conflitti di progettazione tra il modello CLI e l'intento di provisioning del servizio

I potenziali conflitti di progettazione identificano i comandi di intent nel modello CLI e li contrassegnano, se lo stesso comando viene inviato tramite commutazione, SD-Access o fabric. Si sconsiglia l'uso dei comandi di intent perché sono riservati per essere inviati al dispositivo da Cisco DNA Center.

Passo 1 Fare clic sull'icona del menu () e scegli Strumenti> Hub modelli.
Viene visualizzata la finestra Hub modelli.
Passo 2 Nel riquadro di sinistra, fare clic sul Nome progetto dall'elenco a discesa su view i modelli CLI del progetto preferito.
A view solo i modelli con conflitti, nel riquadro di sinistra, sotto Potenziali conflitti di progettazione, controlla il file
Nota
Casella di controllo Conflitti.
Passo 3 Fare clic sul nome del modello.
In alternativa, è possibile fare clic sull'icona di avviso nella colonna Potenziali conflitti di progettazione. Viene visualizzato il numero totale di conflitti.
Viene visualizzato il modello CLI.
Passo 4 Nel modello, i comandi CLI che presentano conflitti sono contrassegnati da un'icona di avviso. Passa il mouse sopra l'icona di avviso per view i dettagli del conflitto.
Per i nuovi modelli, i conflitti vengono rilevati dopo aver salvato il modello.
Passo 5 (Facoltativo) Per mostrare o nascondere i conflitti, fare clic sull'interruttore Mostra conflitti di progettazione.
Passo 6 Fare clic sull'icona del menu () e scegli Provision > Inventario a view il numero di modelli CLI con conflitti. Nella finestra Inventario viene visualizzato un messaggio con un'icona di avviso, che mostra il numero di conflitti nel modello CLI appena configurato. Fare clic sul collegamento Aggiorna modelli CLI per view i conflitti.

Rileva conflitto di runtime del modello CLI

Cisco DNA Center consente di rilevare conflitti di runtime per switching, SD-Access o fabric.

Prima di iniziare
È necessario configurare il modello CLI tramite Cisco DNA Center per rilevare i conflitti di runtime.

Passo 1 Fare clic sull'icona del menu () e scegli Provision > Inventario.
Viene visualizzata la finestra Inventario.
Passo 2 View lo stato di provisioning dei modelli dei dispositivi nella colonna Stato provisioning dei modelli, che mostra il numero di modelli di cui è stato eseguito il provisioning per il dispositivo. I modelli di cui è stato effettuato il provisioning correttamente vengono visualizzati con un'icona di segno di spunta.
I modelli che presentano conflitti vengono visualizzati con un'icona di avviso.
Passo 3 Fare clic sul collegamento sotto la colonna Stato fornitura modello per aprire il riquadro a scorrimento Stato modello.

Puoi view le seguenti informazioni nella tabella:

Nome del modello
Nome del progetto
Stato provisioning: visualizza Modello fornito se il modello è stato fornito correttamente o Modello non sincronizzato se sono presenti conflitti nel modello.
Stato conflitto: visualizza il numero di conflitti nel modello CLI.
Azioni: fare clic View Configurazione a view il modello CLI. I comandi che presentano conflitti sono contrassegnati da un'icona di avviso.

Passo 4 (Opzionale) View il numero di conflitti in un modello CLI nella colonna Stato conflitti modello nella finestra Inventario.
Passo 5 Identificare i conflitti di runtime generando una configurazione preview:
a) Selezionare la casella di controllo accanto al nome del dispositivo.
b) Dall'elenco a discesa Azioni, scegliere Provision Device.
c) Nella finestra Assegna sito, fare clic su Avanti. Nella finestra Configurazione avanzata, apportare le modifiche necessarie e fare clic su Avanti. Nella finestra Riepilogo fare clic su Distribuisci.
d) Nel riquadro a scorrimento Dispositivo di provisioning, fare clic su Genera configurazione preview pulsante di opzione e fare clic su Applica.
e) Fare clic sul collegamento Elementi di lavoro a view la configurazione generata preview. In alternativa, fare clic sull'icona del menu () e scegliere Attività >Elementi di lavoro in view la configurazione generata preview.
f) Se l'attività è ancora in caricamento, fare clic su Aggiorna.
g) Fare clic sul preview collegamento per aprire la configurazione preview riquadro a scorrimento. Puoi view i comandi CLI con conflitti di runtime contrassegnati con icone di avviso.

Documenti / Risorse

	CISCO crea modelli per automatizzare il software dei dispositivi [pdf] Guida utente Crea modelli per automatizzare il software del dispositivo, modelli per automatizzare il software del dispositivo, automatizzare il software del dispositivo, software del dispositivo, software
	CISCO crea modelli per automatizzare i dispositivi [pdf] Guida utente Crea modelli per automatizzare il dispositivo, Modelli per automatizzare il dispositivo, Automatizzare il dispositivo, Dispositivo

Riferimenti

Manuale d'uso

Crea modelli per automatizzare il software del dispositivo

Informazioni su Hub modelli