Podporované telefony budou automaticky vytvořeny a přiřazeny uživatelům ve službě Webex Calling pomocí nástroje zřizová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, když je nástroj pro přesun zařízení spuštěn. Telefony označené v tomto sloupci jako „Ne“ potřebují ruční zásah ke změně adresy URL DMS v šabloně zařízení Cisco BroadWorks nebo v samotném telefonu.

V posledním sloupci je uvedeno mapování modelů telefonů do sloupce „Typ zařízení“ souboru transform-tool/input/newphones.csv. (Další informace o newphones.csv naleznete v části Nástroj transformace tohoto článku.)

Správci partnera spustí tento nástroj pro generátor tokenů nejméně jednou před zahájením spuštění nástrojů pro migraci. Spuštění tohoto nástroje představuje jednorázovou aktivitu poté, co je účet partnera zaregistrován do řešení velkoobchodní cesta na trh (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 na konfigurační soubory partnera pro nástroje pro migraci.

Požadavky

Po stažení extrahujte binární soubory nástroje pro migraci.

Nastavte cestu prostředí JRE/JDK v souboru token_generator.sh pro MAC a token_generator.bat pro Windows. Pokud cesta HOME v jazyce JAVA_již existuje, nástroj ji znovu použije.

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

• Windows: JAVA_HOME=C:\Program~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

MacOS:

./token_generator.š

Výstup:

Název nástroje: Verze nástroje generátoru tokenů: 1.13.0 Načtěte adresu URL do webového prohlížeče: http://localhost: 8080 

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

Obrázky uživatelského rozhraní jsou uvedeny níže pro referenci:

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

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

Obrázek 5: Generování tokenu

Před spuštěním nástroje pro extrakci a přesun zařízení na sekundárním serveru BroadWorks nakonfigurujte následující kroky.

Povolit připojení OCI-P

Nástroj pro přesunutí zařízení komunikuje s platformou BroadWorks prostřednictvím příkazů OCI-P; chcete-li povolit připojení OCI-P, použijte následující kroky:

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

Pomocí následujícího příkazu v rozhraní příkazového řádku změňte adresář GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

Pokud vaše nastavení neodpovídá výše, proveďte opětovnou konfiguraci nastavení pomocí příkazu set .

Krok 2: Ke konfiguraci proxy OCI použijte rozhraní příkazového řádku.

Změňte adresář na proxy OCI:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Spusťte následující rozhraní příkazového řádku, abyste získali aktuální nastavení. Mělo by se zobrazit následující:

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

Pokud vaše nastavení neodpovídá výše, proveďte opětovnou konfiguraci nastavení pomocí příkazu set .

Krok 3: Ke konfiguraci zřizování OCI použijte rozhraní příkazového řádku.

Změňte na zřizovací adresář:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Spuštěním následujícího příkazu získáte 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: Pomocí níže uvedeného příkazu v rozhraní příkazového řádku ověřte správnost konfigurace.

 JAKO_CLI/Maintenance/ManagedObjects> získáte platformu BroadWorks a zkontrolujte, zda výstup vypadá v pořádku. Ukázkový výstup viz níže: JAKO_CLI/Maintenance/ManagedObjects> získat spravované objekty BroadWorks ========================== * Server: Identita..............: Verze AS...............: Rel_21.sp1_1.551 Správní stát..: Odemčené * Aplikace: Název Verze Nasazeno Administrative State Effective State ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked FlashPolicy 21.sp1_1.551 false Unlocked Stopped OpenClientServer 21.sp1_1.551 true Unlocked Unlocked WebContainer 21.sp1_1.551 true Unlocked Unlocked 4 záznamy nalezeny. * Hostované aplikace: Název Verze Kontextová cesta Nasazena ================================================================== CommPilot 21.sp1_1.551 / true DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true JWSFiles 21.sp1_1.551 /FileRepos true MediaFiles 21.sp1_1.551 /media true OCIFiles 21.sp1_1.551 /ocifiles true 5 záznamů. 

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

Pomocí níže uvedených příkazů nasaďte a spusťte otevřený klientský server na sekundárním aplikačním serveru, pokud není nasazen nebo ještě nezačal.

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

AS_CLI/Maintenance/ManagedObjects> nasadit aplikaci OpenClientServer

Krok 2: Spusťte server tímto příkazem:

AS_CLI/Maintenance/ManagedObjects> spustit aplikaci OpenClientServer

Povolit aktivaci čísel

Provedením následujících příkazů v rozhraní příkazového řádku povolte aktivaci čísel:

Krok 1: Spusťte příkaz aktivace čísla:

AS_CLI>cd SubscriberMgmt/NumberActivation

Krok 2: Spusťte příkaz povolit aktivaci:

JAKO_rozhraní příkazového řádku > nastavit skupinu režimu dnModeAndUserActivationEnabled

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

Pro službu BroadCloud

Nástroj pro extrakci je integrován do portálu BroadCloud Service Provider. Správce poskytovatele služeb může provádět tyto činnosti:

1. Odeslat žádosti o extrakt až pro 50 zákazníků na jeden požadavek.
   Žádost o výpis nelze odeslat pro stejného zákazníka více než 10krát za den.
2. Stáhněte extrahovaný datový soubor ve formátu ZIP po dobu až 28 dnů od data odeslání žádosti.

Na následujících obrázcích je zobrazen portál Poskytovatel 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 prostřednictvím OCI-P.
2. Nástroj načte nezpracovaná data o podniku, skupinách, číslech, uživatelích, službách, zařízeních a softwarových klientech z platformy Cisco BroadWorks nebo BroadCloud a exportuje tato data do souborů XML, které poskytují vstupy pro nástroj transformace.

V následujících částech je vysvětlen postup instalace a konfigurace nástroje pro extrahování.

Požadavky

1. SCP binární soubory nástroje pro extrahování na sekundární aplikační server Cisco BroadWorks.
2. SSH na sekundární aplikační server Cisco BroadWorks, nakonfigurujte předpoklady a spusťte nástroj pro extrakci.
3. Nakonfigurujte poskytovatele služeb a ID skupiny, které se mají extrahovat ze služby Cisco BroadWorks v souboru conf/exportTool.yml. Viz níže uvedený ukázkový fragment YAML:

   ID-A poskytovatele služby:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        – všechny 

4. Zkontrolujte, zda jsou v souboru conf/partner.cfg správné ID uživatele aplikačního serveru Cisco BroadWorks sekundární ID, heslo a název hostitele:

   BROADWORKS_UŽIVATELSKÉ_ID = správce BROADWORKS_HESLO = správce BROADWORKS_HOSTITEL_JMÉNO = localhost REFRESH_TOKEN = Token obnovení správce partnera zkopírovaný z nástroje Token Generator. REŽIM_MIGRACE = podporované hodnoty jsou webex_for_broadworks_to_wholesale. Výchozí hodnota je broadworks_to_wholesale. Použít webex_for_broadworks_to_wholesale pro migraci Webexu pro BroadWorks. 

   Vlastnost REFRESH_TOKEN je povinná pro migraci Webexu pro BroadWorks.

5. Upravte cestu prostředí JDK/JRE v souboru export.sh, pokud se sekundární cesta prostředí JDK/JRE serveru aplikací 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 pro extrakce nástrojů:

./export.sh

Protokoly terminálu

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:

 Spuštění nástroje pro export dat BroadSoft ************************************************ Spuštění nástroje pro export v: 1.15.0 Byl zahájen export pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export uživatelů pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export dokončených uživatelů pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export dokončen pro SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export dokončen Výpis Zip adresář : výstup/20221017223452_ExportTool Export Výpis Zip Název souboru:extracted_data_1666060Soubor ZIP 500618.zip extracted_data_1666060byl vytvořen soubor ZIP s názvem 500618.zip. Dokončen proces vytváření souboru ZIP. Exportované soubory byly převedeny jako soubor ZIP ************************************************** 

Výstup

Ve stejném adresáři nástroje pro extrakci bude k dispozici výstupní soubor ZIP (extracted_data_.zip). Pro zobrazení a použití souboru ZIP pro vstup nástroje Transformace použijte následující příkaz:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 říjen  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 říjen  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 říjen  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 říjen  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096. říjen 17 22:34 výstup/ drwxrwxr-x 2 bwadmin bwadmin 4096. říjen 17 22:34 protokoly/ -rw-rw-r-- 1 bwadmin bwadmin 46341. říjen 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á veřejná rozhraní API Webex. Přečte výstupní soubor ZIP (extracted_data_.zip) nástroje extract jako vstup a převede nezpracované XML do formátu JSON, který používá zřizovací nástroj.

Požadavky

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

1. Nastavte OBNOVOVACÍ_TOKEN (token zkopírovaný z nástroje Token Generator) a NÁZEV__HLAVNÍHO_UMÍSTĚNÍ v souboru conf/partner.cfg:

   OBNOVIT_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NÁZEV_HLAVNÍHO__UMÍSTĚNÍ=hlavní 

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

   ZŘIZOVÁNÍ_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Chcete-li dosáhnout úplnějšího ověření e-mailové adresy zákazníka, můžete volitelně nastavit _ID zřizování.
3. V případě chybějících informací nakonfigurujte v souboru input/customers.csv (viz další část).
4. Přidejte e-mailovou adresu koncového uživatele do souboru input/users.csv.
5. Chcete-li zřídit 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 v rámci velkoobchodního volání.
6. Převeďte call centra BroadWorks do CxEssentials pomocí souboru input/cxessentials.csv.
7. Volitelně povolte upgrade_VŠECHNA_CALL_CENTER_NA_CX_ESSENTIALS, abyste převedli 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 pobočky jejich zákazníků podle pobočky.
9. Volitelně povolte použití adres MAC v záhlaví User-Agent zprávy SIP registrace, když adresa MAC není v profilu zařízení Cisco BroadWorks dostupná. Odkomentujte řá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á mohou v Cisco BroadWorks nebo BroadCloud chybět. Tento soubor může být prázdný, pokud jsou již k dispozici všechny povinné informace. Nemusíte vyplňovat všechny sloupce, povinné jsou pouze chybějící informace.

Tabulka níže vysvětluje nejdůležitější sloupce v souboru input/customers.csv.

Pokyny ke spuštění

Nástroj Transform spusťte v libovolném operačním systému. Pomocí následujících kroků spusťte nástroj v systémech Windows a macOS:

Windows

Proveďte následující příkaz a spusťte nástroj Transformace v systému Windows:

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

macOS

Ke spuštění nástroje transformace v systému macOS proveďte následující kroky:

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

   python3 -m venv venv source venv/bin/aktivovat python3 -m pip instalační požadavky python3 -m pip instalační požadavky-oauthlib 

2. Spusťte nástroj transformace:

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

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

Nástroj transformace uskutečňuje volání rozhraní API do Webexu, aby se zachytily potenciální problémy se zřizováním. Ve výchozím nastavení ověří adresu a primární e-mail zákazníka. 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 do zprávy o výjimce.

Navíc lze při spouštění nástroje transformace 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é předběžné kontroly rozhraní API pro e-maily odběratelů.

informace o předběžné kontrole

Ve výchozím nastavení jsou do zprávy o výjimkách 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 služby Webex, kterou lze automaticky připojit).

