Telefoanele acceptate vor fi create automat și atribuite utilizatorilor în Webex Calling de către instrumentul de aprovizionare. Telefoanele marcate cu „da” în coloana „Acceptate în instrumentul de mutare a dispozitivelor” vor fi, de asemenea, mutate automat din Cisco BroadWorks sau BroadCloud în Webex Calling atunci când se execută instrumentul de mutare a dispozitivelor. Telefoanele marcate cu „Nu” în coloana respectivă necesită o intervenție manuală pentru a modifica adresa URL DMS în șablonul dispozitivului Cisco BroadWorks sau în telefonul în sine.

Ultima coloană oferă maparea modelelor de telefoane la coloana „Tip dispozitiv” a fișierului transform-tool/input/newphones.csv. (Consultați secțiunea Instrumentul de transformare din acest articol pentru mai multe informații despre newphones.csv).

Administratorii parteneri rulează acest instrument utilitar generator de tokenuri cel puțin o dată înainte de a începe rularea instrumentelor de migrare. Rularea acestui instrument este o activitate unică după ce contul partenerului este integrat în soluția Wholesale RTM. Acest instrument permite administratorilor partenerilor să se conecteze prin intermediul unui browser web pentru a obține TOKEN-ul unic necesar pentru actualizarea fișierelor de configurare ale partenerilor pentru instrumentele de migrare.

Cerințe preliminare

Instalați Java 8, 11, 17 sau 21 pe computer. Java este disponibil din mai multe surse, inclusiv:

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

După descărcare, extrageți fișierele binare ale instrumentului de migrare.

Instrucțiuni de rulare

Executați următoarea comandă în terminalul din directorul generatorului de token-uri:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Ieșire:

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

Deschideți adresa URL în browserul web de pe terminal, conectați-vă cu acreditările de administrator al partenerului pentru a obține TOKEN-ul și copiați-l pentru utilizare ulterioară.

Ilustrațiile interfeței utilizator sunt prezentate mai jos pentru referință:

Figura 3: Autentificare cu Cisco Webex

Figura 4: Fereastra de acreditări

Figura 5: Generarea de tokenuri

Configurați următorii pași înainte de a rula instrumentele de extragere și mutare a dispozitivelor pe serverul secundar BroadWorks.

Activează conectivitatea OCI-P

Instrumentul de mutare a dispozitivului comunică cu BroadWorks prin comenzi OCI-P. Pentru a activa conectivitatea OCI-P, urmați pașii de mai jos:

Pasul 1: Folosește CLI pentru a configura Setările generale.

Executați următoarea comandă în CLI pentru a accesa directorul GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Executați următoarea comandă în CLI pentru a obține setările generale curente:

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

Dacă setările nu corespund cu cele de mai sus, utilizați comanda set pentru a le reconfigura.

Pasul 2: Folosește CLI pentru a configura proxy-ul OCI.

Schimbați directorul în OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Rulați următoarea interfață CLI pentru a obține setările actuale. Ar trebui să vedeți următoarele:

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

Dacă setările nu corespund cu cele de mai sus, utilizați comanda set pentru a le reconfigura.

Pasul 3: Folosește CLI pentru a configura furnizarea OCI.

Schimbare la directorul de furnizare:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Executați următoarea comandă pentru a obține setările curente de furnizare OCI:

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

Pasul 4: Executați comanda de mai jos în CLI pentru a verifica dacă configurația este corectă.

 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ți serverul client deschis implementat și activ

Folosiți comenzile de mai jos pentru a implementa și porni Open Client Server pe serverul secundar de aplicații, dacă acesta nu este implementat sau nu a pornit deja.

Pasul 1: Implementați serverul cu următoarea comandă CLI:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Pasul 2: Porniți serverul cu această comandă:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Activează activarea numerelor

Executați următoarele comenzi în CLI pentru a activa numerele:

Pasul 1: Executați comanda de activare a numerelor:

AS_CLI> cd SubscriberMgmt/NumberActivation

Pasul 2: Executați comanda activation enabled:

AS_CLI> set dnMode groupAndUserActivationEnabled

Pasul 3: La solicitarea de confirmare, introduceți Y.

Pentru BroadCloud

Instrumentul de extragere este integrat în portalul BroadCloud Service Provider. Un administrator al furnizorului de servicii poate:

1. Trimiteți cereri de extragere pentru maximum 50 de clienți per cerere.
   Cererea de extras nu poate fi trimisă pentru același client de mai mult de 10 ori pe zi.
2. Descărcați fișierul cu date extrase, în format ZIP, în termen de maximum 28 de zile de la data depunerii solicitării.

Următoarele figuri prezintă portalul furnizorilor de servicii.

Figura 6: Portalul furnizorilor de servicii

Figura 7: Portalul furnizorilor de servicii

Cerere de extragere CSV

Inițiază cererea de extragere CSV

1. Descărcați fișierul CSV al clientului

   Faceți clic pe linkul Descărcați fișierul CSV al clientului din colțul din dreapta sus al secțiunii Inițiați cererea de extragere CSV.

2. Editați lista de clienți

   Administratorul poate edita acest fișier CSV pentru a include doar clienții pentru care trebuie efectuată extragerea.

3. Încărcați și trimiteți

   După editare, încărcați fișierul CSV modificat.

   Faceți clic pe Trimiteți pentru a iniția o solicitare de extragere pentru clienții listați și locațiile asociate acestora.

Inițiază o cerere de extragere pentru un client cu locații CSV

1. Selectați clientul și locațiile de descărcare

   Alegeți un client din meniul derulant.

   Descărcați fișierul locations.csv corespunzător din fila Vizualizare clienți→ Site-uri → Exportă locații ca CSV.

2. Editați fișierul Locații

   Administratorul poate edita fișierul CSV pentru a include doar locațiile pe care dorește să le extragă.

3. Încărcați și trimiteți

   Încărcați fișierul locations.csv editat și faceți clic pe Trimite.

   Doar locațiile specificate pentru clientul selectat vor fi incluse în solicitarea de extragere.

Inițiați cererea de extragere pentru toți clienții

1. Faceți clic pe Trimiteți pentru a iniția o solicitare de extragere pentru toți clienții și toate locațiile acestora sub furnizorul de servicii actual.

Pentru Cisco BroadWorks și Webex pentru BroadWorks

1. Instrumentul de extragere rulează pe serverul secundar de aplicații Cisco BroadWorks din rețeaua partenerului și se conectează prin OCI-P.
2. Instrumentul extrage date brute de la întreprinderi, grupuri, numere, utilizatori, servicii, dispozitive și clienți soft din platforma Cisco BroadWorks sau BroadCloud și transmite aceste date în fișiere XML care furnizează date de intrare pentru instrumentul de transformare.

Următoarele secțiuni explică modul de instalare și configurare a instrumentului de extragere.

Cerințe preliminare

1. Conectați fișierele binare ale instrumentului de extragere prin SCP la serverul secundar de aplicații Cisco BroadWorks.
2. Conectați-vă prin SSH la serverul secundar Cisco BroadWorks Application Server pentru a configura cerințele preliminare și a rula instrumentul de extragere.
3. Configurați furnizorul de servicii și ID-ul de grup pentru a extrage din Cisco BroadWorks în conf/exportTool.yml. Consultați următorul fragment de cod YAML exemplu:

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

4. Asigurați-vă că ID-ul de utilizator, parola și numele gazdei secundare Cisco BroadWorks Application Server sunt corecte în conf/partner.cfg fişier:

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

   Proprietatea REFRESH_TOKEN este obligatorie pentru o migrare Webex for BroadWorks.

5. Modificați JDK/JRE calea de mediu din fișierul export.sh dacă serverul secundar Cisco BroadWorks Application Server JDK/JRE Calea de mediu este diferită de fișier:

   JAVA_HOME=/usr/local/java/java_base

Instrucțiuni de rulare

Executați următoarea comandă în serverul secundar Cisco BroadWorks Application Server din directorul instrumentului de extragere:

./export.sh

Jurnalele terminalului

Următoarele jurnale sunt disponibile în terminal după exportul reușit: Rularea instrumentului de exportare a datelor 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
**************************************************

Ieşire

Un fișier ZIP de ieșire (extracted_data_<timestamp>.zip) este disponibil în același director al instrumentului de extragere. Folosește următoarea comandă pentru a vizualiza și utiliza fișierul ZIP pentru intrarea în Instrumentul de transformare:

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

