Telefoanele acceptate vor fi create și atribuite automat utilizatorilor în Webex Calling de către instrumentul de configurare. Telefoanele marcate „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 atunci când instrumentul de mutare a dispozitivului este rulat. Telefoanele marcate „Nu” în coloana respectivă necesită o intervenție manuală pentru a schimba URL-ul DMS în șablonul de dispozitiv Cisco BroadWorks sau în telefon.

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

Administratorii parteneri rulează acest instrument de utilitate al generatorului de tokenuri cel puțin o dată înainte de a începe să ruleze instrumentele de migrare. Rularea acestui instrument este o activitate unică după ce contul partenerului este integrat în soluția RTM angro. Acest instrument permite administratorilor partenerilor să se conecteze prin intermediul browserului web pentru a obține TOKENUL unic necesar pentru actualizarea fișierelor de configurare a partenerilor pentru instrumentele de migrare.

Cerințe preliminare

După descărcare, extrageți binarele instrumentului de migrare.

Setați calea de mediu JRE/JDK în token_generator.sh pentru MAC și token_generator.bat pentru Windows. Dacă calea HOME JAVA_există deja, va fi reutilizată de instrument.

• MAC: JAVA_HOME="/UTILIZATORI/cisco/jdk/zulu@1.8.282/Contents/Home/"

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

Instrucțiuni pentru rulare

Executați următoarea comandă în terminal, în directorul generatorului de tokenuri:

Windows:

token_generator.băţ

MacOS:

./token_generator.sh

Ieșire:

Nume unealtă: Versiune instrument generator de token: 1.13.0 Încărcați URL-ul în browserul dvs. web: http://localhost:8080 

Deschideți URL-ul în browserul web din terminal, conectați-vă cu acreditările administratorului partenerului pentru a obține TOKENUL și a-l copia 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: Fereastră cu detalii de autentificare

Figura 5: Generarea tokenului

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

Activați conectivitatea OCI-P

Instrumentul de mutare a dispozitivului comunică cu BroadWorks prin comenzile 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.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Executați următoarea comandă în CLI pentru a obține GeneralSettings actuale:

AS_CLI/Applications/OpenClientServer/GeneralSettings> obțineți clientPort = 2208 clientPortEnabled = true secureClientPort = 2209 secureClientPortEnabled = true systemDomain = <> 

Dacă setările dvs. nu corespund celor de mai sus, utilizați comanda setare pentru a vă reconfigura setările.

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

Schimbați directorul în proxy OCI:

AS_CLI> cd /Aplicații/OpenClientServer/OCIProxy

Rulați următorul 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 dvs. nu corespund celor de mai sus, utilizați comanda setare pentru a vă reconfigura setările.

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

Modificați la directorul de configurare:

AS_CLI> cd/System/NetworkAccessLists/OCI/Provisioning

Executați următoarea comandă pentru a obține setările actuale de asigurare a accesului OCI:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> obțineți descrierea adresei ======================== 127.0.0.1 la nivel local ca 

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

 AS_CLI/Maintenance/ManagedObjects> obțineți Broadworks și verificați dacă rezultatul arată OK. Consultați mai jos pentru eșantionul de ieșire: AS_CLI/Maintenance/ManagedObjects> obțineți obiecte gestionate de BroadWorks ========================== * Server: Identitate..............: CA Versiune...............: Rel_21.sp1_1.551 Stare administrativă..: Aplicații deblocate *: Nume Versiune Stare administrativă implementată Stare efectivă ========================================================================================= execuţie şi asigurare acces 21.sp1_1.551 reală deblocată FlashPolicy 21.sp1_1.551 falsă deblocată oprită OpenClientServer 21.sp1_1.551 reală deblocată WebContainer 21.sp1_1.551 reală deblocată Deblocată 4 intrări găsite. * Aplicaţii găzduite: Nume Versiune 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 intrări găsite. 

Verificați serverul client deschis implementat și activ

Utilizați comenzile de mai jos pentru a implementa și porni serverul client deschis pe serverul de aplicații secundar dacă nu este implementat sau nu a început deja.

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

AS_CLI/Maintenance/ManagedObjects> implementați aplicația OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> porniți aplicația OpenClientServer

Activați activarea numerelor

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

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

AS_CLI> setați dnMode groupAndUserActivationEnabled

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

Pentru BroadCloud

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

