Strumenti di migrazione per la transizione da BroadWorks, Webex per BroadWorks e BroadCloud a soluzioni RTM Wholesale

I telefoni supportati verranno creati automaticamente e assegnati agli utenti in Webex Calling dallo strumento di provisioning. I telefoni contrassegnati con "sì" nella colonna "Supportati nello strumento di spostamento dispositivo" verranno automaticamente spostati da Cisco BroadWorks o BroadCloud a Webex Calling quando viene eseguito lo strumento di spostamento dispositivo. I telefoni contrassegnati con "No" in tale colonna richiedono un intervento manuale per modificare l'URL DMS nel modello del dispositivo Cisco BroadWorks o nel telefono stesso.

L'ultima colonna fornisce la mappatura dei modelli di telefono alla colonna "Tipo di dispositivo" del file transform-tool/input/newphones.csv. (Vedi la sezione Trasforma strumento di questo articolo per ulteriori informazioni su 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à una tantum dopo che l'account partner viene caricato nella soluzione RTM per la vendita all'ingrosso. Questo strumento consente agli amministratori dei partner di accedere tramite browser Web per ottenere il TOKEN univoco necessario per eseguire l'aggiornamento ai file di configurazione dei partner per gli strumenti di migrazione.

Prerequisiti

Dopo il download, estrarre i binari degli strumenti di migrazione.

Impostare il percorso dell'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/Content/Home/"

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

Istruzioni da eseguire

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

Windows:

token_generatorBat

MacOS:

./token_generator.sh

Uscita:

Nome strumento: Versione strumento generatore 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 copiarlo per un ulteriore utilizzo.

Di seguito sono riportate le illustrazioni dell'interfaccia utente per riferimento:

Figura 3: Accedi con Cisco Webex

Figura 4: Finestra Credenziali

Figura 5: Generazione token

Configurare i passaggi seguenti, prima di eseguire gli strumenti di estrazione e spostamento del 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, effettuare le seguenti operazioni:

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

Eseguire il seguente comando in CLI per passare alla directory Impostazioni generali:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Eseguire il seguente comando in CLI per ottenere le impostazioni generali correnti:

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 imposta per riconfigurare le impostazioni.

Passo 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. Si 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 impostazioni non corrispondono a quelle precedenti, utilizzare il comando imposta per riconfigurare le impostazioni.

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

Modificare la 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> ottenere la descrizione dell'indirizzo ======================== 127.0.0.1 in locale come 

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

 AS_CLI/Maintenance/ManagedObjects> ottieni broadworks e controlla che l'output sia OK. Vedere di seguito i risultati del campione: AS_CLI/Maintenance/ManagedObjects> ottieni BroadWorks Managed Objects ========================== * Server: Identità..............: Versione AS...............: Rel_21.sp1_1.551 Stato amministrativo...: Sbloccato * Applicazioni: Name Version Deployment Administrative State Effective State ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true Sbloccato Sbloccato FlashPolicy 21.sp1_1.551 false Sbloccato Bloccato OpenClientServer 21.sp1_1.551 true Sbloccato Sbloccato WebContainer 21.sp1_1.551 true Sbloccato Sbloccato 4 voci trovate. * Applicazioni in hosting: Name Version Context Path Deployment ================================================================== 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 l'apertura del server client distribuito e attivo

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

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

AS_CLI/Maintenance/ManagedObjects> distribuire applicazione OpenClientServer

Passo 2: Avviare il server con questo comando:

AS_CLI/Maintenance/ManagedObjects> avvia applicazione OpenClientServer

Abilita attivazione numeri

Per abilitare l'attivazione dei numeri, eseguire i seguenti comandi in CLI:

Passo 1: Eseguire il comando di attivazione del numero:

AS_CLI> cd SubscriberMgmt/NumberActivation

Passo 2: Eseguire il comando di attivazione abilitato:

AS_CLI> imposta dnMode groupAndUserActivationEnabled

Passo 3: Al prompt di conferma, immettere Y.

Per BroadCloud

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

1. Inviare richieste di estratto per un massimo di 50 clienti per richiesta.
   Impossibile inviare la richiesta di estratto per lo stesso cliente più di 10 volte al giorno.
2. Scaricare il file dati estratto, in formato ZIP, per un massimo di 28 giorni dalla data di invio della richiesta.

Le cifre seguenti mostrano il portale del provider di servizi.

Figura 6: Portale del provider di servizi

Figura 7: Portale del 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 di aziende, gruppi, numeri, utenti, servizi, dispositivi e soft client dalla piattaforma Cisco BroadWorks o BroadCloud ed invia questi dati ai 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 lo strumento di estrazione binari a Cisco BroadWorks Application Server 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 per estrarre da Cisco BroadWorks in conf/exportTool.yml. Fare riferimento al seguente campione di snippet YAML:

   ServiceProviderID-A:      - GroupID-A1 - GROUPID-A2 - GroupID-A3 ServiceProviderID-B:                        - TUTTI 

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

   ID_UTENTE_BROADWORKS = amministratore BROADWORKS_PASSWORD = amministratore BROADWORKS_NOME_ORGANIZZATORE = localhost REFRESH_ = token di aggiornamento dell'amministratore del partner copiato dallo strumento Generatore di token. MODALITÀ MIGRAZIONE_ = Valori supportati sono webex_for_broadworks_to_wholesale. Il valore predefinito è broadworks_to_wholesale. Usa webex_for_broadworks_to_wholesale per migrazioni Webex per BroadWorks. 

   La proprietà REFRESH_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 da eseguire

Eseguire il comando seguente nel server applicazioni Cisco BroadWorks secondario dalla directory degli strumenti di estrazione:

./export.sh

Registri terminali

I seguenti registri sono disponibili nel terminale al momento dell'esportazione corretta: Esecuzione dello strumento di esportazione dati BroadSoft:

 Esecuzione dello strumento di esportazione dati ************************************************ BroadSoft Start Export Tool v: 1.15.0 Esportazione avviata per SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Esportazione utenti per SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Esportazione utenti completata per SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Esportazione completata per SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Esportazione completata Esporta dump zip Directory: output/20221017223452_ExportTool Export Dump Zip Nome del file:extracted_data_1666060500618.zip Il file zip con il nome extracted_data_1666060500618.zip è stato creato 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 degli strumenti di estrazione. Utilizzare il comando seguente per visualizzare e utilizzare il file ZIP per l'input Transform Tool:

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 ott 17 22:34 output/ drwxrwxr-x 2 bwadmin bwadmin 4096 ott 17 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 ott 17 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 un laptop amministratore del partner, e utilizza le API pubbliche Webex. Legge il file dell'output ZIP dello strumento di estrazione (extracted_data_.zip) come input e trasforma l'XML grezzo in un formato JSON utilizzato dallo strumento di provisioning.

Prerequisiti

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

1. Impostare il TOKEN_REFRESH (Token copiato dallo strumento generatore token) e il NOME__DELLA POSIZIONE PRINCIPALE_ nel file conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NOME_DELLA_POSIZIONE_PRINCIPALE=Principale 

2. Impostare opzionalmente l'ID_PROVISIONING (copiato dal modello in Partner Hub) nel file conf/partner.cfg:

   ID_PROVISIONING=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Per ottenere una verifica più completa dell'indirizzo e-mail del cliente, è possibile impostare l'ID_PROVISIONING.
3. Configurare le informazioni mancanti nel file input/customers.csv (vedere la sezione seguente) se mancanti.
4. Aggiungere l'indirizzo e-mail dell'utente finale nel file input/users.csv.
5. Se è necessario eseguire il provisioning dei 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 dei nuovi telefoni nella chiamata Wholesale.
6. Convertire i call center BroadWorks in CxEssentials utilizzando il file input/cxessentials.csv.
7. Opzionalmente, abilitare la proprietà UPGRADE_ALL_CALL_CENTER__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 posizioni dei propri clienti in base alla posizione
9. Se si desidera, abilitare l'uso degli indirizzi MAC dall'intestazione Agente utente del messaggio REGISTRO SIP quando l'indirizzo MAC non è disponibile nel profilo del dispositivo Cisco BroadWorks. Annulla il commento alla riga "USA_INDIRIZZO_MAC_DA_SIP_REGISTER=sì" nel file conf/partner.cfg

Riempimento dell'input/customers.csv

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

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

Istruzioni da eseguire

Eseguire lo strumento di trasformazione in qualsiasi sistema operativo. Utilizzare i passaggi seguenti 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 le seguenti operazioni per eseguire lo strumento di trasformazione su macOS:

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

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

2. Eseguire lo strumento di trasformazione:

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

Controllo preliminare cliente/utente

Lo strumento Transform effettua chiamate API a Webex per individuare potenziali problemi di provisioning. Per impostazione predefinita, convaliderà l'indirizzo e-mail principale del cliente. Se il valore ID_PROVISIONING è 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, è possibile aggiungere i seguenti parametri opzionali quando si utilizza lo strumento di trasformazione:

verifica preliminare

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

informazioni precheckinfo

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

Registri terminali

I seguenti registri nel terminale su trasformatore di successo:

Report di riepilogo aziende BroadWorks che possono essere migrate correttamente: 1 azienda BroadWorks che non può essere migrata: 0 utenti BroadWorks che possono essere migrati correttamente: 4 utenti BroadWorks non migrabili: 0 telefoni che possono essere migrati correttamente: 3 telefoni non compatibili con Webex Calling: 0 

Report eccezioni

Transform Tool genera il report di eccezione all'interno della directory output//exception_report.txt . È possibile utilizzare questo report per identificare i problemi che incidono sulla migrazione e correggerli nel sistema Cisco BroadWorks.

Dopo aver modificato i dati utente per risolvere l'eccezione, eseguire di nuovo l'estrazione e la trasformazione degli Strumenti con i nuovi dati. Il file del report di eccezione campione è il seguente:

Rapporto di eccezione Tue Oct 18 08:12:09 2022 Imprese con comunicazione Barring Raccomandazione caratteristica: Configura manualmente il piano di chiamata in uscita in Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Output

Nella directory di output// sarà disponibile un file output JSON (customer.json). Il file customer.json campione è 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", "address": { "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": "!!!!!!!!!!REPLACE_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": vero, "sendBusyCalls": {"enabled": vero, "saluto": "PREDEFINITO" }, "sendUnansweredCalls": {"enabled": vero, "saluto": "PREDEFINITO", "numeroDiSquilli": 3}, "messageStorage": {"mwiEnabled": vero, "storageType": "ESTERNO", "externalEmail": "engineering17861@mailnator.com" } } } ], "dispositivi": [ { "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": vero, "sendBusyCalls": {"enabled": vero, "saluto": "PREDEFINITO" }, "sendUnansweredCalls": {"enabled": vero, "saluto": "PREDEFINITO", "numeroDiSquilli": 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": vero, "sendBusyCalls": {"enabled": vero, "saluto": "PREDEFINITO" }, "sendUnansweredCalls": {"enabled": vero, "saluto": "PREDEFINITO", "numeroDiSquilli": 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": vero, "sendBusyCalls": {"enabled": vero, "saluto": "PREDEFINITO" }, "sendUnansweredCalls": {"enabled": vero, "saluto": "PREDEFINITO", "numeroDiSquilli": 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": [], "orari": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Portale vocale automatizzato", "firstName": "Automatizzato", "lastName": "Portale vocale", "languageCode": "en_us", "numero di telefono": "+15205551105", "interno": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "località": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTl2QtODExY2FlYTExYmVk" } } 

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

Prerequisiti

Configurare i seguenti prerequisiti all'interno della directory degli strumenti 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 ambiente JAVA_HOME in provisioning_tool.sh per MAC e provisioning_tool.bat per Windows.
3. Il file partner.cfg:
   • Impostare l'ID_PROVISIONING_WHOLESALE e il TOKEN_REFRESH (token copiato dallo strumento generatore token). Gli amministratori dei partner devono contattare il team dell'account per ottenere l'ID_PROVISIONING:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Imposta CONSENTI_INVITO_AMMINISTRATORE_E-MAIL a falso, se il partner non desidera inviare e-mail di benvenuto agli utenti. Il valore predefinito è vero.

4. Usa la proprietà OGGETTO _E-MAIL_WEBEX4BWKS per le migrazioni Webex per BroadWorks per inviare l'oggetto e-mail di richiesta di modifica della password per gli abbonati Webex per BroadWorks.
5. Usa la proprietà BODY di WEBEX4BWKS_EMAIL_ per le migrazioni di Webex per BroadWorks per inviare il corpo e-mail di richiesta di modifica della password per gli abbonati Webex per BroadWorks.

Per le migrazioni di BroadCloud nella stessa regione:

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

Per le migrazioni di BroadCloud in un'altra regione:

1. Lo strumento predispone numeri, dispositivi e identificativi di chiamata condivisa.
2. Lo strumento creerà utenti e utenti virtuali con numeri di telefono e interno effettivi.
   Tutte le migrazioni BroadCloud in Europa sono in un'altra regione.

Istruzioni da eseguire

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

Windows

Eseguire le seguenti operazioni 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

Effettuare le seguenti operazioni per eseguire lo strumento su macOS:

Per fornire un singolo cliente: ./transform.sh -input= Per fornire più clienti: ./transform.sh -input= 

Prerequisiti per la migrazione di Webex per BroadWorks

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

Esegui lo strumento di provisioning con un argomento aggiuntivo per Webex per BroadWorks per la migrazione Wholesale.

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

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

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

Registri terminali

Di seguito sono riportati i registri nel terminale durante il provisioning riuscito:

Nome strumento: Versione strumento di provisioning: 1.15.0 ********** File di elaborazione avviato: 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 del cliente external_id_engg_grp1: provisioning Numeri di provisioning Provisioning Utenti Provisioning Funzioni utente Provisioning Formule di saluto Pianificazioni di provisioning Provisioning Dispositivi di provisioning Provisioning Apparenze di chiamata condivise Provisioning Operatori automatici Provisioning Code di chiamata Provisioning Gruppi di ricerca Provisioning Cercapersone di gruppo Provisioning Parcheggio chiamata Provisioning Pickup di chiamata Provisioning Portale vocale ********** File completato: input/cliente.json **************** 

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

Output

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

Gli amministratori dei partner possono verificare il provisioning dei clienti nel portale Partner Hub e Control Hub. Fare riferimento alle seguenti illustrazioni dal 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, usa il portale provider di servizi per inviare una richiesta di migrazione per numeri, dispositivi e migrazioni SCA.

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

Le cifre seguenti mostrano il portale del provider di servizi.

Figura 12: Portale del provider di servizi

Figura 13: Portale del provider di servizi

Per Cisco BroadWorks e Webex per BroadWorks

Per le 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 AS tramite OCI-P. Utilizza il file di output JSON (customer.json) dello strumento Transform come input ed esegue i comandi OCI-P per migrare dispositivi e soft client.

Quando l'operazione è riuscita, lo strumento di spostamento del dispositivo:

1. Annullare la registrazione dei dispositivi da Cisco BroadWorks e registrarli 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 i numeri nella vendita all'ingrosso.
5. Crea gli indicatori di chiamata condivisa nel Wholesale per le migrazioni BroadCloud. [Questa fase è applicabile solo alle 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 REFRESH_TOKEN (token copiato dallo strumento generatore token) nel file conf/partner.cfg:

   AGGIORNAMENTO_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:

   ID_UTENTE_BROADWORKS = amministratore BROADWORKS_PASSWORD = amministratore BROADWORKS_NOME ORGANIZZATORE_ = localhost 

3. Verificare che il percorso ambientale JDK/JRE sia corretto in devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. Gli amministratori possono utilizzare il file locations.csv dalla directory di input per eseguire la migrazione dei gruppi specifici anziché di tutti i gruppi in un'azienda.

Telefoni Polycom

Per spostare i telefoni Polycom da Cisco BroadWorks alla chiamata all'ingrosso, l'amministratore di un partner deve creare un nuovo file di tipo di profilo identità/dispositivo a livello di sistema in Cisco BroadWorks ciascun 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 dispositivo, assicurati che il file appena creato esista a livello di Gruppo. Inoltre, assicurarsi che file migration_%BWMAC ADDRESS%.cfg non sia in conflitto con qualsiasi file esistente nel sistema).

Viene utilizzato internamente dallo strumento di spostamento del dispositivo.

Processo di migrazione per i telefoni Polycom:

1. Lo strumento di spostamento del dispositivo sostituisce file %BWMACADDRESS%.cfg a livello di dispositivo con polycom_vvx2.cfg. Si noti che questo file si riferisce a migration_%BWMACADDRESS%.cfg.
2. Ricostruisci i profili dei dispositivi a livello di gruppo o a livello di dispositivo.
   L'azione a livello di gruppo o a livello di dispositivo dipende dalla configurazione del parametro deviceLevelRebuild in 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 a livello di dispositivo.
4. Dopo la richiesta di riavvio, i telefoni Polycom scaricano ed elaborano% BWMACADDRESS%.cfg, che richiede 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 file tipo di profilo identità/dispositivo

Istruzioni da eseguire

Ci sono due metodi per invocare il DMT, il primo è quello di invocare attraverso un singolo cliente alla volta e l'altro è quello di eseguire attraverso più clienti contemporaneamente.

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

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

Registri terminali

Di seguito sono riportati i registri nel terminale quando viene eseguito correttamente lo strumento di spostamento del dispositivo per la migrazione del dispositivo:

Nome strumento: Versione strumento di spostamento dispositivo: 1.15.0 Strumento dispositivo avviato... Dispositivi validi per la migrazione: ------------------------------------------------------------------------------------------------------------------- | Tipo di dispositivo | Mac | Versione | E-mail | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Migrare tutti questi dispositivi? ([Y]es o [N]o) si Caricamento profili dispositivo per DMS Cisco MPP LC Processo di ricostruzione dispositivo Avviato Processo di ricostruzione dispositivo Completato con successo Riavvio processo avviato Riavvio processo completato con successo Modifica profili per Business Communicator in gruppo collabmigrationtestGRP_engg Attiva il processo di numeri di telefono webex avviato per ID organizzazione cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Attivazione della procedura dei numeri di telefono Webex completata per ID organizzazione cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Procedura di disattivazione dei numeri di telefono broadworks avviata per groupId: collabmigrationtestGRP_engg Disattiva il processo dei numeri di telefono broadworks completato per groupId: migrazione collabationtestGRP_engg migrazione dispositivo completata 

Output

Dopo la migrazione del dispositivo, i dispositivi sono disponibili online e sono pronti per 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 vedere un esempio di numeri attivi:

Figura 16: Numeri attivi

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

Per gestore telefonico BroadCloud

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

1. Apri 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 a Webex Calling verrà annullata, lasciando solo utenti e servizi con interni.
   • Gli indirizzi e-mail in Webex Calling verranno ripristinati agli indirizzi e-mail temporanei.
   • I telefoni verranno eliminati da Webex Calling.
   • Numeri di telefono, indirizzi e-mail utilizzati come alternateIds e telefoni verranno ricreato in BroadCloud.
   • I telefoni verranno riavviati.
3. Gli amministratori dei partner devono spostare nuovamente i numeri di telefono PSTN su BroadCloud Carrier.

Per Cisco BroadWorks e Webex per BroadWorks

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

1. Apri un ticket con il centro TAC di Cisco per richiedere il ripristino di un dispositivo.
2. Eseguire lo strumento di spostamento dispositivo in modalità ripristino sul server applicazioni BroadWorks secondario per ripristinare le migrazioni dei dispositivi. In questo modo, l'URL DMS tornerà all'URL DMS del provider di servizi per i profili dei dispositivi in Cisco BroadWorks e riattiverà i numeri di telefono.
3. Il team Webex Calling imposta nuovamente 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 attraverso 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à revert

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 degli strumenti di spostamento del dispositivo:

Ripristina profili

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

Ripristina numeri

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

Registri terminali

Verranno visualizzati i seguenti registri nel terminale quando viene eseguito correttamente lo strumento di spostamento del dispositivo per l'operazione di ripristino:

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 nuovamente da Webex Calling a BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Tipo di dispositivo | Mac | Versione | E-mail | ------------------------------------------------------------------------------------------------------------------- | 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 ripristinare questi dispositivi da Webex Calling a BroadWorks? (Sì, Y, No, N):  sì Caricamento profili dispositivo per DMS Cisco MPP LC Processo di ricostruzione dispositivo avviato Processo di ricostruzione dispositivo completato con successo Riavvio processo avviato Riavvio processo completato con successo Migrazione dispositivo completata per processo di deprovisioning 

Ripristina numeri

Nome strumento: Versione strumento di spostamento dispositivo: 1.15.0 Vuoi continuare a ripristinare i numeri su BroadWorks?  ([S]i o [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Ripristino iniziale Processo di attivazione numeri di telefono broadworks avviato per groupId: collabmigrationtestGRP_engg Attiva i numeri di telefono Broadworks processo completato per groupId: collabmigrationtestGRP_engg Processo di ripristino migrazione dispositivo completato correttamente