Děkujeme za vaši zpětnou vazbu.

Podporované telefony budou automaticky vytvořeny a přiřazeny uživatelům Webex Calling pomocí nástroje pro zřizování. Telefony označené „ano“ ve sloupci „Podporováno v nástroji pro přesun zařízení“ budou také automaticky přesunuty z Cisco BroadWorks nebo BroadCloud do Webex Calling okamžiku spuštění nástroje pro přesun zařízení. Telefony označené „Ne“ v tomto sloupci vyžadují 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ů do sloupce „Typ zařízení“ souboru transform-tool/input/newphones.csv. (Další informace o souboru newphones.csv naleznete v části Trans formační nástroj v tomto článku).

Správci partnerů spustí tento nástroj pro generování tokenů alespoň jednou, než začnou spouštět nástroje pro migraci. Spuštění tohoto nástroje je jednorázovou aktivitou poté, co se partner ský účet připojí do řešení Wholesale RTM. Tento nástroj umožňuje partnerským administrátorům přihlásit se prostřednictvím webového prohlížeče a získat jedinečný TOKEN, který je potřebný k aktualizaci konfiguračních souborů partnerů pro nástroje migrace.

Předpoklady

Nainstalujte do počítače Java 8,11,17 nebo 21. Java je k dispozici z mnoha zdrojů, včetně:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

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

Pokyny ke spuštění

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

Okna:

token_generator.bat

MacOS:

./token_generator.sh

Výstup:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

Otevřete adresu URL ve webovém prohlížeči na terminálu, přihlaste se pomocí pověření správce partnera, abyste získali TOKEN a zkopírujte je pro další použití.

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

Obrázek 3: Přihlášení pomocí Cisco Webex

Obrázek 4: Okno pověření

Obrázek 5: Generování tokenů

Před spuštěním nástrojů 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řesun zařízení komunikuje s BroadWorks prostřednictvím příkazů OCI-P, pro povolení připojení OCI-P použijte následující kroky:

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

Spusťte následující příkaz v příkazovém řádku a přejděte do adresáře GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Spusťte následující příkaz v příkazovém řádku a získejte aktuální GeneralSettings:

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

Pokud vaše nastavení neodpovídají výše uvedeným, pomocí příkazu set znovu nakonfigurujte nastavení.

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

Změňte adresář na OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/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> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

Pokud vaše nastavení neodpovídají výše uvedeným, pomocí příkazu set znovu nakonfigurujte nastavení.

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

Změna do adresáře Zřizování:

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> get
Address Description
========================
127.0.0.1 local as

Krok 4: Spusťte příkaz níže v CLI a ověřte, zda je vaše konfigurace správná.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed 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 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

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

Pomocí níže uvedených příkazů nasaďte a spusťte Open Client Server na sekundárním aplikačním serveru, pokud není nasazen nebo ještě nebyl spuště n.

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Povolit aktivaci čísel

Proveďte následující příkazy v CLI, abyste povolili aktivaci čísel:

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

AS_CLI> cd SubscriberMgmt/NumberActivation

Krok 2: Spusťte příkaz aktivace povolen:

AS_CLI> set dnMode groupAndUserActivationEnabled

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. Pošlete žádosti o výpis až pro 50 zákazníků na 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 si extrahovaný datový soubor, ve formátu ZIP, až 28 dní od data odes lání žádosti.

Následující obrázky ukazují portál poskytovatele služeb.

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

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

Žádost o extrahování CSV

Iniciovat požadavek na extrak ci CSV

1. Stáhněte si zákaznický CSV

   Klikněte na odkaz Stáhnout soubor CSV zákazníka v pravém horním rohu sekce Zaháj it žádost o extrahování CSV.

2. Úprava seznamu zákazníků

   Správce může tento soubor CSV upravit tak, aby zahrnoval pouze zákazníky, pro které je třeba provést extrakci.

3. Nahrát a odeslat

   Po úpravě nahrajte upravený soubor CSV.

   Kliknutím na tlačítko Odeslat zahájíte žádost o extrakci pro uvedené zákazníky a jejich přidružené umístění.

Iniciovat požadavek na extrakci pro zákazníka s adresou Locations CSV

1. Vyberte místa zákazníka a stáhněte si

   Vyberte zákazníka z rozevíracího seznamu.

   Stáhněte si odpovídající soubor locations.csv z karty Zobrazit zákazníky → Weby → Expor tovat umístění jako CSV.

2. Úprava souboru umístění

   Správce může upravit soubor CSV tak, aby zahrnoval pouze místa, která chtějí extrahovat.

3. Nahrát a odeslat

   Nahrajte upravený soubor locations.csv a klikněte na tlačítko O deslat.

   Do požadavku na výpis budou zahrnuta pouze určená místa pro vybran ého zákazníka.

Iniciovat žádost o extrakci pro všechny zákazníky

1. Kliknutím na tlačítko Odeslat zahájíte žádost o extrak ci pro všechny zákazníky a všechna jejich umístění pod aktuálním poskytovatelem služeb.

Pro Cisco BroadWorks a Webex pro BroadWorks

1. Extrahovací nástroj běží na sekundárním aplikačním serveru Cisco BroadWorks v partnerské síti a připojuje se přes OCI-P.
2. Nástroj stahuje nezpracovaná data podniků, skupin, čísel, uživatelů, služeb, zařízení a měkkých klientů z platformy Cisco BroadWorks nebo BroadCloud a vydává tato data do souborů XML, které poskytují vstupy pro transformační nástroj.

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

Předpoklady

1. SCP extrahujte binární soubory nástroje 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 extrakci.
3. Nakonfigurujte poskytovatele služeb a ID skupiny pro extrahování z Cisco BroadWorks v nástroji Conf/ExportTool.yml. Viz následující ukázkový úryvek YAML :

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

4. Zkontrolujte, zda je v souboru conf/partner.cfg správné uživatelské ID, heslo a název hostitele sekundárního serveru Cisco BroadWorks Application Server:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   Vlastnost REFRESH_TOKEN je povinná pro migraci Webex pro BroadWorks.

5. Upravte cestu prostředí JDK/JRE v souboru export.sh, pokud je sekundární cesta prostředí Cisco BroadWorks Application Server JDK/JRE odlišná od souboru:

   JAVA_HOME=/usr/local/java/java_base

Pokyny ke spuštění

Spusťte následující příkaz v sekundárním aplikačním serveru Cisco BroadWorks z adresáře nástroje pro extrakci:

./export.sh

Terminálové protokoly

Po úspěšném exportu jsou v terminálu k dispozici následující protokoly: Spuštění nástroje BroadSoft Data Export Tool:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

Výstup

Výstupní soubor ZIP (extrahovaný_data_ .zip<timestamp>) je k dispozici ve stejném adresáři nástroje pro extrakci. 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 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
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

Pokud správce používá nástroj za firemním proxy serverem, konfigurujte a spusťte exportní skript podle níže uvedených kroků.

Kroky ke konfiguraci a spuštění exportního skriptu