1. Trimiteți solicitări de extras pentru până la 50 de clienți per solicitare.
   Solicitarea de extras nu poate fi trimisă pentru același client de mai mult de 10 ori pe zi.
2. Descărcați fișierul de date extrase, în format ZIP, timp de până la 28 de zile de la data trimiterii cererii.

Cifrele de mai jos prezintă portalul furnizorului de servicii.

Figura 6: Portalul furnizorului de servicii

Figura 7: Portalul furnizorului de servicii

Pentru Cisco BroadWorks și Webex pentru BroadWorks

1. Instrumentul de extragere rulează pe serverul de aplicații secundar Cisco BroadWorks din rețeaua partenerului și se conectează prin OCI-P.
2. Instrumentul extrage datele brute ale întreprinderii, grupului, numerelor, utilizatorilor, serviciilor, dispozitivelor și clienților software de pe platforma Cisco BroadWorks sau BroadCloud și scoate 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 extragere.

Cerințe preliminare

1. SCP binare instrument de extragere către serverul de aplicații secundar Cisco BroadWorks.
2. SSH la serverul de aplicații secundar Cisco BroadWorks pentru a configura cerințele preliminare și a rula instrumentul de extragere.
3. Configurați furnizorul de servicii și ID-ul grupului pentru a fi extras din Cisco BroadWorks în conf/exportTool.yml. Consultați fragmentul YAML de mai jos:

   ID-A furnizor de servicii:      - GrupID-A1 - GrupID-A2 - GrupID-A3 FurnizorID-B:                        - toți 

4. Asigurați-vă că ID-ul de utilizator, parola și numele gazdei secundare serverului de aplicații Cisco BroadWorks sunt corecte în fișierul conf/partner.cfg:

   BROADWORKS_USER_ = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = local host REFRESH TOKEN_ = Token de reîmprospătare al administratorului partenerului copiat din instrumentul Generator de tokenuri. MODUL_MIGRARE = Valorile acceptate sunt webex_for_broadworks_to_wholesale. Valoarea implicită este broadworks_to_wholesale. Utilizați webex_for_broadworks_to_wholesale pentru migrările Webex pentru BroadWorks. 

   Proprietatea REÎMPROSPĂTARE_TOKEN este obligatorie pentru migrarea Webex for BroadWorks.

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

   JAVA_HOME=/usr/local/java/java_base

Instrucțiuni pentru rulare

Executați comanda de mai jos, în serverul secundar de aplicații Cisco BroadWorks, din directorul instrumentului de extragere:

./export.sh

Jurnale terminal

Următoarele jurnale sunt disponibile în terminal la exportul reușit: Se rulează instrumentul de export de date BroadSoft:

 Rularea instrumentului de export de date BroadSoft ************************************************ Pornirea instrumentului de export v: 1.15.0 Export început pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export utilizatori finalizat pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export utilizatori finalizat pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export finalizat pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export finalizat Export Dump Zip Directory: output/20221017223452_ExportTool Export Dump Fişier Zip:extracted_data_1666060Fișierul Zip 500618.zip cu numele extracted_data_1666060500618.zip a fost creat procesul de creare a fișierului ZIP finalizat Fișierele exportate convertite ca fișier ZIP ************************************************** 

Ieşire

Un fișier ZIP de ieșire (extracted_data_.zip) va fi disponibil în același director de instrumente de extragere. Utilizați comanda de mai jos 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 ieșire/ drwxrwxr-x 2 bwadmin bwadmin 4096 oct 17 22:34 jurnale/ -rw-rw-r-- 1 bwadmin bwadmin 46341 oct 17 22:35 extracted_data_1666060500618.zip 

Acest instrument de transformare este rulat pentru toate migrările. Instrumentul de transformare rulează pe orice computer, inclusiv laptopul administratorului unui partener și utilizează API-urile publice Webex. Acesta citește fișierul ZIP de ieșire al instrumentului de extras (extracted_data_.zip) ca intrare și transformă XML-ul brut într-un format JSON utilizat de instrumentul de asigurare a accesului.

Cerințe preliminare

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

1. Setați tokenul DE REÎMPROSPĂTARE_ (token copiat din instrumentul Generator de tokenuri) și NUMELE_LOCAȚIEI_PRINCIPALE_ în fișierul conf/partner.cfg:

   REÎMPROSPĂTARE_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main 