Acest instrument de transformare rulează pentru toate migrările. Instrumentul de transformare rulează pe orice computer, inclusiv pe laptopul de administrator al unui partener și utilizează API-urile Webex Public. Citește fișierul ZIP (extracted_data_<timestamp>.zip) de ieșire al instrumentului de extragere ca intrare și transformă fișierul XML brut într-un format JSON care este utilizat de instrumentul de furnizare.

Cerințe preliminare

După descărcarea și extragerea fișierelor binare ale instrumentelor de migrare, configurați următoarele cerințe preliminare:

1. Setați REFRESH_TOKEN (Token copiat din Instrumentul Generator de Jetoane) și NAME_OF_MAIN_LOCATION în conf/partner.cfg fişier:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opțional, setați ID-ul PROVISIONING_(copiat din șablonul din Partner Hub) în conf/partner.cfg fişier:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pentru o verificare mai completă a adresei de e-mail a clientului, puteți seta opțional ID-ul PROVISIONING_.
3. Configurați informațiile lipsă din input/customers.csv fișier (vezi secțiunea următoare) dacă lipsește.
4. Adăugați adresa de e-mail a utilizatorului final în input/users.csv fişier.
5. Dacă urmează să fie furnizate telefoane noi, adăugați adresa MAC și adresa de e-mail a noului telefon al utilizatorului la input/newphones.csv fişier. Acest lucru este necesar numai dacă administratorii partenerilor doresc să furnizeze noi telefoane în cadrul serviciului de apeluri Wholesale.
6. Conversia centrelor de apel BroadWorks în CxEssentials utilizând input/cxessentials.csv fişier.
7. Opțional, activați proprietatea UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS pentru a converti toate centrele de apel în CxEssentials.
8. Folosește input/locations.csv fișier pentru a susține migrarea la nivel de întreprindere, care permite administratorilor să migreze locațiile clienților lor în funcție de locație
9. Opțional, activați utilizarea adreselor MAC din antetul User-Agent al mesajului SIP REGISTER atunci când adresa MAC nu este disponibilă în profilul dispozitivului Cisco BroadWorks. Eliminați comentariul de la linia „USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" în fișier conf/partner.cfg
10. Funcția de sincronizare a serverului de rețea permite administratorilor să furnizeze numere de telefon, adrese MAC și adrese de e-mail ale utilizatorilor în timpul migrării furnizării în aceeași regiune. Pentru a o activa, setați USE_NS_SYNC=yes în conf/partner.cfg.

    Dacă sincronizarea NS este dezactivată, furnizarea numerelor de telefon și a dispozitivelor va fi omisă, iar utilizatorii vor primi adrese de e-mail temporare.

11. Opțional, activați proprietățile ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD și ANALOG_USER_TYPE_DISABLE_T38 pentru a configura apelul în așteptare, muzica în așteptare și a dezactiva setările T38 pentru toți utilizatorii de tip analogic.

Umplerea input/customers.csv

Fișierul input/customers.csv oferă date care pot lipsi în Cisco BroadWorks sau BroadCloud. Acest fișier poate fi lăsat gol dacă toate informațiile obligatorii sunt deja disponibile. Nu trebuie să completați toate coloanele, doar informațiile lipsă sunt obligatorii.

Tabelul de mai jos explică cele mai importante coloane din input/customers.csv.

Umplerea input/users.csv

Fișierul input/users.csv oferă date care pot lipsi în Cisco BroadWorks sau BroadCloud. Acest fișier poate fi lăsat gol dacă toate informațiile obligatorii sunt deja disponibile. Nu trebuie să completați toate coloanele, doar informațiile lipsă sunt obligatorii.

Instrucțiuni de rulare

Rulați instrumentul Transform Tool în orice sistem de operare. Urmați pașii de mai jos pentru a rula instrumentul în Windows și macOS:

Windows

Executați comanda de mai jos pentru a rula Instrumentul de transformare în Windows:

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

Sistem de operare Mac

Executați următorii pași pentru a rula instrumentul de transformare pe macOS:

1. Creați un mediu virtual și instalați dependențele pentru a rula instrumentul de transformare folosind 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. Rulați instrumentul de transformare:

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

Customer/user verificare prealabilă

