Grazie per il feedback.

I telefoni supportati verranno creati e assegnati automaticamente agli utenti Webex Calling tramite lo strumento di provisioning. I telefoni contrassegnati con «sì» nella colonna «Supportati nello strumento di spostamento del dispositivo» verranno inoltre spostati automaticamente da Cisco BroadWorks o BroadCloud a Webex Calling quando viene eseguito lo strumento di spostamento del dispositivo. I telefoni contrassegnati con «No» in quella colonna richiedono un intervento manuale per modificare l'URL DMS nel modello di 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 partner eseguono questo strumento di utilità per la generazione di token almeno una volta prima di iniziare a eseguire gli strumenti di migrazione. L'esecuzione di questo strumento è un'attività una tantum dopo l'inserimento 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 l'aggiornamento ai 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, estrae i 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

Uscita:

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

Aprire l'URL nel browser web del terminale, accedere con le credenziali dell'amministratore del partner per ottenere il TOKEN e copiarlo per un ulteriore utilizzo.

Le illustrazioni dell'interfaccia utente sono riportate di seguito come riferimento:

Figura 3: Effettua il login con Cisco Webex

Figura 4: finestra delle credenziali

Figura 5: generazione di token

Configura i seguenti passaggi, prima di eseguire gli strumenti di estrazione e spostamento del dispositivo nel server BroadWorks secondario.

Attivare la connettività OCI-P

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

Fase 1: Usa la CLI per configurare le Impostazioni generali.

Esegui il seguente comando nella CLI per passare alla directory GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Esegui il seguente comando nella CLI per ottenere le impostazioni generali correnti:

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

Se le sue impostazioni non corrispondono a quanto sopra, usi il comando set per riconfigurare le sue impostazioni.

Fase 2: Usa la CLI per configurare il proxy OCI.

Cambia la directory in OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Esegui la seguente CLI per ottenere le impostazioni correnti. Dovrebbe vedere quanto segue:

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

Se le sue impostazioni non corrispondono a quanto sopra, usi il comando set per riconfigurare le sue impostazioni.

Fase 3: Usa la CLI per configurare OCI Provisioning.

Passare alla directory Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Esegui il seguente comando per ottenere le impostazioni correnti di OCI Provisioning:

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

Passaggio 4: esegua il comando seguente nella CLI per verificare che la sua 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

Usa i comandi seguenti per distribuire e avviare Open Client Server sull'Application Server secondario se non è distribuito o non è già stato avviato .

Fase 1: Distribuire il server con il seguente comando CLI:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Fase 2: Avviare il server con questo comando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Attivare l'attivazione dei numeri

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

Passaggio 1: esegui il comando di attivazione numerica:

AS_CLI> cd SubscriberMgmt/NumberActivation

Passaggio 2: esegui il comando di attivazione abilitata:

AS_CLI> set dnMode groupAndUserActivationEnabled

Fase 3: Alla richiesta di conferma, inserire Y.

Per BroadCloud

Lo strumento di estrazione è integrato nel portale BroadCloud Service Provider. L'amministratore di un fornitore di servizi può:

1. Invia richieste di estratto per un massimo di 50 clienti per richiesta.
   La richiesta di estratto non può essere inviata per lo stesso cliente più di 10 volte in un giorno.
2. Scarichi il file di dati estratto, in formato ZIP, per un massimo di 28 giorni dalla data di invio della richiesta.

Le figure seguenti mostrano il portale dei fornitori di servizi.

Figura 6: Portale dei fornitori di servizi

Figura 7: Portale dei fornitori di servizi

Richiesta di estratto CSV

Avvia una richiesta di estrazione CSV

1. Scarica il file CSV per i clienti

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

2. Modificare l'elenco clienti

   L'amministratore può modificare questo file CSV per includere solo i clienti per i quali deve essere eseguita l'estrazione.

3. Carica e invia

   Dopo la modifica, carichi il CSV modificato.

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

Avvia una richiesta di estrazione per un cliente con sedi CSV

1. Seleziona il cliente e le sedi dei download

   Scelga un cliente dal menu a discesa.

   Scarichi il file locations.csv corrispondente da Visualizza clienti → scheda Siti → Esporta sedi in formato CSV.

