Nástroje pro migraci na přechod z řešení Broadworks, Webex pro Broadworks a Broadcloud na velkoobchodní řešení RTM

Podporované telefony budou automaticky vytvořeny a přiřazeny uživatelům ve službě Webex Calling pomocí zřizovacího nástroje. Když je nástroj pro přesun zařízení spuštěn, telefony označené „ano“ ve sloupci „Podporováno v nástroji pro přesun zařízení“ budou také automaticky přesunuty ze služby Cisco Broadworks nebo Broadcloud do služby Webex Calling. Telefony označené v tomto sloupci „Ne“ potřebují ruční zásah ke změně adresy URL DMS v šabloně zařízení Cisco Broadworks nebo v samotném telefonu.

Poslední sloupec poskytuje mapování modelů telefonů na sloupec „Typ zařízení“ souboru transform-tool/input/newphones.csv. (Další informace o newphones.csv najdete v části Nástroj transformace tohoto článku.)

Správci partnerů spustí tento nástroj generátoru tokenů alespoň jednou před spuštěním nástrojů migrace. Spuštění tohoto nástroje je jednorázová aktivita po připojení partnerského účtu k řešení Wholesale RTM. Tento nástroj umožňuje správcům partnerů přihlásit se prostřednictvím webového prohlížeče a získat jedinečný TOKEN potřebný k aktualizaci konfiguračních souborů partnera pro nástroje migrace.

Požadavky

Po stažení extrahujte binární soubory nástrojů migrace.

Nastavte cestu prostředí JRE/JDK v souboru token_generator.sh pro MAC a token_generator.bat pro Windows. Pokud cesta k JAVA_HOME již existuje, bude nástrojem znovu použita.

• GUMÁK: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

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

Pokyny ke spuštění

Spusťte následující příkaz v terminálu uvnitř adresáře generátoru tokenů:

Windows:

token_generatorBAT

Systém Macos:

./token_generator.š

Výstup:

Název nástroje: Verze nástroje generátoru tokenů: 1.13.0 Načíst adresu URL ve webovém prohlížeči: http://localhost:8080 

Otevřete adresu URL ve webovém prohlížeči na terminálu, přihlaste se pomocí přihlašovacích údajů správce partnera, získejte token a zkopírujte jej pro další použití.

Ilustrace uživatelského rozhraní jsou uvedeny níže pro referenci:

Obrázek 3: Přihlásit se pomocí služby Cisco Webex

Obrázek 4: Okno přihlašovacích údajů

Obrázek 5: Generování tokenů

Před spuštěním nástrojů extrakce a přesunu zařízení na sekundárním serveru Broadworks nakonfigurujte následující kroky.

Povolit připojení OCI-P

Nástroj pro přesun zařízení komunikuje se službou Broadworks prostřednictvím příkazů OCI-P, aby bylo možné připojení OCI-P povolit pomocí následujících kroků:

Krok 1: Pomocí rozhraní příkazového řádku nakonfigurujte obecná nastavení.

Spusťte následující příkaz v rozhraní příkazového řádku pro změnu do adresáře Settings:

AS_CLI> cd /Applications/Open Server/ Settings.

Spusťte v rozhraní příkazového řádku následující příkaz, abyste získali aktuální nastavení :

AS_CLI/Applications/OpenClientServer/GeneralSettings> získat Port = 2208 Portenabled = true Port = 2209 Portenabled = true Domain = <> 

Pokud nastavení neodpovídají výše uvedenému, použijte příkaz set k překonfiguraci nastavení.

Krok 2: Pomocí rozhraní příkazového řádku nakonfigurujte proxy server OCI.

Změna adresáře na OCI Proxy:

AS_CLI> cd /Applications/Open Server/OCIProxy

Chcete-li získat aktuální nastavení, spusťte následující rozhraní příkazového řádku. Měli byste vidět následující:

AS_CLI/Applications/OpenClientServer/OCIProxy> zapnuto = true Screening = false Caching = false Cache Hours = 24 CacheRenew Min = 30 QueueCapacity = 50 QueueTimeoutseconds = 1800 

Pokud nastavení neodpovídají výše uvedenému, použijte příkaz set k překonfiguraci nastavení.

Krok 3: Pomocí rozhraní příkazového řádku nakonfigurujte zřizování OCI.

Změna adresáře zřizování:

AS_CLI> cd /System/ Accesslists/OCI/Provisioning

Spusťte následující příkaz a získejte aktuální nastavení zřizování OCI:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> získat Popis adresy ======================== 127.0.0.1 místní jako 

