Дякуємо за відгук.

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

Після завантаження витягніть бінарні файли інструменту міграції.

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

Виконайте наступну команду в терміналі всередині каталогу генератора токенів:

Вікна:

token_generator.bat

МакОС:

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

Перехід до каталогу забезпечення:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Виконайте наступну команду, щоб отримати поточні параметри забезпечення OCI:

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

Крок 4: Виконайте команду нижче в CLI, щоб переконатися, що ваша конфігурація правильна.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Перевірте розгорнутий і активний відкритий клієнтський сервер

Використовуйте наведені нижче команди, щоб розгорнути та запустити сервер відкритого клієнта на вторинному сервері додатків, якщо він не розгорнутий або ще не запу щений.

Крок 1: Розгорніть сервер за допомогою наступної команди CLI:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Крок 2: Запустіть сервер за допомогою цієї команди:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Увімкнути активацію номерів

Виконайте наступні команди в CLI, щоб включити активацію номерів:

Крок 1: Запустіть команду активації числа:

AS_CLI> cd SubscriberMgmt/NumberActivation

Крок 2: Запустіть команду включеної активації:

AS_CLI> set dnMode groupAndUserActivationEnabled

Крок 3: У рядку підтвердження введіть Y.

Для Бродхмар

Інструмент вилучення інтегро ваний на портал постачальника послуг BroadCloud. Адміністратор постачальника послуг може:

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, якщо вторинний шлях середовища JDK/JRE сервера додатків Cisco BroadWorks відрізняється від файлу:

   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 (екстраговані_data_ .zip<timestamp>) доступний у тому ж каталозі інструментів вилучення. Скористайтеся наступною командою, щоб переглянути та використовувати файл 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

Якщо адміністратор керує інструментом за корпоративним проксі-сервером, виконайте наведені нижче дії, щоб налаштувати та виконати скрипт експорту.

Кроки для налаштування та виконання сценарію експорту

1. Відкрийте файл export.sh.
2. Знайдіть змінну HTTPS_PROXY_HOST і скасуйте її (видаліть початкове #).

3. Встановіть значення HTTPS_PROXY_HOST як:

   HTTPS_PROXY_HOST=<proxy-host>

4. Знайдіть змінну HTTPS_PROXY_PORT і скасуйте її (видаліть початкове #).
5. Встановіть значення HTTPS_PROXY_PORT як:

   HTTPS_PROXY_PORT=<proxy-port>

6. Збережіть і закрийте файл export.sh.
7. Відкрийте файл partner.cfg і додайте необхідний токен refresh.
8. Переконайтеся, що хост BroadWorks, ім'я користувача та пароль правильно налаштовані в partner.cfg.
9. Запустіть скрипт:

   ./export.sh

Форма заручини:

Інструмент вилучення (BroadCloud та BroadWorks) тепер автоматично генерує консолідований файл XLSX під назвою Форма взаємодії SUA.xlsx під час виконання. Файл попередньо заповнений усіма доступ ними даними на відповідних робочих аркушах, що допомагає оптимізувати та прискорити завершення роботи партнерів.

Цей інструмент трансформації працює для всіх міграцій. Інструмент трансформації працює на будь-якому комп'ютері, включаючи ноутбук адміністратора партнера, і використовує загальнодоступні API Webex. Він читає вихідний файл ZIP (extracted_data_ .zip<timestamp>) інструмента витягування як вхідного файлу та перетворює необроблений XML у формат JSON, який використовується інструментом забезпечення.

передумови

Після завантаження та вилучення бінарних файлів інструментів міграції налаштуйте наступні передумови:

1. Встановіть REFRESH_TOKEN (Токен, скопійований з інструмента генератора токенів) та NAME_OF_MAIN_LOCATION у файлі conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. За бажанням встановіть PROVISIONING_ID (скопійований із шаблону в Partner Hub) у файлі conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Щоб отримати більш повну перевірку адреси електронної пошти клієнта, ви можете за бажанням встановити PROVISIONING_ID.
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=Так у файлі conf/partner.cfg
10. За бажанням увімкніть властивості ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD та ANALOG_USER_TYPE_DISABLE_T38, щоб налаштувати очікування виклику, музику в режимі очікування та вимкнути налаштування T38 для всіх користувачів аналогового типу.

11. Якщо ви хочете налаштувати загальні пристрої шлюзу, додайте MAC-адресу пристрою та ідентифікатор користувача до файлу input/genericgateways.csv. Також вкажіть, чи є користувач основним власником чи спільним користувачем (для спільних викликів). Це потрібно лише в тому випадку, якщо адміністратори партнерів планують використовувати загальні пристрої шлюзу в оптових дзвінках.

    Ця функція недоступна для міграції BroadCloud на оптову торгівлю.

12. Для міграції BroadCloud, щоб перетворити всіх користувачів з ти пом станції обміну повідомленнями на voice_mail_group, оновіть файл conf/rialto_station_type_to_wholesale_package.csv, замі нивши значення Оп товий пакет на voice_mail_group для рядка, де повідомляє Тип станції Rialto.

    Додатково увімкніть властивість COMMON_VOICE_MAIL_GROUP_PASSCODE у partner.cfg, щоб налаштувати типовий PIN-код для груп голосової пошти.

    Якщо ця властивість не вказана в partner.cfg, вона повинна бути вказана для кожного клієнта у фай лі customers.csv у стовпці CommonVoicEmailGroupPassCode.

13. Для міграції спільних контактів до Webex Calling

    Це вдосконалення для управління загальними контактами на рівні підприємства та сайту. Тепер ці контакти можна перенести як контакти організації (Органські контак ти), або як віртуальні розширення, залежно від налаштувань конфігурації. Нижче наведено деталі, які допоможуть вам пройти цей процес міграції.

    Конфігурація ключа:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      У файлі partner.cfg в водиться нова властивість COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE. Ця властивість визначає спосіб перенесення загальних контактів з Rialto доWebex Calling.

    • Без налаштування COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Загальні контакти будуть перенесені як контакти організації (Контакти організації).

      Ніякої додаткової конфігурації не потрібно.

      Контакти залишаються доступними на рівні організації.

    • З налаштованим COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Загальні контакти будуть перенесені як вірту альні розширення.

      До кожного контакту буде додано номер розширення, а початковий діапа зон розширення визначається у властивості COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE у partner.cfg.

      Віртуальні розширення підтримуються як на рівні організації, так і на рівні місцезнаходження, залежно від сфер и контакту.

14. Увімкніть постачальника запису дзвінків за замовчуванням для Webex.

    Цей крок необхідний лише при перенесенні налаштувань запису дзвінків для користувачів, налаштованих за допомогою Dubber, до Cisco Native Call Rec ording у Webex.

    Щоб увімкнути цю опцію:

    • У файлі partner.cfg встановіть наступну властивість, Default _CALL_RECORDING_VENDOR=WebEx.
    • Крім того, використовуйте властивість WEBEX_CALL_RECORDING_STORAGE_REGION для налаштування області зберігання.

      О пція запису на вимогу з BroadCloud не підтримуєтьсяWebex Calling. Ці параметри запису дзвінків не мігруються і відображати муться у звіті про винятки.

15. Виключення вибраних номерів телефонів з міграції:

    Щоб виключити певні телефонні номери з процесу міграції, необхідно виконати наступну двоетапну процедуру за допомогою інструмента перетворення:

    • Спочатку виконайте інструмент перетворення вперше. Після завершення інструмент створить файл з назвою telephone_numbers_inventory.csv, розташований у каталозі output/timestamp/. Клієнт повинен переглянути цей файл і вказати «Так» у стовпці «Drop Tn's» для кожного номера телефону, який слід виключити з майбутньої міграції.
    • Після оновлення файлу telephone_numbers_inventory.csv відповідними прапорцями виключення інструмент трансформації виконується в друге. Оновлений файл слід передати як аргумент у наступному форматі.

      . /transform.sh -екстракт=введення/вилучені_даних_1747640608219.zip -номери вимкнення= {filepath/telephone_numbers_inventory.csv}

16. Додатково встановіть властивість ALLOW_RESTRICT_BY_PARTNER_MODE на OFF, щоб дозволити адміністраторам клієнтів змінювати параметри, визначені партнером, у Центрі керування.
17. Для міграції мобільних номерів (BroadWorks Mobility) з BroadCloud на Webex Calling

    У цьому розділі описано міграцію функції BroadWorks Mobility (мобільні номери клієнтів) з BroadCloud (інтеграція мобільної мережі) на оптовий продаж Webex Calling (оператор мобільної мережі Webex Go).

    Передумови. Перед початком процесу міграції адміністратори-партнери повинні зв'язатися з командою облікових записів Cisco, щоб виконати конфігурацію постачальника хмарного підключення PSTN (CCP) та спеціального списку операторів (CCL).

    У файл partner.cfg додано нову власти вість ASSIGN_MOBILE_NUMBERS_TO_USERS. Увімкніть цю властивість, щоб дозволити присво єння та перенесення мобільних номерів користувачам.

    • Ця функція підтримується лише для міграції Broadcloud на оптову торгівлю.
    • У оптовому Webex кінцеві користувачі можуть мати номер мобільного телефону або номер PSTN (не обидва), на відміну від BroadCloud.
    • Коли користувачеві присвоюється номер мобільного телефону, його основний номер PSTN стає його вторинним (альтернативним) номером.
    • Мобільні номери не можна перенести для користувачів, які перетворюються на робочі простори або віртуальні лінії.
    • Після того, як номер мобільного телефону буде присвоєно в оптовому Webex, він відобра жатиметься як Активний у Центрі управління. Цей статус не означає, що номер відразу готовий до прийому дзвінків. Мож ливість виклику буде доступна лише після повного завершення міграції.
    • Параметри інтеграції мобільних телефонів, налаштовані кінцевими користувачами на порталі користувачів викликів (CUP), не мігруються. Після міграції, коли викликається номер телефону, номер мобільного телефону або розширення , дзвонять усі пристрої користувача.

18. Щоб додатково налаштувати обмеження кількості пакетів під час міграції клієнта, вка жіть кількість для кожного пакета у файлі input/package_quantity.csv. Налаштована кількість пакетів має бути більшою або дорівнює кількості призначених користувача /робочим простором пакунків.

    Наразі обмеження кількості пакетів не підтримуються для міграції Webex для BroadWorks на оптову торгівлю.

    Під час запуску інструменту трансформації надайте оновлений файл як вхідний параметр:. <extract_zip_file>/transform.sh -екстракт= -пакетиліміти = вхід/пакет_кількість.csv .

19. Міграція сайтів від декількох клієнтів з Broadworks/Broadcloud до одного клієнта в оптовій торгівлі Webex Calling
    • Новий режим виконання, -ConsolidatedMigration, введено в інструмент «Трансформація» для підтримки міграції декількох сайтів клієнтів з Broadcloud/Broadworks на оптову платформу Webex під єдиною організацією оптових клієнтів. Якщо цей режим увімкнено, інструмент об'єд нує кілька сайтів клієнтів в одну організацію оптових клієнтів

      -consolidatedMigration

    • Є й інші необов'язкові аргументи, які можна навести разом з -ConsolidatedMigration, наприклад

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • якщо вказано -targetEnterpriseID, а ідентифікатор існує у вихідному файлі інструмента витягування, то він буде використаний для створення організації замовника оптової торгівлі, а якщо ідентифікатор не знайдено, інструмент повернеться до використання будь-яких доступних даних клієнта з вихідного файлу інстру мента витягування.
    • якщо вказано -ConsolidateDexternalId, він встановить externalId для клієнта, а якщо його не вказано, інструмент повернеться до використання існуючого потоку для зовнішнього ідентифікатора.
    • <timestamp>Зведений файл JSON (customer.json) буде доступний у каталозі output//.

Заповнення input/customers.csv

Файл input/customers.csv містить дані, які, можливо, відсутні в Cisco BroadWorks або BroadCloud. Цей файл можна залишити порожнім, якщо вся обов'язкова інформація вже є. Не потрібно заповнювати всі графи, обов'язковими є лише відсутня інформація.

У таблиці нижче пояснюються найважливіші стовпці в input/customers.csv.

Заповнення input/users.csv

Файл input/users.csv містить дані, які, можливо, відсутні в Cisco BroadWorks або BroadCloud. Цей файл можна залишити порожнім, якщо вся обов'язкова інформація вже є. Не потрібно заповнювати всі графи, обов'язковими є лише відсутня інформація.

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

Запустіть Transform Tool в будь-якій операційній системі. Скористайтеся наведеними нижче кроками, щоб запустити інструмент у Windows та macOS:

Вікна

Виконайте команду нижче, щоб запустити інструмент перетворення в Windows:

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

МакОС

Виконайте наступні дії, щоб запустити інструмент перетворення на 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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Попередня перевірка клієнта/користувача

Інструмент трансформації здійснює виклики 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

Звіт про винятки

Інструмент перетворення генерує звіт про винятки всередині каталогу output/ /exception_report.txt<timestamp>. За допомогою цього звіту можна визначити проблеми, які вплинуть на міграцію, і усунути їх у системі 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

вихід

<timestamp><groupid>Вихідний файл JSON (customer.json) буде доступний у каталозі output//. Зразок фай лу.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 та REFRESH_TOKEN (Токен, скопійований з інструмента генератора токенів). Адміністратори-партнери повинні зв'язатися зі своєю командою облікових записів, щоб отримати PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Встановіть значення SEND_SUBSCRIBERS_WELCOME_EMAIL значення false, якщо партнери не хочуть надсилати користувачам вітальний лист. Типовим значенням є true.

     Webex надсилає вітальні листи лише кінцевим користувачам. Адміністр атори клієнтів не отримують вітальних листів.

     Користувачі та адміністратори клієнтів, що базуються в США та Канаді, отримують окреме сповіщення електронною поштою від RedSky. Плат форма RedSky E911 надсилає цей електронний лист для підтвердження створення облікового запису клієнта для екст рених служб. Ця електронна пошта RedSky відокремлена від віт альних листів Webex і не контролюється налаштуваннями електронної пошти Webex. Для оптових організацій у США та Канаді RedSky автоматично вмикається як постачальник екстрених послуг.

4. Використовуйте властивість WEBEX4BWKS_EMAIL_SUBJECT для міграції Webex для BroadWorks, щоб надіслати тему електронної пошти запиту на зміну пароля для передплатників Webex для BroadWorks.
5. Використовуйте властивість WEBEX4BWKS_EMAIL_BODY для міграції Webex для BroadWorks, щоб надіслати текст електронної пошти запиту на зміну пароля для передплатників Webex для BroadWorks.
6. Використовуйте властивість C USTOM_TAG S для додавання тегів після створення клієнта.
7. Щоб застосувати оптові знижки, адміністратори-партнери повинні зв'язатися з командою облікових записів Cisco перед початком міграції.

   У partner.cfg додано нову властивість APPLY_WHOLESALE_DISCOUNTS. Увімкніть цю властивість, щоб застосувати знижки до користувачів і робочих просторів.

8. (Необов'язково) Явно налаштувати підключення PSTN

   Щоб вказати PSTN-з'єднання для всіх місць, передбачених під час міграції, включаючи основне розташування, додайте до файлу partner.cfg таку властивість:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Якщо властивість не налаштована або коментується, інструмент забезпечення використовує типовий процес вибору з'єднання PSTN.

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

Скористайтеся наступними кроками, щоб запустити інструмент у Windows та macOS:

Вікна

Виконайте наступні дії, щоб запустити інструмент в О С Windows:

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

МакОС

Виконайте наступні дії, щоб запустити інструмент на macOS:

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Передумови для Webex для міграції BroadWorks

Адміні стратори-партнери повинні оновити свій шаблон адаптації BroadWorks для функцій співіснування Webex для Broad Works. Зверніться до наступного зображення:

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

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

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

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

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

Журнали терміналів

Нижче наведено журнали в терміналі про успіш не забезпечення:

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

Буде надрукована таблиця з кількістю локацій, створених для кожного пробігу:

вихід

Інструмент забезпечення генерує звіти про успіх і помилки всередині вихідних файлів/ *.success/error<external_id>. Перегляньте журнали успішності виводу та помилок, щоб перевірити успішне забезпечення.

Система створить файл Provisioning_Report_*.csv у каталозі output/consolidated_report s/. Цей файл містить відомості про успіх і невдачу для кожного об'єкта та його налаштувань, надаючи вичерпний звіт про підготовку.

Інструмент забезпечення також генерує файл Pro visioning_Statistics_*.csv у каталозі output/consolidated_reports/. Цей звіт містить кількість успішно та невдало забезпечених клієнтів, місцезнаходжень, користувачів, пристроїв та функцій групи .

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

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

Малюнок 9: Концентратор управління

Малюнок 10: Пристрої

Малюнок 11: Виклик

Обмеження після резервування

Після завершення підготовки для міграції BroadCloud будуть заблоковані наступні дії:

• CAP Portal — Додавання користувачів або портованих пристроїв.
• SP Portal — Створення ADD замовлень з пристроями або номерами.
• RSB API — Створення ADD замовлень з пристроями або номерами та створення користувачів. Замовлення RSB ADD, зроблені з пристроями або номерами, будуть відхилені.

Міграція BroadCloud на оптову торгівлю - обмеження реєстрації пристрою

Для адміністраторів-партнерів, які мігрують клієнтів з BroadCloud на Wholesale в тому ж регіоні, пристрої можуть бути додані до оптової торгівлі після запуску інструменту забезпечення. Однак ці пристрої стануть придатними для реєстрації на платформі Webex лише після завершення мі грації (переміщення пристрою) для відповідного місця.

Це обмеження не поширюється на:

• Клієнти, які мігрують з Broadworks/W4b на оптовий продаж.
• Міграція від BroadCloud до оптової торгівлі в різних регіонів.

Рекомендовані вказівки

Щоб уникнути проблем з реєстрацією пристрою, завершіть міграцію переміщення пристрою на рівні місцезнаходження, перш ніж спробувати зареєструвати пристрої на платформі Webex для міграції BroadCloud на Wholesale з одного регіону.

Для Бродхмар

Для партнерів BroadCloud використовуйте портал постачаль ника послуг, щоб надіслати запит на міграцію номерів, пристроїв та міграції спіль них викликів (SCA).

На порталі постачальника послуг запит на мігра цію може включати до 50 клієнтів. Протягом доби можна подати максимум 10 запит ів.

Адміністратори можуть увімкнути автоматичний відкат, встановивши ROLLBACK_TO_BROADCLOUD=true у файлі conf/partner.cfg, який переміщує пристрої назад до Broad Cloud після міграції. Він підтримує міграції як тих самих, так і різних регіонів за допомогою NS Sync, але лише для успішних міграцій. Для невдалих , адміністратори повинні підвищити a, Cisco TAC перш ніж вимагати відкату.

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

• Мігра ція. Виберіть цей параметр, щоб ініціювати запит на перенесення номерів, пристроїв та зовнішнього вигляду спільних дзвінків (SCA).
• Стан пристрою — Виберіть цю опцію, щоб переглянути поточний стан пристрою на BroadCloud та дзвінках.

На наступних малюнках показаний портал постачальника послуг.

Малюнок 12: Портал постачальників послуг

Малюнок 13: Портал постачальників послуг

Перене сення вибраних місць (необов'язково)

Щоб розпочати міграцію для певної підмножини місць, перелічених у файлі customer.json, додайте до запиту файл locations.csv. У цьому файлі CSV має бути вказано лише місця, які ви збираєтеся перенести.

Щоб завантажити список доступних активних сайтів, перейдіть до Перегляд клієнтів → Ви брати клієнта → Експортувати місце знаходження у форматі CSV.

Малюнок 14: Експортувати місця у форматі CSV

Увімкнути опцію відключення номерів

Коли ви використовуєте той самий магістраль SIP для Webex Calling і BroadCloud Carrier, адміністратори повинні використовувати параметр «Від ключити номери». Це видаляє телефонні номери від прийому вхідних дзвінків після міграції в BroadCloud.

Щоб увімкнути цю опцію,

1. У файлі partner.cfg встановіть DISCONNECT_NUMBERS_FROM_RIALTO = так.
2. Повторно запустіть інструмент міграції, використовуючи той самий файл customer.json та оновлений partner.cfg.

Якщо номери не відключаються, подайте запит Cisco TAC.

Для Cisco BroadWorks та Webex для BroadWorks

Для міграції Cisco BroadWorks та Webex для BroadWorks інструмент працює на вторинному сервері додатків Cisco BroadWorks у партнерській мережі та підключається до АС через OCI-P. Він використовує вихідний файл JSON (customer.json) Інструмент трансформації як введення та виконує команди OCI-P для міграції пристроїв та м'яких клієнтів.

При успіш ній роботі інструмент переміщення пристрою буде:

1. Зняти реєстрацію пристроїв з Cisco BroadWorks та зареєструвати їх у оптовій торгівлі.
2. Користувачі, які використовують клієнт UC-One, перенаправлять на додаток Webex під час першого входу в систему.
3. Деактивуйте телефонні номери з Cisco BroadWorks або видаліть телефонні номери з BroadCloud.
4. Активуйте номери в оптовій торгівлі.
5. Створюйте загальні виступи дзвінків у оптовій торгівлі для міграції BroadCloud. [Цей крок застосовується лише для міграції BroadCloud].

6. Якщо адміністратор керує інструментом за корпоративним проксі-сервером, виконайте наведені нижче дії, щоб налаштувати та виконати скрипт забезпечення.

   Процедура конфігурації

   1. Відкрийте файл devicemove.sh.
   2. Знайдіть змінну PROXY_HOST і скасуйте її (видаліть початкове # для devicemove.sh).

   3. Встановіть значення PROXY_HOST як:

      PROXY_HOST=<proxy-host>

   4. Знайдіть змінну PROXY_PORT і скасуйте її (видаліть початкове # для devicemove.sh).

   5. Встановіть значення PROXY_PORT як:

      PROXY_PORT=<proxy-port>

   6. Будь ласка, знайдіть змінну PROXY_SCHEME і скасуйте її (видаліть початковий # для devicemove.sh). Цей крок є необов'язковим; якщо він залишається коментованим, значення за замовчуванням для PROXY_SCHEME буде HTTP.

   7. Встановіть значення PROXY_SCHEME як:

      PROXY_SCHEME=<proxy-scheme>

   8. Збережіть і закрийте файл devicemove.sh.
   9. Відкрийте файл partner.cfg і додайте необхідний токен refresh.
   10. Переконайтеся, що хост BroadWorks, ім'я користувача та пароль правильно налаштовані в partner.cfg

   11. Запустіть скрипт:

       ./devicemove.sh

SCP і SSH

1. SCP інструмент переміщення пристрою на вторинний сервер додатків Cisco BroadWorks.
2. SSH на вторинний сервер додатків Cisco BroadWorks, щоб налаштувати передумови та запустити інструмент переміщення пристрою.

передумови

1. Встановіть REFRESH_TOKEN (Токен, скопійований з інструмента генератора токенів) у файлі conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Переконайтеся, що ідентифікатор користувача додаткового сервера Cisco BroadWorks, пароль та ім'я хоста є правильними у файлі conf/ DeviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Щоб повторно надіслати електронні листи з активацією, вам потрібно встановити SEND_SUBSCRIBERS_WELCOME_EMAIL=true у файлі conf/partner.cfg.

   Якщо адміністратори хочуть надсилати своїм користувачам електронні листи із запрошеннями під час міграції, вони повинні скасувати коментар властивості «send_subscribers_welcome_email=true» у файлі conf/partner.cfg. В іншому випадку майно повинно залишатися незмінним.

4. Переконайтеся, що шлях середовища JDK/JRE правильний у devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Телефони Polycom

Щоб перемістити телефони Polycom з Cisco BroadWorks на оп товий дзвінок, адміністратор-партнер повинен створити новий файл типу профілю ідентифікації/пристрою на рівні системи в Cisco BroadWorks для кожного шаблону пристрою Polycom. Зверніться до малюнка 14 і завантажте користувацький файл device-move-tool/conf/deviceProfile/ {region} /polycom_vvx.cfg. Після завантаження нового файлу пристрою переконайтеся, що новостворений файл існує на рівні групи. Також переконайтеся, що файл Migration_%BWMAC Address%.cfg не конфліктує з будь-яким існуючим файлом у вашій системі).

Він використовується всередині інструментом переміщення пристрою.

Процес міграції для телефонів Polycom:

1. Інструмент переміщення пристрою замінює файл %BWMACAddress%.cfg на рівні пристрою на polycom_vvx2.cfg. Цей файл відноситься до міграції_%BWMACAddress%.cfg.
2. Перетворіть профілі пристроїв на рівні групи або на рівні пристрою.
   Дія на рівні групи або на рівні пристрою залежить від конфігурації параметра DeviceLevelRebuild у файлі device-move-tool/conf/partner.cfg.
3. Інструмент переміщення пристрою просить сервер додатків Cisco BroadWorks перезавантажити телефони на рівні групи або на рівні пристрою.
4. Після запиту на перезавантаження телефони Polycom завантажують та обробляють% BWMACAddress%.cfg, який просить телефони Polycom завантажити та обробити міграцію_%BWMACAddress%.cfg, яка встановлює Device.prov.ServerName на https://plcm.sipflash.com.
   https://plcm.sipflash.com для регіону США інші регіони мають різні URL-адреси.
5. Телефон Polycom завантажує %BWMACAddress%.cfg з https://plcm.sipflash.com і керуватиметься ним DMS. Webex Calling

Малюнок 14: Додати файл типу профілю ідентифікації/пристрою

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

Існує два методи виклику DMT, перший - викликати одного клієнта одночасно, а інший - одночасно запускати кількох клієнтів.

Інструмент переміщення пристрою запускається з в торинного сервера додатків Cisco BroadWorks всередині каталогу інструментів переміщення пристрою :

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Журнали терміналів

Нижче наведено журнали в терміналі про успішний запуск інструмента переміщення пристрою для міграції пристрою:

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

вихід

Після міграції пристрою пристрої увійшли в Інтернет і готові здійснювати/приймати дзвінки. Зверніться до малюнка 15, щоб побачити приклад стану пристрою:

Малюнок 15: Стан пристрою

Після міграції пристрою номери стали активними. Зверніться до малюнка 16, щоб побачити приклад того, які числа активні:

Малюнок 16: Числа активні

Якщо адміністратор керує інструментом за корпоративним проксі-сервером, виконайте наведені нижче дії, щоб налаштувати та виконати скрип т DeviceMove.

Кроки для налаштування та виконання скрипта DeviceMove

1. Відкрийте файл devicemove.sh.
2. Знайдіть змінну HTTPS_PROXY_HOST і скасуйте її (видаліть початкове #).

3. Встановіть значення HTTPS_PROXY_HOST як:

   HTTPS_PROXY_HOST=<proxy-host>

4. Знайдіть змінну HTTPS_PROXY_PORT і скасуйте її (видаліть початкове #).
5. Встановіть значення HTTPS_PROXY_PORT як:

   HTTPS_PROXY_PORT=<proxy-port>

6. Збережіть і закрийте файл devicemove.sh.
7. Відкрийте файл partner.cfg і додайте необхідний токен refresh.
8. Переконайтеся, що хост BroadWorks, ім'я користувача та пароль правильно налаштовані в partner.cfg.
9. Запустіть скрипт:

   ./devicemove.sh

Операція реверту повинна виконуватися одночасно для одного підприємства.

Для оператора BroadCloud

Адміністратори можуть встановити ROLLBACK_TO_BROADCLOUD= true в conf/partner.cfg, щоб увімкнути автоматичний відкат. Це повертає пристрої до BroadCloud після успішної міграції в один і той же регіон або між регіонами за допомогою NS Sync. У разі невдал ої міграції зверніться Cisco TAC до запиту на відкат.

Для 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= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Повернути числа

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -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