Alat za pružanje usluga automatski će kreirati i dodijeliti korisnicima podržane telefone u Webex Callingu. Telefoni označeni s "da" u stupcu "Podržano u alatu za premještanje uređaja" također će se automatski premjestiti iz Cisco BroadWorksa ili BroadClouda u Webex Calling kada se pokrene alat za premještanje uređaja. Telefoni označeni s "Ne" u tom stupcu zahtijevaju ručnu intervenciju za promjenu DMS URL-a u predlošku Cisco BroadWorks uređaja ili u samom telefonu.

Posljednji stupac prikazuje mapiranje modela telefona na stupac "Vrsta uređaja" u datoteci. transform-tool/input/newphones.csv. (Više informacija o datoteci newphones.csv potražite u odjeljku Alat za transformaciju ovog članka).

Administratori partnera pokreću ovaj uslužni alat za generiranje tokena barem jednom prije nego što počnu pokretati alate za migraciju. Pokretanje ovog alata je jednokratna aktivnost nakon što se partnerski račun integrira u Wholesale RTM rješenje. Ovaj alat omogućuje administratorima partnera prijavu putem web preglednika kako bi dobili jedinstveni TOKEN koji je potreban za ažuriranje konfiguracijskih datoteka partnera za alate za migraciju.

Preduvjeti

Instalirajte Javu 8, 11, 17 ili 21 na računalo. Java je dostupna iz mnogih 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, izdvojite binarne datoteke alata za migraciju.

Upute za pokretanje

Pokrenite sljedeću naredbu u terminalu unutar direktorija generatora tokena:

Prozori:

token_generator.bat

MacOS:

./token_generator.sh

Izlaz:

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

Otvorite URL u web pregledniku na terminalu, prijavite se s administratorskim vjerodajnicama partnera kako biste dobili TOKEN i kopirajte ga za daljnju upotrebu.

Ilustracije korisničkog sučelja dane su u nastavku kao referenca:

Slika 3: Prijava putem Cisco Webexa

Slika 4: Prozor za vjerodajnice

Slika 5: Generiranje tokena

Konfigurirajte sljedeće korake prije pokretanja alata za izdvajanje i premještanje uređaja na sekundarnom BroadWorks poslužitelju.

Omogući OCI-P povezivost

Alat za premještanje uređaja komunicira s BroadWorksom putem OCI-P naredbi. Za omogućavanje OCI-P povezivosti slijedite korake u nastavku:

Korak 1: Pomoću CLI-ja konfigurirajte opće postavke.

Pokrenite sljedeću naredbu u CLI-ju za promjenu direktorija GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Pokrenite sljedeću naredbu u CLI-ju da biste dobili trenutne Opće postavke:

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

Ako vaše postavke ne odgovaraju gore navedenima, upotrijebite naredbu set za ponovno konfiguriranje postavki.

Korak 2: Pomoću CLI-ja konfigurirajte OCI proxy.

Promijenite direktorij u OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Pokrenite sljedeći CLI da biste dobili trenutne postavke. Trebali biste vidjeti sljedeće:

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

Ako vaše postavke ne odgovaraju gore navedenima, upotrijebite naredbu set za ponovno konfiguriranje postavki.

Korak 3: Pomoću CLI-ja konfigurirajte OCI Provisioning.

Promjena u direktorij za pružanje usluga:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Pokrenite sljedeću naredbu da biste dobili trenutne postavke OCI Provisioninga:

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

Korak 4: Pokrenite donju naredbu u CLI-ju kako biste provjerili je li vaša konfiguracija ispravna.

 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.

Provjerite je li otvoreni klijentski poslužitelj raspoređen i aktivan

Pomoću dolje navedenih naredbi implementirajte i pokrenite Open Client Server na sekundarnom aplikacijskom poslužitelju ako nije implementiran ili već nije pokrenut.

Korak 1: Implementirajte poslužitelj sljedećom CLI naredbom:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Korak 2: Pokrenite server ovom naredbom:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Omogući aktivaciju brojeva

Izvršite sljedeće naredbe u CLI-ju kako biste omogućili aktivaciju brojeva:

Korak 1: Pokrenite naredbu za aktivaciju broja:

AS_CLI> cd SubscriberMgmt/NumberActivation

Korak 2: Pokrenite naredbu za omogućenu aktivaciju:

AS_CLI> set dnMode groupAndUserActivationEnabled