Krok 4: Spusťte níže uvedený příkaz v rozhraní příkazového řádku a ověřte správnost konfigurace.

 AS_CLI/Maintenance/ Objects> získejte broadworks a zkontrolujte, zda je váš výstup v pořádku. Ukázkový výstup viz níže: AS_CLI/Maintenance/ Objects> získejte spravované objekty broadworks Broadworks ========================== * Server: Identita..............: Verze AS...............: Rel_21.sp1_1.551 Správní stát..: Odemčené * Aplikace: Název Verze Nasazeno Správní stav Efektivní stav ========================================================================================= Andprovisioning 21.sp1_1.551 true Unlocked Unlocked Unlocked Policy 21.sp1_1.551 false Unlocked Stopped Open Server 21.sp1_1.551 true Unlocked Unlocked Unlocked Webcontainer 21.sp1_1.551 true Unlocked Unlocked Unlocked Unlocked Webcontainer 21.sp14 nalezené záznamy. * Hostované aplikace: Název Verze Kontext Cesta Nasazena ================================================================== Commpilot 21.sp1_1.551 / true Files 21.sp1_1.551 / Management true JWSFiles 21.sp1_1.551 / Repos true Files 21.sp1_1.551 /media true OCIFiles 21.sp1_1.551 /ocifiles true 5 nalezených záznamů. 

Ověřit nasazený a aktivní otevřený klientský server

Použijte níže uvedené příkazy k nasazení a spuštění otevřeného klientského serveru na sekundárním aplikačním serveru, pokud není nasazený nebo ještě nebyl spuštěn.

Krok 1: Nasaďte server následujícím příkazem rozhraní příkazového řádku:

AS_CLI/Maintenance/ManagedObjects> nasazení aplikace Open Server

Krok 2: Spustit server tímto příkazem:

AS_CLI/Maintenance/ManagedObjects> spustit aplikaci Open Server

Povolit aktivaci čísel

Spusťte v rozhraní příkazového řádku následující příkazy, abyste aktivovali čísla:

Krok 1: Spustit příkaz pro aktivaci čísla:

AS_CLI> Předplatné CD Mgmt/ Aktivace

Krok 2: Spusťte příkaz aktivovaný aktivací:

AS_CLI> nastavit Režim A Uživatel Povolen

Krok 3: Na potvrzovací výzvu zadejte Y.

Pro Broadcloud

Extrakční nástroj je integrován do portálu Broadcloud Service Provider. Správce poskytovatele služeb může:

1. Odeslat žádosti o výpis až pro 50 zákazníků na žádost.
   Žádost o extrakci nelze podat stejnému zákazníkovi více než 10krát za den.
2. Stáhněte si extrahovaný datový soubor ve formátu ZIP po dobu až 28 dní od data podání žádosti.

Níže uvedená čísla zobrazují portál poskytovatele služeb.

Obrázek 6: Portál poskytovatele služeb

Obrázek 7: Portál poskytovatele služeb

Pro Cisco Broadworks a Webex pro Broadworks

1. Nástroj pro extrakci běží na sekundárním aplikačním serveru Cisco Broadworks v rámci partnerské sítě a připojuje se přes OCI-P.
2. Nástroj stahuje nezpracovaná data podniku, skupiny, čísel, uživatelů, služeb, zařízení a měkkých klientů z platformy Cisco Broadworks nebo Broadcloud a odesílá tato data do souborů XML, které poskytují vstupy pro nástroj transformace.

Další části vysvětlují, jak nainstalovat a nakonfigurovat nástroj extrahování.

Požadavky

1. SCP nástroj extrahuje binární soubory na sekundární aplikační server Cisco Broadworks.
2. SSH na sekundárním aplikačním serveru Cisco Broadworks ke konfiguraci předpokladů a spuštění nástroje pro extrakci.
3. Nakonfigurujte ID poskytovatele služeb a skupiny tak, aby bylo možné extrahovat z aplikace Cisco Broadworks v souboru conf/exportTool.yml. Viz níže ukázkový úryvek YAML:

   ID-A:      - ID-A1 - <UNK> ID-A2 - ID-A3 ID-B:                        - VŠE 

4. Ověřte správnost sekundárního ID uživatele aplikačního serveru Cisco Broadworks, hesla a názvu hostitele v souboru conf/partner.cfg:

   ID _UŽIVATELE BROADWORKS_USER = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = obnovovací token správce partnera zkopírován z nástroje Token Generator. MIGRAČNÍ_REŽIM = podporované hodnoty jsou webex_for_broadworks_to_wholesale. Výchozí hodnota je broadworks_to_wholesale. Použijte webex_for_broadworks_to_wholesale pro migraci služby Webex pro Broadworks. 

   Vlastnost TOKEN REFRESH_TOKEN je pro migraci služby Webex pro Broadworks povinná.

5. Upravte cestu prostředí JDK/JRE v souboru export.sh, pokud se cesta prostředí JDK/JRE sekundárního aplikačního serveru Cisco Broadworks liší od souboru:

   JAVA_HOME=/usr/local/java/java_base

Pokyny ke spuštění

Spusťte níže uvedený příkaz na sekundárním aplikačním serveru Cisco Broadworks z adresáře nástrojů extrahování:

./export.sh

Protokoly terminálů

Při úspěšném exportu jsou v terminálu k dispozici následující protokoly: Spuštěný nástroj pro export dat Broadsoft:

 Spouštění nástroje pro export dat Broadsoft ************************************************ Spouštění nástroje pro export v: 1.15.0 Export zahájen pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export uživatelů pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export uživatelů dokončen pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export dokončen pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export dokončen Export Dump Zip Directory : output/20221017223452_ExportTool Export Dump Zip Název souboru :extracted_data_1666060500618.zip Soubor ZIP s názvem extracted_data_1666060500618.zip byl vytvořen Proces vytváření souborů ZIP dokončen Exportované soubory převedeny jako soubor ZIP ************************************************** 

Výstup

Ve stejném adresáři nástrojů rozbalování bude k dispozici výstupní soubor ZIP (extracted_data_.zip). Použijte příkaz níže k zobrazení a použití souboru ZIP pro vstup nástroje pro transformaci:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 říj  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 říj  4 11:53 exportovat Tool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 říj  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 říj  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 Oct 17 22:34 výstup/ drwxrwxr-x 2 bwadmin bwadmin 4096 Oct 17 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 Oct 17 22:35 extracted_data_1666060500618.zip 

Tento nástroj transformace je spuštěn pro všechny migrace. Nástroj transformace běží na jakémkoli počítači, včetně notebooku správce partnera, a používá Webex Public API. Přečte výstupní soubor ZIP (extracted_data_.zip) nástroje jako vstup a transformuje surové XML do formátu JSON, který zřizovací nástroj používá.

Požadavky

Po stažení a extrahování binárních souborů nástrojů migrace nakonfigurujte následující předpoklady:

1. V souboru conf/partner.cfg nastavte token REFRESH_ (Token zkopírovaný z nástroje Token Generator Tool) a NÁZEV__HLAVNÍHO_UMÍSTĚNÍ:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVh gwNGUtZjQ1NTEyZTViNzJkOTDJ NÁZEV_HLAVNÍHO_UMÍSTĚNÍ_=Hlavní 

2. Volitelně nastavte ID_zřizování (zkopírované ze šablony v centru Partner) v souboru conf/partner.cfg:

   ZŘIZOVÁNÍ_ID=YmE4MjfkZGYTYTlkNy00 LWIWODCTYMNKOTM2NjUyYWQ1

   Chcete-li získat úplnější ověření e-mailové adresy zákazníka, můžete volitelně nastavit ID_ zřizování.
3. Pokud chybí, nakonfigurujte chybějící informace v souboru input/customers.csv (viz další část).
4. Do souboru input/users.csv přidejte e-mailovou adresu koncového uživatele.
5. Pokud mají být zřízeny nové telefony, přidejte do souboru input/newphones.csv adresu mac a e-mailovou adresu nového telefonu uživatele. To je nutné pouze v případě, že správci partnera chtějí zřídit nové telefony ve velkoobchodním volání.
6. Převeďte call centra Broadworks do Cxessentials pomocí souboru input/cxessentials.csv.
7. Volitelně povolte UPGRADE_VŠECH_CALL_CENTER_NA_CX_ESSENTIALS a převeďte všechna Call centra na Cxessentials.
8. Použijte soubor input/locations.csv k podpoře migrace velkých podniků, která správcům umožňuje migrovat umístění svých zákazníků podle umístění
9. Volitelně povolte použití adres MAC z hlavičky User-Agent zprávy SIP REGISTER, pokud adresa MAC není k dispozici v profilu zařízení Cisco Broadworks. Odkomentovat řádek „USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes“ v souboru conf/partner.cfg

Vyplnění vstupu/customers.csv

Soubor input/customers.csv poskytuje data, která možná chybí v aplikaci Cisco Broadworks nebo Broadcloud. Tento soubor může být ponechán prázdný, pokud jsou již dostupné všechny povinné informace. Nemusíte vyplňovat všechny sloupce, pouze chybějící informace jsou povinné.

Níže uvedená tabulka vysvětluje nejdůležitější sloupce v input/customers.csv.

Pokyny ke spuštění

Spusťte nástroj transformace v jakémkoli operačním systému. Ke spuštění nástroje v systému Windows a Mac OS použijte následující kroky:

Windows

Spusťte níže uvedený příkaz a spusťte nástroj pro transformaci v systému Windows:

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

macOS

Proveďte následující kroky pro spuštění nástroje transformace v systému MacOS:

1. Vytvoření virtuálního prostředí a instalace závislostí pro spuštění nástroje transformace pomocí jazyka Python:

   python3 -m venv venv zdroj venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. Spusťte nástroj pro transformaci:

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

