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

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

Администраторите на партньори стартират този инструмент за генериране на токени поне веднъж, преди да започнат да изпълняват инструменти за миграция. Стартирането на този инструмент е еднократна дейност, след като партньорският акаунт бъде включен в решението Wholesale RTM. Този инструмент позволява на администраторите на партньори да влязат през уеб браузър, за да получат уникалния TOKEN, необходим за актуализиране на конфигурационните файлове на партньора за инструментите за миграция.

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

Инсталирайте 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 адреса в уеб браузъра на терминала, влезте с идентификационните данни на администратора на партньора, за да получите TOKEN и го копирайте за по-нататъшна употреба.

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

Фигура 3: Вход с Cisco Webex

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

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

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

Активиране на OCI-P свързаност

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

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

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

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

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

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.

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

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

Стъпка 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: Портал на доставчика на услуги

Заявка за извличане на CSV файл

Иницииране на заявка за извличане на CSV файл

1. Изтеглете CSV файла на клиента

   Щракнете върху връзката Изтегляне на CSV файл на клиент в горния десен ъгъл на секцията Започване на заявка за извличане на CSV файл.

2. Редактиране на списъка с клиенти

   Администраторът може да редактира този CSV файл, за да включи само клиентите, за които е необходимо да се извърши извличането.

3. Качване и изпращане

   След редактиране, качете променения CSV файл.

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

Иницииране на заявка за извличане за клиент с CSV файл с местоположения

1. Изберете клиент и местоположения за изтегляне

   Изберете клиент от падащото меню.

   Изтеглете съответния locations.csv от Преглед на клиенти→ раздел „Сайтове “ → Експортиране на местоположения като CSV.

2. Редактиране на файла с местоположения

   Администраторът може да редактира CSV файла, за да включва само местоположенията, които желае да извлече.

3. Качване и изпращане

   Качете редактирания файл locations.csv и кликнете върху „Изпращане“.

   Само посочените местоположения за избрания клиент ще бъдат включени в заявката за извличане.

Иницииране на заявка за извличане за всички клиенти

1. Щракнете върху „Изпращане“, за да инициирате заявка за извличане за всички клиенти и всички техни местоположения под текущия доставчик на услуги.

За Cisco BroadWorks и Webex за BroadWorks

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

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

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

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

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

4. Уверете се, че вторичният потребителски идентификатор, парола и име на хост за Cisco BroadWorks Application Server са правилни в 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.
   

   Свойството REFRESH_TOKEN е задължително за миграция на Webex за BroadWorks.

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

   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 адреса и имейл адреса на новия телефон на потребителя към input/newphones.csv файл. Това е необходимо само ако администраторите на партньори искат да осигурят нови телефони в „Обаждания на едро“.
6. Преобразувайте кол центровете на BroadWorks в CxEssentials, като използвате input/cxessentials.csv файл.
7. По желание, активирайте свойството UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, за да конвертирате всички кол центрове в CxEssentials.
8. Използвайте input/locations.csv файл за поддръжка на миграцията в големи предприятия, който позволява на администраторите да мигрират местоположенията на своите клиенти по местоположение
9. По желание активирайте използването на MAC адреси от заглавката на User-Agent на SIP REGISTER съобщението, когато MAC адресът не е наличен в профила на устройството Cisco BroadWorks. Разкоментирайте реда „ИЗПОЛЗВАЙТЕ_MAC_АДРЕС_ОТ_SIP_REGISTER=yes" във файла conf/partner.cfg
10. Функцията за синхронизиране на мрежовия сървър позволява на администраторите да предоставят телефонни номера, MAC адреси и имейл адреси на потребителите по време на предоставянето в миграцията на същия регион. За да го активирате, задайте USE_NS_SYNC=yes в conf/partner.cfg.

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