Instrumentul de transformare efectuează apeluri API către Webex pentru a detecta potențialele probleme de furnizare. În mod implicit, va valida adresa clientului și adresa de e-mail principală. Dacă valoarea ID-ului PROVISIONING_este specificată în conf/partner.cfg fișier, va valida și informațiile despre locație. Rezultatele verificării prealabile sunt incluse în raportul de excepții.

În plus, următorii parametri opționali pot fi adăugați la rularea instrumentului de transformare:

verificare prealabilă

Pe lângă rularea API-ului de preverificare pentru informațiile despre clienți, Instrumentul de transformare va rula și API-ul de preverificare pentru e-mailurile abonaților.

informații de preverificare

În mod implicit, în raportul de excepții sunt incluse doar erorile de preverificare (adică problemele care vor bloca furnizarea). Adăugarea acestui steag va include și rezultatele verificării prealabile reușite (de exemplu, dacă există deja o organizație Webex care poate fi atașată automat).

Jurnalele terminalului

Următoarele jurnale din terminal la transformarea reușită:

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

Raport de excepție

Instrumentul de transformare generează raportul de excepții în cadrul output/<timestamp>/ Directorulexception_report.txt. Puteți utiliza acest raport pentru a identifica problemele care vor afecta migrarea și a le remedia în sistemul Cisco BroadWorks.

După modificarea datelor utilizatorului pentru a rezolva excepția, rulați din nou instrumentele de extragere și transformare cu noile date. Fișierul de raportare a excepțiilor eșantion este următorul:

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

Ieşire

Un fișier JSON de ieșire (customer.json) va fi disponibil în fișierul output/<timestamp>/ Directorul<groupid>. Fișierul exemplu customer.json este următorul:

{
    "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"
    }
}

Instrumentul de furnizare poate rula pe orice mașină, de obicei (laptopul administratorului partenerului) și utilizează API-urile Webex Public. Citește fișierul JSON de ieșire al instrumentului de transformare (customer.json) ca intrare și furnizează clienții, locațiile, numerele, utilizatorii, serviciile și dispozitivele din soluția Webex Wholesale RTM.

Cerințe preliminare

Configurați următoarele cerințe preliminare în directorul instrumentului de furnizare:

1. Instalați Java 8, 11, 17 sau 21 pe computer. Java este disponibil din mai multe surse, inclusiv:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. După descărcarea și extragerea fișierelor binare ale instrumentelor de migrare, setați variabila de mediu JAVA_HOME în fișierul provisioning_tool.sh pentru MAC și provisioning_tool.bat pentru Windows.
3. Fișierul partner.cfg:
   • Setați ID-ul WHOLESALE_PROVISIONING_și REFRESH_TOKEN (tokenul copiat din instrumentul generator de tokenuri). Administratorii partenerilor trebuie să contacteze echipa lor de cont pentru a obține ID-ul PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Setați ALLOW_ADMIN_INVITE_EMAILS la false dacă partenerul nu dorește să trimită un e-mail de bun venit utilizatorilor. Valoarea implicită este adevărat.

4. Utilizați proprietatea WEBEX4BWKS_EMAIL_SUBJECT pentru migrările Webex for BroadWorks pentru a trimite subiectul e-mailului de solicitare a schimbării parolei pentru abonații Webex for BroadWorks.
5. Utilizați proprietatea WEBEX4BWKS_EMAIL_BODY pentru migrările Webex for BroadWorks pentru a trimite corpul e-mailului de solicitare a schimbării parolei pentru abonații Webex for BroadWorks.
6. Funcția de sincronizare a serverului de rețea permite administratorilor să furnizeze numere de telefon, adrese MAC și adrese de e-mail ale utilizatorilor în timpul migrării furnizării în aceeași regiune. Pentru a o activa, setați USE_NS_SYNC=yes în conf/partner.cfg.

   Dacă sincronizarea NS este dezactivată, furnizarea numerelor de telefon și a dispozitivelor va fi omisă, iar utilizatorii vor primi adrese de e-mail temporare.

Pentru migrările BroadCloud în aceeași regiune:

1. Instrumentul omite furnizarea numerelor, dispozitivelor și a Aspectelor Apel Partajate.
2. Instrumentul creează utilizatori și utilizatori virtuali cu extensie și extensie temporară.

Pentru migrările BroadCloud, o altă regiune:

1. Instrumentul va furniza numere, dispozitive și afișaje de apel partajate.
2. Instrumentul creează utilizatori și utilizatori virtuali cu numere de telefon și extensii reale.
   Toate migrările BroadCloud din Europa se fac către o altă regiune.

