Инструменты миграции для перехода от BroadWorks, Webex для BroadWorks и BroadCloud к решениям Wholesale RTM

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

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

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

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

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

Задайте путь окружения JRE/JDK в token_generator.sh для MAC и token_generator.bat для Windows. Если путь JAVA_HOME уже существует, он будет использован инструментом повторно.

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

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

Инструкции по выполнению

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

Windows.

token_generator.bat.

MacOS:

./token_generator.sh

Выход:

Имя инструмента: Версия инструмента генератора маркеров: 1.13.0 Загрузите URL в веб-браузер: http://localhost:8080 

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

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

Рисунок 3. Вход в Cisco Webex

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

Рисунок 5. Создание токенов

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

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

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

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

Чтобы изменить каталог GeneralSettings, выполните следующую команду в CLI:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

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

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

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

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

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

Изменение каталога подготовки.

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

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

 AS_CLI/Maintenance/ManagedObjects> получите broadworks и убедитесь, что ваш вывод выглядит нормально. Ниже приведены примеры вывода. AS_CLI/Maintenance/ManagedObjects> get broadworks Управляемые объекты BroadWorks ========================== * Сервер: Идентификация..............: Версия AS...............: Rel_21.sp1_1.551 Административное состояние...: Разблокированные * Приложения: Имя Версия Развернутое административное состояние Эффективное ========================================================================================= выполнениеAndProvisioning 21.sp1_1.551 true Unlocked Unlocked FlashPolicy 21.sp1_1.551 false Unlocked Stopped OpenClientServer 21.sp1_1.551 true Unlocked Unlocked Unlocked WebContainer 21.sp1_1.551 true Unlocked Unlocked Unlocked 4 записи найдены. * Размещенные приложения: Имя версии Путь контекста Развернутый ================================================================== CommPilot 21.sp1_1.551 / true DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true JWSFiles 21.sp1_1.551 /FileRepos true MediaFiles 21.sp1_1.551 /media true OCIFiles 21.sp1_1.551 /ocifiles true 5 записей найдено. 

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

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

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

AS_CLI/Maintenance/ManagedObjects> развертывание приложения OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> запустить приложение OpenClientServer

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

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

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

AS_CLI> установить dnMode groupAndUserActivationEnabled

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

Для BroadCloud

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

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

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

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

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

Для Cisco BroadWorks и Webex для BroadWorks

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

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

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

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

   ServiceProviderID-A      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - ВСЕ 

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Токен обновления партнера, скопированный из инструмента Генератор токенов. MIGRATION_MODE = поддерживаемые значения webex_for_broadworks_to_wholesale. Значение по умолчанию: broadworks_to_wholesale. Используется webex_for_broadworks_to_wholesale для миграции Webex для BroadWorks. 

   Свойство 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.

 Запуск инструмента экспорта данных BroadSoft ************************************************ Starting Export Tool v: 1.15.0 Начат экспорт для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Экспорт пользователей для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Экспорт завершен для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Экспорт завершен для SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Экспорт завершен Экспорт дампа zip : output/20221017223452_ExportTool Export Dump Zip Имя файла :extracted_data_1666060500618.zip Создан файл ZIP с именем extracted_data_1666060500618.zip Завершен процесс создания файла ZIP Экспортированные файлы преобразованы в файл ZIP ************************************************** 

Результат

Выходной файл 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 окт  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 окт  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 oct  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 окт 17 22:34 output/ drwxrwxr-x 2 bwadmin bwadmin 4096 окт 17 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 окт 17 22:35 extracted_data_1666060500618.zip 

Этот инструмент преобразования запущен для всех миграций. Инструмент преобразования работает на любом компьютере, включая ноутбук администратора партнера, и использует общедоступные API Webex. Он считывает выходной файл утилиты извлечения 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_ (скопированный из шаблона в Partner Hub) в файле conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

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

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

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

Инструкции по выполнению

Запустите инструмент трансформации в любой операционной системе. Чтобы запустить инструмент в Windows и macOS, выполните приведенные ниже действия.

Windows

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

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

MacOS

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

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

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

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

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

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

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

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

предварительный чек

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

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

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

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

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

Сводный отчет Предприятия BroadWorks, которые могут быть успешно перенесены: 1 Предприятия BroadWorks, которые невозможно перенести: 0 пользователей BroadWorks, которые могут быть успешно перенесены: 4 пользователя BroadWorks, которые невозможно перенести: 0 телефонов, которые могут быть успешно перенесены: 3 телефона, несовместимые с Webex Calling. 0 

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

Transform Tool создает отчет об исключениях в каталоге output//exception_report.txt . С помощью этого отчета можно определить проблемы, которые повлияют на миграцию, и устранить их в системе Cisco BroadWorks.

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

Отчет об исключениях Вт 18 окт 08:12:09 2022 Предприятия с функцией запрета связи Рекомендация: вручную настройте план исходящих вызовов в Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Результат

Выходной файл JSON (customer.json) будет доступен в каталоге output// . Пример файла customer.json выглядит следующим образом:

{ "customer": { "provisioningId": "!!!!!!!!!!ЗАМЕНИТЬ_С_PROVISIONINGID!!!!!!!!!!", "пакеты": [ "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", "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/New_York", "язык": "en_us", "номера": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "подписчики": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ЗАМЕНИТЬ_С_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" 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" 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_С_PERSONID!!!!!!!!!!", "product": "DMS Cisco 8811", "mac": "F  B204E4066" } ] } } ], "auto_attendants": [, ], "call_queues": [, ], "hunt_groups": [], "расписания": [], "call_parks": [, ], "call_pickups": [, ], "paging_groups": [, ], "voice_portals": [ { "name": "automated Voice Portal", "firstName": "automated", "lastName": "voice Portal", "languageCode": "en_us", "phoneNumber": "+15205551105", "добавочный номер": "1105" } ], "shared_call_appearances": [, ], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "местоположения: [], "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 на компьютер. Java доступна из многих источников, включая:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. После скачивания и извлечения двоичных файлов инструментов миграции задайте переменную среды JAVA_HOME в provisioning_tool.sh для MAC и provisioning_tool.bat для Windows.
3. Файл partner.cfg:
   • Установите идентификатор WHOLESALE_PROVISIONING_ID и REFRESH_TOKEN (токен, скопированный из инструмента генератора токенов). Администраторы-партнеры должны обратиться в свою команду по работе с учетными записями для получения идентификатора ПОДГОТОВКИ_.

     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.

Для миграции BroadCloud в том же регионе:

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

Для миграции BroadCloud другой регион:

1. Инструмент подготавливает номера, устройства и индикации общих вызовов.
2. Инструмент будет создавать пользователей и виртуальных пользователей с фактическими номерами телефона и добавочным номером.
   Все миграции BroadCloud в Европе происходят в другой регион.

Инструкции по выполнению

Чтобы запустить инструмент в Windows и macOS, выполните приведенные ниже действия.

Windows

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

Для подготовки отдельного клиента: provision.bat -input= Для подготовки нескольких клиентов: provision.bat -input= 

MacOS

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

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

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

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

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

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

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

Этап после миграции: Является ли завершающим этапом Администраторы могут полностью преобразовать BroadWorks в Wholesale. Необходимо запустить инструмент подготовки с аргументом после миграции.

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

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

Имя инструмента: Версия инструмента подготовки: 1.15.0 ********** Начатая обработка файла: input/customer.json **************** Provisioning Клиент Ожидает, пока клиент external_id_engg_grp1 завершит подготовку... Ожидание завершения подготовки клиента external_id_engg_grp1...   Состояние клиента external_id_engg_grp1: подготовленные номера подготовки Подготовка Пользователи Подготовка Функции пользователей Подготовка Подготовка Приветствия Подготовка Подготовка Устройства Подготовка Подготовка Индикации общих вызовов Подготовка Подготовка Автосекретари Подготовка Очереди вызовов Подготовка Сервисные группы Подготовка Страницы группы Подготовка Настройка Парковка вызовов Подготовка Перехваты вызовов Подготовка голосового портала ********** Завершенный файл: 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 запросов.

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

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

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

Для Cisco BroadWorks и Webex для BroadWorks

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

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

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

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. Проверьте правильность пути окружения JDK/JRE в devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Телефоны Polycom

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

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

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

1. Инструмент перемещения устройства заменяет файл %BWMACADDRESS%.cfg на уровне устройства на polycom_vvx2.cfg. Обратите внимание, что данный файл относится к migration_%BWMACADDRESS%.cfg.
2. Восстановите профили устройств на уровне группы или на уровне устройства.
   Действие на уровне группы или устройства зависит от конфигурации параметра deviceLevelRebuild в файле device-move-tool/conf/partner.cfg.
3. Инструмент перемещения устройства запрашивает сервер приложений Cisco BroadWorks перезагрузку телефонов на уровне группы или устройства.
4. После запроса перезагрузки загрузите телефоны Polycom и process% BWMACADDRESS%.cfg, который запрашивает загрузку телефонов Polycom и process.cfgmigration_%BWMACADDRESS%, который задает 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 в каталоге инструмента перемещения устройства:

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

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

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

Имя инструмента: Версия инструмента перемещения устройства: 1.15.0 Запущен инструмент устройства... Допустимые устройства для миграции: ------------------------------------------------------------------------------------------------------------------- | Тип устройства | Mac | Версия | адрес электронной почты | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | F  B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Выполнить миграцию всех этих устройств? ([Y]es или [N]o) да Загрузка профилей устройств для DMS Cisco MPP LC Процесс восстановления устройства Начат Процесс восстановления устройства Завершен Процесс перезагрузки Процесс перезагрузки Завершен Успешно Изменение профилей для Business Communicator в группе collabmigrationtestGRP_engg Активация номера телефона Webex запущен для идентификатора организации клиента: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Активация номера телефона Webex завершена для идентификатора организации клиента: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c процесс деактивации номеров телефона broadworks, начатый для groupId: collabmigrationtestGRP_engg Процесс деактивации номеров телефона broadworks завершен для идентификатора группы: Миграция_engg устройства collabmigrationtestGRP завершена 

Результат

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

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

После миграции устройства номера стали активными. См. рисунок 16, чтобы увидеть пример активных чисел.

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

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

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

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

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

Для Cisco BroadWorks и Webex для BroadWorks

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

1. Откройте обращение в Cisco TAC, чтобы запросить возврат устройства.
2. Запустите инструмент перемещения устройства в режиме возврата на дополнительном сервере приложений BroadWorks, чтобы отменить миграцию устройства. Это приведет к возврату URL-адреса DMS поставщика услуг для профилей устройств в Cisco BroadWorks и повторной активации номеров телефона.
3. Команда Webex Calling возвращает 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

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

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

Возврат профилей

Имя инструмента: Версия инструмента перемещения устройства: 1.15.0 Инструмент устройства запущен для процесса возврата... Устройства, которые можно переместить из Webex Calling в BroadWorks. - ------------------------------------------------------------------------------------------------------------------- | Тип устройства | Mac | Версия | адрес электронной почты | ------------------------------------------------------------------------------------------------------------------- | 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 | F  B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Переместить эти устройства из Webex Calling в BroadWorks? (Да, Y, Нет, N):  да Загрузка профилей устройств для DMS Cisco MPP LC Процесс восстановления устройства Начат Процесс восстановления устройства Завершен Процесс перезагрузки Процесс перезагрузки Успешно завершен Миграция устройства для процесса отключения 

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

Имя инструмента: Версия инструмента перемещения устройства: 1.15.0 Продолжить возврат номеров в Broadworks?  ([Y]es или [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Начало возврата Начат процесс активации номеров телефона broadworks для groupId: collabmigrationtestGRP_engg Процесс активации номеров телефона broadworks завершен для идентификатора группы: collabmigrationtestGRP_engg Процесс возврата миграции устройства успешно завершен