I telefoni supportati verranno creati e assegnati automaticamente agli utenti in Webex Calling dallo strumento di provisioning. I telefoni contrassegnati con "sì" nella colonna "Supportato nello strumento di migrazione dei dispositivi" verranno automaticamente migrati da Cisco BroadWorks o BroadCloud a Webex Calling all'esecuzione dello strumento di migrazione dei dispositivi. I telefoni contrassegnati con "No" in quella colonna richiedono un intervento manuale per modificare l'URL DMS nel modello del dispositivo Cisco BroadWorks o nel telefono stesso.

L'ultima colonna fornisce la mappatura dei modelli di telefono alla colonna "Tipo di dispositivo" del file transform-tool/input/newphones.csv. (Vedere la sezione Strumento di trasformazione di questo articolo per ulteriori informazioni su newphones.csv).

Gli amministratori dei partner devono eseguire questo strumento di generazione di token almeno una volta prima di iniziare a eseguire gli strumenti di migrazione. L'esecuzione di questo strumento è un'attività da svolgere una sola volta dopo l'integrazione dell'account partner nella soluzione Wholesale RTM. Questo strumento consente agli amministratori dei partner di accedere tramite browser web per ottenere il TOKEN univoco necessario per aggiornare i file di configurazione dei partner per gli strumenti di migrazione.

Prerequisiti

Installa Java 8, 11, 17 o 21 sul computer. Java è disponibile da molte fonti, tra cui:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

Dopo il download, estrai i file binari dello strumento di migrazione.

Istruzioni per l'esecuzione

Esegui il seguente comando nel terminale all'interno della directory del generatore di token:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Produzione:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

Apri l'URL nel browser web sul terminale, accedi con le credenziali dell'amministratore partner per ottenere il TOKEN e copialo per utilizzarlo in seguito.

Di seguito sono riportate le illustrazioni dell'interfaccia utente a titolo di riferimento:

Figura 3: Accedi con Cisco Webex

Figura 4: Finestra delle credenziali

Figura 5: Generazione di token

Configurare i seguenti passaggi prima di eseguire gli strumenti di estrazione e spostamento dei dispositivi sul server BroadWorks secondario.

Abilita la connettività OCI-P

Lo strumento di spostamento del dispositivo comunica con BroadWorks tramite comandi OCI-P; per abilitare la connettività OCI-P, seguire i passaggi seguenti:

Passaggio 1: Utilizzare la CLI per configurare le impostazioni generali.

Eseguire il seguente comando nella riga di comando per passare alla directory GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Eseguire il seguente comando nella riga di comando per ottenere le impostazioni generali correnti:

AS_CLI/Applications/OpenClientServer/GeneralSettings> get
clientPort = 2208
clientPortEnabled = true
secureClientPort = 2209
secureClientPortEnabled = true
systemDomain = <>

Se le tue impostazioni non corrispondono a quelle sopra indicate, usa il comando set per riconfigurarle.

Passaggio 2: Utilizzare la CLI per configurare il proxy OCI.

Cambiare la directory in OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Eseguire il seguente comando CLI per ottenere le impostazioni correnti. Dovresti visualizzare quanto segue:

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

Se le tue impostazioni non corrispondono a quelle sopra indicate, usa il comando set per riconfigurarle.

Passaggio 3: Utilizzare la CLI per configurare il provisioning OCI.

Passare alla directory di provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Eseguire il seguente comando per ottenere le impostazioni di provisioning OCI correnti:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

Passaggio 4: Esegui il comando seguente nella riga di comando per verificare che la configurazione sia corretta.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Verificare che il server client aperto sia distribuito e attivo.

Utilizzare i comandi seguenti per distribuire e avviare Open Client Server sul server applicazioni secondario, qualora non sia già distribuito o avviato.

Passaggio 1: Distribuisci il server con il seguente comando CLI:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Passaggio 2: Avvia il server con questo comando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Abilita l'attivazione dei numeri

Eseguire i seguenti comandi nella CLI per abilitare l'attivazione dei numeri:

Passaggio 1: Eseguire il comando di attivazione del numero:

AS_CLI> cd SubscriberMgmt/NumberActivation

Passaggio 2: Eseguire il comando di attivazione abilitata:

AS_CLI> set dnMode groupAndUserActivationEnabled

Passaggio 3: Alla richiesta di conferma, digitare Y.

Per BroadCloud

Lo strumento di estrazione è integrato nel portale dei fornitori di servizi BroadCloud. Un amministratore del fornitore di servizi può:

1. È possibile inviare richieste di estrazione dati per un massimo di 50 clienti per richiesta.
   Non è possibile inviare più di 10 richieste di estrazione dati per lo stesso cliente in un giorno.
2. È possibile scaricare il file di dati estratto, in formato ZIP, entro 28 giorni dalla data di invio della richiesta.

Le seguenti figure mostrano il portale del fornitore di servizi.

Figura 6: Portale dei fornitori di servizi

Figura 7: Portale dei fornitori di servizi

richiesta di estrazione CSV

Avvia richiesta di estrazione CSV

