Благодарим за обратната връзка.

Поддържаните телефони ще бъдат автоматично създадени и присвоени на потребителите Webex Calling чрез инструмента за осигуряване. Телефоните, маркирани с „да“ в колоната „Поддържа се в инструмента за преместване на устройството“, също ще бъдат автоматично преместени от Cisco BroadWorks или BroadCloud към Webex Calling когато инструментът за преместване на устройството се стартира. Телефоните, маркирани с „Не“ в тази колона, се нуждаят от ръчна намеса, за да променят DMS URL адреса в шаблона на устройството Cisco BroadWorks или в самия телефон .

Последната колона предоставя картографирането на моделите на телефони в колоната „Тип устройство“ на файла transform-tool/input/newphones.csv. (Вижте раздела Инструмент за трансформи ране на тази статия за повече информация относно newphones.csv).

Администраторите на партньорите стартират този инструмент за генериране на токени поне веднъж, преди да започнат да изпълняват инструменти за мигриране. Стартирането на този инструмент е еднократна дейност, след като ака унтът на партньора бъде включен в решението RTM на едро. Този инструмент позволява на администраторите на партньори да влизат чрез уеб браузър, за да получат уникалния TOKEN, който е необходим за актуализация до конфигурационните файлове на партньора за инструментите за мигриране.

Предпоставки

Инсталирайте 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

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

Инструкции за стартиране

Изпълнете следната команда в терминала в директорията на генератора на токени:

Прозорци:

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 адреса в уеб браузъра на терминала, влезте с идентификационните данни на администратора на партньора, за да получите TOKEN и копирайте същия за по-нататъшно използване.

Илюстрациите на потребителския интерфейс са дадени по-долу за справка:

Фигура 3: Вход с Cisco Webex

Фигура 4: Прозорец за идентификационни данни

Фигура 5: Генериране на токени

Конфигурирайте следните стъпки, преди да стартирате инструментите за извличане и преместване на устройството във вторичния сървър 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 прокси сървъра.

Променете директорията на 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.

Промяна в директорията за осигуряване:

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. Администраторът на доставчика на услуги може:

1. Подайте заявки за извлечение за до 50 клиенти на заявка.
   Заявката за извлечение не може да бъде подадена за един и същ клиент повече от 10 пъти на ден.
2. Изтеглете извлечения файл с данни във формат ZIP до 28 дни от датата на подаване на заявката.

Следните цифри показват портала на Доставчика на услуги.

Фигура 6: Портал за доставчици на услуги

Фигура 7: Портал за доставчици на услуги

Искане за извлечение от CSV

Инициирайте заявка за изв личане

1. Изтеглете CSV на клиента

   Щракнете върху връз ката Изтегляне на CSV на клиента в горния десен ъгъл на секцията Иницииране на заявка за извличане на CSV.

2. Редактиране на списъка с клиенти

   Администраторът може да редактира този CSV файл, за да включва само клиентите, за които трябва да се извърши извличането.

3. Качване и изпращане

   След редактиране качете модифицирания CSV.

   Щракнете върху Из пращане, за да инициирате заявка за извлечение за изброените клиенти и свърз аните с тях местоположения.

Иницииране на заявка за извлечение за клиент с местоположения CSV

1. Изберете клиент и местоположения за изтегляне

   Изберете клиент от падащото меню.

   Изтеглете съответния locations.csv от раздела Преглед на клиенти → Сайтове → Ек спортиране на местоположения като CSV.

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

   Администраторът може да редактира CSV, за да включва само местоположенията, които желаят да извлечат.

3. Качване и изпращане

   Качете редактирания locations.csv и щракнете върху Из пращане.

   Само посочените места за избрания клиент ще бъдат включени в заявката за извлечение.

Инициирайте заявка за извлечение за всички клиенти

1. Щракнете върху Изпращане, за да инициирате заявка за извлечение за всички клиенти и всичките им место положения под текущия доставчик на услуги.

За Cisco BroadWorks и Webex за BroadWorks

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

Следващите раздели обясняват как да инсталирате и конфигурирате инструмента за извличане.

Предпоставки

1. SCP бинарните файлове на инструмента за извличане към вторичен сървър за приложения на Cisco BroadWorks.
2. SSH към вторичния Cisco BroadWorks Application Server, за да конфигурирате предпоставките и да стар тирате инструмента за извличане.
3. Конфигурирайте доставчика на услуги и идентификатора на групата за извличане от Cisco BroadWorks в Conf/ExportTool.ym l. Вижте следния извадков фрагмент от YAML :

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

4. Уверете се, че вторичният потребителски идентификатор на Cisco BroadWorks Application Server, паролата и името на хоста са правилни във файла conf/partner.cfg:

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

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

5. Променете пътя на средата JDK/JRE във файла export.sh, ако вторичният път на средата на Cisco BroadWorks Application Server JDK/JRE е различен от файла:

   JAVA_HOME=/usr/local/java/java_base

Инструкции за стартиране

Изпълнете следната команда във вторичния Cisco BroadWorks Application Server от директорията с инструменти за извличане:

./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_ .zip<timestamp>) файл е наличен в същата директория с инструменти за извличане. Използвайте следната команда, за да видите и използвате 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

Ако администраторът работи с инструмента зад корпоративен прокси сървър, следвайте стъпките по-долу, за да конфигурирате и изпълните скрипта за експортиране.

Стъпки за конфигуриране и изпълнение на скрипта за експортиране

1. Отворете файла export.sh.
2. Намерете променливата HTTPS_PROXY_HOST и я премахнете коментирането (премахнете водещия #).

3. Задайте стойността HTTPS_PROXY_HOST като:

   HTTPS_PROXY_HOST=<proxy-host>

4. Намерете променливата HTTPS_PROXY_PORT и я премахнете коментирането (премахнете водещия #).
5. Задайте стойността HTTPS_PROXY_PORT като:

   HTTPS_PROXY_PORT=<proxy-port>

6. Запазете и затворете файла export.sh.
7. Отворете файла partner.cfg и добавете необходимия refresh _token.
8. Проверете дали хостът, потребителското име и паролата на BroadWorks са правилно конфигурирани в partner.cfg.
9. Стартирайте скрипта:

   ./export.sh

Форма за ангажиране:

Инструментът за извличане (BroadCloud и BroadWorks) вече автоматично генерира консолидиран XLSX файл, озаглавен Engagement Form SUA.xlsx по време на изпълнение. Файлът е предварително попълнен с всички налични данни в съответните работни листове, което помага за рационализиране и ускор яване на завършването на партньорите.

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

Предпоставки

След като изтеглите и извлечете двоичните файлове на инструментите за мигриране, конфигурирайте следните предпоставки:

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. По желание зададете PROVISIONING_ID (копиран от шаблона в Partner Hub) във файла conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   За да получите по-пълна проверка на имейл адреса на клиента, можете по желание да зададете PROVISIONING_ID.
3. Конфигурирайте липсващата информация във файла input/customers.csv (вижте следващия раздел), ако липсва.
4. Добавете имейл адреса на крайния потребител във файла input/users.csv.
5. Ако трябва да бъдат предоставени нови телефони, добавете mac адреса и имейл адреса на новия телефон на потребителя във файла input/newphones.csv. Това се изисква само ако партньорските администратори искат да предоставят нови телефони при разговори на едро.
6. Конвертирайте телефонните центрове на BroadWorks в CXEssentials, като използвате файла input/cxessentials.csv.
7. По желание активирайте свойството UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, за да конвертирате всички телефонни центрове в CXEssentials.
8. Използвайте файла input/locations.csv, за да поддържате миграцията на големи предприятия, която позволява на администраторите да мигрират местоположенията на клиентите си по местоположение
9. По желание активирайте използването на MAC адреси от заглавката User-Agent на съобщението SIP REGISTER, когато MAC адресът не е наличен в профила на устройството на Cisco BroadWorks . Премахнете коментара от реда Use_MAC_Address_FROM_SIP_REGISTER=Да във файл conf/partner.cfg
10. По желание активирайте свойствата ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_ MUSIC_ON_HOLD и ANALOG_USER_TYPE_DISABLE_T38, за да конфигурирате изчакване на повикване, музика в задържане и деактивиране на настройките на T38 за всички потребители от аналогов тип.

11. Ако искате да настроите общи шлюзови устройства, добавете MAC адреса на устройството и потребителския идентификатор към файла input/genericgateways.csv. Също така споменете дали потребителят е ОСНОВЕН собственик или СПОДЕЛЕН потребител (за споделени показвания на повиквания). Това е необходимо само ако администраторите на партньорите планират да използват общи шлюзови устройства в разговорите на едро.

    Тази функция не е налична за миграциите на BroadCloud към едро .

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

    По желание активирайте свойството COMMON_VOICE_MAIL_GROUP_PASSCODE в partner.cfg, за да конфигурирате ПИН ко да по подразбиране за групите гласова поща.

    Ако това свойство не е посочено в partner.cfg, то трябва да бъде предоставено на клиент във файла customers.csv под колоната CommonVoicEmailGroupPasscode.

13. За миграция на общи контакти към Webex Calling

    Това е подобрение за управление на общите контакти на ниво предприятия и обект. Тези контакти вече могат да бъдат мигрирани или като контакти на организацията (Орг Контак ти) или като виртуални разширения въз основа на настройките за конфигурация. По-долу са подробностите, които ще ви насочат през този процес на миграция.

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

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Н ово свойство, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, се въвежда във файла partner.cfg. Това свойство определя как общите контакти се мигрират от Риалто към. Webex Calling

    • Без конфигуриран COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Общите контакти ще бъдат мигрирани като организационни контакти (Орг Контакти).

      Не се изисква допълнителна конфигурация.

      Контактите остават достъпни на ниво организация.

    • С конфигуриран COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Общите контакти ще бъдат мигрирани като виртуални раз ширения.

      Всеки контакт ще бъде добавен с номер на разширение , а началният диапазон на разширението се дефинира в свойството COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION _START_RANGE в partner.cfg.

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

14. Активирайте доставчика по подразбиране за запис на повиквания към Webex.

    Тази стъпка е необходима само при мигриране на настройките за запис на повиквания за потребители, конфигурирани с Dubber към Cisco Native Call Record ing в Webex.

    За да активирате тази опция:

    • Във файла partner.cfg задайте следното свойство, DEFA ULT_CALL_RECORDING_VENDOR=Webex.
    • Освен това използвайте свойството WEBEX_CALL_RECORDING_STORAGE_REGION, за да конфигури рате региона за съхранение.

      Опцията за запи с по заявка от BroadCloud не се поддържа вWebex Calling. Тези настройки за запис на повиквания няма да мигрират и ще се появят в отчета за изключения.

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

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

    • Първоначално изпълнете инструмента за трансформиране за първи път. След завършване инструментът ще генерира файл с име telephone_numbers_inventory.csv, разположен в директорията output/timestamp/. Клиентът е длъжен да прегледа този файл и да посочи „Да“ в колоната „Drop Tn's“ за всеки телефонен номер, който трябва да бъде изключен от предстоящата миграция.
    • След актуализиране на файла telephone_numbers_inventory.csv със съответните флагове за изключване, инструментът за трансформиране се изпълнява втори път. Актуализираният файл трябва да бъде предаден като аргумент в следния формат.

      . /transform.sh -екстракт = входни/извлечени данни_1747640608219.zip -номера за извеждане от експлоатация = {filepath/telephone_numbers_inventory.csv}

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

    Този раздел очертава миграцията на функцията BroadWorks Mobility (мобилни номера на клиенти) от BroadCloud (Интеграция на мобилна мрежа) към търговия на едро Webex Calling (оператор на мобилна мрежа Webex Go).

    Предпоставки - Преди да започнат процеса на мигриране, администраторите на партньорите трябва да се свържат с екипа на Cisco Account, за да извършат конфигурацията на доставчика на PSTN (CCP), свързан с облака (CCL) и персонализиран списък на оператори (CCL).

    Ново свойство, ASSIGN_MOBILE_NUMBERS_TO_USERS, се добавя към файла partner.cfg. Активирайте това свойство, за да позволите на мобилните номера да бъдат присвоени и мигрирани към потребителите.

    • Тази функция се поддържа само за миграции от Broadcloud към едро.
    • В Webex на едро крайните потребители могат да имат или мобилен номер, или PSTN номер (не и двата), за разлика от BroadCloud.
    • Когато мобилен номер е присвоен на потребител, първичният му PSTN номер става вторичен (алтернативен) номер.
    • Мобилните номера не могат да бъдат мигрирани за потребители, които се преобразуват в работни пространства или виртуални линии.
    • След като мобилен номер бъде зададен в Wholesale Webex, той ще се покаже като активен в контролния център. Това състояние не означава, че номерът е готов веднага да приема обаждания. Възмож ността за повикване ще бъде достъпна само след като миграцията при ключи напълно.
    • Настройките за интеграция на мобилни телефони, конфигурирани от крайните потребители в портал а за повикващи се потребителски услуги (CUP), не се мигрират. След мигрирането, когато се извика телефонен номер, мобилен номер или разширение, всички устройства на потребителя ще звъннат.

18. За да конфигурирате по желание ограниченията за количеството пакети по време на мигри рането на клиента, посочете количеството за всеки пакет във файла input/package_quantity.csv. Конфигурираното количество пакети трябва да бъде по-голямо или равно на броя на зададените пакети на потреб ителя/работното пространство.

    Понастоящем ограниченията за количеството пакети не се поддържат за миграциите на Webex за BroadWorks към едро.

    Когато стартирате инструмента за трансформиране, предоставете актуализирания файл като входен параметър:. <extract_zip_file>/transform.sh -extract= -packagelimits=вход/количествене_пакет.csv .

19. Мигрирайте сайтове от множество клиенти от Broadworks/BroadCloud в един клиент в търговия на едро Webex Calling
    • Нов режим на изпълнение, -ConsolidatedMigration, е въведен в инструмента Transform, за да поддържа мигрирането на множество клиентски сайтове от Broadcloud/Broadworks към платформата на едро на Webex в рамките на една организация за клиенти на едро. Когато този режим е активиран, инструментът консолидира множество клиентски сайтове в една организация за клиенти на едро

      -consolidatedMigration

    • Има и други незадължителни аргументи, които могат да бъдат дадени заедно с -ConsolidatedMigration като например

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

    • ако е даден -TargetEnterpriseID и идентификаторът съществува в изходния файл на инструмента за извличане, той ще бъде използван за създаване на организацията на клиенти на едро и ако идентификаторът не бъде намерен, инструментът ще се върне, за да използва всички налични данни за клиента от изходния файл на инстру мента Extract.
    • ако е даден -ConsolidateDexternalID, той ще зададе ExternalID за клиента и ако не бъде даден, инструмент ът ще се върне, за да използва съществуващия поток за външен идентификатор.
    • <timestamp>Консолидиран JSON (customer.json) файл ще бъде наличен в изходната директория/ /konsoli duota.

Попълване на input/customers.csv

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

Таблицата по-долу обяснява най-важните колони в input/customers.csv.

Попълване на input/users.csv

Файлът input/users.csv предоставя данни, които може да липсват в Cisco BroadWorks или BroadCloud. Този файл може да бъде оставен празен, ако цялата задължителна информация вече е налична. Не е нужно да попълвате всички колони, само липсващата информация е задължителна.

Инструкции за стартиране

Стартирайте инструмента за трансформиране във всяка операционна система. Използвайте стъпките по-долу, за да стартирате инструмента в Windows и macOS:

Прозорци

Изпълнете командата по-долу, за да стартирате инструмента за трансформиране в Windows:

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

макос

Изпълнете следните стъпки, за да стартирате инструмента за трансформиране на macOS:

1. Създайте виртуална среда и инсталирайте зависимости, за да стартирате инструмента за трансформиране с помощта на Python:

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

2. Стартирайте инструмента за трансформи ране:

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

Предварителна проверка на клиент/потребител

Инструментът за трансформиране осъществява API обаждания към Webex, за да улови потенциални проблеми с предоставянето на услуги. По подразбиране той ще потвърди адреса на клиента и основния имейл. Ако стойността PROVISIONING_ID е посочена във файла 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/ /exception_report.txt<timestamp>. Можете да използвате този отчет, за да идентифицирате проблемите, които ще повлияят на миграцията и да ги коригирате в системата 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

Изход

<timestamp><groupid>Изходен JSON (customer.json) файл ще бъде наличен в директорията output//. Пример ният клиент.json файл е както следва:

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

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

Предпоставки

Конфигурирайте следните предпоставки в директорията с инструменти за осигуряване:

1. Инсталирайте Java 8, 11, 17 или 21 на компютъра. Java е достъпна от много източници, включително:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. След като изтеглите и извлечете двоичните файлове на инструментите за миграция, задайте променливата среда JAVA_HOME в provisioning_tool.sh за MAC и provisioning_tool.bat за Windows.
3. Файлът partner.cfg:
   • Задайте WHOLESALE_PROVISIONING_ID и REFRESH_TOKEN (Токен, копиран от инструмента за генериране на токени). Администраторите на партньорите трябва да се свържат с екипа си по акаунта, за да получат PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Задайте HEND_SUBSCRIBERS_WELCOME_EMAIL на фалшив, ако партньорите не искат да изпращат имейл за добре дошли до потребителите. Стойността по подразбиране е вярна.

     Webex изпраща имейли за добре дошли само до крайните потребители. Администраторите на клиентите не получават имейли за добре дошли.

     Потребителите и администраторите на клиенти, базирани в САЩ и Канада, получават отделно имейл уведомление от RedSky. Плат формата RedSky E911 изпраща този имейл, за да потвърди създаването на клиентския акаунт за спешни услуги. Този имейл на RedSky е отделен от имейлите за добре дошли на Webex и не се контролира от настройките за имейл на Webex. За организациите на едро в САЩ и Канада RedSky автоматично се активира като доставчик на спешни услуги.

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

   Нов имот, APPLY_WHOLESALE_DISCOUNTS е добавен към partner.cfg. Активирайте това място за настаняване, за да прилагате отстъпки за потребители и работни пространства.

8. (Незадължително) Изрично конфигурирайте PSTN връзката

   За да зададете PSTN връзката за всички местоположения, предоставени по време на мигрирането, включително основното местоположение, добавете следното свойство към файла partner.cfg:

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

   Ако свойството не е конфигурирано или е коментирано, инструментът за осигуряване използва процеса по подразбиране на избор на връзка PSTN.

Инструкции за стартиране

Използвайте следните стъпки, за да стартирате инструмента в Windows и macOS:

Прозорци

Изпълнете следните стъпки, за да стартирате инструмента в опера ционна система Windows:

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

макос

Изпълнете следните стъпки, за да стартирате инструмента в macOS:

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

Предпоставки за Webex за миграция на BroadWorks

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

След като шаблонът за внедряване на Webex за BroadWorks бъде актуализиран, за да поддържа миграцията, поискайте екипа за акаунти на Cisco да активира превключването на функцията „смесване на едро“ на ниво партньор. Тази настройка позволява на инструмента за осигуряване автоматично да добавя пакети на едро към съществуващите Webex за клиенти на Broad Works по време на предоставянето.

Стартирайте инструмента за осигуряване с допълн ителен аргумент.

Фаза на подготовка: е фаз ата по подразбиране, при която администраторите могат да предоставят потребителите на BroadWorks като абонат на едро и да продължат с Webex за потребителите на BroadWorks.

Фаза на поддръжка: е втората фаза, при която администраторите могат да възложат лиценза на едро на съществуващия Webex за потребители на BroadWorks. Трябва да стартирате инстру мента за осигуряване с поддръжка на аргументи.

Фаза след миграция : Това е последната фаза, когато администраторите могат напълно да конвертират BroadWorks в търговия на едро. Трябва да стартирате инструмента за предоставяне с аргумент след миграция.

Терминални дневници

Следват дневниците в терминала за успешно предоставяне на услуги:

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

Ще бъде отпечатана таблица с броя на местоположенията, създадени за всяко изпълнение:

Изход

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

Системата ще генерира файл Provisioning_Report_*.csv в директорията output/konsolidated_report s/. Този файл съдържа както подробности за успеха, така и за неуспеха за всяко предприятие и неговите настройки, предоставяйки изчерпателен отчет за предоставяне на услуги.

Инструментът за осигуряване също генерира файл Provision ing_Statistics_*.csv в директорията output/konsolidated_reports/. Този отчет съдържа броя на успешно и неуспешно предоставени клиенти, местоположения, потребители, устройства и групови функции.

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

Фигура 8: Партньорски център

Фигура 9: Контролен хъб

Фигура 10: Устройства

Фигура 11: Обаждане

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

След като осигуряването приключи за миграция на BroadCloud, следните действия ще бъдат блокирани:

• CAP Portal — Добавяне на потребители или портирани устройства.
• SP Portal — Създаване на ADD поръчки с устройства или номера.
• RSB API — Съ здаване на ADD поръчки с устройства или номера и създаване на потребители. Поръчките на R SB ADD, направени с устройства или номера, ще бъдат отхвърлени.

Миграция на BroadCloud към едро — ограничение за регистрация на устройства

За администраторите на партньори, които мигрират клиенти от BroadCloud към търговия на едро в същия регион, устройствата могат да бъдат добавени в търговия на едро след стартиране на инструмента за осигуряване. Тези устройства обаче ще могат да се регистрират в платформата Webex едва след приключване на миграцията (преместването на устройството) за съответното местоположение.

Това ограничение не се прилага за:

• Клиенти, мигриращи от Broadworks/W4b към търговия на едро.
• BroadCloud към миграции на едро в различни региони.

Препоръчителни насоки

За да избегнете проблеми с регистрацията на устройството, завършете миграцията на преместване на устройството на ниво местоположение, преди да опитате да регистрирате устройства към платформата Webex за миграции от BroadCloud към едро в същия регион.

За БродКлоуд

За партньорите на BroadCloud използвайте портала на доставчика на услуги, за да подадете заявка за мигриране за миграции на номера, устройства и споделени показания на повиквания (SCA).

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

Администраторите могат да активират автоматично връщане, като зададат rollback_to_broadcloud=true във файла conf/partner.cfg, който премества устройствата обратно в BroadCloud след мигрирането. Той поддържа миграции от един и съ щи и различен регион с NS Sync, но само за успешни миграции. При неуспешни админи страторите трябва да повдигнат a, Cisco TAC преди да поискат връщане.

Н алични са две опции за избор на типа миграция в портала:

• Мигра ция — изберете тази опция, за да инициирате заявка за мигриране на номера, устройства и показания за споделени повиквания (SCA).
• Състоя@@ ние на устройството — Изберете тази опция, за да видите текущото състояние на устройство в BroadCloud и Calling.

Следните цифри показват портала на Доставчика на услуги.

Фигура 12: Портал за доставчици на услуги

Фигура 13: Портал за доставчици на услуги

Мигри ране на избрани место положения (по избор)

За да започнете мигрирането за конкретен поднабор от местоположения, изброени във файла customer.json, включете файл locations.csv към заяв ката си. Този CSV трябва да изброява само местоположенията, които възнамерявате да мигрирате.

За да изтеглите списъка с налични активни сайтове, отидете на Пре глед на клиенти → Избор на клиент → Ек спортиране на местоположения като CSV.

Фигура 14: Експортиране на местоположения като CSV

Активирайте опцията за прекъсване на номера

Когато използвате същия SIP багажник за Webex Calling и BroadCloud Carrier, администраторите трябва да използват опцията Изключ ване на номера. Това премахва телефонните номера от получаване на входящи повиквания след мигриране в BroadCloud.

За да активирате тази опция,

1. Във файла partner.cfg задайте DISCONNECT_NUMBERS_FROM_RIALTO = да.
2. Стартирайте отново инструмента за мигриране, като използвате същия клиент .json файл и актуализи рания partner.cfg.

Ако номерата не успеят да прекъснат връзката, повдигнете искане на Cisco TAC.

За Cisco BroadWorks и Webex за BroadWorks

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

При успешна работа инструментът за преместване на устройството ще:

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

6. Ако администраторът работи с инструмента зад корпоративен прокси сървър, следвайте стъпките по-долу, за да конфигурирате и изпълните скрипта за предоставяне.

   Процедура за конфигуриране

   1. Отворете файла devicemove.sh.
   2. Намерете променливата PROXY_HOST и я премахнете коментирането (премахнете водещия # за devicemove.sh).

   3. Задайте стойността PROXY_HOST като:

      PROXY_HOST=<proxy-host>

   4. Намерете променливата PROXY_PORT и я премахнете коментирането (премахнете водещия # за devicemove.sh).

   5. Задайте стойността PROXY_PORT като:

      PROXY_PORT=<proxy-port>

   6. Моля, намерете променливата PROXY_SCHEME и я премахнете коментирането (премахнете водещия # за devicemove.sh). Тази стъпка не е задължителна; ако остане коментирана, стойността по подразбиране за PROXY_SCHEME ще бъде HTTP.

   7. Задайте стойността PROXY_SCHEME като:

      PROXY_SCHEME=<proxy-scheme>

   8. Запазете и затворете файла devicemove.sh.
   9. Отворете файла partner.cfg и добавете необходимия refresh _token.
   10. Проверете дали хостът, потребителското име и паролата на BroadWorks са правилно конфигурирани в partner.cfg

   11. Стартирайте скрипта:

       ./devicemove.sh

SCP и SSH

1. SCP инструмента за преместване на устройството към вторичния сървър за приложения на Cisco BroadWorks.
2. SSH към вторичния Cisco BroadWorks Application Server, за да конфигурирате предпоставките и да стартирате инструмента за преместване на устройството.

Предпоставки

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Уверете се, че вторичният потребителски идентификатор на Cisco BroadWorks Application Server, паролата и името на хоста са правилни във файла conf/ DeviceMovetool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. За да изпратите отново имейли за активиране, трябва да зададете send_subscribers_welcome_email=True във файла conf/partner.cfg.

   Ако администраторите желаят да изпращат имейли с покана до своите потребители по време на мигрирането, те трябва да премахнат коментара от свойството „send_subscribers_welcome_email=true“ във файла conf/partner.cfg. В противен случай имотът трябва да остане непроменен.

4. Проверете дали пътят на средата JDK/JRE е правилен в devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Поликом телефони

За да преместите телефоните на Polycom от Cisco BroadWorks към обаждания на едро, партньорският администратор трябва да създаде нов файл за идентичност/профил на устройство на системно ниво в Cisco BroadWorks за всеки шаблон на устройство Polycom. Вижте фигура 14 и качете персонализирания файл Device-move-tool/conf/deviceprofile/ {region} /polycom_vvx.cfg. След като качите новия файл на устройството, уверете се, че новосъздаденият файл съществува на ниво група. Също така се уверете, че миграцията на файлове_%BWMAC адресът %.cfg не противоречи на нито един съществуващ файл във вашата система).

Използва се вътрешно от инструмента за преместване на устройството.

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

1. Инструментът за преместване на устройството замества файла %BWMAadress%.cfg на ниво устройство с polycom_vvx2.cfg. Този файл се отнася до миграция_%BWMAAddress%.cfg.
2. Възстановяване на профилите на устройството на ниво група или на ниво устройство.
   Действието на ниво група или ниво устройство зависи от конфигурацията на параметъра DeviceLevelRebuild във файла device-move-tool/conf/partner.cfg.
3. Инструментът за преместване на устройството иска от Cisco BroadWorks Application Server да рестартира телефон ите на ниво група или на ниво устройство.
4. След заявката за рестартиране телефоните на Polycom изтеглят и обработват% BWMAadress%.cfg, което иска телефоните на Polycom да изтеглят и обработят Migration_%BWMAadress%.cfg, което задава девице.prov.ServerName на https://plcm.sipflash.com.
   https://plcm.sipflash.com за региона на САЩ, други региони имат различни URL адреси.
5. Телефонът на Polycom изтегля %BWMAAddress%.cfg от https://plcm.sipflash.com и ще се управлява от DMS. Webex Calling

Фигура 14: Добавяне на файл за идентичност/тип профил на устройството

Инструкции за стартиране

Има два метода за извикване на DMT, първият е да се извиква чрез един клиент наведнъж, а другият е да се изпълнява през няколко клиенти едновременно.

Инструментът за преместване на устройството се изпълнява от вторичния Cisco BroadWorks Application Server в директорията с инструменти за преместване на устройството:

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

Терминални дневници

Следват дневниците в терминала при успешно стартиране на инструмента за преместване на устройството за мигриране на устройството:

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

Изход

След мигрирането на устройството устройствата са влезли онлайн и са готови за осъществяване/получаване на обаждания. Вижте фигура 15, за да видите пример за състоянието на устройството :

Фигура 15: Състояние на устройството

След мигрирането на устройството номерата са активни. Вижте фигура 16, за да видите пример за това какви числа са активни:

Фигура 16: Активни числа

Ако администраторът работи с инструмента зад корпоративен прокси сървър, следвайте стъпките по-долу, за да конфигурирате и изпъл ните скрипта devicemove.

Стъпки за конфигуриране и изпълнение на скрипта devicemove

1. Отворете файла devicemove.sh.
2. Намерете променливата HTTPS_PROXY_HOST и я премахнете коментирането (премахнете водещия #).

3. Задайте стойността HTTPS_PROXY_HOST като:

   HTTPS_PROXY_HOST=<proxy-host>

4. Намерете променливата HTTPS_PROXY_PORT и я премахнете коментирането (премахнете водещия #).
5. Задайте стойността HTTPS_PROXY_PORT като:

   HTTPS_PROXY_PORT=<proxy-port>

6. Запазете и затворете файла devicemove.sh.
7. Отворете файла partner.cfg и добавете необходимия refresh _token.
8. Проверете дали хостът, потребителското име и паролата на BroadWorks са правилно конфигурирани в partner.cfg.
9. Стартирайте скрипта:

   ./devicemove.sh

Операцията за връщане трябва да се изпълнява за едно предприятие наведнъж.

За оператора на BroadCloud

Администраторите могат да зададат rollback_to_broadcloud= true в conf/partner.cfg, за да активират автоматично връщане. Това връща устройствата в BroadCloud след успешна миграция в същия или междурегион с NS Sync. За неуспешни миграции се свържете, Cisco TAC преди да поискате връщане.

За Cisco BroadWorks и Webex за BroadWorks

Процесът на връщане за Cisco BroadWorks и Webex за BroadWorks е както следва:

1. Отворете билет с, Cisco TAC за да поискате връщане на устройството.
2. Стартирайте инструмента за преместване на устройството в режим на връщане на вторичния BroadWorks Application Server, за да върнете миграциите на устройството. Това ще зададе DMS URL адреса обратно към DMS URL адреса на доставчи ка на услуги за профили на устройства в Cisco BroadWorks и ще активира отново телефонните номера.
3. Еки Webex Calling път задава DMS URL адреса обратно към DMS URL адреса на доставчика на услуги в профилите на устройствата в. Webex Calling
4. Администраторите на партньорите трябва да деактивират или изтрият телефонните номера в портала Webex Calling чрез контролния център.
5. Администраторите на партньорите трябва да преместят телефонните номера на PSTN обратно в Cisco BroadWorks.

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

Следвайте стъпките по-долу, за да стартирате инструмента за преместване на устройството в режим на връщане:

Изпълнете командата по-долу във вторичния Cisco BroadWorks Application Server в директорията с инструменти за преместване на устройството:

Връщане на профили

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

Връщане на числа

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

Терминални дневници

Ще получим следните дневници в терминала при успешно стартиране на инструмента за преместване на устройството за операция за връщане:

Връщане на профили

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

Връщане на числа

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