I telefoni supportati verranno creati automaticamente e assegnati agli utenti in Webex Calling dallo strumento di provisioning. I telefoni contrassegnati come "sì" nella colonna "Supportati nello strumento di spostamento dispositivo" verranno spostati automaticamente da Cisco BroadWorks o BroadCloud a Webex Calling quando viene eseguito lo strumento di spostamento dispositivo. I telefoni contrassegnati come "No" in tale colonna necessitano di 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 dispositivo" del file transform-tool/input/newphones.csv. (Vedere la sezione Strumento di trasformazione di questo articolo per ulteriori informazioni sul file newphones.csv).

Gli amministratori dei partner eseguono questo strumento di utilità del generatore di token almeno una volta prima di avviare l'esecuzione degli strumenti di migrazione. L'esecuzione di questo strumento è un'attività occasionale dopo l'onboarding dell'account del partner nella soluzione Wholesale RTM. Questo strumento consente agli amministratori dei partner di accedere tramite il browser Web per ottenere il TOKEN univoco necessario per l'aggiornamento ai file di configurazione del partner per gli strumenti di migrazione.

Prerequisiti

Dopo il download, estrarre i binari dello strumento di migrazione.

Impostare il percorso di ambiente JRE/JDK in token_generator.sh per MAC e token_generator.bat per Windows. Se il percorso JAVA_HOME esiste già, verrà riutilizzato dallo strumento.

• mac: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Istruzioni per l'esecuzione

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

Windows:

token_generatorBat

Mac OS:

./token_generator.sh

Output:

Nome strumento: Versione strumento generatore di token: 1.13.0 Caricare l'URL nel browser Web: http://localhost:8080 

Aprire l'URL nel browser Web sul terminale, accedere con le credenziali dell'amministratore del partner per ottenere il TOKEN e copiare lo stesso per un ulteriore utilizzo.

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

Figura 3: Accedi con Cisco Webex

Figura 4: Finestra Credenziali

Figura 5: Generazione token

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

Abilita connettività OCI-P

Lo strumento di spostamento del dispositivo comunica con BroadWorks tramite i comandi OCI-P, per abilitare la connettività OCI-P utilizzare la procedura seguente:

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

Eseguire il seguente comando in CLI per passare alla directory GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Per ottenere le impostazioni generali correnti, eseguire il seguente comando in CLI:

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

Se le impostazioni non corrispondono a quelle precedenti, utilizzare il comando set per riconfigurare le impostazioni.

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

Modificare la directory in Proxy OCI:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Eseguire la seguente CLI per ottenere le impostazioni correnti. Viene visualizzato quanto segue:

AS_CLI/Applications/OpenClientServer/OCIProxy> get abilitato = true abilitatoLoginLevelScreening = false enableResponseMemorizzazione nella cache = false responseCacheDurationHours = 24 rispostaCacheRenewPeriodMins = 30 messaggiCodaCapacità = 50 messaggiCodaTimeoutSecondi = 1800 

Se le impostazioni non corrispondono a quelle precedenti, utilizzare il comando set per riconfigurare le impostazioni.

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

Passare alla rubrica 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> ottieni descrizione indirizzo ======================== 127.0.0.1 locale come 

Passaggio 4: Eseguire il comando seguente in CLI per verificare che la configurazione sia corretta.

 AS_CLI/Maintenance/ManagedObjects> ottieni BroadWorks e verifica che l'output sia OK. Vedere di seguito per l'output del campione: AS_CLI/Maintenance/ManagedObjects> ottieni BroadWorks Managed Objects ========================== * Server: Identità..............: Versione AS...............: Rel_21.sp1_1.551 Stato amministrativo...: * Applicazioni sbloccate: Nome Versione Distribuito Stato amministrativo Stato effettivo ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true FlashPolicy 21.sp1_1.551 false Sbloccato OpenClientServer 21.sp1_1.551 true WebContainer sbloccato 21.sp1_1.551 true Sbloccato Sbloccato 4 voci trovate. * Applicazioni ospitate: Nome Versione Percorso contesto distribuito ================================================================== 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 voci trovate. 

Verifica l'apertura del server client distribuito e attivo

Utilizzare i comandi seguenti per distribuire e avviare il server client aperto sul server applicazioni secondario, se non è stato distribuito o non è già stato avviato.

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

AS_CLI/Maintenance/ManagedObjects> distribuire l'applicazione OpenClientServer

Passaggio 2: Avviare il server con questo comando:

AS_CLI/Maintenance/ManagedObjects> avvia applicazione OpenClientServer

Abilita attivazione numeri

Esegui i seguenti comandi in CLI per abilitare l'attivazione dei numeri:

Passaggio 1: Eseguire il comando di attività numero:

AS_CLI> cd SubscriberMgmt/NumberActivation

Passaggio 2: Eseguire il comando di attivazione abilitato:

AS_CLI> imposta dnMode groupAndUserActivationEnabled

Passaggio 3: Alla richiesta di conferma, immettere Y.

Per BroadCloud

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

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

Le figure seguenti mostrano il portale del provider di servizi.

Figura 6: Portale provider di servizi

Figura 7: Portale provider di servizi

Per Cisco BroadWorks e Webex per BroadWorks

1. Lo strumento di estrazione viene eseguito sul server applicazioni Cisco BroadWorks secondario all'interno della rete partner e si connette tramite OCI-P.
2. Lo strumento estrae i dati aziendali, di gruppo, numeri, utenti, servizi, dispositivi e soft client dalla piattaforma Cisco BroadWorks o BroadCloud e genera questi dati 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 binari dello strumento di estrazione sul server applicazioni Cisco BroadWorks secondario.
2. SSH sul server applicazioni Cisco BroadWorks secondario 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 in conf/exportTool.yml. Fare riferimento al seguente frammento di esempio YAML:

   ID provider servizio:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - tutto 

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

   BROADWORKS_UTENTE_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_ORGANIZZATORE_NOME = TOKEN DI AGGIORNAMENTO locale_DELL'AMMINISTRATORE del partner copiato dallo strumento Generatore di token. MODALITÀ MIGRAZIONE_ = I valori supportati sono webex_for_broadworks_to_wholesale. Il valore predefinito è broadworks_to_wholesale. Utilizzare webex_for_broadworks_to_wholesale per migrazioni di Webex per BroadWorks. 

   La proprietà AGGIORNA_TOKEN è obbligatoria per una migrazione Webex per BroadWorks.

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

   JAVA_HOME=/usr/local/java/java_base

Istruzioni per l'esecuzione

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

./export.sh

Registri terminali

I seguenti registri sono disponibili nel terminale una volta completata l'esportazione: Esecuzione dello strumento di esportazione di dati BroadSoft:

 Esecuzione dello strumento di esportazione dati BroadSoft ************************************************ Avvio dello strumento di esportazione v: 1.15.0 Esportazione avviata per SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Esportazione di utenti per SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Esportazione completata per SP=collabmigrationtestGRP_engg, Group=collabmigrationtestGRP_engg Esportazione completata per SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Esportazione completata Directory zip dump esportazione: output/20221017223452_ExportTool Export Dump Nome file zip:extracted_data_1666060500618.zip Il file Zip con il nome extracted_data_1666060500618.zip è stato creato il processo di creazione del file ZIP completato. I file esportati convertiti come file ZIP ************************************************** 

Output

Un file ZIP di output (extracted_data_.zip) sarà disponibile nella stessa directory dello strumento di estrazione. Utilizzare il comando seguente per visualizzare e utilizzare il file ZIP per l'input dello strumento di trasformazione:

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

Questo strumento di trasformazione è eseguito per tutte le migrazioni. Lo strumento di trasformazione viene eseguito su qualsiasi computer, incluso il laptop dell'amministratore del partner, e utilizza le API pubbliche Webex. Legge il file di output ZIP (extracted_data_.zip) come input e trasforma l'XML non elaborato in un formato JSON utilizzato dallo strumento di provisioning.