Protokoly terminálu

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

Podniky BroadWorks souhrnné zprávy, které lze úspěšně migrovat: 1 podniky BroadWorks, které nelze migrovat: 0 uživatelů BroadWorks, které lze úspěšně migrovat: 4 uživatelé BroadWorks, kteří nelze migrovat: 0 telefonů, které lze úspěšně migrovat: 3 telefony, které nejsou kompatibilní se službou Webex Calling: 0 

Zpráva o výjimkách

Nástroj transformace vygeneruje zprávu o výjimce v adresáři output//exception_report.txt . Tuto sestavu můžete použít k identifikaci problémů, které mají vliv na migraci, a k jejich vyřešení v systému Cisco BroadWorks.

Po úpravě uživatelských dat, abyste vyřešili výjimku, spusťte znovu nástroje Extract a Transformation s novými daty. Vzorový soubor zprávy o výjimce je následující:

Zpráva o výjimkách Út 18 08:12:09 2022 Podniky s Communication Barring Feature Doporučení: ruční konfigurace plánu odchozích hovorů v centru Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Výstup

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

{ "zákazník": { "provisioningId": "!!!!!!!!!!NAHRADIT_s_PROVIINGID!!!!!!!!!!", "balíčky": [ "webex_calling", "common_area_calling" ], „externalId“: "external_id_engg_grp1", "adresa": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "země": "US" }, "customerInfo": { "name": "Engineering Group - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "location": { "name": "Main", "adresa": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "země": "US" }, "timezone": "America/New_York", "jazyk": "en_us", "čísla": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "hlavníČíslo": "+15205551101" } } } },"broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg„ }, „předplatitelé“: [ { „amareswaranvel+benjaminjack@gmail.com“: { „subscriber“: { „customerId“: "!!!!!!!!!!NAHRADIT_s_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "funkce": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, „sendBusyCalls“: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „sendUnansweredCalls“: { „enabled“: true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, „messageStorage“: {"mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "zařízení": [ { "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, „sendBusyCalls“: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „sendUnansweredCalls“: { „enabled“: true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, „messageStorage“: {"mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "zařízení": [ { "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Leo", "lastName": "Jackson", "primaryPhoneNumber": "+15205551104", "extension": "1104" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, „sendBusyCalls“: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „sendUnansweredCalls“: { „enabled“: true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, „messageStorage“: {"mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "zařízení": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!NAHRADIT_ZÁKAZERID_!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "funkce": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, „sendBusyCalls“: { „povoleno“: true, „pozdrav“: „VÝCHOZÍ“ }, „sendUnansweredCalls“: { „enabled“: true, "pozdrav": "DEFAULT", "numberOfRings": 3 }, „messageStorage“: {"mwiEnabled": true, „storageType“: „EXTERNAL“, „externalEmail“: „engineering8811@mailnator.com“ } } } ], „zařízení“: [ { „cisUuid“: "!!!!!!!!!!NAHRADIT_s_PERSONID „!!!!!!!!!!", produkt“: „DMS Cisco 8811“, „mac“: „F87B204E4066“ } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "plány": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Automatický hlasový portál", "firstName": "Automatický", "lastName": "Hlasový portál", "languageCode": "en_us", "phoneNumber": "+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": [], "locations": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg","hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Nástroj zřizování může běžet na jakémkoli počítači, obvykle na (notebooku správce partnera) a používá veřejná rozhraní API Webex. Přečte výstupní soubor JSON (customer.json) nástroje transformace jako vstup a zřízení zákazníků, poboček, čísel, uživatelů, služeb a zařízení v řešení Webex Wholesale RTM.

Požadavky

V adresáři nástroje pro zřizování nakonfigurujte následující požadavky:

1. Do počítače nainstalujte jazyk Java 8, 11 nebo 17. Jazyk 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 nástrojů migrace nastavte proměnnou prostředí JAVA_HOME v dokumentech provisioning_tool.sh pro MAC a provisioning_tool.bat pro Windows.
3. Soubor partner.cfg:
   • Nastavte ID_VELKOOBCHODNÍHO_ZŘIZOVÁNÍ a TOKEN_ OBNOVENÍ (token zkopírovaný z nástroje Token Generator). Správci partnera musí kontaktovat tým svého účtu, aby získali_ID zřizování:

     VELKOOBCHODNÍ_ZŘIZOVÁNÍ_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Nastavte e-maily POVOLIT_POZVÁNKU_SPRÁVCI_ na hodnotu false, pokud partner nechce uživatelům poslat uvítací e-mail. Výchozí hodnota je true.

4. Pomocí vlastnosti PŘEDMĚT E-mailu WEBEX4BWKS__PRO MIGRACI Webexu pro BroadWorks odešlete předmět e-mailu s žádostí o změnu hesla pro předplatitele Webexu pro BroadWorks.
5. Pomocí vlastnosti WEBEX4BWKS_EMAIL_BODY pro migraci Webexu pro BroadWorks odešlete text e-mailu s žádostí o změnu hesla pro předplatitele Webexu pro BroadWorks.

Pro migraci BroadCloud ve stejné oblasti:

1. Nástroj přeskočí čísla, zařízení a zřizování vzhledu sdílených hovorů.
2. Nástroj vytváří uživatele a virtuální uživatele s linkami a dočasnými linkami.

Pro migraci BroadCloud jiná oblast:

1. Nástroj poskytne čísla, zařízení a vzhled sdílených hovorů.
2. Nástroj vytváří uživatele a virtuální uživatele se skutečnými telefonními čísly a linkami.
   Všechny migrace BroadCloud v Evropě jsou do jiného regionu.

Pokyny ke spuštění

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

Windows

Chcete-li nástroj spustit v operačním systému Windows, proveďte následující kroky:

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

macOS

Ke spuštění nástroje v systému macOS proveďte následující kroky:

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

Předpoklady pro migraci Webexu pro BroadWorks

Správci partnerů musí aktualizovat svou šablonu registrace BroadWorks pro funkce koexistence Webex for BroadWorks. Viz následující obrázek:

Jakmile bude šablona registrace Webex for BroadWorks aktualizována tak, aby podporovala migraci, požádejte tým účtu Cisco, aby povolil přepínač funkce „wholesale-partner-blending-enabled“ na úrovni partnera. Tato akce umožní během zřizování přidat velkoobchodní balíčky do stávajících organizací zákazníků Webex pro BroadWorks.

Spusťte zřizovací nástroj s dalším argumentem.

Fáze přípravy: je výchozí fáze, ve které mohou správci zřídit uživatele BroadWorks jako velkoobchodního předplatitele a pokračovat v používání uživatelů Webexu pro BroadWorks.

Fáze údržby: je druhá fáze, ve které mohou správci přiřadit velkoobchodní licenci stávajícím uživatelům Webexu pro BroadWorks. Zřizovací nástroj musíte spustit s argumentem údržba.

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

Protokoly terminálu

Následují protokoly v terminálu při úspěšném zřízení:

Název nástroje: Verze zřizovacího nástroje: 1.15.0 ********** Zahájeno zpracování souboru: input/customer.json Zřizování **************** zákazníka Čeká se, až zákazník external_id_engg_grp1 dokončí zřizování... Čeká se, až zákazník external_id_engg_grp1 dokončí zřizování...   Stav external_id_engg_grpzákazníka 1: zřízená čísla pro zřizování Uživatelé pro zřizování Uživatelské funkce pro zřizování Pozdravy Plány zřizování Zřizování Zařízení Zřizování Vzhled sdílených hovorů Zřizování Automatické operátory Zřizování Fronty hovorů Zřizování Skupiny sdružených linek Skupiny zřizování Pagingové skupiny Zřizování Parkování hovorů Hromadné zpracování hovorů Zřizování Hlasový portál ********** Dokončený soubor: vstup/customer.json **************** 

Vytiskne se tabulka s počtem míst vytvořených pro každé spuštění:

Výstup

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

Správci partnerů mohou ověřit zřizování zákazníka na portálu centra Partner Hub a centra 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 službu BroadCloud

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

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

Na následujících obrázcích je zobrazen portál Poskytovatel 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

U migrace Cisco BroadWorks a Webexu 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 AS prostřednictvím OCI-P. Používá výstupní soubor JSON (customer.json) nástroje Transform Tool jako vstup a spouští příkazy OCI-P k migraci zařízení a softwarových klientů.

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

1. Zrušte registraci zařízení v rámci Cisco BroadWorks a zaregistrujte je na velkoobchodní úrovni.
2. Uživatelé používající klienta UC-One budou při prvním přihlášení přesměrováni do aplikace Webex.
3. Deaktivujte telefonní čísla z platformy Cisco BroadWorks nebo odeberte telefonní čísla z platformy BroadCloud.
4. Aktivovat čísla pro velkoobchod.
5. Vytvořte vzhled sdílených hovorů na velkoobchodním trhu pro migraci BroadCloud. [Tento krok platí pouze pro migraci BroadCloud].

SCP a SSH

1. SCP nástroj pro přesunutí zařízení na sekundární aplikační server Cisco BroadWorks.
2. SSH na sekundární aplikační server Cisco BroadWorks, aby nakonfiguroval předpoklady a spustil nástroj pro přesun zařízení.

Požadavky

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

   OBNOVIT_TOKEN=MzUwJljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_ID UŽIVATELE_ = admin BROADWORKS_HESLO = admin BROADWORKS_HOSTITEL_JMÉNO = localhost 

3. Chcete-li znovu odeslat aktivační e-maily, je třeba v souboru conf/partner.cfg nastavit možnost RESEND_INVITATION_EMAILS=true.

   Pokud správci chtějí během migrace odeslat uživatelům e-mailové pozvánky, měli by zrušit komentář vlastnosti „RESEND_INVITATION_EMAILS=true“ v souboru conf/partner.cfg. V opačném případě by měl majetek zůstat nezměněn.

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

   JAVA_HOME=/usr/local/java/java_base

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

Telefony Polycom

Aby bylo možné přesunout telefony Polycom z Cisco BroadWorks do velkoobchodního volání, musí správce partnera vytvořit nový soubor typu identity/profilu zařízení na úrovni systému v každé šabloně zařízení Polycom Cisco BroadWorks. Viz obrázek 14 a nahrajte vlastní soubor device-move-tool/conf/deviceProfile/{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 konfliktu s žádným existujícím souborem ve vašem systému.)

Používá se interně nástrojem pro přesunutí zařízení.

Proces migrace telefonů Polycom:

1. Nástroj pro přesunutí zařízení nahrazuje soubor %BWMACADDRESS%.cfg na úrovni zařízení osobou polycom_vvx2.cfg. Tento soubor odkazuje na soubor migration_%BWMACADDRESS%.cfg.
2. Přepracujte profily zařízení na úrovni skupiny nebo zařízení.
   Akce na úrovni skupiny nebo zařízení závisí na konfiguraci parametru deviceLevelRebuild v souboru device-move-tool/conf/partner.cfg.
3. Nástroj pro přesun zařízení požádá aplikační server Cisco BroadWorks o restartování telefonů na úrovni skupiny nebo zařízení.
4. Po požadavku na restart telefony Polycom stáhnou a zpracují% BWMACADDRESS%.cfg, což požádá telefony Polycom o stažení a zpracování migration_%BWMACADDRESS%.cfg, čímž nastaví device.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com pro oblast USA mají jiné oblasti různé adresy URL.
5. Telefon Polycom stáhne soubor %BWMACADDRESS%.cfg z https://plcm.sipflash.com a bude spravován pomocí řešení Webex Calling DMS.

Obrázek 14: Přidání souboru typu identity/zařízení

Pokyny ke spuštění

DMT lze vyvolat dvěma metodami. První je vyvolání prostřednictvím jednoho zákazníka současně a druhou je spuštění přes více zákazníků současně.

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

Pro přesun jednoho zákazníka zařízení: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Pro přesun více zákazníků zařízení: ./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álu

Následují protokoly v terminálu při úspěšném spuštění nástroje pro přesun zařízení k 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]es nebo [N]o) ano Nahrávání profilů zařízení pro DMS Cisco MPP LC Proces opětovného sestavení zařízení Byl zahájen Proces opětovného sestavení zařízení Byl úspěšně dokončen Proces restartování Byl zahájen Proces restartování Byl úspěšně dokončen Úprava profilů pro službu Business Communicator v rámci skupiny collabmigrationtestGRP_engg Byl zahájen proces aktivace telefonních čísel Webex pro ID organizace zákazníka: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Proces aktivace telefonních čísel Webex byl dokončen pro ID organizace zákazníka: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Byl zahájen proces deaktivace telefonních čísel Broadworks pro skupinuId: collabmigrationtestGRP_engg Proces deaktivace telefonních čísel Broadworks byl dokončen pro groupId: Migrace zařízení collabmigrationtestGRP_engg byla dokončena 

Výstup

Po migraci zařízení jsou zařízení připojena do režimu online a jsou připravena uskutečňovat/přijímat hovory. Příklad stavu zařízení najdete na obrázku 15:

Obrázek 15: Stav zařízení

Po migraci zařízení se čísla stala aktivní. Příklad toho, která čísla jsou aktivní, najdete na obrázku 16:

Obrázek 16: Čísla aktivní

Operaci vrácení musí být provedena vždy pro jeden podnik.

Pro operátora BroadCloud

Proces vrácení stavu partnerů BroadCloud je následující:

1. Chcete-li požádat o vrácení zařízení, otevřete lístek v Cisco TAC.
2. Spustit nástroj pro přesun zařízení v režimu vrácení:
   • Přiřazení telefonních čísel bude zrušeno ke službě Webex Calling, takže uživatelé a služby budou mít pouze linky.
   • E-mailové adresy v Webex Calling budou obnoveny na dočasné e-mailové adresy.
   • Telefony budou odstraněny ze služby Webex Calling.
   • Telefonní čísla, e-mailové adresy používané jako alternatedId a telefony budou znovu vytvořeny ve službě BroadCloud.
   • Telefony budou restartovány.
3. Správci partnerů musí přesunout telefonní čísla PSTN zpět k operátorovi BroadCloud.

Pro Cisco BroadWorks a Webex pro BroadWorks

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

1. Chcete-li požádat o vrácení zařízení, otevřete lístek v Cisco TAC.
2. Spuštěním nástroje pro přesunutí zařízení v režimu vrácení na sekundárním aplikačním serveru BroadWorks vrátíte migraci zařízení zpět. Tímto se nastaví adresa URL DMS zpět na adresu URL DMS poskytovatele služeb pro profily zařízení v platformě 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 Cisco BroadWorks.

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

Postupujte podle níže uvedených kroků a spusťte nástroj pro přesun zařízení v režimu vrácení:

Spusťte níže uvedený příkaz na sekundárním aplikačním serveru Cisco BroadWorks uvnitř adresáře nástroje pro přesunutí zařízení:

Vrátit profily

./devicemove.sh -input=  -revertProfily

Vrátit čísla

./devicemove.sh -input=  -revertČísla

Protokoly terminálu

Po úspěšném spuštění nástroje pro přesun zařízení k operaci zpět získáme 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 proces vrácení... Zařízení, která lze přesunout zpět ze služby Webex Calling do BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | 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 tato zařízení přesunout zpět ze služby Webex Calling do BroadWorks? (Ano, Y, Ne, N):  ano Nahrávání profilů zařízení pro DMS Cisco MPP LC Proces opětovného sestavení zařízení Byl zahájen Proces opětovného sestavení zařízení Byl úspěšně dokončen Proces restartování Byl zahájen Proces restartování Dokončen Úspěšně Migrace zařízení dokončena pro proces zrušení zřízení 

Vrátit čísla

Název nástroje: Verze nástroje pro přesunutí zařízení: 1.15.0 Chcete pokračovat v vracení čísel do Broadworks?  ([Y]es nebo [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Spouštění vrácení Aktivace procesu telefonních čísel Broadworks spuštěno pro skupinuId: collabmigrationtestGRP_engg Proces aktivace telefonních čísel Broadworks byl dokončen pro ID skupiny: collabmigrationtestGRP_engg Proces vrácení migrace zařízení byl úspěšně dokončen