CISCO Skapa mallar för att automatisera enhetsprogramvara Användarhandbok

Cisco DNA Center tillhandahåller ett interaktivt mallnav för att skapa CLI-mallar. Du kan enkelt designa mallar med en fördefinierad konfiguration genom att använda parametriserade element eller variabler. När du har skapat en mall kan du använda mallen för att distribuera dina enheter på en eller flera webbplatser som är konfigurerade var som helst i ditt nätverk.
Med Template Hub kan du:

View listan över tillgängliga mallar.

Skapa, redigera, klona, importera, exportera och ta bort en mall.
Filtrera mallen baserat på projektnamn, malltyp, mallspråk, kategori, enhetsfamilj, enhetsserie, engagerad status och leveransstatus.

View följande attribut för mallen i Template Hub-fönstret, under Mall-tabellen:
- Namn: Namnet på CLI-mallen.
- Projekt: Projekt under vilket CLI-mallen skapas.
Typ: Typ av CLI-mall (vanlig eller sammansatt).

Version: Antal versioner av CLI-mallen.
Commit State: Visar om den senaste versionen av mallen är commited. Du kan view följande information under kolumnen Commit State:
- Den tidigasteamp från det senast avtalade datumet.
- En varningsikon betyder att mallen är modifierad men inte ansluten.
- En bockikon betyder att den senaste versionen av mallen är ansluten.

Notera
Den senaste mallversionen måste vara förpliktad att tillhandahålla mallen på enheterna.

Tillhandahållande Status: Du kan view följande information under kolumnen Provision Status:
- Antalet enheter som mallen tillhandahålls på.
- En kryssikon visar antalet enheter för vilka CLI-mallen tillhandahålls utan några fel.
- En varningsikon visar antalet enheter för vilka den senaste versionen av CLI-mallen ännu inte tillhandahålls.
- En korsikon visar antalet enheter för vilka distributionen av CLI-mall misslyckades.
Potentiella designkonflikter: Visar potentiella konflikter i CLI-mallen.

Network Profiles: Visar antalet nätverksproffsfiles som en CLI-mall är ansluten till. Använd länken under Network Profiles kolumn för att bifoga en CLI-mall till nätverksproffsfiles.
Åtgärder: Klicka på ellipsen under kolumnen Åtgärder för att klona, utföra, ta bort eller redigera en mall; redigera ett projekt; eller bifoga en mall till ett nätverksproffsfile.

Bifoga mallar till nätverksproffsfiles. För mer information, se Bifoga en CLI-mall till Network Profiles, på sidan 10.
View antalet nätverksproffsfiles som en CLI-mall är ansluten till.

Lägg till interaktiva kommandon.
Spara CLI-kommandona automatiskt.

Versionskontrollera mallarna för spårningsändamål.
Du kan view versionerna av en CLI-mall. I fönstret Template Hub klickar du på mallens namn och klickar på fliken Mall History för att view mallversionen.
Upptäck fel i mallar.

Simulera mallar.
Definiera variabler.
Upptäck potentiell designkonflikt och körtidskonflikt.

Notera
Var försiktig så att din mall inte skriver över en nätverkskonfiguration som drivs av Cisco DNA Center.

Skapa projekt

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Klicka på Lägg till i det övre högra hörnet av fönstret och välj Nytt projekt från rullgardinsmenyn. Ingångsrutan Lägg till nytt projekt visas.
Steg 3 Ange ett unikt namn i fältet Projektnamn.
Steg 4 (Valfritt) Ange en beskrivning för projektet i fältet Projektbeskrivning.
Steg 5 Klicka på Fortsätt.
Projektet skapas och visas i den vänstra rutan.

Vad du ska göra härnäst
Lägg till en ny mall i projektet. För mer information, se Skapa en vanlig mall, på sidan 3 och Skapa en sammansatt mall, på sidan 5.

Skapa mallar

Mallar tillhandahåller en metod för att enkelt fördefiniera konfigurationer med hjälp av parameterelement och variabler.
Mallar tillåter en administratör att definiera en konfiguration av CLI-kommandon som kan användas för att konsekvent konfigurera flera nätverksenheter, vilket minskar distributionstiden. Variabler i mallen tillåter anpassning av specifika inställningar per enhet.

Skapa en vanlig mall

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Notera Som standard är Onboarding Configuration-projektet tillgängligt för att skapa dag-0-mallar. Du kan skapa dina egna skräddarsydda projekt. Mallar skapade i anpassade projekt kategoriseras som dag-N-mallar.
Steg 2 Klicka på Projektnamn i den vänstra rutan och välj det projekt som du skapar mallar under.
Steg 3 Klicka på Lägg till längst upp till höger i fönstret och välj Ny mall från rullgardinsmenyn.
Notera Mallen som du skapar för dag-0 kan också användas för dag-N.
Steg 4 Konfigurera inställningarna för den vanliga mallen i rutan Lägg till ny mall.
Gör följande i området Malldetaljer:
a. Ange ett unikt namn i fältet Mallnamn.
b. Välj projektnamn från rullgardinsmenyn.
c. Malltyp: Klicka på alternativknappen Normal mall.
d. Mallspråk: Välj antingen hastighets- eller jinja-språket som ska användas för mallens innehåll.

Hastighet: Använd Velocity Template Language (VTL). För information, se http://velocity.apache.org/engine/devel/vtl-reference.html.
Hastighetsmallramverket begränsar användningen av variabler som börjar med ett tal. Se till att variabelnamnet börjar med en bokstav och inte med en siffra.
Notera Använd inte dollartecknet ($) när du använder hastighetsmallarna. Om du har använt dollartecknet ($) behandlas alla värden bakom det som en variabel. Till exempelample, om ett lösenord är konfigurerat som "$a123$q1ups1$va112", så behandlar mallhubben detta som variablerna "a123", "q1ups" och "va112".
För att lösa det här problemet, använd Linux-skalstil för textbearbetning med Velocity-mallar.
Notera Använd dollartecknet ($) i hastighetsmallarna endast när du deklarerar en variabel.
Jinja: Använd språket Jinja. För information, se https://www.palletsprojects.com/p/jinja/.

e. Välj Programvarutyp från rullgardinsmenyn.
Notera Du kan välja den specifika programvarutypen (som IOS-XE eller IOS-XR) om det finns kommandon som är specifika för dessa programvarutyper. Om du väljer IOS som mjukvarutyp gäller kommandona för alla programvarutyper, inklusive IOS-XE och IOS-XR. Detta värde används under provisionering för att kontrollera om den valda enheten bekräftar valet i mallen.

Gör följande i området Device Type Details:
a. Klicka på länken Lägg till enhetsinformation.
b. Välj Enhetsfamilj från rullgardinsmenyn.
c. Klicka på fliken Enhetsserier och markera kryssrutan bredvid önskad enhetsserie.
d. Klicka på fliken Enhetsmodeller och markera kryssrutan bredvid önskad enhetsmodell.
e. Klicka på Lägg till.

Gör följande i området Ytterligare detaljer:
a. Välj enheten Tags från rullgardinsmenyn.
Notera
Tags är som nyckelord som hjälper dig att hitta din mall lättare.
Om du använder tags för att filtrera mallarna måste du tillämpa detsamma tags till den enhet som du vill använda mallarna på. Annars får du följande fel under provisionering:
Det går inte att välja enheten. Inte kompatibel med mallen
b. Ange mjukvaruversionen i programversionsfältet.
Notera
Under provisioneringen kontrollerar Cisco DNA Center om den valda enheten har den programvaruversion som anges i mallen. Om det finns en oöverensstämmelse tillhandahålls inte mallen.
c. Ange mallbeskrivningen.

Steg 5 Klicka på Fortsätt.
Mallen skapas och visas under tabellen Mallar.
Steg 6 Du kan redigera mallens innehåll genom att välja mallen som du skapade, klicka på ellipsen under kolumnen Åtgärder och välj Redigera mall. För mer information om att redigera mallens innehåll, se Redigera mallar, på sidan 7.

Blockerade listkommandon
Blockerade listkommandon är kommandon som inte kan läggas till i en mall eller tillhandahållas via en mall.
Om du använder blockerade listkommandon i dina mallar, visas en varning i mallen om att den kan komma i konflikt med vissa av Cisco DNA Center-provisioneringsprogrammen.
Följande kommandon är blockerade i den här versionen:

router lisp

värdnamn

Sample mallar

Se dessa sample mallar för switchar samtidigt som du skapar variabler för din mall.

Konfigurera värdnamn
hostname$name

Konfigurera gränssnitt
gränssnitt $interfaceName
beskrivning $beskrivning

Konfigurera NTP på Cisco Wireless Controllers
config tid ntp intervall $intervall

Skapa en sammansatt mall
Två eller flera vanliga mallar grupperas i en sammansatt sekvensmall. Du kan skapa en sammansatt sekventiell mall för en uppsättning mallar, som tillämpas kollektivt på enheter. Till exempelample, när du distribuerar en filial måste du ange minimikonfigurationerna för filialroutern. Mallarna som du skapar kan läggas till i en enda sammansatt mall, som samlar alla individuella mallar som du behöver för filialroutern. Du måste ange i vilken ordning mallar som finns i den sammansatta mallen distribueras till enheter.

Notera
Du kan bara lägga till en engagerad mall till en sammansatt mall.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Klicka på Projektnamn i den vänstra rutan och välj det projekt som du skapar mallar under.
Steg 3 Klicka på Lägg till längst upp till höger i fönstret och välj Ny mall från rullgardinsmenyn.
Ingångsrutan Lägg till ny mall visas.
Steg 4 Konfigurera inställningarna för den sammansatta mallen i inskjutningsfönstret Lägg till ny mall.
Gör följande i området Malldetaljer:
a) Ange ett unikt namn i fältet Mallnamn.
b) Välj projektnamn från rullgardinsmenyn.
c) Malltyp: Välj alternativknapp för sammansatt sekvens.
d) Välj Programvarutyp från rullgardinsmenyn.
Notera
Du kan välja den specifika programvarutypen (som IOS-XE eller IOS-XR) om det finns kommandon som är specifika för dessa programvarutyper. Om du väljer IOS som mjukvarutyp gäller kommandona för alla programvarutyper, inklusive IOS-XE och IOS-XR. Detta värde används under provisionering för att kontrollera om den valda enheten bekräftar valet i mallen.

Steg 5 Klicka på Fortsätt.
Fönstret för sammansatt mall visas, som visar listan över tillämpliga mallar.
Steg 6 Klicka på länken Lägg till mallar och klicka + för att lägga till mallarna och klicka på Klar.
Den sammansatta mallen skapas.
Steg 7 Markera kryssrutan bredvid den sammansatta mallen som du skapade, klicka på ellipsen under kolumnen Åtgärder och välj Bekräfta för att bekräfta mallens innehåll.

Redigera mallar

När du har skapat en mall kan du redigera mallen så att den innehåller innehåll.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 I den vänstra rutan väljer du projektnamnet och väljer mallen som du vill redigera.
Den valda mallen visas.
Steg 3 Ange mallens innehåll. Du kan ha en mall med en enradskonfiguration eller en flervalskonfiguration.
Steg 4 Klicka på Egenskaper bredvid mallens namn högst upp i fönstret för att redigera malldetaljer, enhetsdetaljer och ytterligare detaljer. Klicka på Redigera bredvid respektive område.
Steg 5 Mallen sparas automatiskt. Du kan också välja att ändra tidsintervallet för autospara genom att klicka på återkommande tid bredvid Autosparat.
Steg 6 Klicka på Mallhistorik för att view versionerna av mallen. Du kan också klicka på Jämför med view skillnaden i mallversionerna.
Steg 7 Klicka på fliken Variabler för att view variablerna från CLI-mallen.
Steg 8 Klicka på växlingsknappen Visa designkonflikter för att view potentiella fel i mallen.
Cisco DNA Center låter dig view, potentiella fel och körtidsfel. För mer information, se Potentiella designkonflikter Detektering mellan CLI-mall och tjänsteförsörjningsavsikt, på sidan 21 och Detektera CLI-mallkörningskonflikt, på sidan 21.
Steg 9 Klicka på Spara längst ned i fönstret.
Efter att ha sparat mallen söker Cisco DNA Center efter eventuella fel i mallen. Om det finns några syntaxfel sparas inte mallens innehåll och alla indatavariabler som definieras i mallen identifieras automatiskt under sparprocessen. De lokala variablerna (variabler som används för loopar, tilldelade genom en uppsättning och så vidare) ignoreras.
Steg 10 Klicka på Bekräfta för att bekräfta mallen.
Notera Du kan bara koppla en engagerad mall till ett nätverksproffsfile.
Steg 11 Klicka på Bifoga till Network Profile länk, för att bifoga den skapade mallen till ett nätverksproffsfile.

Mallsimulering
Den interaktiva mallsimuleringen låter dig simulera CLI-genereringen av mallar genom att specificera testdata för variabler innan du skickar dem till enheter. Du kan spara testsimuleringsresultaten och använda dem senare om det behövs.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Från den vänstra rutan väljer du ett projekt och klickar på en mall som du vill köra en simulering för.
Mallen visas.
Steg 3 Klicka på fliken Simulering.
Steg 4 Klicka på Skapa simulering.
Ingångsrutan Skapa simulering visas.
Steg 5 Ange ett unikt namn i fältet Simuleringsnamn.

Notera
Om det finns implicita variabler i din mall, välj sedan en enhet från rullgardinsmenyn Enhet för att köra simuleringen mot riktiga enheter baserat på dina bindningar.

Steg 6 Klicka på Importera mallparametrar för att importera mallparametrarna eller klicka på Exportera mallparametrar för att exportera mallparametrarna.
Steg 7 Om du vill använda variablerna från den senaste enhetsadministrationen klickar du på Använd variabelvärden från länken Senaste provisionering. Nya variabler måste läggas till manuellt.
Steg 8 Välj värden för variablerna genom att klicka på länken och klicka på Kör.

Exportera mall(ar)

Du kan exportera en mall eller flera mallar till en file, i JSON-format.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Markera en kryssruta eller flera kryssrutor bredvid mallens namn för att välja en mall eller flera mallar som du vill exportera.
Steg 3 Välj Exportera mall i rullgardinsmenyn Exportera.
Steg 4 (Valfritt) Du kan filtrera mallarna baserat på kategorier i den vänstra rutan.
Steg 5 Den senaste versionen av mallen exporteras.
För att exportera en tidigare version av mallen, gör följande:
a. Klicka på mallens namn för att öppna mallen.
b. Klicka på fliken Mallhistorik.
Ingångsrutan Mallhistorik visas.
c. Välj önskad version.
d. Klick View knappen under versionen.
CLI-mallen för den versionen visas.
e. Klicka på Exportera högst upp i mallen.

JSON-formatet för mallen exporteras.

Importera mall(ar)

Du kan importera en mall eller flera mallar under ett projekt.

Notera
Du kan endast importera mallar från en tidigare version av Cisco DNA Center till en nyare version. Det motsatta är dock inte tillåtet.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 I den vänstra rutan väljer du projektet som du vill importera mallar för, under Projektnamn och väljer Importera > Importera mall.
Steg 3 Ingångsrutan Importera mallar visas.
a. Välj projektnamn från rullgardinsmenyn.
b. Ladda upp JSON file genom att göra någon av följande åtgärder:

Dra och släpp file till dra och släpp-området.
Klicka, välj en file, bläddra till platsen för JSON fileoch klicka på Öppna.

File storleken bör inte överstiga 10 Mb.
c. Markera kryssrutan för att skapa en ny version av den importerade mallen, om mallen med samma namn redan finns i hierarkin.
d. Klicka på Importera.
CLI-mallen har importerats till det valda projektet.

Klona en mall

Du kan göra en kopia av en mall för att återanvända delar av den.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Klicka på ellipsen under kolumnen Åtgärd och välj Klona.
Steg 3 Ingångsrutan för klonmall visas.
Gör följande:
a. Ange ett unikt namn i fältet Mallnamn.
b. Välj projektnamn från rullgardinsmenyn.
Steg 4 Klicka på Klona.
Den senaste versionen av mallen är klonad.
Steg 5 (Valfritt) Alternativt kan du klona mallen genom att klicka på mallens namn. Mallen visas. Klick
Klona ovanför mallen.
Steg 6 För att klona en tidigare version av mallen, gör följande:
a. Välj mallen genom att klicka på mallens namn.
b. Klicka på fliken Mallhistorik.
Ingångsrutan Mallhistorik visas.
c. Klicka på önskad version.
Den valda CLI-mallen visas.
d. Klicka på Klona ovanför mallen.

