Disponibilità:
Zero-Touch Provisioning (ZTP) è generalmente disponibile (GA) per i dispositivi supportati che eseguono RoomOS 26.5.0 o versioni successive.
Principali vantaggi
- Registrazione automatica del dispositivo: i dispositivi possono essere integrati utilizzando il loro indirizzo MAC se assegnati a uno spazio di lavoro condiviso o a un account utente personale, riducendo la necessità di inserire manualmente il codice di attivazione quando si utilizza l'onboarding dell'indirizzo MAC. Webex Edge Le distribuzioni supportate possono utilizzare lo stesso processo con Premises Calling.
- Configurazione semplificata: sfruttando le impostazioni e le preconfigurazioni predefinite di Control Hub, l'esperienza First Time Wizard (FTW) è semplificata, riducendo significativamente i passaggi manuali durante la configurazione fisica del dispositivo.
- Operazioni in blocco efficienti: i dispositivi possono essere aggiunti in blocco importando file CSV contenenti indirizzi MAC, consentendo implementazioni su larga scala con il minimo sforzo.
- Capacità di preattivazione: i dispositivi possono essere attivati in anticipo, anche prima di connettersi alla rete. I dispositivi possono essere preconfigurati per uno spazio di lavoro o un account utente personale.
- Complessità di onboarding ridotta: Automatizzando l'onboarding della rete e il provisioning dei dispositivi, ZTP riduce i tempi, i costi e la complessità tradizionalmente associati alla configurazione dei dispositivi.
Termini chiave per l'onboarding dei dispositivi in Control Hub
- Non reclamato: l'indirizzo MAC del dispositivo non è registrato all'interno della sua organizzazione.
- Richiesto: l'indirizzo MAC del dispositivo è stato aggiunto alla sua organizzazione.
- Non assegnato: un dispositivo dichiarato che non è stato ancora collegato a un'area di lavoro o a un account utente personale.
- Assegnato: un dispositivo richiesto collegato a un'area di lavoro o a un account utente personale.
- In sospeso: lo stato mostrato in Control Hub per un dispositivo che è stato richiesto e/o assegnato ma non è ancora online.
- Preconfigurazione: il processo di applicazione delle impostazioni di configurazione del dispositivo a un dispositivo in sospeso prima che si connetta alla rete o sia online.
- Attivato: Il dispositivo ha completato il Webex o il processo di Webex Edge attivazione applicabile.
- Dispositivo personale: un dispositivo assegnato a un account utente anziché a un' area di lavoro.
- Webex Edge: Un modello di distribuzione in cui il dispositivo rimane registrato nell'infrastruttura locale mentre riceve funzionalità e gestione cloud supportate. Vedere Webex Edgela documentazione.
Requisiti
Si assicuri che il suo ambiente soddisfi questi requisiti prima dell'implementazione:
- Versione software: i dispositivi devono eseguire RoomOS 26.5.0 o versioni successive. RoomOS 11 non è supportato.
- Connettività di rete: i dispositivi richiedono un accesso affidabile alla rete con connettività ai servizi Webex.
- Impostazioni predefinite di configurazione: definisce le impostazioni predefinite di organizzazione e posizione in Control Hub per il formato orario, il fuso orario e la lingua per ridurre al minimo le richieste di onboarding durante la First Time Wizard (FTW).
Per la modalità personale, l'utente deve già esistere in Control Hub prima che il dispositivo venga assegnato.
Per Webex Edge ZTP, il rilevamento CUCM/TFTP deve essere disponibile laddove richiesto dalla
distribuzione, inclusa l'opzione DHCP 150 quando viene utilizzata. Convalida il comportamento di
AllowDataLogging e risolve eventuali conflitti tra le configurazioni controllate da CUCM e
controllate da Control Hub prima dell'onboarding.
Prerequisiti: Aggiornamento alla versione minima per l'attivazione Zero Touch
Per eseguire l'aggiornamento alla versione 26.5, per ora dovrà eseguire l'aggiornamento manualmente. Nei prossimi mesi, una funzionalità di aggiornamento pre-integrata automatizzerà questo processo e le immagini di fabbrica verranno aggiornate di conseguenza. Fino ad allora, i clienti devono eseguire l'aggiornamento utilizzando i collegamenti ai pacchetti o l'interfaccia xcommand per installare l'aggiornamento, seguito da un ripristino delle impostazioni di fabbrica per completare il processo.
Versione del software durante l'onboarding: se un dispositivo è inferiore alla versione di onboarding FTW, ZTP potrebbe aggiornarlo prima della registrazione. Questo aggiornamento avviene indipendentemente dal canale del software dell'area di lavoro, incluso un canale impostato tramite la configurazione del dispositivo in sospeso. Una volta completato lo ZTP, vengono applicate le normali regole software dell'area di lavoro e il dispositivo può essere aggiornato o declassato alla versione richiesta da quel canale. Questo comportamento è previsto. Dispositivi Microsoft Teams Rooms: se ZTP aggiorna un dispositivo MTR a una versione successiva a quella assegnata al suo canale Microsoft Approved, il dispositivo non esegue automaticamente il downgrade mentre funziona in modalità MTR.
Mappatura e comandi dei pacchetti
Selezioni il pacchetto appropriato in base al suo hardware. Usa l'
XCommand fornito per avviare l'aggiornamento.
| Categoria di dispositivo | Nome del pacchetto |
|---|---|
| Cisco Room Navigator |
bifrost.pkg
|
| Prodotti più recenti (Codec Pro G2, Desk Pro G2) |
luna.pkg
|
| Endpoint RoomOS standard (Room Bar, Room Kit EQ, Board Pro, Desk, Codec Pro) |
zenith.pkg
|
Per CiscoRoom Navigator:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/bifrost.pkg" Forced: True
Per Codec Pro G2 e Desk Pro G2:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/luna.pkg" Forced: True
Per Room Bar, Room Kit EQ, Board Pro, Desk e Codec Pro:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/zenith.pkg" Forced: True
Avvio dell'attivazione Zero Touch tramite CLI
Può attivare manualmente il processo di attivazione Zero Touch utilizzando l'interfaccia a riga di comando (CLI) o l'API. Usa il seguente comando per iniziare il flusso di lavoro:
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.
Fasi di configurazione in Control Hub
-
Configurare i valori predefiniti
L'impostazione delle impostazioni predefinite aiuta il dispositivo a saltare le fasi di configurazione manuale durante l'onboarding. Accedere a Control Hub e configurare quanto segue:
- Ora -> TimeFormat (ad esempio, 12h/24h)
- Ora -> Fuso orario (ad esempio, America/New_York)
- Interfaccia utente -> Lingua (ad esempio, inglese)
Facoltativamente, assegni l'area di lavoro alla posizione in cui sono configurate queste impostazioni predefinite o applichi le impostazioni predefinite a livello di organizzazione.
Prima di utilizzare l'attivazione Zero Touch, confermi che il dispositivo non richieda la chiamata ibrida. I dispositivi che richiedono la chiamata ibrida devono essere integrati utilizzando il codice di attivazione o il flusso di lavoro di onboarding manuale.
-
Aggiungere il dispositivo tramite indirizzo MAC
- Vai a Control Hub -> Dispositivi -> Aggiungi dispositivo (o Crea spazio di lavoro). Può anche iniziare da Utenti, selezionare un utente, aprire la scheda Dispositivi e selezionare Aggiungi dispositivo.
- Seleziona Dispositivo Cisco Room o Desk, scelga Utilizzo condiviso o Uso personale e selezioni Indirizzo MAC. Inserire l'indirizzo MAC Ethernet cablato, il tipo di prodotto e la piattaforma (RoomOS o Microsoft Teams). Se seleziona Microsoft Teams, la piattaforma verrà installata automaticamente al termine della procedura guidata.
- Per un dispositivo personale, selezioni l'account utente a cui assegnarlo. Per una Webex Edge distribuzione supportata, selezioni Premises Calling se disponibile e segua il percorso di provisioning CUCM/on-premise configurato.
-
Se il dispositivo è già richiesto ma non assegnato, apra il dispositivo in Control Hub, seleziona Assegna e scegli Assegna un dispositivo a un utente. I dispositivi dichiarati che non si sono ancora connessi vengono visualizzati come In sospeso.
Consulti la sezione per localizzare l'etichetta dell'indirizzo MAC fisico del suo dispositivo per scoprire come trovare l'indirizzo MAC del dispositivo.
Può filtrare tutti i dispositivi rivendicati, siano essi attualmente online o offline, utilizzando il filtro Proprietà nella pagina dei dispositivi e selezionando Rivendicato.
-
Applica le preconfigurazioni ai dispositivi in sospeso (opzionale, consigliato)
Può applicare le preconfigurazioni a livello di dispositivo prima che il dispositivo sia online per qualsiasi configurazione supportata seguendo questi passaggi:
- Aprire la pagina del dispositivo in sospeso in Control Hub.
- Faccia clic su «Tutte le configurazioni».
- Applica le impostazioni necessarie.
Durante l'onboarding, il dispositivo utilizza le impostazioni di configurazione da queste fonti in ordine gerarchico:
- Impostazioni predefinite a livello di organizzazione
- Impostazioni predefinite a livello di località
- Preconfigurazioni a livello di dispositivo sul dispositivo in sospeso
Le impostazioni definite a uno di questi livelli vengono applicate automaticamente durante il flusso di onboarding del First Time Wizard.
Affinché la procedura guidata di onboarding automatico si completi correttamente, è necessario impostare le seguenti configurazioni:
Tutti i dispositivi:
- Ora > TimeFormat (ad esempio, 12h/24h)
- Ora > Fuso orario (ad esempio, America/New_York)
- Interfaccia utente > Lingua (ad esempio, inglese)
Solo serie Board:
- Audio > Posizionamento (montaggio a parete, indipendente)
Risultato:
- A seconda del metodo di onboarding, il dispositivo appare come Richiesto, Assegnato o In sospeso. Quando il dispositivo si connette, completa l'onboarding automatico.
- È preconfigurato con impostazioni di posizione e a livello di dispositivo.
- Quando il dispositivo ripristinato alle impostazioni di fabbrica si connette alla rete, si registrerà e si integrerà automaticamente.
Individui l'etichetta dell'indirizzo MAC fisico del suo dispositivo
Se non riesce a localizzare il suo indirizzo MAC, in genere è stampato sull'etichetta del prodotto che si trova sul retro o sul lato inferiore del dispositivo. Questa etichetta include spesso altri identificatori importanti come il numero di serie e l'ID del prodotto. Per molti prodotti Cisco, l'etichetta dell' indirizzo MAC è chiaramente contrassegnata e si trova sullo chassis o su un vassoio per le etichette. Se non è in grado di localizzarlo fisicamente, alcuni dispositivi Le consentono anche di visualizzare l'indirizzo MAC tramite la loro interfaccia utente o pagina web nelle impostazioni delle informazioni sul prodotto o sul sistema.
Processo di onboarding
Webex Edgesupporta sequenze di onboarding incentrate sul dispositivo e sul cloud. A seconda della distribuzione, il dispositivo può rilevare prima le impostazioni CUCM/TFTP e poi completare Webex Edge l'attivazione, oppure utilizzare l'assegnazione di Control Hub prima di connettersi all'ambiente di provisioning locale.
Una volta che il dispositivo è stato richiesto e assegnato in Control Hub:
- Assicurarsi che il dispositivo sia ripristinato alle impostazioni di fabbrica.
- Connetta il dispositivo alla rete.
- Nella schermata di benvenuto, selezioni l'opzione di onboarding automatico.

Attivazione del dispositivo in corso - Segua le istruzioni rimanenti per gli elementi non configurati in Control Hub.
- Se non ha completato determinate impostazioni durante la preconfigurazione, la procedura guidata di configurazione Le chiederà di configurare queste voci durante l'onboarding del dispositivo.
- Inoltre, completi la configurazione hardware necessaria, ad esempio il posizionamento corretto della fotocamera, per garantire prestazioni ottimali del dispositivo.
Se l'opzione di onboarding automatico non è visualizzata, verifichi quanto segue:
- L'indirizzo MAC è inserito e assegnato correttamente all'area di lavoro o all'account utente personale previsto
- Il dispositivo è stato ripristinato alle impostazioni di fabbrica.
- Il dispositivo ha verificato l'accesso a Internet ai servizi Webex.
- Il dispositivo esegue la versione software minima richiesta (RoomOS 26.5.0+).
Onboarding in blocco dei dispositivi (CSV)
Utilizza la procedura di onboarding in blocco per richiedere e assegnare più dispositivi in un'unica importazione.
- In Control Hub, acceda a Dispositivi e faccia clic su Aggiungi dispositivo.
- Seleziona Aggiungi dispositivi in blocco.

Aggiungere dispositivi in blocco - Dal menu a discesa dei modelli, scelga il modello di onboarding zero-touch e
scarichi il file CSV.