2. Modificare il file delle sedi

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

3. Carica e invia

   Carichi il file locations.csv modificato e faccia clic su Invia.

   Solo le sedi specificate per il cliente selezionato saranno incluse nella richiesta di estratto.

Avvia una richiesta di estratto per tutti i clienti

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

Per Cisco BroadWorks e Webex per BroadWorks

1. Lo strumento di estrazione viene eseguito sull'Application Server Cisco BroadWorks secondario all'interno della rete dei partner e si connette tramite OCI-P.
2. Lo strumento estrae i dati grezzi relativi all'azienda, al gruppo, ai numeri, agli utenti, ai servizi, ai dispositivi e ai soft client dalla piattaforma Cisco BroadWorks o BroadCloud e li trasmette 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, i file binari dello strumento di estrazione sul Cisco BroadWorks Application Server secondario.
2. SSH al server applicativo Cisco BroadWorks secondario per configurare i prerequisiti ed eseguire lo strumento di estrazione.
3. Configura il fornitore di servizi e l'ID del gruppo per l'estrazione da Cisco BroadWorks in conf/ExportTool.yml. Si riferisca al seguente frammento YAML di esempio:

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

4. Assicurarsi che l'ID utente, la password e il nome host secondari di Cisco BroadWorks Application Server siano corretti nel file conf/partner.cfg :

   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 una migrazione Webex per BroadWorks.

5. Modificare il percorso di ambiente JDK/JRE nel file export.sh se il percorso di ambiente JDK/JRE secondario di Cisco BroadWorks Application Server è diverso dal file:

   JAVA_HOME=/usr/local/java/java_base

Istruzioni per l'esecuzione

Esegui il seguente comando nell'Application Server Cisco BroadWorks secondario dalla directory degli strumenti di estrazione:

./export.sh

Registri del terminale

I seguenti registri sono disponibili nel terminale in caso di esportazione riuscita: Running BroadSoft Data Export Tool:

 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
**************************************************

Uscita

Un <timestamp>file ZIP di output (extracted_data_ .zip) è disponibile nella stessa directory dello strumento di estrazione. Usa il seguente comando per visualizzare e utilizzare il file ZIP per l'input dello Strumento di trasformazione:

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, segua i passaggi seguenti per configurare ed eseguire lo script di esportazione.

Passaggi per configurare ed eseguire lo script di esportazione

1. Aprire il file export.sh.
2. Individui la variabile HTTPS_PROXY_HOST e decommentala (rimuova il # iniziale).

3. Imposta il valore HTTPS_PROXY_HOST come:

   HTTPS_PROXY_HOST=<proxy-host>

4. Individui la variabile HTTPS_PROXY_PORT e decommentala (rimuova il # iniziale).
5. Imposta il valore HTTPS_PROXY_PORT come:

   HTTPS_PROXY_PORT=<proxy-port>

6. Salvare e chiudere il file export.sh.
7. Aprire il file partner.cfg e aggiungere il refresh_token richiesto.
8. Verifichi che l'host, il nome utente e la password di BroadWorks siano configurati correttamente in partner.cfg.
9. Esegui lo script:

   ./export.sh

Modulo di coinvolgimento:

L'Extract Tool (BroadCloud e BroadWorks) ora genera automaticamente un file XLSX consolidato intitolato Engagement Form SUA.xlsx durante l'esecuzione. Il file è precompilato con tutti i dati disponibili nei fogli di lavoro pertinenti, contribuendo a semplificare e accelerare il completamento dei partner.

Questo strumento di trasformazione funziona per tutte le migrazioni. Lo strumento di trasformazione funziona su qualsiasi computer, incluso il laptop amministratore di un partner, e utilizza le API pubbliche Webex. Legge il <timestamp>file ZIP (extracted_data_ .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, configuri i seguenti prerequisiti:

1. Imposta REFRESH_TOKEN (token copiato dal Token Generator Tool) e NAME_OF_MAIN_LOCATION nel file conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Facoltativamente, imposta il PROVISIONING_ID (copiato dal modello in Partner Hub) nel file conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Per ottenere una verifica più completa dell'indirizzo email del cliente, può facoltativamente impostare il PROVISIONING_ID.
3. Configurare le informazioni mancanti nel file input/customers.csv (vedere la sezione successiva), se mancanti.
4. Aggiungere l'indirizzo email dell'utente finale nel file input/users.csv.
5. Se deve essere effettuato il provisioning di nuovi telefoni, aggiunga l'indirizzo mac e l'indirizzo email del nuovo telefono dell'utente al file input/newphones.csv. Questo è necessario solo se gli amministratori partner desiderano fornire nuovi telefoni nelle chiamate all'ingrosso.
6. Convertire i call center BroadWorks in CXEssentials utilizzando il file input/cxessentials.csv.
7. Facoltativamente, abiliti la proprietà UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS per convertire tutti i call center in CXEssentials.
8. Usa il file input/locations.csv per supportare la migrazione delle grandi aziende che consente agli amministratori di migrare le sedi dei clienti in base alla località
9. Facoltativamente, abiliti 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. Togliere il commento alla riga USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes nel file conf/partner.cfg
10. Facoltativamente, abiliti 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 in attesa e disabilitare le impostazioni del T38 per tutti gli utenti di tipo analogico.

11. Se desidera configurare dispositivi gateway generici, aggiunga l'indirizzo MAC e l'ID utente del dispositivo al file input/genericgateways.csv. Inoltre, indichi se l' utente è il proprietario PRINCIPALE o un utente CONDIVISO (per le apparizioni di chiamata condivise). Ciò è necessario solo se gli amministratori dei partner intendono utilizzare dispositivi gateway generici in Wholesale Calling.

    Questa funzione 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, aggiorna il file conf/rialto_station_type_to_wholesale_package.csv sostituendo il valore del pacchetto Wholesale con voice_mail_group per la riga in cui il tipo di stazione Rialto sta inviando messaggi.

    Facoltativamente, abiliti la proprietà COMMON_VOICE_MAIL_GROUP_PASSCODE in 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 cliente nel file customers.csv nella colonna CommonVoicemailGroupPasscode.

13. Per la migrazione di contatti comuni a Webex Calling

    È il miglioramento per la gestione dei contatti comuni a livello aziendale e di sito. Questi contatti possono ora essere migrati come contatti dell'organizzazione (Org Contacts) o come estensioni virtuali, in base alle impostazioni di configurazione. Di seguito sono riportati i dettagli per guidarla attraverso questo processo di migrazione.

    Configurazione chiave:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Una nuova proprietà, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, è stata introdotta nel file partner.cfg. Questa proprietà determina la migrazione dei contatti più comuni 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 dell'organizzazione).

      Non è richiesta alcuna configurazione aggiuntiva.

      I contatti rimangono accessibili a livello di organizzazione.

    • Con COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurato

      I contatti comuni verranno migrati come estensioni virtuali.

      A ogni contatto verrà aggiunto un numero di interno e l'intervallo iniziale dell' estensione è definito nella proprietà COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE in partner.cfg.

      Le estensioni virtuali sono supportate sia a livello di organizzazione che a livello di sede, a seconda dell'ambito del contatto.

14. Abilita il fornitore predefinito di registrazione delle chiamate su Webex.

    Questo passaggio è necessario solo durante la migrazione delle 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, imposta la seguente proprietà, DEFAULT_CALL_RECORDING_VENDOR=WebEx.
    • Inoltre, utilizzi la proprietà WEBEX_CALL_RECORDING_STORAGE_REGION per configurare l'area di archiviazione.

      L'opzione di registrazione On Demand di BroadCloud non è supportata inWebex Calling. Queste impostazioni di registrazione delle chiamate non verranno migrate e verranno visualizzate nel rapporto sulle eccezioni.

15. Esclusione dei numeri di telefono selezionati dalla migrazione:

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

    • Inizialmente esegua lo strumento di trasformazione per la prima volta. Al termine, lo strumento genererà un file chiamato telephone_numbers_inventory.csv, situato nella directory output/timestamp/. Il cliente è tenuto a rivedere questo file e indicare «Sì» nella colonna «Drop Tn's» per ogni numero di telefono che deve essere escluso dalla migrazione imminente.
    • 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, imposta la proprietà ALLOW_RESTRICT_BY_PARTNER_MODE su OFF per consentire agli amministratori dei clienti 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 (Mobile Network Integration) a Wholesale Webex Calling (operatore di rete mobile Webex Go).

    Prerequisiti - Prima di iniziare il processo di migrazione, gli amministratori partner devono contattare il team Cisco Account per eseguire la configurazione del fornitore Cloud Connected PSTN (CCP) e della Custom Carrier List (CCL).

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

    • Questa funzione è 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 un numero di cellulare viene assegnato a un utente, il numero PSTN principale diventa il numero secondario (alternativo).
    • I numeri di cellulare non possono essere migrati per gli utenti che vengono convertiti in spazi di lavoro o linee virtuali.
    • Dopo l'assegnazione di un numero di cellulare in Wholesale Webex, verrà visualizzato come 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 dei telefoni cellulari configurate dagli utenti finali nel Calling User Portal (CUP) non vengono migrate. Dopo la migrazione, quando viene chiamato un numero di telefono, un numero di cellulare o un interno, tutti i dispositivi dell'utente squilleranno.

18. Per configurare facoltativamente i limiti di quantità dei pacchi durante la migrazione del cliente, specifichi la quantità per ogni pacco nel file input/package_quantity.csv. La quantità di pacchetti configurati deve essere maggiore o uguale al numero di pacchetti assegnati all' utente/spazio di lavoro.

    I limiti di quantità dei pacchi non sono attualmente supportati per le migrazioni da Webex for BroadWorks a Wholesale.

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

19. Migrare i siti di più clienti da Broadworks/BroadCloud a un unico cliente nel commercio all'ingrosso Webex Calling
    • Una nuova modalità di runtime, -ConsolidatedMigration, è stata introdotta nello strumento Transform per supportare la migrazione di più siti di clienti da Broadcloud/Broadworks alla piattaforma Webex Wholesale in un'unica organizzazione di clienti all'ingrosso. Quando questa modalità è abilitata, lo strumento consolida più siti di clienti in un'unica organizzazione clienti Wholesale

      -consolidatedMigration

    • Ci sono altri argomenti opzionali che possono essere forniti insieme a -ConsolidatedMigration come

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

    • se viene fornito -TargetEnterpriseId e l'ID esiste nel file di output dello strumento di estrazione, verrà utilizzato per creare l'organizzazione clienti Wholesale e se l'ID non viene trovato, lo strumento utilizzerà tutti i dati del cliente disponibili nel file di output dello strumento di estrazione.
    • se viene fornito -ConsolidatedExternalId, imposterà l'ExternalId per il cliente e se non viene fornito, lo strumento tornerà a utilizzare il flusso esistente per l'ID esterno.
    • <timestamp>Un file JSON (customer.json) consolidato sarà disponibile nella directory output/ /consolidated.

Compilando il file input/customers.csv

Il file input/customers.csv fornisce dati che forse mancano in Cisco BroadWorks o BroadCloud. Questo file può essere lasciato vuoto se tutte le informazioni obbligatorie sono già disponibili. Non deve compilare tutte le colonne, solo le informazioni mancanti sono obbligatorie.

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

Compilando il file input/users.csv

Il file input/users.csv fornisce dati che forse mancano in Cisco BroadWorks o BroadCloud. Questo file può essere lasciato vuoto se tutte le informazioni obbligatorie sono già disponibili. Non deve compilare tutte le colonne, solo le informazioni mancanti sono obbligatorie.

Istruzioni per l'esecuzione

Esegui il Transform Tool in qualsiasi sistema operativo. Usa i passaggi seguenti per eseguire lo strumento in Windows e macOS:

Windows

Esegua il comando seguente per eseguire lo strumento di trasformazione in Windows:

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

macOS

Esegua i seguenti passaggi per eseguire lo strumento di trasformazione su macOS:

1. Crea un ambiente virtuale e installa le dipendenze per eseguire lo strumento di trasformazione usando 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. Esegui lo strumento di trasformazione:

   ./transform.sh -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Controllo preliminare cliente/utente

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

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

controllo preliminare

Oltre a eseguire l'API di precontrollo per le informazioni sui clienti, il Transform Tool eseguirà anche l'API di precontrollo per le email degli abbonati.

precheckinfo

Per impostazione predefinita, nel rapporto sulle eccezioni sono inclusi solo gli errori di precontrollo (ad esempio, problemi che bloccheranno il provisioning). L'aggiunta di questo flag includerà anche i risultati del precontrollo corretto (ad esempio, se esiste già un'organizzazione Webex che può essere allegata automaticamente).

Registri del terminale

I seguenti accedono al terminale 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 sulle eccezioni

Transform Tool genera il rapporto sulle eccezioni all'interno della directory output/ /exception_report.txt<timestamp>. Può utilizzare questo rapporto per identificare i problemi che influiranno sulla migrazione e risolverli nel sistema Cisco BroadWorks .

Dopo aver modificato i dati dell'utente per risolvere l'eccezione, riesegui gli strumenti di estrazione e trasformazione con i nuovi dati. Il file di segnalazione delle eccezioni di esempio è 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

Uscita

Un file JSON di output (customer.json) sarà disponibile nella directory output//. <timestamp><groupid> Il file customer.json di esempio è 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, di solito il (laptop dell'amministratore del partner) e utilizza le API pubbliche Webex. Legge il file JSON (customer.json) di output dello strumento di trasformazione come input e assegna il provisioning di clienti, sedi, numeri, utenti, servizi e dispositivi nella soluzione Webex Wholesale RTM.

Prerequisiti

Configura i seguenti prerequisiti all'interno della directory degli strumenti 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, imposta la variabile di ambiente JAVA_HOME in provisioning_tool.sh per MAC e provisioning_tool.bat per Windows.
3. Il file partner.cfg:
   • Imposta WHOLESALE_PROVISIONING_ID e REFRESH_TOKEN (token copiato dal Token Generator Tool). Gli amministratori partner devono contattare il team del proprio account per ottenere il PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

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

     Gli utenti e gli amministratori dei clienti con sede nelle sedi degli Stati Uniti e del Canada ricevono una notifica 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 RedSky è separata dalle e-mail di benvenuto di Webex e non è controllata dalle impostazioni e-mail di Webex. Per le organizzazioni di vendita all'ingrosso negli Stati Uniti e in Canada, RedSky viene automaticamente abilitato come fornitore di servizi di emergenza.

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

   Una nuova proprietà, APPLY_WHOLESALE_DISCOUNTS è stata aggiunta a partner.cfg. Abilita questa proprietà per applicare sconti agli utenti e agli spazi di lavoro.

8. (Facoltativo) Configurare in modo esplicito la connessione PSTN

   Per specificare la connessione PSTN per tutte le sedi assegnate durante la migrazione, inclusa la posizione principale, aggiunga la seguente proprietà al file partner.cfg:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Se la proprietà non è configurata o è commentata, lo strumento di provisioning utilizza il processo di selezione della connessione PSTN predefinito.

Istruzioni per l'esecuzione

Utilizza i seguenti passaggi per eseguire lo strumento in Windows e macOS:

Windows

Esegua i seguenti passaggi per eseguire lo strumento sul sistema operativo Windows:

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

Esegua i seguenti passaggi per eseguire lo strumento su macOS:

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Prerequisiti per la migrazione da Webex a BroadWorks

Gli amministratori partner devono aggiornare il modello di onboarding di BroadWorks per le funzionalità di coesistenza di Webex for BroadWorks. Si riferisca alla seguente immagine:

Una volta aggiornato il modello Webex for BroadWorks Onboarding per supportare la migrazione, richieda al Cisco Account Team di attivare la funzione «wholesale-partner-blending-enabled» a livello di partner. Questa impostazione consente allo strumento di provisioning di aggiungere automaticamente pacchetti all'ingrosso ai clienti Webex for BroadWorks esistenti durante il provisioning.

Esegui lo strumento di provisioning con un argomento aggiuntivo.

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

Fase di manutenzione: è la seconda fase in cui gli amministratori possono assegnare la licenza Wholesale agli utenti Webex for BroadWorks esistenti. Deve eseguire lo strumento di provisioning con una manutenzione degli argomenti.

Fase successiva alla migrazione: è la fase finale in cui gli amministratori possono convertire completamente BroadWorks in vendita all'ingrosso . Deve eseguire lo strumento di provisioning con un argomento dopo la migrazione.

Registri del terminale

Di seguito sono riportati i log del terminale relativi al corretto provisioning:

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 sedi create per ogni corsa:

Uscita

<external_id>Lo strumento di provisioning genera segnalazioni di successo ed errore all'interno dei file output/ /*.success/error. Esamina il successo dell'output e i log degli errori per verificare il corretto provisioning.

Il sistema genererà un file Provisioning_report_*.csv nella directory output/consolidated_reports/. Questo file contiene i dettagli relativi al successo e al fallimento di ciascuna entità e delle relative impostazioni, fornendo un rapporto completo sugli accantonamenti.

Lo strumento di provisioning genera anche un file Provisioning_statistics_*.csv nella directory output/consolidated_reports/. Questo rapporto contiene il conteggio dei clienti, delle sedi, degli utenti, dei dispositivi e delle funzionalità di gruppo assegnati con successo e senza successo.

Gli amministratori dei partner possono verificare l'approvvigionamento dei clienti nel portale Partner Hub e Control Hub. Fare riferimento alle seguenti illustrazioni tratte dal portale Partner Hub e Control Hub:

Figura 8: Partner Hub

Figura 9: Control Hub

Figura 10: Dispositivi

Figura 11: Chiamata

Restrizioni successive all'approvvigionamento

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

• CAP Portal — Aggiungere utenti o dispositivi con porting.
• SP Portal — Creazione di ordini ADD con dispositivi o numeri.
• API RSB — Creazione di ordini ADD con dispositivi o numeri e creazione di utenti. Gli ordini RSB ADD effettuati con dispositivi o numeri verranno rifiutati.

Migrazione da BroadCloud a Wholesale — Limitazione della registrazione dei dispositivi

Per gli amministratori partner che migrano i clienti da BroadCloud a Wholesale all'interno della stessa regione, i dispositivi possono essere aggiunti in Wholesale dopo aver eseguito lo strumento di provisioning. Tuttavia, tali dispositivi diventeranno idonei alla registrazione alla piattaforma Webex solo dopo il completamento della migrazione (spostamento del dispositivo) per la posizione corrispondente.

Questa limitazione non si applica a:

• Clienti che stanno migrando da Broadworks/W4B a Wholesale.
• Migrazioni da BroadCloud a Wholesale tra diverse regioni.

Guida consigliata

Per evitare problemi di registrazione del dispositivo, completa la migrazione dello spostamento del dispositivo a livello di posizione prima di tentare di registrare i dispositivi sulla piattaforma Webex per le migrazioni da BroadCloud a Wholesale della stessa regione.

Per BroadCloud

Per i partner di BroadCloud, utilizza il portale dei fornitori di servizi per inviare una richiesta di migrazione per numeri, dispositivi e migrazioni di Shared Call Appearances (SCA).

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

Gli amministratori possono abilitare il rollback automatico impostando rollback_to_broadcloud=True nel file conf/partner.cfg , che sposta nuovamente i dispositivi su BroadCloud dopo la migrazione. Supporta migrazioni della stessa regione e di diverse regioni con NS Sync, ma solo per migrazioni riuscite. Per quelli falliti, gli amministratori devono alzare un Cisco TAC prima di richiedere il rollback.

Sono disponibili due opzioni per selezionare il tipo di migrazione nel portale:

• Migrazione: selezioni questa opzione per avviare una richiesta di migrazione di numeri, dispositivi e Shared Call Appearances (SCA).
• Stato del dispositivo: selezioni questa opzione per visualizzare lo stato corrente di un dispositivo su BroadCloud e Calling.

Le figure seguenti mostrano il portale dei fornitori di servizi.

Figura 12: Portale dei fornitori di servizi

Figura 13: Portale dei fornitori di servizi

Migrare le località selezionate (opzionale)

Per avviare la migrazione per un sottoinsieme specifico di località elencate nel file customer.json, includa un file locations.csv nella sua richiesta. Questo CSV dovrebbe elencare solo le località che intende migrare.

Per scaricare l'elenco dei siti attivi disponibili, acceda a Visualizza clienti → Seleziona un cliente → Esporta sedi in formato CSV.

Figura 14: Esporta le sedi in formato CSV

Attivi l'opzione di disconnessione dei numeri

Quando utilizza lo stesso trunk SIP per BroadCloud Carrier Webex Calling e BroadCloud, gli amministratori devono utilizzare l'opzione Disconnect Numbers. Questo rimuove i numeri di telefono dalla ricezione di chiamate in arrivo dopo la migrazione in BroadCloud.

Per abilitare questa opzione,

1. Nel file partner.cfg, impostare DISCONNECT_NUMBERS_FROM_RIALTO = yes.
2. Riesegui lo strumento di migrazione utilizzando lo stesso file customer.json e il file partner.cfg aggiornato.

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

Per Cisco BroadWorks e Webex per BroadWorks

Per le migrazioni di Cisco BroadWorks e Webex for BroadWorks, lo strumento viene eseguito sull'Application Server secondario Cisco BroadWorks all'interno della rete dei partner e si connette all'AS tramite OCI-P. Utilizza il file JSON di output di Transform Tool (customer.json) come input ed esegue i comandi OCI-P per migrare dispositivi e soft client.

In caso di corretto funzionamento, lo strumento di spostamento del dispositivo:

1. Annullare la registrazione dei dispositivi da Cisco BroadWorks e registrarli all'ingrosso.
2. Gli utenti che utilizzano il client UC-One verranno reindirizzati all'app Webex al primo accesso.
3. Disattivi i numeri di telefono di Cisco BroadWorks o rimuova i numeri di telefono da BroadCloud.
4. Attiva i numeri in Wholesale.
5. Crea apparizioni condivise per le chiamate all'ingrosso per le migrazioni di BroadCloud. [Questo passaggio è applicabile solo per le migrazioni BroadCloud].

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

   Procedura di configurazione

   1. Aprire il file devicemove.sh.
   2. Individui la variabile PROXY_HOST e decommentala (rimuova il # iniziale per devicemove.sh).

   3. Imposta il valore PROXY_HOST come:

      PROXY_HOST=<proxy-host>

   4. Individui la variabile PROXY_PORT e decommentala (rimuova il # iniziale per devicemove.sh).

   5. Imposta il valore PROXY_PORT come:

      PROXY_PORT=<proxy-port>

   6. Individui la variabile PROXY_SCHEME e decommentala (rimuova il # iniziale di devicemove.sh). Questo passaggio è facoltativo; se rimane commentato, il valore predefinito per PROXY_SCHEME sarà HTTP.

   7. Imposta il valore PROXY_SCHEME come:

      PROXY_SCHEME=<proxy-scheme>

   8. Salvare e chiudere il file devicemove.sh.
   9. Aprire il file partner.cfg e aggiungere il refresh_token richiesto.
   10. Verifichi che l'host, il nome utente e la password di BroadWorks siano configurati correttamente in partner.cfg

   11. Esegui lo script:

       ./devicemove.sh

SCP e SSH

1. SCP, lo strumento di spostamento del dispositivo sull'Application Server Cisco BroadWorks secondario.
2. SSH all'Application Server Cisco BroadWorks secondario per configurare i prerequisiti ed eseguire lo strumento di spostamento del dispositivo.

Prerequisiti

1. Imposta REFRESH_TOKEN (token copiato dal Token Generator Tool) nel file conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Assicurarsi che l'ID utente, la password e il nome host secondari di Cisco BroadWorks Application Server siano corretti nel file conf/DeviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Per inviare nuovamente le email di attivazione, deve impostare send_subscribers_welcome_email=true nel file conf/partner.cfg.

   Se gli amministratori desiderano inviare email di invito ai propri utenti durante la migrazione, devono decommentare la proprietà «send_subscribers_welcome_email=true» nel file conf/partner.cfg. Altrimenti, la proprietà dovrebbe rimanere invariata.

4. Verificare che il percorso dell'ambiente JDK/JRE sia corretto in devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Gli amministratori possono utilizzare il file locations.csv dalla directory di input per migrare i 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 file di tipo di profilo di identità/dispositivo a livello di sistema in Cisco BroadWorks per 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, si assicuri che il file appena creato esista a livello di gruppo. Si assicuri inoltre che il file migration_%BWMAC Address%.cfg non sia in conflitto con nessun file esistente nel suo sistema).

Viene utilizzato internamente dallo strumento di spostamento del dispositivo.

Il processo di migrazione per i telefoni Polycom:

1. Lo strumento di spostamento del dispositivo sostituisce il file %BWMACAddress%.cfg a livello di dispositivo con polycom_vvx2.cfg. Questo file si riferisce a Migration_%BWMACAddress%.cfg.
2. Ricostruisci i profili dei dispositivi a livello di gruppo o di dispositivo.
   L'azione a livello di gruppo o di dispositivo dipende dalla configurazione del parametro DeviceLevelRebuild nel file device-move-tool/conf/partner.cfg.
3. Lo strumento di spostamento del dispositivo chiede al Cisco BroadWorks Application Server di riavviare i telefoni a livello di gruppo o di 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, altre regioni hanno URL diversi.
5. Il telefono Polycom scarica %BWMACAddress%.cfg da https://plcm.sipflash.com e sarà gestito dal DMS. Webex Calling

Figura 14: Aggiunta del file del tipo di profilo di identità/dispositivo

Istruzioni per l'esecuzione

Esistono due metodi per richiamare il DMT, il primo consiste nell'invocare tramite un singolo cliente alla volta e l'altro è utilizzare 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=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Registri del terminale

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

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

Uscita

Dopo la migrazione del dispositivo, i dispositivi sono online e pronti per effettuare/ricevere chiamate. Fare riferimento alla figura 15 per vedere un esempio dello stato del dispositivo:

Figura 15: Stato del dispositivo

Dopo la migrazione del dispositivo, i numeri sono diventati attivi. Si riferisca alla figura 16 per vedere un esempio di quali numeri sono attivi:

Figura 16: Numeri attivi

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

Passaggi per configurare ed eseguire lo script devicemove

1. Aprire il file devicemove.sh.
2. Individui la variabile HTTPS_PROXY_HOST e decommentala (rimuova il # iniziale).

3. Imposta il valore HTTPS_PROXY_HOST come:

   HTTPS_PROXY_HOST=<proxy-host>

4. Individui la variabile HTTPS_PROXY_PORT e decommentala (rimuova il # iniziale).
5. Imposta il valore HTTPS_PROXY_PORT come:

   HTTPS_PROXY_PORT=<proxy-port>

6. Salvare e chiudere il file devicemove.sh.
7. Aprire il file partner.cfg e aggiungere il refresh_token richiesto.
8. Verifichi che l'host, il nome utente e la password di BroadWorks siano configurati correttamente in partner.cfg.
9. Esegui lo script:

   ./devicemove.sh

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

Per BroadCloud Carrier

Gli amministratori possono impostare rollback_to_broadcloud=true in conf/partner.cfg per abilitare il rollback automatico. Ciò restituisce i dispositivi a BroadCloud dopo una migrazione riuscita nella stessa regione o in più regioni con NS Sync. Per le migrazioni non riuscite, contatti Cisco TAC prima di richiedere il rollback.

Per Cisco BroadWorks e Webex per BroadWorks

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

1. Aprire un ticket con Cisco TAC per richiedere il ripristino del dispositivo.
2. Esegui lo strumento di spostamento del dispositivo in modalità di ripristino sull'Application Server BroadWorks secondario per ripristinare le migrazioni dei dispositivi. Questo reimposterà l'URL DMS sull'URL DMS del fornitore di servizi per i profili dei dispositivi in Cisco BroadWorks e riattiverà i numeri di telefono.
3. Il Webex Calling Team reimposta l'URL DMS sull'URL DMS del fornitore di servizi nei profili dei dispositivi in. Webex Calling
4. Gli amministratori dei partner devono disattivare o eliminare i numeri di telefono nel Webex Calling portale di Control Hub.
5. Gli amministratori dei partner devono riportare i numeri di telefono PSTN a Cisco BroadWorks.

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

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

Esegui il comando seguente nell'Application Server Cisco BroadWorks secondario all'interno della directory dello strumento di spostamento del dispositivo:

Ripristina i profili

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Invertire i numeri

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

Registri del terminale

Riceveremo i seguenti log nel terminale dopo aver eseguito correttamente lo strumento di spostamento del dispositivo per ripristinare l'operazione:

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

Invertire i numeri

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