Bifoga en CLI-mall till Network Profiles

För att tillhandahålla en CLI-mall måste den kopplas till ett nätverksproffsfile. Använd denna procedur för att bifoga en CLI-mall till ett nätverksproffsfile eller flera nätverksproffsfiles.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Fönstret Template Hub visas.
Steg 2 Klicka på Bifoga under Network Profile kolumn för att bifoga en mall till nätverksproffsfile.
Notera
Alternativt kan du klicka på ellipsen under kolumnen Åtgärder och välja Bifoga till Profile eller så kan du bifoga en mall till Network Profile från Design> Network Profiles. För mer information, se Associera mallar till Network Profiles, på sidan 19.
Koppla till Network Profile inskjutningsrutan visas.
Steg 3 Markera kryssrutan bredvid nätverksproffsetfile namn och klicka på Spara.
CLI-mallen är ansluten till den valda Network Profile.
Steg 4 Ett nummer visas under Network Profile kolumn, som visar antalet nätverksproffsfiles som en CLI-mall är ansluten till. Klicka på numret för att view nätverksproffsetfile detaljer.
Steg 5 För att bifoga fler nätverksproffsfiles till en CLI-mall gör du följande:
a. Klicka på numret under Network Profile kolumn.
Alternativt kan du klicka på ellipsen under kolumnen Åtgärder och välja Bifoga till Profile.
Network Profiles inskjutningsruta visas.
b. Klicka på Bifoga till Network Profile länken längst upp till höger i inskjutningsrutan och markera kryssrutan bredvid Network Profile namn och klicka på Bifoga.

Tillhandahållande CLI-mallar

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Markera kryssrutan bredvid mallen du vill tillhandahålla och klicka på Provisionsmallar högst upp i tabellen.
Du kan välja att tillhandahålla flera mallar.
Du omdirigeras till arbetsflödet för Provisionsmall.
Steg 3 I fönstret Kom igång anger du ett unikt namn i fältet Uppgiftsnamn.
Steg 4 I fönstret Välj enheter väljer du enheterna från listan över tillämpliga enheter, som är baserade på enhetsinformationen som definieras i mallen och klickar på Nästa.
Steg 5 Där inneview Fönstret Tillämpliga mallar, angview enheterna och mallarna som är anslutna till den. Om det behövs kan du ta bort mallarna som du inte vill ska tillhandahållas på enheten.
Steg 6 Konfigurera mallvariablerna för varje enhet i fönstret Konfigurera mallvariabler.
Steg 7 Välj den enhet som ska preview konfigurationen tillhandahålls på enheten, i Preview Konfigurationsfönster.
Steg 8 I fönstret Schemalägg uppgift väljer du om du vill tillhandahålla mallen nu eller schemalägga tillhandahållandet för en senare tid och klicka på Nästa.
Steg 9 I fönstret Sammanfattning, review mallkonfigurationerna för dina enheter, klicka på Redigera för att göra ändringar; annars klicka på Skicka.
Dina enheter kommer att tillhandahållas med mallen.

Exportera projekt

Du kan exportera ett projekt eller flera projekt, inklusive deras mallar, till en enda file i JSON-format.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 I den vänstra rutan väljer du ett projekt eller flera projekt som du vill exportera under Projektnamn.
Steg 3 Välj Exportera projekt i rullgardinsmenyn Exportera.
Steg 4 Klicka på Spara om du uppmanas.

Importera projekt

Du kan importera ett projekt eller flera projekt med deras mallar till Cisco DNA Center Template Hub.

Notera
Du kan endast importera projekt från en tidigare version av Cisco DNA Center till en nyare version. Det motsatta är dock inte tillåtet.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Välj Importera projekt i listrutan Importera.
Steg 3 Ingångsfönstret Importera projekt visas.
a. Ladda upp JSON file genom att göra någon av följande åtgärder:

Dra och släpp file till dra och släpp-området.

Klicka på Välj en file, bläddra till platsen för JSON fileoch klicka på Öppna.

File storleken bör inte överstiga 10 Mb.
b. Markera kryssrutan för att skapa en ny version av mallen, i det befintliga projektet, om projektet med samma namn redan finns i hierarkin.
c. Klicka på Importera.
Projektet har importerats.

Mallvariabler

Mallvariablerna används för att lägga till ytterligare metadatainformation till mallvariablerna i mallen. Du kan också använda variablerna för att tillhandahålla valideringar för variabler som maximal längd, intervall och så vidare.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Från den vänstra rutan väljer du ett projekt och klickar på en mall.
Mallen visas.
Steg 3 Klicka på fliken Variabler.
Det låter dig lägga till metadata till mallvariablerna. Alla variabler som identifieras i mallen visas.
Du kan konfigurera följande metadata:

Välj variabeln från den vänstra rutan och klicka på växlingsknappen Variabel om du vill att strängen ska betraktas som en variabel.
Notera
Som standard betraktas strängen som en variabel. Klicka på växlingsknappen om du inte vill att strängen ska betraktas som en variabel.
Markera kryssrutan Required Variable om detta är en obligatorisk variabel under provisioneringen. Alla variabler är som standard markerade som Obligatoriska, vilket innebär att du måste ange värdet för denna variabel vid tidpunkten för provisionering. Om parametern inte är markerad som Required Variable och om du inte skickar något värde till parametern, ersätter den en tom sträng vid körning. En brist på en variabel kan leda till kommandofel, vilket kanske inte är syntaktisk korrekt.
Om du vill göra ett helt kommando valfritt baserat på en variabel som inte är markerad som Required Variable, använd if-else-blocket i mallen.

