Mulțumim pentru feedback.

Telefoanele acceptate vor fi create automat și atribuite utilizatorilor Webex Calling prin instrumentul de aprovizionare. Telefoanele marcate cu „da” în coloana „Acceptate în instrumentul de mutare a dispozitivului” vor fi, de asemenea, mutate automat de la Cisco BroadWorks sau BroadCloud la Webex Calling momentul în care instrumentul de mutare a dispozitivului este rulat. Telefoanele marcate cu „Nu” în coloana respectivă au nevoie de o intervenție manuală pentru a schimba adresa URL DMS în șablonul dispozitivului Cisco BroadWorks sau în telefonul în sine.

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

Administratorii parteneri rulează acest instrument utilitar generator de jetoane cel puțin o dată înainte de a începe să ruleze instrumente de migrare. Rularea acestui instrument este o activitate unică după ce contul partener este conectat în soluția RTM cu ridicata. Acest instrument permite administratorilor parteneri să se conecteze prin browserul web pentru a obține TOKEN unic care este necesar pentru a actualiza fișierele 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 binarele instrumentului de migrare.

Instrucțiuni pentru a rula

Rulați următoarea comandă în terminalul din directorul generator de jetoane:

Ferestre:

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 administratorului partener pentru a obține TOKEN și copiați același pentru utilizare ulterioară.

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

Figura 3: Conectați-vă cu Cisco Webex

Figura 4: Fereastra de acreditări

Figura 5: Generarea jetonului

Configurați următorii pași înainte de a rula instrumentele de extracție și mutare a dispozitivului în serverul BroadWorks secundar.

Activați conectivitatea OCI-P

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

Pasul 1: Utilizați CLI pentru a configura setările generale.

Rulați următoarea comandă în CLI pentru a trece la directorul GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Rulați următoarea comandă în CLI pentru a obține GeneralSettings curente:

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

Dacă setările dvs. nu se potrivesc cu cele de mai sus, utilizați comanda set pentru a vă reconfigura setările.

Pasul 2: Utilizați CLI pentru a configura proxy OCI.

Schimbați directorul în OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Rulați următorul CLI pentru a obține setările curente. 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 dvs. nu se potrivesc cu cele de mai sus, utilizați comanda set pentru a vă reconfigura setările.

Pasul 3: Utilizați CLI pentru a configura furnizarea OCI.

Schimbarea la directorul Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Rulaț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: Rulați comanda de mai jos în CLI pentru a verifica dacă configurația dvs. 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

Utilizați comenzile de mai jos pentru a implementa și porni Open Client Server pe serverul de aplicații secundar dacă 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

Activați activarea numerelor

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

Pasul 1: Rulați comanda de activare a numărului:

AS_CLI> cd SubscriberMgmt/NumberActivation

Pasul 2: Rulați comanda activată de activare:

AS_CLI> set dnMode groupAndUserActivationEnabled

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

Pentru BroadCloud

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

1. Trimiteți cereri de extrase pentru până la 50 de clienți pe cerere.
   Cererea de extragere nu poate fi trimisă pentru același client de mai mult de 10 ori într-o zi.
2. Descărcați fișierul de date extras, în format ZIP, timp de până la 28 de zile de la data depunerii cererii.

Următoarele cifre prezintă portalul furnizorului de servicii.

Figura 6: Portalul furnizorilor de servicii

Figura 7: Portalul furnizorilor de servicii

Cerere de extragere CSV

Inițiați solicitarea de extragere CSV

1. Descărcați CSV-ul pentru clienți

   Faceți clic pe linkul Descărcați CSV pentru clienți din colțul din dreapta sus al secțiunii Inițiați solicitarea de extragere CSV.

2. Editați lista de clienți

   Administratorul poate edita acest fișier CSV pentru a include numai clienții pentru care ex tragerea trebuie efectuată.

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

   După editare, încărcați CSV-ul modificat.

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

Inițiați solicitarea de extragere pentru un client cu locații CSV

1. Selectați locațiile clientului și descărcați

   Alegeți un client din meniul derulant.

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

2. Editați fișierul locații

   Administratorul poate edita CSV-ul pentru a include doar locațiile pe care doresc să le extragă.

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

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

   Numai locațiile specificate pentru clientul selectat vor fi incluse în cererea de extragere.

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

1. Faceți clic pe Tri mitere pentru a iniția o solicitare de extragere pentru toți clienții și toate loc ațiile acestora sub furnizorul de servicii curent.

