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

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

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

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

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

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

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

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

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

Windows.

token_generator.bat

MacOS.

./token_generator.sh

Вывод:

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

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

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

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

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

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

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

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

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

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

Чтобы изменить каталог 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> 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.

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

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

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

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

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

Этап 2. Выполните команду активации:

AS_CLI> set dnMode groupAndUserActivationEnabled

Этап 3. В окне подтверждения введите значение Y.

Для BroadCloud

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

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

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

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

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

Для Cisco BroadWorks и Webex для BroadWorks

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

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

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

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

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

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

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

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

   JAVA_HOME=/usr/local/java/java_base

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

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

./export.sh

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

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

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

Результат

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

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

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

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

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   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
10. Функция синхронизации сетевого сервера позволяет администраторам выполнять подготовку номеров телефона, MAC-адресов и адресов электронной почты пользователей во время подготовки в одном и том же регионе. Чтобы включить его, установите USE_NS_SYNC=yes в conf/partner.cfg.

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

Заполнение поля ввода/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
   python3 -m pip install phonenumbers
   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exception Report
Tue Oct 18 08:12:09 2022

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

Результат

Файл вывода JSON (customer.json) будет доступен в каталоге output/<timestamp>/<groupid> . Пример файла customer.json приведен ниже.

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

Инструмент подготовки может работать на любой машине, как правило, на ноутбуке администратора партнера, и использует общедоступные API Webex. В нем считывается выходной файл инструмента преобразования JSON (customer.json) в виде ввода и подготовки клиентов, местоположений, номеров, пользователей, служб и устройств в решении Webex Wholesale RTM.

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

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

1. Установите Java 8, 11, 17 или 21 на компьютер. Java доступен из многих источников, включая:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. После скачивания и извлечения двоичных файлов инструментов миграции задайте переменную среды JAVA_HOME в provisioning_tool.sh для MAC и provisioning_tool.bat для Windows.
3. Файл partner.cfg:
   • Задайте идентификатор WHOLESALE_PROVISIONING_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.
6. Функция синхронизации сетевого сервера позволяет администраторам выполнять подготовку номеров телефона, MAC-адресов и адресов электронной почты пользователей во время подготовки в одном и том же регионе. Чтобы включить его, установите USE_NS_SYNC=yes в conf/partner.cfg.

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

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

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

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

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

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

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

Windows

Для запуска инструмента в ОС Windows выполните следующие действия:

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

MacOS

Для запуска инструмента на macOS выполните следующие действия:

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

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

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

После обновления шаблона подключения Webex для BroadWorks для поддержки миграции попросите команду по работе с учетными записями Cisco включить переключатель функции "Wholesale-partner-blending-enabled" на уровне партнера. Это позволит добавлять пакеты Wholesale в существующие клиентские организации Webex для BroadWorks во время подготовки.

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

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

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

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

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

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

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

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

Результат

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

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

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

Рисунок 9. Control Hub

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

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

Для BroadCloud

Для партнеров BroadCloud отправьте запрос на миграцию номеров, устройств и SCA на портале поставщика услуг.

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

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

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

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

Рисунок 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:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

   Если администраторы хотят отправить электронные приглашения пользователям во время миграции, они должны оставить комментарий к свойству "ОТПРАВИТЬ ПОВТОРНО_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 в каталоге инструмента перемещения устройства:

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

Результат

После миграции устройств устройства стали онлайн и готовы совершать и принимать вызовы. Пример состояния устройства см. на рисунке 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

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

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

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

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