I telefoni supportati verranno creati automaticamente e assegnati agli utenti in Webex Calling dallo strumento di provisioning. Anche 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 quella 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 di dispositivo" del file transform-tool/input/newphones.csv. (Per maggiori informazioni su newphones.csv, vedere la sezione Strumento di trasformazione di questo articolo).

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 da eseguire dopo che l'account partner è stato integrato nella soluzione Wholesale RTM. Questo strumento consente agli amministratori partner di accedere tramite browser Web per ottenere il TOKEN univoco necessario per aggiornare i file di configurazione del partner per gli strumenti di migrazione.

Prerequisiti

Installare Java 8, 11, 17 o 21 sul computer. Java è disponibile da numerose 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, estrarre i file binari dello strumento di migrazione.

Istruzioni per l'esecuzione

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

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Produzione:

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

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

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

Figura 3: Accedi con Cisco Webex

Figura 4: Finestra delle credenziali

Figura 5: Generazione di token

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

Abilita la connettività OCI-P

Lo strumento di spostamento del dispositivo comunica con BroadWorks tramite comandi OCI-P. Per abilitare la connettività OCI-P, attenersi alla seguente procedura:

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Eseguire 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 impostazioni non corrispondono a quelle sopra, utilizzare il comando set per riconfigurare le impostazioni.

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

Cambiare la directory in OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Eseguire la seguente CLI per ottenere le impostazioni correnti. Dovresti 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 sopra, utilizzare il comando set per riconfigurare le impostazioni.

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

Passare alla directory Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

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

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

Verificare che il server client aperto sia distribuito e attivo

Utilizzare i comandi sottostanti per distribuire e avviare Open Client Server sul server applicativo secondario, se non è ancora distribuito o non è stato avviato.

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Passaggio 2: Avviare il server con questo comando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Abilita l'attivazione dei numeri

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

Passaggio 1: Esegui il comando di attivazione del numero:

AS_CLI> cd SubscriberMgmt/NumberActivation

Passaggio 2: Eseguire il comando di attivazione abilitata:

AS_CLI> set dnMode groupAndUserActivationEnabled

Passaggio 3: Alla richiesta di conferma, immettere Y.

Per BroadCloud

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

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

Le figure seguenti mostrano il portale del fornitore di servizi.

Figura 6: Portale del fornitore di servizi

Figura 7: Portale del fornitore di servizi

Richiesta di estrazione CSV

Avvia richiesta di estrazione CSV

1. Scarica il CSV del cliente

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

2. Modifica l'elenco dei 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, carica il CSV modificato.

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

Avvia richiesta di estrazione per un cliente con posizioni CSV

1. Seleziona clienti e posizioni di download

   Seleziona un cliente dal menu a discesa.

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

2. Modifica il file delle posizioni

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

3. Carica e invia

   Carica il file locations.csv modificato e clicca su Invia.

   Nella richiesta di estrazione verranno incluse solo le posizioni specificate per il cliente selezionato.

Avvia richiesta di estrazione per tutti i clienti

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

Per Cisco BroadWorks e Webex per BroadWorks

1. Lo strumento di estrazione viene eseguito sul Cisco BroadWorks Application Server secondario all'interno della rete partner e si connette tramite OCI-P.
2. Lo strumento estrae dati aziendali, di gruppo, numeri, utenti, servizi, dispositivi e soft client dalla piattaforma Cisco BroadWorks o BroadCloud e li esporta in file XML che forniscono gli input per lo strumento di trasformazione.

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

Prerequisiti

1. Eseguire l'estrazione dei file binari dello strumento SCP sul server applicativo Cisco BroadWorks secondario.
2. Per configurare i prerequisiti ed eseguire lo strumento di estrazione, accedere tramite SSH al Cisco BroadWorks Application Server secondario.
3. Configurare il fornitore di servizi e l'ID del gruppo da estrarre da Cisco BroadWorks in conf/exportTool.yml. Fare riferimento al seguente frammento di codice 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 del server applicativo Cisco BroadWorks secondario siano corretti in conf/partner.cfg file:

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

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

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

   JAVA_HOME=/usr/local/java/java_base

Istruzioni per l'esecuzione

Eseguire il seguente comando nel Cisco BroadWorks Application Server secondario dalla directory dello strumento di estrazione:

./export.sh

Registri del terminale

In caso di esportazione riuscita, nel terminale sono disponibili i seguenti log: Esecuzione dello strumento di esportazione dati BroadSoft:

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

Output

Un file di output ZIP (extracted_data_<timestamp>.zip) è disponibile nella stessa directory dello strumento di estrazione. Utilizzare 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

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

Prerequisiti

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

1. Imposta il TOKEN REFRESH_(token copiato dallo strumento generatore di token) e NAME_OF_MAIN_LOCATION in conf/partner.cfg file:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Per ottenere una verifica più completa dell'indirizzo email del cliente, puoi impostare facoltativamente l'ID PROVISIONING_.
3. Configurare le informazioni mancanti nel input/customers.csv file (vedere la sezione successiva) se mancante.
4. Aggiungere l'indirizzo email dell'utente finale nel input/users.csv file.
5. Se devono essere forniti nuovi telefoni, aggiungere l'indirizzo MAC e l'indirizzo email del nuovo telefono dell'utente a input/newphones.csv file. Questa operazione è necessaria solo se gli amministratori partner desiderano predisporre nuovi telefoni per le chiamate all'ingrosso.
6. Converti i Call Center BroadWorks in CxEssentials utilizzando input/cxessentials.csv file.
7. Facoltativamente, abilitare la proprietà UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS per convertire tutti i Call Center in CxEssentials.
8. Utilizzare il input/locations.csv file per supportare la migrazione di grandi aziende che consente agli amministratori di migrare le sedi dei propri clienti in base alla posizione
9. Facoltativamente, abilitare 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. Rimuovere il commento dalla riga "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" in archivio conf/partner.cfg
10. La funzionalità di sincronizzazione del server di rete consente agli amministratori di fornire numeri di telefono, indirizzi MAC e indirizzi e-mail degli utenti durante la migrazione nella stessa regione. Per abilitarlo, impostare USE_NS_SYNC=yes in conf/partner.cfg.

    Se la sincronizzazione NS è disattivata, il provisioning dei numeri di telefono e dei dispositivi verrà ignorato e gli utenti riceveranno indirizzi email temporanei.

11. Facoltativamente, abilitare le proprietà ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD e ANALOG_USER_TYPE_DISABLE_T38 per configurare l'attesa di chiamata, la musica in attesa e disabilitare le impostazioni T38 per tutti gli utenti di tipo analogico.

Riempimento del input/customers.csv

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

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

Riempimento del input/users.csv

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

Istruzioni per l'esecuzione

Esegui lo strumento Trasforma in qualsiasi sistema operativo. Per eseguire lo strumento su Windows e macOS, attenersi alla seguente procedura:

Finestre

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

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

macOS

Per eseguire lo strumento di trasformazione su macOS, eseguire i seguenti passaggi:

1. Crea un ambiente virtuale e installa le 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
   python3 -m pip install phonenumbers
   

2. Esegui lo strumento di trasformazione:

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

Customer/user pre-controllo

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

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

pre-controllo

Oltre a eseguire l'API di pre-controllo per le informazioni del cliente, Transform Tool eseguirà anche l'API di pre-controllo per le email degli abbonati.

precheckinfo

Per impostazione predefinita, nel report delle eccezioni vengono inclusi solo gli errori di pre-controllo (ovvero i problemi che bloccano il provisioning). Aggiungendo questo flag verranno inclusi anche i risultati del precontrollo positivo (ad esempio, se esiste già un'organizzazione Webex che può essere allegata automaticamente).

Registri del terminale

I seguenti log nel 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 di eccezione

Lo strumento di trasformazione genera il report di eccezione all'interno di output/<timestamp>/exception_report.txt directory. È possibile utilizzare questo report per identificare i problemi che influiranno sulla migrazione e risolverli nel sistema Cisco BroadWorks.

Dopo aver modificato i dati utente per risolvere l'eccezione, eseguire nuovamente gli strumenti di estrazione e trasformazione con i nuovi dati. Il file di report 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

Output

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

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

Lo strumento di provisioning può essere eseguito su qualsiasi macchina, solitamente il computer portatile dell'amministratore del partner, e utilizza le API pubbliche di Webex. Legge il file JSON di output dello strumento di trasformazione (customer.json) come input e fornisce 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, 17 o 21 sul computer. Java è disponibile da numerose fonti, tra cui:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Dopo aver scaricato ed estratto i file binari degli strumenti di migrazione, impostare la variabile d'ambiente JAVA_HOME in provisioning_tool.sh per MAC e provisioning_tool.bat per Windows.
3. Il file partner.cfg:
   • Imposta l'ID WHOLESALE_PROVISIONING_e il TOKEN REFRESH_(token copiato dallo strumento generatore di token). Gli amministratori partner devono contattare il team del proprio account per ottenere l'ID PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Impostare ALLOW_ADMIN_INVITE_EMAILS su false se il partner non desidera inviare un'e-mail di benvenuto agli utenti. Il valore predefinito è vero.

4. Utilizzare la proprietà WEBEX4BWKS_EMAIL_SUBJECT per le migrazioni Webex per BroadWorks per inviare l'oggetto dell'e-mail di richiesta di modifica della password per gli abbonati Webex per BroadWorks.
5. Utilizzare la proprietà WEBEX4BWKS_EMAIL_BODY per le migrazioni Webex per BroadWorks per inviare il corpo dell'e-mail di richiesta di modifica della password per gli abbonati Webex per BroadWorks.
6. La funzionalità di sincronizzazione del server di rete consente agli amministratori di fornire numeri di telefono, indirizzi MAC e indirizzi e-mail degli utenti durante la migrazione nella stessa regione. Per abilitarlo, impostare USE_NS_SYNC=yes in conf/partner.cfg.

   Se la sincronizzazione NS è disattivata, il provisioning dei numeri di telefono e dei dispositivi verrà ignorato e gli utenti riceveranno indirizzi email temporanei.

Per le migrazioni BroadCloud nella stessa regione:

1. Lo strumento salta il provisioning di numeri, dispositivi e Shared Call Appearances.
2. Lo strumento crea utenti e utenti virtuali con estensione ed estensione temporanea.

Per le migrazioni BroadCloud un'altra regione:

1. Lo strumento fornirà numeri, dispositivi e Shared Call Appearances.
2. Lo strumento crea utenti e utenti virtuali con numeri di telefono ed interni reali.
   Tutte le migrazioni BroadCloud in Europa avvengono verso un'altra regione.

Istruzioni per l'esecuzione

Per eseguire lo strumento su Windows e macOS, attenersi alla seguente procedura:

Finestre

Per eseguire lo strumento sul sistema operativo Windows, eseguire i seguenti passaggi:

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

macOS

Per eseguire lo strumento su macOS, eseguire i seguenti passaggi:

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

Prerequisiti per la migrazione da Webex a BroadWorks

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

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

Eseguire lo strumento di provisioning con un argomento aggiuntivo.

Fase di preparazione: è la fase predefinita in cui gli amministratori possono predisporre gli utenti BroadWorks come abbonati Wholesale e continuare con Webex per gli utenti BroadWorks.

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

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 postmigration.

Registri del terminale

Di seguito sono riportati i log nel terminale in caso di provisioning riuscito:

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

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

Output

Lo strumento di provisioning genera report di successo ed errore all'interno di output/<external_id>/*.success/error file. Esaminare i registri di output di successo e di errore per verificare il provisioning riuscito.

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

Figura 8: Partner Hub

Figura 9: Control Hub

Figura 10: Dispositivi

Figura 11: Chiamata

Per BroadCloud

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

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

La funzionalità Sincronizzazione server di rete consente agli amministratori di disattivare la posizione broadCloud e di attivare la posizione Webex Calling impostando USE_NS_SYNC=yes in conf/partner.cfg. Dopo la migrazione, i dispositivi e i numeri di telefono vengono attivati nella posizione Webex Calling.

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 sia le migrazioni nella stessa regione che quelle tra regioni diverse con NS Sync, ma solo per le migrazioni riuscite. In caso di errori, gli amministratori devono sollevare un Cisco TAC prima di richiedere il rollback.

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

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

Le figure seguenti mostrano il portale del fornitore di servizi.

Figura 12: Portale del fornitore di servizi

Figura 13: Portale del fornitore di servizi

Migra le posizioni selezionate (facoltativo)

Per avviare la migrazione per uno specifico sottoinsieme di posizioni elencate nel file customer.json, includi un file locations.csv con la tua richiesta. Questo CSV dovrebbe elencare solo le posizioni che intendi migrare.

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

Figura 14: Esporta posizioni come CSV

Per Cisco BroadWorks e Webex per BroadWorks

Per le migrazioni Cisco BroadWorks e Webex per BroadWorks, lo strumento viene eseguito sul Cisco BroadWorks Application Server secondario all'interno della rete partner e si connette all'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 migrare dispositivi e client software.

In caso di 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 verranno reindirizzati 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 all'ingrosso.
5. Crea aspetti di chiamata condivisi in Wholesale per le migrazioni BroadCloud. [This il passaggio è applicabile solo per BroadCloud migrations].

SCP e SSH

1. Eseguire il comando SCP sullo strumento di spostamento del dispositivo sul server applicativo Cisco BroadWorks secondario.
2. Per configurare i prerequisiti ed eseguire lo strumento di spostamento del dispositivo, accedere tramite SSH al Cisco BroadWorks Application Server secondario.

Prerequisiti

1. Imposta il TOKEN REFRESH_(token copiato dallo strumento generatore di token) in conf/partner.cfg file:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Per inviare nuovamente le email di attivazione, è necessario impostare RESEND_INVITATION_EMAILS=true nel conf/partner.cfg file.

   Se gli amministratori desiderano inviare email di invito ai propri utenti durante la migrazione, devono rimuovere il commento da "RESEND_INVITATION_EMAILS=true" proprietà nella conf/partner.cfg file. Altrimenti la proprietà dovrebbe restare invariata.

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

   JAVA_HOME=/usr/local/java/java_base

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

Telefoni Polycom

Per spostare i telefoni Polycom da Cisco BroadWorks a Wholesale Calling, un amministratore partner deve creare un nuovo Identity/Device File di tipo profilo a livello di sistema in Cisco BroadWorks ogni modello di dispositivo Polycom. Fare riferimento alla figura 14 e caricare il file personalizzato device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Dopo aver caricato il nuovo file del dispositivo, assicurati che il file appena creato esista a livello di gruppo. Assicuratevi inoltre che il file migration_%BWMAC ADDRESS%.cfg non sia in conflitto con nessun file esistente nel vostro 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 fa riferimento a migration_%BWMACADDRESS%.cfg.
2. Ricostruire 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 a 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 device.prov.serverName su https://plcm.sipflash.com.
   https://plcm.sipflash.com per la regione degli Stati Uniti, le altre regioni hanno URL diversi.
5. Il telefono Polycom scarica %BWMACADDRESS%.cfg da https://plcm.sipflash.com e sarà gestito dal DMS di Webex Calling.

Figura 14: Identity/device aggiungi file tipo profilo

Istruzioni per l'esecuzione

Esistono due metodi per richiamare il DMT: il primo consiste nell'eseguirlo tramite un singolo cliente alla volta, il secondo consiste nell'eseguirlo tramite più clienti contemporaneamente.

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

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

Registri del terminale

Di seguito sono riportati i log nel terminale in caso di esecuzione corretta dello strumento di spostamento del dispositivo per la migrazione del dispositivo:

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

Output

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

Figura 15: Stato dispositivo

Dopo la migrazione dei dispositivi, i numeri sono diventati attivi. Fare riferimento alla figura 16 per vedere un esempio dei numeri attivi:

Figura 16: Numeri attivi

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

Per BroadCloud Carrier

La procedura di ripristino per i partner BroadCloud è la seguente:

1. Apri un ticket con Cisco TAC per richiedere il ripristino del dispositivo.
2. Esegui lo strumento di spostamento del dispositivo in modalità di ripristino:
   • I numeri di telefono non saranno più assegnati a Webex Calling, lasciando agli utenti e ai servizi solo gli interni.
   • Gli indirizzi e-mail in Webex Calling torneranno ad essere indirizzi e-mail temporanei.
   • I telefoni verranno eliminati da Webex Calling.
   • I numeri di telefono, gli indirizzi email utilizzati come alternatedId e i telefoni verranno ricreati in BroadCloud.
   • I telefoni verranno riavviati.
3. Gli amministratori partner devono spostare nuovamente i numeri di telefono PSTN su BroadCloud Carrier.

Per Cisco BroadWorks e Webex per BroadWorks

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

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

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

Per eseguire lo strumento di spostamento del dispositivo in modalità di ripristino, seguire i passaggi sottostanti:

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

Ripristina profili

./devicemove.sh -input=  -revertProfiles

Ripristina numeri

./devicemove.sh -input=  -revertNumbers

Registri del terminale

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

Ripristina 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

Ripristina 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