Ange fältnamnet i fältnamnet. Det här är etiketten som används för gränssnittswidgeten för varje variabel under provisionering.
I området Variabelt datavärde väljer du Variabel datakälla genom att klicka på alternativknappen. Du kan välja, Användardefinierat värde eller Bound to Source-värde för att hålla ett specifikt värde.

Gör följande om du väljer Användardefinierat värde:
a. Välj variabeltyp från rullgardinsmenyn: String, Heltal, IP-adress eller Mac-adress
b. Välj datainmatningstyp från rullgardinsmenyn: Textfält, Enkelval eller Flerval.
c. Ange standardvariabelvärdet i fältet Standardvariabelvärde.
d. Markera kryssrutan Känsligt värde för känsligt värde.
e. Ange antalet tecken som är tillåtna i fältet Maximalt antal tecken. Detta är endast tillämpligt för strängdatatypen.
f. Ange tipstext i fältet Tipstext.
g. Ange eventuell ytterligare information i textrutan Ytterligare information.
Gör följande om du väljer Bound to Source-värde:
a. Välj datainmatningstyp från rullgardinsmenyn: Textfält, Enkelval eller Flerval.
b. Välj Källa från rullgardinsmenyn: Network Profile, Vanliga inställningar, Cloud Connect och Inventering.
c. Välj Entitet från rullgardinsmenyn.
d. Välj Attribut från rullgardinsmenyn.
e. Ange antalet tecken som är tillåtna i fältet Maximalt antal tecken. Detta är endast tillämpligt för strängdatatypen.
f. Ange tipstext i fältet Tipstext.
g. Ange eventuell ytterligare information i textrutan Ytterligare information.
För mer information om Bound to Source-värde, se Variabelbindning, på sidan 13.

Steg 4 När du har konfigurerat metadatainformation klickar du på Review Blankett för att återview den variabla informationen.
Steg 5 Klicka på Spara.
Steg 6 För att commitera mallen, välj Commit. Fönstret Commit visas. Du kan ange en commit note i textrutan Commit Note.

Variabel bindning
När du skapar en mall kan du ange variabler som ersätts kontextuellt. Många av dessa variabler är tillgängliga i mallhubben.

Template Hub ger ett alternativ att binda eller använda variabler i mallen med källobjektets värden under redigering eller genom förbättringar av inmatningsformuläret; till exempelample, DHCP-server, DNS-server och syslog-server.
Vissa variabler är alltid bundna till sin motsvarande källa och deras beteende kan inte ändras. Till view listan över implicita variabler, klicka på mallen och klicka på fliken Variabler.
De fördefinierade objektvärdena kan vara något av följande:

Network Profile
• SSID
• Policy profile
• AP-grupp
• Flexgrupp
• Flex profile
• Webbplats tag
• Policy tag
Vanliga inställningar
• DHCP-server
• Syslog-server
• SNMP-fälla-mottagare
• NTP-server
• Tidszonsplats
• Enhetsbanner
• DNS-server
• NetFlow-samlare
• AAA-nätverksserver
• AAA-slutpunktsserver
• AAA-servernätverk
• AAA-serverpanoreringsändpunkt
• WLAN-information
• RF profile info
Cloud Connect
• Molnrouter-1 Tunnel IP
• Molnrouter-2 Tunnel IP
• Molnrouter-1 Loopback IP
• Molnrouter-2 Loopback IP
• Branch router-1 Tunnel IP
• Branch router-2 Tunnel IP
• Molnrouter-1 Public IP
• Molnrouter-2 Public IP
• Filialrouter-1 IP
• Filialrouter-2 IP
• Privat subnät-1 IP
• Privat subnät-2 IP
• Privat subnät-1 IP-mask
• Privat subnät-2 IP-mask

Lager
• Enhet
• Gränssnitt
• AP-grupp
• Flexgrupp
• WLAN
• Policy profile
• Flex profile
• Webauth parameterkarta
• Webbplats tag
• Policy tag
• RF profile

• Vanliga inställningar: Inställningar tillgängliga under Design> Nätverksinställningar> Nätverk. Den gemensamma inställningsvariabelbindningen löser värden som är baserade på den plats som enheten tillhör.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Steg 2 Välj mallen och klicka på fliken Variabler för att binda variabler i mallen till nätverksinställningar.
Steg 3 Välj variablerna i den vänstra rutan och markera kryssrutan Required Variable för att binda variabler till nätverksinställningarna.
Steg 4 För att binda variabler till nätverksinställningar, välj varje variabel från den vänstra rutan och välj alternativknappen Bund till källa under Variabel datakälla och gör följande:
a. Från rullgardinsmenyn Datainmatningstyp väljer du vilken typ av UI-widget som ska skapas vid tidpunkten för provisionering: Textfält, Enkelval eller Flerval.
b. Välj Källa, Entitet och Attribut från respektive rullgardinslistor.
c. För källtypen CommonSettings, välj en av dessa enheter: 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 eller rfprofile.info.
Du kan använda ett filter på attributen dns.server eller netflow.collector för att endast visa den relevanta listan med bindningsvariabler under provisionering av enheter. För att tillämpa ett filter på ett attribut, välj ett attribut från rullgardinsmenyn Filtrera efter. I listrutan Villkor väljer du ett villkor som matchar värdet.
d. För källtypen NetworkProfile, välj SSID som enhetstyp. SSID-entiteten som är ifylld definieras under Design> Network Profile. Bindningen genererar ett användarvänligt SSID-namn, som är en kombination av SSID-namn, plats och SSID-kategori. Välj wlanid eller wlanPro i listrutan AttributfileNamn. Det här attributet används under de avancerade CLI-konfigurationerna vid tidpunkten för leverans av mall.
e. För källtypen Inventering, välj en av dessa enheter: Device, Interface, AP Group, Flex Group, Wlan, Policy Profile, Flex Profile, Webauth Parameterkarta, webbplats Tag, Policy Tag, eller RF Profile. För enhetstypen Enhet och gränssnitt visar listrutan Attribut enhetens eller gränssnittsattributen. Variabeln löser sig till AP Group och Flex Group-namnet som är konfigurerat på enheten som mallen tillämpas på.
Du kan använda filter på attributen Device, Interface eller Wlan för att endast visa den relevanta listan med bindningsvariabler under provisionering av enheter. För att tillämpa ett filter på ett attribut, välj ett attribut från rullgardinsmenyn Filtrera efter. I listrutan Villkor väljer du ett villkor som matchar värdet.

Efter bindning av variabler till en gemensam inställning, när du tilldelar mallar till ett trådlöst proffsfile och tillhandahåller mallen, nätverksinställningarna som du definierade under Nätverksinställningar> Nätverk visas i rullgardinsmenyn. Du måste definiera dessa attribut under Nätverksinställningar> Nätverk när du utformar ditt nätverk.

Steg 5
Om mallen innehåller variabelbindningar som binder till specifika attribut och mallkoden kommer åt dessa attribut direkt, måste du göra något av följande:

Ändra bindningen till objektet istället för till attributen.

Uppdatera mallkoden för att inte komma åt attributen direkt.

Till exempelample, om mallkoden är som följer, där $interfaces binder till specifika attribut, måste du uppdatera koden som visas i följande example, eller ändra bindningen till objektet istället för till attributen.
Gamla sample kod:

#foreach ( $interface i $interfaces )
$interface.portName
beskrivning "något"
#avsluta

Nytt sample kod:

#foreach ( $interface i $interfaces )
gränssnitt $gränssnitt
beskrivning "något"
#avsluta

Särskilda nyckelord

Alla kommandon som körs via mallar är alltid i konfigurationsläget. Därför behöver du inte ange enable- eller configt-kommandona uttryckligen i mallen.
Dag-0-mallar stöder inte speciella nyckelord.

Aktivera lägeskommandon
Ange kommandot #MODE_ENABLE om du vill utföra några kommandon utanför kommandot configt.

Använd denna syntax för att lägga till kommandon för aktiveringsläge till dina CLI-mallar:
#MODE_ENABLE
< >
#MODE_END_ENABLE

Interaktiva kommandon
Ange #INTERACTIVE om du vill utföra ett kommando där en användarinmatning krävs.
Ett interaktivt kommando innehåller indata som du måste ange efter att ett kommando har körts. För att ange ett interaktivt kommando i CLI-innehållsområdet, använd följande syntax:

CLI kommando interaktiv fråga 1 kommandosvar 1 interaktiv fråga 2 kommandosvar 2
Var och tags utvärdera den tillhandahållna texten mot vad som syns på enheten.
Den interaktiva frågan använder reguljära uttryck för att verifiera om texten som tas emot från enheten liknar den inmatade texten. Om de reguljära uttrycken anges i tags hittas, då passerar den interaktiva frågan och en del av utdatatexten visas. Det betyder att du behöver ange en del av frågan och inte hela frågan. Ange Ja eller Nej mellan och tags räcker men du måste se till att texten Ja eller Nej visas i frågeutmatningen från enheten. Det bästa sättet att göra detta är genom att köra kommandot på enheten och observera utdata. Dessutom måste du se till att alla reguljära uttrycksmetatecken eller nyrader som anges används korrekt eller undviks helt. De vanliga reguljära uttryckets metatecken är . ( ) [ ] { } | *+? \ $^ : &.

Till exempelample, följande kommando har utdata som inkluderar metatecken och nyrader.

Switch(config)# no crypto pki trustpoint DNAC-CA
% Om du tar bort en registrerad förtroendepunkt kommer alla certifikat som tas emot från den relaterade certifikatutfärdaren att förstöras
Är du säker på att du vill göra det här? [Ja Nej]:

För att mata in detta i en mall måste du välja en del som inte har några metatecken eller nyrader.
Här är några examples om vad som kan användas.

#INTERAKTIV
ingen crypto pki trustpoint DNAC-CA Ja Nej ja
#ENDS_INTERACTIVE

#INTERAKTIV
ingen crypto pki trustpoint DNAC-CA Ta bort en inskriven ja
#ENDS_INTERACTIVE

#INTERAKTIV
ingen krypto pki trustpoint DNAC-CA Är du säker på att du vill göra detta ja
#ENDS_INTERACTIVE

#INTERAKTIV
kryptonyckel genererar allmänna rsa-nycklar Ja Nej Nej
#ENDS_INTERACTIVE

Var och tags är skiftlägeskänsliga och måste anges med versaler.

Notera
Som svar på den interaktiva frågan efter att ha lämnat ett svar, om nyradstecknet inte krävs, måste du ange tag. Inkludera ett mellanslag före tag. När du går in i tag, den tag dyker upp automatiskt. Du kan ta bort tag för det behövs inte.

Till exempelampde:
#INTERAKTIV
config avancerade timers ap-fast-heartbeat local enable 20 Ansök(y/n)? y
#ENDS_INTERACTIVE

