Instrumente de migrare pentru a trece de la BroadWorks, Webex pentru BroadWorks și BroadCloud la soluții RTM angro

Telefoanele acceptate vor fi create și atribuite automat utilizatorilor din Webex Calling de 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 acea coloană au nevoie de o intervenție manuală pentru a modifica URL-ul DMS în șablonul dispozitivului Cisco BroadWorks sau în telefonul în sine.

Ultima coloană oferă cartografierea modelelor de telefon la coloana “Tip dispozitiv” a transformatorului de fișier-instrument/intrare/newphones.csv. (A se vedea Transforma instrument secțiune a acestui articol pentru mai multe informații despre newphones.csv).

Administratorii parteneri execută acest instrument de utilitate generator de token cel puțin o dată înainte de a începe rularea instrumentelor de migrare. Rularea acestui instrument este o activitate de o singură dată după ce contul partenerului este încorporat în soluția RTM en-gros. Acest instrument permite administratorilor parteneri să se conecteze prin browser-ul web pentru a obține TOKEN unic, care este necesar pentru a actualiza la fișierele de configurare partener 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 JAVA_HOME există deja, aceasta va fi reutilizată de unealtă.

• MAC: JAVA_HOME="/Utilizatori/cisco/jdk/zulu@1.8.282/Conţinut/Acasă/"

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

Instrucţiuni de funcţionare

Rulați următoarea comandă în terminalul din interiorul directorului generatorului de jetoane:

Windows:

token_generator.băţ

MacOS:

./token_generator.sh

Ieșire:

Nume instrument: Token Generator Tool Versiune: 1.13.0 Încărcați URL-ul în browserul dvs. web: http://localhost:8080 

Deschideți URL-ul din browserul web de pe terminal, conectați-vă cu datele de autentificare ale administratorului partenerului pentru a obține TOKEN-ul și copiați-l 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ă Informații

Figura 5: Generarea de jetoane

Configurați următorii pași, înainte de a rula instrumentele de extragere și de 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 permite conectivitatea OCI-P să utilizeze pașii de mai jos:

Pasul 1: Utilizați CLI pentru a configura Setări generale.

Rulați următoarea comandă în CLI pentru a o schimba în directorul GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/General Settings.

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

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

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

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

Schimbați directorul în proxy-ul OCI:

AS_CLI> cd /Aplicaţii/OpenClientServer/OCIProxy

Rulați următorul CLI pentru a obține setările curente. Trebuie să vedeţi următoarele:

AS_CLI/Applications/OpenClientServer/OCIProxy> activați = autentic enabledLoginLevel Screening = fals enableResponseCaching = fals responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 mesageQueueCapacity = 50 mesageQueueTimeoutSeconds = 1800 

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

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

Modificarea directorului de configurare:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Rulați următoarea comandă pentru a obține setările actuale de configurare OCI:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> obține Descrierea adresei ======================== 127.0.0.1 local ca 

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

 AS_CLI/Maintenance/ManagedObjects> obține broadworks și verificați dacă ieșirea dvs. arată OK. Vezi mai jos pentru rezultatele eșantionului: AS_CLI/Maintenance/ManagedObjects> obține Broadworks BroadWorks Obiecte gestionate ========================== * Server: Identitate..............: CA Versiune...............: Rel_21.sp1_1.551 Stare administrativă..: Aplicații deblocate *: Versiune nume implementat Administrative State Effective State ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked FlashPolicy 21.sp1_1.551 false Unlocked OpenClientServer oprit 21.sp1_1.551 true Unlocked Unlocked WebContainer 21.sp1_1.551 true Unlocked Unlocked 4 entries found. * Aplicații găzduite: Versiune nume Cale de context implementat ================================================================== CommPilot 21.sp1_1.551 / 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 a începe serverul deschis pentru clienți pe serverul secundar de aplicații 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 activa numerele:

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

CA_CLI> CD SubscriberMgmt/NumberActivation

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

AS_CLI> setați grupul dnMod AndUserActivationEnabled

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

Pentru BroadCloud

Instrumentul de extragere este integrat în portalul furnizorului de servicii BroadCloud. Administratorul unui furnizor de servicii poate:

1. Trimiteți cereri de extragere pentru până la 50 de clienți la cerere.
   Cererea de extract nu poate fi depusă pentru același client 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.

Cifrele de mai jos arată portalul Furnizorului de servicii.

Figura 6: portal Furnizor de servicii

Figura 7: portal Furnizor de servicii

Pentru Cisco BroadWorks și Webex pentru BroadWorks

1. Instrumentul de extragere rulează pe serverul secundar de aplicații Cisco BroadWorks din rețeaua parteneră și se conectează prin OCI-P.
2. Instrumentul trage datele companiei brute, grupului, numerelor, utilizatorilor, serviciilor, dispozitivelor și ale clientului 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ă cum să instalați și să configurați instrumentul de extract.

Cerințe preliminare

1. SCP binarele instrumentului de extragere către serverul secundar de aplicații Cisco BroadWorks.
2. SSH către serverul secundar de aplicații Cisco BroadWorks pentru a configura cerințele prealabile și a rula instrumentul de extragere.
3. Configurați furnizorul de servicii și ID-ul grupului pentru a extrage din Cisco BroadWorks în conf/exportTool.yml. Consultați setul YAML de mai jos:

   ServiceProviderID-A:      - GrupID-A1 - GrupID-A2 - GrupID-A3 ServiceProviderID-B:                        - toate 

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

   BROADWORKS_User_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Tokenul de reîmprospătare al administratorului partenerului copiat din instrumentul Token Generator. MOD MIGRAȚIE_ = Valorile acceptate sunt webex_for_broadworks_to_wholesale. Valoarea implicită este broadworks_to_wholesale. Utilizați webex_for_broadworks_to_wholesale pentru migrări Webex pentru BroadWorks. 

   Proprietatea REFRESH_TOKEN este obligatorie pentru o migrare Webex pentru BroadWorks.

5. Modificați calea de mediu JDK/JRE în fișierul export.sh dacă calea de mediu secundară a serverului de aplicații Cisco BroadWorks JDK/JRE este diferită de fișier:

   JAVA_HOME=/usr/local/java/java_base

Instrucţiuni de funcţionare

Rulați comanda de mai jos în serverul secundar de aplicații Cisco BroadWorks din directorul de instrumente de extragere:

./export.sh

Jurnale terminale

Următoarele jurnale sunt disponibile în terminalul de export de succes: Rularea instrumentului de export de date BroadSoft:

 Rularea BroadSoft instrument de export de date ************************************************ Inițiere instrument de export v: 1.15.0 Exportul a început pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportarea utilizatorilor pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportul utilizatorilor finalizat pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportul finalizat pentru SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportul finalizat Exportul Dump Zip Directory: ieșire/20221017223452_ExportTool Export Nume fișier Dump Zip:Fișierul extracted_data_1666060Zip 500618.zip cu numele de extracted_data_1666060500618.zip a fost creat procesul de creare a fișierelor ZIP finalizat Fișierele exportate convertite ca fișier ZIP ************************************************** 

Ieşire

Un fișier de ieșire ZIP (extracted_data_.zip) va fi disponibil în același director de instrumente de extract. 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 migrațiile. Instrumentul de transformare rulează pe orice computer, inclusiv pe laptop-ul administratorului unui partener, și utilizează API-urile publice Webex. Se citește fișierul ZIP (extracted_data_.zip) de ieșire a sculei extract ca intrare și transformă XML-ul brut într-un format JSON care este 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 prealabile:

1. Setați TOCURILE REFRESH_ (Token copiate din Token Generator Tool) și NUMELE_LOCAȚIEI_PRINCIPALE_ în fișierul conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NUMELE_SAU_LOCAȚIA PRINCIPALĂ_=Principală 

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

   FURNIZARE_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 FURNIZARE_.
3. Configurați informațiile lipsă în fișierul intrare/customers.csv (consultați secțiunea următoare) dacă lipsesc.
4. Adăugați adresa de e-mail a utilizatorului final în fișierul de intrare/users.csv.
5. Dacă telefoanele noi urmează să fie configurate, adăugați adresa de mac și adresa de e-mail a noului telefon al utilizatorului la fișierul de intrare/newphones.csv. Acest lucru este necesar numai în cazul în care administratorii parteneri doresc să furnizeze telefoane noi în apelare angro.
6. Convertiți centrele de apeluri BroadWorks în CxEssentials utilizând fișierul de intrare/cxessentials.csv.
7. Opțional, activați UPGRADE_ALL_Call_CENTERS_TO_CX_ESSENTIALS property to convert all Call Centers to CxEssentials.
8. Utilizați fișierul de intrare/locații.csv pentru a sprijini migrarea întreprinderii mari, care permite administratorilor să migreze locațiile clientului lor în funcție de locație
9. Activați opțional utilizarea adreselor MAC din antetul Agent utilizator al mesajului SIP REGISTER atunci când adresa MAC nu este disponibilă în profilul dispozitivului Cisco BroadWorks. Dezcomentați linia „UTILIZAȚI_ADRESA MAC__DE LA_SIP_REGISTER=da” în fișierul conf/partner.cfg

Umplerea intrării/customers.csv

Fișierul de intrare/customers.csv oferă date care pot să lipsească în Cisco BroadWorks sau BroadCloud. Acest fișier poate fi lăsat 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 intrare/customers.csv.

Instrucţiuni de funcţionare

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 folosind Python:

   python3 -m venv venv sursă venv/bin/activate python3 -m pip instalează solicitări python3 -m pip instalează solicitări-oauthlib 

2. Rulați instrumentul de transformare:

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

Verificare prealabilă client/utilizator

Instrumentul Transform efectuează apeluri API către Webex pentru a capta potențiale probleme de configurare. În mod implicit, acesta va valida adresa clientului și e-mailul principal. Dacă valoarea _ID-ului de FURNIZARE este specificată în fișierul conf/partner.cfg, aceasta va valida, de asemenea, 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 la rularea instrumentului de transformare:

verificare prealabilă

În plus față de rularea API-ului de preverificare pentru informațiile clienților, Instrumentul Transform va rula, de asemenea, API-ul de preverificare pentru e-mailurile abonatului.

informații verificare prealabilă

În mod implicit, în raportul de excepție sunt incluse numai erori de preverificare (adică probleme care vor bloca configurarea). Adăugarea acestui steag va include, de asemenea, rezultate de verificare prealabilă de succes (de exemplu, dacă există deja o organizație Webex care poate fi atașată automat).

Jurnale terminale

Următoarele jurnale în terminal pe transformator de succes:

Raport sumarizat al întreprinderilor 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 Excepție

Instrumentul de transformare generează raportul de excepție în directorul de ieșire//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, redenumiți Instrumentele de extracție și transformare cu noile date. Fișierul de raport cu excepția probelor după cum urmează:

Raport de excepție Tue Oct 18 08:12:09 2022 Întreprinderi cu Comunicare Barring Feature Recomandare: configurați manual planul de apelare de ieșire în Control Hub ________________________________________________________________________________ ColllabmigrationtestGRP_engg 

Ieşire

Un fișier JSON de ieșire (client.json) va fi disponibil în directorul de ieșire// . Fișierul eșantion client.json este după cum urmează:

{ "client": { "provisioningId": "!!!!!!!!!!ÎNLOCUIȚI_cu_PROVIZIONINGID!!!!!!!!!!", "pachete": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "adresa": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "customerInfo": { "name": "Engineering Group - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParametrii": { "calling": { "location": { "name": "Main", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/New_York", "limba": "en_us", " numere": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], " mainNumber": "+15205551101" } } } }, "broadworks_info": { "service_provider_id": "testarea migrației colaborativSP_engg", "group_id": "GRP de testare a migrației colaborative_engg" }, "abonați": [ { "amareswaranvel+benjaminjack@gmail.com": { "abonat": { "customerId": "!!!!!!!!!!ÎNLOCUIREA_cu_CUSTOMERID!!!!!!!!!!", "e-mail": "amareswaranvel+benjaminjack@gmail.com", "pachet": "webex_calling", "provisioningParametrii": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "caracteristici": [ { "/v1/people/{personId}/features/voicemail": { "enabled": adevărat, "sendBusyCalls": { "activat": adevărat, "întâmpinare": "DEFAULT" }, "sendUnansweredCalls": { "activat": adevărat, "salut": "DEFAULT", "numberOfRings": 3 }, „MesageStorage”: { „mwiEnabled”: true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_CU_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } } }, { "amareswaranvel+lucasoliver@gmail.com": { "abonat": { "customerId": "!!!!!!!!!!REPLACE_CU_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, "întâmpinare": "DEFAULT" }, "sendUnansweredCalls": { "activat": adevărat, "salut": "DEFAULT", "numberOfRings": 3 }, „MesageStorage”: { „mwiEnabled”: true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_CU_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } } }, { "amareswaranvel+leojackson@gmail.com": { "abonat": { "customerId": "!!!!!!!!!!REPLACE_CU_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, "întâmpinare": "DEFAULT" }, "sendUnansweredCalls": { "activat": adevărat, "salut": "DEFAULT", "numberOfRings": 3 }, „MesageStorage”: { „mwiEnabled”: true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_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, "întâmpinare": "DEFAULT" }, "sendUnansweredCalls": { "activat": adevărat, "salut": "DEFAULT", "numberOfRings": 3 }, „MesageStorage”: { „mwiEnabled”: true, "storageType": "EXTERNAL", "externEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_cu_PERSONID!!!!!!!!!!", „produs”: „DMS Cisco 8811”, „mac”: „F87B204E4066” } ] } } ], „auto_attendants": [], "call_queues": [], "hunt_groups": [], "programe": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "nume": "Portalul de voce automat", "primul nume": "Automat", "lastName": "Portalul de voce", "linguageCode": "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": "Y2lzY29 zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29 zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id„: „Y2lzY29 zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk” } } 

Instrumentul de configurare poate rula pe orice mașină, de obicei (laptop-ul administratorului partenerului) și utilizează API-urile publice Webex. Se citește fișierul JSON (customer.json) de ieșire a instrumentului 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 condiții prealabile în directorul de instrumente de configurare:

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 instrumentelor de migrare binare, 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 TOKEN-urile WHOLESALE_DISPOZITIVING_ID și REFRESH_ (Token copiat din Token Generator Tool). Administratorii partenerului trebuie să contacteze echipa de cont pentru a obține ID-ul de OFERIRE_:

     GLOBAL_ID_ = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. Utilizați proprietatea WEBEX4BWKS_E-MAIL_SUBIECT pentru migrările Webex pentru BroadWorks pentru a trimite subiectul e-mailului de solicitare a parolei de modificare pentru abonații Webex pentru BroadWorks.
5. Utilizați proprietatea WEBEX4BWKS_E-MAIL_CORPUL pentru migrările Webex pentru BroadWorks pentru a trimite corpul de e-mail al solicitării de schimbare a parolei pentru abonații Webex pentru BroadWorks.

Pentru migrațiile BroadCloud aceeași regiune:

1. Instrumentul va omite configurarea numerelor, dispozitivelor și a aparițiilor apelurilor partajate.
2. Instrumentul va crea utilizatori și utilizatori virtuali cu extensie și extensie temporară.

Pentru migrațiile BroadCloud, o altă regiune:

1. Instrumentul va furniza numere, dispozitive și apariții ale apelurilor partajate.
2. Instrumentul va crea utilizatori și utilizatori virtuali cu numere de telefon reale și extensie.
   Toate migrațiile BroadCloud din Europa sunt în altă regiune.

Instrucţiuni de funcţionare

Utilizați pașii de mai jos pentru a rula instrumentul în Windows și macOS:

Windows

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

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

Sistem de operare Mac

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

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

Cerințe preliminare pentru migrarea Webex pentru BroadWorks

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

Rulați instrumentul de configurare cu un argument suplimentar pentru Webex pentru BroadWorks la migrarea angro.

Faza de pregătire: este faza implicită în care Administratorii pot furniza utilizatorilor BroadWorks ca abonați angro și pot continua cu utilizatorii Webex pentru BroadWorks.

Faza de întreținere: este a doua etapă în care Administratorii pot atribui licența en-gros utilizatorilor Webex existenți pentru BroadWorks. Trebuie să rulați instrumentul de asigurare a accesului cu o întreținere argument.

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

Jurnale terminale

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

Nume instrument: Versiunea instrumentului de configurare: 1.15.0 ********** Fișier de procesare inițiat: client.json de **************** configurare așteaptă clientul external_id_engg_grp1 pentru a finaliza configurarea... Se așteaptă ca clientul external_id_engg_grp1 să finalizeze configurarea...   Stare client external_id_engg_grp1: Numere de configurare configurate Setări utilizatori Setări caracteristici utilizator Setări întâmpinări Programele de configurare Dispozitive de configurare Aspecte de apeluri partajate Setări participanți automați Setări coadă de apeluri Setări grupuri de hunt Setări grup Pagings Setări parcuri de apeluri Setări Pickup-uri de apeluri Setări Portal voce ********** Finalizat fișier: intrare/client.json **************** 

Un tabel va fi imprimat cu numărul de locații create pentru fiecare rulare:

Ieşire

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

Administratorii parteneri pot verifica configurarea clientului în portalul Partner Hub și 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 cerere de migrare pentru numere, dispozitive și migrări SCA.

În cadrul portalului Furnizor de servicii, o cerere de migrare poate include până la 50 de clienți. În termen de o zi se pot depune maximum 10 cereri.

Cifrele de mai jos arată portalul Furnizorului de servicii.

Figura 12: portal Furnizor de servicii

Figura 13: portal Furnizor 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 parteneră ș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 dispozitive și clienți software.

În operațiunea de succes, instrumentul de mutare a dispozitivului va:

1. Deconectați dispozitivele de la Cisco BroadWorks și înregistrați-le în angro.
2. Utilizatorii care utilizează clientul UC-One vor redirecționa 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 comerț angro.
5. Creați apariții partajate ale apelurilor în comerțul cu ridicata pentru migrările BroadCloud. [Această etapă este aplicabilă numai pentru migrările BroadCloud].

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 cerințele prealabile și a rula instrumentul de mutare a dispozitivului.

Cerințe preliminare

1. Setați TOCURILE REFRESH_ (Token copiate din Instrumentul Generator de Token) în fișierul conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_User ID_ = PAROLA BROADWORKS admin_ = NUMELE GAZDULUI_BROADWORKS admin_ = gazdă locală 

3. Verificați dacă calea de mediu JDK/JRE este corectă în devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. 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 din policom

Pentru a muta telefoanele Polycom de la Cisco BroadWorks la apelarea cu ridicata, un administrator partener trebuie să creeze un nou fișier de tip profil identitate/dispozitiv la nivel de sistem în fiecare șablon de dispozitiv Polycom Cisco BroadWorks. Consultați figura 14 și încărcați fișierul de fișier personalizat dispozitiv-mutare-instrument/conf/deviceProfile/{region}/polycom_vvx.cfg. După încărcarea noului fișier de dispozitiv, asigurați-vă că fișierul nou creat există la nivelul Grupului. De asemenea, asigurați-vă că fișierul migration_%BWMAC ADDRESS%.cfg nu intră în conflict cu niciun fișier existent din sistemul dvs.).

Acesta este utilizat pe plan intern de către instrumentul de mișcare dispozitiv.

Procesul de migrare pentru telefoanele Polycom:

1. Instrumentul de mutare a dispozitivului înlocuiește fișierul %BWMACADDRESS%.cfg la nivelul dispozitivului cu polycom_vvx2.cfg. Rețineți că acest fișier se referă la migration_%BWMACADDRESS%.cfg.
2. Reconstruiți profilurile dispozitivului la nivelul grupului sau la nivelul dispozitivului.
   Acționarea la nivel de grup sau nivel de dispozitiv depinde de configurația deviceLevelRebuild parametru în fișier dispozitiv-mișcare-instrument/conf/partner.cfg.
3. Instrumentul de mutare a dispozitivului solicită serverului aplicației Cisco BroadWorks să repornească telefoanele la nivelul grupului sau la nivelul dispozitivului.
4. După cererea de repornire, telefoanele Polycom descărca și proces% BWMACADDRESS%.cfg, care solicită telefoanele Polycom pentru a descărca și proces migration_%BWMACADDRESS%.cfg, care setează dispozitivul.prov.serverName la https://plcm.sipflash.com.
   https://plcm.sipflash.com pentru regiunea SUA, alte regiuni au URL-uri diferite.
5. Telefonul Polycom descarcă %BWMACADDRESS%.cfg de la https://plcm.sipflash.com și va fi gestionat de Webex Calling DMS.

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

Instrucţiuni de funcţionare

Există două metode de invocare a DMT, primul este de a invoca prin intermediul unui singur client la un moment dat, iar celălalt este de a rula prin mai mulți clienți simultan.

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

Pentru mutarea unui singur client al dispozitivului: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Pentru mutarea mai multor clienți ai dispozitivului: ./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/a anumitor telefoane de la versiunea 1.35.0. Utilizați comanda de mai jos: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Jurnale terminale

Următoarele sunt jurnalele din terminalul de pe rulează cu succes instrumentul de mutare a dispozitivului pentru migrarea dispozitivului:

Nume instrument: Versiune instrument de mutare dispozitiv: 1.15.0 Instrumentul de dispozitiv a început... Dispozitive valide pentru migrare: ------------------------------------------------------------------------------------------------------------------- | Tip dispozitiv | Mac | Versiune | E-mail | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | cc98914eaad7 | Cisco-CP-7861-3PCC/11.3.7_ccConsiliul 989147_ | 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 Încărcarea profilurilor de dispozitiv pentru DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Reboot Process Started Reboot Process Finalizat Cu Succes Modificarea profilurilor pentru Business Communicator în cadrul grupului CollabmigrationtestGRP_engg Activarea procesului de numere de telefon webex inițiat pentru organizația client Id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Activați procesul numerelor de telefon webex finalizat pentru ID-ul organizației clientului: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Dezactivarea procesului de numere de telefon broadworks a început pentru groupId: collabmigrationtestGRP_engg Dezactivați procesul de dezactivare a numerelor de telefon broadworks finalizat pentru GrupId: migrarea dispozitivului GRP_engg de testare a colaborării a fost finalizată 

Ieşire

După migrarea dispozitivului, dispozitivele au venit online și gata să facă/să primească apeluri. Consultați figura 15 pentru a vedea un exemplu al stării dispozitivului:

Figura 15: Stare dispozitiv

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

Figura 16: Numere active

Operațiunea inversă trebuie să fie executată pentru o întreprindere la un moment dat.

Pentru BroadCloud Carrier

Procesul invers pentru partenerii BroadCloud este după cum urmează:

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

Pentru Cisco BroadWorks și Webex pentru BroadWorks

Procesul inversat pentru Cisco BroadWorks și Webex pentru BroadWorks este după cum urmează:

1. Deschideți un tichet cu Cisco TAC pentru a solicita revenirea unui dispozitiv.
2. Rulați instrumentul de mutare a dispozitivului în modul revert de pe serverul secundar de aplicații BroadWorks pentru a inversa migrările dispozitivului. Acest lucru va seta URL-ul DMS înapoi la URL-ul DMS al furnizorului de servicii pentru profilurile de dispozitive 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 portalul 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 revert

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

Rulați comanda de mai jos în serverul secundar de aplicații Cisco BroadWorks din directorul de instrumente de mișcare al dispozitivului:

Redirecționare profiluri

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

Redirecționare numere

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

Jurnale terminale

Vom obține următoarele jurnale în terminalul de funcționare cu succes a instrumentului de mutare a dispozitivului pentru operarea inversă:

Redirecționare profiluri

Nume instrument: Versiune instrument de mutare dispozitiv: 1.15.0 Instrumentul de dispozitiv a început procesul de inversare... 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_ccConsiliul 989147_ | 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 înapoi aceste dispozitive de la Webex Calling la BroadWorks? (Da, Y, Nu, N):  da Încărcarea profilurilor de dispozitiv pentru DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Completată cu succes Reboot Process Started Reboot Process Completată cu succes Migrarea dispozitivului Completată pentru procesul de dezactivare 

Redirecționare numere

Nume instrument: Versiune instrument de mutare dispozitiv: 1.15.0 Doriți să redirecționați în continuare numerele către Broadworks?  ([Y]es sau [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Începeți să activați procesul de activare a numerelor de telefon broadworks inițiat pentru grupId: collabmigrationtestGRP_engg Activați procesul numerelor de telefon broadworks finalizat pentru GrupId: procesul de redirecționare a migrării dispozitivului GRP_engg a fost finalizat cu succes