Prerequisiti

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

1. Imposta AGGIORNAMENTO_TOKEN (token copiato dallo strumento generatore di token) e NOME_di_principale_Posizione nel file conf/partner.cfg:

   AGGIORNA_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NOME_DI_PRINCIPALE_POSIZIONE=Principale 

2. Opzionalmente, imposta l'ID di PROVISIONING_ (copiato dal modello in Partner Hub) nel file conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Per una verifica più completa dell'indirizzo e-mail del cliente, è possibile impostare facoltativamente l'ID di PROVISIONING_.
3. Configura le informazioni mancanti nel file input/customers.csv (vedere la sezione successiva) se mancanti.
4. Aggiungi l'indirizzo e-mail dell'utente finale nel file input/users.csv.
5. Se occorre eseguire il provisioning di nuovi telefoni, aggiungere l'indirizzo mac e l'indirizzo e-mail del nuovo telefono dell'utente al file input/newphones.csv. Questa opzione è richiesta solo se gli amministratori dei partner desiderano eseguire il provisioning di nuovi telefoni nella chiamata Wholesale.
6. Converti i call center BroadWorks in CxEssentials utilizzando il file input/cxessentials.csv.
7. Opzionalmente, abilita l'AGGIORNAMENTO_TUTTI I_CALL_CENTER_A_CX_ESSENTIALS per convertire tutti i centri di chiamata in CxEssentials.
8. Usa il file input/locations.csv per supportare la migrazione di grandi dimensioni che consente agli amministratori di migrare le posizioni dei clienti in base alla posizione
9. Opzionalmente, abilita 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. Decommentare la riga "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" nel file conf/partner.cfg

Compilazione di input/clienti.csv

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

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

Istruzioni per l'esecuzione

Eseguire lo strumento di trasformazione in qualsiasi sistema operativo. Utilizzare la procedura seguente per eseguire lo strumento in Windows e macOS:

Windows

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

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

macOS

Eseguire i passaggi seguenti per eseguire lo strumento transform su macOS:

1. Creare un ambiente virtuale e installare le dipendenze per eseguire lo strumento transform utilizzando Python:

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

2. Eseguire lo strumento di trasformazione:

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

Controllo preliminare cliente/utente

Lo strumento di trasformazione effettua chiamate API a Webex per rilevare potenziali problemi di provisioning. Per impostazione predefinita, convaliderà l'indirizzo e l'indirizzo e-mail principale del cliente. Se il valore ID_PROVISIONING viene specificato nel file conf/partner.cfg, verranno convalidate anche le informazioni sulla posizione. I risultati della verifica preliminare sono inclusi nel report di eccezione.

Inoltre, i seguenti parametri opzionali possono essere aggiunti durante l'esecuzione dello strumento di trasformazione:

verifica preliminare

Oltre a eseguire l'API di pre-verifica per le informazioni del cliente, lo strumento di trasformazione eseguirà anche l'API di pre-verifica per le e-mail dell'abbonato.

informazioni preliminari

Per impostazione predefinita, solo gli errori di verifica preliminare (ad esempio, problemi che bloccheranno il provisioning) sono inclusi nel report di eccezione. L'aggiunta di questo flag includerà anche i risultati del controllo preliminare eseguito correttamente (ad esempio, se esiste già un'organizzazione Webex che può essere collegata automaticamente).

Registri terminali

I seguenti registri nel terminale in caso di trasformazione riuscita:

Aziende BroadWorks report di riepilogo che possono essere migrate correttamente: 1 Aziende BroadWorks che non possono essere migrate: 0 utenti BroadWorks che possono essere migrati correttamente: 4 utenti BroadWorks che non possono essere migrati: 0 telefoni che possono essere migrati correttamente: 3 telefoni non compatibili con Webex Calling: 0 

