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

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

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

Dopo il download, estrarre i 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

Mac OS:

./token_generator.sh

Output:

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 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
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 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> get
Address Description
========================
127.0.0.1 local as

Passaggio 4: Eseguire il comando seguente in 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.

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> deploy application OpenClientServer

Passaggio 2: Avviare il server con questo comando:

AS_CLI/Maintenance/ManagedObjects> start application 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> set 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:

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

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_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

   La REFRESH_TOKEN proprietà è obbligatoria per una migrazione di 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:

 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

Sarà disponibile un file ZIP di output (extracted_data_<timestamp>.zip) 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 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 è 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 ZIP di output dello strumento di estrazione (extracted_data_<timestamp>.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:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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
10. La funzione di sincronizzazione del server di rete consente agli amministratori di eseguire il provisioning di numeri di telefono, indirizzi MAC e indirizzi e-mail degli utenti durante il provisioning nella stessa migrazione della regione. Per abilitarlo, impostare USE_NS_SYNC=yes in conf/partner.cfg.

    Se la sincronizzazione NS è disabilitata, il provisioning del numero di telefono e del dispositivo verrà ignorato e gli utenti riceveranno indirizzi e-mail temporanei.

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
   python3 -m pip install phonenumbers
   

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:

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

Report eccezione

Lo strumento di trasformazione genera il report di eccezione all'interno della directory output/<timestamp>/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:

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 nella directory output/<timestamp>/<groupid> . Il file customer.json di esempio è il seguente:

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

Lo strumento di provisioning può essere eseguito su qualsiasi macchina 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, 17 o 21 sul computer. Java è disponibile da molte fonti, tra cui:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Dopo aver scaricato ed estratto i 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.
6. La funzione di sincronizzazione del server di rete consente agli amministratori di eseguire il provisioning di numeri di telefono, indirizzi MAC e indirizzi e-mail degli utenti durante il provisioning nella stessa migrazione della regione. Per abilitarlo, impostare USE_NS_SYNC=yes in conf/partner.cfg.

   Se la sincronizzazione NS è disabilitata, il provisioning del numero di telefono e del dispositivo verrà ignorato e gli utenti riceveranno indirizzi e-mail temporanei.

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:

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

macOS

Eseguire i passaggi seguenti per eseguire lo strumento su macOS:

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./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:

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 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: Control Hub

Figura 10: Dispositivi

Figura 11: Chiamata

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.

La funzione di sincronizzazione del server di rete consente agli amministratori di disattivare la posizione broadCloud e 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 conf/partner.cfg file, che sposta nuovamente i dispositivi in BroadCloud dopo la migrazione. Supporta sia le migrazioni di regioni uguali che diverse con NS Sync, ma solo per le migrazioni di successo. Per quelli in errore, gli amministratori devono generare un centro TAC di Cisco prima di richiedere il rollback.

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:

   REFRESH_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_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = 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 process% 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:

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 terminali

Di seguito sono riportati i registri nel terminale sull'esecuzione corretta dello strumento di spostamento dispositivo per la migrazione 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 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

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