Selezione del modello Zero touch - Compila il file CSV con il suo dispositivo e le informazioni sull'assegnazione, assicurandosi che tutti i campi obbligatori siano compilati. Per i dispositivi in modalità personale, inserisca l'indirizzo email dell'utente nella colonna Account. Il comportamento CSV condiviso e nello spazio di lavoro esistente rimane invariato .
- Carica il file CSV completato e invia l'importazione.
- Aprire la pagina Attività per monitorare l'avanzamento dell'importazione e scaricare un
file CSV di errore in caso di errore in caso di errore in alcune righe.

Stato dell'attività di importazione in blocco - Verifichi i dispositivi importati nell'elenco dei dispositivi, dove possono inizialmente
apparire come Richiamati e In sospeso prima della prima connessione.

Dispositivi importati in stato di attesa
Inserimento della pagina Web del dispositivo (remoto)
Utilizzi la pagina web del dispositivo per l'onboarding remoto quando non ha accesso fisico all'interfaccia del dispositivo. Questo metodo è particolarmente utile per le implementazioni senza dispositivi Room Navigator collegati, come i dispositivi Room Bar BYOD e Room Bar Pro BYOD.
- Aprire un browser web e inserire l'indirizzo IP del dispositivo nella barra degli indirizzi.
- Accedi utilizzando il nome utente admin senza password.

Pagina web del dispositivo - Nella pagina web del dispositivo, apra la pagina di sistema e faccia clic su Registra su Webex.

Registrarsi a Webex - Nella finestra di dialogo di registrazione, faccia clic su Avvia onboarding automatico per iniziare il
processo. L'onboarding automatico supporta anche i dispositivi che sono stati assegnati a un account utente
personale. Per le Webex Edge distribuzioni supportate, il dispositivo continua
attraverso il percorso di provisioning CUCM/on-premise configurato.

L'onboarding automatico è iniziato - Attendi l'inizio dell'onboarding. Quindi, verifichi lo stato del dispositivo e lo stato di registrazione in Control Hub per garantire il corretto onboarding.
Informazioni aggiuntive
- Questo metodo di onboarding Le consente di configurare e gestire i dispositivi da remoto senza la necessità di un'interazione fisica Room Navigator o diretta con il dispositivo.
- Dopo la registrazione, il dispositivo può essere gestito e monitorato tramiteCisco Webex Control Hub.
- Per i dispositivi BYOD Room Bar, questo processo consente di abilitare la connettività di rete e la registrazione di Control Hub, che sblocca funzionalità avanzate come la gestione del software, la visibilità delle periferiche e l'accesso remoto.
- Assicurarsi che il dispositivo sia connesso alla rete e accessibile tramite il suo indirizzo IP prima di iniziare la procedura di onboarding.
Questo processo di onboarding remoto semplificato aiuta a semplificare l'implementazione e la gestione dei dispositivi di collaborazione Cisco in ambienti in cui l'accesso fisico è limitato o non disponibile.
Comportamento del First Time Wizard (FTW)
Il First Time Wizard (FTW) guida il processo iniziale di onboarding per i dispositivi di collaborazione Cisco. Il suo comportamento include le seguenti azioni chiave:
- Avvio automatico dell'onboarding: L'FTW inizia l'onboarding quando l'utente seleziona l'opzione di onboarding automatico nella schermata di benvenuto. L'FTW riconosce se il dispositivo è condiviso o personale. I dispositivi personali utilizzano l'account utente assegnato e non richiedono l'immissione manuale del codice di attivazione quando si seleziona l'onboarding basato su Mac. Nota che i dispositivi in modalità personale non completeranno la procedura guidata finché non saranno sbloccati dall'utente previsto. Se è impostato un pin sull'account dell'utente, l' utente dovrà prima sbloccarlo o andare su https://user.webex.com/ per reimpostare il proprio pin. Se non usano un PIN, dovranno prima associarlo al dispositivo (codice QR, ecografia o usb-c) prima di sbloccarlo.
- Webex EdgeProvisioning: per le implementazioni supportate, l'FTW conserva il percorso di provisioning CUCM/TFTP prima di completare l'attivazione. Webex Edge
- Uso dei valori predefiniti configurati: se disponibile, la procedura guidata applica i valori predefiniti configurati come la lingua e il fuso orario.
- Applicazione delle preconfigurazioni: applica le configurazioni dell'organizzazione, della posizione e di tutte le preconfigurazioni dei dispositivi in sospeso impostate in Control Hub.
- Richiesta di impostazioni mancanti: La procedura guidata richiede all'utente di inserire tutte le impostazioni che non sono già configurate in Control Hub.
- Installazione di Microsoft Teams: se la piattaforma Microsoft Teams è stata selezionata durante il processo di aggiunta del dispositivo, la procedura guidata installa Microsoft Teams al termine dell' onboarding.
- Controlli hardware manuali: Alcune attività di configurazione dell'hardware, come il posizionamento della telecamera, richiedono il completamento manuale da parte dell'utente.
Limitazioni e attività manuali
- L'installazione dell'hardware fisico, come il posizionamento e il montaggio della telecamera, deve comunque essere eseguita manualmente.
- L'assegnazione self-service di un indirizzo MAC all'User Hub non è supportata.
- La modifica di un dispositivo tra le principali modalità di chiamata dopo la registrazione non è supportata.
- Potrebbe essere necessario completare manualmente alcuni passaggi della procedura guidata per la prima volta se le impostazioni predefinite corrispondenti non sono configurate in Control Hub.
- Chiamate ibride: le chiamate ibride non sono supportate tramite Zero Touch Provisioning. Non fornisca dispositivi che richiedono chiamate ibride utilizzando il flusso di lavoro ZTP. Utilizza invece il codice di attivazione o il flusso di lavoro di onboarding manuale esistente. L'opzione Hybrid Calling non appare nel flusso di configurazione ZTP; è previsto.
- Zero Touch Pairing non è disponibile nella versione iniziale. Il supporto per questa funzione è previsto per un aggiornamento futuro.
- I proxy di intercettazione TLS non sono attualmente supportati. Affinché l'attivazione Zero Touch funzioni, il dispositivo deve stabilire una connessione diretta e affidabile con i servizi Webex. Un processo di trust bootstrap semplificato per questi ambienti è attualmente in fase di sviluppo.
- Per le implementazioni che richiedono 802.1X o SCEP, la registrazione dei certificati rimane un processo manuale e viene gestita indipendentemente dall'attivazione Zero Touch. Sebbene sia attualmente in fase di sviluppo uno strumento di caricamento automatico dei certificati, l'attuale flusso di lavoro Zero Touch presuppone che il dispositivo abbia già stabilito la connettività di rete ai servizi Webex.