Підтримувані телефони будуть автоматично створені та призначені користувачам у Webex Calling за допомогою інструмента підготовки. "Телефони з позначкою ""так"" у стовпці ""Підтримується в інструменті переміщення пристрою"" також будуть автоматично переміщені з Cisco BroadWorks або BroadCloud до Webex Calling, коли буде запущено інструмент переміщення пристрою." "Телефони з позначкою ""Ні"" в цьому стовпці потребують втручання вручну, щоб змінити URL-адресу DMS в шаблоні пристрою Cisco BroadWorks або в самому телефоні."

У останньому стовпці наведено зіставлення моделей телефонів із стовпчиком «Тип пристрою» файлу transform-tool/input/newphones.csv. (Див. розділ Інструмент перетворення цієї статті, щоб отримати додаткову інформацію про newphones.csv).

Адміністратори партнерів принаймні один раз запускають цей інструмент генератора токена, перш ніж почати запускати інструменти міграції. Запуск цього інструмента є одноразовою діяльністю після того, як обліковий запис партнера підключається до рішення Wholesale RTM. Цей інструмент дозволяє адміністраторам партнерів ввійти через веббраузер, щоб отримати унікальний ТОКЕН, необхідний для оновлення до файлів конфігурації партнерів для інструментів міграції.

Обов’язкові умови

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

Установіть шлях середовища JRE/JDK у token_generator.sh для MAC і token_generator.bat для Windows. Якщо шлях JAVA_HOME вже існує, він буде використаний інструментом повторно.

• mac: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows. JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

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

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

Windows.

token_generator.bat

MacOS:

./token_generator.sh

Вивід:

Ім’я інструмента: Версія інструменту генератора токена: 1.13.0 Завантажте URL у веббраузер: 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, щоб отримати поточні GeneralSettings:

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

Якщо ваші налаштування не збігаються з наведеною вище, використовуйте команду set , щоб повторно налаштувати налаштування.

Крок 2: Використовуйте CLI, щоб налаштувати проксі-сервер OCI.

Змініть каталог на OCI-проксі:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Запустіть наведений далі CLI, щоб отримати поточні налаштування. Ви повинні побачити наступне:

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledВхідРівеньСкринінг = false enableResponseCaching = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 повідомленьЧергаCapacity = 50 повідомленьQueueTimeoutSeconds = 1800 

Якщо ваші налаштування не збігаються з наведеною вище, використовуйте команду set , щоб повторно налаштувати налаштування.

Крок 3: Використовуйте CLI, щоб налаштувати підготовку OCI.

Змініть каталог підготовки:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Щоб отримати поточні налаштування підготовки OCI, запустіть таку команду:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> отримати опис адреси ======================== 127.0.0.1 локальний як 

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

 AS_CLI/Maintenance/ManagedObjects> отримайте Broadworks і переконайтеся, що ваш вивід виглядає нормально. Див. нижче, щоб отримати зразок виводу: AS_CLI/Maintenance/ManagedObjects> отримати Broadworks Керовані об’єкти BroadWorks ========================== * Сервер: Ідентифікаційні дані..............: ЯК версія...............: Пel_21.sp1_1.551 Адміністративна держава: Розблоковані * Програми: Ім’я Версія Розгорнуто Адміністративний стан Ефективний стан ========================================================================================= ВиконанняТаПідготовка 21.sp1_1.551 true Розблокований Розблокований FlashPolicy 21.sp1_1.551 false Розблокований зупинений OpenClientServer 21.sp1_1.551 true Розблокований розблокований WebContainer 21.sp1_1.551 true Розблокований Розблокований 4 записи знайдено. * Обслуговувані програми: Ім’я Версія Context Path Розгорнуто 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 записів знайдено. 

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

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

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

AS_CLI/Maintenance/ManagedObjects> розгортання програми OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> запустити програму OpenClientServer

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

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

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

AS_CLI> cd Абонентське керування/активація номера

Крок 2: Запустіть активовану команду:

AS_CLI> установити групуІАктиваціюКористувачаВвімкнено

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

Для BroadCloud

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

1. Надсилайте запити на екстракт до 50 клієнтів на один запит.
   Запит на витяг не може бути надіслано для того самого клієнта більше 10 разів на день.
2. Завантажте файл вилучених даних у форматі ZIP протягом 28 днів із дати подання запиту.

Наведені нижче цифри показують портал постачальника послуг.

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

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

Для Cisco BroadWorks і Webex для BroadWorks

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

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

Обов’язкові умови

1. SCP двійкові інструменти вилучення на додатковий сервер програм Cisco BroadWorks.
2. SSH на додатковий сервер програм Cisco BroadWorks для налаштування передумов і запуску інструмента витягування.
3. Налаштуйте постачальника послуг та ідентифікатор групи для вилучення з Cisco BroadWorks у conf/exportTool.yml. Див. наведений нижче зразок фрагмента YAML:

   ІдентифікаторПостачальникаПослуг:      - GroupID-A1 - GroupID-A2 - GroupID-B постачальника послуг GroupID-A3:                        - усі 

4. Упевніться, що ідентифікатор користувача, пароль і ім’я хоста вторинних користувачів сервера програм Cisco BroadWorks є правильними у файлі conf/partner.cfg:

   Broadworks_користувач_ID = адміністратор BROADWORKS_Пароль = адміністратор BROADWORKS_організатор_ім’я = ОНОВЛЕННЯ ЛОКАЛЬНОГО ХОСТА_МАРКЕР = Маркер оновлення адміністратора партнера скопійовано з інструменту створення токенів. РЕЖИМ_МІГРАЦІЇ = підтримувані значення webex_for_broadworks_to_wholesale. Значення за замовчуванням: broadworks_to_wholesale. Використовуйте webex_for_broadworks_to_wholesale для Webex для міграції BroadWorks. 

   Властивість ТОКЕНА ОНОВЛЕННЯ_ є обов’язковою для міграції Webex для BroadWorks.

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

   JAVA_HOME=/usr/local/java/java_base

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

Запустіть команду нижче на додатковому сервері програм Cisco BroadWorks із каталогу інструментів витягу:

./export.sh

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

У терміналі під час успішного експорту доступні наступні журнали: Запущений інструмент експорту даних BroadSoft:

 Запуск інструменту експорту даних BroadSoft ************************************************ Запуск інструменту експорту v: 1.15.0 Експорт розпочато для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Експорт користувачів для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Експорт користувачів завершено для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Експорт завершено для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Експорт завершено. output/20221017223452_ExportTool Експортувати дамп Ім’я файлу ZIP-архіву :extracted_data_1666060500618.zip Архівний файл з ім’ям extracted_data_1666060500618.zip створено Процес створення ZIP-файлу виконано Експортовані файли, перетворені як ZIP-файл ************************************************** 

Вихід

Файл вихідного ZIP (extracted_data_.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 жовтень  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 жовтень  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_.zip) як вхідний файл і перетворює необроблений XML у формат JSON, який використовується інструментом підготовки.

Обов’язкові умови

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

1. Установіть токен ОНОВЛЕННЯ_(ТОКЕН, скопійований із засобу створення токенів) і ІМ’Я__ОСНОВНОГО_РОЗТАШУВАННЯ у файлі conf/partner.cfg:

   ОНОВИТИ_ТОКЕН=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj ІМ’Я_АБО_MAIN_LOCATION=Main 

2. Додатково встановіть ідентифікатор ПІДГОТОВКИ_(скопійований із шаблону в Партнерському центрі) у файлі conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Щоб отримати більш повну перевірку адреси електронної пошти клієнта, можна додатково встановити ідентифікатор ПІДГОТОВКИ_.
3. Налаштуйте відсутню інформацію у файлі input/customers.csv (див. наступний розділ) за відсутності.
4. Додайте адресу електронної пошти кінцевого користувача до файлу введення/users.csv.
5. Якщо потрібно надати нові телефони, додайте mac-адресу та адресу електронної пошти нового телефону користувача до файлу input/newphones.csv. Це потрібно лише в тому випадку, якщо адміністратори партнера хочуть підготувати нові телефони під час викликів Wholesale.
6. Конвертуйте колл-центри BroadWorks у CxEssentials за допомогою файлу input/cxessentials.csv.
7. Додатково увімкніть функцію ОНОВЛЕННЯ_ВСІХ_ЦЕНТРІВ ОБРОБКИ викликів__ДО_CX_ESSENTIALS, щоб перетворити всі центри обробки викликів у CxEssentials.
8. Використовуйте файл input/locations.csv для підтримки міграції великих підприємств, що дозволяє адміністраторам виконувати міграцію розташувань своїх клієнтів за розташуванням
9. Додатково ввімкніть використання MAC-адрес із заголовка "Оператор користувача" повідомлення SIP REGISTER, якщо MAC-адреса недоступна в профілі пристрою Cisco BroadWorks. Скасуйте коментарі до рядка «ВИКОРИСТОВУВАТИ_MAC_ADDRESS_FROM_SIP_REGISTER=yes» у файлі conf/partner.cfg

Заповнення вхідних даних/customers.csv

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

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

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

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

Windows

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

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

macOS

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

1. Створіть віртуальне середовище та установіть залежності, щоб запустити інструмент перетворення за допомогою Python:

   python3 -m venv venv джерело venv/ bin/ activate python3 -m pip установлення запитів python3 -m pip установлення запитів- oauthlib 

2. Запустіть інструмент перетворення:

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

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

Інструмент перетворення здійснює виклики API до Webex з метою виявлення потенційних проблем із підготовкою. За замовчуванням буде перевірено адресу й основну адресу електронної пошти клієнта. Якщо значення ідентифікатора ПІДГОТОВКИ_вказано у файлі conf/partner.cfg, воно також перевірить інформацію про розташування. Результати попередньої перевірки включені до звіту про виняток.

Крім того, під час запуску інструменту перетворення можуть бути додані такі необов’язкові параметри:

попередня перевірка

Окрім запуску API попередньої перевірки для інформації про клієнта, інструмент перетворення також запустить API попередньої перевірки для електронних листів передплатників.

інформація про попередню перевірку

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

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

Такі журнали в терміналі про успішне перетворення:

Зведений звіт про підприємства BroadWorks, які можна успішно перемістити: 1 підприємства BroadWorks, які не можуть бути переміщені: 0 користувачів BroadWorks, яких можна успішно перемістити: 4 користувачі BroadWorks, які не можуть бути переміщені: 0 телефонів, які можна успішно перемістити: 3 Телефони, несумісні з Webex Calling: 0 

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

Інструмент перетворення створює звіт про виняток у каталозі output//exception_report.txt . Ви можете використовувати цей звіт, щоб визначити проблеми, які вплинуть на міграцію, і виправити їх у системі Cisco BroadWorks.

Після зміни даних користувача для вирішення винятку повторно запустіть інструменти вилучення та перетворення з новими даними. Зразок файлу звіту про винятки такий:

Звіт про виняток Tue Oct 18 08:12:09 2022 Підприємства з рекомендацією функції заборони зв’язку: вручну налаштуйте план вихідних викликів у Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Вихід

Файл вихідного JSON (customer.json) буде доступний у каталозі output// . Зразок файлу customer.json такий:

{ "customer": { "provisioningId": "!!!!!!!!!!ЗАМІНИТИ_з_Ідентифікатор PROVISIONING!!!!!!!!!!", "пакети": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "адреса": { "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_Йорк", "мова": "en_us", "номери": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "основнийНомер": "+15205551101" } } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "абоненти": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ЗАМІНИТИ_з_ІНДИВІДУАЛЬНИЙ ІДЕНТИФІКАТОР!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "пакет": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "надіслатиBusyCalls": { "ввімкнено": true, "вітання": "ЗА ЗАМОВЧУВАННЯМ" }, "надсилати виклики без відповіді": { "ввімкнено": true, "привітання": "ЗА ЗАМОВЧУВАННЯМ", "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, "надіслатиBusyCalls": { "ввімкнено": true, "вітання": "ЗА ЗАМОВЧУВАННЯМ" }, "надсилати виклики без відповіді": { "ввімкнено": true, "привітання": "ЗА ЗАМОВЧУВАННЯМ", "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, "надіслатиBusyCalls": { "ввімкнено": true, "вітання": "ЗА ЗАМОВЧУВАННЯМ" }, "надсилати виклики без відповіді": { "ввімкнено": true, "привітання": "ЗА ЗАМОВЧУВАННЯМ", "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, "надіслатиBusyCalls": { "ввімкнено": true, "вітання": "ЗА ЗАМОВЧУВАННЯМ" }, "надсилати виклики без відповіді": { "ввімкнено": true, "привітання": "ЗА ЗАМОВЧУВАННЯМ", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_з_PERSONID!!!!!!!!!!", "product": "DMS Cisco 8811", "mac": "F87B  E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "розклади": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Автоматизований голосовий портал", "firstName": "Автоматизований", "lastName": "Голосовий портал", "languageCode": "en_us", "phoneNumber": "+15205551105", "extension": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - профіль пристрою Engg" ], "connect_client_to_upgrade_to_webex_app": [], "розташування": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgІдентифікатор": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Інструмент підготовки може запускатися на будь-якому комп’ютері, зазвичай (ноутбук адміністратора партнера), і використовує загальнодоступні API Webex. Він читає файл виводу інструмента перетворення JSON (customer.json) як вхідний і надає клієнтів, розташування, номери, користувачів, служби та пристрої в рішенні Webex Wholesale RTM.

Обов’язкові умови

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

1. Установіть Java 8, 11 або 17 на комп’ютер. Java доступна з багатьох джерел, зокрема:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Після завантаження та видобування двійкових інструментів міграції установіть змінну середовища JAVA_HOME у provisioning_tool.sh для MAC і provisioning_tool.bat для Windows.
3. Файл partner.cfg:
   • Установити ОПТОВИЙ ПРОДАЖ_підготовка_Ідентифікатор і ОНОВЛЕННЯ_ТОКЕН (токен скопійовано з інструменту створення токенів). Адміністратори партнера повинні звернутися до команди облікового запису, щоб отримати ідентифікатор підготовки_ВІД:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. Використовуйте властивість теми WEBEX4BWKS_EMAIL_SUBJECT для міграції Webex для BroadWorks, щоб надіслати електронний лист теми запиту на зміну пароля для Webex для абонентів BroadWorks.
5. Використовуйте властивість BODY ЕЛЕКТРОННОЇ ПОШТИ WEBEX4BWKS_EMAIL_для міграції Webex для BroadWorks, щоб надіслати текст електронного листа запиту на зміну пароля для Webex для абонентів BroadWorks.

Для міграції з BroadCloud такий самий регіон:

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

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

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

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

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

Windows

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

Щоб надати єдиного клієнта, виконайте наведені нижче дії. provision.bat -input= Для підготовки кількох клієнтів: provision.bat -input= 

macOS

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

Для підготовки одного клієнта: ./transform.sh -input= Для підготовки кількох клієнтів: ./transform.sh -input= 

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

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

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

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

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

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

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

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

Нижче наведено журнали успішної підготовки в терміналі:

Ім’я інструмента: Версія інструменту підготовки: 1.15.0 ********** Розпочато обробку файлу: input/customer.json **************** Підготовка клієнта Очікування завершення підготовки клієнта external_id_engg_grp1... Очікування завершення підготовки клієнтом external_id_engg_grp1...   Стан клієнта external_id_engg_grp1: підготовлені номери підготовки користувачів підготовка функцій користувачів підготовка графіків підготовки привітання підготовки пристроїв підготовка індикацій спільних викликів підготовка автосекретарів підготовки черг викликів підготовки групи пошуку підготовки групових пейджингу підготовки парків викликів підготовки підхоплення викликів голосового порталу підготовки ********** завершено файл : введення/клієнт.json **************** 

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

Вихід

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

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

Малюнок 8: Хаб партнера

Малюнок 9: Центр керування

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

Малюнок 11: Дзвінки

Для BroadCloud

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

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

Наведені нижче цифри показують портал постачальника послуг.

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

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

Для Cisco BroadWorks і Webex для BroadWorks

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

У разі успішної роботи інструмент переміщення пристрою буде:

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

SCP і SSH

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

Обов’язкові умови

1. Установіть ТОКЕН ОНОВЛЕННЯ_(ТОКЕН, скопійований із інструменту створення токенів) у файлі conf/partner.cfg:

   ОНОВИТИ_ТОКЕН=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   Broadworks_користувач_ID = адміністратор BROADWORKS_Пароль = адміністратор BROADWORKS_організатор_ІМ’Я = localhost 

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

   Якщо адміністратори хочуть надсилати електронні запрошення своїм користувачам під час міграції, вони повинні скасувати коментар до властивості «RESSEND_INVITATION_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, адміністратор партнера повинен створити новий файл типу профілю ідентифікації/пристрою на рівні системи в 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 завантажуються та process% BWMACADDRESS%.cfg, який просить телефони Polycom завантажити та process migration_%BWMACADDRESS%.cfg, який задає пристрій.prov.serverName на https://plcm.sipflash.com.
   https://plcm.sipflash.com для регіону США інші регіони мають різні URL-адреси.
5. Телефон Polycom завантажує %BWMACADDRESS%.cfg з https://plcm.sipflash.com і ним керуватиме служба викликів Webex Calling.

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

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

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

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

Для переміщення єдиного клієнта пристрою: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Для переміщення кількох клієнтів: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Крім того, інструмент переміщення пристрою підтримує міграцію окремих/конкретних телефонів із випуску 1.35.0. Скористайтеся командою нижче: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

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

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

Ім’я інструмента: Версія інструмента переміщення пристрою: 1.15.0 Запущено інструмент пристрою... Дійсні пристрої для міграції: ------------------------------------------------------------------------------------------------------------------- | Тип пристрою | Mac | Версія | Електронна пошта | ------------------------------------------------------------------------------------------------------------------- | Cisco DMS 7861 | cc98914eaad7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | ivanpetrouchtchak@gmail.com | | Cisco DMS 6821 | 5486bcae7e45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | ivanpetrouchtchak@gmail.com | | Cisco DMS 8811 | f87b e4066 | Cisco-CP-8811-3PCC/11.3.7_f87b e4066_ | ivanpetrouchtchak@inbox.lv | Виконати ------------------------------------------------------------------------------------------------------------------- міграцію всіх цих пристроїв? ([Y]ів або [N]o) так Передавання профілів пристрою для DMS Cisco MPP LC Процес відновлення пристрою розпочато Процес відновлення пристрою Успішно завершено Процес перезавантаження Розпочато Процес перезавантаження Успішно завершено Зміна профілів для бізнес-комунікатора в груповому колі міграціїGRP_engg Процес активації телефонних номерів Webex розпочато для ідентифікатора організації клієнта: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Процес активації номерів телефону Webex завершено для ідентифікатора організації клієнта: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Процес деактивації телефонних номерів Broadworks розпочато для ідентифікатора групи : collabmigrationtestGRP_engg Процес деактивації телефонних номерів Broadworks завершено для ідентифікатора групи: collabmigrationtest_engg Міграцію пристрою GRP завершено 

Вихід

Після міграції пристрою пристрої підключилися до мережі та готові здійснювати/приймати виклики. Приклад стану пристрою див. на рисунку 15:

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

Після міграції пристрою активні номери. Приклад активних номерів див. на рисунку 16:

Малюнок 16: Активні номери

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

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

Процес повернення для партнерів BroadCloud такий:

1. Відкрийте квиток у Cisco TAC, щоб надіслати запит щодо повернення пристрою.
2. Запустіть інструмент переміщення пристрою в режимі повернення:
   • У Webex Calling буде скасовано призначення номерів телефонів, що залишиться користувачам і службам лише з розширеннями.
   • Адреси електронної пошти у Webex Calling буде повернуто до тимчасових адрес електронної пошти.
   • Телефони буде видалено з Webex Calling.
   • Номери телефонів, адреси електронної пошти, які використовуються як альтернативні ідентифікатори, і телефони буде відтворено в BroadCloud.
   • Телефони буде перезавантажено.
3. Адміністратори партнерів повинні перемістити телефонні номери ТМЗК назад до оператора BroadCloud.

Для Cisco BroadWorks і Webex для BroadWorks

Процес повернення для Cisco BroadWorks і Webex для BroadWorks такий:

1. Відкрийте квиток у Cisco TAC, щоб надіслати запит щодо повернення пристрою.
2. Запустіть інструмент переміщення пристрою в режимі повернення на додатковому сервері програм BroadWorks, щоб повернути міграцію пристроїв. Після цього URL-адресу DMS буде повернуто до URL-адреси постачальника послуг для профілів пристроїв у Cisco BroadWorks і повторно активують номери телефонів.
3. Команда Webex Calling повертає URL-адресу DMS постачальника послуг у профілях пристроїв у Webex Calling.
4. Адміністратори партнерів повинні деактивувати або видалити номери телефонів у Webex Calling через портал Control Hub.
5. Адміністратори партнерів повинні перемістити телефонні номери ТМЗК назад до Cisco BroadWorks.

Інструкції щодо запуску інструмента переміщення пристрою в режимі повернення

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

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

Повернути профілі

./devicemove.sh -input=  -revertProfiles

Повернути номери

./devicemove.sh -input=  -revertNumbers

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

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

Повернути профілі

Ім’я інструмента: Версія інструмента переміщення пристрою: 1.15.0 Запущено інструмент пристрою для повернення процесу... Пристрої, які можна перемістити назад із Webex Calling до BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Тип пристрою | Mac | Версія | Електронна пошта | ------------------------------------------------------------------------------------------------------------------- | Cisco DMS 7861 | cc98914eaad7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | ivanpetrouchtchak@gmail.com | | Cisco DMS 6821 | 5486bcae7e45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | ivanpetrouchtchak@gmail.com | | Cisco DMS 8811 | f87b e4066 | Cisco-CP-8811-3PCC/11.3.7_f87b e4066_ | ivanpetrouchtchak@inbox.lv | Перемістити ------------------------------------------------------------------------------------------------------------------- ці пристрої з Webex Calling до BroadWorks? (Так, Y, Ні, N):  так Передавання профілів пристрою для DMS Cisco MPP LC Процес відновлення пристрою розпочато Процес відновлення пристрою Успішно завершено Процес перезавантаження Розпочато Процес перезавантаження Успішно завершено Міграцію пристрою завершено для процесу депідготовки 

Повернути номери

Ім’я інструмента: Версія інструмента переміщення пристрою: 1.15.0 Продовжити повернення номерів до Broadworks?  ([Y] або [N] o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] collabmigrationtestGRP_engg Процес активації телефонних номерів Broadworks завершено для ідентифікатора групи: collabmigrationtest_engg Процес повернення міграції пристрою GRP успішно завершено