1. Otevřete soubor export.sh.
2. Vyhledejte proměnnou HTTPS_PROXY_HOST a zrušte její komentář (odstraňte úvodní #).

3. Nastavte hodnotu HTTPS_PROXY_HOST jako:

   HTTPS_PROXY_HOST=<proxy-host>

4. Vyhledejte proměnnou HTTPS_PROXY_PORT a zrušte její komentář (odstraňte úvodní #).
5. Nastavte hodnotu HTTPS_PROXY_PORT jako:

   HTTPS_PROXY_PORT=<proxy-port>

6. Uložte a zavřete soubor export.sh.
7. Otevřete soubor partner.cfg a přidejte požadovaný refresh token.
8. Ověřte, zda jsou hostitel BroadWorks, uživatelské jméno a heslo správně nakonfigurovány v souboru partner.cfg.
9. Spusťte skript:

   ./export.sh

Formulář zásnuby:

Nástroj Extract Tool (BroadCloud a BroadWorks) nyní automaticky generuje konsolidovaný soubor XLSX s názvem Engagement Form SUA.xlsx během provádění. Soubor je předem vyplněn všemi dostup nými daty napříč relevantními pracovními listy, což pomáhá zefektivnit a urychlit dokončení partnerů.

Tento transformační nástroj běží pro všechny migrace. Transformační nástroj běží na jakémkoli počítači, včetně notebooku správce partnera, a používá veřejná rozhraní API Webex. Čte výstupní <timestamp>soubor ZIP (extracted_data_.zip) nástroje pro extrahování jako vstup a transformuje nezpracovaný XML do formátu JSON, který používá nástroj pro zřizování.

Předpoklady

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Volitelně nastavte PROVISIONING_ID (zkopírované ze šablony v Partner Hub) v souboru conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Chcete-li získat úplnější ověření e-mailové adresy zákazníka, můžete volitelně nastavit PROVISIONING_ID.
3. Pokud chybí, nakonfigurujte chybějící informace v souboru input/customers.csv (viz další část).
4. Přidejte e-mailovou adresu koncového uživatele do souboru input/users.csv.
5. Pokud mají být zřizovány 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 administrá toři partnerů chtějí zřídit nové telefony ve Velkoobchodním volání.
6. Převeďte call centra BroadWorks na CXEssentials pomocí souboru input/cxessentials.csv.
7. Volitelně povolte vlastnost UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS pro převod všech call center na CXEssentials.
8. Použijte soubor input/locations.csv k podpoře migrace velkých podniků, která umožňuje správcům migrovat umístění svých zákazníků podle umístění
9. Volitelně povolit použití MAC adres 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=Ano v souboru conf/partner.cfg
10. Volitelně povolte vlastnosti ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_ MUSIC_ON_HOLD a ANALOG_USER_TYPE_DISABLE_T38 pro konfiguraci čekání hovoru, pozastavení hudby a deaktivaci nastavení T38 pro všechny uživatele analogového typu.

11. Pokud chcete nastavit obecná zařízení brány, přidejte MAC adresu zařízení a ID uživatele do souboru input/genericgateways.csv. Uveďte také, zda je uživatel PRIMÁRním vlastníkem nebo sdíleným uživatelem (pro vzhledy sdílených hovorů). To je nutné pouze v případě, že administrátoři partnerů plánují ve velkoobchodním volání používat obecná brána zařízení.

    Tato funkce není k dispozici pro migrace BroadCloud na velkoobchod.

12. Pokud chcete převést všechny uživatele s typem stanice pro zasílání zpráv na voice_mail_group, aktualizujte soubor conf/rialto_station_type_to_wholesale_package.csv tak, že nah radíte hodnotu Vel koobchodního balíčku pomocí voice_mail_group pro řádek, na kterém je typ stanice Rialto zasílán.

    Volitelně povolte vlastnost COMMON_VOICE_MAIL_GROUP_PASSCODE v souboru partner.cfg a nakonfigurujte výchozí kód PIN pro skupiny hlasové pošty.

    Pokud tato vlastnost není zadána v souboru partner.cfg, musí být zadána pro každého zákazníka v souboru customers.csv ve sloupci CommonVoicEmailGroupPassCode.

13. Pro migraci společných kontaktů na Webex Calling

    Je to vylepšení pro správu společných kontaktů na úrovni podniku a webu. Tyto kontakty lze nyní migrovat buď jako kontakty organizace ( Kontakty organizace) nebo jako virtuální rozšíření na základě nastavení konfigurace. Níže jsou uvedeny podrobnosti, které vás provedou tímto procesem migrace.

    Konfigurace klíče:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      V souboru partner.cfg je zaved ena nová vlastnost COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE. Tato vlastnost určuje, jak jsou běžné kontakty migrovány z Rialto doWebex Calling.

    • Bez konfigurace COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Běžné kontakty budou migrovány jako kontakty organizace (Kontakty organizace).

      Není nutná žádná další konfigurace.

      Kontakty zůstávají přístupné na úrovni organizace.

    • S konfigurací COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Běžné kontakty budou migrovány jako virtuální rozšíření.

      Ke každému kontaktu bude připojeno číslo přípony a počáteční rozsah rozšíření je definován ve vlastnosti COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE v partner.cfg.

      Virtuální rozšíření jsou podporována jak na úrovni organizace, tak na úrovni umístění, v závislosti na rozsahu kontaktu.

14. Povolit výchozí dodavatel nahrávání hovorů pro Webex.

    Tento krok je vyžadován pouze při migraci nastavení nahrávání hovorů pro uživatele nakonfigurované pomocí aplikace Dubber na Cisco Native Call Rec ording ve Webex.

    Chcete-li povolit tuto možnost:

    • V souboru partner.cfg nastavte následující vlastnost, default _call_recording_vendor=WebEx.
    • Kromě toho použijte vlastnost WEBEX_CALL_RECORDING_STORAGE_REGION ke konfiguraci oblasti úložiště.

      Možnost nahrávání na vyžád ání z BroadCloud není podporována v Webex Calling aplikaci. Tato nastavení nahrávání hovorů nebudou migrována a zobrazí se v přehledu výjimek.

15. Vyloučení vybraných telefonních čísel z migrace:

    Chcete-li vyloučit konkrétní telefonní čísla z procesu migrace, je třeba postupovat podle následujícího postupu ve dvou krocích pomocí nástroje transformace:

    • Nejprve spusťte transformační nástroj poprvé. Po dokončení nástroj vygeneruje soubor s názvem telephone_numbers_inventory.csv, který se nachází v adresáři output/timestamp/. Zákazník je povinen zkontrolovat tento soubor a uvést „Ano“ ve sloupci „Drop Tn's“ pro každé telefonní číslo, které by mělo být vyloučeno z nadcházející migrace.
    • Po aktualizaci souboru telephone_numbers_inventory.csv s příslušnými příznaky vyloučení je transformační nástroj spuštěn po druhé. Aktualizovaný soubor by měl být předán jako argument v následujícím formátu.

      . /transform.sh -extract=vstup/extrahovaná data_1747640608219.zip -decommissionnumbers= {filepath/telephone_numbers_inventory.csv}

16. Volitelně nastavte vlastnost ALLOW_RESTRICT_BY_PARTNER_MODE na VYPNUTO, aby správci zákazníků mohli upravit nastavení definovaná partnerem v Řídicím centru.
17. Pro migraci mobilních čísel (BroadWorks Mobility) z BroadCloud na Webex Calling

    Tato část popisuje migraci funkce BroadWorks Mobility (zákaznická mobilní čísla) z BroadCloud (integrace mobilní sítě) na velkoobchod Webex Calling (Webex Go Mobile Network Operator).

    Předpoklady — Před zahájením procesu migrace musí administrátoři partnerů kontaktovat tým Cisco Account, aby provedli konfiguraci dodavatele služby Cloud Connected PSTN (CCP) a Custom Carrier List (CCL).

    Do souboru partner.cfg je přidána nová vlastnost ASSIGN_MOBILE_NUMBERS_TO_USERS. Povolte tuto vlastnost, chcete-li povol it přiřazování a migraci mobilních čísel uživatelům.

    • Tato funkce je podporována pouze pro migrace z Broadcloudu na velkoobchod.
    • Ve velkoobchodním Webexu mohou koncoví uživatelé mít na rozdíl od BroadCloudu buď mobilní číslo, nebo číslo PSTN (ne obojí).
    • Když je uživateli přiřazeno mobilní číslo, jeho primární číslo PSTN se stane jeho sekundárním (alternativním) číslem.
    • Mobilní čísla nelze migrovat pro uživatele, kteří jsou převáděni na pracovní prostory nebo virtuální linky.
    • Po přiřazení mobilního čísla ve velkoobchodním Webex se v Control Hub zobrazí jako aktivní. Tento stav neznamená, že číslo je okamžitě připraveno k přijímání hovorů. Možnost volání bude k dispozici až po úplném dokončení migrace.
    • Nastavení integrace mobilních telefonů nakonfigurovaná koncovými uživateli na portálu Calling User Portal (CUP) nejsou migrována. Po migraci, když je voláno telefonní číslo, číslo mobilního telefonu nebo rozšíření, zazvoní všechna zařízení uživatele.

18. Chcete-li volitelně nakonfigurovat limity množství balíků během migrace zákazníka, zadejte množství pro každý balíček v souboru input/package_quantity.csv. Nakonfigurované množství balíků musí být větší nebo roven počtu balíků přiřazených uživatelem/pracovním prostorem.

    Omezení množství balíčků nejsou aktuálně podporovány pro migrace Webex pro BroadWorks na velkoobchod.

    Při spuštění nástroje transformace, zadejte aktualizovaný soubor jako vstupní parametr:. <extract_zip_file>/transform.sh -extract= -packagelimits=vstup/package_quantity.csv .

19. Migrace webů od více zákazníků z Broadworks/Broadcloud na jednoho zákazníka ve velkoobchodě Webex Calling
    • V nástroji Transformace je zaveden nový běhový režim, -ConsolidatedMigration, který podporuje migraci více zákaznických webů z Broadcloud/Broadworks na velkoobchodní platformu Webex v rámci jedné organizace velkoobchodních zákazníků. Je-li tento režim povolen, nástroj konsoliduje více zákaznických pracovišť do jedné organizace velkoobchodních zákazníků

      -consolidatedMigration

    • Existují další volitelné argumenty, které mohou být uvedeny spolu s -ConsolidatedMigration, jako například

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • pokud je zadán -TargetEnterpriseID a Id existuje ve výstupním souboru nástroje Extract, bude použit k vytvoření organizace zákazníka Velkoobchodního zákazníka a pokud Id není nalezen, nástroj se vrátí k použití všech dostupných údajů o zákazníkovi z výstupního souboru nástroje Extract.
    • pokud je zadán -ConsolidateDexternalId, nastaví externalId pro zákazníka a pokud není zadán, nástroj se vrátí k použití stávajícího toku pro externí Id.
    • <timestamp>Konsolidovaný soubor JSON (customer.json) bude k dispozici v adresáři output//.

Vyplnění souboru input/customers.csv

Soubor input/customers.csv poskytuje data, která možná chybí v Cisco BroadWorks nebo BroadCloud. Tento soubor může být ponechán prázdný, pokud jsou již k dispozici 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.

Vyplnění souboru input/users.csv

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

Pokyny ke spuštění

Spusťte nástroj Transform Tool v libovolném operačním systému. Pomocí níže uvedených kroků spusťte nástroj ve Windows a MacOS:

Okna

Spusťte nástroj Transform Tool v systému Windows provedením níže uvedeného příkazu:

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

MacOS

Chcete-li spustit nástroj transformace v systému macOS, proveďte následující kroky:

1. Vytvořte virtuální prostředí a nainstalujte závislosti pro spuštění transformačního nástroje pomocí Pythonu:

   python3 -m venv venv
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. Spusťte nástroj transformace:

   ./transform.sh -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

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

Nástroj Transform Tool provede volání rozhraní API do Webex, aby zachytil potenciální problémy s přidělováním. Ve výchozím nastavení ověří adresu zákazníka a primární e-mail. Pokud je hodnota PROVISIONING_ID 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ýjimkách.

Při spuštění transformačního nástroje lze navíc 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, Transform Tool také spust í rozhraní API předběžné kontroly pro e-maily odběratelů.

informace o předkontrole

Ve výchozím nastavení jsou do zprávy výjimek 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).

Terminálové protokoly

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

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Zpráva o výjimkách

Transform Tool vygeneruje zprávu o výjimce uvnitř <timestamp>adresáře output/ /exception_report.txt. Pomocí této zprávy můžete identifikovat problémy, které ovlivní migraci, a opravit je v systému Cisco BroadWorks.

Po úpravě uživatelských dat k vyřešení výjimky znovu spusťte Nástroje pro extrahování a transform aci s novými daty. Ukázkový soubor zprávy o výjimkách je následující:

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

Výstup

<timestamp><groupid>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_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice 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": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

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

Předpoklady

V adresáři nástroje pro zřizování nakonfigurujte následující předpoklady:

1. Nainstalujte do počítače Java 8,11,17 nebo 21. Java je k dispozici z mnoha zdrojů, včetně:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Po stažení a extrahování binárních souborů nástrojů migrace nastavte proměnnou prostředí JAVA_HOME v souboru provisioning_tool.sh pro MAC a provisioning_tool.bat pro Windows.
3. Soubor partner.cfg:
   • Nastavte WHOLESALE_PROVISIONING_ID a REFRESH_TOKEN (Token zkopírovaný z nástroje pro generování tokenů). Správci partnerů musí kontaktovat svůj tým účtů, aby získali PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Nastavte SEND_SUBSCRIBERS_WELCOME_EMAIL na false, pokud partneři nechtějí posílat uživatelům uvítací e-mail. Výchozí hodnota je true.

     Webex posílá uvítací e-maily pouze koncovým uživatelům. Správci zákazníků nedostávají uvítací e-maily.

     Uživatelé a správci zákazníků se sídlem v USA a Kanadě ob drží od RedSky samostatné e-mailové upozornění. Platforma RedSky E911 odešle tento e-mail k potvrzení vytvoření zákaznického účtu pro pohotovostní služby. Tento e-mail RedSky je oddělený od uvítacích e-mailů Webex a není řízen nastavením e-mailu Webex. Pro velkoobchodní organizace v USA a Kanadě je RedSky automaticky povolen jako poskytovatel tísňových služeb.

4. Použijte vlastnost WEBEX4BWKS_EMAIL_SUBJECT pro migrace Webex pro BroadWorks k odeslání předmětu e-mailu požadavku na změnu hesla pro předplatitele Webex pro BroadWorks.
5. Pomocí vlastnosti WEBEX4BWKS_EMAIL_BODY pro migrace Webex pro BroadWorks odešlete tělo e-mailu požadavku na změnu hesla pro předplatitele Webex pro BroadWorks.
6. Použijte vlastnost C USTOM_TAG S k přidání značek po vytvoření zákazníka.
7. Chcete-li uplatnit velkoobchodní slevy, musí správci partnerů před zahájením migrace kontaktovat tým účtů společnosti Cisco.

   Do partner.cfg je přidána nová vlastnost, APPLY_WHOLESALE_DISCOUNTS. Povolte tuto vlastnost, chcete-li uplatnit slevy na uživatele a pracovní prostory.

8. (Volitelné) Výslovně nakonfigurujte připojení PSTN

   Chcete-li zadat připojení PSTN pro všechna umístění zřízená během migrace, včetně hlavního umístění, přidejte do souboru partner.cfg následující vlastnost:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Pokud vlastnost není nakonfigurována nebo je komentována, nástroj Zřizování použije výchozí proces výběru připojení PSTN.

Pokyny ke spuštění

Pomocí následujících kroků spus ťte nástroj ve Windows a MacOS:

Okna

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

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

MacOS

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

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Předpoklady pro migraci Webex pro BroadWorks

Správ ci partnerů musí aktualizovat svou šablonu přihlášení BroadWorks pro funkce koexistence Webex pro Broad Works. Viz následující obrázek:

Jakmile je šablona Onboarding Webex pro BroadWorks aktualizována tak, aby podporovala migraci, požádejte zákaznický tým Cisco o povolení přepínání funkce „velkoobchodní-partner-mixing-enabled“ na úrovni partnera. Toto nastavení umožňuje nástroji Zřizování automaticky přidávat velkoobchodní balíčky ke stávajícím zákazníkům Webex pro BroadWorks během zřizování.

Spusťte nástroj pro zřizování 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 s Webex pro uživatele BroadWorks.

Fáze údržby: je druhá fáze, ve které mohou správci přiřadit velkoobchodní licenci existujícím uživatelům Webex pro BroadWorks. Musíte spustit nástroj pro zřizování s údrž bou argumentů.

Fáze po migraci: Je poslední fází, kdy správci mohou kompletně převést BroadWorks na velkoobchod . Musíte spustit nástroj pro zřizování s argumentem post migration.

Terminálové protokoly

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

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

Vytiskne se tabulka s počtem míst vytvořených pro každý běh:

Výstup

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

Systém vygeneruje soubor Provisioning_report_*.csv v adresáři output/consolidated_report s/. Tento soubor obsahuje podrobnosti o úspěchu i neúspěchu pro každou entitu a její nastavení a poskytuje komplexní zprávu o zřizování.

Nástroj pro zřizování také generuje soubor Pro visioning_statistics_*.csv v adresáři output/consolidated_reports/. Tato sestava obsahuje počty úspěšně a neúspěšně zřízených zákazníků, umístění, uživatelů, zařízení a funkcí skupiny .

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

Obrázek 8: Centrum partnerů

Obrázek 9: Řídicí rozbočovač

Obrázek 10: Zařízení

Obrázek 11: Volání

Omezení po zřízení

Po dokončení zřizování migrace BroadCloud budou blokovány následující akce:

• CAP Portal — Přidávání uživatelů nebo přenesených zařízení.
• SP Portal - Vyt váření objednávek ADD se zařízeními nebo čísly.
• RSB API - Vyt váření objednávek ADD se zařízeními nebo čísly a vytváření uživatelů. Objednávky RSB ADD provedené se zařízeními nebo čísly budou odmítnuty.

Migrace z BroadCloud na velkoobchod - omezení registrace zařízení

Pro administrátory partnerů, kteří migrují zákazníky z BroadCloudu na velkoobchod ve stejné oblasti, mohou být zařízení přidána do velkoobchodu po spuštění nástroje pro zřizování. Tato zařízení se však stanou způsobilými k registraci na platformě Webex až po dokončení migrace (přesunu zařízení) pro odpovídající umístění.

Toto omezení se nevztahuje na:

• Zákazníci migrující z Broadworks/W4b na velkoobchod.
• BroadCloud na velkoobchodní migrace napříč různými regiony.

Doporučené pokyny

Chcete-li se vyhnout problémům s registrací zařízení, dokončete migraci přesunu zařízení na úrovni umístění před pokusem o registraci zařízení na platformu Webex pro migrace BroadCloud na velkoobchod ze stejné oblasti.

Pro BroadCloud

Pro partnery BroadCloud použijte portál poskytovat ele služeb k odeslání žádosti o migraci čísel, zařízení a migrací sdílených hovorů (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í.

Správci mohou povolit automatické vrácení zpět nastavením rollback_to_broadcloud=true v souboru conf/partner.cfg, který přesune zařízení zpět do BroadCloud po migraci. Podporuje migrace stejných i různých regionů s NS Sync, ale pouze pro úspěšné migrace. U neúspěš ných musí administrátoři Cisco TAC před žádostí o vrácení zpět zadat hodnotu a.

Pro výběr typu migrace na portálu jsou k dispozici dvě možnosti:

• Migrace — vyberte tuto možnost, chcete-li zahájit požadavek na migraci čísel, zařízení a vzhledů sdílených hovorů (SCA).
• Stav zařízení — Výběrem této možnosti zobrazíte aktuální stav zařízení na BroadCloud a volání.

Následující obrázky ukazují portál poskytovatele služeb.

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

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

Migrace vybraných umístění (volitelné)

Chcete-li zahájit migraci pro konkrétní podmnožinu umístění uvedených v souboru customer.json, přidejte k požadavku soubor locations.csv. Tento soubor CSV by měl uvádět pouze místa, která chcete migrovat.

Chcete-li stáhnout seznam dostupných aktivních webů, přejděte na Zobrazit zákazníky → Vybrat zákazníka → Exportovat umístění jako CSV.

Obrázek 14: Export umístění jako CSV

Povolte možnost odpojit čísla

Pokud používáte stejný SIP trunk pro Webex Calling a BroadCloud Carrier, správci by měli použít možnost Odpojit čísla. Tím se odstraní telefonní čísla z přijímání příchozích hovorů po migraci v BroadCloudu.

Chcete-li tuto možnost povolit,

1. V souboru partner.cfg nastavte DISCONNECT_NUMBERS_FROM_RIALTO = yes.
2. Znovu spusťte nástroj migrace pomocí stejného souboru customer.json a aktualiz ovaného souboru partner.cfg.

Pokud se čísla nepodaří odpojit, vyvolejte požadavek Cisco TAC.

Pro Cisco BroadWorks a Webex pro BroadWorks

Pro migrace Cisco BroadWorks a Webex pro BroadWorks je nástroj spuštěn na sekundárním aplikačním serveru Cisco BroadWorks v partnerské síti a připojuje se k AS prostřednictvím OCI-P. Používá výstupní soubor Transform Tool JSON (customer.json) jako vstup a spouští příkazy OCI-P pro migraci zařízení a softwarových klientů.

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

1. Zrušte registraci zařízení z Cisco BroadWorks a zaregistrujte je ve velkoobchodě.
2. Uživatelé používající klienta UC-One budou při prvním přihlášení přesměrováni na aplikaci Webex.
3. Deaktivujte telefonní čísla z Cisco BroadWorks nebo odeberte telefonní čísla z BroadCloud.
4. Aktivujte čísla ve velkoobchodě.
5. Vytvářejte sdílené vzhledy hovorů ve velkoobchodě pro migrace BroadCloud. [Tento krok je použitelný pouze pro migrace BroadCloud].

6. Pokud správce používá nástroj za firemním proxy serverem, nakonfigurujte a spusťte zřizovací skript podle níže uvedených kroků.

   Postup konfigurace

   1. Otevřete soubor devicemove.sh.
   2. Vyhledejte proměnnou PROXY_HOST a zrušte její komentář (odstraňte úvodní # pro devicemove.sh).

   3. Nastavte hodnotu PROXY_HOST jako:

      PROXY_HOST=<proxy-host>

   4. Vyhledejte proměnnou PROXY_PORT a zrušte její komentář (odstraňte úvodní # pro devicemove.sh).

   5. Nastavte hodnotu PROXY_PORT jako:

      PROXY_PORT=<proxy-port>

   6. Vyhledejte proměnnou PROXY_SCHEME a zrušte její komentář (odstraňte úvodní # pro devicemove.sh). Tento krok je volitelný; pokud zůstane komentován, výchozí hodnota pro PROXY_SCHEME bude HTTP.

   7. Nastavte hodnotu PROXY_SCHEME jako:

      PROXY_SCHEME=<proxy-scheme>

   8. Uložte a zavřete soubor devicemove.sh.
   9. Otevřete soubor partner.cfg a přidejte požadovaný refresh token.
   10. Ověřte, zda jsou hostitel BroadWorks, uživatelské jméno a heslo správně nakonfigurovány v partner.cfg

   11. Spusťte skript:

       ./devicemove.sh

SCP a SSH

1. SCP nástroj přesunu zařízení 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í.

Předpoklady

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Zkontrolujte, zda je v souboru conf/ DeviceMoveTool.conf správné uživatelské ID, heslo a název hostitele sekundárního aplikačního serveru Cisco BroadWorks:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Chcete-li znovu odeslat aktivační e-maily, musíte nastavit send_subscribers_welcome_email=true v souboru conf/partner.cfg.

   Pokud si administrátoři přejí posílat e-maily s pozvánkami uživatelům během migrace, měli by zrušit komentář vlastnosti „send_subscribers_welcome_email=true“ v souboru conf/partner.cfg. V opačném případě by majetek měl zůstat nezměněn.

4. Ověřte, zda je cesta prostředí JDK/JRE správná v devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. 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.

Telefony Polycom

Chcete-li přesunout telefony Polycom z Cisco BroadWorks na velkoobchodní volání, musí správce partnera vytvořit nový soubor typu profilu identity/zařízení na úrovni systému v Cisco BroadWorks každé šabloně zařízení Polycom. 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í se ujistěte, že nově vytvořený soubor existuje na úrovni skupiny. Také se ujistěte, ž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ě nástrojem pro přesun zařízení.

Proces migrace pro telefony Polycom:

1. Nástroj pro přesun zařízení nahradí soubor %BWMACAddress%.cfg na úrovni zařízení souborem polycom_vvx2.cfg. Tento soubor odkazuje na 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 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, který požádá telefony Polycom o stažení a zpracování migration_%BWMACAddress%.cfg, což nastaví Device.prov.ServerName na https://plcm.sipflash.com.
   https://plcm.sipflash.com pro oblast USA mají jiné regiony různé adresy URL.
5. Telefon Polycom stáhne %BWMACAddress%.cfg z https://plcm.sipflash.com a bude spravován DMS. Webex Calling

Obrázek 14: Přidat soubor typu profilu identity/zařízení

Pokyny ke spuštění

Existují dvě metody, jak vyvolat DMT, první je vyvolat prostřednictvím jednoho zákazníka najednou a druhou je spustit více zákazníků současně.

Nástroj pro přesun zařízení je spuštěn ze sekundárního aplikačního serveru Cisco BroadWorks v adresáři nástroje pro přesunutí zařízení:

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Terminálové protokoly

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

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| 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 |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

Výstup

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

Obrázek 15: Stav zařízení

Po migraci zařízení se čísla aktivují. Na obrázku 16 naleznete příklad toho, která čísla jsou aktivní:

Obrázek 16: Aktivní čísla

Pokud správce používá nástroj za firemním proxy serverem, nakonfigurujte a spusťte skript DeviceRemove podle níže uvedených kroků.

Kroky ke konfiguraci a spuštění skriptu devicemove

1. Otevřete soubor devicemove.sh.
2. Vyhledejte proměnnou HTTPS_PROXY_HOST a zrušte její komentář (odstraňte úvodní #).

3. Nastavte hodnotu HTTPS_PROXY_HOST jako:

   HTTPS_PROXY_HOST=<proxy-host>

4. Vyhledejte proměnnou HTTPS_PROXY_PORT a zrušte její komentář (odstraňte úvodní #).
5. Nastavte hodnotu HTTPS_PROXY_PORT jako:

   HTTPS_PROXY_PORT=<proxy-port>

6. Uložte a zavřete soubor devicemove.sh.
7. Otevřete soubor partner.cfg a přidejte požadovaný refresh token.
8. Ověřte, zda jsou hostitel BroadWorks, uživatelské jméno a heslo správně nakonfigurovány v souboru partner.cfg.
9. Spusťte skript:

   ./devicemove.sh

Operace vrácení musí být provedena pro jeden podnik najednou.

Pro BroadCloud Carrier

Správci mohou nastavit rollback_to_broadcloud= true v conf/partner.cfg, aby umožnili automatické vrácení zpět. To vrací zařízení do BroadCloud po úspěšné migraci ve stejné oblasti nebo mezi regiony pomocí NS Sync. V případě neúspěšné migrace kontaktujte, Cisco TAC než požádáte o vrácení zpět.

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 Cisco TAC a požádejte o vrácení zařízení.
2. Chcete-li obnovit migraci zařízení, spusťte nástroj pro přesun zařízení v režimu obnovení na sekundárním aplika čním serveru BroadWorks. Tím se adresa URL DMS nastaví zpět na adresu URL DMS poskytovatele služeb pro profily zařízení v Cisco BroadWorks a znovu aktivuje telefonní čísla.
3. T Webex Calling ým nastaví adresu URL DMS zpět na adresu URL DMS poskytovatele služeb v profilech zařízení v. Webex Calling
4. Správci partnerů musí deaktivovat nebo smazat telefonní Webex Calling čísla na portálu Control Hub.
5. Správci partnerů musí přesunout telefonní čísla PSTN zpět do Cisco BroadWorks.

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

Chcete-li spustit nástroj pro přesun zařízení v režimu obnovení, postupujte podle následujících kroků:

Spusťte níže uvedený příkaz v sekundárním aplikačním serveru Cisco BroadWorks uvnitř adresáře nástrojů pro přesun zařízení:

Obnovit 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

Terminálové protokoly

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

Obnovit profily

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| 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 |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

Vrátit čísla

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully