Підтримувані телефони будуть автоматично створені та призначені користувачам у 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 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.

Змініть каталог 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 на додатковому сервері застосунків, якщо він ще не розгорнутий або не запущений.

Крок 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.
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.
   

   Властивість REFRESH_TOKEN є обов'язковою для міграції Webex для BroadWorks.

5. Змінити JDK/JRE шлях середовища у файлі export.sh, якщо вторинний сервер застосунків Cisco BroadWorks JDK/JRE шлях до середовища відрізняється від шляху до файлу:

   JAVA_HOME=/usr/local/java/java_base

Інструкції для запуску

Виконайте таку команду на вторинному сервері застосунків Cisco BroadWorks з каталогу засобу вилучення:

./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. За потреби встановіть ідентифікатор PROVISIONING_(скопійований із шаблону в Центрі партнерів) у conf/partner.cfg файл:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Щоб отримати повнішу перевірку адреси електронної пошти клієнта, ви можете за потреби встановити ідентифікатор PROVISIONING_.
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. Розкоментуйте рядок "USE_MAC_ADDRESS_FROM_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 попередня перевірка

Інструмент перетворення здійснює виклики 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:
   • Встановіть ідентифікатор оптової торгівлі_, надання послуг_та токенів оновлення_(токен скопійовано з інструмента генератора токенів). Адміністратори партнерів повинні звернутися до своєї команди облікових записів, щоб отримати ідентифікатор PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Встановіть для параметра ДОЗВОЛИТИ_АДМІНІСТРАТОР_ЗАПРОШЕННЯ_ЕЛЕКТРОННІ ПОШТИ значення «хибно», якщо партнер не хоче надсилати користувачам вітальні електронні листи. Значення за замовчуванням — true.

4. Використовуйте властивість WEBEX4BWKS_EMAIL_SUBJECT для міграцій Webex for BroadWorks, щоб надсилати тему електронного листа із запитом на зміну пароля для передплатників Webex for BroadWorks.
5. Використовуйте властивість WEBEX4BWKS_EMAIL_BODY для міграцій Webex for BroadWorks, щоб надіслати тіло електронного листа із запитом на зміну пароля для передплатників Webex for BroadWorks.
6. Функція синхронізації мережевого сервера дозволяє адміністраторам надавати номери телефонів, MAC-адреси та адреси електронної пошти користувачів під час надання в межах міграції в тому ж регіоні. Щоб увімкнути це, встановіть USE_NS_SYNC=yes у conf/partner.cfg.

   Якщо синхронізацію NS вимкнено, налаштування номера телефону та пристрою буде пропущено, а користувачі отримають тимчасові адреси електронної пошти.

Для міграцій BroadCloud у тому ж регіоні:

1. Інструмент пропускає налаштування номерів, пристроїв та спільних виглядів викликів.
2. Інструмент створює користувачів та віртуальних користувачів з розширенням та тимчасовим розширенням.

Для міграцій BroadCloud інший регіон:

1. Інструмент надасть номери, пристрої та спільні дзвінки.
2. Інструмент створює користувачів та віртуальних користувачів із фактичними номерами телефонів та додатковим номером.
   Усі міграції Europe 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. Зверніться до наступного зображення:

Після оновлення шаблону адаптації Webex для BroadWorks для підтримки міграції, зверніться до команди роботи з клієнтами Cisco з проханням увімкнути функцію «wholesale-partner-blending-enabled» на рівні партнера. Це дозволить додавати оптові пакети до існуючих організацій клієнтів Webex для BroadWorks під час налаштування.

Запустіть інструмент підготовки з додатковим аргументом.

Підготовчий етап: – це фаза за замовчуванням, на якій адміністратори можуть надавати користувачам BroadWorks статус оптових передплатників і продовжувати роботу з Webex для користувачів BroadWorks.

Фаза технічного обслуговування: – це другий етап, на якому адміністратори можуть призначити оптову ліцензію існуючим користувачам Webex для BroadWorks. Ви повинні запустити інструмент забезпечення з аргументом maintenance.

Фаза після міграції: Це завершальний етап, на якому адміністратори можуть повністю перетворити BroadWorks на оптовий продаж. Ви повинні запустити інструмент підготовки з аргументом 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 файли. Перегляньте журнали успішних виводів та помилок, щоб перевірити успішне налаштування.

Адміністратори партнерів можуть перевірити налаштування клієнтів у Центрі партнерів та на порталі Центру керування. Зверніться до наступних ілюстрацій з порталу Центру партнерів та Центру керування:

Малюнок 8: Партнерський центр

Малюнок 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 перед запитом на відкат.

На порталі доступні два варіанти вибору типу міграції:

• Міграція – Виберіть цю опцію, щоб ініціювати запит на перенесення номерів, пристроїв та спільних ідентифікаційних даних викликів (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. Створення спільних явних форм викликів у Wholesale для міграцій BroadCloud. [This Крок застосовується лише для BroadCloud migrations].

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. Щоб повторно надіслати активаційні електронні листи, потрібно встановити ПОВТОРНО НАДІСЛАТИ_ЗАПРОШЕННЯ_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

Щоб перенести телефони 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 перезавантажити телефони на рівні групи або пристрою.
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, щоб скасувати міграцію пристроїв. Це поверне URL-адресу DMS до URL-адреси DMS постачальника послуг для профілів пристроїв у Cisco BroadWorks та повторно активує номери телефонів.
3. Команда Webex Calling встановлює URL-адресу DMS назад на URL-адресу DMS постачальника послуг у профілях пристроїв у 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