Orodje za omogočanje bo samodejno ustvarilo in dodelilo podprte telefone uporabnikom v storitvi Webex Calling. Telefoni, označeni z »da« v stolpcu »Podprto v orodju za premikanje naprav«, bodo prav tako samodejno premaknjeni iz Cisco BroadWorks ali BroadCloud v Webex Calling, ko se zažene orodje za premikanje naprav. Telefoni, označeni z »Ne« v tem stolpcu, potrebujejo ročni poseg za spremembo URL-ja DMS v predlogi naprave Cisco BroadWorks ali v samem telefonu.

Zadnji stolpec prikazuje preslikavo modelov telefonov v stolpec »Vrsta naprave« v datoteki. transform-tool/input/newphones.csv. (Za več informacij o datoteki newphones.csv glejte razdelek Orodje za preoblikovanje v tem članku).

Partnerski skrbniki vsaj enkrat zaženejo to orodje za generiranje žetonov, preden začnejo izvajati orodja za selitev. Zagon tega orodja je enkratna dejavnost po tem, ko je partnerski račun vključen v rešitev Wholesale RTM. To orodje omogoča skrbnikom partnerjev, da se prijavijo prek spletnega brskalnika in pridobijo edinstveni ŽETON, ki je potreben za posodobitev konfiguracijskih datotek partnerjev za orodja za selitev.

Predpogoji

V računalnik namestite Javo 8, 11, 17 ali 21. Java je na voljo iz številnih virov, vključno z:

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

Po prenosu izvlecite binarne datoteke orodja za selitev.

Navodila za zagon

V terminalu znotraj imenika generatorja žetonov zaženite naslednji ukaz:

Okna:

token_generator.bat

MacOS:

./token_generator.sh

Izhod:

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

Odprite URL v spletnem brskalniku na terminalu, prijavite se s poverilnicami skrbnika partnerja, da dobite žeton, in ga kopirajte za nadaljnjo uporabo.

Ilustracije uporabniškega vmesnika so podane spodaj za referenco:

Slika 3: Prijava s Cisco Webexom

Slika 4: Okno s poverilnicami

Slika 5: Generiranje žetonov

Preden zaženete orodja za ekstrahiranje in premikanje naprav na sekundarnem strežniku BroadWorks, konfigurirajte naslednje korake.

Omogočanje povezljivosti OCI-P

Orodje za premikanje naprave komunicira z BroadWorks prek ukazov OCI-P. Za omogočanje povezljivosti OCI-P sledite spodnjim korakom:

1. korak: Za konfiguracijo splošnih nastavitev uporabite CLI.

Za preklop v imenik GeneralSettings zaženite naslednji ukaz v CLI:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Za pridobitev trenutnih splošnih nastavitev zaženite naslednji ukaz v CLI:

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

Če se vaše nastavitve ne ujemajo z zgornjimi, uporabite ukaz set za ponovno konfiguracijo nastavitev.

2. korak: Za konfiguracijo posredniškega strežnika OCI uporabite CLI.

Spremenite imenik v OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Za pridobitev trenutnih nastavitev zaženite naslednji ukazni ukaz. Videti bi morali naslednje:

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

Če se vaše nastavitve ne ujemajo z zgornjimi, uporabite ukaz set za ponovno konfiguracijo nastavitev.

3. korak: Za konfiguracijo zagotavljanja OCI uporabite CLI.

Sprememba v imeniku za zagotavljanje:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Za pridobitev trenutnih nastavitev zagotavljanja OCI zaženite naslednji ukaz:

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

4. korak: Za preverjanje pravilnosti konfiguracije zaženite spodnji ukaz v 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.

Preverite, ali je odprti odjemalski strežnik nameščen in aktiven.

Spodnje ukaze uporabite za namestitev in zagon strežnika Open Client Server na sekundarnem aplikacijskem strežniku, če še ni nameščen ali se še ni zagnal.

1. korak: Strežnik namestite z naslednjim ukazom CLI:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

2. korak: Zaženite strežnik s tem ukazom:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Omogoči aktivacijo številk

Za aktivacijo številk izvedite naslednje ukaze v CLI:

1. korak: Zaženite ukaz za aktivacijo številke:

AS_CLI> cd SubscriberMgmt/NumberActivation

2. korak: Zaženite ukaz za omogočeno aktivacijo:

AS_CLI> set dnMode groupAndUserActivationEnabled

3. korak: V potrditvenem pozivu vnesite Y.

Za BroadCloud

Orodje za ekstrakcijo je integrirano v portal ponudnika storitev BroadCloud. Skrbnik ponudnika storitev lahko:

1. Zahteve za izpis lahko oddate za do 50 strank na zahtevo.
   Zahteve za izpisek ni mogoče oddati za isto stranko več kot 10-krat na dan.
2. Prenesite izvlečeno podatkovno datoteko v formatu ZIP do 28 dni od datuma oddaje zahteve.

Naslednje slike prikazujejo portal ponudnika storitev.

Slika 6: Portal ponudnika storitev

Slika 7: Portal ponudnika storitev

Zahteva za izvleček CSV

Začni zahtevo za izvleček CSV

1. Prenesite datoteko CSV stranke

   Kliknite povezavo Prenesi datoteko CSV stranke v zgornjem desnem kotu razdelka Začni zahtevo za izvleček datoteke CSV.

2. Uredi seznam strank

   Skrbnik lahko to datoteko CSV uredi tako, da vključi samo stranke, za katere je treba izvesti izvleček.

3. Naloži in pošlji

   Po urejanju naložite spremenjeno datoteko CSV.

   Kliknite Pošlji, da sprožite zahtevo za izvleček za navedene stranke in z njimi povezane lokacije.

Začnite zahtevo za izvleček za stranko z lokacijsko datoteko CSV

1. Izberite stranke in lokacije za prenos

   V spustnem meniju izberite stranko.

   Prenesite ustrezno datoteko locations.csv iz Ogled strank→ zavihek Spletna mesta → Izvoz lokacij kot CSV.

2. Uredite datoteko z lokacijami

   Skrbnik lahko uredi datoteko CSV tako, da vključuje samo lokacije, ki jih želi izvleči.

3. Naloži in pošlji

   Naložite urejeno datoteko locations.csv in kliknite Pošlji.

   V zahtevo za izvleček bodo vključene samo določene lokacije za izbrano stranko.

Začni zahtevo za izvleček za vse stranke

1. Kliknite Pošlji, da sprožite zahtevo za izpisek za vse stranke in vse njihove lokacije pod trenutnim ponudnikom storitev.

Za Cisco BroadWorks in Webex za BroadWorks

1. Orodje za ekstrakcijo deluje na sekundarnem strežniku aplikacij Cisco BroadWorks znotraj partnerskega omrežja in se povezuje prek OCI-P.
2. Orodje pridobiva surove podatke o podjetjih, skupinah, številkah, uporabnikih, storitvah, napravah in programskih odjemalcih s platforme Cisco BroadWorks ali BroadCloud ter te podatke izpisuje v datoteke XML, ki zagotavljajo vhodne podatke za orodje za preoblikovanje.

V naslednjih razdelkih je razloženo, kako namestiti in konfigurirati orodje za ekstrahiranje.

Predpogoji

1. SCP prenesite binarne datoteke orodja za ekstrahiranje na sekundarni strežnik aplikacij Cisco BroadWorks.
2. Za konfiguracijo predpogojev in zagon orodja za ekstrahiranje se prek SSH povežite s sekundarnim strežnikom aplikacij Cisco BroadWorks.
3. Konfigurirajte ponudnika storitev in ID skupine za pridobivanje podatkov iz Cisco BroadWorks v conf/exportTool.yml. Glejte naslednji primer delčka YAML:

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

4. Prepričajte se, da so uporabniško ime, geslo in ime gostitelja sekundarnega strežnika Cisco BroadWorks Application Server pravilni v conf/partner.cfg datoteka:

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

   Lastnost REFRESH_TOKEN je obvezna za selitev Webex za BroadWorks.

5. Spremeni JDK/JRE pot okolja v datoteki export.sh, če je sekundarni strežnik aplikacij Cisco BroadWorks JDK/JRE pot do okolja se razlikuje od datoteke:

   JAVA_HOME=/usr/local/java/java_base

Navodila za zagon

V sekundarnem strežniku aplikacij Cisco BroadWorks iz imenika orodja za ekstrahiranje zaženite naslednji ukaz:

./export.sh

Dnevniki terminala

Ob uspešnem izvozu so v terminalu na voljo naslednji dnevniki: Zagon orodja za izvoz podatkov 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
**************************************************

Izhod

Izhodna datoteka ZIP (extracted_data_<timestamp>.zip) je na voljo v istem imeniku orodja za ekstrahiranje. Za ogled in uporabo datoteke ZIP za vnos orodja Transform uporabite naslednji ukaz:

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

To orodje za preoblikovanje se izvaja za vse migracije. Orodje za preoblikovanje deluje na katerem koli računalniku, vključno s skrbniškim prenosnikom partnerja, in uporablja javne API-je Webex. Prebere izhodno datoteko ZIP (extracted_data_<timestamp>.zip) orodja za ekstrahiranje kot vhod in pretvori surov XML v obliko JSON, ki jo uporablja orodje za oskrbovanje.

Predpogoji

Po prenosu in ekstrahiranju binarnih datotek orodij za selitev konfigurirajte naslednje predpogoje:

1. Nastavite ŽETON OSVEŽITVE_(žeton, kopiran iz orodja za generiranje žetonov) in IME__GLAVNE LOKACIJE_v conf/partner.cfg datoteka:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Po želji nastavite ID ZA OMOGOČANJE_(kopiran iz predloge v središču za partnerje) v conf/partner.cfg datoteka:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Za popolnejše preverjanje e-poštnega naslova stranke lahko po želji nastavite ID ZA OMOGOČANJE_.
3. Konfigurirajte manjkajoče podatke v input/customers.csv datoteka (glejte naslednji razdelek), če manjka.
4. Dodajte e-poštni naslov končnega uporabnika v input/users.csv datoteka.
5. Če želite omogočiti uporabo novih telefonov, dodajte naslov MAC in e-poštni naslov uporabnikovega novega telefona v input/newphones.csv datoteka. To je potrebno le, če želijo skrbniki partnerjev omogočiti nove telefone v storitvi Veleprodajno klicanje.
6. Pretvorite klicne centre BroadWorks v CxEssentials z uporabo input/cxessentials.csv datoteka.
7. Po želji omogočite lastnost NADGRADI_VSE_KLICNE_CENTERJE_NA_CX_ESSENTIALS, da pretvorite vse klicne centre v CxEssentials.
8. Uporabite input/locations.csv datoteka za podporo selitve v velika podjetja, ki skrbnikom omogoča selitev lokacij svojih strank po lokacijah
9. Izbirno omogočite uporabo naslovov MAC iz glave uporabniškega agenta sporočila SIP REGISTER, če naslov MAC ni na voljo v profilu naprave Cisco BroadWorks. Odkomentirajte vrstico »UPORABI_MAC_NASLOV_IZ_SIP_« REGISTER=yes" v datoteki conf/partner.cfg
10. Funkcija sinhronizacije omrežnega strežnika skrbnikom omogoča, da med selitvijo v isti regiji dodelijo telefonske številke, naslove MAC in e-poštne naslove uporabnikov. Če ga želite omogočiti, nastavite USE_NS_SYNC=yes v conf/partner.cfg.

    Če je sinhronizacija NS onemogočena, bo dodeljevanje telefonskih številk in naprav preskočeno, uporabniki pa bodo prejeli začasne e-poštne naslove.

11. Izbirno omogočite lastnosti ANALOG_UPORABNIK_VRSTA_OMOGOČI_KLIC_ČAKANJE, ANALOG_UPORABNIK_VRSTA_OMOGOČI_GLASBA [_VKLOP_ČEKANJE in ANALOG_UPORABNIK_VRSTA_ONEMOGOČI_T38 za konfiguracijo čakajočega klica, glasbe na čakanju in onemogočanje nastavitev T38 za vse uporabnike analognega tipa.

Polnjenje input/customers.csv

Datoteka input/customers.csv zagotavlja podatke, ki morda manjkajo v Cisco BroadWorks ali BroadCloud. To datoteko lahko pustite prazno, če so vsi obvezni podatki že na voljo. Ni vam treba izpolniti vseh stolpcev, obvezni so le manjkajoči podatki.

Spodnja tabela pojasnjuje najpomembnejše stolpce v input/customers.csv.

Polnjenje input/users.csv

Datoteka input/users.csv zagotavlja podatke, ki morda manjkajo v Cisco BroadWorks ali BroadCloud. To datoteko lahko pustite prazno, če so vsi obvezni podatki že na voljo. Ni vam treba izpolniti vseh stolpcev, obvezni so le manjkajoči podatki.

Navodila za zagon

Zaženite orodje za preoblikovanje v katerem koli operacijskem sistemu. Za zagon orodja v sistemih Windows in macOS sledite spodnjim korakom:

Windows

Za zagon orodja Transform v sistemu Windows izvedite spodnji ukaz:

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

macOS

Za zagon orodja za preoblikovanje v sistemu macOS izvedite naslednje korake:

1. Ustvarite virtualno okolje in namestite odvisnosti za zagon orodja za preoblikovanje z uporabo Pythona:

   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. Zaženite orodje za preoblikovanje:

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

Customer/user predhodno preverjanje

Orodje Transform izvaja klice API-ja v Webex, da bi odkrilo morebitne težave z omogočanjem uporabe. Privzeto bo potrdil naslov stranke in primarni e-poštni naslov. Če je vrednost ID-ja PROVISIONING_določena v conf/partner.cfg datoteko, bo potrdil tudi podatke o lokaciji. Rezultati predhodnega preverjanja so vključeni v poročilo o izjemah.

Poleg tega lahko pri zagonu orodja za preoblikovanje dodate naslednje neobvezne parametre:

predhodno preverjanje

Poleg izvajanja API-ja za predhodno preverjanje podatkov o strankah bo orodje Transform zagnalo tudi API za predhodno preverjanje e-poštnih sporočil naročnikov.

informacije o predhodnem preverjanju

Privzeto so v poročilo o izjemah vključene samo napake predhodnega preverjanja (tj. težave, ki bodo blokirale omogočanje). Če dodate to zastavico, boste vključili tudi uspešne rezultate predhodnega preverjanja (npr. če organizacija Webex že obstaja in jo je mogoče samodejno priključiti).

Dnevniki terminala

Ob uspešni transformaciji se v terminalu izpiše naslednje:

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

Poročilo o izjemah

Orodje Transform ustvari poročilo o izjemah znotraj izhoda /<timestamp>/exception_report.txt imenik. To poročilo lahko uporabite za prepoznavanje težav, ki bodo vplivale na selitev, in njihovo odpravo v sistemu Cisco BroadWorks.

Ko spremenite uporabniške podatke, da odpravite izjemo, znova zaženite orodja za ekstrahiranje in preoblikovanje z novimi podatki. Vzorec datoteke s poročilom o izjemah je naslednji:

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

Izhod

Izhodna datoteka JSON (customer.json) bo na voljo v output/<timestamp>/<groupid> imenik. Vzorčna datoteka customer.json je naslednja:

{
    "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"
    }
}

Orodje za oskrbovanje se lahko izvaja na katerem koli računalniku, običajno na (skrbniškem prenosniku partnerja) in uporablja javne API-je Webex. Prebere izhodno datoteko JSON (customer.json) orodja za preoblikovanje kot vhod in dodeli stranke, lokacije, številke, uporabnike, storitve in naprave v rešitvi Webex Wholesale RTM.

Predpogoji

V imeniku orodja za oskrbovanje konfigurirajte naslednje predpogoje:

1. V računalnik namestite Javo 8, 11, 17 ali 21. Java je na voljo iz številnih virov, vključno z:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Po prenosu in ekstrahiranju binarnih datotek orodij za migracijo nastavite spremenljivko okolja JAVA_HOME v datoteki provisioning_tool.sh za MAC in provisioning_tool.bat za Windows.
3. Datoteka partner.cfg:
   • Nastavite ID VELEPRODAJE_ZAGOTAVLJANJA [_in ŽETON OSVEŽITVE_(žeton je bil kopiran iz orodja za generiranje žetonov). Skrbniki partnerjev se morajo obrniti na svojo ekipo za stranke, da dobijo ID ZAGOTAVLJANJA_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Nastavite DOVOLI_ADMIN_POVABILO_E-POŠTA na false, če partner ne želi poslati pozdravnega e-poštnega sporočila uporabnikom. Privzeta vrednost je true.

4. Za pošiljanje zadeve e-poštnega sporočila z zahtevo za spremembo gesla naročnikom na Webex for BroadWorks uporabite lastnost WEBEX4BWKS_EMAIL_SUBJECT za selitve Webex for BroadWorks.
5. Za pošiljanje telesa e-poštnega sporočila z zahtevo za spremembo gesla naročnikom storitve Webex for BroadWorks uporabite lastnost WEBEX4BWKS_EMAIL_BODY za selitve Webex for BroadWorks.
6. Funkcija sinhronizacije omrežnega strežnika skrbnikom omogoča, da med selitvijo v isti regiji dodelijo telefonske številke, naslove MAC in e-poštne naslove uporabnikov. Če ga želite omogočiti, nastavite USE_NS_SYNC=yes v conf/partner.cfg.

   Če je sinhronizacija NS onemogočena, bo dodeljevanje telefonskih številk in naprav preskočeno, uporabniki pa bodo prejeli začasne e-poštne naslove.

Za migracije BroadCloud v isti regiji:

1. Orodje preskoči omogočanje številk, naprav in prikazov skupnih klicev.
2. Orodje ustvari uporabnike in virtualne uporabnike z razširitvijo in začasno razširitvijo.

Za migracije BroadCloud v drugo regijo:

1. Orodje bo omogočilo številke, naprave in prikaze skupnih klicev.
2. Orodje ustvarja uporabnike in virtualne uporabnike z dejanskimi telefonskimi številkami in interno številko.
   Vse migracije Europe BroadCloud potekajo v drugo regijo.

Navodila za zagon

Za zagon orodja v sistemih Windows in macOS sledite naslednjim korakom:

Windows

Za zagon orodja v operacijskem sistemu Windows izvedite naslednje korake:

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

macOS

Za zagon orodja v sistemu macOS izvedite naslednje korake:

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

Predpogoji za migracijo Webexa za BroadWorks

Partnerski skrbniki morajo posodobiti svojo predlogo za uvajanje v BroadWorks za funkcije soobstoja Webexa za BroadWorks. Glejte naslednjo sliko:

Ko je predloga za uvajanje v Webex za BroadWorks posodobljena za podporo selitve, prosite ekipo za stranke Cisco, da na ravni partnerja omogoči preklop funkcije »omogočeno mešanje veleprodajnih partnerjev«. To bo omogočilo dodajanje veleprodajnih paketov obstoječim organizacijam strank Webex for BroadWorks med zagotavljanjem.

Zaženite orodje za oskrbovanje z dodatnim argumentom.

Pripravljalna faza: je privzeta faza, v kateri lahko skrbniki uporabnike BroadWorks oskrbijo kot veleprodajne naročnike in nadaljujejo z uporabo Webexa za uporabnike BroadWorks.

Faza vzdrževanja: je druga faza, v kateri lahko skrbniki dodelijo veleprodajno licenco obstoječim uporabnikom Webexa za BroadWorks. Orodje za oskrbovanje morate zagnati z argumentom vzdrževanje.

Faza po migraciji: Je zadnja faza, v kateri lahko skrbniki BroadWorks popolnoma pretvorijo v veleprodajo. Orodje za oskrbovanje morate zagnati z argumentom po migraciji.

Dnevniki terminala

Sledijo dnevniki v terminalu ob uspešni nastavitvi:

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 ****************

Izpisana bo tabela s številom lokacij, ustvarjenih za vsak zagon:

Izhod

Orodje za oskrbovanje ustvari poročila o uspehu in napakah znotraj izhoda /<external_id>/*.success/error datoteke. Preglejte dnevnike uspeha in napak pri izhodu, da preverite uspešnost omogočanja.

Skrbniki partnerjev lahko preverijo dodeljevanje storitev strankam v portalu Partner Hub in Control Hub. Glejte naslednje ilustracije s portala Partner Hub in Control Hub:

Slika 8: Partnersko zvezdišče,

Slika 9: Nadzorno središče

Slika 10: Naprave

Slika 11: Klicanje

Za BroadCloud

Partnerji BroadCloud naj za oddajo zahteve za selitev številk, naprav in selitev prikazov skupnih klicev (SCA) uporabijo portal ponudnika storitev.

Znotraj portala ponudnika storitev lahko zahteva za selitev vključuje do 50 strank. V enem dnevu je mogoče oddati največ 10 zahtev.

Funkcija sinhronizacije omrežnega strežnika skrbnikom omogoča, da deaktivirajo lokacijo broadCloud in aktivirajo lokacijo Webex Calling, ko v [ conf/partner.cfg] nastavijo USE_NS_SYNC=yes . Po selitvi so naprave in telefonske številke aktivirane na lokaciji Webex Calling.

Skrbniki lahko omogočijo samodejno povrnitev prejšnjih nastavitev tako, da v datoteki ROLLBACK_TO_BROADCLOUD=true ] nastavijo conf/partner.cfg, kar po selitvi naprave premakne nazaj v BroadCloud. Podpira migracije znotraj iste in različnih regij z NS Sync, vendar le za uspešne migracije. Za neuspešne morajo skrbniki pred zahtevo za razveljavitev vnesti Cisco TAC.

Za izbiro vrste migracije na portalu sta na voljo dve možnosti:

• Selitev – Izberite to možnost, če želite sprožiti zahtevo za selitev številk, naprav in prikazov skupnih klicev (SCA).
• Stanje naprave – Izberite to možnost, če si želite ogledati trenutno stanje naprave v storitvah BroadCloud in Calling.

Naslednje slike prikazujejo portal ponudnika storitev.

Slika 12: Portal ponudnika storitev

Slika 13: Portal ponudnika storitev

Prenesi izbrane lokacije (neobvezno)

Če želite začeti selitev za določeno podmnožico lokacij, navedenih v datoteki customer.json, svoji zahtevi priložite datoteko locations.csv. Ta datoteka CSV mora navajati samo lokacije, ki jih nameravate preseliti.

Za prenos seznama razpoložljivih aktivnih lokacij pojdite na Ogled strank → Izberi stranko → Izvozi lokacije kot CSV.

Slika 14: Izvoz lokacij kot CSV

Za Cisco BroadWorks in Webex za BroadWorks

Pri migracijah Cisco BroadWorks in Webex for BroadWorks se orodje izvaja na sekundarnem strežniku aplikacij Cisco BroadWorks znotraj partnerskega omrežja in se z AS poveže prek OCI-P. Kot vhod uporablja izhodno datoteko JSON (customer.json) orodja Transform Tool in izvaja ukaze OCI-P za selitev naprav in programskih odjemalcev.

Po uspešnem delovanju bo orodje za premikanje naprave:

1. Odregistrirajte naprave iz Cisco BroadWorks in jih registrirajte v veleprodaji.
2. Uporabniki, ki uporabljajo odjemalca UC-One, bodo ob prvi prijavi preusmerjeni na aplikacijo Webex.
3. Deaktivirajte telefonske številke iz storitve Cisco BroadWorks ali jih odstranite iz storitve BroadCloud.
4. Aktivirajte številke v veleprodaji.
5. Ustvarite skupne prikaze klicev v veleprodaji za migracije BroadCloud. [This korak velja samo za BroadCloud migrations].

SCP in SSH

1. SCP orodje za premikanje naprav na sekundarni strežnik aplikacij Cisco BroadWorks.
2. Za konfiguracijo predpogojev in zagon orodja za premikanje naprave se prek SSH povežite s sekundarnim strežnikom aplikacij Cisco BroadWorks.

Predpogoji

1. Nastavite ŽETON REFRESH_(žeton, kopiran iz orodja za generiranje žetonov) v conf/partner.cfg datoteka:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Prepričajte se, da so uporabniško ime, geslo in ime gostitelja sekundarnega strežnika Cisco BroadWorks Application Server pravilni v conf/deviceMoveTool.conf datoteka:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Za ponovno pošiljanje aktivacijskih e-poštnih sporočil morate nastaviti PONOVO POŠLJI_POVABILO_EMAILS=true v conf/partner.cfg datoteka.

   Če želijo skrbniki med selitvijo svojim uporabnikom poslati e-poštna povabila, naj odstranijo komentarje v polju »PONOVNO POŠLJI_POVABILO_« EMAILS=true" nepremičnina v conf/partner.cfg datoteka. V nasprotnem primeru bi morala nepremičnina ostati nespremenjena.

4. Preverite JDK/JRE pot do okolja je pravilna v datoteki devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Skrbniki lahko za selitev določenih skupin namesto vseh skupin znotraj podjetja uporabijo datoteko locations.csv iz vhodnega imenika.

Polycomovi telefoni

Za prenos telefonov Polycom iz Cisco BroadWorks v veleprodajno klicanje mora skrbnik partnerja ustvariti nov Identity/Device Datoteka tipa profila na sistemski ravni v Cisco BroadWorks vsaka predloga naprave Polycom. Glejte sliko 14 in naložite datoteko po meri device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Po nalaganju nove datoteke naprave se prepričajte, da na novo ustvarjena datoteka obstaja na ravni skupine. Prav tako se prepričajte, da datoteka migration_%BWMAC ADDRESS%.cfg ni v konfliktu z nobeno obstoječo datoteko v vašem sistemu.

Uporablja ga interno orodje za premikanje naprave.

Postopek selitve za telefone Polycom:

1. Orodje za premikanje naprave zamenja datoteko %BWMACADDRESS%.cfg na ravni naprave z polycom_vvx2.cfg. Ta datoteka se nanaša na migration_%BWMACADDRESS%.cfg.
2. Ponovno zgradite profile naprav na ravni skupine ali naprave.
   Delovanje na ravni skupine ali naprave je odvisno od konfiguracije parametra deviceLevelRebuild v datoteki. device-move-tool/conf/partner.cfg.
3. Orodje za premikanje naprav od strežnika aplikacij Cisco BroadWorks zahteva, da ponovno zažene telefone na ravni skupine ali naprave.
4. Po zahtevi za ponovni zagon telefoni Polycom prenesejo in obdelajo datoteko% BWMACADDRESS%.cfg, ki telefone Polycom pozove, naj prenesejo in obdelajo datoteko migration_%BWMACADDRESS%.cfg, ki nastavi device.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com za regijo ZDA imajo druge regije drugačne URL-je.
5. Telefon Polycom prenese datoteko %BWMACADDRESS%.cfg iz https://plcm.sipflash.com in jo bo upravljal Webex Calling DMS.

Slika 14: Identity/device dodajanje datoteke tipa profila

Navodila za zagon

Obstajata dva načina za klic DMT, prvi je, da se klic izvede prek ene stranke naenkrat, drugi pa je, da se izvede prek več strank hkrati.

Orodje za premikanje naprav se zažene iz sekundarnega strežnika aplikacij Cisco BroadWorks znotraj imenika orodja za premikanje naprav:

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

Dnevniki terminala

Sledijo dnevniki v terminalu ob uspešnem zagonu orodja za premikanje naprav za selitev naprav:

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

Izhod

Po selitvi naprav so naprave vzpostavljene v splet in pripravljene za make/receive klici. Za primer stanja naprave glejte sliko 15:

Slika 15: Stanje naprave

Po selitvi naprave so številke postale aktivne. Za primer aktivnih številk glejte sliko 16:

Slika 16: Aktivne številke

Operacijo razveljavitve je treba izvesti za eno podjetje naenkrat.

Za operaterja BroadCloud

Postopek vračila za partnerje BroadCloud je naslednji:

1. Odprite zahtevek pri Cisco TAC, da zahtevate vračilo naprave.
2. Zaženite orodje za premikanje naprave v načinu za vračanje v prejšnje stanje:
   • Telefonske številke ne bodo dodeljene iz storitve Webex Calling, tako da bodo uporabnikom in storitvam ostale le še interne številke.
   • E-poštni naslovi v storitvi Webex Calling bodo povrnjeni v začasne e-poštne naslove.
   • Telefoni bodo izbrisani iz storitve Webex Calling.
   • Telefonske številke, e-poštni naslovi, uporabljeni kot nadomestni ID-ji, in telefoni bodo ponovno ustvarjeni v BroadCloudu.
   • Telefoni bodo ponovno zagnani.
3. Partnerski skrbniki morajo telefonske številke PSTN prenesti nazaj k operaterju BroadCloud.

Za Cisco BroadWorks in Webex za BroadWorks

Postopek razveljavitve za Cisco BroadWorks in Webex za BroadWorks je naslednji:

1. Odprite zahtevek pri Cisco TAC, da zahtevate vračilo naprave.
2. Za razveljavitev selitev naprav zaženite orodje za premikanje naprav v načinu razveljavitve na sekundarnem strežniku aplikacij BroadWorks. S tem boste URL DMS nastavili nazaj na URL DMS ponudnika storitev za profile naprav v Cisco BroadWorks in ponovno aktivirali telefonske številke.
3. Ekipa za klicanje Webex v profilih naprav v storitvi Webex Calling nastavi URL DMS nazaj na URL DMS ponudnika storitev.
4. Partnerski skrbniki morajo deaktivirati ali izbrisati telefonske številke v storitvi Webex Calling prek portala Control Hub.
5. Partnerski skrbniki morajo telefonske številke PSTN prenesti nazaj v Cisco BroadWorks.

Navodila za zagon orodja za premikanje naprave v načinu za razveljavitev

Za zagon orodja za premikanje naprave v načinu razveljavitve sledite spodnjim korakom:

Zaženite spodnji ukaz v sekundarnem strežniku aplikacij Cisco BroadWorks znotraj imenika orodja za premikanje naprave:

Razveljavi profile

./devicemove.sh -input=  -revertProfiles

Razveljavi številke

./devicemove.sh -input=  -revertNumbers

Dnevniki terminala

Ob uspešnem zagonu orodja za premikanje naprave za operacijo razveljavitve bomo v terminalu dobili naslednje dnevnike:

Razveljavi profile

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

Razveljavi številke

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