Pentru Cisco BroadWorks și Webex pentru BroadWorks

1. Instrumentul de extragere rulează pe serverul secundar Cisco BroadWorks Application Server din cadrul rețelei partenere și se conectează prin OCI-P.
2. Instrumentul extrage date brute de întreprindere, grup, numere, utilizatori, servicii, dispozitive și clienți soft de pe platforma Cisco BroadWorks sau BroadCloud și transmite aceste date în fișiere XML care furnizează intrările pentru instrumentul de transformare.

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

Cerințe preliminare

1. SCP instrumentul de extragere a binarelor către serverul secundar Cisco BroadWorks Application Server.
2. SSH către serverul secundar de aplicații Cisco BroadWorks pentru a configura condițiile preliminare și a rula instrumentul de extracție.
3. Configurați furnizorul de servicii și ID-ul grupului pentru a extrage din Cisco BroadWorks în Conf/ExportTool.yml. Consultați următorul fragment YAML de probă :

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

4. Asigurați-vă că ID-ul de utilizator secundar Cisco BroadWorks Application Server, parola și numele gazdei sunt corecte în fișierul 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.
   

   Proprietatea REFRESH_TOKEN este obligatorie pentru o migrare Webex pentru BroadWorks.

5. Modificați calea mediului JDK/JRE în fișierul export.sh dacă calea secundară a mediului Cisco BroadWorks Application Server JDK/JRE este diferită de fișier:

   JAVA_HOME=/usr/local/java/java_base

Instrucțiuni pentru a rula

Rulați următoarea comandă în serverul secundar Cisco BroadWorks Application Server din directorul de instrumente de extracție:

./export.sh

Jurnalele terminalelor

Următoarele jurnale sunt disponibile în terminal la exportul cu succes: Rularea instrumentului BroadSoft Data Export Tool:

 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_ .zip<timestamp>) este disponibil în același director de instrumente de extracție. Utilizaţi următoarea comandă pentru a vizualiza şi utiliza fişierul ZIP pentru intrarea Instrumentului 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

Dacă administratorul operează instrumentul din spatele unui proxy corporativ, urmați pașii de mai jos pentru a configura și executa scriptul de export.

Pași pentru configurarea și executarea scriptului de export