Korak 3: Na upit za potvrdu unesite Y.

Za BroadCloud

Alat za izdvajanje integriran je u portal pružatelja usluga BroadCloud. Administrator pružatelja usluga može:

1. Pošaljite zahtjeve za izvod za do 50 klijenata po zahtjevu.
   Zahtjev za izvod ne može se podnijeti za istog korisnika više od 10 puta dnevno.
2. Preuzmite izdvojenu datoteku s podacima, u ZIP formatu, do 28 dana od datuma podnošenja zahtjeva.

Sljedeće slike prikazuju portal pružatelja usluga.

Slika 6.: Portal pružatelja usluga

Slika 7.: Portal pružatelja usluga

Zahtjev za izdvajanje CSV datoteke

Pokreni zahtjev za izdvajanje CSV-a

1. Preuzmite CSV datoteku korisnika

   Kliknite vezu Preuzmi CSV korisnika u gornjem desnom kutu odjeljka Pokreni zahtjev za izdvajanje CSV-a.

2. Uredi popis kupaca

   Administrator može urediti ovu CSV datoteku kako bi uključio samo korisnike za koje je potrebno izvršiti izdvajanje.

3. Prenesi i pošalji

   Nakon uređivanja, prenesite izmijenjeni CSV.

   Kliknite Pošalji za pokretanje zahtjeva za izdvajanje za navedene kupce i njihove povezane lokacije.

Pokreni zahtjev za izdvajanje za kupca s CSV-om lokacija

1. Odaberite lokacije za kupce i preuzimanje

   Odaberite kupca iz padajućeg izbornika.

   Preuzmite odgovarajuću datoteku locations.csv iz Pregled kupaca→ kartica Web-lokacije → Izvoz lokacija kao CSV.

2. Uredite datoteku lokacija

   Administrator može urediti CSV datoteku kako bi uključio samo lokacije koje želi izdvojiti.

3. Prenesi i pošalji

   Prenesite uređenu datoteku locations.csv i kliknite Pošalji.

   U zahtjev za izdvajanje bit će uključene samo navedene lokacije za odabranog kupca.

Pokreni zahtjev za izdvajanje za sve korisnike

1. Kliknite Pošalji za pokretanje zahtjeva za izdvajanje za sve korisnike i sve njihove lokacije pod trenutnim pružateljem usluga.

Za Cisco BroadWorks i Webex za BroadWorks

1. Alat za izdvajanje radi na sekundarnom Cisco BroadWorks aplikacijskom poslužitelju unutar partnerske mreže i povezuje se putem OCI-P protokola.
2. Alat povlači sirove podatke o poduzeću, grupama, brojevima, korisnicima, uslugama, uređajima i softverskim klijentima s platforme Cisco BroadWorks ili BroadCloud te te podatke pretvara u XML datoteke koje pružaju ulazne podatke za alat za transformaciju.

Sljedeći odjeljci objašnjavaju kako instalirati i konfigurirati alat za izdvajanje.

Preduvjeti

1. SCP premjesti binarne datoteke alata za izdvajanje na sekundarni Cisco BroadWorks aplikacijski poslužitelj.
2. SSH-om se povežite na sekundarni Cisco BroadWorks aplikacijski poslužitelj kako biste konfigurirali preduvjete i pokrenuli alat za izdvajanje.
3. Konfigurirajte davatelja usluga i ID grupe za izdvajanje iz Cisco BroadWorksa u conf/exportTool.yml. Pogledajte sljedeći primjer YAML isječka:

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

4. Provjerite jesu li korisnički ID, lozinka i naziv hosta sekundarnog Cisco BroadWorks aplikacijskog poslužitelja ispravni u 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.
   

   Svojstvo REFRESH_TOKEN je obavezno za migraciju Webexa za BroadWorks.

5. Izmijenite JDK/JRE put okruženja u datoteci export.sh ako je sekundarni Cisco BroadWorks aplikacijski poslužitelj JDK/JRE put okruženja se razlikuje od datoteke:

   JAVA_HOME=/usr/local/java/java_base

Upute za pokretanje

Pokrenite sljedeću naredbu u sekundarnom Cisco BroadWorks aplikacijskom poslužitelju iz direktorija alata za izdvajanje:

./export.sh

Terminalski zapisnici

Nakon uspješnog izvoza u terminalu su dostupni sljedeći zapisnici: Pokretanje alata za izvoz podataka 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

Izlazna ZIP (extracted_data_<timestamp>.zip) datoteka dostupna je u istom direktoriju alata za raspakiranje. Za pregled i korištenje ZIP datoteke za unos alata Transform koristite sljedeću naredbu:

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

Ovaj alat za transformaciju pokreće se za sve migracije. Alat za transformaciju radi na bilo kojem računalu, uključujući administratorsko prijenosno računalo partnera, i koristi javne Webex API-je. Čita izlaznu ZIP datoteku (extracted_data_<timestamp>.zip) alata za izdvajanje kao ulaz i pretvara sirovi XML u JSON format koji koristi alat za opskrbu.

Preduvjeti

Nakon preuzimanja i izdvajanja binarnih datoteka alata za migraciju, konfigurirajte sljedeće preduvjete:

1. Postavite REFRESH_TOKEN (token kopiran iz alata za generiranje tokena) i NAME_OF_MAIN_LOCATION u conf/partner.cfg datoteka:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Po želji postavite ID OMOGUĆAVANJA_(kopiran iz predloška u Partner Hubu) u conf/partner.cfg datoteka:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Za potpuniju provjeru adrese e-pošte korisnika možete opcionalno postaviti ID ZA OMOGUĆAVANJE_.
3. Konfigurirajte nedostajuće informacije u input/customers.csv datoteka (vidi sljedeći odjeljak) ako nedostaje.
4. Dodajte adresu e-pošte krajnjeg korisnika u input/users.csv datoteka.
5. Ako će se omogućiti novi telefoni, dodajte MAC adresu i adresu e-pošte novog telefona korisnika u input/newphones.csv datoteka. Ovo je potrebno samo ako administratori partnera žele omogućiti nove telefone u veleprodaji poziva.
6. Pretvorite BroadWorks pozivne centre u CxEssentials pomoću input/cxessentials.csv datoteka.
7. Po želji, omogućite svojstvo NADOGRADI_SVE_POZIVNE_CENTRE_NA_CX_ESSENTIALS kako biste pretvorili sve pozivne centre u CxEssentials.
8. Koristite input/locations.csv datoteka za podršku migraciji velikih poduzeća koja administratorima omogućuje migraciju lokacija svojih klijenata po lokaciji
9. Opcionalno omogućite korištenje MAC adresa iz zaglavlja korisničkog agenta SIP REGISTER poruke kada MAC adresa nije dostupna u profilu uređaja Cisco BroadWorks. Uklonite komentar iz retka "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" u datoteci conf/partner.cfg
10. Funkcija sinkronizacije mrežnog poslužitelja omogućuje administratorima da dodijele telefonske brojeve, MAC adrese i adrese e-pošte korisnika tijekom dodjele u migraciji iste regije. Da biste ga omogućili, postavite USE_NS_SYNC=yes u conf/partner.cfg.

    Ako je NS sinkronizacija onemogućena, dodjeljivanje telefonskog broja i uređaja bit će preskočeno, a korisnici će dobiti privremene adrese e-pošte.

11. Opcionalno omogućite svojstva ANALOG_KORISNIK_VRSTA_OMOGUĆI_POZIV_ČEKANJE, ANALOG_KORISNIK_VRSTA_OMOGUĆI_GLAZBA_UKLJUČENO_ČEKANJE i ANALOG_KORISNIK_VRSTA_ONEMOGUĆI_T38 za konfiguriranje čekanja poziva, glazbe na čekanju i onemogućavanje postavki T38 za sve korisnike analognog tipa.

Ispunjavanje input/customers.csv

Datoteka input/customers.csv pruža podatke koji možda nedostaju u Cisco BroadWorksu ili BroadCloudu. Ova datoteka može ostati prazna ako su svi obvezni podaci već dostupni. Ne morate ispuniti sve stupce, obavezni su samo nedostajući podaci.

Donja tablica objašnjava najvažnije stupce u input/customers.csv.

Ispunjavanje input/users.csv

Datoteka input/users.csv pruža podatke koji možda nedostaju u Cisco BroadWorksu ili BroadCloudu. Ova datoteka može ostati prazna ako su svi obvezni podaci već dostupni. Ne morate ispuniti sve stupce, obavezni su samo nedostajući podaci.

Upute za pokretanje

Pokrenite alat za transformaciju u bilo kojem operativnom sustavu. Za pokretanje alata u sustavima Windows i macOS slijedite dolje navedene korake:

