Поддерживаемые телефоны будут автоматически созданы и назначены пользователям в 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="/Пользователи/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows. JAVA_HOME=C:\Progra~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.

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

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

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

Этап 2. Для настройки прокси OCI используйте CLI.

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

 КАК_CLI/Maintenance/ManagedObjects> получить Broadworks и убедитесь, что выходные данные выглядят нормально. Примеры вывода см. ниже. AS_CLI/Maintenance/ManagedObjects> получить объекты под управлением BroadWorks ========================== * Сервер: Идентификация..............: Версия AS...............: Вel_21.sp1_1.551 административное состояние... Разблокированные * Приложения: 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 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. 

Проверка развернутого и активного сервера открытого клиента

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

Этап 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:

   Поставщик услугID-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 Экспорт завершен: output/20221017223452_ExportTool Export Dump File name:extracted_data_1666060Файл ZIP 500618.zip с именем extracted_data_1666060500618.zip создан процесс создания файла ZIP. Экспортированные файлы преобразованы в файл ZIP ************************************************** 

Результат

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

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

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

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

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

1. Установите ТОКЕН ОБНОВЛЕНИЯ_ (токен, скопированный из инструмента генератора токенов) и ИМЯ__ГЛАВНОГО_МЕСТОПОЛОЖЕНИЯ в файле conf/partner.cfg:

   ОБНОВИТЬ_TOKEN=MzВашYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main 

2. При необходимости задайте идентификатор ОБЕСПЕЧЕНИЯ_ (скопированный из шаблона в Partner Hub) в файле conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

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

Файл ввода/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, чтобы обнаружить потенциальные проблемы с обеспечением. По умолчанию будут подтверждены адрес и основной адрес электронной почты клиента. Если значение идентификатора ПОДГОТОВКИ_указано в файле conf/partner.cfg, будет также выполнена проверка информации о местоположении. Результаты предварительной проверки включены в отчет об исключениях.

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

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

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

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

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

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

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

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

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

Инструмент преобразования создает отчет об исключениях в каталоге 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", "адрес": { "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": { "name": "Main", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/New_Йорк", "язык": "en_us", "номера": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "подписчики": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_с помощью команды_CUSTOMERID!!!!!!!!!!", "email": amareswaranvel+benjaminjack@gmail.com, "package": "webex_calling", "provisioningParameters": { "firstName": "Бенджамин", "lastName": "Джек", "primaryPhoneNumber": "+15205551102", "добавочный номер": "1102" }}, "функции": [ { "/v1/people/{personId}/features/голосовая почта": { "включено": true, "sendBusyCalls": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ" }, "sendUnansweredCalls": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ", "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": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ" }, "sendUnansweredCalls": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ", "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": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ" }, "sendUnansweredCalls": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ЗАМЕНИТЬ_НА_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": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ" }, "sendUnansweredCalls": { "включено": true, "приветствие": "ПО УМОЛЧАНИЮ", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_с помощью команды_ЛИЧНОСТЬ!!!!!!!!!!", "продукт": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "расписания": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Автоматизированный голосовой портал", "firstName": "Автоматизированный", "lastName": "Голосовой портал", "languageCode": "en_us", "номер телефона": "+15205551105", "добавочный номер": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - профиль устройства Engg" ], "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 to false, если партнер не хочет отправлять пользователям приветственное электронное сообщение. Значением по умолчанию является истина.

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

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

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

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

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

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

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

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

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

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

SCP и SSH

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

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

1. Установите ТОКЕН ОБНОВЛЕНИЯ_ (токен, скопированный из инструмента генератора токенов) в файле conf/partner.cfg:

   ОБНОВИТЬ_TOKEN=MzВашYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   ИДЕНТИФИКАТОР ПОЛЬЗОВАТЕЛЯ BROADWORKS__BROADWORKS = администратор BROADWORKS_ПАРОЛЬ = администратор BROADWORKS_ХОСТ_ИМЯ = локальный хост 

3. Чтобы повторно отправить электронные сообщения для активации, необходимо задать значение RESEND_INVITATION_EMAILS=true в файле conf/partner.cfg.

   Если администраторы хотят отправить электронные приглашения пользователям во время миграции, они должны оставить комментарий к свойству "ПОВТОРНО ОТПРАВИТЬ_INVITATION_EMAILS=true" в файле conf/partner.cfg. В противном случае свойство должно оставаться неизменным.

4. Убедитесь в правильности пути среды JDK/JRE в devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Телефоны Polycom

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

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

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

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

Для перемещения устройства одного клиента: ./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 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Выполнить миграцию всех этих устройств? ([Y]es или [N]o) да Загрузка профилей устройств для DMS Cisco MPP LC Процесс восстановления устройств начат Процесс восстановления устройств Успешно завершен Процесс перезагрузки Успешно завершен Изменение профилей для Business Communicator в разделе group collabmigrationtestGRP_engg Активация процесса номеров телефонов Webex начата для организации клиента: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Процесс активации номеров телефона Webex завершен для идентификатора организации клиента: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Деактивировать процесс номеров телефона Broadworks, начатый для groupId: collabmigrationtestGRP_engg Деактивация процесса номеров телефона Broadworks завершена для идентификатора groupId: collabmigrationtestGRP_engg Миграция устройства завершена 

Результат

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

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

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

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

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

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

Процесс возврата для партнеров BroadCloud приведен ниже.

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

Для Cisco BroadWorks и Webex для BroadWorks

Процесс возврата для Cisco BroadWorks и Webex для BroadWorks приведен ниже.

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

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

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

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

Отменить профили

./devicemove.sh -input=  -revertProfiles

Отменить номера

./devicemove.sh -input=  -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 | F87B204E4066 | 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] или [N] o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Начало возврата Активация номеров телефона Broadworks начата для идентификатора группы: collabmigrationtestGRP_engg Активация процесса номеров телефона Broadworks завершена для идентификатора groupId: collabmigrationtestGRP_engg Процесс отмены миграции устройства успешно завершен