Podržani telefoni će se automatski kreirati i dodeliti korisnicima u usluzi Webex Calling pomoću alatke za dodelu privilegija. Telefoni sa „Da“ u koloni „Podržano u alatki za premeštanje uređaja“ takođe će se automatski premestiti iz aplikacija Cisco BroadWorks ili BroadCloud u Webex Calling kada se alatka za premeštanje uređaja pokrene. Telefonima koji su označeni „Ne“ u toj koloni potrebna je ručna intervencija da bi se promenila DMS URL adresa u Cisco BroadWorks šablonu uređaja ili u samom telefonu.

Poslednja kolona obezbeđuje mapiranje modela telefona u kolonu „Tip uređaja” datoteke za transformisanje-tool/input/newphones.csv. (Pogledajte odeljak Alatka za transformisanje ovog članka da biste saznali više o newphones.csv).

Administratori partnera pokreću ovu alatku za alatku generatora tokena najmanje jednom pre nego što počnu da pokreću alatke za migraciju. Pokretanje ove alatke je jednokratna aktivnost nakon što nalog partnera bude ulazno migriran u rešenje veleprodaje RTM. Ova alatka omogućava administratorima partnera da se prijave putem veb-pregledača kako bi dobili jedinstveni TOKEN koji je potreban za ažuriranje na datoteke konfiguracije partnera za alatke za migraciju.

Preduslovi

Instalirajte Java 8, 11, 17 ili 21 na računar. Java je dostupna iz mnogo izvora, uključujući:

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

Nakon preuzimanja, izdvojte binare alatke za migraciju.

Uputstva za pokretanje

Pokrenite sledeću komandu u terminalu unutar direktorijuma generatora tokena:

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

Otvorite URL u veb-pregledaču na terminalu, prijavite se pomoću akreditiva administratora partnera da biste dobili TOKEN i kopirali ga za dalju upotrebu.

Ilustracije korisničkog interfejsa su date u nastavku za referencu:

Slika 3: Prijavite se pomoću usluge Cisco Webex

Slika 4: Prozor akreditiva

Slika 5: Generisanje tokena

Konfigurišite sledeće korake pre nego što pokrenete ekstrakt i premeštanje uređaja na sekundarnom BroadWorks serveru.

Omogući OCI-P mogućnost povezivanja

Alatka za premeštanje uređaja komunicira sa BroadWorks-om preko OCI-P komandi da bi se omogućila OCI-P veza, koristite korake u nastavku:

Korak 1: Koristite CLI da biste konfigurisali opšta podešavanja.

Pokrenite sledeću komandu u CLI da biste promenili u GeneralSettings direktorijum:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Pokrenite sledeću komandu u CLI da biste dobili trenutne opšte postavke:

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

Ako se vaša podešavanja ne podudaraju sa gorenavedenom, koristite komandu Set da biste ponovo konfigurisali podešavanja.

Korak 2: Koristite CLI za konfigurisanje OCI proxy servera.

Promenite direktorijum u OCI proxy server:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Pokrenite sledeću CLI da biste dobili trenutna podešavanja. Trebalo bi da vidite sledeće:

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

Ako se vaša podešavanja ne podudaraju sa gorenavedenom, koristite komandu Set da biste ponovo konfigurisali podešavanja.

Korak 3: Koristite CLI da biste konfigurisali OCI dodeljivanje privilegija.

Promenite u direktorijum za dodelu privilegija:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Pokrenite sledeću komandu da biste dobili trenutna podešavanja dodele privilegija za OCI:

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

Korak 4: Pokrenite komandu u nastavku na CLI da biste proverili da li je konfiguracija tačna.

 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.

Potvrdi da je otvoren server klijenta primenjen i aktivan

Koristite komande u nastavku da biste primenili i pokrenuli Otvori server klijenta na sekundarnom serveru aplikacije ako nije primenjen ili već nije pokrenut.

Korak 1: Primenite server sa sledećom CLI komandom:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Korak 2: Pokrenite server pomoću ove komande:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Omogući aktivaciju brojeva

Izvršite sledeće komande u CLI da biste omogućili aktiviranje brojeva:

Korak 1: Pokrenite komandu za aktiviranje broja:

AS_CLI> cd SubscriberMgmt/NumberActivation

Korak 2: Pokrenite komandu omogućenu aktivaciju:

AS_CLI> set dnMode groupAndUserActivationEnabled

Korak 3: U upitu za potvrdu unesite Y.

Za BroadCloud

Alatka za ekstrakciju je integrisana na BroadCloud portalu za pružaoca usluga. Administrator pružaoca usluga može:

1. Pošaljite zahteve za ekstrakt za do 50 kupaca po zahtevu.
   Zahtev za ekstrakciju ne može da se pošalje istom kupcu više od 10 puta dnevno.
2. Preuzmite datoteku izvezenih podataka, u ZIP formatu, do 28 dana od datuma slanja zahteva.

Cifre u nastavku prikazuju portal za pružaoca usluga.

Slika 6: Portal pružaoca usluga

Slika 7: Portal pružaoca usluga

Za Cisco BroadWorks i Webex za BroadWorks

1. Alatka za ekstrakt se pokreće na sekundarnom Cisco BroadWorks serveru aplikacije u okviru partnerske mreže i povezuje se putem OCI-P-a.
2. Alatka povlači podatke neobrađenih preduzeća, grupe, brojeva, korisnika, usluga, uređaja i softverskog klijenta sa Cisco BroadWorks ili BroadCloud platforme i izlaže ove podatke u XML datoteke koje obezbeđuju ulazne podatke za alatku za transformaciju.

Sledeći odeljci objašnjavaju kako da instalirate i konfigurišete alatku za ekstrakciju.

Preduslovi

1. SCP binari alatke za ekstrakciju na sekundarni Cisco BroadWorks server aplikacije.
2. SSH na sekundarni Cisco BroadWorks server aplikacije da bi konfigurisao preduslove i pokrenuo alatku za ekstrakciju.
3. Konfigurišite pružaoca usluge i ID grupe za izdvajanje iz usluge Cisco BroadWorks u conf/exportTool.yml. Pogledajte uzorak YAML isečak u nastavku:

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

4. Uverite se da su sekundarni ID, lozinka i ime hosta za Cisco BroadWorks aplikaciju servera tačni u datoteci conf/partner.cfg:

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

   Svojstvo REFRESH_TOKEN je obavezno za Webex za BroadWorks migraciju.

5. Izmenite putanju JDK/JRE okruženja u izvozu.sh datoteci ako se sekundarna putanja Cisco BroadWorks Application Server JDK/JRE okruženja razlikuje od datoteke:

   JAVA_HOME=/usr/local/java/java_base

Uputstva za pokretanje

Pokrenite komandu ispod na sekundarnom Cisco BroadWorks serveru aplikacije iz direktorijuma za ekstrakt:

./export.sh

Evidencije terminala

Sledeće evidencije su dostupne u terminalu prilikom uspešnog izvoza: Pokretanje BroadSoft alatke za izvoz podataka:

 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

Izlazna ZIP datoteka (extracted_data_<timestamp>.zip) biće dostupna u istom direktorijumu alatke za ekstrakt. Koristite komandu u nastavku za pregled i korišćenje ZIP datoteke za unos alatke za transformisanje:

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

Ova alatka za transformisanje je pokrenuta za sve migracije. Alatka za transformisanje radi na bilo kom računaru, uključujući laptop administratora partnera i koristi Webex javne API-je. On očitava izlaznu alatku ZIP (extracted_data_<timestamp>.zip) datoteku kao unos i pretvara sirovi XML u JSON format koji koristi alatka za dodelu privilegija.

Preduslovi

Nakon preuzimanja i preuzimanja binara za alatke za migraciju, konfigurišite sledeće preduslove:

1. Podesite token za OSVEŽAVANJE_ (token kopiran iz alatke za generatora tokena) i IME_GLAVNE__LOKACIJE u datoteci conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opcionalno podesite ID za DODELU PRIVILEGIJA_ (kopiran iz šablona u čvorištu partnera) u datoteci conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Da biste dobili potpuniju potvrdu e-adrese kupca, možete opcionalno da podesite ID za DODELU PRIVILEGIJA_.
3. Konfigurišite informacije koje nedostaju u ulaznoj/kupcima.csv datoteci (pogledajte sledeći odeljak) ako nedostaju.
4. Dodajte e-adresu krajnjeg korisnika u ulaznu/users.csv datoteku.
5. Ako treba da se dodele privilegije za nove telefone, dodajte mac adresu i e-adresu novog telefona korisnika u ulaznu/newphones.csv datoteku. Ovo je potrebno samo ako administratori partnera žele da dodele privilegije za nove telefone u pozivanju veleprodaje.
6. Konvertujte BroadWorks centre poziva u CxEssentials koristeći ulaznu/cxessentials.csv datoteku.
7. Opcionalno, omogućite NADOGRADNJU_SVIH_CENTARA POZIVA__ U_CX_ESSENTIALS da biste konvertovali sve centre poziva u CxEssentials.
8. Koristite datoteku unosa/locations.csv za podršku migraciji velikih preduzeća koja omogućava administratorima da migriraju lokacije svojih kupaca po lokaciji
9. Opcionalno omogućite upotrebu MAC adresa iz zaglavlja Korisnik-Agent poruke za SIP REGISTAR kada MAC adresa nije dostupna u profilu Cisco BroadWorks uređaja. Opozovite komentar na liniju „KORISTI _MAC_ADRESU_IZ_SIP_REGISTER=da“ u datoteci conf/partner.cfg
10. Funkcija sinhronizacije mrežnog servera omogućava administratorima da dodele privilegije za brojeve telefona, MAC adrese i e-adrese korisnika tokom dodele privilegija u istoj migraciji regiona. Da biste ga omogućili, podesite USE_NS_SYNC=yes u conf/partner.cfg.

    Ako je NS sinhronizacija onemogućena, broj telefona i dodela privilegija za uređaje će se preskočiti, a korisnici će dobiti privremene e-adrese.

Popunjavanje unosa/kupaca.csv

Unos datoteke/customers.csv obezbeđuje podatke koji možda nedostaju u Cisco BroadWorks ili BroadCloud. Ova datoteka može da se ostavi prazna ako su sve obavezne informacije već dostupne. Ne morate da popunjavate sve kolone, samo su nedostajuće informacije obavezne.

Tabela u nastavku objašnjava najvažnije kolone u input/customers.csv.

Uputstva za pokretanje

Pokrenite alatku za transformisanje u bilo kom operativnom sistemu. Koristite korake u nastavku da biste pokrenuli alatku u operativnim sistemima Windows i macOS:

Windows

Izvršite komandu u nastavku da biste pokrenuli alatku za transformisanje u operativnom sistemu Windows:

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

macOS

Izvršite sledeće korake da biste pokrenuli alatku za transformisanje na macOS-u:

1. Kreirajte virtuelno okruženje i instalirajte zavisnosti da biste pokrenuli alatku za transformisanje pomoću Python-a:

   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. Pokrenite alatku za transformisanje:

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

Preliminarna provera kupca/korisnika

Alatka za transformisanje upućuje API pozive usluzi Webex da bi uhvatio potencijalne probleme sa obezbeđivanjem. Podrazumevano, potvrdiće adresu kupca i primarnu e-adresu. Ako je vrednost ID-a_obezbeđivanja navedena u datoteci conf/partner.cfg, ona će takođe potvrditi informacije o lokaciji. Rezultati preliminarne provere su uključeni u izveštaj o izuzetku.

Pored toga, mogu se dodati sledeći opcionalni parametri prilikom pokretanja alatke za transformisanje:

шљем