Report eccezione

Lo strumento di trasformazione genera il report di eccezione nella directory output//exception_report.txt . È possibile utilizzare questo report per identificare i problemi che incidono sulla migrazione e risolverli nel sistema Cisco BroadWorks.

Dopo aver modificato i dati utente per risolvere l'eccezione, eseguire di nuovo gli strumenti di estrazione e trasformazione con i nuovi dati. Il file di report di eccezione di esempio come segue:

Report eccezione mar 18 ott 08:12:09 2022 Aziende con blocco delle comunicazioni Raccomandazione: configura manualmente il piano di chiamata in uscita in Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Output

Un file JSON di output (customer.json) sarà disponibile nella directory output// . Il file customer.json di esempio è il seguente:

{ "customer": { "provisioningId": "!!!!!!!!!!SOSTITUISCI_con_PROVISIONINGID!!!!!!!!!!", "pacchetti": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "indirizzo": { "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", "indirizzo": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/New_York", "lingua": "en_us", "numeri": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "abbonati": [ { "amareswaranvel+benjaminjack@gmail.com": { "abbonato": { "customerId": "!!!!!!!!!!SOSTITUIRE_con_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "pacchetto": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "enabled": true, "messaggio di saluto": "PREDEFINITO" }, "sendUnansweredCalls": { "enabled": true, "messaggio di saluto": "PREDEFINITO", "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, "messaggio di saluto": "PREDEFINITO" }, "sendUnansweredCalls": { "enabled": true, "messaggio di saluto": "PREDEFINITO", "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, "messaggio di saluto": "PREDEFINITO" }, "sendUnansweredCalls": { "enabled": true, "messaggio di saluto": "PREDEFINITO", "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, "messaggio di saluto": "PREDEFINITO" }, "sendUnansweredCalls": { "enabled": true, "messaggio di saluto": "PREDEFINITO", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_con_PERSONID!!!!!!!!!!", "prodotto": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "pianificazioni": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Portale vocale automatizzato", "firstName": "Automatizzato", "lastName": "Portale vocale", "languageCode": "en_us", "phoneNumber": "+15205551105", "interno": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Profilo dispositivo Engg" ], "connect_client_to_upgrade_to_webex_app": [], "posizioni": [], "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 solitamente dal laptop dell'amministratore del partner e utilizza le API pubbliche Webex. Legge il file di output dello strumento di trasformazione JSON (customer.json) come input e provisioning di clienti, posizioni, numeri, utenti, servizi e dispositivi nella soluzione Webex Wholesale RTM.

Prerequisiti

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

1. Installare Java 8, 11 o 17 sul computer. Java è disponibile da molte fonti, tra cui:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Dopo aver scaricato ed estratto i binari degli strumenti di migrazione, impostare la variabile di ambiente JAVA_HOME in provisioning_tool.sh per MAC e provisioning_tool.bat per Windows.
3. File partner.cfg:
   • Impostare l'ID_PROVISIONING_WHOLESALE e il TOKEN_ (token copiato dallo strumento generatore di token). Gli amministratori dei partner devono contattare il team dell'account per ottenere l'ID provisioning_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Impostare CONSENTI _AMMIN_INVITE_E-MAIL su falso, se il partner non desidera inviare un messaggio e-mail di benvenuto agli utenti. Il valore predefinito è true.

4. Usa la proprietà OGGETTO WEBEX4BWKS_E-MAIL_per le migrazioni di Webex per BroadWorks per inviare l'oggetto e-mail di richiesta della password di modifica per gli abbonati Webex per BroadWorks.
5. Usa la proprietà del CORPO WEBEX4BWKS_E-MAIL_per le migrazioni di Webex per BroadWorks per inviare il corpo e-mail di richiesta della password di modifica per gli abbonati Webex per BroadWorks.

Per le migrazioni BroadCloud stessa regione:

1. Lo strumento ignora il provisioning di numeri, dispositivi e indicatori di chiamata condivisa.
2. Lo strumento crea utenti e utenti virtuali con interno e interno temporaneo.

Per le migrazioni BroadCloud un'altra regione:

1. Lo strumento predisporrà numeri, dispositivi e indicatori di chiamata condivisa.
2. Lo strumento crea utenti e utenti virtuali con numeri di telefono e interni effettivi.
   Tutte le migrazioni di Europe BroadCloud sono in un'altra regione.

Istruzioni per l'esecuzione

Utilizzare la seguente procedura per eseguire lo strumento in Windows e macOS:

Windows

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

Per eseguire il provisioning del singolo cliente: provision.bat -input= Per eseguire il provisioning di più clienti: provision.bat -input= 

macOS

Eseguire i passaggi seguenti per eseguire lo strumento su macOS:

Per eseguire il provisioning di un singolo cliente: ./transform.sh -input= Per eseguire il provisioning di più clienti: ./transform.sh -input= 

Prerequisiti per la migrazione di Webex per BroadWorks

Gli amministratori dei partner devono aggiornare il relativo modello di onboarding BroadWorks per le funzioni di coesistenza di Webex per BroadWorks. Fare riferimento all'immagine seguente:

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

Eseguire lo strumento di provisioning con un ulteriore argomento.

Fase di preparazione: è la fase predefinita in cui gli amministratori possono eseguire il provisioning degli utenti BroadWorks come abbonato Wholesale e continuare con gli utenti Webex per BroadWorks.

Fase di manutenzione: è la seconda fase in cui gli amministratori possono assegnare la licenza Wholesale agli utenti Webex per BroadWorks esistenti. Devi eseguire lo strumento di provisioning con un argomento manutenzione.

Fase post-migrazione: È la fase finale in cui gli amministratori possono convertire completamente BroadWorks in Wholesale. Devi eseguire lo strumento di provisioning con un argomento post-migrazione.

Registri terminali

Di seguito sono riportati i registri nel terminale una volta eseguito correttamente il provisioning:

Nome strumento: Versione strumento di provisioning: 1.15.0 ********** Avvio dell'elaborazione del file: input/customer.json Provisioning **************** Cliente In attesa che il cliente external_id_engg_grp1 completi il provisioning... In attesa che il cliente external_id_engg_grp1 completi il provisioning...   Stato cliente external_id_engg_grp1: provisioning Numeri di provisioning Utenti provisioning Funzioni utente Provisioning Messaggi di saluto Provisioning Pianificazioni Provisioning Dispositivi Provisioning Visualizzazioni di chiamata condivise Provisioning Operatori automatici Provisioning Code chiamate Provisioning Gruppi di ricerca Provisioning Paging di gruppo Provisioning Parcheggi di chiamata Provisioning Risposte per assente Provisioning Portale vocale ********** File completato: input/cliente.json **************** 

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

Output

Lo strumento di provisioning genera report di successo e errore all'interno dei file output/<external_id>/*.success/error . Esamina l'output riuscito e i registri degli errori per verificare il corretto provisioning.

Gli amministratori dei partner possono verificare il provisioning del cliente nel portale Partner Hub e Control Hub. Fare riferimento alle seguenti illustrazioni del portale Partner Hub e Control Hub:

Figura 8: Hub partner

Figura 9: Hub di controllo

Figura 10: Dispositivi

Figura 11: Chiamata in corso

Per BroadCloud

Per i partner BroadCloud, utilizzare il portale del provider di servizi per inviare una richiesta di migrazione di numeri, dispositivi e migrazioni SCA.

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

Le figure seguenti mostrano il portale del provider di servizi.

Figura 12: Portale provider di servizi

Figura 13: Portale provider di servizi

Per Cisco BroadWorks e Webex per BroadWorks

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

Una volta completata l'operazione, lo strumento di spostamento del dispositivo:

1. Annulla la registrazione dei dispositivi da Cisco BroadWorks e registrali in Wholesale.
2. Gli utenti che utilizzano il client UC-One reindirizzeranno all'app Webex al primo accesso.
3. Disattivare i numeri di telefono da Cisco BroadWorks o rimuovere i numeri di telefono da BroadCloud.
4. Attiva numeri in Wholesale.
5. Crea indicatori di chiamata condivisa in Wholesale per le migrazioni BroadCloud. [Questo passaggio è applicabile solo per le migrazioni BroadCloud].

SCP e SSH

1. SCP lo strumento di spostamento del dispositivo sul server applicazioni Cisco BroadWorks secondario.
2. SSH sul server applicazioni Cisco BroadWorks secondario per configurare i prerequisiti ed eseguire lo strumento di spostamento del dispositivo.

Prerequisiti

1. Impostare il TOKEN DI AGGIORNAMENTO_ (token copiato dallo strumento generatore di token) nel file conf/partner.cfg:

   AGGIORNA_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_UTENTE_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_ORGANIZZATORE_NOME = localhost 

3. Per inviare nuovamente i messaggi e-mail di attivazione, è necessario impostare RESEND_INVITATION_EMAILS=true nel file conf/partner.cfg.

   Se gli amministratori desiderano inviare e-mail di invito ai propri utenti durante la migrazione, devono decommentare la proprietà "RESEND_INVITATION_EMAILS=true" nel file conf/partner.cfg. In caso contrario, 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 rubrica di input per eseguire la migrazione di gruppi specifici anziché di tutti i gruppi in un'azienda.

Telefoni Polycom

Per spostare i telefoni Polycom da Cisco BroadWorks a Wholesale Calling, un amministratore del partner deve creare un nuovo file del tipo di profilo di identità/dispositivo 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 file del nuovo dispositivo, assicurati che il file appena creato esista a livello di gruppo. Assicurarsi inoltre che il file migration_%BWMAC ADDRESS%.cfg non sia in conflitto con alcun file esistente nel 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 del dispositivo a livello di gruppo o a livello 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 richiede al server applicazioni Cisco BroadWorks di riavviare i telefoni a livello di gruppo o di dispositivo.
4. Dopo la richiesta di riavvio, i telefoni Polycom scaricano e elaborano% BWMACADDRESS%.cfg, che richiede ai telefoni Polycom di scaricare e elaborare migration_%BWMACADDRESS%.cfg, che imposta device.prov.serverName su https://plcm.sipflash.com.
   https://plcm.sipflash.com per la regione USA, 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 è richiamare attraverso un singolo cliente alla volta e l'altro è passare attraverso più clienti contemporaneamente.

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

Per lo spostamento dispositivo singolo cliente: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Per lo spostamento dispositivo più clienti: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Inoltre, lo strumento di spostamento dispositivo supporta la migrazione di uno o più telefoni specifici dalla release 1.35.0. Utilizzare il comando seguente: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Registri terminali

Di seguito sono riportati i registri nel terminale sull'esecuzione corretta dello strumento di spostamento dispositivo per la migrazione dispositivo:

Nome strumento: Versione strumento di spostamento dispositivo: 1.15.0 Strumento dispositivo avviato... Dispositivi validi per la migrazione: ------------------------------------------------------------------------------------------------------------------- | Tipo di dispositivo | Mac | Versione | 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 | ------------------------------------------------------------------------------------------------------------------- Vuoi eseguire la migrazione di tutti questi dispositivi? ([Y]es o [N]o) sì Caricamento di profili dispositivo per DMS Processo di ricostruzione dispositivo avviato Processo di ricostruzione dispositivo completato correttamente Processo di riavvio avviato Processo di riavvio completato correttamente Modifica dei profili per Business Communicator in gruppo collabmigrationtestGRP_engg Processo di attivazione dei numeri di telefono Webex avviato per ID organizzazione cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Processo di attivazione dei numeri di telefono Webex completato per ID organizzazione cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c processo di disattivazione dei numeri di telefono BroadWorks avviato per groupId: collabmigrationtestGRP_engg Processo di disattivazione dei numeri di telefono BroadWorks completato per groupId: collabmigrationtestGRP_engg Migrazione dispositivo completata 

Output

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

Figura 15: Stato dispositivo

Dopo la migrazione del dispositivo, i numeri sono diventati attivi. Fare riferimento alla figura 16 per visualizzare un esempio di quali numeri sono attivi:

Figura 16: Numeri attivi

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

Per gestore telefonico BroadCloud

Il processo di ripristino per i partner BroadCloud è il seguente:

1. Aprire un ticket con il centro TAC di Cisco per richiedere il ripristino di un dispositivo.
2. Eseguire lo strumento di spostamento del dispositivo in modalità ripristino:
   • L'assegnazione dei numeri di telefono verrà annullata da Webex Calling lasciando agli utenti e ai servizi solo interni.
   • Gli indirizzi e-mail in Webex Calling verranno ripristinati sugli indirizzi e-mail temporanei.
   • I telefoni verranno eliminati da Webex Calling.
   • Numeri di telefono, indirizzi e-mail utilizzati come ID alternati e telefoni verranno ricreati in BroadCloud.
   • I telefoni verranno riavviati.
3. Gli amministratori dei partner devono spostare nuovamente i numeri di telefono PSTN sul gestore telefonico BroadCloud.

Per Cisco BroadWorks e Webex per BroadWorks

Il processo di ripristino per Cisco BroadWorks e Webex per BroadWorks è il seguente:

1. Aprire un ticket con il centro TAC di Cisco per richiedere il ripristino di un dispositivo.
2. Esegui lo strumento di spostamento del dispositivo in modalità di ripristino sul server applicazioni BroadWorks secondario per ripristinare le migrazioni dei dispositivi. In questo modo, l'URL DMS verrà reimpostato sull'URL DMS del provider di servizi per i profili dei dispositivi in Cisco BroadWorks e verranno riattivati i numeri di telefono.
3. Il team Webex Calling imposta di nuovo l'URL DMS sull'URL DMS del provider di servizi nei profili dei dispositivi 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 spostare nuovamente i numeri di telefono PSTN in Cisco BroadWorks.

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

Effettuare le seguenti operazioni per eseguire lo strumento di spostamento del dispositivo in modalità ripristino:

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

Ripristina profili

./devicemove.sh -input=  -revertProfiles

Ripristina numeri

./devicemove.sh -input=  -revertNumbers

Registri terminali

Una volta eseguito correttamente lo strumento di spostamento del dispositivo per l'operazione di ripristino, verranno visualizzati i seguenti registri nel terminale:

Ripristina profili

Nome strumento: Versione strumento di spostamento dispositivo: 1.15.0 Strumento dispositivo avviato per il processo di ripristino... Dispositivi che possono essere spostati di nuovo da Webex Calling a BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Tipo di dispositivo | Mac | Versione | 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 | ------------------------------------------------------------------------------------------------------------------- Vuoi riportare questi dispositivi da Webex Calling a BroadWorks? (Sì, Y, No, N):  Sì Caricamento dei profili dispositivo per DMS Processo di ricostruzione dispositivo avviato Processo di ricostruzione dispositivo completato correttamente Processo di riavvio avviato Processo di riavvio completato Migrazione dispositivo completata correttamente per il processo di deprovisioning 

Ripristina numeri

Nome strumento: Versione strumento di spostamento dispositivo: 1.15.0 Vuoi continuare a ripristinare i numeri in BroadWorks?  ([S]e o [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +152055511107, +15205551108, +15205551109, +15205551110] Ripristino dell'avvio Processo di attivazione numeri di telefono BroadWorks avviato per groupId: collabmigrationtestGRP_engg Processo di attivazione dei numeri di telefono BroadWorks completato per groupId: collabmigrationtestGRP_engg Processo di ripristino migrazione dispositivo completato correttamente