Kombinera kommandon för interaktivt aktiveringsläge
Använd den här syntaxen för att kombinera interaktiva kommandon för aktiveringsläge:

#MODE_ENABLE
#INTERAKTIV
kommandon interaktiv fråga svar
#ENDS_INTERACTIVE
#MODE_END_ENABLE

#MODE_ENABLE
#INTERAKTIV
mkdir Skapa katalog xyz
#ENDS_INTERACTIVE
#MODE_END_ENABLE

Flerradskommandon
Om du vill att flera rader i CLI-mallen ska radbrytas, använd MLTCMD tags. Annars skickas kommandot rad för rad till enheten. För att ange flerradskommandon i CLI-innehållsområdet, använd följande syntax:

första raden i flerradskommandot
andra raden i flerradskommandot
…
…
sista raden i flerradskommandot

Var och är skiftlägeskänsliga och måste skrivas med versaler.

Flerradskommandona måste infogas mellan och tags.
De tags kan inte börja med ett mellanslag.
De och tags kan inte användas på en enda rad.

Koppla mallar till Network Profiles

Innan du börjar
Innan du tillhandahåller en mall, se till att mallen är associerad med ett nätverksproffsfile och proffsetfile är tilldelad en webbplats.
Under provisionering, när enheterna är tilldelade till specifika platser, mallarna som är associerade med webbplatsen via nätverksproffsetfile visas i den avancerade konfigurationen.

Steg 1

Klicka på menyikonen () och välj Design> Network Profiles och klicka på Add Profile.
Följande typer av proffsfiles är tillgängliga:

Assurance: Klicka här för att skapa ett Assurance-proffsfile.
Brandvägg: Klicka här för att skapa ett brandväggsproffsfile.
Routing: Klicka här för att skapa ett routingproffsfile.

Byte: Klicka här för att skapa ett bytesproffsfile.
• Klicka på Onboarding-mallar eller Day-N-mallar efter behov.
• I Profile Namnfält, ange proffsetfile namn.
• Klicka på +Lägg till mall och välj enhetstyp, tag, och mall från enhetstypen, Tag rullgardinslistor Namn och mall.
Om du inte ser mallen du behöver, skapa en ny mall i Template Hub. Se Skapa en vanlig mall, på sidan 3.
• Klicka på Spara.
Telemetry Appliance: Klicka här för att skapa en Cisco DNA Traffic Telemetry Appliance-proffsfile.
Trådlöst: Klicka här för att skapa ett trådlöst proffsfile. Innan du tilldelar ett trådlöst nätverksproffsfile till en mall, se till att du har skapat trådlösa SSID:n.
• I Profile Namnfält, ange proffsetfile namn.
• Klicka på+ Lägg till SSID. De SSID som skapades under Nätverksinställningar >Trådlöst är ifyllda.
• Under Bifoga mall(ar), från rullgardinsmenyn Mall väljer du den mall som du vill tillhandahålla.
• Klicka på Spara.

Notera
Du kan view Switching and Wireless-proffsetfiles i korten och tabellen view.

Steg 2 Network Profiles fönster listar följande:

Profile Namn

Typ
Version
Skapad av

Webbplatser: Klicka på Tilldela webbplats för att lägga till webbplatser till det valda proffsetfile.

Steg 3
För Day-N provisionering, välj Provision > Network Devices > Inventory och gör följande:
a) Markera kryssrutan bredvid enhetsnamnet som du vill tillhandahålla.
b) Från rullgardinsmenyn Åtgärder, välj Provision.
c) I fönstret Tilldela plats, tilldela en plats som proffsenfiles är bifogade.
d) I fältet Välj en plats anger du namnet på den plats som du vill associera styrenheten till, eller välj från rullgardinsmenyn Välj en plats.
e) Klicka på Nästa.
f) Konfigurationsfönstret visas. I fältet Managed AP Locations anger du de AP-platser som hanteras av styrenheten. Du kan ändra, ta bort eller omtilldela webbplatsen. Detta gäller endast för trådlösa profiles.
g) Klicka på Nästa.
h) Fönstret Avancerad konfiguration visas. Mallarna som är associerade med webbplatsen via nätverksproffsfile visas i den avancerade konfigurationen.

Markera kryssrutan Tillhandahåll dessa mallar även om de har distribuerats innan om du skrev över några konfigurationer från avsikt i mallen och du vill att dina ändringar ska åsidosättas. (Det här alternativet är inaktiverat som standard.)

Alternativet Copy running config to startup config är aktiverat som standard, vilket innebär att efter att ha distribuerat mallkonfigurationen kommer skrivminne att tillämpas. Om du inte vill använda den körande konfigurationen på startkonfigurationen måste du avmarkera den här kryssrutan.
Använd sökfunktionen för att snabbt söka efter enheten genom att ange enhetsnamnet, eller expandera mappen mallar och välj mallen i den vänstra rutan. I den högra rutan väljer du värden för de attribut som är bundna till källan.
För att exportera mallvariablerna till en CSV file medan du distribuerar mallen klickar du på Exportera i den högra rutan.
Du kan använda CSV file för att göra nödvändiga ändringar i variabelkonfigurationen och importera den till Cisco DNA Center vid ett senare tillfälle genom att klicka på Importera i den högra rutan.

i) Klicka på Nästa för att distribuera mallen.
j) Välj om du vill distribuera mallen nu eller schemalägga den för senare.
Kolumnen Status i fönstret Enhetsinventering visar SUCCESS efter att distributionen har lyckats.

Steg 4 Klicka på Exportera distributions-CSV för att exportera mallvariabler från alla mallar i en enda file.
Steg 5 Klicka på Importera distributions-CSV för att importera mallvariabler från alla mallar i en enda file.
Steg 6 För Day-0 provisionering, välj Provision> Plug and Play och gör följande:
a) Välj en enhet från rullgardinsmenyn Åtgärder och välj Anspråk.
b) Klicka på Nästa och i Site Assignment-fönstret väljer du en plats från rullgardinsmenyn Site.
c) Klicka på Nästa och välj bilden och mallen Dag-0 i konfigurationsfönstret.
d) Klicka på Nästa och ange platsen i fönstret Avancerad konfiguration.
e) Klicka på Nästa view Enhetsdetaljer, Bilddetaljer, Dag-0-konfiguration Preview, och Template CLI Preview.

Upptäck konflikter i en CLI-mall

Cisco DNA Center låter dig upptäcka konflikter i en CLI-mall. Du kan view potentiella designkonflikter och körtidskonflikter för switching, SD-Access eller tyg.

Potentiella designkonflikter Detektering mellan CLI-mall och tjänsteförsörjningsavsikt

Potentiella designkonflikter identifierar avsiktskommandona i CLI-mallen och flaggar dem, om samma kommando trycks av switching, SD-Access eller fabric. Avsiktskommandon rekommenderas inte för användning, eftersom de är reserverade för att skickas till enheten av Cisco DNA Center.

Steg 1 Klicka på menyikonen () och välj Verktyg > Mallnav.
Fönstret Template Hub visas.
Steg 2 I den vänstra rutan klickar du på projektnamnet från rullgardinsmenyn till view CLI-mallarna för det föredragna projektet.
Till view endast mallarna med konflikter, i den vänstra rutan, under Potentiella designkonflikter, kontrollera
Notera
Kryssrutan Konflikter.
Steg 3 Klicka på mallens namn.
Alternativt kan du klicka på varningsikonen under kolumnen Potentiella designkonflikter. Det totala antalet konflikter visas.
CLI-mallen visas.
Steg 4 I mallen flaggas CLI-kommandon som har konflikter med en varningsikon. Håll muspekaren över varningsikonen till view detaljerna i konflikten.
För nya mallar upptäcks konflikterna efter att du har sparat mallen.
Steg 5 (Valfritt) Klicka på Visa designkonflikter för att visa eller dölja konflikterna.
Steg 6 Klicka på menyikonen () och välj Provision> Inventory to view antalet CLI-mallar med konflikter. I inventeringsfönstret visas ett meddelande med en varningsikon som visar antalet konflikter i den nykonfigurerade CLI-mallen. Klicka på länken Uppdatera CLI-mallar till view konflikterna.

Upptäck CLI Template Run-Time Conflict

Cisco DNA Center låter dig upptäcka körtidskonflikt för växling, SD-åtkomst eller tyg.

Innan du börjar
Du måste konfigurera CLI-mallen via Cisco DNA Center för att upptäcka körtidskonflikt.

Steg 1 Klicka på menyikonen () och välj Provision> Inventory.
Inventeringsfönstret visas.
Steg 2 View enhetsstatus för malladministration under kolumnen Template Provision Status, som visar antalet mallar som tillhandahålls för enheten. Mallarna som tillhandahålls framgångsrikt visas med en bockikon.
Mallarna som har konflikter visas med en varningsikon.
Steg 3 Klicka på länken under kolumnen Template Provision Status för att öppna rutan Mall Status.

Du kan view följande information i tabellen:

Mallnamn
Projektnamn
Tillhandahållandestatus: Visar mall tillhandahållen om mallen har tillhandahållits framgångsrikt eller mall ej synkroniserad om det finns några konflikter i mallen.
Konfliktstatus: Visar antalet konflikter i CLI-mallen.
Åtgärder: Klicka View Konfiguration till view CLI-mallen. Kommandon som har konflikter flaggas med en varningsikon.

Steg 4 (Frivillig) View antalet konflikter i en CLI-mall under kolumnen Template Conflicts Status i Inventory-fönstret.
Steg 5 Identifiera körtidskonflikterna genom att generera en konfigurationspreview:
a) Markera kryssrutan bredvid enhetens namn.
b) Från rullgardinsmenyn Åtgärder, välj Provision Device.
c) Klicka på Nästa i fönstret Tilldela plats. I fönstret Avancerad konfiguration gör du nödvändiga ändringar och klickar på Nästa. Klicka på Distribuera i fönstret Sammanfattning.
d) Klicka på Generate Configuration Preview alternativknappen och klicka på Använd.
e) Klicka på länken Work Items till view den genererade konfigurationen preview. Alternativt, klicka på menyikonen () och välj Aktiviteter >Arbetsobjekt till view den genererade konfigurationen preview.
f) Om aktiviteten fortfarande laddas, klicka på Uppdatera.
g) Klicka på preview länk för att öppna Configuration Preview inskjutbar ruta. Du kan view CLI-kommandona med körtidskonflikter flaggade med varningsikoner.

Dokument/resurser

	CISCO Skapa mallar för att automatisera enhetsprogramvara [pdf] Användarhandbok Skapa mallar för att automatisera enhetsprogramvara, mallar för att automatisera enhetsprogramvara, automatisera enhetsprogramvara, enhetsprogramvara, programvara
	CISCO Skapa mallar för att automatisera enhet [pdf] Användarhandbok Skapa mallar för att automatisera enhet, mallar för att automatisera enhet, automatisera enhet, enhet

Referenser

Användarmanual

Skapa mallar för att automatisera enhetsprogramvara

Om Template Hub