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

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

Администраторы партнеров запускают этот служебный инструмент генератора токенов по крайней мере один раз перед началом запуска инструментов миграции. Запуск этого инструмента — это единоразовое действие после того, как учетная запись партнера будет подключена к решению Wholesale RTM. Этот инструмент позволяет администраторам партнеров входить в систему через веб-браузер, чтобы получить уникальный ТОКЕН, необходимый для обновления файлов конфигурации партнеров для инструментов миграции.

Предварительные условия

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

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

После загрузки извлеките двоичные файлы инструмента миграции.

Инструкции по запуску

Выполните следующую команду в терминале внутри каталога генератора токенов:

Windows.

token_generator.bat

MacOS:

./token_generator.sh

Выход:

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

Откройте URL-адрес в веб-браузере на терминале, войдите в систему, используя учетные данные администратора партнера, чтобы получить ТОКЕН и скопировать его для дальнейшего использования.

Ниже для справки приведены иллюстрации пользовательского интерфейса:

Рисунок 3. Войти с помощью Cisco Webex

Рисунок 4. Окно учетных данных

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

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

Включить подключение OCI-P

Инструмент перемещения устройств взаимодействует с BroadWorks посредством команд OCI-P. Чтобы включить подключение OCI-P, выполните следующие действия:

Шаг 1: Используйте CLI для настройки общих параметров.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Чтобы получить текущие общие настройки, выполните следующую команду в CLI:

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

Если ваши настройки не соответствуют приведенным выше, используйте команду set, чтобы перенастроить ваши настройки.

Шаг 2: Используйте CLI для настройки OCI Proxy.

Измените каталог на OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Запустите следующий CLI, чтобы получить текущие настройки. Вы должны увидеть следующее:

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

Если ваши настройки не соответствуют приведенным выше, используйте команду set, чтобы перенастроить ваши настройки.

Шаг 3: Используйте CLI для настройки OCI Provisioning.

Перейдите в каталог Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Чтобы получить текущие настройки OCI Provisioning, выполните следующую команду:

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

Шаг 4: Выполните команду ниже в CLI, чтобы проверить правильность конфигурации.

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

Убедитесь, что открытый клиентский сервер развернут и активен

Используйте команды ниже для развертывания и запуска Open Client Server на вторичном сервере приложений, если он еще не развернут или не запущен.

Шаг 1: Разверните сервер с помощью следующей команды CLI:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Шаг 2: Запустите сервер с помощью этой команды:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Включить активацию номеров

Чтобы включить активацию номеров, выполните следующие команды в CLI:

Шаг 1: Выполните команду активации номера:

AS_CLI> cd SubscriberMgmt/NumberActivation

Шаг 2: Запустите команду активации:

AS_CLI> set dnMode groupAndUserActivationEnabled

Шаг 3: В ответ на запрос подтверждения введите Y.

Для BroadCloud

Инструмент извлечения интегрирован в портал поставщика услуг BroadCloud. Администратор поставщика услуг может:

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

На следующих рисунках показан портал поставщика услуг.

Рисунок 6. Портал поставщика услуг

Рисунок 7. Портал поставщика услуг

Запрос на извлечение CSV-файла

Инициировать запрос на извлечение CSV

1. Загрузить CSV-файл клиента

   Нажмите ссылку Загрузить CSV-файл клиента в правом верхнем углу раздела Инициировать запрос на извлечение CSV-файла.

2. Редактировать список клиентов

   Администратор может редактировать этот CSV-файл, чтобы включить в него только тех клиентов, для которых необходимо выполнить извлечение.

3. Загрузить и отправить

   После редактирования загрузите измененный CSV-файл.

   Нажмите Отправить, чтобы инициировать запрос на извлечение данных по перечисленным клиентам и их местоположениям.

Инициировать запрос на извлечение для клиента с CSV-файлом местоположений

1. Выберите клиента и место загрузки

   Выберите клиента из выпадающего списка.

   Загрузите соответствующий locations.csv из View Customers→ Sites tab → Export Locations as CSV.

2. Редактировать файл местоположений

   Администратор может редактировать CSV-файл, включив в него только те местоположения, которые он хочет извлечь.

3. Загрузить и отправить

   Загрузите отредактированный файл locations.csv и нажмите Отправить.

   В запрос на выписку будут включены только указанные местоположения выбранного клиента.

Инициировать запрос на выписку для всех клиентов

1. Нажмите Отправить, чтобы инициировать запрос на извлечение данных для всех клиентов и всех их местоположений у текущего поставщика услуг.

