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

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

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

Predpoklady

Nainštalujte Java 8, 11, 17 alebo 21 do počítača. Java je dostupná z mnohých zdrojov, vrátane:

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

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

Pokyny na spustenie

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

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

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

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

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

Obrázok 4: Okno poverenia

Obrázok 5: Generovanie tokenov

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

Povoliť pripojenie OCI-P

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

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

Zmeňte adresár na OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

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

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

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

Prejdite do adresára Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

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

 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.

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

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

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Krok 2: Spustite server týmto príkazom:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Povoliť aktiváciu čísel

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

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

AS_CLI> set dnMode groupAndUserActivationEnabled

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

Pre BroadCloud

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

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

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

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

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

Pre Cisco BroadWorks a Webex pre BroadWorks

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

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

Predpoklady

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

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

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

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

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

   JAVA_HOME=/usr/local/java/java_base

Pokyny na spustenie

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

./export.sh

Denníky terminálu

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

 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ý súbor ZIP (extracted_data_<timestamp>.zip) bude dostupný v rovnakom adresári nástroja na extrahovanie. Na zobrazenie a použitie súboru ZIP pre vstup nástroja Transform Tool použite príkaz uvedený nižšie:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 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 je spustený pre všetky migrácie. Transformačný nástroj beží na akomkoľvek počítači, vrátane notebooku správcu partnera, a používa Webex Public API. Načíta výstupný súbor ZIP (extracted_data_<timestamp>.zip) nástroja na extrahovanie ako vstup a transformuje nespracovaný formát XML do formátu JSON, ktorý používa nástroj na poskytovanie.

Predpoklady

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

    Ak je synchronizácia NS zakázaná, poskytovanie telefónneho čísla a zariadenia sa preskočí a používatelia dostanú dočasné e-mailové adresy.

Vyplnenie input/customers.csv

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

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

Pokyny na spustenie

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

Windows

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

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

macOS

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

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

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

2. Spustite transformačný nástroj:

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

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

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

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

predbežná kontrola

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

predbežné informácie

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

Denníky terminálu

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

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

Správa o výnimke

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

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

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ý súbor JSON (customer.json) bude dostupný v adresári output/<timestamp>/<groupid> . Vzorový súbor customer.json je nasledujúci:

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

Predpoklady

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

1. Nainštalujte Java 8, 11, 17 alebo 21 do počítača. Java je dostupná z mnohých zdrojov, vrátane:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Po stiahnutí a rozbalení binárnych súborov nástrojov na migráciu nastavte premennú prostredia JAVA_HOME v súbore provisioning_tool.sh pre MAC a provisioning_tool.bat pre Windows.
3. Súbor partner.cfg:
   • Nastavte VEĽKOOBCHOD_PROVISIONING_ID a REFRESH_TOKEN (token skopírovaný z nástroja na generovanie tokenov). Správcovia partnerov musia kontaktovať svoj tím účtu, aby získali PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

4. Použite vlastnosť WEBEX4BWKS_EMAIL_SUBJECT pre migrácie Webex for BroadWorks na odoslanie predmetu e-mailu so žiadosťou o zmenu hesla pre predplatiteľov Webex for BroadWorks.
5. Použite vlastnosť WEBEX4BWKS_EMAIL_BODY pre migrácie Webex for BroadWorks na odoslanie tela žiadosti o zmenu hesla pre predplatiteľov Webex for BroadWorks.
6. Funkcia synchronizácie sieťového servera umožňuje správcom poskytovať telefónne čísla, adresy MAC a e-mailové adresy používateľov počas migrácie v rovnakom regióne. Ak ju chcete povoliť, nastavte USE_NS_SYNC=yes v conf/partner.cfg.

   Ak je synchronizácia NS zakázaná, poskytovanie telefónneho čísla a zariadenia sa preskočí a používatelia dostanú dočasné e-mailové adresy.

Pre migrácie BroadCloud v rovnakej oblasti:

1. Nástroj preskočí poskytovanie čísel, zariadení a zdieľaných vzhľadov hovorov.
2. Nástroj vytvára používateľov a virtuálnych používateľov s predĺžením a dočasným predĺžením.

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

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

Pokyny na spustenie

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

Windows

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

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

macOS

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

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

Predpoklady pre Webex pre migráciu BroadWorks

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

Po aktualizácii šablóny Webex for BroadWorks Onboarding na podporu migrácie požiadajte tím Cisco Account Team, aby povolil prepínanie funkcie „wholesale-partner-blending-enabled“ na úrovni partnera. To umožní pridanie veľkoobchodných balíkov do existujúcich zákazníckych organizácií Webex for BroadWorks počas poskytovania.

Spustite nástroj na poskytovanie s ďalším argumentom.

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

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

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

Denníky terminálu

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

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 ****************

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

Výstup

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

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

Obrázok 8: Partnerské centrum

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

Obrázok 10: Zariadenia

Obrázok 11: Volanie

Pre BroadCloud

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

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

Funkcia Network Server Sync umožňuje správcom deaktivovať umiestnenie broadCloud a aktivovať umiestnenie Webex Calling nastavením USE_NS_SYNC=yes v conf/partner.cfg. Po migrácii sú zariadenia a telefónne čísla aktivované v lokalite Webex Calling.

Správcovia môžu povoliť automatické vrátenie nastavením ROLLBACK_TO_BROADCLOUD=true v conf/partner.cfg súbore, ktorý po migrácii presunie zariadenia späť do BroadCloud. Podporuje migráciu z rovnakej aj inej oblasti pomocou NS Sync, ale iba pre úspešné migrácie. Pre neúspešné musia správcovia zvýšiť Cisco TAC pred požiadaním o vrátenie.

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

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

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

Pre Cisco BroadWorks a Webex pre BroadWorks

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

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

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

SCP a SSH

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

Predpoklady

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Ak chcete znova odoslať aktivačné e-maily, musíte v súbore conf/partner.cfg nastaviť ZNOVU POSLAŤ_POZVÁNKU_EMAILS=true.

   Ak chcú správcovia počas migrácie posielať svojim používateľom e-maily s pozvánkami, mali by zrušiť komentár k vlastnosti „RESEND_INVITATION_EMAILS=true“ v súbore conf/partner.cfg. V opačnom prípade by mal majetok zostať nezmenený.

4. Overte, či je cesta k prostrediu JDK/JRE správna v devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Telefóny Polycom

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

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

Proces migrácie pre telefóny Polycom:

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

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

Pokyny na spustenie

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

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

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

Denníky terminálu

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

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 migrácii zariadenia sú zariadenia online a pripravené na uskutočňovanie/prijímanie hovorov. Pozrite si obrázok 15, kde nájdete príklad stavu zariadenia:

Obrázok 15: Stav zariadenia

Po migrácii zariadenia sa čísla aktivovali. Pozrite si obrázok 16, kde nájdete príklad toho, ktoré čísla sú aktívne:

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

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

Pre operátora BroadCloud

Proces vrátenia pre partnerov BroadCloud je nasledovný:

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

Pre Cisco BroadWorks a Webex pre BroadWorks

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

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

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

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

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

Vrátiť späť profily

./devicemove.sh -input=  -revertProfiles

Vrátiť čísla

./devicemove.sh -input=  -revertNumbers

Denníky terminálu

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

Vrátiť späť profily

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átiť čí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