Podporované telefony budou automaticky vytvořeny a přiřazeny uživatelům ve službě Webex Calling nástrojem 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 ze systému Cisco BroadWorks nebo BroadCloud do systému Webex Calling po spuštění nástroje pro přesun zařízení. Telefony označené v tomto sloupci jako „Ne“ 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ů ke sloupci „Typ zařízení“ v souboru. transform-tool/input/newphones.csv. (Další informace o souboru newphones.csv naleznete v části Nástroj Transformace tohoto článku).

Správci partnerů spustí tento nástroj pro generování tokenů alespoň jednou před zahájením spouštění migračních nástrojů. Spuštění tohoto nástroje je jednorázová aktivita po registraci partnerského účtu do řešení Wholesale RTM. Tento nástroj umožňuje správcům partnerů přihlásit se přes webový prohlížeč a získat jedinečný TOKEN, který je potřeba k aktualizaci konfiguračních souborů partnera pro migrační nástroje.

Požadavky

Nainstalujte si na počítač Javu 8, 11, 17 nebo 21. Java je dostupná 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 migračního nástroje.

Pokyny ke spuštění

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

Windows:

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 URL adresu ve webovém prohlížeči na terminálu, přihlaste se s přihlašovacími údaji správce partnera, abyste získali TOKEN, a zkopírujte jej pro další použití.

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

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

Obrázek 4: Okno s pověřeními

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 aktivaci připojení OCI-P postupujte podle následujících kroků:

Krok 1: Pro konfiguraci obecných nastavení použijte rozhraní příkazového řádku.

Spusťte v CLI následující příkaz pro přechod do adresáře GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Spuštěním následujícího příkazu v CLI získáte aktuální obecná nastavení (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ému, použijte příkaz set k jeho opětovné konfiguraci.

Krok 2: Pro konfiguraci OCI Proxy použijte CLI.

Změňte adresář na OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Spusťte následující CLI pro získání aktuálního nastavení. 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ému, použijte příkaz set k jeho opětovné konfiguraci.

Krok 3: Pomocí rozhraní CLI nakonfigurujte zřizování OCI.

Změna adresáře Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Spusťte následující příkaz pro získání aktuálního nastavení OCI Provisioning:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

Krok 4: Spusťte níže uvedený příkaz 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, zda je otevřený klientský server nasazen a aktivní.

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

Krok 1: Nasaďte server pomocí následujícího příkazu CLI:

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

Pro aktivaci čísel spusťte v CLI následující příkazy:

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

AS_CLI> cd SubscriberMgmt/NumberActivation

Krok 2: Spusťte příkaz s povolenou aktivací:

AS_CLI> set dnMode groupAndUserActivationEnabled

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

Pro BroadCloud

Nástroj pro extrakci je integrován do portálu poskytovatele služeb BroadCloud. Správce poskytovatele služeb může:

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

Následující obrázky znázorňují portál poskytovatele služeb.

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

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

Žádost o extrakci CSV

Zahájit požadavek na extrakci CSV

1. Stáhnout soubor CSV zákazníka

   Klikněte na odkaz Stáhnout soubor CSV zákazníka v pravém horním rohu sekce Zahájit požadavek na extrakci souboru CSV.

2. Upravit seznam zákazníků

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

3. Nahrát a odeslat

   Po úpravě nahrajte upravený soubor CSV.

   Kliknutím na tlačítko Odeslat zahájíte požadavek na výpis pro uvedené zákazníky a jejich přidružené lokality.

Zahájit požadavek na extrakci pro zákazníka s CSV s pobočkami

1. Vyberte zákazníka a umístění pro stahování

   Vyberte zákazníka z rozbalovací nabídky.

   Stáhněte si odpovídající soubor locations.csv z Zobrazit zákazníky→ záložka Lokality → Exportovat lokality jako CSV.

2. Úprava souboru s umístěními

   Administrátor může upravit soubor CSV tak, aby obsahoval pouze místa, která chce extrahovat.

3. Nahrát a odeslat

   Nahrajte upravený soubor locations.cs a klikněte na tlačítko Odeslat.

   V požadavku na výpis budou zahrnuty pouze zadané lokality pro vybraného zákazníka.

Zahájit požadavek na výpis pro všechny zákazníky

1. Kliknutím na Odeslat zahájíte požadavek na výpis pro všechny zákazníky a všechny jejich lokality pod aktuálním poskytovatelem 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 partnerské síti a připojuje se přes OCI-P.
2. Nástroj stáhne 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 tato data uloží do souborů XML, které poskytují vstupy pro transformační nástroj.

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

Požadavky

1. SCP provede extrakci binárních souborů nástroje na sekundární aplikační server Cisco BroadWorks.
2. Pro konfiguraci předpokladů a spuštění nástroje pro extrakci se připojte přes SSH k sekundárnímu aplikačnímu serveru Cisco BroadWorks.
3. Nakonfigurujte poskytovatele služeb a ID skupiny pro extrakci z Cisco BroadWorks v conf/exportTool.yml. Viz následující ukázkový úryvek YAML:

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

4. Ujistěte se, že ID uživatele, heslo a název hostitele sekundárního aplikačního serveru Cisco BroadWorks jsou v conf/partner.cfg soubor:

   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 Webexu pro BroadWorks.

5. Upravit JDK/JRE cesta k prostředí v souboru export.sh, pokud se jedná o sekundární aplikační server Cisco BroadWorks. JDK/JRE cesta k prostředí se liší od cesty k 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 (extracted_data_<timestamp>.zip) 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

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

Požadavky

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

1. Nastavte TOKEN OBNOVENÍ_(token zkopírovaný z nástroje generátoru tokenů) a NÁZEV__HLAVNÍHO UMIESTNĚNÍ_v conf/partner.cfg soubor:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pro úplnější ověření e-mailové adresy zákazníka můžete volitelně nastavit ID PROVISIONING_.
3. Nakonfigurujte chybějící informace v input/customers.csv soubor (viz další část), pokud chybí.
4. Přidejte e-mailovou adresu koncového uživatele do input/users.csv soubor.
5. Pokud mají být zřízeny nové telefony, přidejte MAC adresu a e-mailovou adresu nového telefonu uživatele do input/newphones.csv soubor. Toto je nutné pouze v případě, že správci partnerů chtějí zřídit nové telefony ve velkoobchodním volání.
6. Převeďte call centra BroadWorks na CxEssentials pomocí input/cxessentials.csv soubor.
7. Volitelně můžete povolit vlastnost UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, abyste převedli všechna call centra na CxEssentials.
8. Použijte input/locations.csv soubor pro podporu migrace ve velkých podnicích, který umožňuje administrátorům migrovat umístění svých zákazníků podle umístění
9. Volitelně povolte použití MAC adres z hlavičky User-Agent zprávy SIP REGISTER, pokud MAC adresa není k dispozici v profilu zařízení Cisco BroadWorks. Odkomentujte řádek „POUŽÍT_MAC_ADRESA_OD_SIP_“ REGISTER=yes" v souboru conf/partner.cfg
10. Funkce synchronizace síťového serveru umožňuje správcům zřizovat telefonní čísla, MAC adresy a e-mailové adresy uživatelů během migrace ve stejné oblasti. Chcete-li to povolit, nastavte USE_NS_SYNC=yes v conf/partner.cfg.

    Pokud je synchronizace NS zakázána, zřizování telefonních čísel a zařízení bude přeskočeno a uživatelé obdrží dočasné e-mailové adresy.

11. Volitelně povolte vlastnosti ANALOGOVÝ_UŽIVATEL_TYP_POVOLIT_HOVOR_ČEKÁNÍ, ANALOGOVÝ_UŽIVATEL_TYP_POVOLIT_HUDBA_ZAPNUTO_ČEKANÍ a ANALOGOVÝ_UŽIVATEL_TYP_ZAKÁZAT_T38 pro konfiguraci čekání hovoru, hudby při čekání a deaktivaci nastavení T38 pro všechny uživatele s analogovým hovorem.

Naplnění input/customers.csv

Soubor input/customers.csv poskytuje data, která mohou v Cisco BroadWorks nebo BroadCloud chybět. Tento soubor lze ponechat 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.

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

Naplnění input/users.csv

Soubor input/users.csv poskytuje data, která mohou v Cisco BroadWorks nebo BroadCloud chybět. Tento soubor lze ponechat 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.

Pokyny ke spuštění

Spusťte nástroj Transformace v libovolném operačním systému. Pro spuštění nástroje ve Windows a macOS použijte následující kroky:

Windows

Spusťte níže uvedený příkaz pro spuštění nástroje Transformace ve Windows:

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

macOS

Chcete-li spustit nástroj pro transformaci 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 pro transformaci:

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

Customer/user předběžná kontrola

Nástroj Transform Tool volá API do Webexu, aby zachytil 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 v parametru PROVISIONING_uvedena hodnota ID conf/partner.cfg soubor, ověří také informace o poloze. Výsledky předběžné kontroly jsou zahrnuty ve zprávě 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 pro předběžnou kontrolu informací o zákazníkovi spustí nástroj Transform Tool také rozhraní API pro předběžnou kontrolu e-mailů odběratelů.

předběžné kontroly

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 zahrne i ú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 se v terminálu po úspěšné transformaci zaznamenají:

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ýjimce

Nástroj Transformace generuje hlášení o výjimce uvnitř výstupu /<timestamp>/ Adresářexception_report.txt. Tuto zprávu můžete použít k identifikaci problémů, které ovlivní migraci, a k jejich opravě v systému Cisco BroadWorks.

Po úpravě uživatelských dat za účelem vyřešení výjimky znovu spusťte nástroje pro extrakci a transformaci s novými daty. Ukázkový soubor se zprávou o výjimce 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

Výstupní soubor JSON (customer.json) bude k dispozici v output/<timestamp>/<groupid> adresář. Ukázkový soubor customer.json vypadá takto:

{
    "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 na (notebooku správce partnera) a používá veřejná API Webex. Načte výstupní soubor JSON (customer.json) transformačního nástroje jako vstup a zřídí zákazníky, lokality, čísla, uživatele, služby a zařízení v řešení Webex Wholesale RTM.

Požadavky

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

1. Nainstalujte si na počítač Javu 8, 11, 17 nebo 21. Java je dostupná 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ů migračních nástrojů 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 ID VELKOOBCHODNÍHO POSKYTOVÁNÍ__a TOKEN OBNOVENÍ_(token zkopírovaný z nástroje pro generování tokenů). Správci partnerů musí kontaktovat svůj obchodní tým, aby získali ID PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Pokud partner nechce uživatelům posílat uvítací e-maily, nastavte POVOLIT_ADMIN_POZVAT_na hodnotu false. Výchozí hodnota je true.

4. Pro migrace Webex for BroadWorks použijte vlastnost WEBEX4BWKS_EMAIL_SUBJECT k odeslání předmětu e-mailu s požadavkem na změnu hesla pro předplatitele Webex for BroadWorks.
5. Pro migrace Webex for BroadWorks použijte vlastnost WEBEX4BWKS_EMAIL_BODY k odeslání těla e-mailu s požadavkem na změnu hesla pro předplatitele Webex for BroadWorks.
6. Funkce synchronizace síťového serveru umožňuje správcům zřizovat telefonní čísla, MAC adresy a e-mailové adresy uživatelů během migrace ve stejné oblasti. Chcete-li to povolit, nastavte USE_NS_SYNC=yes v conf/partner.cfg.

   Pokud je synchronizace NS zakázána, zřizování telefonních čísel a zařízení bude přeskočeno a uživatelé obdrží dočasné e-mailové adresy.

Pro migrace BroadCloud ve stejném regionu:

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

Pro migrace BroadCloudu v jiném regionu:

1. Nástroj zřídí čísla, zařízení a sdílené vzhledy hovorů.
2. Nástroj vytváří uživatele a virtuální uživatele se skutečnými telefonními čísly a klapkami.
   Všechny migrace z evropských BroadCloudů probíhají do jiného regionu.

Pokyny ke spuštění

Chcete-li nástroj spustit v systémech Windows a macOS, postupujte podle následujících kroků:

Windows

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

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

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

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

Předpoklady pro migraci Webexu pro BroadWorks

Správci partnerů musí aktualizovat svou šablonu pro registraci v BroadWorks pro funkce koexistence Webexu pro BroadWorks. Viz následující obrázek:

Jakmile bude šablona pro onboarding Webex pro BroadWorks aktualizována tak, aby podporovala migraci, požádejte tým Cisco Account o povolení funkce „wholesale-partner-blending-enabled“ na úrovni partnera. To umožní přidávat velkoobchodní balíčky do stávajících zákaznických organizací Webex for BroadWorks během zřizování.

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

Přípravná fáze: je výchozí fáze, ve které mohou administrátoři zřídit uživatele BroadWorks jako velkoobchodní předplatitele a pokračovat v používání Webexu pro uživatele BroadWorks.

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

Fáze po migraci: Je to závěrečná fáze, kdy mohou administrátoři kompletně převést BroadWorks na velkoobchod. Nástroj pro zřizování musíte spustit s argumentem postmigration.

Terminálové protokoly

Následují protokoly v terminálu po úspěšném zřizování:

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

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

Výstup

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

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

Obrázek 8: Partner Hub

Obrázek 9: Control Hub

Obrázek 10: Zařízení

Obrázek 11: Volání

Pro BroadCloud

Partneri BroadCloud mohou k odeslání žádosti o migraci čísel, zařízení a migrací sdílených zobrazení hovorů (SCA) použít portál poskytovatele služeb.

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

Funkce synchronizace síťového serveru umožňuje správcům deaktivovat umístění broadCloud a aktivovat umístění Webex Calling nastavením USE_NS_SYNC=yes v conf/partner.cfg. Po migraci jsou zařízení a telefonní čísla aktivována v lokalitě Webex Calling.

Administrátoři mohou povolit automatické vrácení zpět nastavením parametru ROLLBACK_TO_BROADCLOUD=true v souboru conf/partner.cfg, čímž se zařízení po migraci přesunou zpět do BroadCloudu. Podporuje migrace ze stejné i odlišné oblasti pomocí NS Sync, ale pouze v případě úspěšných migrací. U neúspěšných procesů musí administrátoři před žádostí o vrácení zpět vygenerovat požadavek na odvolání odpovědní osoby (Cisco TAC).

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

• Migrace – Tuto možnost vyberte pro zahájení požadavku na migraci čísel, zařízení a sdílených zobrazení hovorů (SCA).
• Stav zařízení – Tuto možnost vyberte pro zobrazení aktuálního stavu zařízení ve službách BroadCloud a Calling.

Následující obrázky znázorňují 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 spustit migraci pro konkrétní podmnožinu umístění uvedených v souboru customer.json, přiložte k požadavku soubor locations.csv. Tento soubor CSV by měl obsahovat pouze seznam umístění, která chcete migrovat.

Chcete-li si stáhnout seznam dostupných aktivních pracovišť, přejděte na Zobrazit zákazníky → Vybrat zákazníka → Exportovat lokality jako CSV.

Obrázek 14: Exportovat lokality jako CSV

Pro Cisco BroadWorks a Webex pro BroadWorks

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

Po úspěšné operaci nástroj pro přesun zařízení provede následující:

1. Zrušte registraci zařízení ze služby Cisco BroadWorks a zaregistrujte je ve velkoobchodě.
2. Uživatelé používající klienta UC-One budou při prvním přihlášení přesměrováni do aplikace Webex.
3. Deaktivujte telefonní čísla ze služby Cisco BroadWorks nebo je odeberte z služby BroadCloud.
4. Aktivujte čísla ve velkoobchodě.
5. Vytvořte sdílená zobrazení hovorů ve velkoobchodě pro migrace BroadCloud. [This krok platí pouze pro BroadCloud migrations].

SCP a SSH

1. SCP – nástroj pro přesun zařízení na sekundární aplikační server Cisco BroadWorks.
2. Pro konfiguraci předpokladů a spuštění nástroje pro přesun zařízení se připojte přes SSH k sekundárnímu aplikačnímu serveru Cisco BroadWorks.

Požadavky

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Ujistěte se, že ID uživatele, heslo a název hostitele sekundárního aplikačního serveru Cisco BroadWorks jsou v conf/deviceMoveTool.conf soubor:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Pro opětovné odeslání aktivačních e-mailů je nutné nastavit ZNOVU ODESLAT_POZVÁNKU_EMAILS=true v conf/partner.cfg soubor.

   Pokud si administrátoři přejí během migrace zaslat uživatelům e-maily s pozvánkami, měli by odkomentovat políčko „ZNOVU ODESLAT_POZVÁNKU_EMAILS=true" nemovitost v conf/partner.cfg soubor. Jinak by nemovitost měla zůstat beze změny.

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

   JAVA_HOME=/usr/local/java/java_base

5. Administrátoři 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

Pro přesun telefonů Polycom z Cisco BroadWorks do Wholesale Calling musí partnerský administrátor vytvořit nový Identity/Device Soubor typu profilu na systémové úrovni v Cisco BroadWorks každá šablona 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 nekoliduje 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 sestavte profily zařízení na úrovni skupiny nebo zařízení.
   Činnost 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 restartování si telefony Polycom stáhnou a zpracují soubor% BWMACADDRESS%.cfg, který požádá telefony Polycom o stažení a zpracování souboru migration_%BWMACADDRESS%.cfg, který nastaví device.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com Pro oblast USA mají ostatní oblasti jiné adresy URL.
5. Telefon Polycom stáhne soubor %BWMACADDRESS%.cfg z https://plcm.sipflash.com a bude spravován systémem Webex Calling DMS.

Obrázek 14: Identity/device přidat soubor typu profilu

Pokyny ke spuštění

Existují dvě metody, jak spustit DMT, první je spustit ji přes jednoho zákazníka najednou a druhá je spustit ji přes více zákazníků současně.

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

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 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=  -macaddress=4CBC4883A6F8,48256741CBE9

Terminálové protokoly

Následují protokoly v terminálu po ú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í se zařízení připojí k internetu a jsou připravena k… make/receive hovory. Příklad stavu zařízení viz obrázek 15:

Obrázek 15: Stav zařízení

Po migraci zařízení se čísla aktivovala. Příklad aktivních čísel je znázorněn na obrázku 16:

Obrázek 16: Aktivní čísla

Operaci vrácení změn je nutné provádět vždy pro jeden podnik.

Pro operátora BroadCloud

Proces vrácení pro partnery BroadCloud je následující:

1. Otevřete tiket u Cisco TAC a požádejte o vrácení zařízení.
2. Spusťte nástroj pro přesun zařízení v režimu obnovení:
   • Telefonní čísla budou zrušena z Webex Calling, takže uživatelům a službám zůstanou pouze linky.
   • E-mailové adresy ve službě Webex Calling budou převedeny na dočasné e-mailové adresy.
   • Telefony budou z Webex Calling smazány.
   • Telefonní čísla, e-mailové adresy použité jako alternatedId a telefony budou znovu vytvořeny v BroadCloudu.
   • 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í do předchozích verzí pro Cisco BroadWorks a Webex pro BroadWorks je následující:

1. Otevřete tiket u Cisco TAC a požádejte o vrácení zařízení.
2. Spusťte nástroj pro přesun zařízení v režimu vrácení na sekundárním aplikačním serveru BroadWorks, abyste vrátili migrace zařízení zpět. Tím se adresa URL DMS nastaví zpět na adresu URL DMS poskytovatele služeb pro profily zařízení v Cisco BroadWorks a telefonní čísla se znovu aktivují.
3. Tým Webex Calling nastaví URL adresu DMS zpět na URL adresu DMS poskytovatele služeb v profilech zařízení ve Webex Calling.
4. Správci partnerů musí deaktivovat nebo smazat 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 systému Cisco BroadWorks.

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

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

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

Vrátit profily

./devicemove.sh -input=  -revertProfiles

Vrátit čísla

./devicemove.sh -input=  -revertNumbers

Terminálové protokoly

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

Vrátit 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