Для Cisco BroadWorks и Webex для BroadWorks

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

В следующих разделах объясняется, как установить и настроить инструмент извлечения.

Предварительные условия

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

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   Свойство REFRESH_TOKEN является обязательным для миграции Webex на BroadWorks.

5. Изменить JDK/JRE путь к среде в файле export.sh, если вторичный сервер приложений Cisco BroadWorks JDK/JRE Путь к среде отличается от пути к файлу:

   JAVA_HOME=/usr/local/java/java_base

Инструкции по запуску

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

./export.sh

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

При успешном экспорте в терминале доступны следующие логи: Запуск инструмента экспорта данных BroadSoft:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

Результат

Выходной ZIP-файл (extracted_data_<timestamp>.zip) доступен в том же каталоге инструмента извлечения. Используйте следующую команду для просмотра и использования ZIP-файла для ввода инструмента преобразования:

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

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

Предварительные условия

После загрузки и извлечения двоичных файлов инструментов миграции настройте следующие предварительные условия:

1. Установите REFRESH_TOKEN (токен, скопированный из инструмента Token Generator) и NAME_OF_MAIN_LOCATION в conf/partner.cfg файл:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. При желании можно установить идентификатор PROVISIONING_(скопированный из шаблона в Partner Hub) в conf/partner.cfg файл:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Для более полной проверки адреса электронной почты клиента вы можете дополнительно установить идентификатор PROVISIONING_.
3. Настройте недостающую информацию в input/customers.csv файл (см. следующий раздел), если он отсутствует.
4. Добавьте адрес электронной почты конечного пользователя в input/users.csv файл.
5. Если необходимо настроить новые телефоны, добавьте MAC-адрес и адрес электронной почты нового телефона пользователя. input/newphones.csv файл. Это необходимо только в том случае, если администраторы партнеров хотят предоставить новые телефоны для оптовых звонков.
6. Преобразуйте колл-центры BroadWorks в CxEssentials с помощью input/cxessentials.csv файл.
7. При желании можно включить свойство ОБНОВИТЬ_ВСЕ_КОЛОНКИ_ЦЕНТРЫ_ДО_CX_ESSENTIALS, чтобы преобразовать все колл-центры в CxEssentials.
8. Используйте input/locations.csv файл для поддержки миграции крупных предприятий, который позволяет администраторам переносить местоположения своих клиентов по местоположению
9. При желании можно включить использование MAC-адресов из заголовка User-Agent сообщения SIP REGISTER, если MAC-адрес недоступен в профиле устройства Cisco BroadWorks. Раскомментируйте строку «ИСПОЛЬЗОВАТЬ_MAC_АДРЕС_ИЗ_SIP_» REGISTER=yes" в файле conf/partner.cfg
10. Функция синхронизации сетевого сервера позволяет администраторам предоставлять номера телефонов, MAC-адреса и адреса электронной почты пользователей во время предоставления в том же регионе миграции. Чтобы включить его, установите USE_NS_SYNC=yes в conf/partner.cfg.

    Если синхронизация NS отключена, инициализация номера телефона и устройства будет пропущена, а пользователи получат временные адреса электронной почты.