11. По желание активирайте свойствата АНАЛОГОВ_ПОТРЕБИТЕЛ_ТИП_АКТИВИРАН [_ПОВИКВАНЕ_ЧАКАЩО, АНАЛОГОВ_ПОТРЕБИТЕЛ_ТИП_АКТИВИРАН_МУЗИКА_ВКЛ._ЗАДЪРЖАНЕ и АНАЛОГОВ_ПОТРЕБИТЕЛ_ТИП_ДЕАКТИВИРАН_T38, за да конфигурирате чакащо повикване, музика при задържане и да деактивирате настройките на T38 за всички потребители с аналогов тип.

Запълване на input/customers.csv

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

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

Запълване на input/users.csv

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

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

Стартирайте инструмента за трансформация във всяка операционна система. Използвайте стъпките по-долу, за да стартирате инструмента в 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=

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

Инструментът за трансформация (Transform Tool) извършва API повиквания към Webex, за да открие потенциални проблеми с осигуряването. По подразбиране ще се валидират адресът и основният имейл на клиента. Ако стойността на PROVISIONING_ID е посочена в 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

Доклад за изключения

Инструментът за трансформация генерира отчет за изключение в изхода /<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) ще бъде наличен в output/<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 
     

   • Задайте ALLOW_ADMIN_INVITE_EMAILS на false, ако партньорът не иска да изпраща приветствен имейл на потребителите. Стойността по подразбиране е true.

4. Използвайте свойството WEBEX4BWKS_EMAIL_SUBJECT за миграции на Webex for BroadWorks, за да изпратите темата на имейла със заявка за промяна на парола за абонати на Webex for BroadWorks.
5. Използвайте свойството WEBEX4BWKS_EMAIL_BODY за миграции на Webex за BroadWorks, за да изпратите тялото на имейла със заявка за промяна на парола за абонати на Webex за BroadWorks.
6. Функцията за синхронизиране на мрежовия сървър позволява на администраторите да предоставят телефонни номера, MAC адреси и имейл адреси на потребителите по време на предоставянето в миграцията на същия регион. За да го активирате, задайте USE_NS_SYNC=yes в conf/partner.cfg.

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

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

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

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

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

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

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

Windows

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

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. Вижте следното изображение:

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

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

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

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

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

Терминални логове

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

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

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

Изход

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

Администраторите на партньори могат да проверят осигуряването на клиентите в портала „Център за партньори“ и „Център за управление“. Вижте следните илюстрации от портала 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 Sync, но само за успешни миграции. За неуспешни, администраторите трябва да повдигнат Cisco TAC, преди да поискат връщане към предишна версия.

В портала има две опции за избор на типа миграция:

• Миграция – Изберете тази опция, за да инициирате заявка за мигриране на номера, устройства и споделени повиквания (SCA).
• Състояние на устройството – Изберете тази опция, за да видите текущото състояние на устройството в BroadCloud и Calling.

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

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

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

Мигриране на избраните местоположения (по избор)

За да започнете миграцията за конкретен набор от местоположения, изброени във файла customer.json, включете файл locations.csv към заявката си. Този CSV файл трябва да изброява само местоположенията, които възнамерявате да мигрирате.

За да изтеглите списъка с налични активни сайтове, отидете на Преглед на клиенти → Изберете клиент → Експортиране на местоположения като CSV.

Фигура 14: Експортиране на местоположения като CSV

За Cisco BroadWorks и Webex за BroadWorks

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

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

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

SCP и SSH

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

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Уверете се, че вторичният потребителски идентификатор, парола и име на хост за Cisco BroadWorks Application Server са правилни в conf/deviceMoveTool.conf файл:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. За да изпратите отново имейли за активиране, трябва да зададете ИЗПРАТИ ПОКАНАТА__EMAILS=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 от Cisco BroadWorks към Wholesale Calling, администраторът на партньор трябва да създаде нов Identity/Device Файл с тип профил на системно ниво в Cisco BroadWorks всеки шаблон за устройство Polycom. Вижте фигура 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. Пресъздайте профилите на устройствата на ниво група или на ниво устройство.
   Действията на ниво група или устройство зависят от конфигурацията на параметъра 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 и ще бъде управляван от Webex Calling DMS.

Фигура 14: Identity/device добавяне на файл с тип профил

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

Има два метода за извикване на 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

Изход

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

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

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

Фигура 16: Активни числа

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

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

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

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

За Cisco BroadWorks и Webex за BroadWorks

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

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

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

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

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

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

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