Windows

Izvršite donju naredbu za pokretanje alata Transform u sustavu Windows:

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

macOS

Izvršite sljedeće korake za pokretanje alata za transformaciju na macOS-u:

1. Izradite virtualno okruženje i instalirajte ovisnosti za pokretanje alata za transformaciju pomoću 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. Pokrenite alat za transformaciju:

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

Customer/user prethodna provjera

Alat za transformaciju upućuje API pozive Webexu kako bi uočio potencijalne probleme s opskrbom. Prema zadanim postavkama, provjerit će adresu i primarnu e-poštu kupca. Ako je vrijednost PROVISIONING_ID navedena u conf/partner.cfg datoteku, također će provjeriti podatke o lokaciji. Rezultati prethodne provjere uključeni su u izvješće o iznimkama.

Osim toga, prilikom pokretanja alata za transformaciju mogu se dodati sljedeći opcionalni parametri:

prethodna provjera

Osim pokretanja API-ja za prethodnu provjeru podataka o kupcima, alat za transformaciju pokrenut će i API za prethodnu provjeru e-pošte pretplatnika.

informacije o prethodnoj provjeri

Prema zadanim postavkama, u izvješće o iznimkama uključene su samo pogreške prethodne provjere (tj. problemi koji će blokirati pružanje usluga). Dodavanje ove zastavice uključivat će i uspješne rezultate prethodne provjere (npr. ako već postoji Webex organizacija koja se može automatski pridružiti).

Terminalski zapisnici

Sljedeće se zapisuje u terminalu nakon uspješne transformacije:

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

Izvješće o iznimci

Alat za transformaciju generira izvješće o iznimci unutar izlaza/<timestamp>/exception_report.txt direktorij. Ovo izvješće možete koristiti za identifikaciju problema koji će utjecati na migraciju i njihovo rješavanje u Cisco BroadWorks sustavu.

Nakon što izmijenite korisničke podatke kako biste riješili iznimku, ponovno pokrenite alate za izdvajanje i transformaciju s novim podacima. Primjer datoteke izvješća o iznimci kako slijedi:

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 (customer.json) datoteka bit će dostupna u output/<timestamp>/<groupid> direktorij. Primjer datoteke customer.json je sljedeći:

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

Alat za opskrbu može se pokrenuti na bilo kojem računalu, obično na administratorskom prijenosnom računalu partnera, i koristi javne Webex API-je. Čita izlaznu JSON datoteku (customer.json) alata za transformaciju kao ulaz i dodjeljuje kupce, lokacije, brojeve, korisnike, usluge i uređaje u Webex Wholesale RTM rješenju.

Preduvjeti

Konfigurirajte sljedeće preduvjete unutar direktorija alata za opskrbu:

1. Instalirajte Javu 8, 11, 17 ili 21 na računalo. Java je dostupna iz mnogih 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 izdvajanja binarnih datoteka alata za migraciju, postavite varijablu okruženja JAVA_HOME u provisioning_tool.sh za MAC i provisioning_tool.bat za Windows.
3. Datoteka partner.cfg:
   • Postavite ID VELEPRODAJE_OMOGUĆAVANJA_i TOKEN ZA OSVJEŽAVANJE_(token kopiran iz alata za generiranje tokena). Administratori partnera moraju kontaktirati svoj tim za korisničke račune kako bi dobili ID ZA PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Postavite DOPUSTI_ADMIN_POZOVI_E-POŠTU na lažno ako partner ne želi poslati e-poštu dobrodošlice korisnicima. Zadana vrijednost je istina.

4. Koristite svojstvo WEBEX4BWKS_EMAIL_SUBJECT za migracije Webex for BroadWorks kako biste poslali predmet e-pošte sa zahtjevom za promjenu lozinke pretplatnicima Webex for BroadWorks.
5. Koristite svojstvo WEBEX4BWKS_EMAIL_BODY za migracije Webexa za BroadWorks kako biste poslali tijelo e-pošte sa zahtjevom za promjenu lozinke za pretplatnike Webexa za BroadWorks.
6. Funkcija sinkronizacije mrežnog poslužitelja omogućuje administratorima da dodijele telefonske brojeve, MAC adrese i adrese e-pošte korisnika tijekom dodjele u migraciji iste regije. Da biste ga omogućili, postavite USE_NS_SYNC=yes u conf/partner.cfg.

   Ako je NS sinkronizacija onemogućena, dodjeljivanje telefonskog broja i uređaja bit će preskočeno, a korisnici će dobiti privremene adrese e-pošte.