1. Deschideți fișierul export.sh.
2. Localizați variabila HTTPS_PROXY_HOST și dezcomentați-o (eliminați primul #).

3. Setați valoarea HTTPS_PROXY_HOST ca:

   HTTPS_PROXY_HOST=<proxy-host>

4. Localizați variabila HTTPS_PROXY_PORT și dezcomentați-o (eliminați primul #).
5. Setați valoarea HTTPS_PROXY_PORT ca:

   HTTPS_PROXY_PORT=<proxy-port>

6. Salvați și închideți fișierul export.sh.
7. Deschideți fișierul partner.cfg și adăugați tokenul de refresh necesar.
8. Verificați dacă gazda BroadWorks, numele de utilizator și parola sunt configurate corect în partner.cfg.
9. Rulați scriptul:

   ./export.sh

Formular de logodnă:

Instrumentul Extract (BroadCloud și BroadWorks) generează acum automat un fișier XLSX consolidat intitulat Formular de implic are SUA.xlsx în timpul execuției. Fișierul este pre-populat cu toate datele disponibile în foile de lucru relevante, contribuind la eficientizarea și accelerarea finalizării partenerilor.

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

Cerințe preliminare

După descărcarea și extragerea binarelor instrumentelor de migrare, configurați următoarele condiții preliminare:

1. Setați REFRESH_TOKEN (Token copiat din instrumentul Generator Token) și NAME_OF_MAIN_LOCATION în fișierul conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opțional, setați PROVISIONING_ID (copiat din șablonul din Partner Hub) în fișierul conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pentru a obține o verificare mai completă a adresei de e-mail a clientului, puteți seta opțional PROVISIONING_ID.
3. Configurați informațiile lipsă în fișierul input/customers.csv (consultați secțiunea următoare) dacă lipsesc.
4. Adăugați adresa de e-mail a utilizatorului final în fișierul input/users.csv.
5. Dacă urmează să fie furnizate telefoane noi, adăugați adresa mac și adresa de e-mail a noului telefon al utilizatorului în fișierul input/newphones.csv. Acest lucru este necesar numai dacă administratorii parteneri doresc să furnizeze telefoane noi în apelurile cu ridicata.
6. Convertiți centrele de apel BroadWorks în CXEssentials utilizând fișierul input/cxessentials.csv.
7. Opțional, activați proprietatea UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS pentru a converti toate centrele de apel în CXEssentials.
8. Utilizați fișierul input/locations.csv pentru a sprijini migrarea întreprinderilor mari, 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 mesaj ului SIP REGISTER atunci când adresa MAC nu este disponibilă în profilul dispozitivului Cisco BroadWorks. Decomentați linia USE_MAC_ADDRESS_FROM_SIP_REGISTER=Da în fișierul conf/partner.cfg
10. 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 așteptarea apelurilor, muzica în așteptare și dezactivarea setărilor T38 pentru toți utilizatorii de tip analog.

11. Dacă doriți să configurați dispozitive gateway generice, adăugați adresa MAC a dispozitivului și ID-ul de utilizator în fișierul input/genericgateways.csv. De asemenea, menționați dacă utilizatorul este proprietarul PRINCIPAL sau un utilizator PARTAJAT (pentru aparițiile apelurilor partajate). Acest lucru este necesar numai dacă administratorii parteneri intenționează să utilizeze dispozitive gateway generice în apelarea cu ridicata.

    Această caracteristică nu este disponibilă pentru migrările BroadCloud la Wholesale.

12. Pentru migrările BroadCloud, pentru a converti toți utilizatorii cu tipul de stație de mesagerie în voice_mail_group, actualizați fișierul conf/rialto_station_type_to_wholesale_package.csv înlocu ind valoarea pachetului cu ridicata cu voice_mail_group pentru rândul în care mesageria este tipul stației Rialto.

    Opțional, activați proprietatea COMMON_VOICE_MAIL_GROUP_PASSCODE în partner.cfg pentru a configura codul PIN implicit pentru grupurile de poştă vocală.

    Dacă această proprietate nu este specificată în partner.cfg, aceasta trebuie furniz ată pentru fiecare client în fișierul customers.csv sub coloana CommonVoicEmailGroupPassCode.

13. Pentru migrarea contactelor comune la Webex Calling

    Este îmbunătățirea pentru gestionarea contactelor comune la nivel de întreprindere și la nivel de site. Aceste contacte pot fi acum migrate fie ca persoane de contact ale organizației (Persoane de contact Org), fie ca extensii virtuale, pe baza setărilor de configurare. Mai jos sunt detaliile pentru a vă ghida prin acest proces de migrare.

    Configurare cheie:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      O nouă proprietate, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, este introdusă în fișierul partner.cfg. Această proprietate determină modul în care contactele comune sunt migrate de la Rialto laWebex Calling.

    • Fără COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurat

      Persoanele de contact comune vor fi migrate ca persoane de contact ale organizației (Persoane de contact ale organizației).

      Nu este necesară o configurație suplimentară.

      Contactele rămân accesibile la nivel de organizație.

    • Cu COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurat

      Contactele comune vor fi migrate ca extensii virtuale.

      Fiecare contact va fi adăugat cu un număr de extensie, iar intervalul de pornire al extensiei este definit în proprietatea COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE din partner.cfg.

      Extensiile virtuale sunt acceptate atât la nivel de organizație, cât și la nivel de locație, în funcție de domeniul de aplicare al contact ului.

14. Activați furnizorul implicit de înregistrare a apelurilor la Webex.

    Acest pas este necesar numai atunci când migrați setările de înregistrare a apelurilor pentru utilizatorii configurați cu Dubber la înregistrarea apelurilor native Cisco în Webex.

    Pentru a activa această opțiune:

    • În fișierul partner.cfg, setați următoarea proprietate, default _call_recording_vendor=WebEx.
    • În plus, utilizați proprietatea WEBEX_CALL_RECORDING_STORAGE_REGION pentru a configura regiunea de stocare.

      Opțiunea de înregistrare la cerere de la BroadCloud nu este acceptată înWebex Calling. Aceste setări de înregistrare a apelurilor nu vor migra și vor apărea în raportul de excepție.

15. Excluderea numerelor de telefon selectate din migrare:

    Pentru a exclude anumite numere de telefon din procesul de migrare, trebuie urmată următoarea procedură în doi pași utilizând instrumentul de transformare:

    • Executați inițial instrumentul de transformare pentru prima dată. După finalizare, instrumentul va genera un fișier numit telephone_numbers_inventory.csv, situat în directorul output/timestamp/. Clientul trebuie să revizuiască acest fișier și să indice „Da” în coloana „Drop Tn's” pentru fiecare număr de telefon care ar trebui exclus din migrarea viitoare.
    • După actualizarea fișierului telephone_numbers_inventory.csv cu steagurile de excludere corespunzătoare, instrumentul de transformare este executat a doua oară. Fișierul actualizat trebuie transmis ca argument în următorul format.

      . /transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers= {filepath/telephone_numbers_inventory.csv}

16. Opțional, setați proprietatea ALLOW_RESTRICT_BY_PARTNER_MODE la OFF pentru a permite administratorilor de clienți să modifice setările definite de partener în Control Hub.
17. Pentru migrarea numerelor mobile (BroadWorks Mobility) de la BroadCloud la Webex Calling

    Această secțiune prezintă migrarea funcției BroadWorks Mobility (numere de telefon mobil ale clienților) de la BroadCloud (Integrarea rețelei mobile) la comerțul cu ridicata Webex Calling (Webex Go Mobile Network Operator).

    C@@ erin țe preliminare - Înainte de a începe procesul de migrare, administratorii parteneri trebuie să contacteze echipa Cisco Account pentru a efectua configurarea furnizorului Cloud Connected PSTN (CCP) și a listei de transportatori personalizați (CCL).

    O nouă proprietate, ASSIGN_MOBILE_NUMBERS_TO_USERS, este adăugată la fișierul partner.cfg. Activați această proprietate pentru a permite atribuirea și migr area numerelor de telefon mobil către utilizatori.

    • Această caracteristică este acceptată numai pentru migrările Broadcloud către Wholesale.
    • În Wholesale Webex, utilizatorii finali pot avea fie un număr de telefon mobil, fie un număr PSTN (nu ambele), spre deosebire de BroadCloud.
    • Când un număr de telefon mobil este atribuit unui utilizator, numărul său principal PSTN devine numărul secundar (alternativ) al acestuia.
    • Numerele mobile nu pot fi migrate pentru utilizatorii care sunt convertiți în spații de lucru sau linii virtuale.
    • După ce un număr de telefon mobil este atribuit în Wholesale Webex, acesta va apărea ca activ în Control Hub. Această stare nu înseamnă că numărul este gata imediat să primească apeluri. Capacitatea de apel va fi disponibilă numai după finalizarea completă a migr ării.
    • Setările de integrare a telefonului mobil configurate de utilizatorii fin ali în Portalul utilizatorului apelant (CUP) nu sunt migrate. După migrare, când se apelează un număr de telefon, un număr de telefon mobil sau o extensie, toate dispozitivele utilizatorului vor suna.

18. Pentru a configura opţional limitele cantităţii de pachete în timpul migrării clientului, specificaţi cantitatea pentru fiecare pachet în fişierul input/package_quantity.csv. Cantitatea de pachete configurate trebuie să fie mai mare sau egală cu numărul de pachete atribuite utilizator ului/spațiului de lucru.

    Limitele cantității de pachete nu sunt acceptate momentan pentru migrările Webex pentru BroadWorks la Wholesale.

    Când rulați instrumentul de transformare, furnizați fișierul actualizat ca parametru de intrare:. <extract_zip_file>/transform.sh -extract= -packagelimits=input/package_quantity.csv .

19. Migrați site-uri de la mai mulți clienți de la Broadworks/Broadcloud la un singur client în comerțul cu ridicata Webex Calling
    • Un nou mod de rulare, -ConsolidatedMigration, este introdus în instrumentul Transform pentru a sprijini migrarea mai multor site-uri clienți de la Broadcloud/Broadworks la platforma Webex Wholesale sub o singură organizație de clienți cu ridicata. Când acest mod este activat, instrumentul consolidează mai multe site-uri ale clienților într-o organizație de clienți angro

      -consolidatedMigration

    • Există și alte argumente opționale care pot fi date împreună cu -ConsolidatedMigration, cum ar fi

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • dacă se dă -TargetEnterpriseID și ID-ul există în fișierul de ieșire al instrumentului Extract, atunci acesta va fi utilizat pentru a crea organizația clienților cu ridicata și dacă Id nu este găsit, instrumentul va reveni pentru a utiliza orice detalii disponibile despre client din fișierul de ieșire al instrum entului Extract.
    • dacă se dă -ConsolidateDexternalId, acesta va seta externalID pentru client și dacă nu este dat, instrumentul va reveni pentru a utiliza fluxul existent pentru Id extern.
    • <timestamp>Un fișier JSON consolidat (customer.json) va fi disponibil în directorul output/consolidat.

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

Completarea 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 pentru a rula

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

ferestre

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

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

MacOS

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

1. Creați un mediu virtual și instalați dependențe 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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Verificare prealabilă client/utilizator

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 e-mailul principal. Dacă valoarea PROVISIONING_ID este specificată în fișierul conf/partner.cfg, acesta va valida și informațiile despre locație. Rezultatele verificării prealabile sunt incluse în raportul de excepție.

În plus, următorii parametri opționali pot fi adăugați atunci când rulați instrumentul de transformare:

verificare prealabilă

Pe lângă rularea API-ului de verificare prealabilă pentru informațiile despre clienți, Instrumentul de transformare va rula, de asemenea, API-ul de preverificare pentru e-mailurile abonatului.

precheckinfo

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

Jurnalele terminalelor

Următoarele jurnale în terminal la transformarea cu succes:

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 Transform generează raportul de excepție în <timestamp>directorul output/ /exception_report.txt. Puteți utiliza acest raport pentru a identifica problemele care vor afecta migrarea și pentru a le remedia în sistemul Cisco BroadWorks.

După modificarea datelor utilizatorului pentru a rezolva excepția, rulați din nou Instrumentele de extragere și transform are cu noile date. Exemplul de fișier raport de excepție după cum urmează:

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

<timestamp><groupid>Un fișier JSON de ieșire (customer.json) va fi disponibil în directorul output//. Exemplul fișierului customer.json este după cum urmează:

{
    "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 aprovizionare poate rula pe orice mașină, de obicei (laptopul administratorului partenerului) și utilizează API-urile publice Webex. Citește fișierul JSON (customer.json) de ieșire al instrumentului de transformare 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 instrumentelor de aprovizionare:

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 binarelor Instrumente de migrare, setați variabila de mediu JAVA_HOME în provisioning_tool.sh pentru MAC și provisioning_tool.bat pentru Windows.
3. Fișierul partner.cfg:
   • Setați WHOLESALE_PROVISIONING_ID și REFRESH_TOKEN (Token copiat din instrumentul Generator de jetoane). Administratorii parteneri trebuie să contacteze echipa de cont pentru a obține PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Setați SEND_SUBSCRIBERS_WELCOME_EMAIL la false, dacă partenerii nu doresc să trimită un e-mail de bun venit utilizatorilor. Valoarea implicită este adevărată.

     Webex trimite e-mailuri de bun venit numai utilizatorilor finali. Administratorii de clienți nu primesc e-mailuri de bun venit.

     Utilizatorii și administratorii clienților din locațiile din SUA și Canada primesc o notificare separată prin e-mail de la RedSky. Platforma RedSky E911 trimite acest e-mail pentru a confirma crearea contului de client pentru serviciile de urgență. Acest e-mail RedSky este separat de e-mailurile de bun venit Webex și nu este controlat de setările de e-mail Webex. Pentru organizațiile en-gros din SUA și Canada, RedSky este activat automat ca furnizor de servicii de urgență.

4. Utilizați proprietatea WEBEX4BWKS_EMAIL_SUBJECT pentru migrările Webex pentru BroadWorks pentru a trimite subiectul de e-mail al solicitării de modificare a parolei pentru abonații Webex pentru BroadWorks.
5. Utilizați proprietatea WEBEX4BWKS_EMAIL_BODY pentru migrările Webex pentru BroadWorks pentru a trimite corpul de e-mail al solicitării de modificare a parolei pentru abonații Webex pentru BroadWorks.
6. Utilizați proprietatea C USTOM_TAGS pentru a adăuga etichete după crearea clientului.
7. Pentru a aplica reduceri cu ridicata, administratorii parteneri trebuie să contacteze echipa de cont Cisco înainte de a începe migrarea.

   O nouă proprietate, APPLY_WHOLESALE_DISCOUNTS este adăugată la partner.cfg. Activați această proprietate pentru a aplica reduceri utilizatorilor și spațiilor de lucru.

8. (Opțional) Configurați explicit conexiunea PSTN

   Pentru a specifica conexiunea PSTN pentru toate locațiile furnizate în timpul migr ării, inclusiv locația principală, adăugați următoarea proprietate în fișierul partner.cfg:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Dacă proprietatea nu este configurată sau este comentată, instrumentul de aprovizionare utilizează procesul implicit de selectare a conexiunii PSTN.

Instrucțiuni pentru a rula

Utilizați următorii pași pentru a rula instrumentul în Windows și macOS:

ferestre

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

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

MacOS

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

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Cerințe preliminare pentru migrarea Webex pentru BroadWorks

Administratorii parteneri trebuie să își actualizeze șablonul de integrare BroadWorks pentru caracteristicile de coexistență Webex pentru Broad Works. Consultați următoarea imagine:

Odată ce șablonul de Onboarding Webex pentru BroadWorks este actualizat pentru a sprijini migrarea, solicitați echipei de cont Cisco să activeze comutarea funcției „angros-partener-mixing-enabled” la nivel de partener. Această setare permite instrum entului de furnizare să adauge automat pachete en-gros la clienții Webex pentru BroadWorks existenți în timpul furnizării.

Rulați instrumentul de aprovizionare cu un argument suplimentar.

Faza de pregătire: este faza implicită în care Administrat orii pot furniza utilizatorii BroadWorks ca abonat en-gros și pot continua cu Webex pentru utilizatorii BroadWorks.

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

F@@ aza post-migr are: Este faza finală în care administratorii pot converti complet BroadWorks în comerț cu ridicata. Trebuie să rulați instrumentul de aprovizionare cu un argument post migrare.

Jurnalele terminalelor

Următoarele sunt jurnalele din terminal cu privire la furnizarea cu succes:

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

Va fi tipărit un tabel cu numărul de locații create pentru fiecare rulare:

Ieșire

Instrumentul de furnizare generează rapoarte de succes și de eroare în fișierele de ieșire// *.success/ <external_id>eroare. Examinați succesul ieșirilor și jurnalele de eroare pentru a verifica aprovizionarea cu succes.

Sistemul va genera un fișier Provisioning_report_*.csv în directorul output/consolidated_report s/. Acest fișier conține atât detalii despre succes, cât și despre eșec pentru fiecare entitate și setările acesteia, oferind un raport cuprinzător de aprovizionare.

Instrumentul de furnizare generează, de asemenea, un fișier Provisioning_statistics_*.csv în directorul output/consolidated_reports/. Acest raport conține numărul clienților, loc ațiilor, utilizatorilor, dispozitivelor și caracteristicilor de grup furnizate cu succes și fără succes.

Administratorii partenerilor pot verifica provizionarea clienților în portalul Hub Partner și Control Hub. Consultaţi următoarele ilustraţii din portalul Hub Partner Hub şi Control Hub:

Figura 8: Hub pentru parteneri

Figura 9: Hub de control

Figura 10: Dispozitive

Figura 11: Apelare

Restricții post-provizionare

După finalizarea proviziunii pentru o migrare BroadCloud, următoarele acțiuni vor fi blocate:

• CAP Portal — Adăugarea de utilizatori sau dispozitive portate.
• SP Portal — Crearea comenzilor ADD cu dispozitive sau numere.
• RSB API - Crearea comenzilor ADD cu dispozitive sau numere și crearea de utilizatori. Comenzile RSB ADD efectuate cu dispozitive sau numere vor fi respinse.

Migrarea BroadCloud către angro - Limitarea înregistrării dispozitivului

Pentru administratorii parteneri care migrează clienți de la BroadCloud la Wholesale în aceeași regiune, dispozitivele pot fi adăugate în comerțul cu ridicata după rularea instrumentului de aprovizionare. Cu toate acestea, aceste dispozitive vor deveni eligibile pentru a se înregistra pe platforma Webex numai după ce migrarea (mutarea dispozitivului) pentru locația corespunzătoare a fost finalizată.

Această limitare nu se aplică:

• Clienții care migrează de la Broadworks/W4b la Wholesale.
• Migrări BroadCloud către angro în diferite regiuni.

Ghid recomandat

Pentru a evita problemele de înregistrare a dispozitivului, finalizați migrarea mutării dispozitivului la nivel de locație înainte de a încerca să înregistrați dispozitive pe platforma Webex pentru migrările BroadCloud în aceeași regiune.

Pentru BroadCloud

Pentru partenerii BroadCloud, utilizați portalul furniz orului de servicii pentru a trimite o solicitare de migrare pentru numere, dispozitive și migrări privind aparițiile apel urilor partajate (SCA).

În cadrul portalului furnizorului de servicii, o solicitare de migrare poate include până la 50 de clienți. Pot fi depuse maximum 10 cereri în decurs de o zi.

Administratorii pot activa returnarea automată setând rollback_to_broadcloud=true în fișierul conf/partner.cfg, care mută dispozitivele înapoi la BroadCloud după migrare. Acceptă atât migrări în aceeași regiune, cât și în diferite regiuni cu NS Sync, dar numai pentru migrări de succes. Pentru cele eșuate, administratorii trebuie să ridice un Cisco TAC înainte de a solicita revocarea.

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

• Migr are — Selectați această opțiune pentru a iniția o solicitare de migrare a numerelor, a dispoziti velor și a aparițiilor apelurilor partajate (SCA).
• Starea dispozitivului — Selectați această opțiune pentru a vizualiza starea curentă a unui dispozitiv pe BroadCloud și Apelare.

Următoarele cifre prezintă portalul furnizorului de servicii.

Figura 12: Portalul furnizorilor de servicii

Figura 13: Portalul furnizorilor de servicii

Migr area 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 împreună cu solicitarea dvs. Acest CSV ar trebui să listeze numai 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 → Selectați un client → Exportați locațiile ca CSV.

Figura 14: Exportați locațiile ca CSV

Activați opțiunea de deconectare a numerelor

Când utilizați același trunchi SIP pentru Webex Calling și BroadCloud Carrier, administratorii ar trebui să utilizeze opțiunea Dis connect Numbers. Aceasta elimină numerele de telefon de la primirea apelurilor primite după migrarea în BroadCloud.

Pentru a activa această opțiune,

1. În fișierul partner.cfg, setați DISCONNECT_NUMBERS_FROM_RIALTO = da.
2. Rulați din nou instrumentul de migrare utilizând același fișier customer.json și partner.cfg actualizat.

Dacă numerele nu se deconectează, ridicați o solicitare Cisco TAC.

Pentru Cisco BroadWorks și Webex pentru BroadWorks

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

La funcționarea cu succes, instrumentul de mutare a dispozitivului va:

1. Anulați dispozitivele din Cisco BroadWorks și înregistrați-le în comerțul cu ridicata.
2. Utilizatorii care utilizează clientul UC-One vor redirecționa către aplicația Webex la prima conectare.
3. Dezactivați numerele de telefon de la Cisco BroadWorks sau eliminați numerele de telefon din BroadCloud.
4. Activați numerele în comerțul cu ridicata.
5. Creați apariții de apeluri partajate în comerțul cu ridicata pentru migrările BroadCloud. [Acest pas este aplicabil numai pentru migrările BroadCloud].

6. Dacă administratorul operează instrumentul din spatele unui proxy corporativ, urmați pașii de mai jos pentru a configura și executa scriptul de furnizare.

   Procedura de configurare

   1. Deschideți fișierul devicemove.sh.
   2. Localizați variabila PROXY_HOST și dezcomentați-o (eliminați # principal pentru devicemove.sh).

   3. Setați valoarea PROXY_HOST ca:

      PROXY_HOST=<proxy-host>

   4. Localizați variabila PROXY_PORT și dezcomentați-o (eliminați # principal pentru devicemove.sh).

   5. Setați valoarea PROXY_PORT ca:

      PROXY_PORT=<proxy-port>

   6. Vă rugăm să localizați variabila PROXY_SCHEME și să o dezcomentați (eliminați # principal pentru devicemove.sh). Acest pas este opțional; dacă rămâne comentat, valoarea implicită pentru PROXY_SCHEME va fi HTTP.

   7. Setați valoarea PROXY_SCHEME ca:

      PROXY_SCHEME=<proxy-scheme>

   8. Salvați și închideți fișierul devicemove.sh.
   9. Deschideți fișierul partner.cfg și adăugați tokenul de refresh necesar.
   10. Verificați dacă gazda BroadWorks, numele de utilizator și parola sunt configurate corect în partner.cfg

   11. Rulați scriptul:

       ./devicemove.sh

SCP și SSH

1. SCP instrumentul de mutare a dispozitivului la serverul secundar de aplicații Cisco BroadWorks.
2. SSH către serverul secundar de aplicații Cisco BroadWorks pentru a configura condițiile preliminare și a rula instrumentul de mutare a dispozitivului.

Cerințe preliminare

1. Setați REFRESH_TOKEN (Token copiat din instrumentul Generator Token) în fișierul conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Asigurați-vă că ID-ul de utilizator secundar al serverului de aplicații Cisco BroadWorks, parola și numele gazdei sunt corecte în fișierul conf/ DeviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Pentru a retrimite e-mailurile de activare, trebuie să setați send_subscribers_welcome_email=true în fișierul conf/partner.cfg.

   Dacă administratorii doresc să trimită e-mailuri de invitație utilizatorilor lor în timpul migrării, aceștia ar trebui să anuleze comentariul proprietății „send_subscribers_welcome_email=true” din fișierul conf/partner.cfg. În caz contrar, proprietatea ar trebui să rămână neschimbată.

4. Verificați dacă calea mediului JDK/JRE 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 apelare cu ridicata, un administrator partener trebuie să creeze un nou fișier tip de profil de identitate/dispozitiv 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 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 dvs.).

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 dispozitivului la nivel de grup sau dispozitiv.
   Acționarea la nivel de grup sau la nivel de dispozitiv depinde de configurația parametrului DeviceLevelRebuild în fișierul device-move-tool/conf/partner.cfg.
3. Instrumentul de mutare a dispozitivului 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ă% BWMACAddress%.cfg, care solicită telefoanelor Polycom să descarce și să proceseze Migration_%BWMACAddress%.cfg, care 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ă %BWMACAddress%.cfg de la https://plcm.sipflash.com și va fi gestionat de DMS. Webex Calling

Figura 14: Adăugare fișier tip profil de identitate/dispozitiv

Instrucțiuni pentru a rula

Există două metode de a invoca DMT, prima este de a invoca printr-un singur client la un moment dat și cealaltă este de a trece prin mai mulți clienți simultan.

Instrumentul de mutare a dispozitivului este rulat din serverul secundar de aplicații Cisco BroadWorks din directorul instrumentului de mutare a dispozitivului:

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Jurnalele terminalelor

Următoarele sunt jurnalele din terminal la rularea cu succes a instrumentului de mutare a dispozitivului pentru migrarea dispozitivului:

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 dispozitivului, dispozitivele au intrat online și sunt gata să efectueze/primească apeluri. Consultați figura 15 pentru a vedea un exemplu de stare a dispozitivului :

Figura 15: Starea dispozitivului

După migrarea dispozitivului, numerele au devenit active. Consultați figura 16 pentru a vedea un exemplu despre ce numere sunt active:

Figura 16: Numere active

Dacă administratorul operează instrumentul din spatele unui proxy corporativ, urmați pașii de mai jos pentru a configura și executa scrip tul devicemove.

Pași pentru configurarea și executarea scriptului devicemove

1. Deschideți fișierul devicemove.sh.
2. Localizați variabila HTTPS_PROXY_HOST și dezcomentați-o (eliminați primul #).

3. Setați valoarea HTTPS_PROXY_HOST ca:

   HTTPS_PROXY_HOST=<proxy-host>

4. Localizați variabila HTTPS_PROXY_PORT și dezcomentați-o (eliminați primul #).
5. Setați valoarea HTTPS_PROXY_PORT ca:

   HTTPS_PROXY_PORT=<proxy-port>

6. Salvați și închideți fișierul devicemove.sh.
7. Deschideți fișierul partner.cfg și adăugați tokenul de refresh necesar.
8. Verificați dacă gazda BroadWorks, numele de utilizator și parola sunt configurate corect în partner.cfg.
9. Rulați scriptul:

   ./devicemove.sh

Operațiunea de returnare trebuie executată pentru o întreprindere la un moment dat.

Pentru BroadCloud Carrier

Administratorii pot seta rollback_to_broadcloud= true în conf/partner.cfg pentru a activa returnarea automată. Aceasta returnează dispozitivele la BroadCloud după migrarea cu succes în aceeași regiune sau în mai multe regiuni cu NS Sync. Pentru migrări nereușite, contactați Cisco TAC înainte de a solicita returnarea.

Pentru Cisco BroadWorks și Webex pentru BroadWorks

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

1. Deschideți un bilet cu Cisco TAC pentru a solicita returnarea dispozitivului.
2. Rulați instrumentul de mutare a dispozitivului în modul de revenire pe serverul de aplicații BroadWorks secundar pentru a reveni la migrările dispozitivului. 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. Webex CallingEchipa setează adresa URL DMS înapoi la adresa URL DMS a furnizorului de servicii în profilurile dispozitivului din. Webex Calling
4. Administratorii parteneri trebuie să dezactiveze sau să şteargă numerele de telefon din portalul Webex Calling prin Control Hub.
5. Administratorii parteneri trebuie să mute numerele de telefon PSTN înapoi la Cisco BroadWorks.

Instrucțiuni pentru a rula instrumentul 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:

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

Reveniți profilurile

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

Reveniți numerele

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

Jurnalele terminalelor

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

Reveniți profilurile

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 numerele

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