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

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

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

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

Предварителни изисквания

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

Задайте пътя на средата на JRE/JDK вtoken_generator .sh за MAC иtoken_generator .bat за Windows. Ако JAVA_ Пътят HOME вече съществува, той ще бъде използван повторно от инструмента.

• MAC: JAVA_ НАЧАЛО="/Users/cisco/jdk/zulu@1.8.282/Contents/ Начален екран/"

• Windows: JAVA_ HOME=C:\Progra~1\ Java\jre1.8.0_ 321

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

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

Windows:

token_generator.прилеп

MacOS:

./token_generator .sh

Изход:

Име на инструмента: Версия на инструмента за генериране на токени: 1.13.0 Заредете URL във вашия уеб браузър: 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 = <> 

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

Стъпка 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 

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

Стъпка 3 : Използвайте CLI, за да конфигурирате OCI Provisioning.

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

AS_ CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Изпълнете следната команда, за да получите текущите настройки за осигуряване на OCI:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> вземете описание на адреса ========================= 127.0.0.1 локално като 

Стъпка 4 : Изпълнете командата по-долу в CLI, за да проверите дали вашата конфигурация е правилна.

 AS_ CLI/Maintenance/ManagedObjects> вземете broadworks и проверете дали изходът ви изглежда ОК. Вижте по-долу за примерен изход: AS_ CLI/Maintenance/ManagedObjects> получите broadworks BroadWorks Managed Objects =========================== * Сървър: Самоличност.................: AS версия...................: Рel_ 21.sp1_ 1,551 Административна държава...: Отключено * Приложения: Име Версия Разгърнато Административно състояние Ефективно състояние ============================================== =============================================== Изпълнение и осигуряване 21.sp1_ 1.551 true Отключен Отключен Отключен FlashPolicy 21.sp1_ 1.551 false Отключено спряно OpenClientServer 21.sp1_ 1.551 true Отключен Отключен WebContainer 21.sp1_ 1.551 true Отключен Отключен Открити са 4 записа. * Хоствани приложения: Име Версия Контекст Път Разположен ================================================ ====================== CommPilot 21.sp1_ 1.551 / true DeviceManagementFiles 21.sp1_ 1.551 /DeviceManagement true JWSFiles 21.sp1_ 1.551 /FileRepos true MediaFiles 21.sp1_ 1.551 /media true OCIFiles 21.sp1_ 1,551 /ocifiles true Намерени са 5 записа. 

Проверете дали отворен клиентски сървър е разгърнат и активен

Използвайте командите по-долу, за да разположите и стартирате Open Client Server на вторичния сървър на приложения, ако той не е внедрен или още не е стартиран.

Стъпка 1 : Разположете сървъра със следната команда от командния ред:

AS_CLI/Maintenance/ManagedObjects> разгръщане на приложение OpenClientServer

Стъпка 2 : Стартирайте сървъра с тази команда:

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

Активиране на номера

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

Стъпка 1 : Изпълнете командата за активиране на номера:

AS_ CLI> cd SubscriberMgmt/NumberActivation

Стъпка 2 : Изпълнете активираната команда за активиране:

AS_ CLI> задайте dnMode groupAndUserActivationEnabled

Стъпка 3 : При подкана за потвърждение въведете Y.

За BroadCloud

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

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

Фигурите по-долу показват портала на доставчика на услуги.

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

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

За Cisco BroadWorks и Webex за BroadWorks

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

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

Предварителни изисквания

1. SCP инструмента за извличане на двоични файлове към вторичен Cisco BroadWorks Application Server.
2. SSH към вторичния сървър на приложения Cisco BroadWorks, за да конфигурирате предпоставките и да стартирате инструмента за извличане.
3. Конфигурирайте доставчика на услуги и ИД на групата за извличане от Cisco BroadWorks в conf/exportTool.yml. Вижте примерния YAML фрагмент по-долу:

   ServiceProviderID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - ВСИЧКИ 

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

   BROADWORKS_ ПОТРЕБИТЕЛ_ ИД = администратор BROADWORKS_ ПАРОЛА = администратор BROADWORKS_ ХОСТ_ ИМЕ = локален хост ОБНОВЯВАНЕ_ TOKEN = Токенът за опресняване на администратора на партньор, копиран от инструмента Token Generator. МИГРАЦИЯ_ MODE = Поддържаните стойности саwebex_for_broadworks_to_wholesale . Стойността по стойност по подразбиране еbroadworks_to_wholesale . Използвайтеwebex_for_broadworks_to_wholesale за миграции на Webex за BroadWorks. 

   В ОБНОВЯВАНЕ_ ТОКЕН свойството е задължително за миграция на Webex за BroadWorks.

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

   JAVA_ НАЧАЛО=/usr/local/java/java_base

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

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

./export.sh

Терминални журнали

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

 Стартиране на инструмента за експортиране на данни на BroadSoft ************************************************** *** Стартиране на инструмента за експортиране v: 1.15.0 Експортирането стартира за SP=colllabmigrationtestSP_engg , Group=colllabmigrationtestGRP_engg Експортиране на потребители за SP=collabmigrationtestSP_engg , Group=colllabmigrationtestGRP_engg Експортирането на потребители завършено за SP=collabmigrationtestSP_engg , Group=colllabmigrationtestGRP_engg Експортирането завършено за SP=collabmigrationtestSP_engg , Group=colllabmigrationtestGRP_engg Експортирането завършено Експортиране на Dump Zip директория: изход/20221017223452_ ExportTool Export Dump Zip Име на файла:extracted_data_1666060500618.zip Zip файл с иметоextracted_data_1666060 500618.zip е създаден Процесът на създаване на ZIP файл е завършен. Експортираните файлове са преобразувани като ZIP файл ********************************* ***************

Изход

Изходен ZIP (extracted_data_ .zip ) файл ще бъде наличен в същата директория с инструменти за извличане. Използвайте командата по-долу, за да видите и използвате ZIP файла за въвеждане на инструмента за трансформиране:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 октомври  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 октомври  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 октомври  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 октомври  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 17 октомври 22:34 изход/ drwxrwxr-x 2 bwadmin bwadmin 4096 17 октомври 22:34 logs/ -rw-rw-r4min 17 bwad 17 окт. 35extracted_data_1666060 500618.zip

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

Предварителни изисквания

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

1. Задайте ОСНОВАВАНЕ_ TOKEN (Токен, копиран от инструмента за генериране на токени) и ИМЕ_ OF_ ОСНОВНИ_ МЕСТОПОЛОЖЕНИЕ във файла conf/partner.cfg:

   ОБНОВЯВАНЕ_ TOKEN=MzUwYjljODETYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj ИМЕ_ OF_ ОСНОВНИ_ МЕСТОПОЛОЖЕНИЕ=Основно

2. По желание задайте ПРЕДОСТАВЯНЕ_ ИД (копиран от шаблона в Partner Hub) във файла conf/partner.cfg:

   ПРЕДОСТАВЯНЕ_ ИД=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   За да получите по-пълна проверка на потребителски имейл , можете по избор да зададете ПРЕДОСТАВЯНЕ_ ИД.
3. Конфигурирайте липсваща информация във файла input/customers.csv (вижте следващия раздел), ако липсва.
4. Добавете имейл адрес на краен потребител във файла input/users.csv.
5. Ако трябва да се предоставят нови телефони, добавете mac адреса и имейл адрес на новия телефон на потребителя към файла input/newphones.csv. Това се изисква само ако администраторите на партньори искат да предоставят нови телефони в обажданията на едро.
6. Преобразувайте центровете за повикване на BroadWorks в CxEssentials, като използвате файла input/cxessentials.csv.
7. По желание активирайте UPGRADE_ ВСИЧКИ_ ОБВАЙТЕ се_ ЦЕНТРИ_ ДО_ CX_ Свойство ESSENTIALS за преобразуване на всички центрове за обаждания в CxEssentials.
8. Използвайте файла input/locations.csv, за да поддържате голямата миграция на предприятието, която позволява на администраторите да мигрират местоположенията на своите клиенти по местоположение
9. По избор активирайте използването на MAC адреси от заглавката на User-Agent на съобщението SIP REGISTER, когато MAC адрес не е наличен в профила на профил на устройство на Cisco BroadWorks. Разкоментирайте реда „USE_ MAC_ АДРЕС_ ОТ_ SIP_ REGISTER=yes" във файл conf/partner.cfg

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

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

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

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

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

Windows

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

transform.bat -extract= -клиенти= -потребители= -нови телефони=

macOS

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

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

   python3 -m venv venv източник venv/bin/активиране на python3 -m заявки за инсталиране на pip python3 -m заявки за инсталиране на pip-oauthlib 

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

    ./transform.sh -extract= -клиенти= -потребители= -нови телефони=

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

Инструментът за трансформиране прави извиквания на API към Webex , за да улови потенциални проблеми с обезпечаването. По подразбиране той ще потвърди адреса и основния имейл на клиента. Ако ПРЕДОСТАВЯНЕТО_ Стойността на ИД е посочена във файла conf/partner.cfg, тя също така ще потвърди информацията за местоположението. Резултатите от предварителната проверка са включени в доклада за изключения.

Освен това при стартиране на инструмента за трансформиране могат да се добавят следните допълнителни параметри:

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

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

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

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

Терминални журнали

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

Обобщен отчет Предприятия BroadWorks, които могат да бъдат успешно мигрирани: 1 Предприятия на BroadWorks, които не могат да бъдат мигрирани: 0 потребители на BroadWorks, които могат да бъдат успешно мигрирани: 4 потребители на BroadWorks, които не могат да бъдат мигрирани: 0 Телефони, които могат да бъдат успешно мигрирани: 3 телефона, които не са съвместими с Webex Calling: 0 

Доклад за изключение

Инструментът за трансформиране генерира отчета за изключение вътре изход/ /exception_report .txt директория. Можете да използвате този отчет, за да идентифицирате проблемите, които ще засегнат миграцията, и да ги коригирате в системата Cisco BroadWorks.

След като промените потребителските данни, за да разрешите изключението, стартирайте отново инструментите за извличане и трансформиране с новите данни. Примерният файл с отчет за изключения, както следва:

Доклад за изключения вт, 18 октомври 08:12:09 2022 г. Предприятия с функция за забрана на комуникацията Препоръка: ръчно конфигурирайте плана за изходящи повиквания в Control Hub________________________________________________________________________________ collabmigrationtestGRP_engg 

Изход

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

{ "customer": { "provisioningId": "!!!!!!!!!!!ЗАМЕНИ_ С_ PROVISIONINGID!!!!!!!!!!", "пакети": [ "webex_calling ", "common_area_calling " ], "externalId": "external_id_engg_grp 1", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", " country": "САЩ" }, "customerInfo": { "име": "Инженерна група - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "обаждане": { " location": { "name": "Main", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/New_ Йорк", "език": "en_us ", "числа": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "5205551106", "555551120", "50501501501501501501501501501501501501501501501501501505551105" ", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info ": { "service_provider_id ": "colllabmigrationtestSP_engg ", "group_id ": "colabmigrationtestGRP_engg " }, "абонати": [ { "amareswaranvel+benjaminjack@gmail.com": { "абонат": { "customerId": "!!!!!!!!!!!!ЗАМЕНИ_ С_ КЛИЕНТ!!!!!!!!!!", "имейл": "amareswaranvel+benjaminjack@gmail.com", "пакет": "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": "!!!!!!!!!!ЗАМЕНЕТЕ"_ С_ PERSONID!!!!!!!!!!!", "продукт": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "абонат" : { "customerId": "!!!!!!!!!!!ЗАМЕНИ_ С_ КЛИЕНТ!!!!!!!!!!", "имейл": "amareswaranvel+lucasoliver@gmail.com", "пакет": "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": "!!!!!!!!!!!ЗАМЕНЯТЕ_ С_ PERSONID!!!!!!!!!!!", "продукт": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "абонат" : { "customerId": "!!!!!!!!!!!ЗАМЕНИ_ С_ КЛИЕНТ!!!!!!!!!!!", "имейл": "amareswaranvel+leojackson@gmail.com", "пакет": "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": { "абонат" : { "customerId": "!!!!!!!!!!!ЗАМЕНИ_ С_ КЛИЕНТ!!!!!!!!!!", "имейл": "amareswaranvel+owenalex@gmail.com", "пакет": "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": "!!!!!!!!!!ЗАМЕНЕТЕ"_ С_ PERSONID!!!!!!!!!!!", "продукт": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants ": [], "call_queues ": [], "hunt_groups ": [], "графици": [], "call_parks ": [], "call_pickups ": [], "paging_groups ": [], "voice_portals ": [ { "name": "Автоматичен гласов портал", "firstName": "Автоматичен", "lastName": "Гласов портал", "languageCode": "en_us ", "телефонен номер": "+15205551105", "разширение": "1105" } ], "shared_call_appearances ": [], "business_communicator_desktop_to_upgrade_to_webex_app ": [ "компютър Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app ": [], "местоположения": [], "webex_for_broadworks_info ": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_org Id": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id ": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } }

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

Предварителни изисквания

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

1. Инсталирайте Java 8, 11 или 17 на компютъра. Java се предлага от много източници, включително:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. След като изтеглите и извлечете двоичните файлове на инструментите за миграция, задайте JAVA_ HOME променлива на средата вprovisioning_tool .sh за MAC иprovisioning_tool .bat за Windows.
3. Файлът partner.cfg:
   • Задайте ТЪРГОВИЯ НА ЕДРО_ ПРЕДОСТАВЯНЕ_ ИД и ОБНОВЯВАНЕ_ TOKEN (Токен, копиран от инструмента за генериране на токени). Администраторите на партньорите трябва да се свържат с екипа на акаунта си, за да получат ПРЕДОСТАВЯНЕТО_ ИД:

     НА ЕДРО_ ПРЕДОСТАВЯНЕ_ ИД = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 ОБНОВЯВАНЕ_ TOKEN=MzUwYjljODETYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

   • Задайте РАЗРЕШИ_ АДМИНИСТР_ ПОКАНИ_ ИМЕЙЛИ на false, ако партньорът не иска да изпрати добре дошъл имейл на потребителите. Стойността по подразбиране е true.

4. Използвайте WEBEX4BWKS_ ИМЕЙЛ_ Свойство SUBJECT за миграции на Webex за BroadWorks за изпращане на тема на имейл с искане за промяна на паролата за абонати на Webex за BroadWorks.
5. Използвайте WEBEX4BWKS_ ИМЕЙЛ_ Свойство BODY за миграции на Webex за BroadWorks, за да изпратите имейл със заявка за промяна на паролата за абонати на Webex за BroadWorks.

За миграции на BroadCloud в същия регион:

1. Инструментът ще пропусне осигуряването на номера, устройства и Споделено повикване .
2. Инструментът ще създаде потребители и виртуални потребители с разширение и временно разширение.

За миграции на BroadCloud друг регион:

1. Инструментът ще предостави номера, устройства и Споделено повикване .
2. Инструментът ще създаде потребители и виртуални потребители с действителни телефонни номера и разширение.
   Всички миграции на Europe BroadCloud са към друг регион.

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

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

Windows

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

За предоставяне на единичен клиент: provide.bat -input= За предоставяне на множество клиенти: provide.bat -input= 

macOS

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

За предоставяне на единичен клиент: ./transform.sh -input= За предоставяне на множество клиенти: ./transform.sh -input= 

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

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

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

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

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

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

Терминални журнали

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

Име на инструмента: Версия на инструмента за осигуряване: 1.15.0 ********** Започна обработка на файл: input/customer.json **************** Предоставяне на клиента Изчакване на клиентаexternal_id_engg_grp 1 за завършване на обезпечаването... В очакване на клиентаexternal_id_engg_grp 1 за завършване на обезпечаването...   Клиентexternal_id_engg_grp 1 състояние: осигурени номера за осигуряване Осигуряване на потребители Осигуряване на потребителски функции Осигуряване Поздрави Осигуряване на графици Осигуряване на устройства Осигуряване на Споделено повикване Осигуряване на автоматични придружители Осигуряване на опашки за повиквания Осигуряване на групи за търсене Осигуряване на групови пейджинги Осигуряване на паркове за разговори Осигуряване на извличане на разговори Осигуряване на гласови съобщения ***** Портал файл : input/customer.json **************** 

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

Изход

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

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

Фигура 8: Partner Hub

Фигура 9: Control Hub

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

Фигура 11: Набиране

За BroadCloud

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

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

Фигурите по-долу показват портала на доставчика на услуги.

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

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

За Cisco BroadWorks и Webex за BroadWorks

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

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

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

SCP и SSH

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

Предварителни изисквания

1. Задайте ОСНОВАВАНЕ_ TOKEN (Token, копиран от Token Generator Tool) във файла conf/partner.cfg:

   ОБНОВЯВАНЕ_ TOKEN=MzUwYjljODETYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_ ПОТРЕБИТЕЛ_ ИД = администратор BROADWORKS_ ПАРОЛА = администратор BROADWORKS_ ХОСТ_ ИМЕ = локален хост

3. Уверете се, че пътят на средата на JDK/JRE е правилен в devicemove.sh

    JAVA_ НАЧАЛО=/usr/local/java/java_base

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

Телефони Polycom

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

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

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

1. Инструментът за преместване на устройството замества файла%BWMACADDRESS% .cfg на ниво устройство сpolycom_vvx 2.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 и ще се управлява от Webex Calling DMS.

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

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

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

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

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

Терминални журнали

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

Име на инструмента: Версия на инструмента за преместване на устройство: 1.15.0 Device Tool стартира... Валидни устройства за миграция: -------------------------------------------------- -------------------------------------------------- ---------------| Тип устройство| Mac| Версия| Имейл| -------------------------------------------------- -------------------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenalex@gmail.com| -------------------------------------------------- -------------------------------------------------- --------------- Искате ли да мигрирате всички тези устройства? ([Y]es или [N]o) да Качване на профили на устройства за DMS Cisco MPP LC Процесът на възстановяване на устройството Започна Процесът на повторно изграждане на устройство Завършен успешно Процесът на рестартиране Стартира процесът на рестартиране Завършен успешно Промяна на профилите за Business Communicator под групов collabmigrationtestGRP_engg Активирайте процеса на телефонни номера на webex, започнат за клиентска организация Id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Процесът за активиране на телефонните номера на webex завършен за клиентска организация идентификатор: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Деактивиране на процеса на телефонни номера на broadworks, стартиран за groupId: collabmigrationtestGRP_engg Процесът на деактивиране на телефонни номера на broadworks завършен за groupId: collabmigrationtestGRP_engg Миграцията на устройство е завършена

Изход

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

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

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

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

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

За BroadCloud Carrier

Процесът на връщане за партньорите на BroadCloud е както следва:

1. Отворете билет с Cisco TAC , за да поискате връщане на устройството.
2. Стартирайте инструмента за преместване на устройството в режим на връщане:
   • Телефонните номера ще бъдат премахнати от Webex Calling, оставяйки потребителите и услугите само с разширения.
   • Имейл адресите в Webex Calling ще бъдат върнати към временни имейл адреси.
   • Телефоните ще бъдат изтрити от Webex Calling.
   • Телефонните номера, имейл адресите, използвани като alternatedIds, и телефоните ще бъдат пресъздадени в BroadCloud.
   • Телефоните ще бъдат рестартирани.
3. Администраторите на партньори трябва да преместят телефонните номера на PSTN обратно в BroadCloud Carrier.

За Cisco BroadWorks и Webex за BroadWorks

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

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

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

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

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

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

./devicemove.sh -input= -връщане на профили

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

./devicemove.sh -input= -RevertNumbers

Терминални журнали

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

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

Име на инструмента: Версия на инструмента за преместване на устройство: 1.15.0 Device Tool стартира за процес на връщане... Устройства, които могат да бъдат преместени обратно от Webex Calling към BroadWorks: -------------------------------------------------- -------------------------------------------------- ----------------| Тип устройство| Mac| Версия| Имейл| -------------------------------------------------- -------------------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenalex@gmail.com| -------------------------------------------------- -------------------------------------------------- --------------- Искате ли да върнете тези устройства от Webex Calling към BroadWorks? (Да, Y, Не, N):  да Качване на профили на устройства за DMS Cisco MPP LC Процесът на възстановяване на устройството Започна Процесът на възстановяване на устройството завършен успешно Процесът на рестартиране Стартира Процесът на рестартиране Завършен успешно Миграцията на устройството завършена за процеса на депровизиране 

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

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