Поддържаните телефони ще бъдат автоматично създадени и зададени на потребителите в Webex Calling от инструмента за осигуряване. Телефоните, маркирани с „Да“ в колоната „Поддържани в инструмента за преместване на устройства“, също ще бъдат автоматично преместени от Cisco BroadWorks или BroadCloud в Webex Calling, когато се изпълнява инструментът за преместване на устройства. Телефоните, маркирани с „Не“ в тази колона, се нуждаят от ръчна намеса, за да променят URL адреса на DMS в шаблона за устройства Cisco BroadWorks или в самия телефон.

Последната колона предоставя съпоставянето на моделите на телефоните с колоната „Тип устройство“ на файла transform-tool/input/newphones.csv. (Вижте раздела Инструмент за трансформация в тази статия за повече информация относно newphones.csv).

Администраторите на партньори стартират този инструмент на помощната програма за генератор на маркери поне един път, преди да започнат да стартират инструменти за мигриране. Изпълнението на този инструмент е еднократна дейност, след като партньорският акаунт бъде включен в решението Wholesale RTM. Този инструмент позволява на администраторите на партньори да влизат през уеб браузър, за да получат уникалния МАРКЕР, необходим за актуализиране до партньорските конфигурационни файлове за инструментите за мигриране.

Предварителни изисквания

Инсталирайте Java 8, 11, 17 или 21 на компютъра. Java се предлага от много източници, включително:

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

След изтегляне извлечете бинарите на инструмента за мигриране.

Инструкции за изпълнение

Изпълнете следната команда в терминала в директорията на генератора на маркери:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Изход:

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

Отворете URL адреса в уеб браузъра на терминала, влезте с идентификационните данни на партньорския администратор, за да получите маркера и да го копирате за по-нататъшна употреба.

Илюстрациите на потребителския интерфейс са дадени по-долу за справка:

Фигура 3: Влизане със Cisco Webex

Фигура 4: Прозорец за идентификационни данни

Фигура 5: Генериране на маркер

Конфигурирайте следните стъпки, преди да изпълните инструментите за извличане и преместване на устройства на вторичния сървър на BroadWorks.

Разрешаване на OCI-P свързаност

Инструментът за преместване на устройството комуникира с BroadWorks чрез OCI-P команди, за да активирате OCI-P свързаност, използвайте стъпките по-долу:

Стъпка 1: Използвайте CLI, за да конфигурирате общите настройки.

Изпълнете следната команда в CLI, за да промените в директорията GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Изпълнете следната команда в CLI, за да получите текущите общи настройки:

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

Ако настройките ви не съвпадат с горните, използвайте командата set , за да преконфигурирате настройките си.

Стъпка 2: Използвайте CLI, за да конфигурирате OCI прокси сървъра.

Промяна на директорията на OCI прокси:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Изпълнете следния CLI, за да получите текущите настройки. Трябва да видите следното:

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

Ако настройките ви не съвпадат с горните, използвайте командата set , за да преконфигурирате настройките си.

Стъпка 3: Използвайте CLI, за да конфигурирате обезпечаване на OCI.

Промяна в указателя за осигуряване:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Изпълнете следната команда, за да получите текущите настройки за обезпечаване на OCI:

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

Стъпка 4: Изпълнете командата по-долу в CLI, за да проверите дали конфигурацията ви е правилна.

 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.

Потвърждаване, че отвореният клиентски сървър е разположен и активен

Използвайте командите по-долу, за да разположите и стартирате отворения клиентски сървър на вторичния сървър на приложения, ако той не е разгърнат или още не сте стартирали.

Стъпка 1: Разположете сървъра със следната CLI команда:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Стъпка 2: Стартиране на сървъра с тази команда:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Разрешаване на активиране на номера

Изпълнете следните команди в CLI, за да активирате активирането на номерата:

Стъпка 1: Изпълнете командата за действие на номер:

AS_CLI> cd SubscriberMgmt/NumberActivation

Стъпка 2: Изпълнете командата за активиране:

AS_CLI> set dnMode groupAndUserActivationEnabled

Стъпка 3: В подканата за потвърждение въведете Y.

За BroadCloud

Инструментът за извличане е интегриран в портала на доставчика на услуги BroadCloud. Администраторът на доставчик на услуги може:

1. Изпращайте заявки за извличане за до 50 клиенти на заявка.
   Искането за извличане не може да бъде подадено за един и същ клиент повече от 10 пъти на ден.
2. Изтеглете извлечения файл с данни в ZIP формат до 28 дни от датата на подаване на заявката.

Цифрите по-долу показват портала на доставчика на услуги.

Фигура 6: Портал на доставчик на услуги

Фигура 7: Портал на доставчик на услуги

За Cisco BroadWorks и Webex за BroadWorks

1. Инструментът за извличане се изпълнява на вторичния сървър на приложението Cisco BroadWorks в партньорската мрежа и се свързва чрез OCI-P.
2. Инструментът изтегля необработени данни за предприятие, група, номера, потребители, услуги, устройства и софтуерен клиент от платформата Cisco BroadWorks или BroadCloud и извежда тези данни в XML файлове, които предоставят входовете за инструмента за трансформация.

Следващите раздели обясняват как да инсталирате и конфигурирате инструмента за извличане.

Предварителни изисквания

1. SCP бинарите на инструмента за извличане към вторичен сървър на приложението Cisco BroadWorks.
2. SSH към вторичния сървър на приложението Cisco BroadWorks, за да конфигурирате предварителните изисквания и да стартирате инструмента за извличане.
3. Конфигурирайте Доставчика на услуги и ИД на група за извличане от Cisco BroadWorks в conf/exportTool.yml. Вижте примерния фрагмент YAML по-долу:

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

4. Уверете се, че вторичният ИД на потребител, парола и име на хост на сървъра на приложението Cisco BroadWorks са правилни във файла conf/partner.cfg:

   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 задължително за мигриране на Webex за BroadWorks.

5. Променете пътя на средата JDK/JRE във файла export.sh, ако вторичният път на средата JDK/JRE на сървъра на приложението Cisco BroadWorks е различен от файла:

   JAVA_HOME=/usr/local/java/java_base

Инструкции за изпълнение

Изпълнете командата по-долу във вторичния сървър на Cisco BroadWorks Application Server от директорията с инструменти за извличане:

./export.sh

Регистрационни файлове на терминала

В терминала при успешно експортиране са налични следните регистрационни файлове: Изпълняващ се инструмент за експортиране на данни на BroadSoft:

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

Изход

Изходен ZIP файл (extracted_data_<timestamp>.zip) ще бъде наличен в същата директория с инструменти за извличане. Използвайте командата по-долу, за да видите и използвате ZIP файла за въвеждане на инструмента за трансформация:

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

Този инструмент за трансформация се изпълнява за всички миграции. Инструментът за трансформация се изпълнява на всеки компютър, включително лаптоп на администратор на партньор, и използва публичните API на Webex. Той чете изходния ZIP файл (extracted_data_<timestamp>.zip) на инструмента за извличане като вход и трансформира необработения XML във формат JSON, който се използва от инструмента за обезпечаване.

Предварителни изисквания

След изтегляне и извличане на двоичните инструменти за мигриране конфигурирайте следните изисквания:

1. Задайте маркера за ОБНОВЯВАНЕ_ (маркер, копиран от инструмента за генератор на маркери) и ИМЕ_НА_ОСНОВНОТО_МЕСТОПОЛОЖЕНИЕ във файла conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Като опция задайте ИД за ОСИГУРЯВАНЕ_ (копиран от шаблона в Partner Hub) във файла conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   За да получите по-пълно потвърждаване на имейл адреса на клиента, можете да зададете ИД на ОСИГУРЯВАНЕ_.
3. Конфигурирайте липсваща информация във файла input/customers.csv (вижте следващия раздел), ако липсва.
4. Добавете имейл адреса на крайния потребител във файла input/users.csv.
5. Ако трябва да бъдат осигурени нови телефони, добавете mac адреса и имейл адреса на новия телефон на потребителя, за да въведете/newphones.csv файла. Това е необходимо само ако администраторите на партньора искат да осигурят нови телефони в повикванията на едро.
6. Конвертирайте центровете за повиквания на BroadWorks в CxEssentials, като използвате input/cxessentials.csv файл.
7. Като опция активирайте НАДСТРОЙВАНЕ_ВСИЧКИ_ЦЕНТРОВЕ ЗА ПОВИКВАНИЯ__ДО_CX_ESSENTIALS, за да конвертирате всички центрове за повиквания в CxEssentials.
8. Използвайте файла input/locations.csv, за да поддържате миграцията на големи предприятия, която позволява на администраторите да мигрират местоположенията на клиентите си по местоположение
9. Като опция разрешете използването на MAC адреси от заглавката „Потребител-агент“ на съобщението SIP REGISTER, когато MAC адресът не е наличен в профила на устройството на Cisco BroadWorks. Премахнете коментар за реда „ИЗПОЛЗВАНЕ НА_MAC_АДРЕС_ОТ_SIP_REGISTER=да“ във файла conf/partner.cfg
10. Функцията за синхронизиране на мрежови сървъри позволява на администраторите да осигуряват телефонни номера, MAC адреси и имейл адреси на потребители по време на осигуряването в същата миграция на регион. За да го активирате, задайте USE_NS_SYNC=yesconf/partner.cfg.

    Ако синхронизирането на NS е деактивирано, осигуряването на телефонен номер и устройство ще бъде прескочено, а потребителите ще получат временни имейл адреси.