Instrucțiuni de rulare

Urmați pașii următori pentru a rula instrumentul în Windows și macOS:

Windows

Executați următorii pași pentru a rula instrumentul pe sistemul de operare Windows:

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

Sistem de operare Mac

Executați următorii pași pentru a rula instrumentul pe macOS:

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

Cerințe preliminare pentru migrarea Webex for BroadWorks

Administratorii parteneri trebuie să își actualizeze șablonul de integrare BroadWorks pentru funcțiile de coexistență Webex for BroadWorks. Consultați următoarea imagine:

După ce șablonul de integrare Webex for BroadWorks este actualizat pentru a accepta migrarea, solicitați echipei de conturi Cisco să activeze comutatorul funcției „wholesale-partner-blending-enabled” la nivel de partener. Acest lucru va permite adăugarea de pachete Wholesale la organizațiile clienților Webex for BroadWorks existenți în timpul aprovizionării.

Rulați instrumentul de furnizare cu un argument suplimentar.

Faza de pregătire: este faza implicită în care administratorii pot configura utilizatorii BroadWorks ca abonați Wholesale și pot continua cu Webex pentru utilizatorii BroadWorks.

Faza de întreținere: este a doua fază în care administratorii pot atribui licența Wholesale utilizatorilor Webex for BroadWorks existenți. Trebuie să rulați instrumentul de furnizare cu un argument maintenance.

Faza post-migrare: Este faza finală în care administratorii pot converti complet BroadWorks în Wholesale. Trebuie să rulați instrumentul de furnizare cu un argument postmigration.

Jurnalele terminalului

Următoarele sunt jurnalele din terminal privind aprovizionarea cu succes:

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

Se va tipări un tabel cu numărul de locații create pentru fiecare rulare:

Ieşire

Instrumentul de furnizare generează rapoarte de succes și erori în cadrul output/<external_id>/*.success/error fișiere. Examinați jurnalele de succes și erori ale ieșirilor pentru a verifica dacă aprovizionarea a fost reușită.

Administratorii partenerilor pot verifica furnizarea de servicii clientului în portalul Partner Hub și Control Hub. Consultați următoarele ilustrații din portalul Partner Hub și Control Hub:

Figura 8: Partner Hub

Figura 9: Control Hub

Figura 10: Dispozitive

Figura 11: Apelare

Pentru BroadCloud

Pentru partenerii BroadCloud, utilizați portalul Furnizor de servicii pentru a trimite o solicitare de migrare pentru numere, dispozitive și migrări Shared Call Appearances (SCA).

În cadrul portalului Furnizorului de Servicii, o cerere de migrare poate include până la 50 de clienți. Se pot depune maximum 10 cereri într-o zi.

Funcția de sincronizare a serverului de rețea permite administratorilor să dezactiveze locația broadCloud și să activeze locația Webex Calling prin setarea USE_NS_SYNC=yes în conf/partner.cfg. După migrare, dispozitivele și numerele de telefon sunt activate în locația Webex Calling.

Administratorii pot activa revenirea automată la versiunea inițială setând ROLLBACK_TO_BROADCLOUD=true în fișierul conf/partner.cfg, ceea ce mută dispozitivele înapoi în BroadCloud după migrare. Acceptă atât migrări în aceeași regiune, cât și în regiuni diferite cu NS Sync, dar numai pentru migrări reușite. Pentru cele eșuate, administratorii trebuie să genereze un aviz Cisco TAC înainte de a solicita revenirea la versiunea inițială.

Există două opțiuni disponibile pentru selectarea tipului de migrare în portal:

• Migrare – Selectați această opțiune pentru a iniția o solicitare de migrare a numerelor, dispozitivelor și Afișărilor Apel Partajate (SCA).
• Starea dispozitivului – Selectați această opțiune pentru a vizualiza starea curentă a unui dispozitiv pe BroadCloud și Calling.

Următoarele figuri prezintă portalul furnizorilor de servicii.

Figura 12: Portalul furnizorilor de servicii

Figura 13: Portalul furnizorilor de servicii

Migrarea locațiilor selectate (opțional)

Pentru a începe migrarea pentru un anumit subset de locații listate în fișierul customer.json, includeți un fișier locations.csv în solicitarea dvs. Acest fișier CSV ar trebui să enumere doar locațiile pe care intenționați să le migrați.

Pentru a descărca lista site-urilor active disponibile, navigați la Vizualizare clienți → Selectare client → Exportare locații ca CSV.

Figura 14: Exportați locațiile ca fișier CSV

Pentru Cisco BroadWorks și Webex pentru BroadWorks

Pentru migrările Cisco BroadWorks și Webex for BroadWorks, instrumentul rulează pe serverul secundar de aplicații Cisco BroadWorks din rețeaua partenerului și se conectează la AS prin OCI-P. Folosește fișierul JSON de ieșire Transform Tool (customer.json) ca intrare și execută comenzile OCI-P pentru a migra dispozitive și clienți soft.

După o operațiune reușită, instrumentul de mutare a dispozitivului va:

1. Anulați înregistrarea dispozitivelor din Cisco BroadWorks și înregistrați-le în Wholesale.
2. Utilizatorii care utilizează clientul UC-One vor fi redirecționați către aplicația Webex la prima conectare.
3. Dezactivați numerele de telefon din Cisco BroadWorks sau eliminați numerele de telefon din BroadCloud.
4. Activează numerele în comerțul cu ridicata.
5. Creați apariții de apel partajate în Wholesale pentru migrări BroadCloud. [This Pasul este aplicabil numai pentru BroadCloud migrations].

SCP și SSH

1. Conectați instrumentul de mutare a dispozitivului la serverul secundar Cisco BroadWorks Application Server prin SCP.
2. Conectați-vă prin SSH la serverul secundar Cisco BroadWorks Application Server pentru a configura cerințele preliminare și a rula instrumentul de mutare a dispozitivului.

Cerințe preliminare

1. Setați REFRESH_TOKEN (Token copiat din Instrumentul Generator de Jetoane) în conf/partner.cfg fişier:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Asigurați-vă că ID-ul de utilizator, parola și numele gazdei secundare Cisco BroadWorks Application Server sunt corecte în conf/deviceMoveTool.conf fişier:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Pentru a retrimite e-mailuri de activare, trebuie să setați RESINDE_INVITATION_EMAILS=true în conf/partner.cfg fişier.

   Dacă administratorii doresc să trimită e-mailuri de invitație utilizatorilor lor în timpul migrării, aceștia trebuie să elimine comentariile la „RETRIMITE_INVITARE_EMAILS=true" proprietate în conf/partner.cfg fişier. În caz contrar, proprietatea ar trebui să rămână neschimbată.

4. Verificați JDK/JRE Calea de mediu este corectă în devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratorii pot utiliza fișierul locations.csv din directorul de intrare pentru a migra grupurile specifice în loc de toate grupurile dintr-o întreprindere.

Telefoane Polycom

Pentru a muta telefoanele Polycom de la Cisco BroadWorks la Wholesale Calling, un administrator partener trebuie să creeze un nou Identity/Device Fișier de tip profil la nivel de sistem în Cisco BroadWorks fiecare șablon de dispozitiv Polycom. Consultați figura 14 și încărcați fișierul personalizat device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. După încărcarea noului fișier de dispozitiv, asigurați-vă că fișierul nou creat există la nivel de grup. De asemenea, asigurați-vă că fișierul migration_%BWMAC ADDRESS%.cfg nu intră în conflict cu niciun fișier existent în sistemul dumneavoastră.

Este utilizat intern de instrumentul de mutare a dispozitivului.

Procesul de migrare pentru telefoanele Polycom:

1. Instrumentul de mutare a dispozitivului înlocuiește fișierul %BWMACADDRESS%.cfg la nivel de dispozitiv cu polycom_vvx2.cfg. Acest fișier se referă la migration_%BWMACADDRESS%.cfg.
2. Reconstruiți profilurile dispozitivelor la nivel de grup sau la nivel de dispozitiv.
   Acțiunea la nivel de grup sau la nivel de dispozitiv depinde de configurația parametrului deviceLevelRebuild din fișier. device-move-tool/conf/partner.cfg.
3. Instrumentul de mutare a dispozitivelor solicită serverului de aplicații Cisco BroadWorks să repornească telefoanele la nivel de grup sau la nivel de dispozitiv.
4. După solicitarea de repornire, telefoanele Polycom descarcă și procesează fișierul% BWMACADDRESS%.cfg, care solicită telefoanelor Polycom să descarce și să proceseze fișierul migration_%BWMACADDRESS%.cfg, ceea ce setează device.prov.serverName la https://plcm.sipflash.com.
   https://plcm.sipflash.com Pentru regiunea SUA, alte regiuni au adrese URL diferite.
5. Telefonul Polycom descarcă fișierul %BWMACADDRESS%.cfg din https://plcm.sipflash.com și va fi gestionat de Webex Calling DMS.

Figura 14: Identity/device adăugare fișier tip profil

Instrucțiuni de rulare

Există două metode de a invoca DMT, prima este de a apela prin intermediul unui singur client odată, iar cealaltă este de a rula prin intermediul mai multor clienți simultan.

Instrumentul de mutare a dispozitivelor este executat de pe serverul secundar de aplicații Cisco BroadWorks din directorul instrumentului de mutare a dispozitivelor:

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

Jurnalele terminalului

Mai jos sunt jurnalele din terminal privind rularea cu succes a instrumentului de mutare a dispozitivelor pentru migrarea dispozitivelor:

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

Ieşire

După migrarea dispozitivelor, acestea au intrat online și sunt gata de make/receive apeluri. Consultați figura 15 pentru a vedea un exemplu de stare a dispozitivului:

Figura 15: Stare dispozitiv

După migrarea dispozitivului, numerele au devenit active. Consultați figura 16 pentru a vedea un exemplu al numerelor active:

Figura 16: Numere active

Operația de revenire trebuie executată pentru o singură întreprindere odată.

Pentru BroadCloud Carrier

Procesul de returnare pentru partenerii BroadCloud este următorul:

1. Deschideți un tichet la Cisco TAC pentru a solicita revenirea la configurația unui dispozitiv.
2. Rulați instrumentul de mutare a dispozitivului în modul de revenire:
   • Numerele de telefon vor fi anulate din Webex Calling, utilizatorii și serviciile rămânând doar cu extensii.
   • Adresele de e-mail din Webex Calling vor fi readuse la adrese de e-mail temporare.
   • Telefoanele vor fi șterse din Webex Calling.
   • Numerele de telefon, adresele de e-mail utilizate ca ID-uri alternative și numerele de telefon vor fi recreate în BroadCloud.
   • Telefoanele vor fi repornite.
3. Administratorii parteneri trebuie să mute numerele de telefon PSTN înapoi la BroadCloud Carrier.

Pentru Cisco BroadWorks și Webex pentru BroadWorks

Procesul de revenire pentru Cisco BroadWorks și Webex for BroadWorks este următorul:

1. Deschideți un tichet la Cisco TAC pentru a solicita revenirea la configurația unui dispozitiv.
2. Rulați instrumentul de mutare a dispozitivelor în modul de revenire pe serverul de aplicații BroadWorks secundar pentru a anula migrările dispozitivelor. Aceasta va seta adresa URL DMS înapoi la adresa URL DMS a furnizorului de servicii pentru profilurile de dispozitive din Cisco BroadWorks și va reactiva numerele de telefon.
3. Echipa Webex Calling setează adresa URL DMS înapoi la adresa URL DMS a furnizorului de servicii din profilurile dispozitivului din Webex Calling.
4. Administratorii parteneri trebuie să dezactiveze sau să șteargă numerele de telefon din Webex Calling prin intermediul portalului Control Hub.
5. Administratorii parteneri trebuie să mute numerele de telefon PSTN înapoi la Cisco BroadWorks.

Instrucțiuni pentru rularea instrumentului de mutare a dispozitivului în modul de revenire

Urmați pașii de mai jos pentru a rula instrumentul de mutare a dispozitivului în modul de revenire:

Executați comanda de mai jos în serverul secundar de aplicații Cisco BroadWorks din directorul instrumentului de mutare a dispozitivului:

Reveniți la profiluri

./devicemove.sh -input=  -revertProfiles

Reveniți la numere

./devicemove.sh -input=  -revertNumbers

Jurnalele terminalului

Vom primi următoarele jurnale în terminal la rularea cu succes a instrumentului de mutare a dispozitivului pentru operațiunea de revenire:

Reveniți la profiluri

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

Reveniți la numere

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