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

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

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

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

Установіть Java 8, 11, 17 або 21 на комп’ютер. Java доступна з багатьох джерел, зокрема:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

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

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

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

Windows.

token_generator.bat

MacOS:

./token_generator.sh

Вивід:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

Відкрийте URL-адресу у веббраузері на терміналі, увійдіть у облікові дані адміністратора партнера, щоб отримати МАРКЕР, і скопіюйте його для подальшого використання.

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

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

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

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

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

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

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

Крок 1: Для налаштування загальних параметрів використовуйте CLI.

Запустіть таку команду в CLI, щоб змінити каталог GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Запустіть таку команду в CLI, щоб отримати поточні 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
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

Інструмент витягу інтегровано на порталі постачальника послуг 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:
                          - 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.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

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

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

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

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

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Додатково встановіть ідентифікатор ПІДГОТОВКИ_(скопійований із шаблону в Партнерському центрі) у файлі 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
10. Функція синхронізації мережевого сервера дозволяє адміністраторам надавати номери телефонів, MAC-адреси та адреси електронної пошти користувачів під час підготовки в межах міграції того самого регіону. Щоб увімкнути його, задайте USE_NS_SYNC=yes в conf/partner.cfg.

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

Заповнення вхідних даних/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
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

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

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

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

Інструмент перетворення здійснює виклики API до Webex з метою виявлення потенційних проблем із підготовкою. За замовчуванням буде перевірено адресу й основну адресу електронної пошти клієнта. Якщо значення ідентифікатора ПІДГОТОВКИ_вказано у файлі 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/<timestamp>/exception_report.txt . Ви можете використовувати цей звіт, щоб визначити проблеми, які вплинуть на міграцію, і виправити їх у системі Cisco BroadWorks.

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

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

Вихід

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

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

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

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

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

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

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

4. Використовуйте властивість теми WEBEX4BWKS_EMAIL_SUBJECT для міграції Webex для BroadWorks, щоб надіслати електронну тему запиту на зміну пароля для Webex для абонентів BroadWorks.
5. Використовуйте властивість BODY ЕЛЕКТРОННОЇ ПОШТИ WEBEX4BWKS_EMAIL_для міграції Webex для BroadWorks, щоб надіслати текст електронного листа запиту на зміну пароля для Webex для абонентів BroadWorks.
6. Функція синхронізації мережевого сервера дозволяє адміністраторам надавати номери телефонів, MAC-адреси та адреси електронної пошти користувачів під час підготовки в межах міграції того самого регіону. Щоб увімкнути його, задайте USE_NS_SYNC=yes в conf/partner.cfg.

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

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

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

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

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

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

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

Windows

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

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

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

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

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

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

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

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

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

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

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

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

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

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

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

Вихід

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

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

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

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

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

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

Для BroadCloud

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

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

Функція синхронізації мережевого сервера дозволяє адміністраторам деактивувати розташування broadCloud і активувати розташування Webex Calling, установивши його USE_NS_SYNC=yes в conf/partner.cfg. Після міграції пристрої та номери телефонів активовано в розташуванні Webex Calling.

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

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

Малюнок 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:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = 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 всередині каталогу інструментів переміщення пристрою:

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

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

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

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

Вихід

Після міграції пристрою пристрої підключилися до мережі та готові здійснювати/приймати виклики. Приклад стану пристрою див. на рисунку 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

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

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

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

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