Попълване на въведените данни/customers.csv

Файлът input/customers.csv предоставя данни, които може да липсват в Cisco BroadWorks или BroadCloud. Този файл може да бъде оставен празен, ако вече е налична цялата задължителна информация. Не е необходимо да попълвате всички колони, само липсващата информация е задължителна.

Таблицата по-долу обяснява най-важните колони в input/customers.csv.

Инструкции за изпълнение

Изпълнете инструмента за трансформация във всяка операционна система. Използвайте стъпките по-долу, за да изпълните инструмента в Windows и macOS:

Windows

Изпълнете командата по-долу, за да изпълните инструмента за трансформация в Windows:

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

macOS

Изпълнете следните стъпки, за да изпълните инструмента за трансформация на macOS:

1. Създайте виртуална среда и инсталирайте зависимости, за да изпълните инструмента за трансформация с помощта на Python:

   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. Изпълнете инструмента за трансформация:

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

Предварителна проверка на клиент/потребител

Инструментът за трансформация прави API повиквания до Webex за наваксване на потенциални проблеми с осигуряването. По подразбиране това ще валидира адреса и основния имейл на клиента. Ако стойността на ИД за ОСИГУРЯВАНЕ_е посочена във файла conf/partner.cfg, тя ще валидира и информацията за местоположението. Резултатите от предварителната проверка са включени в отчета за изключения.

Освен това следните незадължителни параметри могат да бъдат добавени при изпълнение на инструмента за трансформация:

предварителна проверка

В допълнение към изпълнението на API за предварителна проверка за информация за клиента, инструментът за трансформация ще стартира и API за предварителна проверка за имейлите на абонатите.

информация за предварителната проверка

По подразбиране в отчета за изключения са включени само грешки преди проверка (т.е. проблеми, които ще блокират осигуряването). Добавянето на този флаг ще включва и успешни резултати от предварителната проверка (напр. ако вече съществува организация на Webex, която може да бъде прикачена автоматично).

Регистрационни файлове на терминала

Следните регистрационни файлове в терминала при успешна трансформация:

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

Отчет за изключения

Инструментът за трансформация генерира отчета за изключения в директорията output/<timestamp>/exception_report.txt . Можете да използвате този отчет, за да идентифицирате проблемите, които ще повлияят на мигрирането, и да ги коригирате в системата Cisco BroadWorks.

След като промените потребителските данни, за да отстраните изключението, изпълнете отново инструментите за извличане и трансформация с новите данни. Файлът на примерния отчет за изключения, както следва:

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

Изход

Ще бъде наличен изходен JSON файл (customer.json) в изходната/<timestamp>/<groupid> директория. Примерният файл customer.json е както следва:

{
    "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"
    }
}

Инструментът за осигуряване може да се изпълнява на всяка машина, обикновено на (лаптоп на администратора на партньора) и използва публичните API на Webex. Той чете изходния JSON файл на инструмента за трансформация (customer.json) като вход и обезпечаване на клиентите, местоположенията, числата, потребителите, услугите и устройствата в решението Webex Wholesale RTM.

Предварителни изисквания

Конфигурирайте следните изисквания в указателя на инструментите за обезпечаване:

1. Инсталирайте Java 8, 11, 17 или 21 на компютъра. Java се предлага от много източници, включително:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. След изтегляне и извличане на бинарите на инструментите за мигриране задайте променливата JAVA_HOME среда в provisioning_tool.sh за MAC и provisioning_tool.bat за Windows.
3. Файлът partner.cfg:
   • Задайте ИД на ЕДРО_ОСИГУРЯВАНЕ_ и МАРКЕР ЗА ОБНОВЯВАНЕ_ (маркер, копиран от инструмента за генератор на маркери). Администраторите на партньора трябва да се свържат със своя екип за акаунти, за да получат ИД на ОСИГУРЯВАНЕ_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Задайте ПОЗВОЛЯВАНЕ_АДМИНИСТРАТОРСКИ_ПОКАНИ_ИМЕЙЛИ на False, ако партньорът не иска да изпраща приветствен имейл до потребителите. Стойността по подразбиране е „вярно“.

4. Използвайте свойството на тема WEBEX4BWKS_ИМЕЙЛ_ за Webex за миграции в BroadWorks, за да изпратите темата на имейла с искане за промяна на парола за абонати на Webex за BroadWorks.
5. Използвайте свойството на тялото на _WEBEX4BWKS_ ИМЕЙЛ ЗА Webex за BroadWorks миграции, за да изпратите тялото на имейла с искане за промяна на парола за абонати на Webex за BroadWorks.
6. Функцията за синхронизиране на мрежови сървъри позволява на администраторите да осигуряват телефонни номера, MAC адреси и имейл адреси на потребители по време на осигуряването в същата миграция на регион. За да го активирате, задайте USE_NS_SYNC=yesconf/partner.cfg.

   Ако синхронизирането на NS е деактивирано, осигуряването на телефонен номер и устройство ще бъде прескочено, а потребителите ще получат временни имейл адреси.

За миграции на BroadCloud един и същ регион:

1. Инструментът прескочи номерата, устройствата и осигуряването на споделени изгледи на повиквания.
2. Инструментът създава потребители и виртуални потребители с вътрешен номер и временен вътрешен номер.

За миграции на BroadCloud друг регион:

1. Инструментът ще осигури номера, устройства и появявания на споделени повиквания.
2. Инструментът създава потребители и виртуални потребители с действителни телефонни номера и вътрешни номера.
   Всички миграции на BroadCloud в Европа са към друг регион.

Инструкции за изпълнение

Използвайте следните стъпки, за да изпълните инструмента в Windows и macOS:

Windows

Изпълнете следните стъпки, за да изпълните инструмента на Windows OS:

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

macOS

Изпълнете следните стъпки, за да изпълните инструмента на macOS:

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

Предварителни изисквания за Webex за мигриране на BroadWorks

Администраторите на партньори трябва да актуализират своя шаблон за включване на BroadWorks за функциите за съвместно съществуване на Webex за BroadWorks. Вижте следното изображение:

След като шаблонът за включване на Webex for BroadWorks бъде актуализиран, за да поддържа мигриране, поискайте от екипа за акаунти на Cisco да активира превключвателя на функцията „разрешено за смесване на едро с партньори“ на ниво партньор. Това ще позволи да се добавят пакети на едро към съществуващите клиентски организации на Webex за BroadWorks по време на осигуряването.

Изпълнете инструмента за осигуряване с допълнителен аргумент.

Фаза на подготовка: е фазата по подразбиране, в която администраторите могат да осигуряват потребителите на BroadWorks като абонат на едро и да продължат с Webex за потребителите на BroadWorks.

Поддържаща фаза: е втората фаза, в която администраторите могат да разпределят лиценза за търговия на едро на съществуващия Webex за потребители на BroadWorks. Трябва да изпълните инструмента за обезпечаване с аргумент поддръжка.

Фаза след мигриране: Е последната фаза, в която администраторите могат да конвертират напълно BroadWorks в Wholesale. Трябва да изпълните инструмента за осигуряване с аргумент след миграция.

Регистрационни файлове на терминала

Следват регистрационните файлове в терминала за успешно осигуряване:

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

Таблицата ще бъде отпечатана с броя на създадените местоположения за всяко изпълнение:

Изход