1. Scarica il file CSV del cliente

   Fai clic sul collegamento Scarica il file CSV del cliente nell'angolo in alto a destra della sezione Avvia richiesta di estrazione CSV.

2. Modifica l'elenco clienti

   L'amministratore può modificare questo file CSV per includere solo i clienti per i quali è necessario eseguire l'estrazione.

3. Carica e invia

   Dopo aver apportato le modifiche, carica il file CSV modificato.

   Fai clic su Invia per avviare una richiesta di estrazione per i clienti elencati e le relative sedi.

Avvia richiesta di estrazione per un cliente con posizioni CSV

1. Seleziona il cliente e le posizioni di download

   Seleziona un cliente dal menu a tendina.

   Scarica il file locations.csv corrispondente da Visualizza clienti→ scheda Siti → Esporta posizioni come CSV.

2. Modifica il file delle posizioni

   L'amministratore può modificare il file CSV per includere solo le posizioni che desidera estrarre.

3. Carica e invia

   Carica il file locations.csv modificato e fai clic su Invia.

   Nella richiesta di estrazione saranno incluse solo le sedi specificate per il cliente selezionato.

Avvia richiesta di estrazione per tutti i clienti

1. Fai clic su Invia per avviare una richiesta di estrazione per tutti i clienti e tutte le loro sedi sotto l'attuale fornitore di servizi.

Per Cisco BroadWorks e Webex per BroadWorks

1. Lo strumento di estrazione viene eseguito sul server applicativo secondario Cisco BroadWorks all'interno della rete del partner e si connette tramite OCI-P.
2. Lo strumento estrae dati grezzi relativi a imprese, gruppi, numeri, utenti, servizi, dispositivi e client software dalla piattaforma Cisco BroadWorks o BroadCloud e li esporta in file XML che forniscono gli input per lo strumento di trasformazione.

Le sezioni successive spiegano come installare e configurare lo strumento di estrazione.

Prerequisiti

1. SCP trasferisce i file binari dello strumento di estrazione al server applicativo secondario Cisco BroadWorks.
2. Connettiti tramite SSH al server applicativo secondario Cisco BroadWorks per configurare i prerequisiti ed eseguire lo strumento di estrazione.
3. Configurare il provider di servizi e l'ID gruppo da estrarre da Cisco BroadWorks nel conf/exportTool.yml. Si veda il seguente esempio di frammento YAML:

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

4. Assicurarsi che l'ID utente, la password e il nome host del server applicazioni Cisco BroadWorks secondario siano corretti. conf/partner.cfg file:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   La proprietà REFRESH_TOKEN è obbligatoria per la migrazione da Webex a BroadWorks.

5. Modificare il JDK/JRE percorso ambiente nel file export.sh se il server applicazioni secondario Cisco BroadWorks JDK/JRE Il percorso dell'ambiente è diverso da quello del file:

   JAVA_HOME=/usr/local/java/java_base

Istruzioni per l'esecuzione

Eseguire il seguente comando nel server applicativo secondario Cisco BroadWorks dalla directory dello strumento di estrazione:

./export.sh

Registri del terminale

I seguenti log sono disponibili nel terminale al termine dell'esportazione: Esecuzione dello strumento di esportazione dati BroadSoft:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

Output

Un file ZIP di output (extracted_data_<timestamp>.zip) è disponibile nella stessa directory dello strumento di estrazione. Utilizzare il seguente comando per visualizzare e utilizzare il file ZIP come input per lo strumento Trasforma:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

Se l'amministratore utilizza lo strumento dietro un proxy aziendale, seguire i passaggi seguenti per configurare ed eseguire lo script di esportazione.

Passaggi per configurare ed eseguire lo script di esportazione

1. Apri il file export.sh.
2. Individua la variabile HTTPS_PROXY_HOST e decommentala (rimuovi il commento iniziale #).

3. Imposta il valore HTTPS_PROXY_HOST come:

   HTTPS_PROXY_HOST=

4. Individua la variabile HTTPS_PROXY_PORT e decommentala (rimuovi il commento iniziale #).
5. Imposta il valore HTTPS_PROXY_PORT come:

   HTTPS_PROXY_PORT=

6. Salva e chiudi il file export.sh.
7. Apri il file partner.cfg e aggiungi le parentesi quadre refresh_token.
8. Verifica che l'host BroadWorks, il nome utente e la password siano configurati correttamente nel file partner.cfg.
9. Esegui lo script:

   ./export.sh

Modulo di incarico:

Lo strumento di estrazione (BroadCloud e BroadWorks) ora genera automaticamente un file XLSX consolidato denominato Engagement Form SUA.xlsx durante l'esecuzione. Il file è precompilato con tutti i dati disponibili nei fogli di lavoro pertinenti, contribuendo a semplificare e velocizzare la compilazione da parte del partner.

Questo strumento di trasformazione viene eseguito per tutte le migrazioni. Lo strumento di trasformazione funziona su qualsiasi computer, incluso il portatile amministratore di un partner, e utilizza le API pubbliche di Webex. Legge il file ZIP (extracted_data_<timestamp>.zip) di output dello strumento di estrazione come input e trasforma l'XML grezzo in un formato JSON utilizzato dallo strumento di provisioning.

Prerequisiti

Dopo aver scaricato ed estratto i file binari degli strumenti di migrazione, configurare i seguenti prerequisiti:

1. Imposta il TOKEN REFRESH_(Token copiato dallo strumento Generatore di token) e NOME_DI_POSIZIONE PRINCIPALE_nel conf/partner.cfg file:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Imposta facoltativamente l'ID PROVISIONING_(copiato dal modello in Partner Hub) nel conf/partner.cfg file:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Per ottenere una verifica più completa dell'indirizzo email del cliente, è possibile impostare facoltativamente l'ID PROVISIONING_.
3. Configurare le informazioni mancanti nel input/customers.csv file (vedi sezione successiva) se mancante.
4. Aggiungi l'indirizzo email dell'utente finale nel input/users.csv file.
5. Se è necessario configurare nuovi telefoni, aggiungere l'indirizzo MAC e l'indirizzo e-mail del nuovo telefono dell'utente a input/newphones.csv file. Questa operazione è necessaria solo se gli amministratori del partner desiderano attivare nuovi telefoni per le chiamate all'ingrosso.
6. Convertire i call center BroadWorks in CxEssentials utilizzando input/cxessentials.csv file.
7. Facoltativamente, abilita la proprietà UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS per convertire tutti i Call Center in CxEssentials.
8. Utilizzare il input/locations.csv file a supporto della migrazione di grandi aziende che consente agli amministratori di migrare le sedi dei propri clienti, sede per sede
9. È possibile abilitare, facoltativamente, l'utilizzo degli indirizzi MAC dall'intestazione User-Agent del messaggio SIP REGISTER quando l'indirizzo MAC non è disponibile nel profilo del dispositivo Cisco BroadWorks. Decommenta la riga USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes nel file conf/partner.cfg
10. È possibile abilitare facoltativamente le proprietà ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD e ANALOG_USER_TYPE_DISABLE_T38 per configurare l'avviso di chiamata, la musica d'attesa e disabilitare le impostazioni T38 per tutti gli utenti di tipo analogico.

11. Se si desidera configurare dispositivi gateway generici, aggiungere l'indirizzo MAC del dispositivo e l'ID utente al input/genericgateways.csv file. Inoltre, specificare se l'utente è il proprietario PRINCIPALE o un utente CONDIVISO (per le partecipazioni alle chiamate condivise). Ciò è necessario solo se gli amministratori dei partner intendono utilizzare dispositivi gateway generici nelle chiamate all'ingrosso.

    Questa funzionalità non è disponibile per le migrazioni da BroadCloud a Wholesale.

12. Per le migrazioni BroadCloud, per convertire tutti gli utenti con il tipo di stazione di messaggistica in voice_mail_group, aggiornare il file conf/rialto_station_type_to_wholesale_package.csv sostituendo il valore Wholesale Package con voice_mail_group per la riga in cui Rialto Station Type è in modalità di messaggistica.

    Facoltativamente, abilita la proprietà COMMON_VOICE_MAIL_GROUP_PASSCODE nel file partner.cfg per configurare il PIN predefinito per i gruppi di segreteria telefonica.

    Se questa proprietà non è specificata in partner.cfg, deve essere fornita per ogni cliente nel file customers.csv nella colonna commonVoicemailGroupPassCode.

13. Per la migrazione dei contatti comuni a Webex Calling

    Si tratta di un miglioramento per la gestione dei contatti comuni a livello aziendale e di sede. Questi contatti possono ora essere migrati come contatti aziendali (Contatti Org) o come estensioni virtuali, in base alle impostazioni di configurazione. Di seguito sono riportati i dettagli che vi guideranno attraverso questo processo di migrazione.

    Configurazione chiave:

    • COMUNE_TELEFONO_ELENCO_A_VIRTUALE_INTERNO_INIZIO_PORTATA

      Una nuova proprietà, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, viene introdotta nel file partner.cfg. Questa proprietà determina come i contatti comuni vengono migrati da Rialto a Webex Calling.

    • Senza COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE Configurato

      I contatti comuni verranno migrati come contatti dell'organizzazione (Contatti Org).

      Non è necessaria alcuna configurazione aggiuntiva.

      I contatti rimangono accessibili a livello organizzativo.

    • Con COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurato

      I contatti comuni verranno migrati come estensioni virtuali.

      A ciascun contatto verrà aggiunto un numero di interno e l'intervallo iniziale dell'interno è definito nella proprietà COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE nel file partner.cfg.

      Le estensioni virtuali sono supportate sia a livello di organizzazione che a livello di sede, a seconda della portata del contatto.

14. Abilita Webex come fornitore predefinito per la registrazione delle chiamate.

    Questo passaggio è necessario solo quando si migrano le impostazioni di registrazione delle chiamate per gli utenti configurati con Dubber a Cisco Native Call Recording in Webex.

    Per abilitare questa opzione:

    • Nel file partner.cfg, impostare la seguente proprietà, DEFAULT_CALL_RECORDING_VENDOR=Webex.
    • Inoltre, utilizzare la proprietà WEBEX_CALL_RECORDING_STORAGE_REGION per configurare la regione di archiviazione.

      L'opzione di registrazione su richiesta di BroadCloud non è supportata in Webex Calling. Queste impostazioni di registrazione delle chiamate non verranno migrate e saranno visualizzate nel report delle eccezioni.

15. Esclusione di alcuni numeri di telefono dalla migrazione:

    Per escludere specifici numeri di telefono dal processo di migrazione, è necessario seguire la seguente procedura in due fasi utilizzando lo strumento di trasformazione:

    • Eseguire inizialmente lo strumento di trasformazione per la prima volta. Al termine, lo strumento genererà un file denominato telephone_numbers_inventory.csv, situato all'interno della output/timestamp/ directory. Il cliente è tenuto a esaminare questo file e a indicare "Sì" nella colonna "Elimina Tn" per ciascun numero di telefono che deve essere escluso dalla prossima migrazione.
    • Dopo aver aggiornato il file telephone_numbers_inventory.csv con i flag di esclusione appropriati, lo strumento di trasformazione viene eseguito una seconda volta. Il file aggiornato deve essere passato come argomento nel seguente formato.

      ./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}

16. Facoltativamente, impostare la proprietà ALLOW_RESTRICT_BY_PARTNER_MODE su OFF per consentire agli amministratori del cliente di modificare le impostazioni definite dal partner in Control Hub.
17. Per la migrazione dei numeri di cellulare (BroadWorks Mobility) da BroadCloud a Webex Calling

    Questa sezione descrive la migrazione della funzionalità BroadWorks Mobility (numeri di cellulare dei clienti) da BroadCloud (integrazione di rete mobile ) a Wholesale Webex Calling (operatore di rete mobile Webex Go).

    Prerequisiti- Prima di avviare il processo di migrazione, gli amministratori dei partner devono contattare il team di account Cisco per configurare il fornitore Cloud Connected PSTN (CCP) e l'elenco di operatori personalizzati (CCL).

    Una nuova proprietà, ASSEGNA_NUMERI_MOBILE [_A_UTENTI, viene aggiunta al file partner.cfg. Abilita questa proprietà per consentire l'assegnazione e la migrazione dei numeri di cellulare agli utenti.

    • Questa funzionalità è supportata solo per le migrazioni da BroadCloud a Wholesale .
    • In Wholesale Webex, gli utenti finali possono avere un numero di cellulare o un numero PSTN (non entrambi), a differenza di BroadCloud.
    • Quando a un utente viene assegnato un numero di cellulare, il suo numero PSTN principale diventa il suo numero secondario (alternativo).
    • Non è possibile migrare i numeri di cellulare degli utenti che vengono convertiti a Workspaces o Linee Virtuali.
    • Una volta assegnato un numero di cellulare in Wholesale Webex, questo risulterà attivo in Control Hub. Questo stato non significa che il numero sia immediatamente pronto a ricevere chiamate. La funzionalità di chiamata sarà disponibile solo dopo il completamento della migrazione.
    • Le impostazioni di integrazione con i telefoni cellulari configurate dagli utenti finali nel Portale utenti chiamanti (CUP) non vengono migrate. Dopo la migrazione, quando viene chiamato un numero di telefono fisso, un numero di cellulare o un interno, tutti i dispositivi dell'utente squilleranno.

18. Per configurare facoltativamente i limiti di quantità dei pacchetti durante la migrazione dei clienti, specificare la quantità per ciascun pacchetto nel file input/package_quantity.csv. La quantità di pacchetti configurati deve essere maggiore o uguale al numero di user/workspace pacchetti assegnati.

    Al momento, i limiti di quantità dei pacchetti non sono supportati per le migrazioni da Webex per BroadWorks a Wholesale.

    Quando si esegue lo strumento di trasformazione, fornire il file aggiornato come parametro di input: ./transform.sh -estratto=<extract_zip_file> -packagelimits=input/package_quantity.csv.

19. Migra siti da più clienti da BroadWorks/BroadCloud in un singolo cliente nelle chiamate Webex all'ingrosso
    • Una nuova modalità di runtime, -consolidatedMigration, viene introdotta nello strumento Transform per supportare la migrazione di più siti clienti da Broadcloud/Broadworks alla piattaforma Webex Wholesale sotto un'unica organizzazione di clienti all'ingrosso. Quando questa modalità è abilitata, lo strumento consolida più siti clienti in un'unica organizzazione clienti all'ingrosso.

      -consolidatedMigration

    • Esistono altri argomenti opzionali che possono essere forniti insieme a -consolidatedMigration come ad esempio

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • Se viene specificato -targetEnterpriseId e l'ID è presente nel file di output dello strumento Extract, verrà utilizzato per creare l'organizzazione del cliente all'ingrosso. Se l'ID non viene trovato, lo strumento utilizzerà, in alternativa, i dettagli di qualsiasi cliente disponibile nel file di output dello strumento Extract.
    • Se viene specificato -consolidatedExternalId, verrà impostato l'externalId per il cliente; in caso contrario, lo strumento utilizzerà il flusso esistente per l'externalId.

Riempire il input/customers.csv

Il file input/customers.csv Fornisce dati che potrebbero mancare in Cisco BroadWorks o BroadCloud. Questo file può essere lasciato vuoto se tutte le informazioni obbligatorie sono già presenti. Non è necessario compilare tutte le colonne, solo le informazioni mancanti sono obbligatorie.

La tabella seguente spiega le colonne più importanti in input/customers.csv.

Riempire il input/users.csv

Il file input/users.csv Fornisce dati che potrebbero mancare in Cisco BroadWorks o BroadCloud. Questo file può essere lasciato vuoto se tutte le informazioni obbligatorie sono già presenti. Non è necessario compilare tutte le colonne, solo le informazioni mancanti sono obbligatorie.

Istruzioni per l'esecuzione

Esegui lo strumento Trasforma su qualsiasi sistema operativo. Segui i passaggi seguenti per eseguire lo strumento su Windows e macOS:

Windows

Eseguire il comando seguente per avviare lo strumento Trasforma in Windows:

transform.bat -extract= -customers= -users= -newphones=

macOS

Per eseguire lo strumento di trasformazione su macOS, segui questi passaggi:

1. Crea un ambiente virtuale e installa le dipendenze necessarie per eseguire lo strumento di trasformazione utilizzando Python:

   python3 -m venv venv
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. Avvia lo strumento di trasformazione:

   ./transform.sh -extract= -customers= -users= -newphones=

Customer/user precontrollo

Lo strumento Transform Tool effettua chiamate API a Webex per individuare potenziali problemi di provisioning. Per impostazione predefinita, verranno convalidati l'indirizzo e l'indirizzo email principale del cliente. Se il valore PROVISIONING_ID è specificato nel conf/partner.cfg file, convaliderà anche le informazioni sulla posizione. I risultati del controllo preliminare sono inclusi nel rapporto sulle eccezioni.

Inoltre, durante l'esecuzione dello strumento di trasformazione è possibile aggiungere i seguenti parametri opzionali:

precontrollo

Oltre a eseguire la pre-verifica tramite API per le informazioni del cliente, lo strumento Transform Tool eseguirà anche la pre-verifica tramite API per gli indirizzi email degli abbonati.

precheckinfo

Per impostazione predefinita, nel report delle eccezioni vengono inclusi solo gli errori di pre-verifica (ovvero i problemi che bloccheranno il provisioning). L'aggiunta di questo flag includerà anche i risultati positivi del pre-controllo (ad esempio, se esiste già un'organizzazione Webex che può essere collegata automaticamente).

Registri del terminale

Nel terminale vengono visualizzati i seguenti messaggi di log in caso di trasformazione riuscita:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Rapporto di eccezione

Transform Tool genera il report delle eccezioni all'interno dell'output /<timestamp>/exception_report.txt directory. È possibile utilizzare questo report per identificare i problemi che potrebbero influire sulla migrazione e risolverli nel sistema Cisco BroadWorks.

Dopo aver modificato i dati utente per risolvere l'eccezione, eseguire nuovamente gli strumenti di estrazione e trasformazione con i nuovi dati. Il file di esempio del rapporto di eccezione è il seguente:

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

Output

Un file JSON di output (customer.json) sarà disponibile in output/<timestamp>/<groupid> directory. Il file di esempio customer.json è il seguente:

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

Lo strumento di provisioning può essere eseguito su qualsiasi macchina, in genere il laptop dell'amministratore del partner, e utilizza le API pubbliche di Webex. Legge il file JSON di output dello strumento di trasformazione (customer.json) come input e configura clienti, sedi, numeri, utenti, servizi e dispositivi nella soluzione Webex Wholesale RTM.

Prerequisiti

Configurare i seguenti prerequisiti all'interno della directory dello strumento di provisioning:

1. Installa Java 8, 11, 17 o 21 sul computer. Java è disponibile da molte fonti, tra cui:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Dopo aver scaricato ed estratto i file binari degli strumenti di migrazione, impostare la variabile d'ambiente JAVA_HOME nel file provisioning_tool.sh per MAC e nel file provisioning_tool.bat per Windows.
3. Il file partner.cfg:
   • Imposta l'ID di PROVISIONING__ALL'INGROSSO e il TOKEN DI AGGIORNAMENTO_(Token copiato dallo strumento Generatore di token). Gli amministratori partner devono contattare il proprio team di account per ottenere l'ID PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Imposta SEND_SUBSCRIBERS_WELCOME_EMAIL su false se i partner non desiderano inviare un'email di benvenuto agli utenti. Il valore predefinito è true.

     Webex invia email di benvenuto solo agli utenti finali. Gli amministratori dei clienti non ricevono email di benvenuto.

     Gli utenti e gli amministratori dei clienti con sede negli Stati Uniti e in Canada ricevono una notifica via e-mail separata da RedSky. La piattaforma RedSky E911 invia questa email per confermare la creazione dell'account cliente per i servizi di emergenza. Questa email di RedSky è separata dalle email di benvenuto di Webex e non è controllata dalle impostazioni email di Webex. Per le organizzazioni all'ingrosso negli Stati Uniti e in Canada, RedSky viene abilitato automaticamente come fornitore di servizi di emergenza.

4. Utilizzare la proprietà WEBEX4BWKS_EMAIL_SUBJECT per le migrazioni di Webex per BroadWorks per inviare l'oggetto dell'e-mail di richiesta di modifica della password agli abbonati di Webex per BroadWorks.
5. Utilizzare la proprietà WEBEX4BWKS_EMAIL_BODY per le migrazioni di Webex per BroadWorks per inviare il corpo dell'e-mail di richiesta di modifica della password agli abbonati di Webex per BroadWorks.
6. Utilizza la proprietà CUSTOM_TAGS per aggiungere tag dopo la creazione del cliente.
7. Per applicare gli sconti all'ingrosso, gli amministratori dei partner devono contattare il team account di Cisco prima di iniziare la migrazione.

   Una nuova proprietà, APPLICA_ALL'INGROSSO_SCONTI, viene aggiunta al file partner.cfg. Abilita questa proprietà per applicare sconti a utenti e spazi di lavoro.

Istruzioni per l'esecuzione

Segui questi passaggi per eseguire lo strumento su Windows e macOS:

Windows

Per eseguire lo strumento su un sistema operativo Windows, seguire i passaggi seguenti:

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

Per eseguire lo strumento su macOS, segui questi passaggi:

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

Prerequisiti per la migrazione da Webex a BroadWorks

Gli amministratori dei partner devono aggiornare il modello di onboarding di BroadWorks per le funzionalità di coesistenza di Webex con BroadWorks. Si veda l'immagine seguente:

Una volta aggiornato il modello di onboarding di Webex per BroadWorks per supportare la migrazione, richiedi al team di account Cisco di abilitare l'opzione "wholesale-partner-blending-enabled" a livello di partner. Ciò consentirà di aggiungere i pacchetti Wholesale alle organizzazioni clienti Webex per BroadWorks esistenti durante la fase di provisioning.

Eseguire lo strumento di provisioning con un argomento aggiuntivo.

Fase di preparazione: Questa è la fase predefinita in cui gli amministratori possono configurare gli utenti BroadWorks come abbonati all'ingrosso e continuare con Webex per gli utenti BroadWorks.

Fase di manutenzione: Questa è la seconda fase in cui gli amministratori possono assegnare la licenza Wholesale agli utenti Webex per BroadWorks già esistenti. È necessario eseguire lo strumento di provisioning con l'argomento maintenance.

Fase post-migrazione: Questa è la fase finale in cui gli amministratori possono convertire completamente BroadWorks in versione Wholesale. È necessario eseguire lo strumento di provisioning con l'argomento postmigration.

Registri del terminale

Di seguito sono riportati i log del terminale relativi al provisioning avvenuto con successo:

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

Verrà stampata una tabella con il numero di posizioni create per ogni esecuzione:

Output

Lo strumento di provisioning genera report di successo ed errore all'interno dell'output <external_id>/*.success/error file. Esamina i log di successo e di errore per verificare che il provisioning sia andato a buon fine.

Il sistema genererà un file Provisioning_Report_*.csv nella directory output/consolidated_reports/. Questo file contiene i dettagli relativi sia ai successi che ai fallimenti per ciascuna entità e le relative impostazioni, fornendo un report di provisioning completo.

Gli amministratori dei partner possono verificare il provisioning del cliente nel Partner Hub e nel portale Control Hub. Si prega di fare riferimento alle seguenti illustrazioni tratte dai portali Partner Hub e Control Hub:

Figura 8: Partner Hub

Figura 9: Control Hub

Figura 10: Dispositivi

Figura 11: Chiamata

Restrizioni post-provisioning

Una volta completato il provisioning per una migrazione BroadCloud, le seguenti azioni saranno bloccate:

• Portale CAP – Aggiunta di utenti o dispositivi portati.
• Portale SP – Creazione di ordini ADD con dispositivi o numeri.
• RSB API – Creazione di ordini ADD con dispositivi o numeri e creazione di utenti. Gli ordini RSB ADD effettuati con dispositivi o numeri verranno rifiutati.

Per BroadCloud

Per i partner BroadCloud, utilizzare il portale del fornitore di servizi per inviare una richiesta di migrazione per numeri, dispositivi e Shared Call Appearances (SCA).

All'interno del portale del fornitore di servizi, una richiesta di migrazione può includere fino a 50 clienti. È possibile inviare un massimo di 10 richieste al giorno.

Gli amministratori possono abilitare il rollback automatico impostando ROLLBACK_TO_BROADCLOUD=true nel file conf/partner.cfg, che riporta i dispositivi a BroadCloud dopo la migrazione. Supporta migrazioni sia all'interno della stessa regione che tra regioni diverse con NS Sync, ma solo per le migrazioni riuscite. In caso di errori, gli amministratori devono contattare il supporto tecnico Cisco (Cisco TAC) prima di richiedere il ripristino.

Nel portale sono disponibili due opzioni per la selezione del tipo di migrazione:

• Migrazione – Seleziona questa opzione per avviare una richiesta di migrazione di numeri, dispositivi e Shared Call Appearance (SCA).
• Stato del dispositivo – Seleziona questa opzione per visualizzare lo stato attuale di un dispositivo su BroadCloud e Calling.

Le seguenti figure mostrano il portale del fornitore di servizi.

Figura 12: Portale dei fornitori di servizi

Figura 13: Portale dei fornitori di servizi

Migra le posizioni selezionate (facoltativo)

Per avviare la migrazione per un sottoinsieme specifico di posizioni elencate nel file customer.json, includi un file locations.csv nella tua richiesta. Questo file CSV deve elencare solo le posizioni che si intendono migrare.

Per scaricare l'elenco dei siti attivi disponibili, vai a Visualizza clienti → Seleziona un cliente → Esporta posizioni come CSV.

Figura 14: Esporta le posizioni in formato CSV

Abilita l'opzione di disconnessione dei numeri

Quando si utilizza lo stesso trunk SIP per Webex Calling e BroadCloud Carrier, gli amministratori devono utilizzare l'opzione Disconnetti numeri. Questa operazione impedisce ai numeri di telefono di ricevere chiamate in entrata dopo la migrazione in BroadCloud.

Per abilitare questa opzione,

1. Nel file partner.cfg, impostare DISCONNECT_NUMBERS_FROM_RIALTO = SÌ.
2. Eseguire nuovamente lo strumento di migrazione utilizzando lo stesso file customer.json e il file partner.cfgaggiornato.

Se i numeri non si disconnettono, inviare una richiesta al Cisco TAC .

Per Cisco BroadWorks e Webex per BroadWorks

Per le migrazioni di Cisco BroadWorks e Webex for BroadWorks, lo strumento viene eseguito sul server applicazioni Cisco BroadWorks secondario all'interno della rete del partner e si connette all'AS tramite OCI-P. Utilizza il file JSON di output dello strumento di trasformazione (customer.json) come input ed esegue i comandi OCI-P per migrare dispositivi e client software.

In caso di funzionamento corretto, lo strumento di spostamento del dispositivo eseguirà le seguenti operazioni:

1. Annullare la registrazione dei dispositivi da Cisco BroadWorks e registrarli in Wholesale.
2. Gli utenti che utilizzano il client UC-One verranno reindirizzati all'app Webex al primo accesso.
3. Disattiva i numeri di telefono da Cisco BroadWorks oppure rimuovili da BroadCloud.
4. Attiva i numeri nel settore all'ingrosso.
5. Creazione di visualizzazioni di chiamata condivise in Wholesale per le migrazioni BroadCloud. [This Questo passaggio è applicabile solo a BroadCloud migrations].

SCP e SSH

1. Trasferisci lo strumento di spostamento del dispositivo SCP al server applicativo secondario Cisco BroadWorks.
2. Connettiti tramite SSH al server applicativo Cisco BroadWorks secondario per configurare i prerequisiti ed eseguire lo strumento di spostamento del dispositivo.

Prerequisiti

1. Imposta il TOKEN REFRESH_(Token copiato dallo strumento Generatore di token) nel conf/partner.cfg file:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Assicurarsi che l'ID utente, la password e il nome host del server applicazioni Cisco BroadWorks secondario siano corretti. conf/deviceMoveTool.conf file:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Per reinviare le email di attivazione, è necessario impostare INVIA_ISCRIVITI_BENVENUTI_EMAIL=true nel conf/partner.cfg file.

   Se gli amministratori desiderano inviare email di invito ai propri utenti durante la migrazione, devono decommentare "SEND_SUBSCRIBERS_WELCOME_EMAIL=true" proprietà nel conf/partner.cfg file. Altrimenti, la proprietà non dovrebbe subire modifiche.

4. Verificare JDK/JRE Il percorso dell'ambiente è corretto in devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Gli amministratori possono utilizzare il file locations.csv presente nella directory di input per migrare gruppi specifici anziché tutti i gruppi di un'azienda.

telefoni Polycom

Per spostare i telefoni Polycom da Cisco BroadWorks a Wholesale Calling, un amministratore partner deve creare un nuovo Identity/Device File di tipo profilo a livello di sistema in Cisco BroadWorks ogni modello di dispositivo Polycom. Fare riferimento alla figura 14 e caricare il file personalizzato device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Dopo aver caricato il nuovo file del dispositivo, assicurarsi che il file appena creato esista a livello di gruppo. Assicurati inoltre che il file migration_%BWMAC ADDRESS%.cfg non sia in conflitto con alcun file già presente nel tuo sistema.

Viene utilizzato internamente dallo strumento di spostamento del dispositivo.

La procedura di migrazione per i telefoni Polycom:

1. Lo strumento di spostamento del dispositivo sostituisce il file %BWMACADDRESS%.cfg a livello del dispositivo con polycom_vvx2.cfg. Questo file fa riferimento a migration_%BWMACADDRESS%.cfg.
2. Ricrea i profili dei dispositivi a livello di gruppo o a livello di singolo dispositivo.
   L'azione a livello di gruppo o a livello di dispositivo dipende dalla configurazione del parametro deviceLevelRebuild nel file device-move-tool/conf/partner.cfg.
3. Lo strumento di spostamento dei dispositivi richiede al Cisco BroadWorks Application Server di riavviare i telefoni a livello di gruppo o a livello di singolo dispositivo.
4. Dopo la richiesta di riavvio, i telefoni Polycom scaricano ed elaborano% BWMACADDRESS%.cfg, che chiede ai telefoni Polycom di scaricare ed elaborare migration_%BWMACADDRESS%.cfg, che imposta il device.prov.serverName su https://plcm.sipflash.com.
   https://plcm.sipflash.com Per la regione degli Stati Uniti, gli URL sono diversi per le altre regioni.
5. Il telefono Polycom scarica %BWMACADDRESS%.cfg da https://plcm.sipflash.com e verrà gestito dal DMS di chiamata Webex.

Figura 14: Identity/device tipo di profilo file aggiungi

Istruzioni per l'esecuzione

Esistono due metodi per richiamare il DMT: il primo consiste nel richiamarlo tramite un singolo cliente alla volta, mentre il secondo consiste nel farlo tramite più clienti contemporaneamente.

Lo strumento di spostamento del dispositivo viene eseguito dal server applicativo Cisco BroadWorks secondario all'interno della directory dello strumento di spostamento del dispositivo:

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

Registri del terminale

Di seguito sono riportati i log del terminale relativi all'esecuzione corretta dello strumento di spostamento del dispositivo per la migrazione del dispositivo:

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

Output

Dopo la migrazione dei dispositivi, i dispositivi sono entrati in linea e sono pronti per make/receive chiamate. Si veda la figura 15 per un esempio dello stato del dispositivo:

Figura 15: Stato dispositivo

Dopo la migrazione dei dispositivi, i numeri sono diventati attivi. Si veda la figura 16 per un esempio dei numeri attivi:

Figura 16: Numeri attivi

Se l'amministratore utilizza lo strumento dietro un proxy aziendale, seguire i passaggi seguenti per configurare ed eseguire lo script devicemove.

Passaggi per configurare ed eseguire lo script devicemove

1. Apri il file devicemove.sh.
2. Individua la variabile HTTPS_PROXY_HOST e decommentala (rimuovi il commento iniziale #).

3. Imposta il valore HTTPS_PROXY_HOST come:

   HTTPS_PROXY_HOST=

4. Individua la variabile HTTPS_PROXY_PORT e decommentala (rimuovi il commento iniziale #).
5. Imposta il valore HTTPS_PROXY_PORT come:

   HTTPS_PROXY_PORT=

6. Salva e chiudi il file devicemove.sh.
7. Apri il file partner.cfg e aggiungi le parentesi quadre refresh_token.
8. Verifica che l'host BroadWorks, il nome utente e la password siano configurati correttamente nel file partner.cfg.
9. Esegui lo script:

   ./devicemove.sh

L'operazione di ripristino deve essere eseguita per una sola azienda alla volta.

Per BroadCloud Carrier

Gli amministratori possono impostare ROLLBACK_TO_BROADCLOUD=true in conf/partner.cfg per abilitare il rollback automatico. Questa operazione riporta i dispositivi su BroadCloud dopo una migrazione riuscita nella stessa regione o in una regione diversa tramite NS Sync. In caso di migrazioni non riuscite, contattare il supporto tecnico Cisco (Cisco TAC) prima di richiedere il ripristino.

Per Cisco BroadWorks e Webex per BroadWorks

La procedura di ripristino per Cisco BroadWorks e Webex per BroadWorks è la seguente:

1. Apri un ticket con il supporto tecnico Cisco (TAC) per richiedere il ripristino del dispositivo.
2. Eseguire lo strumento di spostamento dei dispositivi in modalità di ripristino sul server applicazioni BroadWorks secondario per annullare le migrazioni dei dispositivi. In questo modo l'URL DMS verrà ripristinato all'URL DMS del fornitore di servizi per i profili dei dispositivi in Cisco BroadWorks e i numeri di telefono verranno riattivati.
3. Il team di Webex Calling reimposta l'URL DMS sull'URL DMS del fornitore di servizi nei profili dispositivo in Webex Calling.
4. Gli amministratori dei partner devono disattivare o eliminare i numeri di telefono in Webex Calling tramite il portale Control Hub.
5. Gli amministratori dei partner devono riportare i numeri di telefono PSTN su Cisco BroadWorks.

Istruzioni per eseguire lo strumento di spostamento del dispositivo in modalità inversa

Segui i passaggi seguenti per eseguire lo strumento di spostamento del dispositivo in modalità di ripristino:

Eseguire il comando seguente nel server applicativo secondario Cisco BroadWorks all'interno della directory dello strumento di spostamento del dispositivo:

Ripristina i profili

./devicemove.sh -input=  -revertProfiles

Numeri invertiti

./devicemove.sh -input=  -revertNumbers

Registri del terminale

Dopo aver eseguito correttamente lo strumento di spostamento del dispositivo per l'operazione di ripristino, nel terminale verranno visualizzati i seguenti log:

Ripristina i profili

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

Numeri invertiti

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully