Інструменти міграції для переходу від BroadWorks, Webex для BroadWorks і BroadCloud до рішень Wholesale RTM

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

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

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

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

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

Установіть шлях середовища 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_ ГОЛОВНА=C:\Progra~1\Java\jre1.8.0_ 321

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

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

Windows.

token_generator.bat

MacOS:

./token_generator .sh

Вивід:

Ім’я інструмента: Версія інструмента генератора токенів: 1.13.0 Завантажте URL-адресу у веббраузері: http://локальний хост:8080 

Відкрийте URL-адресу у веббраузері на терміналі, увійдіть за допомогою облікових даних адміністратора партнера, щоб отримати TOKEN, і скопіюйте її для подальшого використання.

Ілюстрації інтерфейсу користувача наведено нижче для довідки:

Рисунок 3. Увійти за допомогою Cisco Webex

Рисунок 4. Вікно облікових даних

Рисунок 5. Генерування токена

Налаштуйте такі кроки, перш ніж запускати інструменти вилучення та переміщення пристрою на додатковому сервері BroadWorks.

Увімкнути підключення OCI-P

Інструмент переміщення пристрою зв’язується з BroadWorks за допомогою команд OCI-P. Щоб увімкнути підключення OCI-P, виконайте наведені нижче дії.

Крок 1 : Використовуйте CLI, щоб налаштувати загальні параметри.

Виконайте таку команду в CLI, щоб перейти до каталогу GeneralSettings:

AS_ CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

AS_CLI/Applications/OpenClientServer/GeneralSettings> отримати clientPort = 2208 clientPortEnabled = true secureClientPort = 2209 secureClientPortEnabled = true systemDomain = <> 

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

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

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

AS_ CLI> cd /Applications/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> отримати ввімкнено = true enabledLoginLevelScreening = false enableResponseCaching = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 messageQueueCapacity = 50 messageQueueTimeoutSeconds = 1800 

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

Крок 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> отримайте широкі роботи та перевірте, чи вивідні дані мають належний вигляд. Зразок виводу див. нижче: AS_ CLI/Maintenance/ManagedObjects> отримати керовані об’єкти BroadWorks BroadWorks ========================== * Сервер: Ідентифікаційні дані.................: Версія AS.................: Рel_ 21.sp1_ 1.551 Адміністративний штат..: Розблоковано * Програми: Ім’я Версія Розгорнуто адміністративний стан Дієвий стан =========================================== ============================================== ExecutionAndProvisioning 21.sp1_ 1.551 true Розблоковано Розблоковано FlashPolicy 21.sp1_ 1.551 false Розблоковано Зупинено OpenClientServer 21.sp1_ 1.551 true Розблоковано розблоковано WebContainer 21.sp1_ 1,551 true Розблоковано Розблоковано Знайдено 4 записи. * Розміщені програми: Ім’я Версія Контекст Шлях Розгорнуто ============================================= ===================== 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 записів. 

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

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

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

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

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

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

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

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

Крок 1 : Виконайте команду активації номера:

AS_ CLI> cdНалаштування абонента/Активація номера

Крок 2 : Виконайте команду активації ввімкнено:

AS_ CLI> установіть dnMode groupAndUserActivationEnabled

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

Для BroadCloud

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

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

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

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

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

Для Cisco BroadWorks і Webex для BroadWorks

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

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

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

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

   ServiceProviderID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - УСІ 

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

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

   , ОНОВИТИ_ ТОКЕН є обов’язковою для міграції Webex для BroadWorks.

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

   JAVA_ ГОЛОВНА=/usr/local/java/java_base

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

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

./export.sh

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

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

 Запуск інструмента експорту даних BroadSoft ********************************************* *** Запуск інструмента експорту версії: 1.15.0 Експорт розпочато для SP=colllabmigrationtestSP_engg , Group=colllabmigrationtestGRP_engg Експортування користувачів для SP=collabmigrationtestSP_engg , Group=colllabmigrationtestGRP_engg Експорт користувачів для SP=collabmigrationtestSP завершено_engg , Group=colllabmigrationtestGRP_engg Експорт завершено для SP=collabmigrationtestSP_engg , Group=colllabmigrationtestGRP_engg Експорт завершено. Експорт дамп-каталогу: вихід/20221017223452_ Ім’я файлу архіву ExportTool для експорту дампу:extracted_data_1666060500618.zip-файл ZIP з ім’ямextracted_data_1666060 500618.zip створено. Процес створення ZIP-файлу завершено. Експортовані файли перетворено як ZIP-файл ********************************* ****************

Вихід

Вихідний файл ZIP (extracted_data_ .zip ) буде доступний у тому самому каталозі інструмента вилучення. Використовуйте команду нижче, щоб переглянути та використати ZIP-файл для введення інструмента трансформації:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 жовт.  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 жовт.  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, 17 жовт., 22:34 вивід/ drwxrwxr-x 2 bwadmin bwadmin 4096, 17 жовт., 22:34 logs/ -rw-rw-rwad46 min 1 bwad 12:34 жовт. 35extracted_data_1666060 500618.zip

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

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

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

1. Установіть ОНОВЛЕННЯ_ TOKEN (токен скопійовано з інструмента генератора токенів) і NAME_ OF_ ГОЛОВНИЙ_ LOCATION у файлі conf/partner.cfg:

   ОНОВИТИ_ ТОКЕН=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj НАЗВА_ OF_ ГОЛОВНИЙ_ LOCATION=Основне

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

   ПІДГОТОВКА_ ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

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

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

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

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

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

ОС Windows

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

transform.bat -extract= -клієнти= -користувачів= -newphones=

macOS

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

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

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

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

    ./transform.sh -extract= -клієнти= -користувачів= -newphones=

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

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

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

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

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

інформація попередньої перевірки

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

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

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

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

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

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

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

Звіт про винятки, вт, 18 жовтня, 08:12:09, 2022 р. Рекомендації щодо підприємств із функцією заборони зв’язку: вручну налаштувати план вихідних викликів у Control Hub________________________________________________________________________________ спільнаміграціятестGRP_engg 

Вихід

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