Инструментът за осигуряване генерира отчети за успех и грешки във файловете output/<external_id>/*.success/error . Прегледайте успешните резултати и регистрационните файлове за грешки, за да потвърдите успешното осигуряване.

Администраторите на партньори могат да проверяват осигуряването на клиенти в портала Partner Hub и Control Hub. Вижте следните илюстрации от портала Partner Hub и Control Hub:

Фигура 8: Partner Hub

Фигура 9: Control Hub

Фигура 10: Устройства

Фигура 11: Повикване

За BroadCloud

За партньори на BroadCloud използвайте портала на доставчика на услуги, за да подадете искане за мигриране на номера, устройства и SCA мигриране.

В рамките на портала на доставчика на услуги заявката за мигриране може да включва до 50 клиенти. В рамките на един ден могат да бъдат подадени максимум 10 искания.

Функцията за синхронизиране на мрежови сървъри позволява на администраторите да деактивират местоположението на BroadCloud и да активират местоположението на Webex Calling при настройка USE_NS_SYNC=yes в conf/partner.cfg. След мигрирането устройствата и телефонните номера се активират в местоположението на Webex Calling.

Администраторите могат да активират автоматизирано връщане обратно, като зададат ROLLBACK_TO_BROADCLOUD=true във файлаconf/partner.cfg , който премества устройствата обратно в BroadCloud след мигрирането. Той поддържа миграции от един и друг регион с NS синхронизиране, но само за успешни миграции. За неуспешните администратори трябва да подадат заявка за обратно повикване със Cisco TAC, преди да поискат връщане обратно.

Цифрите по-долу показват портала на доставчика на услуги.

Фигура 12: Портал на доставчик на услуги

Фигура 13: Портал на доставчик на услуги

За Cisco BroadWorks и Webex за BroadWorks

За миграции на Cisco BroadWorks и Webex за BroadWorks инструментът се изпълнява на вторичния сървър на приложението Cisco BroadWorks в партньорската мрежа и се свързва към AS чрез OCI-P. Той използва изходния JSON файл (customer.json) на Transform Tool като вход и изпълнява OCI-P команди за мигриране на устройства и софтуерни клиенти.

При успешна операция инструментът за преместване на устройството ще:

1. Дерегистрирайте устройства от Cisco BroadWorks и ги регистрирайте в „На едро“.
2. Потребителите, използващи клиента UC-One, ще се пренасочват към приложението Webex при първото влизане.
3. Деактивирайте телефонните номера от Cisco BroadWorks или премахнете телефонните номера от BroadCloud.
4. Активирайте номера за търговия на едро.
5. Създаване на появявания на споделени повиквания в „На едро“ за миграции на BroadCloud. [Тази стъпка е приложима само за мигрирания на BroadCloud].

SCP и SSH

1. SCP инструмента за преместване на устройството към вторичния сървър на приложението Cisco BroadWorks.
2. SSH към вторичния сървър на приложението Cisco BroadWorks, за да конфигурирате изискванията и да стартирате инструмента за преместване на устройството.

Предварителни изисквания

1. Задайте маркера ЗА ОБНОВЯВАНЕ_ (маркер, копиран от инструмента за генериране на маркери) във файла conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Уверете се, че вторичният ИД на потребител, парола и име на хост на сървъра на приложението Cisco BroadWorks са правилни във файла conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. За да изпратите повторно имейли за активиране, трябва да зададете ПОВТОРНО ИЗПРАЩАНЕ_ИМЕЙЛИ С ПОКАНА_=true във файла conf/partner.cfg.

   Ако администраторите желаят да изпращат имейли с покана до потребителите си по време на мигрирането, те трябва да изчистят коментара за свойството \„ПОВТОРНО ИЗПРАЩАНЕ_НА ПОКАНА_EMAILS=true\“ във файла conf/partner.cfg. В противен случай имотът трябва да остане непроменен.

4. Уверете се, че пътят на средата JDK/JRE е правилен в devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Администраторите могат да използват файла locations.csv от входната директория, за да мигрират определени групи вместо всички групи в предприятието.

Телефони на Polycom

За да преместите телефони на Polycom от Cisco BroadWorks в повиквания на едро, администратор на партньор трябва да създаде нов файл за тип самоличност/профил на устройство на системно ниво в всеки шаблон за устройства на Polycom в Cisco BroadWorks. Вижте фигура 14 и качете персонализирания файл device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. След качването на новия файл на устройство се уверете, че новосъздаденият файл съществува на ниво група. Също така се уверете, че файлът migration_%BWMAC ADDRESS%.cfg не е в конфликт с никой съществуващ файл във вашата система).

Използва се вътрешно от инструмента за преместване на устройства.

Процесът на мигриране за телефони на Polycom:

1. Инструментът за преместване на устройството замества файла %BWMACADDRESS%.cfg на ниво устройство с polycom_vvx2.cfg. Този файл се отнася за migration_%BWMACADDRESS%.cfg.
2. Възстановете профилите на устройството на ниво група или устройство.
   Действието на ниво група или ниво устройство зависи от конфигурацията на parameter deviceLevelRebuild във файла device-move-tool/conf/partner.cfg.
3. Инструментът за преместване на устройства моли Cisco BroadWorks Application Server да рестартира телефоните на ниво група или ниво устройство.
4. След заявката за рестартиране телефоните на Polycom изтеглят и обработват% BWMACADDRESS%.cfg, което изисква от телефоните на Polycom да изтеглят и обработват migration_%BWMACADDRESS%.cfg, което задава device.prov.serverName на https://plcm.sipflash.com.
   https://plcm.sipflash.com за региона на САЩ други региони имат различни URL адреси.
5. Телефонът на Polycom изтегля %BWMACADDRESS%.cfg от https://plcm.sipflash.com и ще бъде управляван от DMS на Webex Calling.

Фигура 14: Добавяне на файл с тип на профил за самоличност/устройство

Инструкции за изпълнение

Има два метода за извикване на DMT, първият е да се извика чрез един клиент в даден момент, а другият е да се изпълнява чрез няколко клиента едновременно.

Инструментът за преместване на устройства се изпълнява от вторичния сървър на приложението Cisco BroadWorks в директорията с инструменти за преместване на устройства:

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

Регистрационни файлове на терминала

Следват регистрационните файлове в терминала при успешно изпълнение на инструмента за преместване на устройства за мигриране на устройства:

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

Изход

След мигрирането на устройствата устройствата са дошли онлайн и са готови да извършват/получават повиквания. Вижте фигура 15, за да видите пример за състоянието на устройството:

Фигура 15: Статус на устройството

След мигрирането на устройството номерата станаха активни. Вижте фигура 16, за да видите пример кои номера са активни:

Фигура 16: Активни номера

Операцията за връщане трябва да се изпълни за едно предприятие в даден момент.

За оператор на BroadCloud

Процесът на връщане за партньорите на BroadCloud е както следва:

1. Отворете билет в Cisco TAC, за да поискате връщане на устройството.
2. Изпълнете инструмента за преместване на устройството в режим на връщане:
   • Задаването на телефонните номера ще бъде премахнато от Webex Calling, оставяйки потребителите и услугите само с вътрешни номера.
   • Имейл адресите в Webex Calling ще бъдат върнати към временни имейл адреси.
   • Телефоните ще бъдат изтрити от Webex Calling.
   • Телефонните номера, имейл адресите, използвани като alternateId, и телефоните ще бъдат създадени отново в BroadCloud.
   • Телефоните ще бъдат рестартирани.
3. Администраторите на партньори трябва да преместят PSTN телефонни номера обратно към оператор на BroadCloud.

За Cisco BroadWorks и Webex за BroadWorks

Процесът на връщане за Cisco BroadWorks и Webex за BroadWorks е както следва:

1. Отворете билет в Cisco TAC, за да поискате връщане на устройството.
2. Изпълнете инструмента за преместване на устройството в режим на връщане на вторичния сървър на приложението BroadWorks, за да върнете мигрирането на устройството. Това ще зададе DMS URL обратно към DMS URL адреса на доставчика на услуги за профилите на устройства в Cisco BroadWorks и ще активира отново телефонните номера.
3. Екипът на Webex Calling задава URL адреса обратно към DMS URL адреса на доставчика на услуги в профилите на устройства в Webex Calling.
4. Администраторите на партньори трябва да деактивират или изтриват телефонните номера в Webex Calling чрез портала на Control Hub.
5. Администраторите на партньори трябва да преместят PSTN телефонните номера обратно в Cisco BroadWorks.

Инструкции за изпълнение на инструмента за преместване на устройства в режим на връщане

Следвайте стъпките по-долу, за да стартирате инструмента за преместване на устройство в режим на връщане:

Изпълнете командата по-долу във вторичния сървър на приложението Cisco BroadWorks в директорията с инструменти за преместване на устройства:

Връщане на профилите

./devicemove.sh -input=  -revertProfiles

Връщане на номерата

./devicemove.sh -input=  -revertNumbers

Регистрационни файлове на терминала

Ще получим следните регистрационни файлове в терминала при успешно изпълнение на инструмента за преместване на устройството за операция по връщане:

Връщане на профилите

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

Връщане на номерата

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