Předběžná kontrola zákazníka/uživatele

Nástroj pro transformaci volá rozhraní API do služby Webex, aby zachytil potenciální problémy se zřizováním. Ve výchozím nastavení ověří adresu zákazníka a primární e-mail. Pokud je hodnota ID zřizování_zadána v souboru conf/partner.cfg, ověří se také informace o umístění. Výsledky předběžné kontroly jsou zahrnuty ve zprávě o výjimkách.

Kromě toho lze při spuštění nástroje pro transformaci přidat následující volitelné parametry:

předběžná kontrola

Kromě spuštění rozhraní API předběžné kontroly pro informace o zákazníkovi spustí nástroj Transform také rozhraní API předběžné kontroly pro e-maily odběratele.

přednastavené informace

Ve výchozím nastavení jsou do zprávy o výjimce zahrnuty pouze chyby předběžné kontroly (tj. problémy, které blokují zřizování). Přidání tohoto příznaku bude zahrnovat také úspěšné výsledky předběžné kontroly (např. pokud již existuje organizace Webex, kterou lze automaticky připojit).

Protokoly terminálů

Následující protokoly v terminálu při úspěšné transformaci:

Podniky Broadworks, které lze úspěšně migrovat: 1 Podniky Broadworks, které nelze migrovat: 0 uživatelů Broadworks, kteří lze úspěšně migrovat: 4 uživatelé Broadworks, kteří nemohou být migrováni: 0 Telefony, které lze úspěšně migrovat: 3 Telefony, které nejsou kompatibilní s Webex Calling: 0 

Zpráva o výjimkách

Nástroj Transform vygeneruje zprávu o výjimce uvnitř adresáře output//exception_report.txt . Tuto zprávu můžete použít k identifikaci problémů, které budou mít vliv na migraci, a k jejich odstranění v systému Cisco Broadworks.

Po úpravě uživatelských dat pro vyřešení výjimky znovu spusťte nástroje Extrahovat a transformovat s novými daty. Ukázkový soubor zprávy o výjimce:

Zpráva o výjimce Út Oct 18 08:12:09 2022 Podniky s omezením komunikace Doporučení funkce: ručně nakonfigurujte plán odchozích hovorů v prostředí Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Výstup

Výstupní soubor JSON (customer.json) bude k dispozici v adresáři output// . Ukázkový soubor customer.json je následující:

{ "customer": { "Provisioningid": "!!!!!!!!!!REPLACE_S_ZŘIZOVÁNÍ!!!!!!!!!!", "balíčky": [ "webex_calling", "common_area_calling" ], " Id": "external_id_engg_grp1", "adresa": { " Line1": "100 Main Street", " Line2": "", "město": "Gaithersburg", "stateOrprovince": "MD", " Or Code": "20877", "country": "US" }, " Info": { "name": "Engineering Group - 1", " Email": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningparametry": { "calling": { "location": { "name": "Main", "address": { " Line1": "100 Main Street", " Line2": "", "city": "Gaithersburg", "stateOrprovince": "MD", " Or Code": "20877", "country": "US" }, "timezone": "America/New_York", "jazyk": "en_us", "čísla": [ "+1520551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainnumber": "+15205551101" } } }, "broadworks_info": {"service_provider_id": "collabmigrationtestovací SP_engg", "group_id": "collabmigrationtestovací GRP_engg" }, "předplatitelé": [ { "amareswaranvel+benjaminjack@gmail.com": { "odběratel": { " Id": "!!!!!!!!!!NAHRADIT_S_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "balíček": "webex_calling", "Parametry zřizování": { " Name": "Benjamin", " Name": "Jack", " Number": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personid}/features/voicemail": { "enabled": true, „Hovory “: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „ Un Hovory“: { „enabled“: true, "pozdrav": "VÝCHOZÍ", " Ofrings": 3 }, „ Úložiště“: { „mwienabled“: true, „ Type“: „EXTERNAL“, „ Email“: „engineering17861@mailnator.com“ } } } ], „devices“: [ { „ Uuid“: "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", „product“: „DMS Cisco 7861“, „mac“: „CC98914EAAD7“ } ] } }, { „amareswaranvel+lucasoliver@gmail.com“: { „subscriber“: { „ Id“: "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!", „email“: „amareswaranvel+lucasoliver@gmail.com“, „package“: „webex_calling“, „provisioningparameters“: { „ Name“: „Lucas“, „ Name“: „Oliver“, „ Number“: „+15205551103“, „extension“: „1103“ } }, „features“: [ { "/v1/people/{personId}/features/voicemail“: { „enabled“: true, „Hovory “: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „ Un Hovory“: { „enabled“: true, "pozdrav": "VÝCHOZÍ", " Ofrings": 3 }, „ Úložiště“: { „mwienabled“: true, „ Type“: „EXTERNAL“, „ Email“: „engineering16821@mailnator.com“ } } } ], „devices“: [ { „ Uuid“: "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", „product“: „DMS Cisco 6821“, „mac“: „5486BCAE7E45“ } ] } }, { „amareswaranvel+leojackson@gmail.com“: { „subscriber“: { „ Id“: "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!", „email“: „amareswaranvel+leojackson@gmail.com“, „package“: „webex_calling“, „provisioningparameters“: { „ Name“: „Leo“, „ Name“: „Jackson“, „ Number“: „+15205551104“, „extension“: „1104“ } }, „features“: [ { "/v1/people/{personId}/features/voicemail“: { „enabled“: true, „Hovory “: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „ Un Hovory“: { „enabled“: true, "pozdrav": "VÝCHOZÍ", " Ofrings": 3 }, „ Úložiště“: { „mwienabled“: true, „ Type“: „EXTERNAL“, „ Email“: „engineeringmacpc@mailnator.com“ } } } ], „devices“: [] } }, { „amareswaranvel+owenalex@gmail.com“: { „subscriber“: { „ Id“: "!!!!!!!!!!NAHRADIT_ZA_CUSTOMERID!!!!!!!!!!", „email“: „amareswaranvel+owenalex@gmail.com“, „package“: „webex_calling“, „provisioningparameters“: { „ Name“: „Owen“, „ Name“: „Alexander“, „ Number“: „+15205551101“, „extension“: „1101“ } }, „features“: [ { "/v1/people/{personId}/features/voicemail“: { „enabled“: true, „Hovory “: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „ Un Hovory“: { „enabled“: true, "pozdrav": "VÝCHOZÍ", " Ofrings": 3 }, „ Úložiště“: { „mwienabled“: true, „ Typ“: „EXTERNÍ“, „ Email“: „engineering8811@mailnator.com“ } } } ], „zařízení“: [ { „ Uuid“: "!!!!!!!!!!REPLACE_S_PERSONID!!!!!!!!!!", "výrobek": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "rozvrhy": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Automated Voice Portal", " Name": "Automated", " Name": "Voice Portal", " Code": "en_us", " Číslo": "+15205551105", "linka": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "umístění: [],"webex_for_broadworks_info": { "users": [ { "id": "Y2lzy29zc yazovL3VzL1NVQlNDUKLCRVIvY2QzNGViNWYtYTVmMi00OWQ1 lkNWMt g1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzy29zc yazovL3VzL09SR0FOSVPPBVELPTi9jMjJiYTMwNC1mODQ4LTRlOT YWFmYy0zYWRlMj YTgz g", "hydra_customer_config_id": "Y2LZY29ZC yazovL3VzL0VOVEVSUFJJU0 YmIyMzA1MDETMtuzMS00MzNi llM2 ODExY2FlYTExYmVk" } } 

Zřizovací nástroj může běžet na jakémkoli počítači, obvykle v notebooku správce partnera, a používá Webex Public APIs. Načte soubor výstupního nástroje JSON (customer.json) jako vstup a zřizuje zákazníky, pobočky, čísla, uživatele, služby a zařízení v řešení Webex Wholesale RTM.

Požadavky

V adresáři zřizovacích nástrojů nakonfigurujte následující předpoklady:

1. Do počítače nainstalujte jazyk Java 8, 11 nebo 17. Java je k dispozici z mnoha zdrojů, včetně:
   • 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 stažení a extrahování binárních souborů nástrojů migrace nastavte proměnnou prostředí JAVA_HOME do provisioning_tool.sh pro MAC a provisioning_tool.bat pro Windows.
3. Soubor partner.cfg:
   • Nastavte ID_VELKOOBCHODNÍHO_PROVISIONING a REFRESH_TOKEN (Token zkopírován z nástroje Token Generator Tool). Správci partnera se musí obrátit na svůj tým účtů a získat ID_zřizování:

     ID_VELKOOBCHODNÍHO_ZŘIZOVÁNÍ = Y2U4YWQxYm MWZlny00NjRiLWExMmItMGJkODMZN2U5 U0 REFRESH_TOKEN=MzwYjljODEtYmQ4MS00NGVh gwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Nastavte možnost POVOLIT_ADMIN_INVITE_E-MAILY na nepravdivé, pokud partner nechce uživatelům odesílat uvítací e-maily. Výchozí hodnota je true.

4. Pomocí vlastnosti WEBEX4BWKS_EMAIL_SUBJECT pro migrace Webex pro Broadworks odešlete předmět e-mailu s žádostí o změnu hesla pro předplatitele Webex pro Broadworks.
5. Pomocí vlastnosti WEBEX4BWKS_EMAIL_BODY pro Webex pro Broadworks můžete odeslat tělo e-mailu s žádostí o změnu hesla pro předplatitele Webex pro Broadworks.

Pro migraci Broadcloud stejná oblast:

1. Nástroj přeskočí zřizování čísel, zařízení a zobrazení sdílených hovorů.
2. Nástroj vytvoří uživatele a virtuální uživatele s linkou a dočasnou linkou.

Pro migraci Broadcloud jiná oblast:

1. Nástroj zřídí čísla, zařízení a zobrazení sdílených hovorů.
2. Nástroj vytvoří uživatele a virtuální uživatele se skutečnými telefonními čísly a linkami.
   Všechny migrace Broadcloudu Europe jsou do jiného regionu.

Pokyny ke spuštění

Ke spuštění nástroje v systému Windows a Mac OS použijte následující kroky:

Windows

Pro spuštění nástroje v operačním systému Windows proveďte následující kroky:

Zřídit jednoho zákazníka: provision.bat -input= Pro poskytnutí více zákazníků: provision.bat -input= 

macOS

Spusťte nástroj v systému mac OS pomocí následujících kroků:

Zřídit jednoho zákazníka: ./transform.sh -input= Zřídit více zákazníků: ./transform.sh -input= 

Předpoklady pro migraci služby Webex pro službu Broadworks

Správci partnerů musí aktualizovat šablonu registrace služby Broadworks pro funkce koexistence služby Webex pro službu Broadworks. Viz obrázek níže:

Spusťte nástroj zřizování s dalším argumentem pro migraci služby Webex pro Broadworks na velkoobchod.

Fáze přípravy: je výchozí fáze, ve které mohou správci zřídit uživatele Broadworks jako velkoodběratele a pokračovat v používání služby Webex pro uživatele Broadworks.

Udržovací fáze: je druhá fáze, během které mohou správci přiřadit licenci pro velkoobchod stávajícím uživatelům služby Webex pro Broadworks. Zřizovací nástroj musíte spustit s údržbou argumentů.

Fáze po migraci: Je finální fáze, kdy správci mohou zcela převést Broadworks na velkoobchod. Zřizovací nástroj musíte spustit s argumentem postmigrace.

Protokoly terminálů

Níže jsou uvedeny protokoly v terminálu při úspěšném zřizování:

Název nástroje: Verze nástroje zřizování: 1.15.0 ********** Spuštěno zpracování souboru: input/customer.json **************** Zřizování Zákazník Čeká na external_id_engg_grpdokončení zřizování zákazníka 1... Čeká se, až external_id_engg_grpzákazník 1 dokončí zřizování...   Stav external_id_engg_grpzákazníka 1 : zřízeno čísla Zřizování uživatelů Zřizování uživatelských funkcí Zřizování pozdravy Plány zřizování zařízení Zřizování sdílených vzhledů hovorů Zřizování automatických operátorů Zřizování front hovorů Zřizování skupin sdružených linek Skupiny sdružených linek Pagingové stránky Zřizování Parky hovorů Zřizování Zvednutí hovorů Zřizování hlasového portálu ********** Dokončený soubor: input/customer.json **************** 

Bude vytištěna tabulka s počtem poboček vytvořených pro každý běh:

Výstup

Nástroj zřizování generuje zprávy o úspěchu a chybách uvnitř souborů output/<external_id>/*.success/error . Zkontrolujte úspěšné protokoly výstupů a chyb a ověřte úspěšné zřizování.

Správci partnerů mohou zřizování zákazníků ověřit na portálu Partner Hub a Control Hub. Podívejte se na následující obrázky z portálu Partner Hub a Control Hub:

Obrázek 8: Rozbočovač partnera

Obrázek 9: Control Hub

Obrázek 10: Zařízení

Obrázek 11: Volání

Pro Broadcloud

V případě partnerů služby Broadcloud použijte portál poskytovatele služeb k odeslání žádosti o migraci čísel, zařízení a migrace SCA.

V rámci portálu poskytovatele služeb může žádost o migraci zahrnovat až 50 zákazníků. Do jednoho dne lze podat maximálně 10 žádostí.

Níže uvedená čísla zobrazují portál poskytovatele služeb.

Obrázek 12: Portál poskytovatele služeb

Obrázek 13: Portál poskytovatele služeb

Pro Cisco Broadworks a Webex pro Broadworks

V případě migrace aplikací Cisco Broadworks a Webex pro Broadworks nástroj běží na sekundárním aplikačním serveru Cisco Broadworks v rámci partnerské sítě a připojuje se k systému AS prostřednictvím protokolu OCI-P. Jako vstup používá výstupní soubor JSON (customer.json) nástroje Transform Tool a provádí příkazy OCI-P pro migraci zařízení a softwarových klientů.

Při úspěšném provozu nástroj pro přesunutí zařízení:

1. Zrušte registraci zařízení ze služby Cisco Broadworks a zaregistrujte je ve velkoobchodě.
2. Uživatelé používající klienta UC-One se při prvním přihlášení přesměrují na aplikaci Webex.
3. Deaktivujte telefonní čísla ze služby Cisco Broadworks nebo odeberte telefonní čísla ze služby Broadcloud.
4. Aktivujte čísla ve velkoobchodě.
5. Vytvoření zobrazení sdílených hovorů ve velkoobchodě pro migraci Broadcloud. [Tento krok platí pouze pro migraci služby Broadcloud].

SCP a SSH

1. SCP zařízení přesune nástroj na sekundární aplikační server Cisco Broadworks.
2. SSH na sekundární aplikační server Cisco Broadworks pro konfiguraci předpokladů a spuštění nástroje pro přesun zařízení.

Požadavky

1. Nastavte token REFRESH_ (Token zkopírovaný z nástroje Token Generator Tool) v souboru conf/partner.cfg:

   REFRESH_TOKEN=MzwYjljODEtYmQ4MS00NGVh gwNGUtZjQ1NTEyZTViNzjkOTdj

2. Ověřte správnost sekundárního ID uživatele aplikačního serveru Cisco Broadworks, hesla a názvu hostitele v souboru conf/ Tool.conf:

   ID _UŽIVATELE_BROADWORKS = admin BROADWORKS_HESLO = admin BROADWORKS_HOSTITEL_BROADWORKS = localhost 

3. Ověřte správnost cesty prostředí JDK/JRE v devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. Správci mohou použít soubor locations.csv ze vstupního adresáře k migraci konkrétních skupin namísto všech skupin v rámci podniku.

Polycom telefony

Chcete-li přesunout telefony Polycom z aplikace Cisco Broadworks do velkoobchodního volání, musí správce partnera vytvořit nový soubor typu profilu identity/zařízení na úrovni systému v každé šabloně zařízení Polycom v aplikaci Cisco Broadworks. Viz obrázek 14 a nahrajte vlastní soubor souboru device-move-tool/conf/ Profile/{region}/polycom_vvx.cfg. Po nahrání nového souboru zařízení zkontrolujte, zda nově vytvořený soubor existuje na úrovni skupiny. Ujistěte se také, že soubor migration_%BWMAC ADDRESS%.cfg není v rozporu s žádným existujícím souborem ve vašem systému.)

Používá se interně pomocí nástroje pro přesun zařízení.

Proces migrace pro telefony Polycom:

1. Nástroj pro přesunutí zařízení nahradí soubor %BWMACADDRESS%.cfg na úrovni zařízení hodnotou polycom_vvx2.cfg. Upozorňujeme, že tento soubor se týká migration_%BWMACADDRESS%.cfg.
2. Znovu vytvořte profily zařízení na úrovni skupiny nebo zařízení.
   Působení na úrovni skupiny nebo zařízení závisí na konfiguraci parametru Rebuild v souboru device-move-tool/conf/partner.cfg.
3. Nástroj pro přesun zařízení požádá aplikační server Cisco Broadworks, aby restartoval telefony na úrovni skupiny nebo zařízení.
4. Po požadavku restartu Polycom telefony stáhnou a process% BWMACADDRESS%.cfg, který požádá telefony Polycom o stažení a process migration_%BWMACADDRESS%.cfg, čímž nastaví device.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com pro oblast USA mají jiné regiony jiné .
5. Telefon Polycom stáhne %BWMACADDRESS%.cfg ze https://plcm.sipflash.com služby Webex Calling a bude jím spravován.

Obrázek 14: Typ profilu identity/zařízení přidat soubor

Pokyny ke spuštění

Existují dva způsoby, jak vyvolat DMT, první je vyvolat prostřednictvím jednoho zákazníka v čase a druhý je spustit přes více zákazníků současně.

Nástroj pro přesunutí zařízení je spuštěn ze sekundárního aplikačního serveru Cisco Broadworks uvnitř adresáře nástrojů pro přesunutí zařízení:

Pro přesun zařízení jednoho zákazníka: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Pro přesun zařízení více zákazníků: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Nástroj pro přesun zařízení navíc podporuje migraci jednotlivých/konkrétních telefonů z verze 1.35.0. Použijte následující příkaz: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Protokoly terminálů

Níže jsou uvedeny protokoly v terminálu při úspěšném spuštění nástroje pro přesun zařízení pro migraci zařízení:

Název nástroje: Verze nástroje pro přesunutí zařízení: 1.15.0 Nástroj zařízení byl spuštěn... Platná zařízení pro migraci: ------------------------------------------------------------------------------------------------------------------- | Typ zařízení | Mac | Verze | 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 | ------------------------------------------------------------------------------------------------------------------- Chcete migrovat všechna tato zařízení? ([Y] nebo [N] o) ano Nahrávání profilů zařízení pro DMS Cisco MPP LC Proces obnovy zařízení Zahájen Proces obnovy zařízení Úspěšně Dokončen Proces restartování Zahájen Proces restartování Dokončen Úspěšně Úprava profilů pro Business Communicator v rámci skupinové collabmigrationtestGRP_engg Proces aktivace telefonních čísel webex zahájen pro Id organizace zákazníka: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Byl dokončen proces aktivace telefonních čísel Webex pro ID organizace zákazníka : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Deaktivace telefonních čísel broadworks zahájena pro Id: collabmigrationtestovací GRP_engg Deaktivace telefonních čísel broadworks dokončen pro Id : Migrace_engg zařízení GRP dokončena 

Výstup

Po migraci zařízení jsou zařízení online a připravena k uskutečnění/příjmu hovorů. Příklad stavu zařízení naleznete na obrázku 15:

Obrázek 15: Stav zařízení

Po migraci zařízení byla čísla aktivní. Příklad aktivních čísel viz obrázek 16:

Obrázek 16: Aktivní čísla

Návratová operace musí být provedena vždy pro jeden podnik.

Pro Broadcloud Carrier

Zpětný proces pro partnery Broadcloud je následující:

1. Otevřete lístek v centru technické podpory Cisco a požádejte o vrácení zařízení.
2. Spusťte nástroj pro přesunutí zařízení v režimu vrácení:
   • Přiřazení telefonních čísel ze služby Webex Calling bude zrušeno, takže uživatelé a služby budou mít pouze linky.
   • E-mailové adresy ve službě Webex Calling budou vráceny na dočasné e-mailové adresy.
   • Telefony budou ze služby Webex Calling odstraněny.
   • Telefonní čísla, e-mailové adresy používané jako Alternativní ID a telefony budou v cloudu Broadcloud znovu vytvořeny.
   • Telefony budou restartovány.
3. Správci partnerů musí přesunout telefonní čísla PSTN zpět do služby Broadcloud Carrier.

Pro Cisco Broadworks a Webex pro Broadworks

Proces vrácení pro Cisco Broadworks a Webex pro Broadworks je následující:

1. Otevřete lístek v centru technické podpory Cisco a požádejte o vrácení zařízení.
2. Spusťte nástroj pro přesun zařízení v režimu vrácení na sekundárním aplikačním serveru Broadworks a vraťte tak migraci zařízení. Tato akce nastaví adresu URL DMS zpět na adresu URL DMS poskytovatele služeb pro profily zařízení v aplikaci Cisco Broadworks a znovu aktivuje telefonní čísla.
3. Tým služby Webex Calling nastaví adresu URL DMS zpět na adresu URL DMS poskytovatele služeb v profilech zařízení ve službě Webex Calling.
4. Správci partnerů musí deaktivovat nebo odstranit telefonní čísla ve službě Webex Calling prostřednictvím portálu Control Hub.
5. Správci partnerů musí přesunout telefonní čísla PSTN zpět do služby Cisco Broadworks.

Pokyny pro spuštění nástroje pro přesun zařízení v režimu vrácení

Chcete-li spustit nástroj pro přesunutí zařízení v režimu vrácení, postupujte podle níže uvedených kroků:

V sekundárním aplikačním serveru Cisco Broadworks spusťte níže uvedený příkaz v adresáři nástrojů pro přesunutí zařízení:

Vrátit profily

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

Vrátit čísla

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

Protokoly terminálů

Po úspěšném spuštění nástroje pro přesun zařízení dostaneme v terminálu následující protokoly:

Vrátit profily

Název nástroje: Verze nástroje pro přesunutí zařízení: 1.15.0 Nástroj zařízení byl spuštěn pro vrácení procesu... Zařízení, která lze přesunout zpět ze služby Webex Calling do služby Broadworks: - ------------------------------------------------------------------------------------------------------------------- | Typ zařízení | Verze || 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 | ------------------------------------------------------------------------------------------------------------------- Chcete přesunout tato zařízení z služby Webex Calling do služby Broadworks? (Ano, Y, ne, N):  ano Nahrávání profilů zařízení pro DMS Cisco MPP LC Proces přestavby zařízení Zahájen Proces přestavby zařízení Úspěšně dokončen Proces restartování Zahájen Proces restartování Úspěšně dokončen Migrace zařízení Dokončena pro proces deprovizace 

Vrátit čísla

Název nástroje: Verze nástroje pro přesunutí zařízení: 1.15.0 Chcete pokračovat ve vracení čísel do služby Broadworks?  ([Y] nebo [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Spuštění zpětného chodu Aktivace telefonních čísel Broadworks zahájen proces Id: collabmigrationtestovací GRP_engg Aktivace telefonních čísel broadworks dokončen pro Id : collabmigrationtestovací_engg proces migrace zařízení GRP Úspěšně dokončen