Nástroje na migráciu na prechod z riešení BroadWorks, Webex for BroadWorks a BroadCloud na veľkoobchodné riešenia RTM

Podporované telefóny budú automaticky vytvorené a priradené používateľom vo Webex Calling nástrojom na poskytovanie. Telefóny označené „áno“ v stĺpci „Podporované v nástroji na presun zariadenia“ sa tiež automaticky presunú z Cisco BroadWorks alebo BroadCloud do Webex Calling, keď sa spustí nástroj na presun zariadenia. Telefóny označené v tomto stĺpci „Nie“ potrebujú manuálny zásah na zmenu adresy URL DMS v šablóne zariadenia Cisco BroadWorks alebo v samotnom telefóne.

Posledný stĺpec poskytuje mapovanie modelov telefónov do stĺpca „Typ zariadenia“ súboru transform-tool/input/newphones.csv. (Viac informácií o stránke newphones.csv nájdete v časti Nástroj na transformáciu tohto článku).

Správcovia partnerov spustia tento nástroj generátora tokenov aspoň raz pred spustením nástrojov na migráciu. Spustenie tohto nástroja je jednorazová aktivita po pripojení partnerského účtu do riešenia veľkoobchodného RTM. Tento nástroj umožňuje administrátorom partnerov prihlásiť sa cez webový prehliadač, aby získali jedinečný TOKEN, ktorý je potrebný na aktualizáciu konfiguračných súborov partnera pre nástroje na migráciu.

Predpoklady

Po stiahnutí rozbaľte binárne súbory nástroja na migráciu.

Nastavte cestu prostredia JRE/JDK v súbore token_generator.sh pre MAC a token_generator.bat pre Windows. Ak už cesta JAVA_HOME existuje, nástroj ju znova použije.

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

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

Pokyny na spustenie

Spustite nasledujúci príkaz v termináli v adresári generátora tokenov:

Windows:

token_generator.netopier

MacOS:

./token_generator.sh

výstup:

Názov nástroja: Verzia nástroja na generovanie tokenov: 1.13.0 Načítajte URL do vášho webového prehliadača: http://localhost:8080 

Otvorte URL vo webovom prehliadači na termináli, prihláste sa pomocou poverení správcu partnera, aby ste získali TOKEN a skopírujte ho na ďalšie použitie.

Ilustrácie používateľského rozhrania sú uvedené nižšie ako referencia:

Obrázok 3: Prihláste sa pomocou Cisco Webex

Obrázok 4: Okno poverenia

Obrázok 5: Generovanie tokenov

Pred spustením nástrojov na extrakciu a presun zariadenia na sekundárnom serveri BroadWorks nakonfigurujte nasledujúce kroky.

Povoliť pripojenie OCI-P

Nástroj na presun zariadenia komunikuje so zariadením BroadWorks prostredníctvom príkazov OCI-P, na umožnenie pripojenia OCI-P použite nasledujúce kroky:

Krok 1: Na konfiguráciu všeobecných nastavení použite CLI.

Ak chcete prejsť do adresára GeneralSettings, spustite nasledujúci príkaz v CLI:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Ak chcete získať aktuálne všeobecné nastavenia, spustite nasledujúci príkaz v CLI:

AS_CLI/Applications/OpenClientServer/GeneralSettings> získať clientPort = 2208 clientPortEnabled = true secureClientPort = 2209 secureClientPortEnabled = true systemDomain = <> 

Ak sa vaše nastavenia nezhodujú s vyššie uvedenými nastaveniami, pomocou príkazu set prekonfigurujte nastavenia.

Krok 2: Na konfiguráciu OCI Proxy použite CLI.

Zmeňte adresár na OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Ak chcete získať aktuálne nastavenia, spustite nasledujúce CLI. Mali by ste vidieť nasledovné:

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

Ak sa vaše nastavenia nezhodujú s vyššie uvedenými nastaveniami, pomocou príkazu set prekonfigurujte nastavenia.

Krok 3: Použite CLI na konfiguráciu OCI Provisioning.

Prejdite do adresára Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Ak chcete získať aktuálne nastavenia poskytovania OCI, spustite nasledujúci príkaz:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> získať popis adresy ========================= 127.0.0.1 miestne ako 

4. krok: Spustite príkaz uvedený nižšie v CLI a overte, či je vaša konfigurácia správna.

 AS_CLI/Maintenance/ManagedObjects> získajte broadworks a skontrolujte, či váš výstup vyzerá v poriadku. Vzorový výstup nájdete nižšie: AS_CLI/Maintenance/ManagedObjects> získajte spravované objekty BroadWorks =========================== * Server: Identita..................: Verzia AS...............: Rel_21.sp1_1.551 Administratívny štát...: Odomknuté * Aplikácie: Názov Verzia Nasadený Administratívny stav Platný stav ============================================= =============================================== ExecutionAndProvisioning 21.sp1 _1,551 true Odomknuté Odomknuté FlashPolicy 21.sp1_1,551 false Odomknuté Zastavené OpenClientServer 21.sp1_1,551 true Odomknuté Odomknuté WebContainer 21.sp1_Našlo sa 1,551 true Odomknuté Odomknuté 4 záznamy. * Hosťované aplikácie: Názov Verzia Kontextová cesta nasadená =============================================== ===================== 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 Našlo sa 5 záznamov. 

Overte, či je otvorený klientsky server nasadený a aktívny

Pomocou nižšie uvedených príkazov nasaďte a spustite Open Client Server na sekundárnom aplikačnom serveri, ak ešte nie je nasadený alebo ešte nebol spustený.

Krok 1: Nasaďte server pomocou nasledujúceho príkazu CLI:

AS_CLI/Maintenance/ManagedObjects> nasadiť aplikáciu OpenClientServer

Krok 2: Spustite server pomocou tohto príkazu:

AS_CLI/Maintenance/ManagedObjects> spustite aplikáciu OpenClientServer

Povoliť aktiváciu čísel

Vykonajte nasledujúce príkazy v CLI, aby ste povolili aktiváciu čísel:

Krok 1: Spustite príkaz na aktiváciu čísla:

AS_CLI> cd SubscriberMgmt/NumberActivation

Krok 2: Spustite príkaz aktivácie povolený:

AS_CLI> nastaviť dnMode groupAndUserActivationEnabled

Krok 3: Po výzve na potvrdenie zadajte Y.

Pre BroadCloud

Nástroj na extrahovanie je integrovaný v portáli poskytovateľa služieb BroadCloud. Správca poskytovateľa služieb môže:

1. Odošlite žiadosti o výpis až pre 50 zákazníkov na žiadosť.
   Žiadosť o extrakciu nemožno odoslať pre toho istého zákazníka viac ako 10-krát za deň.
2. Stiahnite si extrahovaný dátový súbor vo formáte ZIP po dobu až 28 dní od dátumu odoslania žiadosti.

Obrázky nižšie zobrazujú portál poskytovateľa služieb.

Obrázok 6: Portál poskytovateľa služieb

Obrázok 7: Portál poskytovateľa služieb

Pre Cisco BroadWorks a Webex pre BroadWorks

1. Nástroj na extrahovanie beží na sekundárnom aplikačnom serveri Cisco BroadWorks v rámci partnerskej siete a pripája sa cez OCI-P.
2. Nástroj sťahuje nespracované údaje o podniku, skupine, číslach, používateľoch, službách, zariadeniach a softvérových klientoch z platformy Cisco BroadWorks alebo BroadCloud a odosiela tieto údaje do súborov XML, ktoré poskytujú vstupy pre transformačný nástroj.

Nasledujúce časti vysvetľujú, ako nainštalovať a nakonfigurovať nástroj na extrahovanie.

Predpoklady

1. Presuňte binárne súbory nástroja na extrahovanie na sekundárny aplikačný server Cisco BroadWorks.
2. SSH na sekundárny aplikačný server Cisco BroadWorks na konfiguráciu predpokladov a spustenie nástroja na extrahovanie.
3. Nakonfigurujte poskytovateľa služieb a ID skupiny na extrahovanie z Cisco BroadWorks v súbore conf/exportTool.yml. Pozrite si nižšie uvedený vzorový úryvok YAML:

   ServiceProviderID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - VŠETCI 

4. Uistite sa, že sekundárne ID používateľa, heslo a názov hostiteľa Cisco BroadWorks Application Server sú v súbore conf/partner.cfg správne:

   BROADWORKS_USER_ID = administrátor BROADWORKS_HESLO = administrátor BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Obnovovací token správcu partnera skopírovaný z nástroja Token Generator. MIGRÁCIA_REŽIM = Podporované hodnoty sú webex_for_broadworks_to_wholesale. Predvolená hodnota je broadworks_to_wholesale. Použite webex_for_broadworks_to_wholesale pre migrácie Webex for BroadWorks. 

   Vlastnosť REFRESH_TOKEN je povinná pre migráciu Webex for BroadWorks.

5. Upravte cestu k prostrediu JDK/JRE v súbore export.sh, ak sa sekundárna cesta prostredia JDK/JRE Cisco BroadWorks Application Server líši od cesty súboru:

   JAVA_HOME=/usr/local/java/java_base

Pokyny na spustenie

Spustite príkaz uvedený nižšie na sekundárnom aplikačnom serveri Cisco BroadWorks z adresára nástroja na extrahovanie:

./export.sh

Denníky terminálu

Po úspešnom exporte sú v termináli k dispozícii nasledujúce protokoly: Spustenie nástroja BroadSoft Data Export Tool:

 Spustenie nástroja BroadSoft Data Export Tool ************************************************** *** Spustenie nástroja Export v: 1.15.0 Export spustený pre SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export používateľov pre SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export používateľov dokončený pre SP=collabmigrationtestSP_engg, Group=G Export dokončený pre SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export dokončený Export Dump Zip Directory :_engg output/20221017223452_ExportTool Export Dump Názov súboru ZIP:extracted_data_1666060500618.zip Súbor ZIP s názvom extracted_data_1666060500618.zip bol vytvorený Proces vytvárania súboru ZIP bol dokončený Exportované súbory skonvertované ako súbor ZIP ******************* ********************************** 

Výstup

Výstupný súbor ZIP (extracted_data_.zip) bude dostupný v rovnakom adresári nástroja na extrahovanie. Na zobrazenie a použitie súboru ZIP pre vstup nástroja Transform Tool použite príkaz uvedený nižšie:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 okt.  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 okt  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 okt.  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 okt.  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 17. októbra 22:34 výstup/ drwxrwxr-x 2 bwadmin bwadmin 4096 17. okt 22:34 protokoly/ -rw-rw-rw-rwdmin 17. októbra 17. 35 extracted_data_1666060500618.zip 

Tento transformačný nástroj je spustený pre všetky migrácie. Transformačný nástroj beží na akomkoľvek počítači, vrátane notebooku správcu partnera, a používa Webex Public API. Načíta výstupný súbor ZIP (extracted_data_.zip) nástroja na extrahovanie ako vstup a transformuje nespracovaný formát XML do formátu JSON, ktorý používa nástroj na poskytovanie.

Predpoklady

Po stiahnutí a rozbalení binárnych súborov nástrojov na migráciu nakonfigurujte nasledujúce predpoklady:

1. V súbore conf/partner.cfg nastavte OBNOVIŤ_TOKEN (token skopírovaný z nástroja na generovanie tokenov) a NÁZOV__HLAVNÉHO_MIESTA:

   OBNOVIŤ_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NÁZOV_Z_HLAVNÉHO_LOCATION=Hlavné 

2. Voliteľne nastavte ID PROVISIONING_ (skopírované zo šablóny v Partner Hub) v súbore conf/partner.cfg:

   ZABEZPEČENIE_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Ak chcete získať úplnejšie overenie e-mailovej adresy zákazníka, môžete voliteľne nastaviť ID PROVISIONING_.
3. Nakonfigurujte chýbajúce informácie v súbore input/customers.csv (pozri nasledujúcu časť), ak chýbajú.
4. Pridajte e-mailovú adresu koncového používateľa do súboru input/users.csv.
5. Ak sa majú poskytovať nové telefóny, pridajte mac adresu a e-mailovú adresu nového telefónu používateľa do súboru input/newphones.csv. Vyžaduje sa to iba v prípade, že správcovia partnerov chcú poskytovať nové telefóny v rámci veľkoobchodného volania.
6. Preveďte Call Centers BroadWorks na CxEssentials pomocou súboru input/cxessentials.csv.
7. Voliteľne povoľte vlastnosť UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS na konverziu všetkých call centier na CxEssentials.
8. Použite súbor input/locations.csv na podporu migrácie veľkých podnikov, ktorá umožňuje správcom migrovať miesta svojich zákazníkov podľa miesta
9. Voliteľne povoľte používanie MAC adries z hlavičky User-Agent v správe SIP REGISTER, keď MAC adresa nie je dostupná v profile zariadenia Cisco BroadWorks. Odkomentujte riadok „POUŽÍVAŤ_MAC_ADRESU_Z_SIP_REGISTER=yes“ v súbore conf/partner.cfg

Vyplnenie input/customers.csv

Súbor input/customers.csv poskytuje údaje, ktoré možno chýbajú v Cisco BroadWorks alebo BroadCloud. Tento súbor môže zostať prázdny, ak sú už k dispozícii všetky povinné informácie. Nemusíte vyplniť všetky stĺpce, povinné sú len chýbajúce informácie.

V tabuľke nižšie sú vysvetlené najdôležitejšie stĺpce v input/customers.csv.

Pokyny na spustenie

Spustite nástroj Transform Tool v ľubovoľnom operačnom systéme. Na spustenie nástroja v systéme Windows a macOS použite nasledujúce kroky:

Windows

Ak chcete spustiť nástroj Transform v systéme Windows, vykonajte príkaz uvedený nižšie:

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

macOS

Ak chcete spustiť nástroj transformácie v systéme macOS, vykonajte nasledujúce kroky:

1. Vytvorte virtuálne prostredie a nainštalujte závislosti na spustenie transformačného nástroja pomocou Pythonu:

   python3 -m venv zdroj venv venv/bin/aktivovať python3 -m požiadavky na inštaláciu pip python3 -m požiadavky na inštaláciu pip-oauthlib 

2. Spustite transformačný nástroj:

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

Predbežná kontrola zákazníka/používateľa

Nástroj Transform Tool volá API do Webexu, aby zachytil potenciálne problémy s poskytovaním. V predvolenom nastavení overí zákazníkovu adresu a primárny e-mail. Ak je v súbore conf/partner.cfg zadaná hodnota ID PROVISIONING_, overí sa aj informácia o polohe. Výsledky predbežnej kontroly sú zahrnuté v správe o výnimkách.

Okrem toho je možné pri spustení transformačného nástroja pridať nasledujúce voliteľné parametre:

predbežná kontrola

Okrem spustenia rozhrania API na predbežnú kontrolu informácií o zákazníkoch nástroj Transform Tool spustí aj rozhranie API predbežnej kontroly pre e-maily predplatiteľov.

predbežné informácie

V predvolenom nastavení sú do správy o výnimkách zahrnuté iba chyby predbežnej kontroly (t. j. problémy, ktoré blokujú poskytovanie). Pridanie tohto príznaku bude zahŕňať aj úspešné výsledky predbežnej kontroly (napr. ak už existuje organizácia Webex, ktorú možno automaticky pripojiť).

Denníky terminálu

Nasledujúce záznamy v termináli o úspešnej transformácii:

Súhrnná správa Podniky BroadWorks, ktoré možno úspešne migrovať: 1 Podniky BroadWorks, ktoré nemožno migrovať: 0 používateľov BroadWorks, ktorých možno úspešne migrovať: 4 používatelia BroadWorks, ktorých nemožno migrovať: 0 telefónov, ktoré je možné úspešne migrovať: 3 telefóny, ktoré nie sú kompatibilné s Webex Calling: 0 

Správa o výnimke

Nástroj Transform Tool generuje správu o výnimkách v adresári output//exception_report.txt . Túto správu môžete použiť na identifikáciu problémov, ktoré ovplyvnia migráciu, a na ich opravu v systéme Cisco BroadWorks.

Po úprave údajov používateľa na vyriešenie výnimky znova spustite nástroje na extrahovanie a transformáciu s novými údajmi. Vzorový súbor správy o výnimkách:

Správa o výnimkách Ut. 18. október 08:12:09 2022 Podniky s funkciou blokovania komunikácie Odporúčanie: manuálne nakonfigurovať plán odchádzajúcich hovorov v Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Výstup

Výstupný súbor JSON (customer.json) bude dostupný v adresári output// . Vzorový súbor customer.json je nasledujúci:

{ "customer": { "provisioningId": "!!!!!!!!!!NAHRAĎTE_ZA_PROVISIONINGID!!!!!!!!!!", " balíčky": [ "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": "Inžinierstvo Skupina - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "volanie": { "miesto": { "meno": "Hlavné" , "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", " krajina": "USA" }, "timezone": "Amerika/New_York", "language": "en_us", "čísla": [ "+15205551101", "+15205551102", " +15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+152055551109", "+152055551109", "051,01" 512:01 15205551101" } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, " odberateľov": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!NAHRADIŤ_ZA_ CUSTOMERID!!!!!!!!!!", "e-mail": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Benjamin ", "priezvisko": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{ personId}/features/voicemail": { "povolené": true, "sendBusyCalls": { "povolené": true, "pozdrav": "DEFAULT" }, "sendUnansweredCalls": { "povolené": true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "zariadenia": [ { "cisUuid": "!!!!! !!!!!NAHRAĎTE_ZA_PERSONIDU!!!!!!!!!!", "produkt": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!NAHRADIŤ_ZA_ CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Lucas ", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [ { "/v1/people/{ personId}/features/voicemail": { "povolené": true, "sendBusyCalls": { "povolené": true, "pozdrav": "DEFAULT" }, "sendUnansweredCalls": { "povolené": true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "zariadenia": [ { "cisUuid": "!!!!! !!!!!NAHRAĎTE_ZA_PERSONIDU!!!!!!!!!!", "produkt": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!NAHRADIŤ_ZA_ CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Leo ", "priezvisko": "Jackson", "primaryPhoneNumber": "+15205551104", "extension": "1104" } }, "features": [ { "/v1/people/{ personId}/features/voicemail": { "povolené": true, "sendBusyCalls": { "povolené": true, "pozdrav": "DEFAULT" }, "sendUnansweredCalls": { "povolené": true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "zariadenia": [] } }, { "amareswaranvel +owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!NAHRAĎTE_ZA_CHOD ZÁKAZNÍKA!!!!!!!! !!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander" , "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "features": [ { "/v1/people/{personId}/features/voicemail" : { "povolené": true, "sendBusyCalls": { "povolené": true, "pozdrav": "DEFAULT" }, "sendUnansweredCalls": { "povolené": true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "zariadenia": [ { "cisUuid": "!!!!! !!!!!NAHRAĎTE_ZA_PERSONIDU!!!!!!!!!!", "produkt": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "plány": [], "call_parks": [], "": [], "paging_groups": [], "voice_portals": [ { "meno": "Automatizovaný hlasový portál", "firstName": "Automaticky", "priezvisko": "Hlas 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": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGMQMitZ11WTYLKWMQMLTVYTv1 5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "Y2Lzov9zYz": JU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Nástroj na poskytovanie môže bežať na akomkoľvek počítači, ktorý je zvyčajne (správcovský laptop partnera) a používa verejné rozhrania API Webex. Číta výstupný súbor JSON (customer.json) nástroja transformácie ako vstup a poskytuje zákazníkov, miesta, čísla, používateľov, služby a zariadenia v riešení Webex Wholesale RTM.

Predpoklady

V adresári nástroja na poskytovanie nakonfigurujte nasledujúce predpoklady:

1. Nainštalujte Java 8, 11 alebo 17 do počítača. Java je dostupná z mnohých zdrojov, vrátane:
   • 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. Po stiahnutí a rozbalení binárnych súborov nástrojov na migráciu nastavte premennú prostredia JAVA_HOME v súbore provisioning_tool.sh pre MAC a provisioning_tool.bat pre Windows.
3. Súbor partner.cfg:
   • Nastavte VEĽKOOBCHOD_PROVISIONING_ID a REFRESH_TOKEN (token skopírovaný z nástroja na generovanie tokenov). Správcovia partnerov musia kontaktovať svoj tím účtu, aby získali PROVISIONING_ID:

     VEĽKOOBCHOD_POSKYTOVANIE_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 OBNOVIŤ_TOKEN=MzUwYjljODEtYmQ4MS000NGUt4jkLTyOTZ

   • Ak partner nechce posielať používateľom uvítací e-mail, nastavte POVOLIŤ E-MAILY SPRÁVCA_POZVANIA_ na hodnotu false._ Predvolená hodnota je true.

4. Použite vlastnosť WEBEX4BWKS_EMAIL_SUBJECT pre migrácie Webex for BroadWorks na odoslanie predmetu e-mailu so žiadosťou o zmenu hesla pre predplatiteľov Webex for BroadWorks.
5. Použite vlastnosť WEBEX4BWKS_EMAIL_BODY pre migrácie Webex for BroadWorks na odoslanie tela žiadosti o zmenu hesla pre predplatiteľov Webex for BroadWorks.

Pre migrácie BroadCloud v rovnakej oblasti:

1. Nástroj preskočí poskytovanie čísel, zariadení a vzhľadov zdieľaných hovorov.
2. Nástroj vytvorí používateľov a virtuálnych používateľov s rozšírením a dočasným rozšírením.

Pre migráciu BroadCloud ďalší región:

1. Nástroj poskytne čísla, zariadenia a vzhľady zdieľaných hovorov.
2. Nástroj vytvorí používateľov a virtuálnych používateľov so skutočnými telefónnymi číslami a klapkami.
   Všetky migrácie Europe BroadCloud sú do iného regiónu.

Pokyny na spustenie

Na spustenie nástroja v systéme Windows a macOS použite nasledujúce kroky:

Windows

Ak chcete spustiť nástroj v operačnom systéme Windows, vykonajte nasledujúce kroky:

Poskytovanie jedného zákazníka: provide.bat -input= Postup poskytovania viacerých zákazníkov: provide.bat -input= 

macOS

Ak chcete spustiť nástroj v systéme macOS, vykonajte nasledujúce kroky:

Poskytovanie jedného zákazníka: ./transform.sh -input= Poskytovanie viacerých zákazníkov: ./transform.sh -input= 

Predpoklady pre Webex pre migráciu BroadWorks

Správcovia partnerov musia aktualizovať svoju šablónu registrácie BroadWorks pre funkcie koexistencie Webex for BroadWorks. Pozrite si obrázok nižšie:

Spustite nástroj na poskytovanie s ďalším argumentom pre migráciu Webex for BroadWorks na veľkoobchod.

Prípravná fáza: je predvolená fáza, v ktorej môžu správcovia poskytnúť používateľom BroadWorks ako veľkoobchodného predplatiteľa a pokračovať v službe Webex pre používateľov BroadWorks.

Fáza údržby: je druhá fáza, v ktorej môžu správcovia prideliť licenciu na veľkoobchod existujúcim používateľom Webex for BroadWorks. Nástroj na poskytovanie musíte spustiť s argumentom údržba.

Fáza po migrácii: Je to posledná fáza, v ktorej môžu správcovia úplne previesť BroadWorks na veľkoobchod. Nástroj na poskytovanie musíte spustiť s argumentom postmigration.

Denníky terminálu

Nasledujú protokoly v termináli o úspešnom poskytovaní:

Názov nástroja: Verzia nástroja na poskytovanie: 1.15.0 ********** Začalo sa spracovávať súbor: input/customer.json **************** Poskytujúci zákazník Čaká sa na zákazníka external_id_engg_grp1 na dokončenie poskytovania... Čaká sa, kým zákazník external_id_engg_grp1 dokončí poskytovanie...   Stav zákazníka external_id_engg_grp1 : zabezpečované Provisioning Numbers Provisioning Users Provisioning User Features Provisioning Pozdravy Provisioning Schedule Provisioning Devices Provisioning Shared Call Vzhľad Provisioning Auto Attendant Provisioning Call Questing Provisioning Hunt Groups Provisioning Group Stránkovanie Poskytovanie parkovísk hovorov Zabezpečenie preberania hovorov Zabezpečenie pre hlasový portál ********** Dokončené Súbor : input/customer.json ****************** 

Vytlačí sa tabuľka s počtom miest vytvorených pre každý cyklus:

Výstup

Nástroj na poskytovanie generuje správy o úspechu a chybách v súboroch output/<external_id>/*.success/error . Prezrite si úspešnosť výstupu a protokoly chýb a overte úspešné poskytovanie.

Správcovia partnerov môžu overiť poskytovanie služieb zákazníkom na portáli Partner Hub a Control Hub. Pozrite si nasledujúce ilustrácie z portálu Partner Hub a Control Hub:

Obrázok 8: Partnerské centrum

Obrázok 9: Ústredňa (Control Hub)

Obrázok 10: Zariadenia

Obrázok 11: Volanie

Pre BroadCloud

Pre partnerov BroadCloud použite portál poskytovateľa služieb na odoslanie žiadosti o migráciu čísel, zariadení a migrácií SCA.

V rámci portálu poskytovateľa služieb môže žiadosť o migráciu zahŕňať až 50 zákazníkov. V priebehu dňa je možné podať maximálne 10 žiadostí.

Obrázky nižšie zobrazujú portál poskytovateľa služieb.

Obrázok 12: Portál poskytovateľa služieb

Obrázok 13: Portál poskytovateľa služieb

Pre Cisco BroadWorks a Webex pre BroadWorks

V prípade migrácií Cisco BroadWorks a Webex for BroadWorks nástroj beží na sekundárnom aplikačnom serveri Cisco BroadWorks v rámci partnerskej siete a pripája sa k AS cez OCI-P. Používa výstupný súbor JSON (customer.json) nástroja Transform Tool ako vstup a spúšťa príkazy OCI-P na migráciu zariadení a softvérových klientov.

Po úspešnej operácii nástroj na presun zariadenia:

1. Zrušte registráciu zariadení z Cisco BroadWorks a zaregistrujte ich vo veľkoobchode.
2. Používatelia používajúci klienta UC-One sa pri prvom prihlásení presmerujú na aplikáciu Webex.
3. Deaktivujte telefónne čísla od Cisco BroadWorks alebo odstráňte telefónne čísla z BroadCloud.
4. Aktivujte si čísla vo Veľkoobchode.
5. Vytvorte zdieľané vzhľady hovorov vo veľkoobchode pre migrácie BroadCloud. [Tento krok platí len pre migrácie BroadCloud].

SCP a SSH

1. SCP nástroj na presun zariadenia na sekundárny aplikačný server Cisco BroadWorks.
2. SSH na sekundárny aplikačný server Cisco BroadWorks na konfiguráciu predpokladov a spustenie nástroja na presun zariadenia.

Predpoklady

1. Nastavte REFRESH_TOKEN (token skopírovaný z nástroja na generovanie tokenov) v súbore conf/partner.cfg:

   OBNOVIŤ_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Uistite sa, že sekundárne ID používateľa Cisco BroadWorks Application Server, heslo a názov hostiteľa sú v súbore conf/deviceMoveTool.conf správne:

   BROADWORKS_USER_ID = administrátor BROADWORKS_HESLO = administrátor BROADWORKS_HOSTITEĽ_NAME = localhost 

3. Overte správnosť cesty k prostrediu JDK/JRE na stránke devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. Administrátori môžu použiť súbor locations.csv zo vstupného adresára na migráciu špecifických skupín namiesto všetkých skupín v rámci podniku.

Telefóny Polycom

Ak chcete presunúť telefóny Polycom zo služby Cisco BroadWorks do služby Wholesale Calling, správca partnera musí vytvoriť nový súbor typu profilu identity/zariadenia na úrovni systému v šablóne Cisco BroadWorks každého zariadenia Polycom. Pozrite si obrázok 14 a odovzdajte súbor vlastného súboru device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Po nahraní nového súboru zariadenia sa uistite, že novovytvorený súbor existuje na úrovni skupiny. Tiež sa uistite, že súbor migration_%BWMAC ADDRESS%.cfg nie je v konflikte so žiadnym existujúcim súborom vo vašom systéme).

Používa sa interne nástrojom na presun zariadenia.

Proces migrácie pre telefóny Polycom:

1. Nástroj na presun zariadenia nahradí súbor %BWMACADDRESS%.cfg na úrovni zariadenia súborom polycom_vvx2.cfg. Upozorňujeme, že tento súbor odkazuje na migration_%BWMACADDRESS%.cfg.
2. Obnovte profily zariadenia na úrovni skupiny alebo zariadenia.
   Konanie na úrovni skupiny alebo zariadenia závisí od konfigurácie parametra deviceLevelRebuild v súbore device-move-tool/conf/partner.cfg.
3. Nástroj na presun zariadenia požiada aplikačný server Cisco BroadWorks o reštartovanie telefónov na úrovni skupiny alebo zariadenia.
4. Po požiadavke na reštart telefóny Polycom prevezmú a spracujú súbor% BWMACADDRESS%.cfg, ktorý požiada telefóny Polycom o stiahnutie a spracovanie súboru migration_%BWMACADDRESS%.cfg, čím sa parameter device.prov.serverName nastaví na hodnotu https://plcm.sipflash.com.
   https://plcm.sipflash.com pre región USA majú iné oblasti iné adresy URL.
5. Telefón Polycom stiahne súbor %BWMACADDRESS%.cfg z lokality https://plcm.sipflash.com a bude spravovaný službou Webex Calling DMS.

Obrázok 14: Pridať súbor typu profilu identity/zariadenia

Pokyny na spustenie

Existujú dva spôsoby vyvolania DMT, prvým je vyvolať naraz prostredníctvom jedného zákazníka a druhým je spustiť súčasne viacerých zákazníkov.

Nástroj na presun zariadenia sa spúšťa zo sekundárneho aplikačného servera Cisco BroadWorks v adresári nástroja na presun zariadenia:

Pre presun zariadenia jedného zákazníka: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Pre presun viacerých zákazníkov: . /devicemove.sh -input= ls -l /tmp/adresár zákazníkov/ customer1.json customer2.json customer3.json Nástroj na presun zariadenia navyše podporuje migráciu jedného alebo konkrétneho telefónu( s) od vydania 1.35.0. Použite príkaz uvedený nižšie: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Denníky terminálu

Nasledujú protokoly v termináli o úspešnom spustení nástroja na presun zariadenia na migráciu zariadenia:

Názov nástroja: Verzia nástroja na presun zariadenia: 1.15.0 Device Tool Spustený... Platné zariadenia na migráciu: -------------------------------------------------- -------------------------------------------------- --------------- | Typ zariadenia | Mac | Verzia | E-mail | ---------------- -------------------------------------------------- -------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6861 54821BCAE71}548 }Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | F87B204E4066 | Cisco/31CP-838Cisco/31CP-838Cisco-31CP-83 _f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ---------------------------------- -------------------------------------------------- -------------------------------- Chcete migrovať všetky tieto zariadenia?|| ([Á]áno alebo [N]nie) áno Nahrávanie profilov zariadení pre DMS Cisco MPP LC Proces obnovy zariadenia spustený Proces obnovy zariadenia bol úspešne dokončený Proces reštartovania bol spustený Proces reštartovania bol úspešne dokončený Úprava profilov pre Business Communicator v rámci skupinového collabmigrationtestGRP_engg Aktivovať webex telefón spustený proces čísel pre zákaznícke org ID: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Proces aktivácie telefónnych čísel pre webex bol dokončený pre ID organizácie zákazníka: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Deaktivácia procesu telefónnych čísel Broadworks spusteného pre groupId : collabmigrationtestGRP_engg Proces deaktivácie broadworks telefónnych čísel dokončený pre groupId : collabmigrationtestGRP_engg Migrácia zariadenia dokončená 

Výstup

Po migrácii zariadenia sú zariadenia online a pripravené na uskutočňovanie/prijímanie hovorov. Pozrite si obrázok 15, kde nájdete príklad stavu zariadenia:

Obrázok 15: Stav zariadenia

Po migrácii zariadenia sa čísla aktivovali. Pozrite si obrázok 16, kde nájdete príklad aktívnych čísel:

Obrázok 16: Čísla sú aktívne

Operácia vrátenia musí byť vykonaná pre jeden podnik naraz.

Pre operátora BroadCloud

Proces vrátenia pre partnerov BroadCloud je nasledovný:

1. Otvorte lístok pomocou Cisco TAC a požiadajte o vrátenie zariadenia.
2. Spustite nástroj na presun zariadenia v režime návratu:
   • Priradenie telefónnych čísel z Webex Calling bude zrušené a používateľom a službám zostanú iba klapky.
   • E-mailové adresy v službe Webex Calling budú vrátené na dočasné e-mailové adresy.
   • Telefóny budú vymazané z Webex Calling.
   • Telefónne čísla, e-mailové adresy používané ako alternatívne identifikátory a telefóny budú znova vytvorené v BroadCloud.
   • Telefóny budú reštartované.
3. Správcovia partnerov musia presunúť telefónne čísla PSTN späť do služby BroadCloud Carrier.

Pre Cisco BroadWorks a Webex pre BroadWorks

Proces vrátenia pre Cisco BroadWorks a Webex pre BroadWorks je nasledovný:

1. Otvorte lístok pomocou Cisco TAC a požiadajte o vrátenie zariadenia.
2. Spustite nástroj na presun zariadenia v režime vrátenia na sekundárnom serveri BroadWorks Application Server, aby ste vrátili migrácie zariadení. Týmto sa adresa URL DMS nastaví späť na adresu URL DMS poskytovateľa služieb pre profily zariadení v Cisco BroadWorks a znova sa aktivujú telefónne čísla.
3. Webex Calling Team nastaví DMS URL späť na DMS URL poskytovateľa služieb v profiloch zariadení v Webex Calling.
4. Správcovia partnerov musia deaktivovať alebo vymazať telefónne čísla vo Webex Calling prostredníctvom portálu Control Hub.
5. Správcovia partnerov musia presunúť telefónne čísla PSTN späť do Cisco BroadWorks.

Pokyny na spustenie nástroja na presun zariadenia v režime návratu

Ak chcete spustiť nástroj na presun zariadenia v režime návratu, postupujte podľa nasledujúcich krokov:

Spustite príkaz uvedený nižšie na sekundárnom aplikačnom serveri Cisco BroadWorks v adresári nástroja na presun zariadenia:

Vrátiť späť profily

./devicemove.sh -input=  -revertProfiles

Vrátiť čísla

./devicemove.sh -input=  -revertNumbers

Denníky terminálu

O úspešnom spustení nástroja na presun zariadenia na vrátenie operácie získame v termináli nasledujúce protokoly:

Vrátiť späť profily

Názov nástroja: Verzia nástroja na presun zariadenia: 1.15.0 Nástroj Device spustený pre proces vrátenia... Zariadenia, ktoré je možné presunúť späť z Webex Calling do BroadWorks: ------------------------------------------------- -------------------------------------------------- ---------------- | Typ zariadenia | Mac | Verzia | E-mail | --------------- -------------------------------------------------- -------------------------------------------------- – | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 54821 15 7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | --------------------------------- -------------------------------------------------- --------------------------------- Chcete tieto zariadenia presunúť späť z Webex Calling na BroadWorks?||__||||| (Áno, Y, Nie, N):  áno Nahrávanie profilov zariadení pre DMS Cisco MPP LC Proces obnovy zariadenia spustený Proces obnovy zariadenia bol úspešne dokončený Proces reštartovania bol spustený Proces reštartovania bol úspešne dokončený Migrácia zariadenia dokončená pre proces zrušenia 

Vrátiť čísla

Názov nástroja: Verzia nástroja na presun zariadenia: 1.15.0 Chcete pokračovať v vrátení čísel do Broadworks?  ([Áno] alebo [Nie] nie):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551105, +51525,515125 05551110] Spúšťa sa návrat Spustenie procesu aktivácie broadworks telefónnych čísel pre groupId: collabmigrationtestGRP_engg Proces aktivácie telefónnych čísel Broadworks bol dokončený pre groupId : collabmigrationtestGRP_engg Proces migrácie zariadenia bol úspešne dokončený