2. Setați opțional ID-ul de ASIGURARE a accesului_ (copiat din șablonul din Partner Hub) în fișierul conf/partner.cfg:

   ASIGURARE ACCES_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pentru a obține o verificare mai completă a adresei de e-mail a clientului, puteți seta opțional ID-ul de CONFIGURARE_.
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ă se configureze telefoane noi, adăugați adresa mac și adresa de e-mail a noului telefon al utilizatorului la fișierul input/newphones.csv. Acest lucru este necesar numai dacă administratorii parteneri doresc să configureze telefoane noi în apelarea en-gros.
6. Convertiți centrele de apeluri BroadWorks în CxEssentials cu fișierul intrare/cxessentials.csv.
7. Aveți și opțiunea de a activa UPGRADE_TOATE_CALL_CENTER_LA_CX_ESSENTIALS pentru a converti toate Call Center în CxEssentials.
8. Utilizați fișierul input/locations.csv pentru a accepta migrarea la scară largă a întreprinderii, care permite administratorilor să migreze locațiile clienților lor în funcție de locație
9. Activați opțional utilizarea adreselor MAC din antetul Agent utilizator al mesajului ÎNREGISTRARE SIP atunci când adresa MAC nu este disponibilă în profilul dispozitivului Cisco BroadWorks. Decomentați linia „UTILIZARE ADRESĂ_MAC__DE LA_SIP_REGISTER=yes” din fișierul conf/partner.cfg

Se completează datele introduse/customers.csv

Fișierul input/customers.csv furnizează date care pot lipsi în Cisco BroadWorks sau BroadCloud. Acest fișier poate rămâne necompletat 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.

Instrucțiuni pentru rulare

Rulați instrumentul de transformare în orice sistem de operare. Utilizaț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țe pentru a rula instrumentul de transformare, utilizând Python:

   python3 -m venv venv sursă venv/bin/activați python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. Rulați instrumentul de transformare:

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

Verificare prealabilă client/utilizator

Instrumentul de transformare efectuează apeluri API către Webex pentru a detecta eventualele probleme de asigurare a accesului. În mod implicit, aceasta va valida adresa clientului și adresa principală de e-mail. Dacă valoarea ID-ului de ASIGURARE a accesului_este specificată în fișierul conf/partner.cfg, acesta va valida, de asemenea, informații despre locație. Rezultatele verificărilor prealabile sunt incluse în raportul de excepție.

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

verificare prealabilă

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

informații verificare prealabilă

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

Jurnale terminal

Următoarele jurnale în terminal la transformarea reușită:

Raport rezumat privind întreprinderile BroadWorks care pot fi migrate cu succes: 1 Întreprinderi BroadWorks care nu pot fi migrate: 0 utilizatori BroadWorks care pot fi migrați cu succes: 4 utilizatori BroadWorks care nu pot fi migrați: 0 Telefoane care pot fi migrate cu succes: 3 Telefoane care nu sunt compatibile cu Webex Calling: 0 

Raport de excepție

Instrumentul Transformare generează raportul de excepție în interiorul directorului output//exception_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 raportului de excepție eșantion este următorul:

Raport excepție 18 oct. 08:12:09 2022 Întreprinderi cu Recomandare privind funcția de interzicere a comunicațiilor: configurați manual Planul de apeluri de ieșire în Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Ieşire

Un JSON de ieșire (customer.json) fișierul va fi disponibil în ieșire// director. Fișierul eșantion customer.json este următorul:

{ "customer": { "provisioningId": "!!!!!!!!!!ÎNLOCUIȚI_cu_Provisioningid!!!!!!!!!!", „pachete”: [ "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", "limbă": "en_us", "numere": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+152055511107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "abonați": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_cu_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/mesagerie vocală": { "enabled": adevărat, „sendBusyCalls”: { „activat”: adevărat, „salut”: „IMPLICIT” }, „trimitereApeluriFără răspuns”: { „activat”: adevărat, „salut”: „IMPLICIT”, „numberOfRings”: 3 }, „messageStorage”: { „mwiEnabled”: adevărat, "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": adevărat, „sendBusyCalls”: { „activat”: adevărat, „salut”: „IMPLICIT” }, „trimitereApeluriFără răspuns”: { „activat”: adevărat, „salut”: „IMPLICIT”, „numberOfRings”: 3 }, „messageStorage”: { „mwiEnabled”: adevărat, "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": adevărat, „sendBusyCalls”: { „activat”: adevărat, „salut”: „IMPLICIT” }, „trimitereApeluriFără răspuns”: { „activat”: adevărat, „salut”: „IMPLICIT”, „numberOfRings”: 3 }, „messageStorage”: { „mwiEnabled”: adevărat, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ÎNLOCUIȚI_CU_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": adevărat, „sendBusyCalls”: { „activat”: adevărat, „salut”: „IMPLICIT” }, „trimitereApeluriFără răspuns”: { „activat”: adevărat, „salut”: „IMPLICIT”, „numberOfRings”: 3 }, „messageStorage”: { „mwiEnabled”: true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_cu_PERSONID!!!!!!!!!!", "produs": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "programări": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Portal de voce automat", "prenume": "Automat", "numeNume": "Portal de voce", "CodLimbă": "en_us", "phoneNumber": "+15205551105", "extensie": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "locații": [], "webex_for_broadworks_info": { "utilizatori": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Instrumentul de asigurare a accesului poate rula pe orice mașină, de obicei (laptopul administratorului partenerului) și poate utiliza API-urile publice Webex. Acesta citește fișierul JSON (customer.json) de ieșire instrument de transformare ca intrare și configurare a clienților, locațiilor, numerelor, utilizatorilor, serviciilor și dispozitivelor în soluția Webex Wholesale RTM.

Cerințe preliminare

Configurați următoarele cerințe preliminare în directorul instrumentului de asigurare a accesului:

1. Instalați Java 8, 11 sau 17 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://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. După descărcarea și extragerea binarelor instrumentelor de migrare, setați variabila de mediu JAVA_ACASĂ în provisioning_tool.sh pentru MAC și provisioning_tool.bat pentru Windows.
3. Fișierul partner.cfg:
   • Setați ID-ul de _ASIGURARE A ACCESULUI_EN-GROS și REÎMPROSPĂTAȚI TOKENUL_ (token copiat din instrumentul Generator de tokenuri). Administratorii parteneri trebuie să își contacteze echipa de cont pentru a obține ID-ul de CONFIGURARE_:

     ID_FURNIZARE EN-GROS_ = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REÎMPROSPĂTARE_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Setați opțiunea PERMITEȚI_ADMINISTRATORULUI_INVITAREA_E-MAILURILOR la valoarea fals în cazul în care partenerul nu dorește să trimită un e-mail de bun venit utilizatorilor. Valoarea implicită este Adevărat.

4. Utilizați proprietatea de SUBIECT WEBEX4BWKS_E-MAIL_ 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 CORPULUI WEBEX4BWKS_E-MAIL_ 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.

Pentru migrările BroadCloud, aceeași regiune:

1. Instrumentul omite configurarea numerelor, dispozitivelor și aparențelor de apel partajat.
2. Instrumentul creează utilizatori și utilizatori virtuali cu extensie și extensie temporară.

Pentru migrările BroadCloud, o altă regiune:

1. Instrumentul va configura numere, dispozitive și apariții apel partajat.
2. Instrumentul creează utilizatori și utilizatori virtuali cu numere de telefon reale și extensie.
   Toate migrările BroadCloud din Europa sunt către o altă regiune.

Instrucțiuni pentru rulare

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

Windows

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

Pentru a configura un singur client: provision.bat -input= Pentru a configura mai mulți clienți: provision.bat -input= 

Sistem de operare Mac

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

Pentru a configura un singur client: ./transform.sh -input= Pentru a configura mai mulți clienți: ./transform.sh -input= 

Cerințe preliminare pentru migrarea Webex pentru BroadWorks

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

După actualizarea șablonului Webex for BroadWorks Onboarding pentru a sprijini migrarea, solicitați echipei de conturi Cisco să activeze comutatorul de funcție „wholesale-partner-blending-enabled” la nivel de partener. Acest lucru va permite ca pachetele angro să fie adăugate la organizațiile existente de clienți Webex for BroadWorks în timpul setării.

Rulați instrumentul de asigurare a accesului cu un argument suplimentar.

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

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

Faza postmigrare: Este etapa finală atunci când administratorii pot converti complet BroadWorks în Wholesale. Trebuie să rulați instrumentul de asigurare a accesului cu un argument postmigrare.

Jurnale terminal

Mai jos sunt jurnalele din terminal la setarea reușită:

Nume unealtă: Versiunea instrumentului de configurare: 1.15.0 ********** Procesarea fișierului a început: input/customer.json **************** Client de configurare Se așteaptă ca clientul external_id_engg_grp1 să finalizeze configurarea... Se așteaptă ca clientul external_id_engg_grp1 să finalizeze configurarea...   Stare client external_id_engg_grp1: Numere de configurare Utilizatori Caracteristici de utilizator Configurare Felicitări Programe de configurare Dispozitive de configurare Apariții de apeluri partajate Configurare Operatori automați Configurarea cozilor de apeluri Configurarea grupurilor de hunt Setarea grupurilor de paginare Setarea parcurilor de apeluri Setarea preluărilor apelurilor Setarea portalului de voce ********** Fișier finalizat: intrare/client.json **************** 

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

Ieşire

Instrumentul de configurare generează rapoarte de succes și erori în fișierele output/<external_id>/*.success/error . Revizuiți jurnalele de ieșire și erorile pentru a verifica configurarea reușită.

Administratorii parteneri pot verifica asigurarea accesului clienților în Partner Hub și în portalul Control Hub. Consultați următoarele ilustrații din portalul Partner Hub și Control Hub:

Figura 8: Hub partener

Figura 9: Control Hub

Figura 10: Dispozitive

Figura 11: Calling

Pentru BroadCloud

Pentru partenerii BroadCloud, utilizați portalul furnizorului de servicii pentru a trimite o solicitare de migrare a numerelor, dispozitivelor și migrărilor SCA.

În portalul furnizorului de servicii, o solicitare de migrare poate include până la 50 de clienți. În decurs de o zi se pot depune maximum 10 solicitări.

Cifrele de mai jos prezintă portalul furnizorului de servicii.

Figura 12: Portalul furnizorului de servicii

Figura 13: Portalul furnizorului de servicii

Pentru Cisco BroadWorks și Webex pentru BroadWorks

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

La funcționarea reușită, instrumentul de mutare a dispozitivului va:

1. Anulați înregistrarea dispozitivelor de la 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. Activați numerele în Wholesale.
5. Creați apariții apeluri partajate în comerț angro pentru migrările BroadCloud. [Acest pas se aplică numai pentru migrările BroadCloud].

SCP și SSH

1. SCP instrumentul de mutare a dispozitivului pe serverul de aplicații secundar Cisco BroadWorks.
2. SSH la serverul de aplicații secundar Cisco BroadWorks pentru a configura cerințele preliminare și a rula instrumentul de mutare a dispozitivului.

Cerințe preliminare

1. Setați tokenul DE REÎMPROSPĂTARE_ (token copiat din instrumentul Generator de tokenuri) în fișierul conf/partner.cfg:

   REÎMPROSPĂTARE_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_UTILIZATOR_ = admin BROADWORKS_PAROLĂ = admin BROADWORKS_GAZDĂ_NUME = local host 

3. Pentru a retrimite e-mailuri de activare, trebuie să setați RETRIMITERE_E-MAILURI DE INVITAȚIE_=true în fișierul conf/partner.cfg.

   Dacă administratorii doresc să trimită e-mailuri de invitație utilizatorilor în timpul migrării, trebuie să decomenteze proprietatea „RETRIMITERE_E-MAILURI INVITAȚIE_=true” din fișierul conf/partner.cfg. În caz contrar, proprietatea ar trebui să rămână neschimbată.

4. Verificați dacă calea de mediu 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 anumite grupuri în loc de toate grupurile dintr-o întreprindere.

Telefoane Polycom

Pentru a muta telefoanele Polycom de la Cisco BroadWorks la apelarea angro, un administrator partener trebuie să creeze un nou fișier de tip identitate/profil dispozitiv la nivel de sistem în Cisco BroadWorks în 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 din 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 de la nivel de dispozitiv cu polycom_vvx2.cfg. Acest fișier se referă la migration_%BWMACADDRESS%.cfg.
2. Reconfigurați profilurile de dispozitiv la nivel de grup sau la nivel de dispozitiv.
   Acționarea la nivel de grup sau 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 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ăugați un fișier cu tipul de profil al identității/dispozitivului

Instrucțiuni pentru rulare

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

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

Pentru dispozitiv mutați un singur client: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Pentru dispozitiv mutați mai mulți clienți: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json În plus, instrumentul de mutare a dispozitivului acceptă migrarea unui singur telefon/telefon specific de la versiunea 1.35.0. Utilizați comanda de mai jos: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Jurnale terminal

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

Nume unealtă: Versiune instrument de mutare dispozitiv: 1.15.0 Instrument dispozitiv pornit... Dispozitive valide pentru migrare: ------------------------------------------------------------------------------------------------------------------- | Tip dispozitiv | Mac | Versiune | E-mail | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Doriți să migrați toate aceste dispozitive? ([Y]es sau [N]o) da Se încarcă profilurile dispozitivului pentru DMS Cisco MPP LC Procesul de reconstruire a dispozitivului A început Procesul de reconstruire a dispozitivului A fost finalizat Procesul de repornire A fost finalizat Modificarea profilurilor pentru Business Communicator în cadrul grupului de collabmigrationtestGRP_engg Activați procesul de numere de telefon webex inițiat pentru ID-ul organizației clientului: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Procesul de activare a numerelor de telefon webex a fost finalizat pentru ID-ul organizației clientului: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Procesul de dezactivare a numerelor de telefon broadworks inițiat pentru groupId: collabmigrationtestGRP_engg Dezactivare numere de telefon broadworks finalizat pentru groupId: collabmigrationtestGRP_engg Migrare dispozitiv finalizată 

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: Stare dispozitiv

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

Figura 16: Numerele sunt active

Operația de revenire trebuie executată pentru o întreprindere la un moment dat.

Pentru operatorul BroadCloud

Procesul de revenire pentru partenerii BroadCloud este după cum urmează:

1. Deschideți un tichet cu Cisco TAC pentru a solicita revenirea dispozitivului.
2. Rulați instrumentul de mutare a dispozitivului în modul de revenire:
   • Numerele de telefon nu vor fi alocate din Webex Calling, lăsând utilizatorii și serviciile numai cu interioare.
   • Adresele de e-mail din Webex Calling vor fi restabilite la adrese de e-mail temporare.
   • Telefoanele vor fi șterse din Webex Calling.
   • Numerele de telefon, adresele de e-mail utilizate ca alternateId și telefoanele vor fi recreate în BroadCloud.
   • Telefoanele vor fi repornite.
3. Administratorii parteneri trebuie să mute numerele de telefon PSTN înapoi la operatorul BroadCloud.

Pentru Cisco BroadWorks și Webex pentru BroadWorks

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

1. Deschideți un tichet cu Cisco TAC pentru a solicita revenirea dispozitivului.
2. Rulați instrumentul de mutare a dispozitivului în modul revenire pe serverul secundar de aplicații BroadWorks pentru a restabili migrările dispozitivului. Această acțiune va seta URL-ul DMS înapoi la URL-ul DMS al furnizorului de servicii pentru profilurile dispozitivelor din Cisco BroadWorks și va reactiva numerele de telefon.
3. Echipa Webex Calling setează URL-ul DMS înapoi la URL-ul DMS al furnizorului de servicii în 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 secundar, în serverul de aplicații Cisco BroadWorks din directorul de instrumente de mutare a dispozitivului:

Restabiliți profilurile

./devicemove.sh -input=  -revertProfiles

Restabiliți numerele

./devicemove.sh -input=  -revertNumbers

Jurnale terminal

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

Restabiliți profilurile

Nume unealtă: Versiune instrument de mutare dispozitiv: 1.15.0 Instrument dispozitiv pornit pentru revenire la procesul de revenire... Dispozitive care pot fi mutate înapoi de la Webex Calling la BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Tip dispozitiv | Mac | Versiune | E-mail | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Doriți să mutați aceste dispozitive înapoi din Webex Calling în BroadWorks? (Da, Y, Nu, N):  Da Încărcare profiluri dispozitiv pentru DMS Cisco MPP LC Procesul de reconstruire a dispozitivului Început Procesul de reconstruire a dispozitivului Finalizat cu succes Procesul de repornire Început Procesul de repornire Finalizat cu succes Migrarea dispozitivului Finalizată pentru procesul de anulare a configurării 

Restabiliți numerele

Nume unealtă: Versiune instrument de mutare dispozitiv: 1.15.0 Doriți să continuați să reveniți numerele la Broadworks?  ([Y]es sau [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Se reia procesul de activare a numerelor de telefon broadworks inițiat pentru grupId: collabmigrationtestGRP_engg Activare numere de telefon broadworks finalizat pentru groupId: collabmigrationtestGRP_engg Procesul de revenire a migrării dispozitivului a fost finalizat cu succes