{ "customer": { "provisioningId": "!!!!!!!!!!!REPLACE_ З_ Ідентифікатор PROVISIONING!!!!!!", "packages": [ "webex_calling ", "common_area_calling " ], "зовнішній ідентифікатор": "external_id_engg_grp 1", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", " country": "США" }, "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 ", "numbers": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109 ", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info ": { "service_provider_id ": "тест спільної міграціїSP_engg ", "group_id ": "тест спільної міграціїGRP_engg " }, "subscribers": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE"_ З_ ІНДИКАТОР КЛІЄНТА!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling ", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/ v1/people/{personId}/features/voicemail": { "ввімкнено": 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"_ З_ PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "абонент" : { "customerId": "!!!!!!!!!!!ЗАМІНА_ З_ ІНДИКАТОР КЛІЄНТА!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling ", "provisioningParameters": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [ { "/ v1/people/{personId}/features/voicemail": { "ввімкнено": 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"_ З_ ПЕРСОНІД!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "абонент" : { "customerId": "!!!!!!!!!!!ЗАМІНА_ З_ ІНДИКАТОР КЛІЄНТА!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "package": "webex_calling ", "provisioningParameters": { "firstName": "Лев", "lastName": "Джексон", "primaryPhoneNumber": "+15205551104", "extension": "1104" } }, "features": [ { "/ v1/people/{personId}/features/voicemail": { "ввімкнено": 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": { "абонент" : { "customerId": "!!!!!!!!!!!ЗАМІНА_ З_ ІНДИКАТОР КЛІЄНТА!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling ", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "features": [ { "/ v1/people/{personId}/features/voicemail": { "ввімкнено": 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"_ З_ ПЕРСОНІД!!!!!!!!!!", "продукт": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "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 ": [ "Зв’язок ПК – профіль пристрою" ], "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:
   • Установіть ОПТ_ ПІДГОТОВКА_ Ідентифікатор і ОНОВЛЕННЯ_ TOKEN (токен скопійовано з інструмента генератора токенів). Адміністратори партнерів повинні звернутися до своєї команди з облікових записів, щоб отримати ПІДГОТОВКУ_ Ідентифікатор:

     ОПТ_ ПІДГОТОВКА_ Ідентифікатор = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 ОНОВИТИ_ ТОКЕН=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

   • Установити ДОЗВОЛИТИ_ АДМІН_ ЗАПРОСИТИ_ EMAILS на false, якщо партнер не хоче надсилати користувачам електронного листа з привітанням. Значення за замовчуванням – true.

4. Використовуйте WEBEX4BWKS_ EMAIL_ Властивість ТЕМА для міграції Webex для BroadWorks, щоб надіслати тему електронного листа із запитом на зміну пароля для передплатників Webex для BroadWorks.
5. Використовуйте WEBEX4BWKS_ EMAIL_ Властивість BODY для міграцій Webex для BroadWorks, щоб надіслати текст електронного листа із запитом на зміну пароля для передплатників Webex для BroadWorks.

Для міграції BroadCloud в тому самому регіоні:

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

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

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

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

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

ОС Windows

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

Щоб підготувати одного клієнта: забезпечення.bat -input= Щоб підготувати кілька клієнтів: забезпечення.bat -input= 

macOS

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

Щоб надати єдиного клієнта: ./transform.sh -input= Щоб підготувати кілька клієнтів: ./transform.sh -input= 

Обов’язкові умови для міграції Webex для BroadWorks

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

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

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

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

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

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

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

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

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

Вихід

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

Адміністратори партнерів можуть перевірити підготовку клієнтів на порталі 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. Установіть ОНОВЛЕННЯ_ TOKEN (токен, скопійований із інструмента генератора токенів) у файлі conf/partner.cfg:

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

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

   BROADWORKS_ USER_ Ідентифікатор = адміністратор BROADWORKS_ ПАРОЛЬ = адміністратор BROADWORKS_ ХОСТ_ NAME = локальний хост

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

    JAVA_ ГОЛОВНА=/usr/local/java/java_base

4. Адміністратори можуть використовувати файл 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_vvx 2.cfg. Зауважте, що цей файл посилається наmigration_%BWMACADDRESS% .cfg.
2. Перебудуйте профілі пристрою на рівні групи або пристрою.
   Дія на рівні групи або пристрою залежить від конфігурації параметра deviceLevelRebuild у файлі device-move-tool/conf/partner.cfg.
3. Інструмент переміщення пристрою запитує сервер програм Cisco BroadWorks про перезавантаження телефонів на рівні групи або пристрою.
4. Після запиту на перезавантаження телефони Polycom завантажуються й обробляються% BWMACADDRESS% .cfg, який просить телефони Polycom завантажити й обробитиmigration_%BWMACADDRESS% .cfg, який встановлює для device.prov.serverName значенняhttps://plcm.sipflash.com.
   https://plcm.sipflash.com для регіону США, інші регіони мають інші URL-адреси.
5. Завантаження телефону Polycom%BWMACADDRESS% .cfg відhttps://plcm.sipflash.com і буде керуватися Webex Calling DMS.

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

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

Існує два способи запуску 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| Версія| Електронна пошта| -------------------------------------------------- -------------------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenalex@gmail.com| -------------------------------------------------- -------------------------------------------------- --------------- Перенести всі ці пристрої? ([Y]es або [N]no) yes Передавання профілів пристроїв для DMS Cisco MPP LC Процес відновлення пристрою розпочато. Процес відновлення пристрою завершено успішно. Процес перезавантаження розпочато. Процес перезавантаження успішно завершено._engg Розпочатий процес активації номерів телефону Webex для ідентифікатора організації клієнта: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Процес активації телефонних номерів Webex завершено для ідентифікатора організації клієнта: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Процес деактивації телефонних номерів Broadworks, розпочатий для ідентифікатора групи: спільнаміграціятестGRP_engg Процес деактивації телефонних номерів Broadworks для ідентифікатора групи завершено: спільнаміграціятестGRP_engg Міграцію пристрою завершено

Вихід

Після міграції пристрою пристрої підключені до мережі та готові здійснювати та приймати виклики. Зверніться до малюнка 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-адреси DMS постачальника послуг для профілів пристроїв у Cisco BroadWorks та повторно активує номери телефону.
3. Команда Webex Calling повертає URL-адресу DMS до URL-адреси DMS постачальника послуг у профілях пристроїв у Webex Calling.
4. Адміністратори партнерів повинні деактивувати або видалити номери телефонів у Webex Calling через портал Control Hub.
5. Адміністратори партнерів повинні перемістити телефонні номери ТМЗК назад до Cisco BroadWorks.

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

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

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

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

./devicemove.sh -input= -повернутипрофілі

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

./devicemove.sh -input= -revertNumbers

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

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

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

Ім’я інструмента: Версія інструмента переміщення пристрою: Інструмент пристрою 1.15.0 запущено для відновлення процесу... Пристрої, які можна перемістити назад із Webex Calling до BroadWorks: - -------------------------------------------------- -------------------------------------------------- ----------------| Тип пристрою| Mac| Версія| Електронна пошта| -------------------------------------------------- -------------------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenalex@gmail.com| -------------------------------------------------- -------------------------------------------------- --------------- Перемістити ці пристрої з Webex Calling до BroadWorks? (Так, Т, Ні, Н):  так Передавання профілів пристроїв для DMS Cisco MPP LC Процес відновлення пристрою розпочато. Процес відновлення пристрою завершено успішно. Процес перезавантаження розпочато. Процес перезавантаження завершено успішно. Міграцію пристрою завершено для процесу деініціалізації 

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

Ім’я інструмента: Версія інструмента переміщення пристрою: 1.15.0 Продовжити повернення номерів до Broadworks?  ([Так]так або [Ні]:  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Starting revert Activate broadworks phone numbers process started for groupId : спільнаміграціятестGRP_engg Процес активації телефонних номерів Broadworks завершено для ідентифікатора групи: спільнаміграціятестGRP_engg Процес повернення міграції пристрою успішно завершено