Za migracije BroadClouda u istoj regiji:

1. Alat preskače dodjelu brojeva, uređaja i prikaza zajedničkih poziva.
2. Alat stvara korisnike i virtualne korisnike s ekstenzijom i privremenom ekstenzijom.

Za BroadCloud migracije u drugu regiju:

1. Alat će osigurati brojeve, uređaje i dijeljene prikaze poziva.
2. Alat stvara korisnike i virtualne korisnike sa stvarnim telefonskim brojevima i ekstenzijama.
   Sve migracije BroadClouda iz Europe su u drugu regiju.

Upute za pokretanje

Za pokretanje alata u sustavima Windows i macOS slijedite sljedeće korake:

Windows

Za pokretanje alata na Windows OS-u izvršite sljedeće korake:

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

macOS

Za pokretanje alata na macOS-u izvršite sljedeće korake:

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

Preduvjeti za migraciju Webexa za BroadWorks

Administratori partnera moraju ažurirati svoj predložak za uvođenje u BroadWorks za značajke koegzistencije Webexa za BroadWorks. Pogledajte sljedeću sliku:

Nakon što se predložak za uvođenje u Webex za BroadWorks ažurira kako bi podržao migraciju, zatražite od Cisco tima za korisničke račune da omogući prekidač značajke "omogućeno veleprodajno-partnersko-miješanje" na razini partnera. To će omogućiti dodavanje veleprodajnih paketa postojećim korisničkim organizacijama Webexa za BroadWorks tijekom pružanja usluga.

Pokrenite alat za opskrbu s dodatnim argumentom.

Pripremna faza: je zadana faza u kojoj administratori mogu osigurati korisnike BroadWorksa kao veleprodajne pretplatnike i nastaviti s Webexom za korisnike BroadWorksa.

Faza održavanja: je druga faza u kojoj administratori mogu dodijeliti veleprodajnu licencu postojećim korisnicima Webexa za BroadWorks. Alat za opskrbu morate pokrenuti s argumentom održavanje.

Faza nakon migracije: Ovo je završna faza u kojoj administratori mogu potpuno pretvoriti BroadWorks u veleprodaju. Alat za opskrbu morate pokrenuti s argumentom nakon migracije.

Terminalski zapisnici

Slijede zapisnici u terminalu o uspješnom pružanju usluga:

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

Ispisat će se tablica s brojem kreiranih lokacija za svako pokretanje:

Izlaz

Alat za opskrbu generira izvješća o uspjehu i pogreškama unutar izlaza/<external_id>/*.success/error datoteke. Pregledajte zapisnike uspjeha i pogrešaka izlaza kako biste provjerili uspješnost pružanja usluga.

Administratori partnera mogu provjeriti pružanje usluga korisnicima na portalu Partner Hub i Control Hub. Pogledajte sljedeće ilustracije s portala Partner Hub i Control Hub:

Slika 8.: Partner Hub

Slika 9.: Control Hub

Slika 10.: Uređaji

Slika 11.: Pozivanje

Za BroadCloud

Za BroadCloud partnere, koristite portal pružatelja usluga za slanje zahtjeva za migraciju brojeva, uređaja i migracija Shared Call Appearances (SCA).

Unutar portala pružatelja usluga, zahtjev za migraciju može uključivati do 50 korisnika. U jednom danu može se podnijeti najviše 10 zahtjeva.

Funkcija sinkronizacije mrežnog poslužitelja omogućuje administratorima deaktivaciju lokacije broadCloud i aktivaciju lokacije Webex Calling postavljanjem USE_NS_SYNC=yes u conf/partner.cfg. Nakon migracije, uređaji i telefonski brojevi aktiviraju se na lokaciji Webex Calling.

Administratori mogu omogućiti automatsko vraćanje na prethodno stanje postavljanjem ROLLBACK_TO_BROADCLOUD=true u datoteci conf/partner.cfg, što uređaje vraća na BroadCloud nakon migracije. Podržava migracije i iz iste i iz različitih regija s NS Sync-om, ali samo za uspješne migracije. Za neuspješne, administratori moraju podići Cisco TAC prije nego što zatraže vraćanje na prethodno stanje.

Na portalu su dostupne dvije opcije za odabir vrste migracije:

• Migracija – Odaberite ovu opciju za pokretanje zahtjeva za migraciju brojeva, uređaja i prikaza zajedničkih poziva (SCA).
• Status uređaja – Odaberite ovu opciju za prikaz trenutnog statusa uređaja na BroadCloudu i Callingu.

Sljedeće slike prikazuju portal pružatelja usluga.

Slika 12.: Portal pružatelja usluga

Slika 13.: Portal pružatelja usluga

Migriraj odabrane lokacije (nije obavezno)

Za pokretanje migracije za određeni podskup lokacija navedenih u datoteci customer.json, uz zahtjev priložite datoteku locations.csv. Ovaj CSV treba navesti samo lokacije koje namjeravate migrirati.

Za preuzimanje popisa dostupnih aktivnih lokacija idite na Pregledaj klijente → Odaberi klijenta → Izvoz lokacija kao CSV.

Slika 14.: Izvoz lokacija kao CSV

Za Cisco BroadWorks i Webex za BroadWorks

Za migracije Cisco BroadWorksa i Webexa za BroadWorks, alat se pokreće na sekundarnom Cisco BroadWorks aplikacijskom poslužitelju unutar partnerske mreže i povezuje se s AS-om putem OCI-P-a. Koristi izlaznu JSON datoteku (customer.json) alata Transform kao ulaz i pokreće OCI-P naredbe za migraciju uređaja i softverskih klijenata.

Nakon uspješne operacije, alat za premještanje uređaja će:

1. Odregistrirajte uređaje iz Cisco BroadWorksa i registrirajte ih u veleprodaji.
2. Korisnici koji koriste UC-One klijent preusmjerit će se na Webex aplikaciju prilikom prve prijave.
3. Deaktivirajte telefonske brojeve iz Cisco BroadWorksa ili uklonite telefonske brojeve iz BroadClouda.
4. Aktivirajte brojeve u veleprodaji.
5. Stvorite dijeljene prikaze poziva u veleprodaji za migracije BroadClouda. [This korak je primjenjiv samo za BroadCloud migrations].

SCP i SSH

1. SCP alat za premještanje uređaja na sekundarni Cisco BroadWorks aplikacijski poslužitelj.
2. SSH-om se povežite na sekundarni Cisco BroadWorks aplikacijski poslužitelj kako biste konfigurirali preduvjete i pokrenuli alat za premještanje uređaja.

Preduvjeti

1. Postavite REFRESH_TOKEN (token kopiran iz alata za generiranje tokena) u conf/partner.cfg datoteka:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Provjerite jesu li korisnički ID, lozinka i naziv hosta sekundarnog Cisco BroadWorks aplikacijskog poslužitelja ispravni u conf/deviceMoveTool.conf datoteka:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Za ponovno slanje aktivacijskih e-poruka, morate postaviti PONOVO POŠALJI_POZIVNICU_EMAILS=true u conf/partner.cfg datoteka.

   Ako administratori žele poslati e-poruke s pozivnicama svojim korisnicima tijekom migracije, trebaju ukloniti komentar iz polja "PONOVNO POŠALJI_POZIVNICU_EMAILS=true" nekretnina u conf/partner.cfg datoteka. U suprotnom, nekretnina bi trebala ostati nepromijenjena.

4. Provjerite JDK/JRE put okruženja je ispravan u devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratori mogu koristiti datoteku locations.csv iz ulaznog direktorija za migraciju određenih grupa umjesto svih grupa unutar poduzeća.

Polycom telefoni

Za premještanje Polycom telefona iz Cisco BroadWorksa u Wholesale Calling, administrator partnera mora stvoriti novi Identity/Device Datoteka tipa profila na razini sustava u Cisco BroadWorksu svaki predložak Polycom uređaja. Pogledajte sliku 14 i prenesite prilagođenu datoteku device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Nakon prijenosa nove datoteke uređaja, provjerite postoji li novostvorena datoteka na razini grupe. Također provjerite da datoteka migration_%BWMAC ADDRESS%.cfg nije u sukobu s bilo kojom postojećom datotekom u vašem sustavu.

Koristi ga interno alat za premještanje uređaja.

Proces migracije za Polycom telefone:

1. Alat za premještanje uređaja zamjenjuje datoteku %BWMACADDRESS%.cfg na razini uređaja s polycom_vvx2.cfg. Ova datoteka se odnosi na migration_%BWMACADDRESS%.cfg.
2. Ponovno izgradite profile uređaja na razini grupe ili na razini uređaja.
   Djelovanje na razini grupe ili uređaja ovisi o konfiguraciji parametra deviceLevelRebuild u datoteci device-move-tool/conf/partner.cfg.
3. Alat za premještanje uređaja traži od Cisco BroadWorks Application Servera da ponovno pokrene telefone na razini grupe ili uređaja.
4. Nakon zahtjeva za ponovno pokretanje, Polycom telefoni preuzimaju i obrađuju% BWMACADDRESS%.cfg, što traži od Polycom telefona da preuzmu i obrade migration_%BWMACADDRESS%.cfg, što postavlja device.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com za regiju SAD-a, ostale regije imaju drugačije URL-ove.
5. Polycom telefon preuzima %BWMACADDRESS%.cfg datoteku s https://plcm.sipflash.com i njime će upravljati Webex Calling DMS.

Slika 14.: Identity/device dodavanje datoteke tipa profila

Upute za pokretanje

Postoje dvije metode za pozivanje DMT-a, prva je pozivanje kroz jednog korisnika istovremeno, a druga je istovremeno pokretanje kroz više korisnika.

Alat za premještanje uređaja pokreće se sa sekundarnog Cisco BroadWorks aplikacijskog poslužitelja unutar direktorija alata za premješ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

Terminalski zapisnici

Slijede zapisnici u terminalu o uspješnom pokretanju alata za premješ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 povezani s internetom i spremni za make/receive pozivi. Primjer statusa uređaja prikazan je na slici 15:

Slika 15.: Status uređaja

Nakon migracije uređaja, brojevi su postali aktivni. Primjer aktivnih brojeva prikazan je na slici 16:

Slika 16.: Aktivni brojevi

Operacija vraćanja mora se izvršiti za jedno poduzeće istovremeno.

Za BroadCloud operatera

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

1. Otvorite tiket kod Cisco TAC-a kako biste zatražili vraćanje uređaja.
2. Pokrenite alat za premještanje uređaja u načinu vraćanja:
   • Telefonski brojevi neće biti dodijeljeni iz Webex Callinga, ostavljajući korisnicima i uslugama samo ekstenzije.
   • E-mail adrese u Webex Callingu bit će vraćene na privremene e-mail adrese.
   • Telefoni će biti izbrisani iz Webex Callinga.
   • Telefonski brojevi, adrese e-pošte korištene kao alternativni ID-ovi i telefoni bit će ponovno kreirani u BroadCloudu.
   • Telefoni će se ponovno pokrenuti.
3. Administratori partnera moraju vratiti PSTN telefonske brojeve tvrtki BroadCloud Carrier.

Za Cisco BroadWorks i Webex za BroadWorks

Postupak vraćanja za Cisco BroadWorks i Webex za BroadWorks je sljedeći:

1. Otvorite tiket kod Cisco TAC-a kako biste zatražili vraćanje uređaja.
2. Pokrenite alat za premještanje uređaja u načinu vraćanja na sekundarnom BroadWorks aplikacijskom poslužitelju kako biste vratili migracije uređaja. Ovim će se DMS URL vratiti na DMS URL pružatelja usluga za profile uređaja u Cisco BroadWorksu i ponovno aktivirati telefonski brojevi.
3. Webex Calling tim vraća DMS URL na DMS URL pružatelja usluge u profilima uređaja u Webex Callingu.
4. Administratori partnera moraju deaktivirati ili izbrisati telefonske brojeve u Webex Callingu putem portala Control Hub.
5. Administratori partnera moraju vratiti PSTN telefonske brojeve u Cisco BroadWorks.

Upute za pokretanje alata za premještanje uređaja u načinu vraćanja

Slijedite korake u nastavku za pokretanje alata za premještanje uređaja u načinu vraćanja:

Pokrenite naredbu u nastavku na sekundarnom Cisco BroadWorks aplikacijskom poslužitelju unutar direktorija alata za premještanje uređaja:

Vrati profile

./devicemove.sh -input=  -revertProfiles

Vrati brojeve

./devicemove.sh -input=  -revertNumbers

Terminalski zapisnici

Nakon uspješnog pokretanja alata za premještanje uređaja za operaciju vraćanja u prethodno stanje, u terminalu ćemo dobiti sljedeće zapise:

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