Pored pokretanja API za preliminarnu proveru za informacije o kupcima, alatka za transformisanje će takođe pokrenuti API za preliminarnu proveru za e-poštu pretplatnika.

шљико

U izveštaj o izuzetku podrazumevano se uključuju samo greške preliminarne provere (tj. problemi koji će blokirati dodelu privilegija). Ako dodate ovu zastavicu, uključiće se i rezultati preliminarne provere (npr. ako već postoji Webex organizacija koja se može automatski priključiti).

Evidencije terminala

Sledeće evidencije u terminalu o uspešnom transformisanju:

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

Izveštaj o izuzetku

Alatka za transformisanje generiše izveštaj o izuzetku u izlaznom/<timestamp>/exception_report.txt direktorijumu. Ovaj izveštaj možete koristiti za identifikovanje problema koji će uticati na migraciju i rešiti ih u Cisco BroadWorks sistemu.

Nakon što izmenite korisničke podatke da biste rešili izuzetak, ponovo pokrenite Ekstrakt i Transformišite alatke sa novim podacima. Datoteka izveštaja o izuzeću na sledeći način:

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

Izlazna JSON datoteka (customer.json) će biti dostupna u izlaznom/<timestamp>/<groupid> direktorijumu. Uzorak datoteke customer.json je sledeća:

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

Alatka za dodelu privilegija može da radi na bilo kojoj mašini obično na računaru (partnerov administratorski laptop) i koristi Webex javne API-je. On čita JSON datoteku za transformisanje alatke za transformaciju (customer.json) kao unos i dodelu privilegija korisnicima, lokacijama, brojevima, korisnicima, uslugama i uređajima u Webex RTM rešenju za veleprodaju.

Preduslovi

Konfigurišite sledeće preduslove u direktorijumu alatke za dodelu privilegija:

1. Instalirajte Java 8, 11, 17 ili 21 na računar. Java je dostupna iz mnogo izvora, uključujući:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Nakon preuzimanja i preuzimanja binara za alatke za migraciju, podesite promenljivu JAVA_HOME okruženja u provisioning_tool.sh za MAC i provisioning_tool.bat za Windows.
3. Datoteka partner.cfg:
   • Podesite _ID ZA obezbeđivanje_VELEPRODAJE i token za OSVEŽAVANJE_ (Token kopiran iz alatke za generisanje tokena). Administratori partnera moraju da se obrate timu za naloge da bi dobili ID_dodele privilegija:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Podesite opciju _DOZVOLI ADMINISTRATORU_POZOVI_e-PORUKE na netačno ako partner ne želi da korisnicima šalje e-poruku dobrodošlice. Podrazumevana vrednost je tačna.

4. Koristite WEBEX4BWKS_EMAIL_svojstvo SUBJEKTA za Webex za BroadWorks migracije da biste poslali temu e-pošte sa zahtevom za promenu lozinke za Webex za BroadWorks pretplatnike.
5. Koristite svojstvo WEBEX4BWKS_EMAIL_TELA za Webex za BroadWorks migracije da biste poslali telo e-pošte sa zahtevom za promenu lozinke za Webex za BroadWorks pretplatnike.
6. Funkcija sinhronizacije mrežnog servera omogućava administratorima da dodele privilegije za brojeve telefona, MAC adrese i e-adrese korisnika tokom dodele privilegija u istoj migraciji regiona. Da biste ga omogućili, podesite USE_NS_SYNC=yes u conf/partner.cfg.

   Ako je NS sinhronizacija onemogućena, broj telefona i dodela privilegija za uređaje će se preskočiti, a korisnici će dobiti privremene e-adrese.

Za migracije BroadCloud-a isti region:

1. Alatka preskače dodelu privilegija za brojeve, uređaje i Deljene pozive.
2. Alatka kreira korisnike i virtuelne korisnike sa lokalom i privremenim lokalom.

Za BroadCloud migracije u drugi region:

1. Alatka će dodeliti privilegije za pojavljivanja brojeva, uređaja i deljenih poziva.
2. Alatka kreira korisnike i virtuelne korisnike sa stvarnim brojevima telefona i lokalom.
   Sva evropska BroadCloud migracija je u drugi region.

Uputstva za pokretanje

Koristite sledeće korake da biste pokrenuli alatku u operativnim sistemima Windows i macOS:

Windows

Izvršite sledeće korake da biste pokrenuli alatku na operativnom sistemu Windows OS:

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

macOS

Izvršite sledeće korake da biste pokrenuli alatku na macOS-u:

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

Preduslovi za Webex za BroadWorks migraciju

Administratori partnera moraju da ažuriraju svoj obrazac priključivanja za BroadWorks za Webex za BroadWorks funkcije koegzistencije. Pogledajte sledeću sliku:

Kada se Webex za BroadWorks obrazac priključivanja ažurira da podržava migraciju, zatražite od Cisco naloga da omogući preklopnik funkcije „omogućavanje za veleprodaju partnera za mešanje“ na nivou partnera. Ovo će omogućiti da se paketi za veleprodaju postojećim Webex za BroadWorks organizacijama kupca tokom obezbeđivanja.

Pokrenite alatku za dodelu privilegija sa dodatnim argumentima.

Faza pripreme: je podrazumevana faza u kojoj administratori mogu da dodele privilegije za BroadWorks korisnike kao pretplatnike veleprodaje i nastave sa Webex za BroadWorks korisnike.

Faza održavanja: je druga faza u kojoj administratori mogu da dodele licencu za veleprodaju postojećim Webex za BroadWorks korisnicima. Morate da pokrenete alatku za dodelu privilegija sa argumentom održavanja.

Faza naknadne migracije: To je poslednja faza kada administratori mogu u potpunosti da konvertuju BroadWorks u veleprodaju. Morate da pokrenete alatku za dodelu privilegija sa argumentom nakon migracije.

Evidencije terminala

Slede evidencije u terminalu uspešnog dodeljivanja privilegija:

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

Tabela će se odštampati sa brojem lokacija kreiranih za svako pokretanje:

Izlaz

Alatka za dodelu privilegija generiše izveštaje o greškama i izveštajima o greškama unutar izlaznih/<external_id>/*.success/error datoteka. Pregledajte uspeh emitovanja i evidencije grešaka da biste proverili da li je dodela privilegija uspela.

Administratori partnera mogu da potvrde dodelu privilegija za kupce na portalu Partner Hub i Control Hub. Pogledajte sledeće ilustracije sa Partner Hub i Control Hub portala:

Slika 8: Partner Hub

Slika 9: Control Hub

Slika 10: Uređaji

Slika 11: Pozivanje

Za BroadCloud

Za BroadCloud partnere koristite portal pružaoca usluga za slanje zahteva za migraciju za brojeve, uređaje i SCA migracije.

U okviru portala pružaoca usluga zahtev za migraciju može da sadrži do 50 kupaca. Najviše 10 zahteva može da se podnese u roku od jednog dana.

Funkcija "Sinhronizacija mrežnog servera" omogućava administratorima da deaktiviraju lokaciju BroadCloud i aktiviraju lokaciju Webex Calling na podešavanju USE_NS_SYNC=yes u conf/partner.cfg. Nakon migracije, uređaji i brojevi telefona se aktiviraju na lokaciji Webex Calling.

Administratori mogu da omoguće automatizovano vraćanje tako što će ROLLBACK_TO_BROADCLOUD=true se podesiti u conf/partner.cfg datoteku, koja premešta uređaje nazad u BroadCloud nakon migracije. Podržava migracije u istom i različitom regionu sa NS sinhronizacijom, ali samo za uspešne migracije. Za neuspešne, administratori moraju da podignu Cisco TAC pre nego što zatraže vraćanje unazad.

Cifre u nastavku prikazuju portal za pružaoca usluga.

Slika 12: Portal pružaoca usluga

Slika 13: Portal pružaoca usluga

Za Cisco BroadWorks i Webex za BroadWorks

Za Cisco BroadWorks i Webex za BroadWorks migracije, alatka se pokreće na sekundarnom Cisco BroadWorks serveru aplikacije u okviru partnerske mreže i povezuje se sa AS preko OCI-P-a. Koristi izlaznu alatku za transformisanje JSON (customer.json) datoteku kao unos i pokreće OCI-P komande za migraciju uređaja i softverskih klijenata.

Prilikom uspešnog rada, alatka za premeštanje uređaja će:

1. Odjavite uređaje sa Cisco BroadWorks-a i registrujte ih u veleprodaji.
2. Korisnici koji koriste UC-One klijent će se preusmeriti na aplikaciju Webex prilikom prvog prijavljivanja.
3. Deaktivirajte brojeve telefona iz usluge Cisco BroadWorks ili uklonite brojeve telefona iz platforme BroadCloud.
4. Aktivirajte brojeve u veleprodaji.
5. Kreirajte pojavljivanja deljenih poziva u veleprodaji za BroadCloud migracije. [Ovaj korak je primenljiv samo za BroadCloud migracije].

SCP i SSH

1. SCP alatka za premeštanje uređaja na sekundarni Cisco BroadWorks server za aplikaciju.
2. SSH na sekundarni Cisco BroadWorks server aplikacije da bi konfigurisao preduslove i pokrenuo alatku za premeštanje uređaja.

Preduslovi

1. Podesite token za OSVEŽAVANJE_ (Token kopiran iz alatke za generisanje tokena) u datoteku conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Uverite se da su sekundarni ID korisnika Cisco BroadWorks aplikacije servera tačni u datoteci conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Da biste ponovo poslali e-poruke za aktivaciju, potrebno je da podesite PONOVO POŠALJI_POZIVNICU_E-PORUKU=true u datoteci conf/partner.cfg.

   Ako administratori žele da pošalju e-poruke sa pozivnicom svojim korisnicima tokom migracije, trebalo bi da opozovu komentar na svojstvo „PONOVO POŠALJI_E-PORUKE_POZIVNICE=true” u datoteci conf/partner.cfg. U suprotnom, imovina treba da ostane nepromenjena.

4. Uverite se da je putanja JDK/JRE okruženja tačna u devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratori mogu da koriste lokaciju.csv datoteku iz direktorijuma unosa za migraciju određenih grupa, a ne svih grupa u okviru velikog preduzeća.

Поликохоне

Da bi se Polycom telefone premestili iz Cisco BroadWorks u pozivanje za veleprodaju, administrator partnera mora da kreira novu datoteku tipa identiteta/profila uređaja na nivou sistema u Cisco BroadWorks svakom šablonu Polycom uređaja. Pogledajte sliku 14 i otpremite prilagođenu datoteku device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Nakon otpremanja datoteke uređaja uverite se da novo kreirana datoteka postoji na nivou grupe. Takođe, uverite se da datoteka migration_%BWMAC ADDRESS%.cfg nije neusaglašena sa bilo kojom postojećom datotekom u vašem sistemu).

Uređaj je interno koristi alatka za premeštanje uređaja.

Postupak migracije za Polycom telefone:

1. Alatka za premeštanje uređaja zamenjuje datoteku %BWMACADDRESS%.cfg na nivou uređaja polycom_vvx2.cfg. Ova datoteka se odnosi na migration_%BWMACADDRESS%.cfg.
2. Ponovo kreirajte profile uređaja na nivou grupe ili na nivou uređaja.
   Postupanje na nivou grupe ili uređaja zavisi od konfiguracije uređaja parametra deviceLevelRebuild u datoteci device-move-tool/conf/partner.cfg.
3. Alatka za premeštanje uređaja traži od Cisco BroadWorks servera aplikacije da ponovo pokrene telefone na nivou grupe ili uređaja.
4. Nakon zahteva za ponovno pokretanje, Polycom telefoni preuzimaju i obrađuju% BWMACADDRESS%.cfg, koji traži od Polycom telefona da preuzimaju i obrađuju migration_%BWMACADDRESS%.cfg, čime se podešava device.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com za region SAD, drugi regioni imaju različite URL adrese.
5. Polycom telefon preuzima %BWMACADDRESS%.cfg sa https://plcm.sipflash.com i njime će upravljati Webex Calling DMS.

Slika 14: Dodavanje datoteke tipa profila identiteta/uređaja

Uputstva za pokretanje

Postoje dva načina pozivanja DMT, prvi je pozivanje po jednog kupca, a drugi je istovremeno upućivanje preko više kupaca.

Alatka za premeštanje uređaja se pokreće na sekundarnom Cisco BroadWorks serveru aplikacije unutar direktorijuma alatki za premeštanje uređaja:

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

Evidencije terminala

Slede evidencije u terminalu o uspešnom pokretanju alatke za premeštanje uređaja za migraciju uređaja:

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

Nakon migracije uređaja, uređaji su došli na mrežu i spremni za upućivanje/primanje poziva. Pogledajte sliku 15 da biste videli primer statusa uređaja:

Slika 15: Status uređaja

Nakon migracije uređaja brojevi su postali aktivni. Pogledajte sliku 16 da biste videli primer koji su brojevi aktivni:

Slika 16: Brojevi su aktivni

Operacija vraćanja mora da se izvrši za jedno preduzeće u datom trenutku.

Za BroadCloud operatera

Postupak vraćanja za BroadCloud partnere je sledeći:

1. Otvorite tiket kod Cisco TAC-a da biste zatražili vraćanje uređaja.
2. Pokrenite alatku za premeštanje uređaja u vraćenom režimu:
   • Brojevi telefona će se poništiti dodela usluge Webex Calling, ostavljajući korisnike i usluge samo za lokale.
   • E-adrese u usluzi Webex Calling će se vratiti na privremene e-adrese.
   • Telefoni će biti izbrisani iz usluge Webex Calling.
   • Brojevi telefona, e-adrese koji se koriste kao izmenjeni ID i telefoni će se ponovo kreirati u usluzi BroadCloud.
   • Telefoni će se ponovo pokrenuti.
3. Administratori partnera moraju da vrate PSTN brojeve telefona na BroadCloud operatera.

Za Cisco BroadWorks i Webex za BroadWorks

Povratni proces za Cisco BroadWorks i Webex za BroadWorks je sledeći:

1. Otvorite tiket kod Cisco TAC-a da biste zatražili vraćanje uređaja.
2. Pokrenite alatku za premeštanje uređaja u režim vraćanja na sekundarnom BroadWorks aplikacionom serveru da biste vratili migraciju uređaja. Ovim putem će se DMS URL vratiti na DMS URL pružaoca usluga za profile uređaja u Cisco BroadWorks-u i ponovo aktivirati brojeve telefona.
3. Webex Calling tim podešava DMS URL adresu nazad na DMS URL adresu pružaoca usluge u profilima uređaja u usluzi Webex Calling.
4. Administratori partnera moraju da deaktiviraju ili izbrišu brojeve telefona iz usluge Webex Calling putem portala Control Hub.
5. Administratori partnera moraju da vrate PSTN brojeve telefona u Cisco BroadWorks.

Uputstva za pokretanje alatke za premeštanje uređaja u režim vraćanja

Pratite korake u nastavku da biste pokrenuli alatku za premeštanje uređaja u režimu vraćanja:

Pokrenite komandu ispod na sekundarnom Cisco BroadWorks serveru aplikacije unutar direktorijuma alatki za premeštanje uređaja:

Vrati profile

./devicemove.sh -input=  -revertProfiles

Vrati brojeve

./devicemove.sh -input=  -revertNumbers

Evidencije terminala

Dobićete sledeće evidencije u terminalu o uspešnom pokretanju alatke za premeštanje uređaja za vraćanje:

Vrati 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

Vrati brojeve

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