Благодарим вас за обратную связь.

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

В последнем столбце приведено сопоставление моделей телефонов со столбцом «Тип устройства» файла 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. Используйте интерфейс командной строки для настройки общих параметров.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

Шаг 2. Используйте интерфейс командной строки для настройки прокси-сервера OCI.

Измените каталог на прокси-сервер OCI:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

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

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

Шаг 3. Используйте интерфейс командной строки для настройки 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. Выполните приведенную ниже команду в интерфейсе командной строки, чтобы убедиться в правильности конфигурации.

 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

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

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

Шаг 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 на вкладке Просмотр клиентов → Сайты → Экспорт местоположений в формате CSV.

2. Отредактируйте файл местоположений

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

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

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

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

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

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

Для Cisco BroadWorks и Webex для BroadWorks

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

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

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

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

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

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

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

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

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

   JAVA_HOME=/usr/local/java/java_base

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

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

./export.sh

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

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

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

Вывод

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

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

Если администратор управляет инструментом на корпоративном прокси-сервере, выполните следующие действия для настройки и выполнения сценария экспорта.

Шаги по настройке и выполнению сценария экспорта

1. Откройте файл export.sh.
2. Найдите переменную HTTPS_PROXY_HOST и раскомментируйте ее (удалите начальный символ #).

3. Задайте значение HTTPS_PROXY_HOST следующим образом:

   HTTPS_PROXY_HOST=<proxy-host>

4. Найдите переменную HTTPS_PROXY_PORT и раскомментируйте ее (удалите начальный символ #).
5. Задайте значение HTTPS_PROXY_PORT следующим образом:

   HTTPS_PROXY_PORT=<proxy-port>

6. Сохраните и закройте файл export.sh.
7. Откройте файл partner.cfg и добавьте необходимый refresh_token.
8. Убедитесь, что хост, имя пользователя и пароль BroadWorks правильно настроены в partner.cfg.
9. Запустите скрипт:

   ./export.sh

Форма помолвки:

Инструмент извлечения (BroadCloud и BroadWorks) теперь автоматически генерирует консолидированный файл XLSX под названием «Форма взаимодействия SUA.xlsx» во время выполнения. Файл предварительно заполнен всеми доступными данными из соответствующих рабочих листов, что помогает упростить и ускорить процесс привлечения партнеров.

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

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

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

1. Задайте значения REFRESH_TOKEN (токен, скопированный из инструмента генерации токенов) и NAME_OF_MAIN_LOCATION в файле conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Дополнительно задайте PROVISIONING_ID (скопированный из шаблона в Центре партнеров) в файле conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Для более полной проверки адреса электронной почты клиента вы можете дополнительно установить PROVISIONING_ID.
3. Настройте недостающую информацию в файле input/customers.csv (см. следующий раздел) , если она отсутствует.
4. Добавьте адрес электронной почты конечного пользователя в файл input/users.csv.
5. Если необходимо предоставить новые телефоны, добавьте mac-адрес и адрес электронной почты нового телефона пользователя в файл input/newphones.csv. Это необходимо только в том случае, если администраторы партнеров хотят предоставить новые телефоны в режиме оптовых звонков.
6. Преобразуйте колл-центры BroadWorks в CXEssentials с помощью файла input/cxessentials.csv.
7. При желании включите свойство UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, чтобы преобразовать все центры обработки вызовов в CXEssentials.
8. Используйте файл input/locations.csv для поддержки миграции крупных предприятий, которая позволяет администраторам перемещать офисы своих клиентов по местоположению
9. При желании включите использование MAC-адресов из заголовка User-Agent сообщения SIP REGISTER, если MAC-адрес недоступен в профиле устройства Cisco BroadWorks. Раскомментируйте строку use_mac_address_from_sip_register=yes в файле conf/partner.cfg
10. Дополнительно включите свойства ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD и ANALOG_USER_TYPE_DISABLE_T38, чтобы настроить ожидание вызова, музыку в режиме ожидания и отключение настроек T38 для всех пользователей аналогового типа.

11. Если вы хотите настроить стандартные шлюзовые устройства, добавьте MAC-адрес и идентификатор пользователя устройства в файл input/genericgateways.csv. Кроме того, укажите, является ли пользователь ОСНОВНЫМ владельцем или пользователем SHARED (для совместных звонков). Это необходимо только в том случае, если администраторы-партнеры планируют использовать стандартные шлюзовые устройства при оптовых звонках.

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

12. При миграции в BroadCloud для преобразования всех пользователей с типом станции обмена сообщениями в voice_mail_group обновите файл conf/rialto_station_type_to_wholesale_package.csv, заменив значение Wholesale Package на voice_mail_group в строке, где используется тип станции Rialto для обмена сообщениями.

    При желании включите свойство COMMON_VOICE_MAIL_GROUP_PASSCODE в partner.cfg, чтобы настроить PIN-код по умолчанию для групп голосовой почты.

    Если это свойство не указано в partner.cfg, его необходимо указать каждому клиенту в файле customers.csv в столбце CommonVoiceMailGroupPassCode.

13. Для переноса общих контактов в Webex Calling

    Это усовершенствование управления общими контактами на уровне предприятия и на уровне сайта. Теперь эти контакты можно перенести как контакты организации (Org Contacts) или как виртуальные расширения в зависимости от настроек конфигурации. Ниже приведены подробные сведения, которые помогут вам в этом процессе миграции.

    Ключевая конфигурация:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      В файле partner.cfg появилось новое свойство COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE. Это свойство определяет способ переноса обычных контактов из Rialto в. Webex Calling

    • Без настройки COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Общие контакты будут перенесены как контакты организации (контакты организации).

      Дополнительная настройка не требуется.

      Контакты остаются доступными на уровне организации.

    • После настройки COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Общие контакты будут перенесены в виде виртуальных расширений.

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

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

14. Разрешите поставщику записи звонков по умолчанию использовать Webex.

    Этот шаг необходим только при переносе настроек записи разговоров для пользователей, настроенных с помощью Dubber, в Cisco Native Call Recording в Webex.

    Чтобы включить эту опцию, выполните следующие действия:

    • В файле partner.cfg задайте следующее свойство default_call_recording_vendor=Webex.
    • Кроме того, используйте свойство WEBEX_CALL_RECORDING_STORAGE_REGION для настройки региона хранения.

      Опция записи по запросу от BroadCloud не поддерживается в. Webex Calling Эти настройки записи разговоров не будут перенесены и появятся в отчете об исключениях.

15. Исключение выбранных телефонных номеров из миграции:

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

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

      . /transform.sh — extract=input/extracted_data_1747640608219.zip — номера выведенных из эксплуатации = {filepath/telephone_numbers_inventory.csv}

16. При необходимости установите для свойства ALLOW_RESTRICT_BY_PARTNER_MODE значение OFF, чтобы администраторы клиентов могли изменять заданные партнером настройки в Control Hub.
17. Для переноса мобильных номеров (BroadWorks Mobility) из BroadCloud в Webex Calling

    В этом разделе описывается перенос функции BroadWorks Mobility (мобильные номера клиентов) из BroadCloud (интеграция мобильных сетей) в оптовую торговлю Webex Calling (оператор мобильной сети Webex Go).

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

    В файл partner.cfg добавлено новое свойство ASSIGN_MOBILE_NUMBERS_TO_USERS. Включите это свойство, чтобы разрешить присвоение и перенос мобильных номеров пользователям.

    • Эта функция поддерживается только при миграции из Broadcloud в оптовую торговлю.
    • В Wholesale Webex конечные пользователи могут иметь номер мобильного телефона или номер PSTN (не оба), в отличие от BroadCloud.
    • Когда пользователю присваивается номер мобильного телефона, его основной номер PSTN становится дополнительным (альтернативным) номером.
    • Перенос мобильных номеров для пользователей, преобразуемых в рабочие пространства или виртуальные линии, невозможен.
    • После назначения мобильного номера в оптовом приложении Webex он будет отображаться как активный в Control Hub. Этот статус не означает, что номер сразу готов к приему звонков. Возможность звонков будет доступна только после полного завершения миграции.
    • Настройки интеграции мобильных телефонов, настроенные конечными пользователями на портале для звонящих пользователей (CUP), не переносятся. После миграции при звонке на телефонный номер, мобильный номер или добавочный номер будут звонить все устройства пользователя.

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

    Ограничения количества пакетов в настоящее время не поддерживаются при миграции Webex для BroadWorks на Wholesale.

    При запуске инструмента преобразования укажите обновленный файл в качестве входного параметра:. <extract_zip_file>/transform.sh -extract= -packagelimits=input/package_quantity.csv .

19. Перенесите сайты нескольких клиентов из BroadWorks/Broadcloud в одного покупателя оптом Webex Calling
    • В инструменте Transform представлен новый режим работы — ConsolidatedMigration — для поддержки переноса сайтов нескольких клиентов из Broadcloud/Broadworks на оптовую платформу Webex в рамках единой организации оптовых клиентов. Когда этот режим включен, инструмент объединяет несколько сайтов клиентов в одну организацию оптовых клиентов

      -consolidatedMigration

    • Вместе с параметром -ConsolidatedMigration можно указать и другие дополнительные аргументы, такие как

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

    • Если задано значение -TargetEnterpriseId и идентификатор существует в выходном файле инструмента Extract, то оно будет использовано для создания организации оптовых клиентов, а если идентификатор не будет найден, инструмент вернется к использованию всех доступных сведений о клиенте из выходного файла инструмента Extract.
    • Если задан параметр -ConsolidatedExternalID, он задаст внешний идентификатор для клиента, а если он не будет указан, инструмент вернется к использованию существующего потока в качестве внешнего идентификатора.
    • <timestamp>Консолидированный файл JSON (customer.json) будет доступен в каталоге output/ /consolidate.

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

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

В приведенной ниже таблице описаны наиболее важные столбцы в файле input/customers.csv.

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

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

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

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

Windows

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

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

macOS

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

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

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

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

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

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

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

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

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

Помимо запуска API предварительной проверки информации о клиентах, инструмент Transform также запустит API предварительной проверки электронных писем подписчиков.

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

По умолчанию в отчет об исключениях включаются только ошибки предварительной проверки (то есть проблемы, которые могут заблокировать выделение ресурсов). Добавление этого флага также будет включать успешные результаты предварительной проверки (например, если организация Webex уже существует, которую можно автоматически присоединить).

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

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

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Отчет об исключениях

Инструмент преобразования генерирует отчет об исключениях в каталоге output/ /exception_report.txt<timestamp>. Этот отчет можно использовать для выявления проблем, которые могут повлиять на миграцию, и их устранения в системе Cisco BroadWorks.

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

Exception Report
Tue Oct 18 08:12:09 2022

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

Выходные данные

<timestamp><groupid>Выходной файл JSON (customer.json) будет доступен в каталоге output//. Пример файла 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 и REFRESH_TOKEN (токен, скопированный из инструмента генерации токенов). Администраторы партнеров должны связаться со своей командой по работе с клиентами, чтобы получить PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Если партнеры не хотят отправлять пользователям приветственное письмо, задайте для SEND_SUBSCRIBERS_WELCOME_EMAIL значение false. По умолчанию установлено значение true.

     Webex отправляет приветственные письма только конечным пользователям. Администраторы клиентов не получают приветственных писем.

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

4. Используйте свойство WEBEX4BWKS_EMAIL_SUBJECT для миграции Webex для BroadWorks, чтобы отправить тему письма с запросом на смену пароля для подписчиков Webex для подписчиков BroadWorks.
5. Используйте свойство WEBEX4BWKS_EMAIL_BODY для миграции Webex для BroadWorks, чтобы отправить текст письма с запросом на смену пароля для подписчиков Webex для подписчиков BroadWorks.
6. Используйте свойство CUSTOM_TAGS для добавления тегов после создания клиента.
7. Чтобы воспользоваться оптовыми скидками, администраторы-партнеры должны связаться с отделом по работе с клиентами Cisco перед началом миграции.

   В файл partner.cfg добавлено новое свойство APPLY_WHOLESALE_DISCOUNTS. Включите это свойство, чтобы предоставлять скидки пользователям и рабочим пространствам.

8. (Необязательно) Явно настройте соединение PSTN

   Чтобы указать подключение к PSTN для всех местоположений, предоставленных во время миграции, включая основное местоположение, добавьте следующее свойство в файл partner.cfg:

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

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

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

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

Windows

Выполните следующие шаги , чтобы запустить инструмент в ОС Windows:

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

macOS

Выполните следующие шаги, чтобы запустить инструмент в macOS:

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

Предварительные условия для миграции Webex для BroadWorks

Администраторы-партнеры должны обновить свой шаблон адаптации BroadWorks для Webex для функций совместной работы BroadWorks. См. следующее изображение:

Как только шаблон Webex для BroadWorks Onboarding будет обновлен для поддержки миграции, попросите отдел по работе с клиентами Cisco включить функцию «Объединение оптовых партнеров включено» на уровне партнера. Эта настройка позволяет инструменту Provisioning автоматически добавлять оптовые пакеты существующим клиентам Webex for BroadWorks во время подготовки.

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

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

Этап обслуживания: второй этап, на котором администраторы могут назначить оптовую лицензию существующей версии Webex для пользователей BroadWorks. Инструмент подготовки должен быть запущен с аргументом «Сопровождение».

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

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

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

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

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

Выходные данные

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

Система создаст файл Provisioning_report_*.csv в каталоге output/consolidated_reports/. Этот файл содержит сведения об успехах и неудачах каждого объекта и его настроек, а также содержит исчерпывающий отчет об обеспечении.

Инструмент подготовки также создает файл Provisioning_Statistics_*.csv в каталоге output/consolidated_reports/. В этом отчете содержится количество успешно и неудачно подготовленных клиентов, местоположений, пользователей, устройств и групповых функций.

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

Рисунок 8: Центр партнеров

Рисунок 9: Центр управления

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

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

Ограничения после выделения ресурсов

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

• Портал CAP — добавление пользователей или портированных устройств.
• Портал SP — создание заказов ADD с использованием устройств или номеров.
• RSB API — создание заказов ADD с устройствами или номерами и создание пользователей. Заказы RSB ADD, сделанные с использованием устройств или номеров, будут отклонены.

Миграция BroadCloud на оптовую торговлю — ограничение регистрации устройств

Администраторы-партнеры, переносящие клиентов из BroadCloud в Wholesale в том же регионе, могут добавить устройства в Wholesale после запуска инструмента подготовки. Однако эти устройства смогут зарегистрироваться на платформе Webex только после завершения миграции (перемещения устройства) в соответствующее местоположение.

Это ограничение не распространяется на:

• Клиенты, переходящие с Broadworks/W4B на оптовую торговлю.
• Миграция BroadCloud в оптовую торговлю из разных регионов.

Рекомендуемое руководство

Чтобы избежать проблем с регистрацией устройств, выполните миграцию устройств на уровне местоположения, прежде чем пытаться зарегистрировать устройства на платформе Webex для миграции BroadCloud на Wholesale в тот же регион.

Для BroadCloud

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

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

Администраторы могут включить автоматический откат, установив параметр 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

Включите опцию разъединить номера

Если вы используете одну Webex Calling и ту же магистраль SIP для BroadCloud Carrier, администраторам следует использовать опцию «Отключить номера». Это избавит телефонные номера от приема входящих звонков после миграции в BroadCloud.

Чтобы включить эту опцию,

1. В файле partner.cfg задайте значение DISCONNECT_NUMBERS_FROM_RIALTO = да.
2. Перезапустите средство миграции, используя тот же файл customer.json и обновленный файл partner.cfg.

Если номера не удается разъединить, подайте запрос Cisco TAC.

Для Cisco BroadWorks и Webex для BroadWorks

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

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

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

6. Если администратор использует инструмент на корпоративном прокси-сервере, выполните следующие действия для настройки и выполнения сценария выделения ресурсов.

   Процедура настройки

   1. Откройте файл devicemove.sh.
   2. Найдите переменную PROXY_HOST и раскомментируйте ее (удалите начальный символ # для devicemove.sh).

   3. Задайте значение PROXY_HOST следующим образом:

      PROXY_HOST=<proxy-host>

   4. Найдите переменную PROXY_PORT и раскомментируйте ее (удалите начальный символ # в файле devicemove.sh).

   5. Задайте значение PROXY_PORT следующим образом:

      PROXY_PORT=<proxy-port>

   6. Найдите переменную PROXY_SCHEME и раскомментируйте ее (удалите начальный символ # в файле devicemove.sh). Этот шаг необязателен; если оставить комментарий, значением по умолчанию для PROXY_SCHEME будет HTTP.

   7. Задайте значение PROXY_SCHEME следующим образом:

      PROXY_SCHEME=<proxy-scheme>

   8. Сохраните и закройте файл devicemove.sh.
   9. Откройте файл partner.cfg и добавьте необходимый refresh_token.
   10. Убедитесь, что хост, имя пользователя и пароль BroadWorks правильно настроены в partner.cfg

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

       ./devicemove.sh

SCP и SSH

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

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

1. Задайте REFRESH_TOKEN (токен, скопированный из средства генерации токенов) в файле conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Чтобы повторно отправить письма с активацией, вам необходимо задать send_subscribers_welcome_email=True в файле conf/partner.cfg.

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

4. Убедитесь, что путь к среде JDK/JRE указан правильно в файле devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Телефоны Polycom

Чтобы перевести телефоны Polycom с Cisco BroadWorks на Wholesale Calling, администратор-партнер должен создать новый файл типа идентификации/профиля устройства на системном уровне в шаблоне каждого устройства Polycom Cisco BroadWorks. См. рисунок 14 и загрузите собственный файл Device-Move-tool/conf/deviceProfile/ {region} /polycom_vvx.cfg. После загрузки нового файла устройства убедитесь, что вновь созданный файл существует на уровне группы. Также убедитесь, что файл Migration_%BWMAC-адрес%.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 и будет управляться DMS. Webex Calling

Рисунок 14: Добавлен файл типа идентификатора и профиля устройства

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

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

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

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

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

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

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

Вывод

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

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

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

Рисунок 16: Активные числа

Если администратор использует инструмент на корпоративном прокси-сервере, выполните следующие действия для настройки и выполнения сценария devicemove.

Шаги по настройке и выполнению сценария devicemove

1. Откройте файл devicemove.sh.
2. Найдите переменную HTTPS_PROXY_HOST и раскомментируйте ее (удалите начальный символ #).

3. Задайте значение HTTPS_PROXY_HOST следующим образом:

   HTTPS_PROXY_HOST=<proxy-host>

4. Найдите переменную HTTPS_PROXY_PORT и раскомментируйте ее (удалите начальный символ #).
5. Задайте значение HTTPS_PROXY_PORT следующим образом:

   HTTPS_PROXY_PORT=<proxy-port>

6. Сохраните и закройте файл devicemove.sh.
7. Откройте файл partner.cfg и добавьте необходимый refresh_token.
8. Убедитесь, что хост, имя пользователя и пароль BroadWorks правильно настроены в partner.cfg.
9. Запустите скрипт:

   ./devicemove.sh

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

Для оператора связи BroadCloud

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

Для Cisco BroadWorks и Webex для BroadWorks

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

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

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

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

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

Восстановите профили

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Вернуть номера

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

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

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

Восстановите профили

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

Вернуть номера

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