Tillgänglighet:
Zero-Touch Provisioning (ZTP) är allmänt tillgängligt (GA) för enheter som stöds och kör RoomOS 26.5.0 eller senare.
Viktiga fördelar
- Automatisk enhetsregistrering: Enh eter kan anslutas med sin MAC-adress när de tilldelas en delad arbetsyta eller ett personligt användarkonto, vilket minskar behovet av manuell aktiveringskod när MAC-adress onboarding används. Drift Webex Edge sättningar som stöds kan använda samma process med Premises Calling.
- Förenklad installation: Med hjälp av Control Hubs standardinställningar och förkonfigurationer effektiviseras FTW-upplevelsen (First Time Wizard), vilket avsevärt minskar de manuella stegen vid installation av fysiska enheter.
- Effektiva massoperationer: Enh eter kan läggas till i bulk genom att importera CSV-filer som innehåller MAC-adresser, vilket möjliggör storskaliga distributioner med minimal ansträngning.
- Föraktiveringsförmåga: Enheter kan aktiveras i förväg, även innan de ansluter till nätverket. Enheter kan vara förinställda för en arbetsyta eller ett personligt användar konto.
- Minskad onboarding-komplexitet: Genom att automatisera nätverksinstallation och enhetstill delning minskar ZTP den tid, kostnad och komplexitet som traditionellt förknippas med enhetsinställningar.
Viktiga villkor för onboarding av enheter i Control Hub
- Ej hämtad: Enhetens MAC-adress är inte registrerad i organisationen.
- Påstådd: Enhetens MAC-adress har lagts till i organisationen.
- Ej tilldelad: En angiven enhet som ännu inte har länkats till en arbetsyta eller ett personligt användarkonto.
- Tilldelad: En angiven enhet som är länkad till antingen en arbetsyta eller ett personligt användar konto.
- Väntande: Statusen som visas i Control Hub för en enhet som har hävdats och/eller tilldelats men ännu inte har aktiverats.
- Förkonfiguration: Proc essen att tillämpa enhetskonfigurationsinställningar på en väntande enhet innan den ansluter till nätverket eller kommer online.
- Aktiverad: Enheten har slutfört tillämplig Webex- eller Webex Edge aktiveringsprocess.
- Personlig enhet: En enhet som tilldelats ett användarkonto i stället för till en arbetsyta.
- Webex Edge: En distributionsmodell där enheten förblir registrerad i lokal infrastruktur samtidigt som den får molnfunktioner och hantering som stöds. Se Webex Edgedokumentation.
Krav
Se till att din miljö uppfyller dessa krav innan du distribuerar:
- Programversion: Enh eter måste köra RoomOS 26.5.0 eller senare. RoomOS 11 stöds inte.
- Nätverksanslutning: Enheter kräver tillförlitlig nätverksåtkomst med anslutning till Webex-tjänster.
- Konfigurationsinställningar: Definiera standard för organisation och plats i Control Hub för tidsformat, tidszon och språk för att minimera introduktionsanvisningar under guiden Första gången (FTW).
För personligt läge måste användaren redan finnas i Control Hub innan enheten tilldelas.
För Webex Edge ZTP måste CUCM/TFTP-identifiering vara tillgänglig där distributionen kräver det
, inklusive DHCP-alternativ 150 när det används. Validera beteendet hos
AllowDataLogging och lösa eventuella konflikter mellan CUCM-kontrollerade och
Control Hub-kontrollerade konfigurationer innan onboarding.
Förutsättningar: Uppgradering till minsta version för Zero Touch-aktivering
För att uppgradera till version 26.5 måste du utföra uppgraderingen manuellt för tillfället. Under de kommande månaderna kommer en pre-omborduppgraderingsfunktion att automatisera denna process, och fabriksbilder kommer att uppdateras därefter. Fram till dess måste kunderna uppgradera med hjälp av paketlänkarna eller xcommandgränssnittet för att installera uppdateringen, följt av att utföra en fabriksåterställning för att slutföra processen.
Programversion under onboarding: Om en enhet ligger under FTW- onboardingversionen kan ZTP uppgradera den före registrering. Denna uppgradering sker oberoende av programvarukanalen för arbetsytan, inklusive en kanal inställd genom konfigurationen av hängande enhet . När ZTP har slutförts tillämpas arbetsytans normala programregler och enheten kan uppgraderas eller nedgraderas till den version som krävs av den kanalen. Detta beteende förväntas. Microsoft Teams Rooms-enheter: Om ZTP uppgraderar en MTR-enhet till en version som är senare än den version som tilldelats dess Microsoft Approved kanal nedgraderas inte enheten automatiskt när den körs i MTR-läge.
Paketmappning och kommandon
Välj lämpligt paket baserat på din hårdvara. Använd den medföljande
XCommand för att initiera uppgraderingen.
| Enhetskategori | Paketnamn |
|---|---|
| Cisco Room Navigator |
bifrost.pkg
|
| Nyare produkter (Codec Pro G2, Desk Pro G2) |
luna.pkg
|
| Standard RoomOS-slutpunkter (rumsbar, rumssats EQ, Board Pro, skrivbord, Codec Pro) |
zenith.pkg
|
För CiscoRoom Navigator:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/bifrost.pkg" Forced: True
För Codec Pro G2 och Desk Pro G2:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/luna.pkg" Forced: True
För Room Bar, Room Kit EQ, Board Pro, Desk och Codec Pro:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/zenith.pkg" Forced: True
Initiera Zero Touch-aktivering via CLI
Du kan manuellt utlösa Zero Touch Activation-processen med kommandoradsgränssnittet (CLI) eller API. Använd följande kommando för att starta arbets flödet:
xCommand Webex Registration ZeroTouchProvisioning Start SecurityAction: <Harden, NoAction>
Parameters:
Harden: Applies enhanced security settings to the device during the activation process.
NoAction: Proceeds with the activation using the current device security configuration.
Inställningssteg i Control Hub
-
Konfigurera standardvärden
Att ställa in standardinställningar hjälper enheten att hoppa över manuella inställningssteg under onboarding. Navigera till Control Hub och konfigurera följande:
- Tid -> TimeFormat (t.ex. 12h/24h)
- Tid -> Zon (t.ex. America/New_York)
- Användargränssnitt -> Språk (t.ex. Engelska)
Alternativt kan du tilldela arbetsytan till den plats där standardinställningarna är konfigurerade eller tillämpa standardvärdena för hela organisationen.
Innan du använder Zero Touch Activation, kontrollera att enheten inte kräver hybridsamtal. Enheter som kräver hybridsamtal måste anslutas med hjälp av aktiveringskod eller manuell onboarding-arbetsflöde.
-
Lägg till enheten med MAC-adress
- Gå till Control Hub -> Enheter -> Lägg till enhet (eller Skapa arbetsyta). Du kan också börja från Använ dare, välja en användare, öppna fliken Enh eter och välj Lägg till enhet.
- Välj Cisco Room eller Desk Dev ice, välj Delad användning eller Personlig användning och välj MAC-adress. Ange den trådbundna Ethernet-MAC-adressen, produkttypen och plattformen (RoomOS eller Microsoft Teams). Om du väljer Microsoft Teams installeras plattformen automatiskt när guiden är klar.
- För en personlig enhet väljer du det användarkonto som du vill tilldela den till. För en driftsättning som stöds Webex Edge väljer du Lokal an rop när det är tillgängligt och följer den konfigurerade CUCM/on-premises provisioning-sökvägen.
-
Om enheten redan har hävdats men inte tilldelats öppnar du enheten i Control Hub, väljer Tilldela och väljer Tilldela en enhet till en användare. Hävdade enheter som ännu inte har anslutits visas som Väntande.
Se avsnittet Leta reda på enhetens fysiska MAC-adressetikett för att lära dig hur du hittar enhetens MAC-adress.
Du kan filtrera alla enheter som har hävdats, oavsett om de för närvarande är online eller offline, genom att använda filtret Ägarskap på enhetssidan och välja Anspråk på.
-
Tillämpa förkonfigurationer på väntande enheter (valfritt, rekommenderas)
Du kan använda förkonfigurationer på enhetsnivå innan enheten går online för alla konfigurationer som stöds genom att följa dessa steg:
- Öppna sidan för väntande enhet i Control Hub.
- Klicka på ”Alla konfigurationer”.
- Tillämpa nödvändiga inställningar.
Under onboarding förbrukar enheten konfigurationsinställningar från dessa källor i hierarkisk ordning:
- Standardvärden på organisationsnivå
- Standardvärden på platsnivån
- Förkonfigurationer på enhetsnivå på den väntande enheten
Inställningar som definierats på någon av dessa nivåer tillämpas automatiskt under introduktionsflödet i guiden Första gången.
För att guiden för automatisk introduktion ska kunna slutföras måste följande konfigurationer ställas in:
Alla enheter:
- Tid > TimeFormat (t.ex. 12h/24h)
- Tid > Zon (t.ex. America/New_York)
- Användargränssnitt > Språk (t.ex. engelska)
Endast styrelserier:
- Ljud > Placering (väggmontering, fristående)
Resultat:
- Beroende på introduktionsmetod visas enheten som hävdad, tilldelad eller väntande. När enheten ansluts slutför den automatisk onboarding.
- Den är förkonfigurerad med inställningar för plats och enhetsnivå.
- När fabriksåterställningsenheten ansluts till nätverket registreras den automatiskt och går ombord.
Leta reda på enhetens fysiska MAC-adressetikett
Om du inte hittar din MAC-adress skrivs den vanligtvis ut på produktetiketten som finns på baksidan eller undersidan av din enhet. Denna etikett innehåller ofta andra viktiga identifi erare som serienummer och produkt-ID. För många Cisco-produkter är MAC- adressetiketten tydligt markerad och finns på chassit eller ett etikettfack. Om du inte kan hitta den fysiskt tillåter vissa enheter dig också att visa MAC-adressen via deras användargränssnitt eller webbsida under produkt- eller systeminformationsinställningar.
Onboarding-process
Webex Edgestöder enhets-first och cloud-first onboarding-sekvenser. Beroende på distributionen kan enheten upptäcka CUCM/TFTP-inställningar först och sedan slutföra Webex Edge aktiveringen, eller använda sin Control Hub-tilldelning innan den ansluter till den lokala etableringsmiljön.
När enheten har hämtats och tilldelats i Control Hub:
- Se till att enheten är fabriksåterställd.
- Anslut enheten till nätverket.
- Välj alternativet för automatisk onboarding på välkomstskärmen.

Enhetsaktivering pågår - Följ eventuella återstående anvisningar för objekt som inte är konfigurerade i Control Hub.
- Om du inte slutförde vissa inställningar under förkonfigurationen kommer installations guiden att uppmana dig att konfigurera dessa objekt under enhetens onboarding.
- Slutför dessutom nödvändiga maskinvaruinställningar, till exempel att placera kameran korrekt, för att säkerställa optimal enhetsprestanda.
Om alternativet för automatisk onboarding inte visas kontrollerar du följande:
- MAC-adressen är korrekt inmatad och tilldelad den avsedda arbetsytan eller det personliga användarkontot
- Enheten har återställts till fabriksinställningen.
- Enheten har verifierat internetåtkomst till Webex-tjänster.
- Enheten kör den minsta programvaruversion som krävs (RoomOS 26.5.0+).
Massonboarding av enheter (CSV)
Använd processen för massintroduktion för att göra anspråk på och tilldela flera enheter i en enda import.
- I Control Hub navigerar du till Enheter och klickar på Lägg till enhet.
- Välj Lägg till enheter i bulk.

Lägg till enheter i bulk - Välj onboarding-mallen utan beröring i rullgardinsmenyn för mall och
ladda ner CSV-filen.

Val av mall för noll beröring - Fyll i CSV-filen med din enhets- och tilldelningsinformation och se till att alla obligatoriska fält är ifyllda. För enheter i personligt läge anger du användarens e-postadress i kolumnen Kon to. Befintligt CSV-beteende för delade och arbetsytor förblir oförändrat.
- Ladda upp den färdiga CSV-filen och skicka importen.
- Öppna sidan Upp gifter för att övervaka importförloppet och hämta en fel-CSV
-fil om några rader misslyckas.

Status för massimporteringsaktivitet - Verifiera de importerade enheterna i listan Enh eter, där de initialt kan
visas som Påstå dda och Väntande före den första anslutningen.

Importerade enheter i väntande tillstånd
Onboarding av enhetswebbsida (fjärrkontroll)
Använd enhetens webbsida för fjärronboarding när du inte har fysisk åtkomst till enhetsgränssnittet. Den här metoden är särskilt användbar för distributioner utan en Room Navigator ansluten, till exempel Room Bar BYOD- och Room Bar Pro BYOD-enheter.
- Öppna en webbläsare och ange enhetens IP-adress i adressfältet.
- Logga in med användarnamnet admin utan lösenord.

Enhetens webbsida hem - Öppna systemsidan på enhetens webbsida och klicka på Registrera till Webex.

Registrera dig på Webex - I registreringsdialogrutan klickar du på Starta automatisk onboarding för att påbörja
processen. Automatisk onboarding stöder också enheter som har tilldelats ett
personligt användarkonto. För Webex Edge distributioner som stöds fortsätter enheten
genom den konfigurerade sökvägen för CUCM/lokal etablering.

Automatisk onboarding påbörjades - Vänta tills onboardingen börjar. Kontrollera sedan enhetens tillstånd och registrerings status i Control Hub för att säkerställa framgångsrik onboarding.
Ytterligare information
- Med den här introduktionsmetoden kan du konfigurera och hantera enheter på distans utan att behöva fysisk Room Navigator eller direkt enhetsinteraktion.
- Efter registrering kan enheten hanteras och övervakas genomCisco Webex Control Hub.
- För Room Bar BYOD-enheter möjliggör denna process nätverksanslutning och Control Hub-registrering, vilket låser upp avancerade funktioner som programvaruhantering, kr ingutrustning och fjärråtkomst.
- Se till att enheten är ansluten till nätverket och tillgänglig via sin IP-adress innan du startar onboarding-processen.
Denna strömlinjeformade fjärranslutningsprocess hjälper till att förenkla distributionen och hanteringen av Cisco-samarbetsenheter i miljöer där fysisk åtkomst är begränsad eller o tillgänglig.
Beteende i förstagångsguiden (FTW)
First Time Wizard (FTW) guidar den första onboarding-processen för Ciscos samarbet senheter. Dess beteende inkluderar följande nyckelåtgärder:
- Automatisk introduktionsstart: FTW börjar onboarding när användaren väljer alternativet för automatisk onboarding på välkomstskärmen. FTW känner igen om enheten är delad eller personlig. Personliga enheter använder det tilldelade användarkontot och kräver ingen manuell aktiveringskod när Mac-baserad onboarding är vald. Observera att enheter i personligt läge inte kommer att slutföra guiden förrän de låses upp av den avsedda användaren. Om en pin är inställd på användarens konto måste användaren låsa upp den först eller gå till https://user.webex.com/ för att återställa sin pin. Om de inte använder en stift måste de först para ihop med enheten (QR-kod, ultraljud eller usb-c) innan de låser upp den.
- Webex EdgeProvisioning: För distributioner som stöds bevarar FTW CUCM/TFTP-etableringsvägen innan aktiveringen slutförs. Webex Edge
- Användning av konfigurerade standardvärden: När det är tillgängligt tillämpar guiden konfigurerade standardvärden som Språk och Tidszon.
- Tillämpning av förkonfigurationer: Den tillämpar konfigurationer från förkonfigurationerna Organisation, Plats och alla förkonfigurationer för hängande enheter som anges i Control Hub.
- Fråga efter saknade inställningar: Gu iden uppmanar användaren att ange inställningar som inte redan är konfigurerade i Control Hub.
- Installation av Microsoft Teams: Om Microsoft Teams-plattformen valdes under processen Lägg till enhet installerar guiden Microsoft Teams i slutet av onboardingen.
- Manuella maskinvarukontroller: Vissa maskinvaruinställningsuppgifter, till exempel kamer apositionering, kräver manuellt utförande av användaren.
Begränsningar och manuella uppgifter
- Fysisk maskinvaruinstallation, såsom kamerapositionering och montering, måste fortfarande utföras manuellt.
- User Hub självbetjäningstilldelning av en MAC-adress stöds inte.
- Ändring av en enhet mellan större samtalslägen efter registrering stöds inte.
- Du kan behöva slutföra vissa steg i Förstagångsguiden manuellt om motsvarande standardinställningar inte är konfigurerade i Control Hub.
- Hybridsamtal: Hybridsamtal stöds inte via Zero Touch Provisioning. Tillhandahåll inte enheter som kräver hybridsamtal med ZTP- arbetsflödet. Använd istället den befintliga aktiveringskoden eller det manuella arbetsflödet för onboarding. Alternati vet Hybrid Calling visas inte i ZTP-inställningsflödet. Detta förväntas.
- Zero Touch Pairing är inte tillgängligt i den första utgåvan. Stöd för den här funktionen plan eras för en framtida uppdatering.
- TLS-avlyssningsproxyer stöds för närvarande inte. För att Zero Touch Activation ska fungera måste enheten upprätta en direkt, betrodd anslutning till Webex-tjänster. En förenklad förtroendebootstrap-process för dessa miljöer är för närvarande under utveckling.
- För driftsättningar som kräver 802.1X eller SCEP förblir certifikatregistrering en manuell process och hanteras oberoende av Zero Touch Activation. Medan ett automatiserat inläsningsverktyg för certifikat för närvarande är under utveckling förutsätter det nuvarande Zero Touch-arbetsflödet att enheten redan har etablerat nätverksanslutning till Webex-tjänster.