- Главная
- /
- Статья
Инструменты миграции для перехода к решениям Wholesale RTM
Запустите миграцию с минимальной предварительной настройкой. Упрощение выполнения команд. Администраторы могут просматривать свои данные после подготовки, а также совершать и принимать звонки сразу после миграции. Поддерживается автоматическое обновление до приложения Webex для клиентов UC-One.
Обзор
Целью настоящего документа является предоставление подробных инструкций по использованию инструментов для миграции с Cisco BroadWorks, Webex for BroadWorks и BroadCloud на Wholesale и Webex Calling. В этом документе описывается набор инструментов миграции, разработанных для помощи в миграции существующих клиентов Cisco BroadWorks, Webex для BroadWorks и BroadCloud на решение Wholesale Route-to-Market.
Инструменты миграции предназначены для облегчения полного перехода от BroadWorks к оптовым сервисам. Они не рассчитаны на долгосрочное сосуществование обеих служб в рамках одной организации-клиента.
Влияние миграции
Последствия миграции следующие:
Администраторы
После миграции администраторы должны:
- Начните использовать Partner Hub и Control Hub для настройки функций вместо CommPilot.
- Перенастройте все функции, которые не являются частью миграции.
Вам необходимо вручную перенести те функции, которые не переносятся автоматически после завершения работы инструментов миграции.
Пользователи
Поддерживаемые функции должны работать после миграции так же, как и до нее. Функции Webex Calling, не поддерживаемые миграцией, необходимо перенастроить в Webex после миграции:
- Пользователи потеряют историю звонков и историю сообщений.
- Пользователи потеряют все персональные настройки и настройки ключевых линий и должны будут заново настроить эти параметры после миграции. В качестве примеров можно привести быстрый набор.
- При первом входе в систему пользователи должны сбросить свои коды доступа и пароли.
- Пользователям, использующим клиент UC-One, при первом входе в систему необходимо выполнить обновление до приложения Webex.
Архитектура инструментов миграции
Архитектура инструментов миграции состоит из четырех различных инструментов:
- Инструмент извлечения— извлекает предприятия, группы, номера, пользователей, службы, телефоны и программные клиенты из Cisco BroadWorks. Партнеры BroadCloud должны подать запрос на выписку на портале поставщика услуг.
- Инструмент преобразования— преобразует информацию, извлеченную инструментом извлечения, в файл JSON, который можно редактировать.
- Инструмент подготовки— использует выходной файл JSON из инструмента преобразования для подготовки клиентов, местоположений, номеров, пользователей, служб и телефонов с помощью общедоступных API Webex.
- Инструмент перемещения устройства— использует выходной файл JSON инструмента преобразования для перестроения профилей и перезагрузки телефонов, активации номеров в решении Wholesale RTM и деактивации телефонных номеров в Cisco BroadWorks.
- Этот инструмент поддерживает возврат профилей телефонов и программных клиентов, а также активацию номеров обратно в Cisco BroadWorks.
- Партнеры BroadCloud должны подать заявку на миграцию на портале поставщика услуг.
На следующем рисунке показано, как последовательно работают четыре инструмента, взаимодействуя с Cisco BroadWorks, общедоступными API и загружая метрики в службы Webex для будущей аналитики после того, как администратор запустит задачи миграции.

Рисунок 1. Инструменты миграции
Требования
Перед запуском инструментов миграции партнер должен соответствовать следующим требованиям:
- Учетная запись партнера и администратора партнера должна быть подключена к решению Wholesale RTM. На этапе предпродажи партнерам не требуется быть подключенными к решению Wholesale RTM для запуска инструмента извлечения.
- Партнер должен пройти предмиграционный контрольный список, чтобы убедиться, что все требования выполнены.
- Для запуска инструментов извлечения и перемещения устройств требуются учетные данные системного администратора Cisco BroadWorks. Это не относится к партнерам BroadCloud.
- Инструменты извлечения и перемещения устройств должны запускаться с дополнительного сервера приложений Cisco BroadWorks во время периода обслуживания, чтобы минимизировать риск. Партнеры BroadCloud будут запускать инструмент перемещения устройств с портала поставщика услуг.
- Просмотрите список поддерживаемых устройств Webex Calling.
- Просмотрите список неподдерживаемых устройств Webex Calling.
- Партнерам необходимо обратиться в свою команду по работе с клиентами Cisco, чтобы получить поддерживаемую версию прошивки для телефонов и устройств.
- Клиентам UC-One необходимо обновиться до следующих версий:
- Клиенты Desktop Communicator должны быть версии 22.9.12 или выше.
- Клиенты Mobile Connect должны быть версии 3.9.14 или выше.
- На компьютере администратора должны быть:
- JDK/JRE Для инструмента подготовки требуется версия 1.8.
- Для работы инструмента Transform Tool на компьютерах MAC и Linux требуется Python 3.10.5 или выше.
- Клиенты должны иметь действительный платежный адрес, а конечные пользователи должны иметь рабочий адрес электронной почты, настроенный в Cisco BroadWorks. Если значения не установлены, администраторы партнеров должны связаться со своими клиентами, чтобы получить их. Эти данные необходимо добавить в CSV-файлы (значения, разделенные запятыми) перед запуском инструмента преобразования. Примеры CSV-файлов прилагаются к инструменту преобразования.
План переноса
План миграции состоит из 3 этапов:
- Подготовка
- Получите копию пользовательских данных с помощью инструмента извлечения
- Создайте токен с помощью инструмента «Генератор токенов»
- Используйте инструмент «Трансформация» для форматирования пользовательских данных
- Подготовка
- Получите последние пользовательские данные с помощью Extract Tool
- Используйте инструмент «Трансформация» для форматирования пользовательских данных
- Предоставьте пользователям инструмент подготовки
- Миграция
- Миграция устройств с помощью инструмента перемещения устройств
- Миграции без устройств [ Активация телефонных номеров через Control Hub ]
Если у администраторов партнеров нет устройств для перемещения из Cisco BroadWorks в Wholesale, то запускать инструмент перемещения устройств не нужно. Администраторы партнеров могут использовать общедоступную ссылку ниже для активации телефонных номеров непосредственно через портал Control Hub. Дополнительную информацию см. в статье Управление номерами телефона в Control Hub.
Деактивация телефонных номеров в Cisco BroadWorks необязательна, если администраторы партнеров активируют свои телефонные номера через Control Hub.
Функции автоматически перенесены в Wholesale Calling
Эти пользовательские функции автоматически переносятся инструментами миграции:
- Настройки голосовых сообщений и пользовательские приветствия (голосовые сообщения, персонализированное имя и PIN-код пользователя не переносятся)
- Альтернативные номера
- BroadWorks Anywhere
- Занятое фонарное поле
- Идентификатор вызывающего абонента (имя и номер телефона)
- Ожидающий вызов
- Настройки переадресации вызовов (переадресация вызовов) always/busy/no answer/not достижимый)
- Перехват вызовов
- Не беспокоить
- Настройки факса
- Удаленный офис
- Индикация общего вызова
- Одновременный персональный звонок (включая расписание и критерии отбора)
- Уведомление о вызове (включая расписание и критерии отбора)
- Отклонять анонимные вызовы
- Избирательное отклонение вызовов
- Выборочная переадресация вызовов
- Направленный перехват вызова и вмешательство в разговор
- освобожден от уплаты налога на ввоз
- Нажмите, чтобы говорить
- Конфиденциальность
- Мелодия режима удержания
- Обслуживание в выходные дни
- Ночное обслуживание
Эти групповые функции автоматически переносятся инструментами миграции:
- Автосекретарь
- Только один уровень
- Индивидуальные приветствия
- Настройки переадресации вызовов (всегда, занято, выборочно)
- Альтернативные номера
- Праздничное меню недоступно в Webex
- Избирательное отклонение вызовов
- Стандартный центр обработки вызовов Cisco BroadWorks и очередь вызовов BroadCloud:
- Базовая конфигурация
- Индивидуальные приветствия
- Агенты и супервайзеры
- Настройки переадресации вызовов (всегда, занято, выборочно)
- Альтернативные номера
- Музыка на паузе
- Принудительная пересылка
- Обход сообщения «Комфорт»
- Парковка вызовов
- Перехват вызовов
- Сервисная группа
- Настройки переадресации вызовов (всегда, занято, выборочно, недоступно)
- Альтернативные номера
- Код местоположения (один на местоположение или группу)
- Группа пейджинга
- Расписания (только на уровне группы, расписания предприятий не переносятся)
- Голосовой портал
- Музыка на паузе
- Общий список телефонов
Поддерживаемые устройства
Поддерживаемые телефоны будут автоматически созданы и назначены пользователям в Webex Calling с помощью инструмента подготовки. Телефоны, отмеченные как «да» в столбце «Поддерживается инструментом перемещения устройств», также будут автоматически перемещены из Cisco BroadWorks или BroadCloud в Webex Calling при запуске инструмента перемещения устройств. Для телефонов, отмеченных в этом столбце как «Нет», требуется ручное вмешательство для изменения URL-адреса DMS в шаблоне устройства Cisco BroadWorks или в самом телефоне.
В последнем столбце отображается сопоставление моделей телефонов со столбцом «Тип устройства» файла. transform-tool/input/newphones.csv. (Дополнительную информацию о newphones.csv см. в разделе Инструмент преобразования данной статьи).
Модель телефона |
Поддерживается в инструменте перемещения устройства |
Тип устройства в newphones.csv |
---|---|---|
Cisco MPP 6821 |
Да |
DMS Cisco 6821 |
Cisco MPP 6841 |
Да |
DMS Cisco 6841 |
Cisco MPP 6851 |
Да |
DMS Cisco 6851 |
Cisco MPP 6861 |
Да |
DMS Cisco 6861 |
Cisco MPP 6871 |
Да |
DMS Cisco 6871 |
Cisco MPP 7811 |
Да |
DMS Cisco 7811 |
Cisco MPP 7821 |
Да |
DMS Cisco 7821 |
Cisco MPP 7832 |
Да |
DMS Cisco 7832 |
Cisco MPP 7841 |
Да |
DMS Cisco 7841 |
Cisco MPP 7861 |
Да |
DMS Cisco 7861 |
Cisco MPP 8811 |
Да |
DMS Cisco 8811 |
Cisco MPP 8832 |
Да |
DMS Cisco 8832 |
Cisco MPP 8841 |
Да |
DMS Cisco 8841 |
Cisco MPP 8845 |
Да |
DMS Cisco 8845 |
Cisco MPP 8851 |
Да |
DMS Cisco 8851 |
Cisco MPP 8861 |
Да |
DMS Cisco 8861 |
Cisco MPP 8865 |
Да |
DMS Cisco 8865 |
Cisco MPP 8875 |
Да |
DMS Cisco 8875 |
Cisco АТА191 |
Да |
DMS Cisco 191 |
Cisco ATA192 |
Да |
DMS Cisco 192 |
Cisco DBS 110 |
Да |
DMS Cisco DBS110 |
Поликом VVX101 |
Да |
DMS Polycom VVX101 |
Поликом VVX150 |
Да |
DMS Polycom VVX150 |
Поликом VVX201 |
Да |
DMS Polycom VVX201 |
Поликом VVX250 |
Да |
DMS Polycom VVX250 |
Поликом VVX301 |
Да |
DMS Polycom VVX301 |
Поликом VVX311 |
Да |
DMS Polycom VVX311 |
Поликом VVX350 |
Да |
DMS Polycom VVX350 |
Поликом VVX401 |
Да |
DMS Polycom VVX401 |
Поликом VVX411 |
Да |
DMS Polycom VVX411 |
Поликом VVX450 |
Да |
DMS Polycom VVX450 |
Поликом VVX501 |
Да |
DMS Polycom VVX501 |
Поликом VVX601 |
Да |
DMS Polycom VVX601 |
Поликом Трио 8300 |
Да |
DMS Polycom Trio8300 |
Polycom Trio 8500 |
Да |
DMS Polycom Trio8500 |
Polycom Trio 8800 |
Да |
DMS Polycom Trio8800 |
Polycom SoundStation 5000 |
Да |
DMS Polycom SSIP5000 |
Polycom SoundStation 6000 |
Да |
DMS Polycom SSIP6000 |
Yealink T33G |
Да |
DMS Yealink T33G |
Yealink T41S |
Да |
ДМС Yealink T41S |
Yealink T42S |
Да |
ДМС Yealink T42S |
Yealink T43U |
Да |
ДМС Yealink T43U |
Yealink T46U |
Да |
ДМС Yealink T46U |
Yealink T46S |
Да |
ДМС Yealink T46S |
Yealink T48S |
Да |
ДМС Yealink T48S |
Yealink T48U |
Да |
ДМС Yealink T48U |
Yealink T53W |
Да |
ДМС Yealink T53W |
Yealink T54W |
Да |
ДМС Yealink T54W |
Yealink T57W |
Да |
ДМС Yealink T57W |
Yealink T58V |
Да |
ДМС Yealink T58V |
Yealink CP920 |
Да |
ДМС Yealink CP920 |
Yealink CP960 |
Да |
ДМС Yealink CP960 |
Yealink W52B |
Да |
ДМС Yealink W52P |
Yealink W56B |
Да |
ДМС Yealink W56P |
Yealink W60B |
Да |
ДМС Yealink W60P |
Yealink W70B |
Да |
ДМС Yealink W70P |
Yealink CP925 |
Да |
ДМС Yealink CP925 |
Yealink CP965 |
Да |
ДМС Yealink CP965 |
Неподдерживаемые устройства
Если клиент использует устройства, не поддерживаемые решением Wholesale RTM, то эти устройства не подлежат миграции. В этом случае у вас есть следующие варианты:
- Перед миграцией подготовьте новые телефоны к работе с Cisco BroadWorks.
- Оставьте старые телефоны в Cisco BroadWorks, и пользователям придется установить приложение Webex, чтобы совершать и принимать вызовы.
Оптовые пакеты звонков
Инструменты миграции имеют набор настроек по умолчанию для выбора пакетов оптовых звонков для абонентов. Если позднее потребуется другой пакет, администратор партнера может изменить его в Control Hub.
Конфигурация пакета миграции Cisco BroadWorks
Все абоненты, перешедшие с Cisco BroadWorks, по умолчанию будут использовать пакет вызовов Webex. Если голосовой пакет Webex необходим абонентам, которым не назначены услуги ожидания вызова или голосовой почты, его можно включить в файле partner.cfg инструмента преобразования, раскомментировав строку USE_WEBEX_VOICE_PACKAGE.
Сопоставление пакетов миграции Webex для BroadWorks
Пакеты Webex для BroadWorks автоматически сопоставляются с пакетами оптовых вызовов. Это не настраивается.
Пакет Webex для BroadWorks |
Пакет оптовых звонков |
---|---|
Программный телефон |
Webex Voice |
Базовое |
Webex Calling |
Стандартный |
Webex Suite |
Премиум |
Webex Suite |
Сопоставление пакетов миграции BroadCloud
Миграция из пакетов карт BroadCloud Carrier в зависимости от типа станции. Сопоставление по умолчанию можно настроить в конфигурационном файле инструмента преобразования conf/rialto_station_type_to_wholesale_package.csv.
Тип станции BroadCloud Carrier |
Пакет оптовых звонков |
---|---|
Базовое |
Webex Voice |
Конференц-зал |
Webex Voice |
Обмен сообщениями |
Webex Voice |
Стандартный |
Webex Voice |
Руководитель |
Webex Suite |
Все остальные типы станций |
Webex Voice |
Преобразуйте учетную запись пользователя BroadWorks или BroadCloud в рабочее пространство Webex Calling
Рабочее пространство Webex — это телефон, которым пользуются многие люди, например: например: телефоны в конференц-зале, на складе или в вестибюле. Такие телефоны можно настроить в Webex Calling как рабочие пространства Webex, а не как пользователей Webex. Доступна возможность автоматического преобразования учетных записей пользователей из Cisco BroadWorks или BroadCloud Carrier в рабочие пространства в процессе миграции.
Перечень действий
- В файле transform_tool/input/users.csv, назначьте пакет «common_area» пользователям, которых необходимо преобразовать в рабочее пространство.
- Пример. bwuser@domain,,,common_area
- (Только BroadCloud) Чтобы преобразовать все учетные записи пользователей определенного типа станции в рабочие пространства, добавьте запись в transform-tool/conf/rialto_station_type_to_wholesale_package.csv и установите для пакета Wholesale значение «common_area_calling».
- Пример. conference_room_v2,common_area_calling
- Запустите инструмент преобразования.
- Запустите инструмент подготовки.
- Откройте Control Hub вновь созданной организации клиента и настройте домен SIP (см. рисунок 2, Настройка домена SIP в Control Hub).
- Запустите инструмент подготовки еще раз. Это позволит создать рабочие пространства и назначить им телефоны.
Ограничения
Настройка пользовательских функций (например, переадресация вызовов, режим «Не беспокоить») не переносится автоматически в рабочее пространство.

Рисунок 2. Настройка SIP-домена в Control Hub
Инструмент генератора токенов
Администраторы партнеров запускают этот служебный инструмент генератора токенов хотя бы один раз перед запуском инструментов миграции. Запуск этого инструмента является однократным действием после того, как учетная запись партнера будет подключена к решению 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
После загрузки извлеките двоичные файлы инструмента миграции.
Этот шаг необязателен.
Инструкции по запуску
Выполните следующую команду в терминале внутри каталога генератора токенов:
-
Для запуска инструмента генератора токенов должны быть доступны следующие порты. Порты: 8080, 50009, 50010, 50011, 50012 и 50013
-
По крайней мере один из указанных портов должен быть открыт для подключения на компьютере пользователя.
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
Перед запуском инструментов извлечения и перемещения устройств на вторичном сервере BroadWorks настройте следующие шаги.
Включить подключение OCI-P
Инструмент перемещения устройств взаимодействует с BroadWorks посредством команд OCI-P. Чтобы включить подключение OCI-P, выполните следующие действия:
Шаг 1: Используйте CLI для настройки общих параметров.
Выполните следующую команду в CLI, чтобы перейти в каталог GeneralSettings:
AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.
Выполните следующую команду в CLI, чтобы получить текущие общие настройки:
AS_CLI/Applications/OpenClientServer/GeneralSettings> get
clientPort = 2208
clientPortEnabled = true
secureClientPort = 2209
secureClientPortEnabled = true
systemDomain = <>
Если ваши настройки не соответствуют указанным выше, используйте команду set, чтобы перенастроить ваши настройки.
Шаг 2: Используйте CLI для настройки OCI Proxy.
Измените каталог на OCI Proxy:
AS_CLI> cd /Applications/OpenClientServer/OCIProxy
Запустите следующий CLI, чтобы получить текущие настройки. Вы должны увидеть следующее:
AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800
Если ваши настройки не соответствуют указанным выше, используйте команду set, чтобы перенастроить ваши настройки.
Шаг 3: Используйте CLI для настройки OCI Provisioning.
Перейдите в каталог Provisioning:
AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning
Выполните следующую команду, чтобы получить текущие настройки обеспечения OCI:
AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as
Шаг 4: Выполните команду ниже в CLI, чтобы проверить правильность конфигурации.
AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.
Убедитесь, что открытый клиентский сервер развернут и активен.
Используйте команды ниже для развертывания и запуска Open Client Server на вторичном сервере приложений, если он еще не развернут или не запущен.
Шаг 1: Разверните сервер с помощью следующей команды CLI:
AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer
Шаг 2: Запустите сервер с помощью этой команды:
AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer
Включить активацию номеров
Выполните следующие команды в CLI, чтобы включить активацию номеров:
Шаг 1: Выполните команду активации номера:
AS_CLI> cd SubscriberMgmt/NumberActivation
Шаг 2: Выполните команду включения активации:
AS_CLI> set dnMode groupAndUserActivationEnabled
Шаг 3: В ответ на запрос подтверждения введите Y.
Инструмент извлечения
Для BroadCloud
Инструмент извлечения интегрирован в портал поставщика услуг BroadCloud. Администратор поставщика услуг может:
- Отправляйте запросы на выписку максимум для 50 клиентов за один запрос.Запрос на выписку не может быть отправлен для одного и того же клиента более 10 раз в день.
- Загрузите извлеченный файл данных в формате ZIP в течение 28 дней с даты подачи запроса.
На следующих рисунках показан портал поставщика услуг.

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

Рисунок 7. Портал поставщика услуг
Запрос на извлечение CSV-файла
Инициировать запрос на извлечение CSV
-
Загрузить CSV-файл клиента
Нажмите ссылку Загрузить CSV-файл клиента в правом верхнем углу раздела Инициировать запрос на извлечение CSV-файла.
-
Редактировать список клиентов
Администратор может редактировать этот CSV-файл, чтобы включить в него только тех клиентов, для которых необходимо выполнить извлечение.
-
Загрузить и отправить
После редактирования загрузите измененный CSV-файл.
Нажмите Отправить, чтобы инициировать запрос на извлечение данных по перечисленным клиентам и их местоположениям.
Инициировать запрос на извлечение данных о клиенте с помощью CSV-файла местоположений
-
Выберите клиента и место загрузки
Выберите клиента из выпадающего списка.
Загрузите соответствующий файл locations.csv из «Просмотр клиентов» → вкладка «Сайты» → «Экспорт местоположений в формате CSV» .
-
Редактировать файл местоположений
Администратор может редактировать CSV-файл, включив в него только те местоположения, которые он хочет извлечь.
-
Загрузить и отправить
Загрузите отредактированный файл location.csv и нажмите Отправить.
В запрос на выписку будут включены только указанные местоположения выбранного клиента.
Инициировать запрос на выписку для всех клиентов
- Нажмите Отправить, чтобы инициировать запрос на извлечение для всех клиентов и всех их местоположений у текущего поставщика услуг.

Для Cisco BroadWorks и Webex для BroadWorks
- Инструмент извлечения работает на вторичном сервере приложений Cisco BroadWorks в партнерской сети и подключается по протоколу OCI-P.
- Инструмент извлекает необработанные данные о предприятии, группе, номерах, пользователях, сервисах, устройствах и программных клиентах из платформы Cisco BroadWorks или BroadCloud и выводит эти данные в XML-файлы, которые предоставляют входные данные для инструмента преобразования.
В следующих разделах объясняется, как установить и настроить инструмент извлечения.
Предварительные условия
- SCP — инструмент извлечения двоичных файлов на вторичный сервер приложений Cisco BroadWorks.
- Подключитесь по SSH к вторичному серверу приложений Cisco BroadWorks, чтобы настроить необходимые компоненты и запустить инструмент извлечения.
- Настройте поставщика услуг и идентификатор группы для извлечения из Cisco BroadWorks в conf/exportTool.yml. Ознакомьтесь со следующим примером фрагмента YAML:
ServiceProviderID-A: - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B: - ALL
- Убедитесь, что идентификатор пользователя, пароль и имя хоста вторичного сервера приложений 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. - Изменить JDK/JRE путь к среде в файле export.sh, если вторичный сервер приложений Cisco BroadWorks JDK/JRE Путь к среде отличается от файла:
JAVA_HOME=/usr/local/java/java_base
Инструкции по запуску
Выполните следующую команду на дополнительном сервере приложений Cisco BroadWorks из каталога инструмента извлечения:
./export.sh
Журналы терминала
При успешном экспорте в терминале доступны следующие логи: Запуск инструмента экспорта данных BroadSoft:
Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed
Exported files converted as ZIP file
**************************************************
Результат
Выходной ZIP-файл (extracted_data_<timestamp>.zip) доступен в том же каталоге инструмента извлечения. Используйте следующую команду для просмотра и использования ZIP-файла для ввода инструмента преобразования:
ls –ltr
drwxr-xr-x 2 bwadmin bwadmin 4096 Oct 4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct 4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin 2635 Oct 4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin 4096 Oct 5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin 4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin 4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin 46341 Oct 17 22:35 extracted_data_1666060500618.zip
Инструмент преобразования
Этот инструмент преобразования работает для всех миграций. Инструмент преобразования работает на любом компьютере, включая ноутбук администратора партнера, и использует общедоступные API Webex. Он считывает выходной ZIP-файл инструмента извлечения (extracted_data_<timestamp>.zip) в качестве входных данных и преобразует необработанный XML в формат JSON, который используется инструментом подготовки.
Предварительные условия
После загрузки и извлечения двоичных файлов инструментов миграции настройте следующие предварительные условия:
- Установите ТОКЕН ОБНОВЛЕНИЯ_(токен, скопированный из инструмента генератора токенов) и ИМЯ__ОСНОВНОГО_РАСПОЛОЖЕНИЯ в conf/partner.cfg файл:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main
- При желании можно установить идентификатор PROVISIONING_(скопированный из шаблона в Partner Hub) в conf/partner.cfg файл:
PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1
Для более полной проверки адреса электронной почты клиента вы можете дополнительно установить идентификатор PROVISIONING_. - Настройте недостающую информацию в input/customers.csv файл (см. следующий раздел), если он отсутствует.
- Добавьте адрес электронной почты конечного пользователя в input/users.csv файл.
- Если необходимо настроить новые телефоны, добавьте MAC-адрес и адрес электронной почты нового телефона пользователя. input/newphones.csv файл. Это требуется только в том случае, если администраторы партнеров хотят предоставить новые телефоны для оптовых звонков.
- Преобразуйте колл-центры BroadWorks в CxEssentials с помощью input/cxessentials.csv файл.
- При желании можно включить свойство UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, чтобы преобразовать все центры обработки вызовов в CxEssentials.
- Используйте input/locations.csv файл для поддержки миграции крупных предприятий, который позволяет администраторам переносить местоположения своих клиентов по местоположению
- При необходимости включите использование MAC-адресов из заголовка User-Agent сообщения SIP REGISTER, если MAC-адрес недоступен в профиле устройства Cisco BroadWorks. Раскомментируйте строку USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes в файле conf/partner.cfg
- Функция синхронизации с сетевым сервером позволяет администраторам предоставлять номера телефонов, MAC-адреса и адреса электронной почты пользователей во время предоставления данных в том же регионе миграции. Чтобы включить его, установите
USE_NS_SYNC=yes
вconf/partner.cfg
.Если синхронизация NS отключена, инициализация номера телефона и устройства будет пропущена, а пользователи получат временные адреса электронной почты.
- При желании можно включить свойства АНАЛОГОВЫЙ_ПОЛЬЗОВАТЕЛЬ_ТИП_ВКЛЮЧИТЬ [_ВЫЗОВ_ОЖИДАНИЕ, АНАЛОГОВЫЙ_ПОЛЬЗОВАТЕЛЬ_ТИП_ВКЛЮЧИТЬ_МУЗЫКА_НА_УДЕРЖАНИИ и АНАЛОГОВЫЙ_ПОЛЬЗОВАТЕЛЬ_ТИП_ОТКЛЮЧИТЬ_T38, чтобы настроить ожидание вызова, музыку на удержании и отключить параметры T38 для всех пользователей аналогового типа.
-
Если вы хотите настроить универсальные шлюзовые устройства, добавьте MAC-адрес устройства и идентификатор пользователя в input/genericgateways.csv файл. Также укажите, является ли пользователь ОСНОВНЫМ владельцем или ОБЩИМ пользователем (для общих вызовов). Это необходимо только в том случае, если администраторы партнеров планируют использовать универсальные шлюзовые устройства в оптовых звонках.
Эта функция недоступна для миграции с BroadCloud на Wholesale.
-
Для миграции BroadCloud, чтобы преобразовать всех пользователей с типом станции обмена сообщениями в voice_mail_group, обновите файл conf/rialto_station_type_to_wholesale_package.csv, заменив значение Wholesale Package на voice_mail_group для строки, где Rialto Station Type — это обмен сообщениями.
При желании можно включить свойство COMMON_VOICE_MAIL_GROUP_PASSCODE в partner.cfg, чтобы настроить PIN-код по умолчанию для групп голосовой почты.
Если это свойство не указано в partner.cfg, его необходимо указать для каждого клиента в файле customers.csv в столбце commonVoicemailGroupPassCode.
-
Для переноса общих контактов в Webex Calling
Это усовершенствование для управления общими контактами на уровне предприятия и объекта. Эти контакты теперь можно переносить либо как контакты организации (Org Contacts), либо как виртуальные расширения в зависимости от настроек конфигурации. Ниже приведены подробные инструкции, которые помогут вам пройти этот процесс миграции.
Конфигурация ключа:
- ОБЩИЙ_ТЕЛЕФОН_СПИСОК_ДО_ВИРТУАЛЬНЫЙ_ДОПОЛНИТЕЛЬНЫЙ_НАЧАЛО_ДИАПАЗОН
В файл partner.cfg введено новое свойство COMMON_PHONE_LIST_TO_VIRTUAL__EXTENSION_START [] RANGE. Это свойство определяет, как общие контакты переносятся из Rialto в Webex Calling.
- Без ОБЩЕГО_ТЕЛЕФОННОГО_СПИСКА_ДО_ВИРТУАЛЬНОГО_ДОПОЛНИТЕЛЬНОГО_НАЧАЛА_ДИАПАЗОНА Настроено
Общие контакты будут перенесены как контакты организации (Org Contacts).
Никакой дополнительной настройки не требуется.
Контакты остаются доступными на уровне организации.
- С настроенным ОБЩИМ_СПИСКОМ ТЕЛЕФОНОВ__ДЛЯ_ВИРТУАЛЬНОГО_ДОПОЛНИТЕЛЬНОГО_НАЧАЛА_ДИАПАЗОНА
Общие контакты будут перенесены как виртуальные расширения.
К каждому контакту будет добавлен добавочный номер, а начальный диапазон добавочного номера определяется в свойстве COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE в partner.cfg.
Виртуальные расширения поддерживаются как на уровне организации, так и на уровне местоположения, в зависимости от сферы действия контакта.
- ОБЩИЙ_ТЕЛЕФОН_СПИСОК_ДО_ВИРТУАЛЬНЫЙ_ДОПОЛНИТЕЛЬНЫЙ_НАЧАЛО_ДИАПАЗОН
-
Исключение выбранных номеров телефонов из миграции:
Чтобы исключить определенные номера телефонов из процесса миграции, необходимо выполнить следующую двухэтапную процедуру с использованием инструмента преобразования:
- Сначала запустите инструмент преобразования в первый раз. После завершения инструмент сгенерирует файл с именем telephone_numbers_inventory.csv, расположенный в папке output/timestamp/ каталог. Клиенту необходимо просмотреть этот файл и указать «Да» в столбце «Исключить номера» для каждого номера телефона, который следует исключить из предстоящей миграции.
- После обновления файла telephone_numbers_inventory.csv с соответствующими флагами исключения инструмент преобразования запускается второй раз. Обновленный файл следует передать как аргумент в следующем формате.
./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}
Заполнение input/customers.csv
Файл input/customers.csv предоставляет данные, которые могут отсутствовать в Cisco BroadWorks или BroadCloud. Этот файл можно оставить пустым, если вся обязательная информация уже имеется. Вам не обязательно заполнять все столбцы, обязательной является только недостающая информация.
В таблице ниже объясняются наиболее важные столбцы в input/customers.csv.
Имя столбца |
Правила |
---|---|
Идентификатор |
В корпоративном режиме Cisco BroadWorks:
В режиме поставщика услуг BroadWorks это идентификатор группы Cisco BroadWorks. В BroadCloud это customerId Rialto. |
externalId |
Это идентификатор, который совпадает с внутренним идентификатором партнера для данного клиента. Этот столбец должен быть уникальным в пределах партнерской организации Webex. Этот столбец необязателен, уникальный идентификатор будет сгенерирован автоматически инструментом преобразования. Этот столбец не используется для групп внутри предприятия. |
ИмяКлиента |
Для предприятия этот столбец используется как поле имени клиента Webex. Для группы внутри предприятия этот столбец используется как наименование местоположения. Названия местоположений должны быть уникальными в пределах предприятия. |
основной адрес электронной почты |
Используется как адрес электронной почты администратора клиента Webex. Этот столбец является необязательным для групп внутри предприятия. |
Столбцы адреса |
Для предприятия адрес используется в качестве платежного адреса и адреса первого местонахождения. Для группы внутри предприятия адрес используется в качестве адреса местонахождения. |
часовой пояс |
См. раздел о часовых поясах в этой статье. |
язык | См. Языки, поддерживаемые Webex. |
defaultvoicemailpin | |
commonVoicemailGroupPassCode | В этом столбце можно указать PIN-код по умолчанию, который будет применяться ко всем группам голосовой почты соответствующего клиента. После миграции администраторам необходимо обновить PIN-код для каждой группы голосовой почты. В процессе преобразования всем группам голосовой почты назначается общий PIN-код, указанный администратором. |
Заполнение input/users.csv
Файл input/users.csv предоставляет данные, которые могут отсутствовать в Cisco BroadWorks или BroadCloud. Этот файл можно оставить пустым, если вся обязательная информация уже имеется. Вам не обязательно заполнять все столбцы, обязательной является только недостающая информация.
Все эти поля являются необязательными.
Имя столбца |
Правила |
---|---|
ID пользователя |
Уникальный идентификатор пользователя. Это может быть идентификатор пользователя BroadWorks или BroadCloud. |
адрес электронной почты | (Необязательно) Адрес электронной почты пользователя. Если он предоставлен, он будет использоваться в целях обеспечения. |
номер телефона |
(Необязательно) Номер телефона пользователя, который необходимо предоставить. |
пакет |
(Необязательно) Тип пакета пользователя. Допустимые значения: голос, вызов, набор, common_area, virtual_line, dont_migrate, call_park_ext или voice_mail_group. Значение dont_migrate используется, когда партнеры хотят исключить определенных пользователей (вместе с их устройствами и номерами телефонов) как из подготовки, так и из миграции. Это поддерживается как для BroadWorks, так и для BroadCloud. При применении выбранные пользователи и связанные с ними ресурсы не будут перенесены или подготовлены. Чтобы использовать эту функцию, администраторы должны ввести dont_migrate в столбце пакета файла users.csv. |
добавочный номер |
(Необязательно) Добавочный номер телефона, который будет назначен пользователю. |
имя |
(Необязательно) Полное имя пользователя. |
ata_settings |
(Необязательно) Допустимые значения: т38, аналоговый К enable/disable ожидание вызова, музыка на удержании и настройки T38 T38: Эта опция отключает ожидание вызова и музыку при удержании, а также включает настройки T38 для устройств ATA. Аналог:
|
do_not_move_phone |
Только BroadWorks. Дополнительный флаг для предотвращения миграции устройства в Webex Calling. Эта опция позволяет партнерам предоставлять пользователям их настройки вызовов, устройства и номера телефонов без миграции устройств в Webex или активации номеров телефонов в Webex Calling. Этот параметр доступен только для BroadWorks, но не для BroadCloud. Чтобы использовать его, администраторы должны указать do_not_move_phone в столбце do_not_move_phone (только BroadWorks) файла users.csv. Это гарантирует, что пользователи будут подключены без активации номеров или перемещения своих телефонов, поэтому они продолжат работать через BroadCloud. |
Инструкции по запуску
Запустите Transform Tool в любой операционной системе. Для запуска инструмента в Windows и macOS выполните следующие действия:
Windows
Выполните следующую команду, чтобы запустить инструмент преобразования в Windows:
transform.bat -extract= -customers= -users= -newphones=
MacOS
Чтобы запустить инструмент преобразования на macOS, выполните следующие действия:
- Создайте виртуальную среду и установите зависимости для запуска инструмента преобразования с помощью 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
- Запустите инструмент преобразования:
./transform.sh -extract= -customers= -users= -newphones=
Customer/user предварительная проверка
Инструмент преобразования отправляет вызовы API в Webex для выявления потенциальных проблем с обеспечением. По умолчанию проверяются адрес клиента и его основной адрес электронной почты. Если значение идентификатора PROVISIONING_указано в conf/partner.cfg файл, он также проверит информацию о местоположении. Результаты предварительной проверки включаются в отчет об исключениях.
Кроме того, при запуске инструмента преобразования можно добавить следующие необязательные параметры:
предварительная проверка
Помимо запуска API предварительной проверки информации о клиентах, инструмент Transform Tool также запустит API предварительной проверки адресов электронной почты подписчиков.
предварительная проверка информации
По умолчанию в отчет об исключениях включаются только ошибки предварительной проверки (т. е. проблемы, которые блокируют подготовку). Добавление этого флага также будет включать успешные результаты предварительной проверки (например, если организация Webex уже существует и может быть автоматически присоединена).
precheckinfo занимает дополнительное время для выполнения.
Журналы терминала
При успешном преобразовании в терминале регистрируются следующие данные:
Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0
Отчет об исключении
Инструмент преобразования генерирует отчет об исключении внутри output/<timestamp>/exception_report.txt каталог. Этот отчет можно использовать для выявления проблем, которые повлияют на миграцию, и их устранения в системе Cisco BroadWorks.
После изменения пользовательских данных для устранения исключения повторно запустите инструменты извлечения и преобразования с новыми данными. Пример файла отчета об исключениях выглядит следующим образом:
Exception Report
Tue Oct 18 08:12:09 2022
Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg
Результат
Выходной файл JSON (customer.json) будет доступен в output/<timestamp>/<groupid> каталог. Пример файла customer.json выглядит следующим образом:
{
"customer": {
"provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
"packages": [
"webex_calling",
"common_area_calling"
],
"externalId": "external_id_engg_grp1",
"address": {
"addressLine1": "100 Main Street",
"addressLine2": "",
"city": "Gaithersburg",
"stateOrProvince": "MD",
"zipOrPostalCode": "20877",
"country": "US"
},
"customerInfo": {
"name": "Engineering Group - 1",
"primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
},
"provisioningParameters": {
"calling": {
"location": {
"name": "Main",
"address": {
"addressLine1": "100 Main Street",
"addressLine2": "",
"city": "Gaithersburg",
"stateOrProvince": "MD",
"zipOrPostalCode": "20877",
"country": "US"
},
"timezone": "America/New_York",
"language": "en_us",
"numbers": [
"+15205551101",
"+15205551102",
"+15205551103",
"+15205551104",
"+15205551105",
"+15205551106",
"+15205551107",
"+15205551108",
"+15205551109",
"+15205551110"
],
"mainNumber": "+15205551101"
}
}
}
},
"broadworks_info": {
"service_provider_id": "collabmigrationtestSP_engg",
"group_id": "collabmigrationtestGRP_engg"
},
"subscribers": [
{
"amareswaranvel+benjaminjack@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+benjaminjack@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Benjamin",
"lastName": "Jack",
"primaryPhoneNumber": "+15205551102",
"extension": "1102"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineering17861@mailnator.com"
}
}
}
],
"devices": [
{
"cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
"product": "DMS Cisco 7861",
"mac": "CC98914EAAD7"
}
]
}
},
{
"amareswaranvel+lucasoliver@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+lucasoliver@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Lucas",
"lastName": "Oliver",
"primaryPhoneNumber": "+15205551103",
"extension": "1103"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineering16821@mailnator.com"
}
}
}
],
"devices": [
{
"cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
"product": "DMS Cisco 6821",
"mac": "5486BCAE7E45"
}
]
}
},
{
"amareswaranvel+leojackson@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+leojackson@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Leo",
"lastName": "Jackson",
"primaryPhoneNumber": "+15205551104",
"extension": "1104"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineeringmacpc@mailnator.com"
}
}
}
],
"devices": []
}
},
{
"amareswaranvel+owenalex@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+owenalex@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Owen",
"lastName": "Alexander",
"primaryPhoneNumber": "+15205551101",
"extension": "1101"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineering8811@mailnator.com"
}
}
}
],
"devices": [
{
"cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
"product": "DMS Cisco 8811",
"mac": "F87B204E4066"
}
]
}
}
],
"auto_attendants": [],
"call_queues": [],
"hunt_groups": [],
"schedules": [],
"call_parks": [],
"call_pickups": [],
"paging_groups": [],
"voice_portals": [
{
"name": "Automated Voice Portal",
"firstName": "Automated",
"lastName": "Voice Portal",
"languageCode": "en_us",
"phoneNumber": "+15205551105",
"extension": "1105"
}
],
"shared_call_appearances": [],
"business_communicator_desktop_to_upgrade_to_webex_app": [
"PC Comm - Engg Device Profile"
],
"connect_client_to_upgrade_to_webex_app": [],
"locations": [],
"webex_for_broadworks_info": {
"users": [
{
"id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
}
],
"hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
"hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
}
}
The `webex_for_broadworks_info` Свойство JSON присутствует только для миграций Webex для BroadWorks. The `broadcloud_info` Свойство JSON присутствует только для миграций BroadCloud.
Инструмент подготовки
Инструмент обеспечения может работать на любом компьютере (обычно на ноутбуке администратора партнера) и использует общедоступные API Webex. Он считывает выходной JSON-файл инструмента преобразования (customer.json) в качестве входных данных и предоставляет данные о клиентах, местоположениях, номерах, пользователях, сервисах и устройствах в решении Webex Wholesale RTM.
Предварительные условия
Настройте следующие предварительные условия в каталоге инструмента подготовки:
- Установите Java 8, 11, 17 или 21 на компьютер. Java доступна из многих источников, включая:
- После загрузки и извлечения двоичных файлов инструментов миграции установите переменную среды JAVA_HOME в provisioning_tool.sh для MAC и provisioning_tool.bat для Windows.
- Файл partner.cfg:
- Установите идентификатор WHOLESALE_PROVISIONING_и токен REFRESH_(токен, скопированный из инструмента генератора токенов). Администраторы партнеров должны связаться со своей командой по работе с клиентами, чтобы получить идентификатор PROVISIONING_:
WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
-
Установите ALLOW_ADMIN_INVITE_EMAILS на значение false, если партнер не хочет отправлять приветственные письма пользователям. Значение по умолчанию — true.
- Установите идентификатор WHOLESALE_PROVISIONING_и токен REFRESH_(токен, скопированный из инструмента генератора токенов). Администраторы партнеров должны связаться со своей командой по работе с клиентами, чтобы получить идентификатор PROVISIONING_:
- Используйте свойство WEBEX4BWKS_EMAIL_SUBJECT для миграции Webex для BroadWorks, чтобы отправить тему электронного письма с запросом на смену пароля подписчикам Webex для BroadWorks.
- Используйте свойство WEBEX4BWKS_EMAIL_BODY для миграции Webex для BroadWorks, чтобы отправить текст электронного письма с запросом на смену пароля для подписчиков Webex для BroadWorks.
- Функция синхронизации с сетевым сервером позволяет администраторам предоставлять номера телефонов, MAC-адреса и адреса электронной почты пользователей во время предоставления данных в том же регионе миграции. Чтобы включить его, установите
USE_NS_SYNC=yes
вconf/partner.cfg
.Если синхронизация NS отключена, инициализация номера телефона и устройства будет пропущена, а пользователи получат временные адреса электронной почты.
Для миграций BroadCloud в том же регионе:
- Инструмент пропускает настройку номеров, устройств и общих линий вызова.
- Инструмент создает пользователей и виртуальных пользователей с расширением и временным расширением.
Для миграции BroadCloud другой регион:
- Инструмент предоставит номера, устройства и общие вызовы.
- Инструмент создает пользователей и виртуальных пользователей с реальными номерами телефонов и добавочными номерами.Все миграции BroadCloud из Европы осуществляются в другой регион.
Инструкции по запуску
Для запуска инструмента в Windows и macOS выполните следующие действия:
Windows
Для запуска инструмента в ОС Windows выполните следующие действия:
To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input=
MacOS
Чтобы запустить инструмент на macOS, выполните следующие действия:
To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=
Предварительные условия для миграции Webex для BroadWorks
Администраторы партнеров должны обновить свой шаблон адаптации BroadWorks для функций сосуществования Webex и BroadWorks. Обратитесь к следующему изображению:

После обновления шаблона Webex для адаптации BroadWorks для поддержки миграции попросите группу по работе с клиентами Cisco включить функцию «wholesale-partner-blending-enabled» на уровне партнера. Это позволит добавлять оптовые пакеты в существующие организации клиентов Webex для BroadWorks во время подготовки.
Запустите инструмент подготовки с дополнительным аргументом.
Подготовительная фаза: — это этап по умолчанию, на котором администраторы могут предоставлять пользователям BroadWorks услуги в качестве оптовых подписчиков и продолжать работу с Webex для пользователей BroadWorks.
Фаза обслуживания: — это второй этап, на котором администраторы могут назначить оптовую лицензию существующим пользователям Webex для BroadWorks. Необходимо запустить инструмент подготовки с аргументом maintenance.
Фаза после миграции: Это заключительный этап, на котором администраторы могут полностью преобразовать BroadWorks в оптовую версию. Необходимо запустить инструмент подготовки с аргументом postmigration.
Журналы терминала
Ниже приведены журналы терминала при успешной подготовке:
Tool Name: Provisioning Tool
Version: 1.15.0
********** Started Processing File : input/customer.json ****************
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
********** Completed File : input/customer.json ****************
Будет напечатана таблица с количеством локаций, созданных для каждого запуска:

Результат
Инструмент подготовки генерирует отчеты об успехах и ошибках внутри output/<external_id>/*.success/error файлы. Проверьте журналы успешного выполнения и ошибок вывода, чтобы убедиться в успешности подготовки.
Администраторы партнеров могут проверить подготовку клиентов на портале Partner Hub и Control Hub. Ознакомьтесь со следующими иллюстрациями из порталов Partner Hub и Control Hub:

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

Рисунок 9. Control Hub

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

Рисунок 11. Вызов
Ограничения после предоставления
После завершения подготовки к миграции BroadCloud следующие действия будут заблокированы:
- Портал CAP – Добавление пользователей или перенесенных устройств.
- SP Portal – Создание заказов ADD с устройствами или номерами.
- RSB API – Создание заказов ADD с устройствами или номерами и создание пользователей. Заказы RSB ADD, сделанные с использованием устройств или цифр, будут отклонены.
Инструмент перемещения устройства
Для BroadCloud
Партнеры BroadCloud могут воспользоваться порталом поставщиков услуг для отправки запроса на миграцию номеров, устройств и миграций общих вызовов (SCA).
На портале поставщика услуг запрос на миграцию может включать до 50 клиентов. В течение дня можно подать не более 10 запросов.
Функция синхронизации сетевого сервера позволяет администраторам деактивировать местоположение broadCloud и активировать местоположение Webex Calling при установке USE_NS_SYNC=yes
в conf/partner.cfg
. После миграции устройства и номера телефонов активируются в локации Webex Calling.
Администраторы могут включить автоматический откат, установив ROLLBACK_TO_BROADCLOUD=true
в файле conf/partner.cfg
, который возвращает устройства в BroadCloud после миграции. Поддерживает миграцию как в пределах одного региона, так и в пределах разных регионов с помощью NS Sync, но только для успешных миграций. В случае неудачных попыток администраторам необходимо обратиться в центр технической поддержки Cisco TAC, прежде чем запрашивать откат.
На портале доступны два варианта выбора типа миграции:
- Миграция — выберите этот параметр, чтобы инициировать запрос на миграцию номеров, устройств и общих вызовов (SCA).
- Состояние устройства — выберите этот параметр, чтобы просмотреть текущее состояние устройства в BroadCloud и вызовах.
На следующих рисунках показан портал поставщика услуг.
Рисунок 12. Портал поставщика услуг
Рисунок 13. Портал поставщика услуг
Перенести выбранные местоположения (необязательно)
Чтобы начать миграцию для определенного подмножества местоположений, перечисленных в файле customer.json
, включите файл locations.csv
в свой запрос. В этом CSV-файле должны быть указаны только те местоположения, которые вы собираетесь перенести.
Если файл location.csv не указан, будут перенесены все местоположения из customer.json.
Термин | Определение |
---|---|
Идентификатор веб-сайта |
Идентификатор сайта местоположения, подлежащего переносу. |
Имя веб-сайта |
Название местоположения, подлежащего переносу. |
Чтобы загрузить список доступных активных сайтов, перейдите в раздел Просмотр клиентов → Выберите клиента → Экспорт местоположений в формате CSV.

Рисунок 14. Экспорт местоположений в формате CSV
Для Cisco BroadWorks и Webex для BroadWorks
Для миграции Cisco BroadWorks и Webex для BroadWorks инструмент работает на дополнительном сервере приложений Cisco BroadWorks в партнерской сети и подключается к AS через OCI-P. Он использует выходной JSON-файл инструмента преобразования (customer.json) в качестве входных данных и запускает команды OCI-P для миграции устройств и программных клиентов.
При успешной работе инструмент перемещения устройства выполнит следующие действия:
- Отмените регистрацию устройств в Cisco BroadWorks и зарегистрируйте их в Wholesale.
- Пользователи, использующие клиент UC-One, при первом входе в систему будут перенаправлены в приложение Webex.
- Деактивируйте номера телефонов из Cisco BroadWorks или удалите номера телефонов из BroadCloud.
- Активируйте номера в Оптовой продаже.
- Создавайте общие вызовы в Wholesale для миграции в BroadCloud. [This шаг применим только для BroadCloud migrations].
SCP и SSH
- SCP — инструмент перемещения устройства на вторичный сервер приложений Cisco BroadWorks.
- Подключитесь по SSH к вторичному серверу приложений Cisco BroadWorks, чтобы настроить предварительные условия и запустить инструмент перемещения устройств.
Предварительные условия
- Установите REFRESH_TOKEN (токен, скопированный из инструмента генератора токенов) в conf/partner.cfg файл:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
- Убедитесь, что идентификатор пользователя, пароль и имя хоста вторичного сервера приложений Cisco BroadWorks указаны правильно. conf/deviceMoveTool.conf файл:
BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost
- Для повторной отправки писем активации вам необходимо установить RESEND_INVITATION_EMAILS=true в conf/partner.cfg файл.
Если администраторы хотят отправлять своим пользователям электронные письма с приглашениями во время миграции, им следует раскомментировать «RESEND_INVITATION_EMAILS=true" недвижимость в conf/partner.cfg файл. В противном случае имущество должно остаться неизменным.
- Проверьте JDK/JRE Путь к среде указан правильно в devicemove.sh
JAVA_HOME=/usr/local/java/java_base
- Администраторы могут использовать файл location.csv из входного каталога для миграции определенных групп вместо всех групп в рамках предприятия.
Телефоны Polycom
Чтобы перенести телефоны Polycom из Cisco BroadWorks в Wholesale Calling, администратор партнера должен создать новую Identity/Device Файл типа профиля на системном уровне в Cisco BroadWorks для каждого шаблона устройства Polycom. Обратитесь к рисунку 14 и загрузите пользовательский файл device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. После загрузки нового файла устройства убедитесь, что вновь созданный файл существует на уровне группы. Также убедитесь, что файл migration_%BWMAC ADDRESS%.cfg не конфликтует ни с одним существующим файлом в вашей системе).
Он используется внутренне инструментом перемещения устройства.
Процесс миграции для телефонов Polycom:
- Инструмент перемещения устройства заменяет файл %BWMACADDRESS%.cfg на уровне устройства на polycom_vvx2.cfg. Этот файл ссылается на migration_%BWMACADDRESS%.cfg.
- Перестройте профили устройств на уровне группы или устройства.Действие на уровне группы или устройства зависит от конфигурации параметра deviceLevelRebuild в файле device-move-tool/conf/partner.cfg.
- Инструмент перемещения устройств запрашивает у сервера приложений Cisco BroadWorks перезагрузку телефонов на уровне группы или устройства.
- После запроса на перезагрузку телефоны Polycom загружают и обрабатывают% BWMACADDRESS%.cfg, который просит телефоны Polycom загрузить и обработать migration_%BWMACADDRESS%.cfg, который устанавливает device.prov.serverName в https://plcm.sipflash.com.https://plcm.sipflash.com для региона США, для других регионов URL-адреса отличаются.
- Телефон Polycom загрузит %BWMACADDRESS%.cfg из https://plcm.sipflash.com и будет управляться Webex Calling DMS.

Рисунок 14. Identity/device добавить файл типа профиля
Инструкции по запуску
Существует два метода вызова ДМТ: первый — это обращение к одному клиенту за раз, а второй — обращение к нескольким клиентам одновременно.
Инструмент перемещения устройств запускается с дополнительного сервера приложений Cisco BroadWorks, находящегося в каталоге инструментов перемещения устройств:
For device move single customer:
./devicemove.sh -input=
./devicemove.sh -input=/tmp/customername.json
For device move multiple customers:
./devicemove.sh -input=
ls -l /tmp/directoryofcustomers/
customer1.json
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input= -macaddress=4CBC4883A6F8,48256741CBE9
Журналы терминала
Ниже приведены журналы терминала при успешном запуске инструмента перемещения устройств для миграции устройств:
Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
| Device Type | Mac | Version | Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o)
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed
Результат
После миграции устройства подключены к сети и готовы к работе. make/receive звонки. Пример состояния устройства см. на рисунке 15:

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

Рисунок 16. Активные номера
Откат миграции
Операция возврата должна быть выполнена для одного предприятия за раз.
Для оператора BroadCloud
Процесс возврата для партнеров BroadCloud выглядит следующим образом:
- Откройте заявку в Cisco TAC, чтобы запросить возврат устройства.
- Запустите инструмент перемещения устройства в режиме возврата:
- Номера телефонов будут отменены для использования в Webex Calling, оставив пользователям и службам только добавочные номера.
- Адреса электронной почты в Webex Calling будут преобразованы во временные адреса электронной почты.
- Телефоны будут удалены из Webex Calling.
- Номера телефонов, адреса электронной почты, используемые в качестве альтернативных идентификаторов, и телефоны будут воссозданы в BroadCloud.
- Телефоны будут перезагружены.
- Администраторы партнеров должны перенести телефонные номера PSTN обратно в оператора BroadCloud.
Для Cisco BroadWorks и Webex для BroadWorks
Процесс возврата к предыдущей версии для Cisco BroadWorks и Webex для BroadWorks выглядит следующим образом:
- Откройте заявку в Cisco TAC, чтобы запросить возврат устройства.
- Запустите инструмент перемещения устройств в режиме возврата на вторичном сервере приложений BroadWorks, чтобы отменить миграции устройств. Это вернет URL-адрес DMS к URL-адресу DMS поставщика услуг для профилей устройств в Cisco BroadWorks и повторно активирует номера телефонов.
- Команда Webex Calling устанавливает URL-адрес DMS обратно на URL-адрес DMS поставщика услуг в профилях устройств в Webex Calling.
- Администраторы партнеров должны деактивировать или удалить номера телефонов в Webex Calling через портал Control Hub.
- Администраторам партнеров необходимо перенести телефонные номера ТфОП обратно в Cisco BroadWorks.
Инструкции по запуску инструмента перемещения устройства в режиме возврата
Чтобы запустить инструмент перемещения устройства в режиме возврата, выполните следующие действия:
Выполните следующую команду на дополнительном сервере приложений Cisco BroadWorks в каталоге инструмента перемещения устройства:
Откатить профили
./devicemove.sh -input= -revertProfiles
Возврат номеров
./devicemove.sh -input= -revertNumbers
Журналы терминала
При успешном запуске инструмента перемещения устройства для операции отката мы получим следующие журналы в терминале:
Откатить профили
Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
| Device Type | Mac | Version | Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N):
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process
Возврат номеров
Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ? ([Y]es or [N]o):
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully
Приложение
Миграция крупных предприятий
Крупные предприятия, имеющие множество филиалов, не могут перенести все филиалы в течение одного периода обслуживания. Функциональность, описанная в этом разделе, позволяет партнерам переносить несколько местоположений одновременно.
Этапы
Для планирования поэтапной миграции для крупного предприятия используйте следующие шаги:
- Извлеките корпоративные данные из BroadWorks или BroadCloud.
- Запустите инструмент «Преобразование» без опции местоположений для извлеченных данных.
- Найдите раздел Рекомендуемое местоположение для одновременного перемещения в exception_report.txt, чтобы спланировать этапы миграции, получить дополнительную информацию о зависимостях местоположения, изучить файлы списка агентов функций (см. инструмент преобразования ниже).
- Создайте input/locations.csv, изменив locations_to_be_edited.csv.
- Запустите инструмент «Трансформация» еще раз, выбрав нужные местоположения.
- Проверьте exception_report.txt, чтобы выявить любые проблемы зависимости от местоположения для текущей фазы.
- При необходимости исправьте проблемы зависимости от местоположения (изменив location.csv).
- Повторно запустите инструмент Transform, чтобы сгенерировать файл customer.json для текущей фазы.
- Запустите инструмент подготовки для каждого файла customer.json.
- Во время периода обслуживания запустите инструмент перемещения устройства.
- Повторите шаги 4–10 для следующего этапа.
Инструмент преобразования
Для достижения цели поэтапной миграции местоположений на крупном предприятии, как упоминалось выше, добавляется новый файл locations.csv в качестве необязательного входного сигнала (-locations=input/locations.csv) при запуске инструмента преобразования.
Файл location.csv содержит данные, относящиеся к местоположениям. Он переопределяет данные, найденные в input/customers.csv, который в настоящее время содержит как данные о предприятии, так и данные о местоположении.
В следующей таблице приведены подробные данные о location.csv:
Описание |
Значения |
Значение по умолчанию |
Обязательно |
Карты в BroadWorks |
Карты в BroadCloud | |
---|---|---|---|---|---|---|
enterpriseId |
Уникальный идентификатор предприятия |
Да |
serviceProviderId |
Rialto CustomerId | ||
locationId |
Идентификатор местоположения, уникальный в пределах предприятия |
Да |
идентификатор группы |
Rialto SiteId | ||
миграционный статус |
Перенесено ли это местоположение? |
мигрировал, dont_migrate, мигрирующий |
мигрирующий |
Нет | ||
имя |
Название этого места. Оставьте поле пустым, чтобы использовать locationId. |
Нет | ||||
часовой пояс |
Нет | |||||
язык |
Нет | |||||
address1 |
Нет | |||||
address2 |
Нет | |||||
city |
Нет | |||||
state |
Нет | |||||
Почтовый индекс |
Почтовый индекс |
Нет | ||||
country |
2-буквенный код |
Нет |
Файл location.csv можно составить из предварительно заполненного locations_to_be_edited.csv при запуске инструмента Transform на крупном предприятии. Читайте далее, чтобы увидеть примеры.
Файл location.csv является необязательным входным параметром при запуске инструмента преобразования, поэтому инструмент преобразования будет вести себя так же, как и раньше, если выбрана опция -locations=input/locations.csv отсутствует.
Новые выходные файлы
Инструмент преобразования содержит 5 новых выходных файлов:
- locations_to_be_edited.csv — это предварительно заполненный файл со всеми данными о местоположении крупного предприятия, подлежащего миграции.
Пример.
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US
The partners/customers можно использовать его для создания location.csv, чтобы контролировать местоположения, которые будут перенесены для определенного этапа (и обновлять информацию о местоположениях по мере необходимости).
Пример. location.csv сгенерированный из вышеуказанного locations_to_be_edited.csv
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,migrated,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,migrating,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,dont_migrate,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US
Этот location.csvозначает: для этой фазыместоположение auto_mig_ent_grp1 было перенесено, местоположение auto_mig_ent_grp2 переносится, а местоположение auto_mig_ent_grp3 не переносится.
- hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4 файла имеют одинаковое назначение: сгенерировать полные списки соответствующих функций agents/supervisors/originators/targets/monitored_elements в мигрирующих местоположениях, если мигрирующие местоположения имеют зависимости от других местоположений.
Они имеют почти одинаковый формат (имя третьего столбца меняется в зависимости от функции), как показано ниже (список агентов поисковой группыauto_mig_ent_grp2 для вышеуказанной фазы):
Пример. следующее из hunt_group_agents.csv
feature name,feature location,agent,location
Sarah Rodriguez,auto_mig_ent_grp2,agent_michael@domain.com,auto_mig_ent_grp1
Sarah Rodriguez,auto_mig_ent_grp2,agent_sally@domain.com,auto_mig_ent_grp1
Если при запуске инструмента «Преобразование» опция местоположений отсутствует, указанные выше 4 файла сгенерируют полные списки hunt-group/call-center/paging-group/busy-lamp-field’s agents/supervisors/originators/targets/monitored_elements для всего предприятия, что может быть использовано для планирования поэтапных миграций.
Новые разделы в exception_report
При выполнении поэтапной миграции для крупных предприятий в exception_report.txt появятся новые разделы, если существуют невыполненные зависимости от местоположения.
Пример. Следующий новый раздел предназначен для группы поиска Сары Родригес в локации auto_mig_ent_grp2, которая находится в локации auto_mig_ent_grp3 и не мигрирует в этой фазе.
Dependencies between locations - Hunt groups
Name Location Agent Agent's Location Comment
________________________________________________________________________________________________________________
Sarah Rodriguez auto_mig_ent_grp2 agent_william@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet
Sarah Rodriguez auto_mig_ent_grp2 agent_melody@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet
В следующем новом разделе даются рекомендации по группировке местоположений на этапах миграции.
Рекомендуемые места для одновременного перемещения:
Location auto_mig_ent_grp1 has dependency on location(s) auto_mig_ent_grp2, auto_mig_ent_grp3
Location auto_mig_ent_grp2 has dependency on location(s) auto_mig_ent_grp3
Если при запуске инструмента «Преобразование» параметр местоположений отсутствует, в разделе «Рекомендуемые местоположения для одновременного перемещения» перечислены все зависимости местоположений для удобства планирования.
При запуске инструмента «Преобразование» с опцией местоположений (например, для фазы миграции) в разделе «Рекомендуемые местоположения для одновременного перемещения» перечислены только зависимости местоположений для текущей фазы.
Инструмент подготовки
Для крупных предприятий инструмент подготовки можно запустить в обычном режиме.
Инструмент перемещения устройства
Инструмент перемещения устройства может работать для подмножества местоположений из customer.json. Для этого добавьте новый необязательный файл location.csv, который состоит из двух столбцов.
External_id |
МестоположениеИмена |
---|---|
Значение внешнего идентификатора |
Имена locations/group имена |
- Это необязательный файл. Если он не указан или указан с пустыми значениями, будут перенесены все местоположения.
- Если указаны названия местоположений и их соответствующие external_идентификаторы, то будут перенесены только эти местоположения.
Команда выглядит следующим образом:
./devicemove.sh -input=/customer.json -locations=/Location_names.csv
Часовые пояса
США:
"timeZones":["America/Adak","America/Anchorage","America/Chicago","America/Denver","America/Los_Angeles","America/New_York","America/Phoenix","Pacific/Honolulu"]
Канада:
"timeZones":["America/Dawson_Creek","America/Edmonton","America/Halifax","America/Montreal","America/Regina","America/St_Johns","America/Vancouver","America/Winnipeg"]
Австралия:
"timeZones":["Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Hobart","Australia/Lord_Howe","Australia/Perth","Australia/Sydney"]
Франция:
"timeZones":["Europe/Paris"]
Португалия:
"timeZones":["Atlantic/Azores","Europe/Lisbon"]}
Великобритания:
"timeZones":["Europe/London"]
Италия:
"timeZones":["Europe/Rome"]
Германия:
"timeZones":["Europe/Berlin"]