Подржани телефони ће бити аутоматски креирани и додељени корисницима у Webex Calling-у помоћу алатке за обезбеђивање. Телефони означени са „да“ у колони „Подржано у алату за премештање уређаја“ такође ће бити аутоматски премештени из Cisco BroadWorks-а или BroadCloud-а у Webex Calling када се покрене алат за премештање уређаја. Телефони означени са „Не“ у тој колони захтевају ручну интервенцију да би се променила DMS URL адреса у шаблону Cisco BroadWorks уређаја или у самом телефону.

Последња колона приказује мапирање модела телефона на колону „Тип уређаја“ у датотеци. transform-tool/input/newphones.csv. (Погледајте одељак Алат за трансформацију овог чланка за више информација о датотеци newphones.csv).

Администратори партнера покрећу овај услужни алат за генерисање токена барем једном пре него што почну да користе алате за миграцију. Покретање овог алата је једнократна активност након што се партнерски налог укључи у Wholesale RTM решење. Овај алат омогућава администраторима партнера да се пријаве путем веб прегледача како би добили јединствени ТОКЕН који је потребан за ажурирање конфигурационих датотека партнера за алате за миграцију.

Preduslovi

Инсталирајте Јаву 8, 11, 17 или 21 на рачунар. Јава је доступна из многих извора, укључујући:

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

Након преузимања, распакујте бинарне датотеке алата за миграцију.

Упутства за покретање

Покрените следећу команду у терминалу унутар директоријума генератора токена:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Излаз:

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

Отворите УРЛ адресу у веб прегледачу на терминалу, пријавите се са акредитивима администратора партнера да бисте добили ТОКЕН и копирајте га за даљу употребу.

Илустрације корисничког интерфејса дате су у наставку ради референце:

Slika 3: Пријавите се помоћу Cisco Webex-а

Slika 4: Прозор за акредитиве

Slika 5: Генерисање токена

Конфигуришите следеће кораке пре покретања алата за издвајање и премештање уређаја на секундарном BroadWorks серверу.

Омогући OCI-P повезивање

Алат за премештање уређаја комуницира са BroadWorks-ом путем OCI-P команди. Да бисте омогућили OCI-P повезивање, користите кораке у наставку:

Корак 1: Користите CLI да бисте конфигурисали општа подешавања.

Покрените следећу команду у CLI-ју да бисте прешли у директоријум GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Покрените следећу команду у CLI да бисте добили тренутне опште поставке (GeneralSettings):

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

Ако се ваша подешавања не подударају са горе наведеним, користите команду set да бисте поново конфигурисали своја подешавања.

Корак 2: Користите CLI да бисте конфигурисали OCI прокси.

Промените директоријум на OCI прокси:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Покрените следећи CLI да бисте добили тренутна подешавања. Требало би да видите следеће:

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

Ако се ваша подешавања не подударају са горе наведеним, користите команду set да бисте поново конфигурисали своја подешавања.

Корак 3: Користите CLI да бисте конфигурисали OCI Provisioning.

Промена у директоријуму за обезбеђивање:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Покрените следећу команду да бисте добили тренутна подешавања за OCI Provisioning:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

Корак 4: Покрените команду испод у CLI-ју да бисте проверили да ли је ваша конфигурација исправна.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Проверите да ли је отворени клијентски сервер распоређен и активан

Користите доленаведене команде да бисте распоредили и покренули Open Client Server на секундарном апликационом серверу ако није распоређен или већ није покренут.

Корак 1: Распоредите сервер помоћу следеће CLI команде:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Корак 2: Покрените сервер овом командом:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Омогући активацију бројева

Извршите следеће команде у CLI-ју да бисте омогућили активацију бројева:

Корак 1: Покрените команду за активацију броја:

AS_CLI> cd SubscriberMgmt/NumberActivation

Корак 2: Покрените команду омогућене активације:

AS_CLI> set dnMode groupAndUserActivationEnabled

Корак 3: У потврдном прозору унесите Y.

За BroadCloud

Алат за издвајање је интегрисан у портал провајдера услуга BroadCloud. Администратор добављача услуга може:

1. Пошаљите захтеве за извод за највише 50 клијената по захтеву.
   Захтев за извод се не може поднети за истог клијента више од 10 пута дневно.
2. Преузмите издвојену датотеку са подацима, у ZIP формату, до 28 дана од датума подношења захтева.

Следеће слике приказују портал добављача услуга.

Slika 6: Портал добављача услуга

Slika 7: Портал добављача услуга

Захтев за издвајање CSV датотеке

Покрени захтев за издвајање 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 апликационом серверу унутар партнерске мреже и повезује се преко OCI-P.
2. Алат преузима сирове податке о предузећима, групама, бројевима, корисницима, услугама, уређајима и софтверским клијентима са Cisco BroadWorks или BroadCloud платформе и преноси ове податке у XML датотеке које пружају улазе за алатку за трансформацију.

У следећим одељцима је објашњено како инсталирати и конфигурисати алатку за екстракцију.

Preduslovi

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:
                          - ALL
   

4. Уверите се да су кориснички ИД, лозинка и име хоста секундарног Cisco BroadWorks апликацијског сервера исправни у conf/partner.cfg датотека:

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

   Својство REFRESH_TOKEN је обавезно за миграцију Webex-а за BroadWorks.

5. Измените JDK/JRE путања окружења у датотеци export.sh ако је секундарни Cisco BroadWorks Application Server JDK/JRE путања окружења се разликује од датотеке:

   JAVA_HOME=/usr/local/java/java_base

Упутства за покретање

Покрените следећу команду на секундарном Cisco BroadWorks апликационом серверу из директоријума алата за екстракцију:

./export.sh

Терминални логови

Следећи логови су доступни у терминалу након успешног извоза: Покретање алатке за извоз података BroadSoft-а:

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

Izlaz

Излазни ZIP (extracted_data_<timestamp>.zip) фајл је доступан у истом директоријуму алатке за распакивање. Користите следећу команду да бисте видели и користили ZIP датотеку за унос алатке за трансформацију:

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

Овај алат за трансформацију се покреће за све миграције. Алат за трансформацију ради на било ком рачунару, укључујући и администраторски лаптоп партнера, и користи јавне Webex API-је. Чита излазну ZIP датотеку (extracted_data_<timestamp>.zip) алата за екстракцију као улаз и трансформише сирови XML у JSON формат који користи алат за обезбеђивање.

Preduslovi

Након преузимања и распакивања бинарних датотека алата за миграцију, конфигуришите следеће предуслове:

1. Подесите ТОКЕН ЗА ОСВЕЖАВАЊЕ_(токен копиран из алатке за генерисање токена) и НАЗИВ__ГЛАВНЕ ЛОКАЦИЈЕ_у conf/partner.cfg датотека:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Опционо подесите ИД ОБЕЗБЕЂИВАЊА_(копирано из шаблона у Центру за партнере) у conf/partner.cfg датотека:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Да бисте добили потпунију верификацију имејл адресе клијента, опционо можете подесити ИД ОБЕЗБЕЂИВАЊА_.
3. Конфигуришите недостајуће информације у input/customers.csv датотека (видети следећи одељак) ако недостаје.
4. Додајте адресу е-поште крајњег корисника у input/users.csv датотека.
5. Ако треба да се обезбеде нови телефони, додајте МАЦ адресу и имејл адресу новог телефона корисника у input/newphones.csv датотека. Ово је потребно само ако администратори партнера желе да обезбеде нове телефоне у велепродајном позивању.
6. Претворите BroadWorks кол центре у CxEssentials користећи input/cxessentials.csv датотека.
7. Опционо, омогућите својство НАДОГРАДИ_СВЕ_ПОЗИВНЕ_ЦЕНТРЕ_НА_CX_ESSENTIALS да бисте конвертовали све позивне центре у CxEssentials.
8. Користите input/locations.csv датотека за подршку миграције великих предузећа која омогућава администраторима да мигрирају локације својих клијената по локацији
9. Опционо омогућите коришћење MAC адреса из заглавља User-Agent SIP REGISTER поруке када MAC адреса није доступна у профилу Cisco BroadWorks уређаја. Одкоментишите ред „КОРИСТИ_MAC_АДРЕСА_ОД_SIP_REGISTER=yes" у датотеци conf/partner.cfg
10. Функција синхронизације мрежног сервера омогућава администраторима да обезбеде бројеве телефона, MAC адресе и имејл адресе корисника током обезбеђивања у истој регионалној миграцији. Да бисте га омогућили, поставите USE_NS_SYNC=yes у conf/partner.cfg.

    Ако је NS синхронизација онемогућена, додељивање броја телефона и уређаја ће бити прескочено, а корисници ће добити привремене имејл адресе.

11. Опционо омогућите својства ANALOG_KORISNIK_TYPE_ENABLE_CALL_WAITING, ANALOG_KORISNIK_TYPE_ENABLE_MUSIC_ON_TEAM, и ANALOG_KORISNIK_TYPE_DISABLE_T38 да бисте конфигурисали чекање позива, музику на чекању и онемогућили подешавања T38 за све кориснике аналогног типа.

Попуњавање input/customers.csv

Датотека input/customers.csv пружа податке који можда недостају у Cisco BroadWorks-у или BroadCloud-у. Ова датотека може остати празна ако су све обавезне информације већ доступне. Не морате попунити све колоне, обавезни су само подаци који недостају.

Доња табела објашњава најважније колоне у input/customers.csv.

Попуњавање input/users.csv

Датотека input/users.csv пружа податке који можда недостају у Cisco BroadWorks-у или BroadCloud-у. Ова датотека може остати празна ако су све обавезне информације већ доступне. Не морате попунити све колоне, обавезни су само подаци који недостају.

Упутства за покретање

Покрените алатку за трансформацију у било ком оперативном систему. Користите доле наведене кораке да бисте покренули алатку у оперативним системима Windows и macOS:

Windows

Извршите команду испод да бисте покренули алатку за трансформацију у оперативном систему Windows:

transform.bat -extract= -customers= -users= -newphones=

macOS

Извршите следеће кораке да бисте покренули алатку за трансформацију на macOS-у:

1. Креирајте виртуелно окружење и инсталирајте зависности да бисте покренули алатку за трансформацију користећи Пајтон:

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

2. Покрените алатку за трансформацију:

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

Customer/user претходна провера

Алат за трансформацију упућује 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

Извештај о изузецима

Алат за трансформацију генерише извештај о изузетку унутар излаза/<timestamp>/exception_report.txt директоријум. Овај извештај можете користити да идентификујете проблеме који ће утицати на миграцију и да их решите у Cisco BroadWorks систему.

Након измене корисничких података да бисте решили изузетак, поново покрените алате за издвајање и трансформацију са новим подацима. Пример датотеке са извештајем о изузецима је следећи:

Exception Report
Tue Oct 18 08:12:09 2022

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

Izlaz

Излазни JSON (customer.json) фајл ће бити доступан у output/<timestamp>/<groupid> директоријум. Пример датотеке customer.json је следећи:

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

Алат за обезбеђивање може да се покреће на било којој машини, обично на (партнерском администраторском лаптопу) и користи Webex јавне API-је. Чита излазну JSON датотеку (customer.json) алатке за трансформацију као улаз и обезбеђује купце, локације, бројеве, кориснике, услуге и уређаје у Webex Wholesale RTM решењу.

Preduslovi

Конфигуришите следеће предуслове унутар директоријума алата за обезбеђивање:

1. Инсталирајте Јаву 8, 11, 17 или 21 на рачунар. Јава је доступна из многих извора, укључујући:
   • 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:
   • Подесите ИД ВЕЛЕПРОДАЈЕ_ОБЕЗБЕЂИВАЊА_и ТОКЕН ЗА ОСВЕЖАВАЊЕ_(токен копиран из алатке за генерисање токена). Администратори партнера морају да контактирају свој тим за налоге да би добили ИД за PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Поставите ДОЗВОЛИ_АДМИНИСТРАТОР_ПОЗИВ_ИМЕЈЛОВЕ на нетачно, ако партнер не жели да пошаље имејл добродошлице корисницима. Подразумевана вредност је тачно.

4. Користите својство WEBEX4BWKS_EMAIL_SUBJECT за миграције Webex for BroadWorks да бисте послали наслов е-поште са захтевом за промену лозинке претплатницима Webex for BroadWorks.
5. Користите својство WEBEX4BWKS_EMAIL_BODY за миграције Webex for BroadWorks да бисте послали тело имејла са захтевом за промену лозинке за претплатнике Webex for BroadWorks.
6. Функција синхронизације мрежног сервера омогућава администраторима да обезбеде бројеве телефона, MAC адресе и имејл адресе корисника током обезбеђивања у истој регионалној миграцији. Да бисте га омогућили, поставите USE_NS_SYNC=yes у conf/partner.cfg.

   Ако је NS синхронизација онемогућена, додељивање броја телефона и уређаја ће бити прескочено, а корисници ће добити привремене имејл адресе.

За BroadCloud миграције у истом региону:

1. Алат прескаче обезбеђивање бројева, уређаја и дељених изгледа позива.
2. Алат креира кориснике и виртуелне кориснике са екстензијом и привременом екстензијом.

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

1. Алат ће обезбедити бројеве, уређаје и дељене приказе позива.
2. Алат креира кориснике и виртуелне кориснике са стварним бројевима телефона и екстензијама.
   Све миграције са Europe BroadCloud-а су у други регион.

Упутства за покретање

Користите следеће кораке да бисте покренули алатку у оперативним системима Windows и macOS:

Windows

Извршите следеће кораке да бисте покренули алатку на Windows оперативном систему:

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

macOS

Извршите следеће кораке да бисте покренули алатку на macOS-у:

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

Предуслови за миграцију Webex-а за BroadWorks

Администратори партнера морају да ажурирају свој шаблон за увођење у BroadWorks за функције коегзистенције Webex-а за BroadWorks. Погледајте следећу слику:

Када се шаблон за увођење у Webex за BroadWorks ажурира да би подржао миграцију, затражите од Cisco тима за налоге да омогући прекидач функције „омогућено комбиновање велепродаје са партнерима“ на нивоу партнера. Ово ће омогућити додавање велепродајних пакета постојећим организацијама корисника Webex-а за BroadWorks током обезбеђивања.

Покрените алатку за обезбеђивање са додатним аргументом.

Припремна фаза: је подразумевана фаза у којој администратори могу да обезбеде корисницима BroadWorks-а као велепродајним претплатницима и да наставе са Webex-ом за кориснике BroadWorks-а.

Фаза одржавања: је друга фаза у којој администратори могу доделити велепродајну лиценцу постојећим корисницима Webex-а за BroadWorks. Морате покренути алатку за обезбеђивање са аргументом одржавање.

Фаза након миграције: Ово је последња фаза када администратори могу потпуно конвертовати BroadWorks у велепродају. Морате покренути алатку за обезбеђивање са аргументом postmigration.

Терминални логови

Следе евиденције у терминалу о успешном обезбеђивању:

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

Биће одштампана табела са бројем креираних локација за свако покретање:

Izlaz

Алат за обезбеђивање генерише извештаје о успеху и грешкама унутар излаза/<external_id>/*.success/error датотеке. Прегледајте евиденцију успеха и грешака излаза да бисте проверили успешно обезбеђивање.

Администратори партнера могу да провере обезбеђивање корисника на порталу Partner Hub и Control Hub. Погледајте следеће илустрације са портала Partner Hub и Control Hub:

Slika 8: Partner Hub

Slika 9: Control Hub

Slika 10: Uređaji

Slika 11: Pozivanje

За BroadCloud

За BroadCloud партнере, користите портал добављача услуга да бисте послали захтев за миграцију бројева, уређаја и миграција дељених позива (SCA).

У оквиру портала добављача услуга, захтев за миграцију може да садржи до 50 клијената. У току једног дана може се поднети највише 10 захтева.

Функција синхронизације мрежног сервера омогућава администраторима да деактивирају локацију broadCloud и активирају локацију Webex Calling подешавањем USE_NS_SYNC=yes у conf/partner.cfg. Након миграције, уређаји и бројеви телефона се активирају на локацији Webex Calling.

Администратори могу омогућити аутоматско враћање на претходно стање постављањем ROLLBACK_TO_BROADCLOUD=true у датотеци conf/partner.cfg, што враћа уређаје на BroadCloud након миграције. Подржава миграције и из истог и из другог региона помоћу NS Sync-а, али само за успешне миграције. За неуспешне, администратори морају да подигну Cisco TAC пре него што затраже враћање на претходно стање.

Постоје две опције за избор типа миграције на порталу:

• Миграција – Изаберите ову опцију да бисте покренули захтев за миграцију бројева, уређаја и дељених приказа позива (SCA).
• Статус уређаја – Изаберите ову опцију да бисте видели тренутни статус уређаја на BroadCloud-у и Calling-у.

Следеће слике приказују портал добављача услуга.

Slika 12: Портал добављача услуга

Slika 13: Портал добављача услуга

Мигрирај изабране локације (опционо)

Да бисте започели миграцију за одређени подскуп локација наведених у датотеци customer.json, уз захтев приложите датотеку locations.csv. Ова CSV датотека треба да садржи само локације које намеравате да мигрирате.

Да бисте преузели листу доступних активних локација, идите на Прикажи клијенте → Изаберите клијента → Извези локације као CSV.

Slika 14: Извези локације као CSV

За Cisco BroadWorks и Webex за BroadWorks

За миграције Cisco BroadWorks и Webex за BroadWorks, алат се покреће на секундарном Cisco BroadWorks апликационом серверу унутар партнерске мреже и повезује се са AS преко OCI-P. Користи излазну JSON датотеку (customer.json) алатке Transform Tool као улаз и покреће OCI-P команде за миграцију уређаја и софтверских клијената.

Након успешног рада, алат за премештање уређаја ће:

1. Одрегиструјте уређаје са Cisco BroadWorks-а и региструјте их у Wholesale-у.
2. Корисници који користе UC-One клијент ће бити преусмерени на Webex апликацију приликом првог пријављивања.
3. Деактивирајте бројеве телефона из Cisco BroadWorks-а или уклоните бројеве телефона из BroadCloud-а.
4. Активирајте бројеве у велепродаји.
5. Креирајте дељене приказе позива у велепродаји за миграције BroadCloud-а. [This корак је применљив само за BroadCloud migrations].

SCP и SSH

1. SCP алат за премештање уређаја на секундарни Cisco BroadWorks апликациони сервер.
2. Повежите се преко SSH са секундарним Cisco BroadWorks апликацијским сервером да бисте конфигурисали предуслове и покренули алатку за премештање уређаја.

Preduslovi

1. Поставите ТОКЕН ЗА ОСВЕЖАВАЊЕ_(токен копиран из алатке за генерисање токена) у conf/partner.cfg датотека:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Уверите се да су кориснички ИД, лозинка и име хоста секундарног Cisco BroadWorks апликацијског сервера исправни у conf/deviceMoveTool.conf датотека:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Да бисте поново послали активационе имејлове, потребно је да подесите ПОНОВО ПОШАЉИ_ПОЗИВНИЦУ_EMAILS=true у conf/partner.cfg датотека.

   Ако администратори желе да пошаљу имејлове са позивом својим корисницима током миграције, требало би да одкоментишу „ПОНОВО ПОШАЉИ_ПОЗИВ_EMAILS=true" имовина у conf/partner.cfg датотека. У супротном, имовина би требало да остане непромењена.

4. Проверите JDK/JRE путања окружења је исправна у devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Администратори могу да користе датотеку locations.csv из улазног директоријума да би мигрирали одређене групе уместо свих група у оквиру предузећа.

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

Да би преместио Polycom телефоне са Cisco BroadWorks-а на Wholesale Calling, администратор партнера мора да креира нови Identity/Device Датотека типа профила на нивоу система у Cisco BroadWorks сваки шаблон Polycom уређаја. Погледајте слику 14 и отпремите прилагођену датотеку device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Након отпремања нове датотеке уређаја, уверите се да новокреирана датотека постоји на нивоу групе. Такође се уверите да датотека migration_%BWMAC ADDRESS%.cfg није у сукобу са било којом постојећом датотеком на вашем систему.

Користи се интерно од стране алата за премештање уређаја.

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

1. Алат за премештање уређаја замењује датотеку %BWMACADDRESS%.cfg на нивоу уређаја са polycom_vvx2.cfg. Ова датотека се односи на migration_%BWMACADDRESS%.cfg.
2. Поново направите профиле уређаја на нивоу групе или на нивоу уређаја.
   Деловање на нивоу групе или нивоу уређаја зависи од конфигурације параметра deviceLevelRebuild у датотеци device-move-tool/conf/partner.cfg.
3. Алат за премештање уређаја захтева од Cisco BroadWorks Application Server-а да поново покрене телефоне на нивоу групе или на нивоу уређаја.
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.

Slika 14: Identity/device додавање датотеке типа профила

Упутства за покретање

Постоје две методе за позивање DMT-а, прва је позивање преко једног клијента у исто време, а друга је истовремено покретање преко више клијената.

Алат за премештање уређаја се покреће са секундарног Cisco BroadWorks апликацијског сервера унутар директоријума алата за премештање уређаја:

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

Терминални логови

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

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

Izlaz

Након миграције уређаја, уређаји су повезани на мрежу и спремни за make/receive позиви. Погледајте слику 15 да бисте видели пример статуса уређаја:

Slika 15: Status uređaja

Након миграције уређаја, бројеви су постали активни. Погледајте слику 16 да бисте видели пример који су бројеви активни:

Slika 16: Бројеви активни

Операција враћања мора се извршити за једно предузеће истовремено.

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

Процес враћања за BroadCloud партнере је следећи:

1. Отворите тикет код Cisco TAC-а да бисте захтевали враћање уређаја.
2. Покрените алатку за премештање уређаја у режиму враћања на претходно стање:
   • Бројеви телефона неће бити додељени из Webex Calling-а, остављајући корисницима и услугама само екстензије.
   • Имејл адресе у Webex Calling-у биће враћене на привремене имејл адресе.
   • Телефони ће бити избрисани из Webex Calling-а.
   • Бројеви телефона, адресе е-поште које се користе као алтернативни ИД-ови и бројеви телефона биће поново креирани у BroadCloud-у.
   • Телефони ће бити рестартовани.
3. Администратори партнера морају да врате бројеве телефона PSTN-а оператеру BroadCloud.

За Cisco BroadWorks и Webex за BroadWorks

Процес враћања на претходна подешавања за Cisco BroadWorks и Webex за BroadWorks је следећи:

1. Отворите тикет код Cisco TAC-а да бисте захтевали враћање уређаја.
2. Покрените алатку за премештање уређаја у режиму враћања на секундарном BroadWorks апликацијском серверу да бисте вратили миграције уређаја. Овим ће се DMS URL вратити на DMS URL добављача услуга за профиле уређаја у Cisco BroadWorks-у и поново активирати бројеви телефона.
3. Webex тим за позиве враћа DMS URL адресу на DMS URL адресу добављача услуга у профилима уређаја у Webex Calling-у.
4. Администратори партнера морају да деактивирају или избришу бројеве телефона у Webex Calling-у путем портала Control Hub.
5. Партнерски администратори морају да врате бројеве телефона PSTN мреже у Cisco BroadWorks.

Упутства за покретање алата за премештање уређаја у режиму враћања на претходно стање

Пратите кораке у наставку да бисте покренули алатку за премештање уређаја у режиму враћања на претходно стање:

Покрените команду испод на секундарном Cisco BroadWorks апликационом серверу унутар директоријума алата за премештање уређаја:

Врати профиле

./devicemove.sh -input=  -revertProfiles

Врати бројеве

./devicemove.sh -input=  -revertNumbers

Терминални логови

Добићемо следеће логове у терминалу након успешног покретања алата за премештање уређаја за операцију враћања:

Врати профиле

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

Врати бројеве

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