Podržani telefoni automatski će se izraditi i dodijeliti korisnicima u usluzi Webex Calling pomoću alata za dodjelu resursa. Telefoni s oznakom "da" u stupcu "Podržano u alatu za premještanje uređaja" također će se automatski premjestiti iz usluga Cisco BroadWorks ili BroadCloud u Webex Calling kada se pokrene alat za premještanje uređaja. Telefonima s oznakom "Ne" u tom stupcu potrebna je ručna intervencija za promjenu URL DMS-a u predlošku uređaja Cisco BroadWorks ili na samom telefonu.

Posljednji stupac pruža mapiranje modela telefona u stupac „Vrsta uređaja“ datoteke transform-tool/input/newphones.csv. (Pogledajte odjeljak Alat za transformaciju ovog članka za više informacija o newphones.csv).

Administratori partnera pokreću ovaj alat uslužnog programa za generator tokena barem jednom prije nego što počnu pokretati alate za migraciju. Pokretanje ovog alata jednokratna je aktivnost nakon omogućavanja partnerskog računa u rješenje RTM za veleprodaju. Ovaj alat omogućuje administratorima partnera prijavu putem web-preglednika kako bi dobili jedinstveni TOKEN potreban za ažuriranje na konfiguracijske datoteke 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 token:

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 vjerodajnicama partnerskog administratora kako biste dobili TOKEN i kopirajte ga za daljnju upotrebu.

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

Slika 3: Prijavite se putem Cisco Webexa

Slika 4: Prozor vjerodajnica

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 povezivanje

Alat za premještanje uređaja komunicira s uslugom BroadWorks putem naredbi OCI-P, kako biste omogućili povezivanje OCI-P pomoću koraka u nastavku:

Korak 1: Upotrijebite CLI za konfiguriranje općih postavki.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Pokrenite sljedeću naredbu u CLI-ju kako biste dobili trenutačne GeneralSettings:

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

Ako se vaše postavke ne podudaraju s gore navedenim, upotrijebite naredbu postavi za ponovno konfiguriranje postavki.

Korak 2: Upotrijebite CLI za konfiguriranje OCI proxy poslužitelja.

Promijenite imenik na OCI proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Pokrenite sljedeći CLI prikaz trenutačnih postavki. 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 se vaše postavke ne podudaraju s gore navedenim, upotrijebite naredbu postavi za ponovno konfiguriranje postavki.

Korak 3: Upotrijebite CLI za konfiguriranje dodjele OCI-ja.

Promjena u imeniku omogućavanja:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Pokrenite sljedeću naredbu kako biste dobili trenutačne postavke omogućavanja OCI-ja:

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

Korak 4: Pokrenite naredbu u nastavku u CLI formatu kako biste provjerili je li vaša konfiguracija toč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.

Provjerite je li poslužitelj otvorenog klijenta implementiran i aktivan

Upotrijebite naredbe u nastavku za implementaciju i pokretanje poslužitelja otvorenog klijenta na sekundarnom poslužitelju aplikacije ako nije implementiran ili već nije pokrenut.

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Korak 2: Pokreni poslužitelj s 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 aktiviranje brojeva:

Korak 1: Pokreni naredbu za aktiviranje broja:

AS_CLI> cd SubscriberMgmt/NumberActivation

Korak 2: Pokrenite naredbu omogućenu za aktivaciju:

AS_CLI> set dnMode groupAndUserActivationEnabled

Korak 3: Kada se od vas zatraži potvrda, unesite Y.

Za BroadCloud

Alat za izdvajanje integriran je u portal davatelja usluga BroadCloud. Administrator davatelja usluge može:

1. Pošaljite zahtjeve za ekstrakciju za do 50 korisnika po zahtjevu.
   Zahtjev za izdvajanje ne može se podnijeti za istog korisnika više od 10 puta dnevno.
2. Preuzmite izvađenu datoteku podataka, u ZIP formatu, najviše 28 dana od datuma podnošenja zahtjeva.

Slike u nastavku prikazuju portal davatelja usluga.

Slika 6.: Portal pružatelja usluga

Slika 7.: Portal pružatelja usluga

Za Cisco BroadWorks i Webex za BroadWorks

1. Alat za izdvajanje izvodi se na sekundarnom poslužitelju aplikacije Cisco BroadWorks unutar partnerske mreže i povezuje se putem OCI-P-a.
2. Alat povlači neobrađene podatke poduzeća, skupine, brojeva, korisnika, usluga, uređaja i softverskih klijenata iz Cisco BroadWorksa ili BroadCloud platforme i izlaže te podatke u XML datoteke koje pružaju ulaze za alat za transformaciju.

U sljedećim odjeljcima objašnjeno je kako instalirati i konfigurirati alat za izdvajanje.

Preduvjeti

1. SCP binarne datoteke alata za izdvajanje na sekundarni poslužitelj aplikacije Cisco BroadWorks.
2. SSH na sekundarni poslužitelj aplikacije Cisco BroadWorks za konfiguriranje preduvjeta i pokretanje alata za izdvajanje.
3. Konfigurirajte davatelja usluga i ID skupine za izdvajanje iz usluge Cisco BroadWorks u alatu conf/exportTool.yml. Pogledajte uzorak YAML isječka u nastavku:

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

4. Provjerite jesu li sekundarni ID korisnika poslužitelja aplikacije Cisco BroadWorks, lozinka i ime glavnog računala ispravni 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.
   

   REFRESH_TOKEN Svojstvo je obavezno za Webex za BroadWorks migraciju.

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

   JAVA_HOME=/usr/local/java/java_base

Upute za pokretanje

Pokrenite naredbu u nastavku na sekundarnom Cisco BroadWorks Application Server iz direktorija alata za izdvajanje:

./export.sh

Zapisnici terminala

Sljedeći zapisnici dostupni su na terminalu prilikom uspješnog izvoza: Pokreće se BroadSoft alat 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 (extracted_data_<timestamp>.zip) datoteka bit će dostupna u istom direktoriju alata za izdvajanje. Upotrijebite naredbu u nastavku za prikaz i korištenje ZIP datoteke za unos alata za transformaciju:

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 pokrenut je za sve migracije. Alat za transformaciju izvodi se na bilo kojem računalu, uključujući administratorski laptop partnera i koristi Webex javne API-je. Čita ZIP (extracted_data_<timestamp>.zip) datoteku kao ulaz i pretvara neobrađeni XML u JSON format koji koristi alat za dodjelu resursa.

Preduvjeti

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

1. Postavite TOKEN OSVJEŽAVANJA_(Token kopiran iz alata generatora tokena) i NAZIV_GLAVNE__LOKACIJE u datoteci conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opcionalno postavite ID_DODJELE RESURSA (kopiran iz predloška u okruženju Partner Hub) u datoteku conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Da biste dobili potpunije provjeru adrese e-pošte korisnika, po želji možete postaviti ID_ZA OMOGUĆAVANJE.
3. Ako nedostaju, konfigurirajte informacije koje nedostaju u datoteci input/customers.csv (pogledajte sljedeći odjeljak).
4. Dodajte adresu e-pošte krajnjeg korisnika u datoteku input/users.csv.
5. Ako želite dodijeliti nove telefone, dodajte MAC adresu i adresu e-pošte korisničkog novog telefona u datoteku input/newphones.csv. To je obavezno samo ako partnerski administratori žele omogućiti nove telefone u pozivima za Wholesale.
6. Konvertirajte BroadWorks pozivne centre u CxEssentials pomoću datoteke input/cxessentials.csv.
7. Opcionalno, omogućite svojstvo NADOGRADNJE_SVIH_POZIVNIH_CENTARA_U_CX_ESSENTIALS kako biste konvertirali sve pozivne centre u CxEssentials.
8. Upotrijebite datoteku input/locations.csv kako biste podržali migraciju velikih poduzeća koja administratorima omogućava migraciju lokacija svojih korisnika prema lokaciji
9. Opcijski omogućite upotrebu MAC adresa iz zaglavlja Korisnik-Agent poruke SIP REGISTER kada MAC adresa nije dostupna u profilu uređaja Cisco BroadWorks. Poništi komentar retka „UPOTRIJEBI_MAC_ADRESU_IZ_SIP_REGISTER=da“ u datoteci conf/partner.cfg
10. Značajka sinkronizacije mrežnog poslužitelja administratorima omogućuje dodjelu telefonskih brojeva, MAC adresa i adresa e-pošte korisnika tijekom omogućavanja u istoj migraciji regije. Kako biste je omogućili, postavite USE_NS_SYNC=yes u conf/partner.cfg.

    Ako je onemogućena NS sinkronizacija, preskočit će se broj telefona i dodjeljivanje uređaja, a korisnici će dobiti privremene adrese e-pošte.

Ispunite input/customers.csv

Datoteka input/customers.csv pruža podatke koji možda nedostaju u Cisco BroadWorksu ili BroadCloudu. Datoteka se može ostaviti prazna ako su sve obvezne informacije već dostupne. Ne morate ispuniti sve stupce, obavezni su samo podaci koji nedostaju.

U tablici u nastavku objašnjeni su najvažniji stupci u stavci input/customers.csv.

Upute za pokretanje

Pokrenite alat za transformaciju u bilo kojem operacijskom sustavu. Pomoću koraka u nastavku pokrenite alat u sustavu Windows i macOS:

Windows

Izvršite naredbu u nastavku za pokretanje alata za transformaciju u sustavu Windows:

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

macOS

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

1. Stvori virtualno okruženje i instaliraj ovisnosti za pokretanje alata transformacije 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=

Prethodna provjera korisnika/korisnika

Alat za transformaciju upućuje API pozive prema Webexu kako bi uložio potencijalne probleme s dodjelom resursa. Prema zadanim postavkama provjerava se valjanost adrese i primarne e-pošte korisnika. Ako je ID_DODJELE RESURSA navedena u datoteci conf/partner.cfg, provjerit će i informacije o lokaciji. Rezultati prethodnih provjera uključeni su u izvješće o izuzecima.

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

prethodna provjera

Osim pokretanja API-ja za prethodnu provjeru za informacije o korisniku, alat za transformaciju također će pokrenuti API za prethodnu provjeru za e-poštu pretplatnika.

informacije o pretpregledu

Prema zadanoj vrijednosti u izvješću o izuzecima uključene su samo pogreške prethodne provjere (tj. problemi koji će blokirati omogućavanje). Dodavanje ove zastave uključivat će i uspješne rezultate prethodnih provjera (npr. ako već postoji organizacija usluge Webex koja se može automatski priložiti).

Zapisnici terminala

Sljedeći zapisnici u terminalu na uspješnoj transformaciji:

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 izuzecima

Alat za transformaciju generira izvješće o izuzecima u direktoriju output/<timestamp>/exception_report.txt . Ovim izvješćem možete identificirati probleme koji će utjecati na migraciju i riješiti ih u sustavu Cisco BroadWorks.

Nakon izmjene korisničkih podataka kako biste riješili iznimku, ponovno pokrenite alate za izdvajanje i transformaciju s novim podacima. Datoteka oglednog izvješća o izuzecima 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 izlaznom/<timestamp>/<groupid> direktoriju. Ogledna datoteka customer.json je sljedeć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"
    }
}

Alat za dodjelu resursa može se izvoditi na bilo kojem uređaju, obično na prijenosnom računalu (administratorskom prijenosnom računalu partnera) i koristi Webex javne API-je. Čita JSON (customer.json) datoteku alata za transformaciju kao unos i omogućavanje korisnika, lokacija, brojeva, korisnika, usluga i uređaja u rješenju Webex Wholesale RTM.

Preduvjeti

Konfigurirajte sljedeće preduvjete u direktoriju alata za omogućavanje:

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 alata za migraciju, postavite JAVA_HOME varijablu okruženja u provisioning_tool.sh za MAC i provisioning_tool.bat za Windows.
3. Datoteka partner.cfg:
   • Postavite ID_DODJELE RESURSA_WHOLESALE i OSVJEŽITE_TOKEN (Token kopiran iz alata za generator tokena). Partnerski administratori moraju se obratiti svom timu za račun kako bi dobili ID_dodjele resursa:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Postavite opciju DOPUSTI_ADMINISTRATORSKE_PORUKE E-POŠTE s pozivnicama_ ako partner ne želi korisnicima poslati e-poštu dobrodošlice. Zadana vrijednost je istinita.

4. Upotrijebite svojstvo predmeta WEBEX4BWKS_E-POŠTE_za Webex za BroadWorks migracije kako biste poslali predmet e-pošte sa zahtjevom za promjenu lozinke za Webex za pretplatnike na BroadWorks.
5. Upotrijebite svojstvo tijela e-pošte WEBEX4BWKS_E-POŠTE_za Webex za BroadWorks migracije kako biste poslali tijelo e-pošte sa zahtjevom za promjenu lozinke za Webex za BroadWorks pretplatnike.
6. Značajka sinkronizacije mrežnog poslužitelja administratorima omogućuje dodjelu telefonskih brojeva, MAC adresa i adresa e-pošte korisnika tijekom omogućavanja u istoj migraciji regije. Kako biste je omogućili, postavite USE_NS_SYNC=yes u conf/partner.cfg.

   Ako je onemogućena NS sinkronizacija, preskočit će se broj telefona i dodjeljivanje uređaja, a korisnici će dobiti privremene adrese e-pošte.

Za migracije na uslugu BroadCloud ista regija:

1. Alat preskače brojeve, uređaje i omogućavanje dijeljenih pojavljivanja poziva.
2. Alat stvara korisnike i virtualne korisnike s kućnim brojem i privremenim kućnim brojem.

Za migracije na BroadCloud, druga regija:

1. Alat će omogućiti brojeve, uređaje i prikaze dijeljenih poziva.
2. Alat stvara korisnike i virtualne korisnike sa stvarnim telefonskim brojevima i kućnim brojevima.
   Sve migracije usluge Europe BroadCloud nalaze se u drugoj regiji.

Upute za pokretanje

Koristite sljedeće korake za pokretanje alata u sustavima Windows i macOS:

Windows

Izvršite sljedeće korake za pokretanje alata na operacijskom sustavu Windows:

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

macOS

Izvršite sljedeće korake za pokretanje alata na sustavu macOS:

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

Preduvjeti za Webex za BroadWorks migraciju

Partnerski administratori moraju ažurirati svoj predložak aktiviranja u BroadWorks za Webex za značajke supostojanja BroadWorks. Pogledajte sljedeću sliku:

Nakon što se predložak aktiviranja usluge Webex za BroadWorks ažurira kako bi podržao migraciju, zatražite od tima Cisco računa da omogući tipku za uključivanje/isključivanje značajke „wholesale-partner-blending-enabled” na razini partnera. To će omogućiti dodavanje paketa za veleprodaju postojećim korisničkim organizacijama usluge Webex za BroadWorks tijekom omogućavanja.

Pokrenite alat za omogućavanje s dodatnim argumentom.

Faza pripreme: zadana je faza u kojoj administratori mogu omogućiti korisnike BroadWorksa kao pretplatnika veleprodaje i nastaviti s Webexom za korisnike BroadWorksa.

Faza održavanja: je druga faza u kojoj administratori mogu dodijeliti licencu za veleprodaju postojećem Webexu za BroadWorks korisnike. Morate pokrenuti alat za omogućavanje s argumentom održavanja.

Faza nakon migracije: To je završna faza kada administratori mogu u potpunosti konvertirati BroadWorks u veleprodaju. Morate pokrenuti alat za omogućavanje s argumentom nakon migracije.

Zapisnici terminala

Slijede zapisnici u terminalu o uspješnom omogućavanju:

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

Tablica će biti ispisana s brojem stvorenih lokacija za svako izvođenje:

Izlaz

Alat za omogućavanje generira izvješća o uspjehu i pogreškama u datotekama output/<external_id>/*.success/error . Pregledajte zapisnike o uspjehu izlaza i zapisnike pogrešaka kako biste potvrdili uspješno omogućavanje.

Administratori partnera mogu potvrditi omogućavanje korisnika na portalu Partner Hub i Control Hub. Pogledajte sljedeće ilustracije na portalu Partner Hub i Control Hub:

Slika 8.: Čvorište partnera

Slika 9.: Control Hub

Slika 10.: Uređaji

Slika 11.: Pozivanje

Za BroadCloud

Za partnere iz platforme BroadCloud upotrijebite portal davatelja usluga za slanje zahtjeva za migraciju brojeva, uređaja i SCA migracija.

Na portalu davatelja usluga zahtjev za migraciju može uključivati do 50 korisnika. Najviše 10 zahtjeva može se podnijeti u roku od jednog dana.

Značajka sinkronizacije mrežnog poslužitelja administratorima omogućuje da deaktiviraju lokaciju broadCloud i aktiviraju lokaciju 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 postavljanjem ROLLBACK_TO_BROADCLOUD=true u conf/partner.cfg datoteci koja nakon migracije premješta uređaje natrag u BroadCloud. Podržava i migracije istih i različitih regija s NS sinkronizacijom, ali samo za uspješne migracije. Za neuspješne slučajeve administratori moraju podići Cisco TAC prije nego što zatraže vraćanje.

Slike u nastavku prikazuju portal davatelja usluga.

Slika 12.: Portal pružatelja usluga

Slika 13.: Portal pružatelja usluga

Za Cisco BroadWorks i Webex za BroadWorks

Za Cisco BroadWorks i Webex za migracije BroadWorks alat se izvodi na sekundarnom Cisco BroadWorks aplikacijskom poslužitelju unutar partnerske mreže i povezuje se na AS preko OCI-P. Koristi izlaznu datoteku JSON (customer.json) alata za transformaciju kao unos i pokretanje OCI-P naredbi za migriranje uređaja i softverskih klijenata.

Ako je operacija uspješna, alat za premještanje uređaja:

1. Odregistrirajte uređaje iz Cisco BroadWorksa i registrirajte ih u veleprodaji.
2. Korisnici koji upotrebljavaju UC-One klijenta preusmjerit će se na aplikaciju Webex prilikom prve prijave.
3. Deaktivirajte telefonske brojeve tvrtke Cisco BroadWorks ili uklonite telefonske brojeve iz BroadClouda.
4. Aktivirajte brojeve u veleprodaji.
5. Izradite prikaze dijeljenih poziva u veleprodaji za BroadCloud migracije. [Ovaj korak primjenjiv je samo za migracije na BroadCloud].

SCP i SSH

1. SCP alat za premještanje uređaja na sekundarni poslužitelj aplikacije Cisco BroadWorks.
2. SSH na sekundarni poslužitelj aplikacije Cisco BroadWorks za konfiguriranje preduvjeta i pokretanje alata za premještanje uređaja.

Preduvjeti

1. Postavite TOKEN OSVJEŽAVANJA_(Token kopiran iz alata generatora tokena) u datoteku conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Provjerite jesu li sekundarni ID, lozinka i naziv glavnog računala poslužitelja aplikacije Cisco BroadWorks točni u datoteci conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Za ponovno slanje aktivacijske e-pošte morate postaviti PONOVNO POŠALJI_E-POŠTU POZIVNICE_=true u datoteci conf/partner.cfg.

   Ako administratori žele poslati poruke e-pošte s pozivnicom svojim korisnicima tijekom migracije, trebali bi poništiti komentar svojstva „RESEND_INVITATION_EMAILS=true” u datoteci conf/partner.cfg. U suprotnom, nekretnina bi trebala ostati nepromijenjena.

4. Provjerite je li put okruženja JDK/JRE točan u aplikaciji devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Telefoni tvrtke Polycom

Za premještanje telefona Polycom iz Cisco BroadWorksa u Wholesale Calling, partnerski administrator mora izraditi novu datoteku vrste profila identiteta/uređaja na razini sustava u Cisco BroadWorksu svakom predlošku uređaja Polycom. Pogledajte sliku 14 i prenesite prilagođenu datoteku device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Nakon prijenosa datoteke novog uređaja provjerite postoji li novoizrađena datoteka na razini skupine. Također provjerite je li datoteka migration_%BWMAC ADDRESS%.cfg u sukobu s postojećom datotekom u sustavu).

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

Proces migracije za telefone Polycom:

1. Alat za premještanje uređaja zamjenjuje datoteku %BWMACADDRESS%.cfg na razini uređaja s polycom_vvx2.cfg. Ova se datoteka odnosi na migration_%BWMACADDRESS%.cfg.
2. Ponovno izradite profile uređaja na razini skupine ili uređaja.
   Djelovanje na razini skupine ili uređaja ovisi o konfiguraciji parametra deviceLevelRebuild u datoteci device-move-tool/conf/partner.cfg.
3. Alat za premještanje uređaja od poslužitelja aplikacije Cisco BroadWorks traži ponovno pokretanje telefona na razini skupine ili uređaja.
4. Nakon zahtjeva za ponovno pokretanje, Polycom telefoni preuzimaju i process% BWMACADDRESS%.cfg, što od Polycom telefona traži preuzimanje i process migration_%BWMACADDRESS%.cfg, što postavlja uređaj.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com za regiju SAD-a, druge regije imaju različite URL-ove.
5. Telefon Polycom preuzima %BWMACADDRESS%.cfg iz https://plcm.sipflash.com i njima upravlja DMS usluge Webex Calling.

Slika 14.: Dodavanje datoteke vrste identiteta / profila uređaja

Upute za pokretanje

Postoje dvije metode pozivanja na DMT, prva je pozivanje kroz jednog korisnika u isto vrijeme, a druga je pokretanje kroz više korisnika istovremeno.

Alat za premještanje uređaja pokreće se iz sekundarnog poslužitelja aplikacije Cisco BroadWorks 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

Zapisnici terminala

U terminalu su sljedeći zapisnici 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 se povezali i spremni za upućivanje/primanje poziva. Pogledajte sliku 15 kako biste vidjeli primjer statusa uređaja:

Slika 15.: Status uređaja

Nakon migracije uređaja, brojevi su se aktivirali. Pogledajte sliku 16 kako biste vidjeli primjer brojeva koji su aktivni:

Slika 16.: Brojevi aktivni

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

Za BroadCloud operatera

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

1. Otvorite kartu s Cisco TAC-om kako biste zatražili vraćanje uređaja.
2. Pokrenite alat za premještanje uređaja u načinu vraćanja:
   • Telefonskim brojevima poništit će se dodjela za Webex Calling, ostavljajući korisnike i usluge samo s kućnim brojevima.
   • Adrese e-pošte u usluzi Webex Calling vratit će se na privremene adrese e-pošte.
   • Telefoni će se izbrisati iz usluge Webex Calling.
   • Telefonski brojevi, adrese e-pošte koje se upotrebljavaju kao alternatedId-ovi i telefoni ponovno će se izraditi u BroadCloudu.
   • Telefoni će se ponovno pokrenuti.
3. Administratori partnera moraju premjestiti PSTN telefonske brojeve natrag u BroadCloud Carrier.

Za Cisco BroadWorks i Webex za BroadWorks

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

1. Otvorite kartu s Cisco TAC-om kako biste zatražili vraćanje uređaja.
2. Pokrenite alat za premještanje uređaja u načinu vraćanja na sekundarnom poslužitelju BroadWorks aplikacije za vraćanje migracija uređaja. To će vratiti URL DMS-a na URL DMS davatelja usluge za profile uređaja u Cisco BroadWorksu i ponovno aktivirati telefonske brojeve.
3. Tim za Webex Calling vraća URL DMS na URL DMS davatelja usluge u profilima uređaja u usluzi Webex Calling.
4. Administratori partnera moraju deaktivirati ili izbrisati telefonske brojeve u usluzi Webex Calling putem portala Control Hub.
5. Administratori partnera moraju premjestiti PSTN telefonske brojeve natrag u Cisco BroadWorks.

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

Slijedite korake u nastavku kako biste pokrenuli alat 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

Zapisnici terminala

U terminalu ćemo dobiti sljedeće zapisnike o uspješnom pokretanju alata za premještanje uređaja za vraćanje rada:

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