11. При желании можно включить свойства АНАЛОГОВЫЙ_ПОЛЬЗОВАТЕЛЬ_ТИП_ВКЛЮЧИТЬ [_ВЫЗОВ_ОЖИДАНИЕ, АНАЛОГОВЫЙ_ПОЛЬЗОВАТЕЛЬ_ТИП_ВКЛЮЧИТЬ_МУЗЫКУ_НА_УДЕРЖАНИИ и АНАЛОГОВЫЙ_ПОЛЬЗОВАТЕЛЬ_ТИП_ОТКЛЮЧИТЬ_T38, чтобы настроить ожидание вызова, музыку на удержании и отключить параметры T38 для всех пользователей аналогового типа.

Заполнение input/customers.csv

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

В таблице ниже поясняются наиболее важные столбцы в input/customers.csv.

Заполнение input/users.csv

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

Инструкции по запуску

Запустите Transform Tool в любой операционной системе. Для запуска инструмента в Windows и macOS выполните следующие действия:

Windows

Чтобы запустить инструмент преобразования в Windows, выполните следующую команду:

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

MacOS

Чтобы запустить инструмент преобразования на macOS, выполните следующие действия:

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

   python3 -m venv venv
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. Запустите инструмент преобразования:

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

Customer/user предварительная проверка

Инструмент преобразования выполняет вызовы API к Webex для выявления потенциальных проблем с подготовкой. По умолчанию проверяются адрес и основной адрес электронной почты клиента. Если значение идентификатора PROVISIONING_указано в conf/partner.cfg файл, он также проверит информацию о местоположении. Результаты предварительной проверки включаются в отчет об исключении.

Кроме того, при запуске инструмента преобразования можно добавить следующие необязательные параметры:

предварительная проверка

Помимо запуска API предварительной проверки информации о клиентах, инструмент Transform Tool также запустит 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_и токен REFRESH_(токен, скопированный из инструмента генератора токенов). Администраторы партнеров должны связаться со своей командой по работе с клиентами, чтобы получить идентификатор PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Установите для параметра ALLOW_ADMIN_INVITE_EMAILS значение false, если партнер не хочет отправлять пользователям приветственные письма. Значение по умолчанию — true.

4. Используйте свойство WEBEX4BWKS_EMAIL_SUBJECT для миграции Webex для BroadWorks, чтобы отправить тему электронного письма с запросом на смену пароля для подписчиков Webex для BroadWorks.
5. Используйте свойство WEBEX4BWKS_EMAIL_BODY для миграции 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 Onboarding для поддержки миграции попросите группу по работе с клиентами Cisco включить функцию «wholesale-partner-blending-enabled» на уровне партнера. Это позволит добавлять оптовые пакеты в существующие организации клиентов Webex для BroadWorks во время подготовки.

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

Подготовительный этап: — это этап по умолчанию, на котором администраторы могут предоставить пользователям BroadWorks услуги в качестве оптовых подписчиков и продолжить работу с Webex для пользователей BroadWorks.

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

Фаза после миграции: Это заключительный этап, на котором администраторы могут полностью преобразовать BroadWorks в оптовую версию. Необходимо запустить инструмент подготовки с аргументом postmigration.

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

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

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

Будет напечатана таблица с количеством локаций, созданных для каждого запуска:

Результат

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

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

Рисунок 8. Партнерский центр

Рисунок 9. Control Hub

Рисунок 10. Устройства

Рисунок 11. Вызов

Для BroadCloud

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

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

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

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

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

• Миграция — выберите этот параметр, чтобы инициировать запрос на миграцию номеров, устройств и общих вызовов (SCA).
• Состояние устройства — выберите этот параметр, чтобы просмотреть текущее состояние устройства в BroadCloud и Calling.

На следующих рисунках показан портал поставщика услуг.

Рисунок 12. Портал поставщика услуг

Рисунок 13. Портал поставщика услуг

Перенести выбранные местоположения (необязательно)

Чтобы начать миграцию для определенного подмножества местоположений, перечисленных в файле customer.json, включите файл locations.csv в свой запрос. В этом CSV-файле должны быть указаны только те местоположения, которые вы собираетесь перенести.

Чтобы загрузить список доступных активных сайтов, перейдите в Просмотр клиентов → Выбрать клиента → Экспорт местоположений в формате CSV.

Рисунок 14. Экспорт местоположений в формате CSV

Для Cisco BroadWorks и Webex для BroadWorks

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

При успешной работе инструмент перемещения устройства выполнит следующие действия:

1. Отмените регистрацию устройств в Cisco BroadWorks и зарегистрируйте их в оптовой торговле.
2. Пользователи, использующие клиент UC-One, будут перенаправлены в приложение Webex при первом входе в систему.
3. Деактивируйте номера телефонов из Cisco BroadWorks или удалите номера телефонов из BroadCloud.
4. Активируйте номера в Оптовой продаже.
5. Создавайте общие вызовы в Wholesale для миграции BroadCloud. [This шаг применим только для BroadCloud migrations].

SCP и SSH

1. SCP — инструмент перемещения устройства на вторичный сервер приложений Cisco BroadWorks.
2. Подключитесь по SSH к вторичному серверу приложений Cisco BroadWorks, чтобы настроить предварительные условия и запустить инструмент перемещения устройств.

Предварительные условия

1. Установите REFRESH_TOKEN (токен, скопированный из инструмента Token Generator Tool) в conf/partner.cfg файл:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Для повторной отправки писем активации вам необходимо установить RESEND_INVITATION_EMAILS=true в conf/partner.cfg файл.

   Если администраторы хотят отправлять своим пользователям электронные письма с приглашениями во время миграции, им следует раскомментировать «RESEND_INVITATION_EMAILS=true" недвижимость в conf/partner.cfg файл. В противном случае имущество должно остаться неизменным.

4. Проверьте JDK/JRE Путь к среде указан правильно в devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

телефоны Поликом

Чтобы перенести телефоны Polycom из Cisco BroadWorks в Wholesale Calling, администратор партнера должен создать новую Identity/Device Файл типа профиля на системном уровне в Cisco BroadWorks для каждого шаблона устройства Polycom. Обратитесь к рисунку 14 и загрузите пользовательский файл device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. После загрузки нового файла устройства убедитесь, что вновь созданный файл существует на уровне группы. Также убедитесь, что файл migration_%BWMAC ADDRESS%.cfg не конфликтует ни с одним существующим файлом в вашей системе).

Он используется внутри инструмента перемещения устройства.

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

1. Инструмент перемещения устройства заменяет файл %BWMACADDRESS%.cfg на уровне устройства на polycom_vvx2.cfg. Этот файл ссылается на migration_%BWMACADDRESS%.cfg.
2. Перестройте профили устройств на уровне группы или устройства.
   Действие на уровне группы или устройства зависит от конфигурации параметра deviceLevelRebuild в файле. device-move-tool/conf/partner.cfg.
3. Инструмент перемещения устройств запрашивает у сервера приложений Cisco BroadWorks перезагрузку телефонов на уровне группы или устройства.
4. После запроса на перезагрузку телефоны Polycom загружают и обрабатывают% BWMACADDRESS%.cfg, который просит телефоны Polycom загрузить и обработать migration_%BWMACADDRESS%.cfg, который устанавливает device.prov.serverName в https://plcm.sipflash.com.
   https://plcm.sipflash.com для региона США, для других регионов используются другие URL-адреса.
5. Телефон Polycom загружает %BWMACADDRESS%.cfg из https://plcm.sipflash.com и будет управляться Webex Calling DMS.

Рисунок 14. Identity/device добавить файл типа профиля

Инструкции по запуску

Существует два метода вызова DMT: первый — это вызов одного клиента за раз, а второй — запуск нескольких клиентов одновременно.

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

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

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

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

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

Результат

После миграции устройства перешли в режим онлайн и готовы к работе. make/receive звонки. Пример состояния устройства см. на рисунке 15:

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

После миграции устройств номера стали активными. На рисунке 16 показан пример активных номеров:

Рисунок 16. Активные номера

Операция возврата должна выполняться для одного предприятия за раз.

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

Процесс возврата для партнеров BroadCloud выглядит следующим образом:

1. Откройте заявку в Cisco TAC, чтобы запросить возврат устройства.
2. Запустите инструмент перемещения устройства в режиме возврата:
   • Номера телефонов будут отменены из Webex Calling, и у пользователей и служб останутся только добавочные номера.
   • Адреса электронной почты в Webex Calling будут возвращены к временным адресам электронной почты.
   • Телефоны будут удалены из Webex Calling.
   • Номера телефонов, адреса электронной почты, используемые в качестве альтернативных идентификаторов, и телефоны будут воссозданы в BroadCloud.
   • Телефоны будут перезагружены.
3. Администраторы партнеров должны перевести телефонные номера PSTN обратно в BroadCloud Carrier.

Для Cisco BroadWorks и Webex для BroadWorks

Процесс возврата к предыдущей версии для Cisco BroadWorks и Webex для BroadWorks выглядит следующим образом:

1. Откройте заявку в Cisco TAC, чтобы запросить возврат устройства.
2. Запустите инструмент перемещения устройств в режиме возврата на вторичном сервере приложений BroadWorks, чтобы отменить миграции устройств. Это вернет URL-адрес DMS к URL-адресу DMS поставщика услуг для профилей устройств в Cisco BroadWorks и повторно активирует номера телефонов.
3. Команда Webex Calling устанавливает URL-адрес DMS обратно на URL-адрес DMS поставщика услуг в профилях устройств в Webex Calling.
4. Администраторы партнеров должны деактивировать или удалить номера телефонов в Webex Calling через портал Control Hub.
5. Администраторы партнеров должны перенести телефонные номера PSTN обратно в Cisco BroadWorks.

Инструкции по запуску инструмента перемещения устройства в режиме возврата

Чтобы запустить инструмент перемещения устройства в режиме возврата, выполните следующие действия:

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

Откатить профили

./devicemove.sh -input=  -revertProfiles

Возврат чисел

./devicemove.sh -input=  -revertNumbers

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

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

Откатить профили

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

Возврат чисел

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully