A támogatott telefonokat a rendszer automatikusan létrehozza és rendeli hozzá a felhasználókhoz a Webex Calling alkalmazásban. A „Támogatott az eszközáthelyezési eszközben” oszlopban „igen” jelölésű telefonok szintén automatikusan átkerülnek a Cisco BroadWorks-ből vagy a BroadCloudból a Webex Callingba, amikor az eszközáthelyezési eszköz fut. Az ebben az oszlopban „Nem” jelölésű telefonokhoz manuális beavatkozásra van szükség a DMS URL módosításához a Cisco BroadWorks eszközsablonban vagy magán a telefonon.

Az utolsó oszlop a transform-tool/input/newphones.csv fájl „Eszköz típusa” oszlopához rendeli a telefonmodelleket. (A newphones.csv-vel kapcsolatos további információkért lásd a cikk Átalakító eszköz szakaszát.)

A partnerrendszergazdák legalább egyszer futtatják ezt a tokengenerátor segédeszközt, mielőtt elkezdenék futtatni az áttelepítési eszközöket. Ennek az eszköznek a futtatása egyszeri tevékenység, miután a partnerfiók bekerül a nagykereskedelmi RTM-megoldásba. Ez az eszköz lehetővé teszi a partnerrendszergazdák számára, hogy webböngészőn keresztül jelentkezzenek be, hogy megkapják az áttelepítési eszközök partnerkonfigurációs fájljainak frissítéséhez szükséges egyedi tokent.

Előfeltételek

Telepítse a Java 8, 11, 17 vagy 21 alkalmazást a számítógépre. A Java számos forrásból áll rendelkezésre, többek között:

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

A letöltés után bontsa ki az áttelepítési eszköz bináris fájljait.

Futtatandó utasítások

Futtassa a következő parancsot a terminálban a tokengenerátor könyvtárban:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Kimenet:

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

Nyissa meg az URL-címet a terminál webböngészőjében, jelentkezzen be a partner rendszergazdájának hitelesítő adataival, hogy megkapja a TOKENT, és másolja ki azt további használat céljából.

A felhasználói felület alábbi illusztrációi referenciaként szolgálnak:

3. ábra: Bejelentkezés Cisco Webex alkalmazással

4. ábra: Hitelesítő adatok ablaka

5. ábra: Token létrehozása

Konfigurálja a következő lépéseket, mielőtt futtatná az kivonatot és az eszközáthelyezési eszközöket a másodlagos BroadWorks kiszolgálón.

OCI-P kapcsolat engedélyezése

Az eszközáthelyezés eszköz OCI-P parancsokon keresztül kommunikál a BroadWorks-szel, az OCI-P-kapcsolat engedélyezéséhez használja az alábbi lépéseket:

1. lépés: Használja a CLI-t az általános beállítások konfigurálásához.

Futtassa az alábbi parancsot a CLI-ben a GeneralSettings címtárra való váltáshoz:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Az aktuális GeneralSettings lekéréséhez futtassa a következő parancsot a CLI-ben:

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

Ha a beállításai nem egyeznek a fentiekkel, a set paranccsal konfigurálhatja újra a beállításokat.

2. lépés: Az OCI proxy konfigurálásához használja a CLI-t.

Címtár módosítása OCI proxyra:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Az aktuális beállítások lekéréséhez futtassa a következő CLI-t. A következőket kell látnia:

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

Ha a beállításai nem egyeznek a fentiekkel, a set paranccsal konfigurálhatja újra a beállításokat.

3. lépés: A CLI használata az OCI szolgáltatás konfigurálásához.

Váltás a Szolgáltatási címtárra:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Az aktuális OCI-szolgáltatási beállítások lekéréséhez futtassa a következő parancsot:

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

4. lépés: Futtassa az alábbi parancsot a CLI-ben, hogy ellenőrizze, helyes-e a konfiguráció.

 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.

Ellenőrizze, hogy a nyitott kliens kiszolgáló telepítve van-e és aktív-e

Az alábbi parancsok segítségével telepítheti és indíthatja el a Nyitott Kliens Kiszolgálót a másodlagos Application Server-en, ha még nincs telepítve, vagy még nem kezdődött el.

1. lépés: Telepítse a szervert a következő CLI paranccsal:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

2. lépés: Indítsa el a kiszolgálót ezzel a paranccsal:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Számok aktiválásának engedélyezése

A számok aktiválásának engedélyezéséhez hajtsa végre az alábbi parancsokat a CLI-ben:

1. lépés: A szám aktiválási parancs futtatása:

AS_CLI> cd SubscriberMgmt/NumberActivation

2. lépés: Az aktiválással aktivált parancs futtatása:

AS_CLI> set dnMode groupAndUserActivationEnabled

3. lépés: A megerősítési kérésnél írja be az Y karaktert.

BroadCloud esetén

A kivonatoló eszköz integrálva van a BroadCloud-szolgáltató portáljába. A szolgáltató rendszergazdája a következőket teheti:

1. Kérésenként legfeljebb 50 ügyfélre küldhet be kivonatkéréseket.
   A kivonatkérés nem nyújtható be ugyanarra az ügyfélre naponta 10-nél többször.
2. A kitöltött adatfájl letöltése ZIP formátumban, a kérelem benyújtásának napjától számított 28 napig.

Az alábbi számok a szolgáltató portálját mutatják.

6. ábra: Szolgáltatói portál

7. ábra: Szolgáltatói portál

Cisco BroadWorks részére és Webex a BroadWorks részére

1. A kivonatoló eszköz a másodlagos Cisco BroadWorks alkalmazáskiszolgálón fut a partnerhálózaton, és OCI-P-n keresztül kapcsolódik.
2. Az eszköz lekéri a nyers nagyvállalatok, csoportok, számok, felhasználók, szolgáltatások, eszközök és szoftveres kliens adatait a Cisco BroadWorks vagy BroadCloud platformról, és ezeket az adatokat XML-fájlokba helyezi, amelyek megadják az átalakító eszköz bemeneteit.

A következő szakaszokban ismertetjük, hogyan kell telepíteni és konfigurálni a kivonatolóeszközt.

Előfeltételek

1. SCP a kivonatoló eszköz bináris fájljait a másodlagos Cisco BroadWorks alkalmazásszerverre.
2. SSH-t a másodlagos Cisco BroadWorks alkalmazáskiszolgálóra az előfeltételek konfigurálásához és a kivonatoló eszköz futtatásához.
3. Konfigurálja a szolgáltatót és a csoportazonosítót a Cisco BroadWorks-ből való kivonáshoz a conf/exportTool.yml-ben. Lásd az alábbi minta YAML-részletet:

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

4. Győződjön meg arról, hogy a másodlagos Cisco BroadWorks alkalmazáskiszolgáló felhasználói azonosítója, jelszava és állomásneve helyes a conf/partner.cfg fájlban:

   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.
   

   A REFRESH_TOKEN tulajdonság kötelező a Webex for BroadWorks áttelepítéséhez.

5. Módosítsa a JDK/JRE környezeti útvonalat az export.sh fájlban, ha a másodlagos Cisco BroadWorks Application Server JDK/JRE környezeti útvonala eltér a fájltól:

   JAVA_HOME=/usr/local/java/java_base

Futtatandó utasítások

Futtassa az alábbi parancsot a másodlagos Cisco BroadWorks Application Server alkalmazásban a kivonatkezelő eszköz címtárából:

./export.sh

Terminálnaplók

A sikeres exportálás esetén a következő naplók érhetők el a terminálban: BroadSoft adatexportáló eszköz futtatása:

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

Hozam

Egy kimeneti ZIP (extracted_data_<timestamp>.zip) fájl ugyanabban a kivonatkezelő eszköz könyvtárában lesz elérhető. Az alábbi paranccsal megtekintheti és használhatja a ZIP-fájlt a Transform Tool beviteli eszközhöz:

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

Ez az átalakító eszköz minden áttelepítésnél fut. Az átalakító eszköz bármely számítógépen fut, beleértve a partner rendszergazdai laptopját is, és a Webex nyilvános API-kat használja. Beolvassa a kivonatoló eszköz kimeneti ZIP (extracted_data_<timestamp>.zip) fájlt bemenetként, és a nyers XML-t a szolgáltató eszköz által használt JSON formátummá alakítja.

Előfeltételek

Az áttelepítési eszközök bináris fájljainak letöltése és kinyerése után konfigurálja a következő előfeltételeket:

1. Állítsa be a FRISSÍTÉSI_TOKENT (a Tokengenerátor eszközből másolt token) és a_FŐ_HELYSZÍN NEVÉT_ a conf/partner.cfg fájlban:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opcionálisan állítsa be a KIÉPÍTÉSI_azonosítót (a Partner Hubban lévő sablonból másolva) a conf/partner.cfg fájlban:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Az ügyfél e-mail-címének teljesebb körű ellenőrzéséhez opcionálisan beállíthatja a KIÉPÍTÉSI_azonosítót.
3. Ha hiányoznak, konfigurálja a hiányzó információkat az input/customers.csv fájlban (lásd a következő szakaszt).
4. Adja hozzá a végfelhasználó e-mail-címét az input/users.csv fájlban.
5. Ha új telefonokat szeretne szolgáltatni, adja hozzá a felhasználó új telefonjának mac-címét és e-mail-címét az input/newphones.csv fájlhoz. Ez csak akkor szükséges, ha a partner rendszergazdái új telefonokat szeretnének szolgáltatni a nagykereskedelmi hívásokban.
6. Az input/cxessentials.csv fájl használatával konvertálja a BroadWorks hívásközpontokat CxEssentials-re.
7. Opcionálisan engedélyezze az _ÖSSZES_HÍVÁSKÖZPONT__CX__ESSENTIALS-re való frissítését az összes hívásközpont CxEssentials-re való konvertálásához.
8. Az input/locations.csv fájl segítségével támogassa a nagyvállalati áttelepítést, amely lehetővé teszi a rendszergazdák számára az ügyfelük helyszínének helyszín szerinti áttelepítését
9. Opcionálisan engedélyezze a MAC-címek használatát a SIP REGISTER üzenet Felhasználó-ügynök fejlécében, ha a MAC-cím nem érhető el a Cisco BroadWorks eszközprofilban. Törölje a megjegyzést a „USE_MAC_ADDRESS_FROM_SIP_REGISTER=igen” sorból a conf/partner.cfg fájlban
10. A hálózati kiszolgáló szinkronizálási funkciója lehetővé teszi a rendszergazdák számára, hogy az azonos régió áttelepítése során telefonszámokat, MAC-címeket és felhasználói e-mail-címeket üzemeltessenek be. Az engedélyezéséhez állítsa be a következőt: USE_NS_SYNC=yesconf/partner.cfg.

    Ha az NS-szinkronizálás le van tiltva, a telefonszám és az eszköz beüzemelése kihagyásra kerül, és a felhasználók ideiglenes e-mail-címeket kapnak.

Töltse ki a bemenetet/customers.csv fájlt

Az input/customers.csv fájl olyan adatokat tartalmaz, amelyek esetleg hiányoznak a Cisco BroadWorks vagy a BroadCloud alkalmazásban. A fájl üresen hagyható, ha már minden kötelező információ rendelkezésre áll. Nem kell minden oszlopot kitöltenie, csak a hiányzó információk kötelezőek.

Az alábbi táblázat ismerteti az input/customers.csv legfontosabb oszlopait.

Futtatandó utasítások

Futtassa az Átalakító eszközt bármely operációs rendszerben. Az alábbi lépések segítségével futtathatja az eszközt Windows rendszerben és macOS-ben:

Windows

Az Átalakító eszköz Windows rendszerben való futtatásához hajtsa végre az alábbi parancsot:

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

macOS

Hajtsa végre a következő lépéseket az átalakító eszköz macOS rendszeren való futtatásához:

1. Hozzon létre egy virtuális környezetet és telepítse a függőségeket az átalakító eszköz Pythonban történő futtatásához:

   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. A transzformációs eszköz futtatása:

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

Ügyfél/felhasználó előzetes ellenőrzése

A Transzformációs eszköz API-hívásokat kezdeményez a Webex felé, hogy elnyelje az esetleges üzembe helyezési problémákat. Alapértelmezés szerint érvényesíti az ügyfél címét és elsődleges e-mail-címét. Ha a LÉTESÍTÉSI_azonosító értéke meg van adva a conf/partner.cfg fájlban, az a helyszínadatokat is ellenőrzi. Az előzetes ellenőrzés eredményeit a kivételjelentés tartalmazza.

Ezenkívül az átalakító eszköz futtatásakor a következő opcionális paramétereket lehet hozzáadni:

előzetes ellenőrzés

Az ügyféladatok előzetes ellenőrzésének API-jának futtatása mellett a Transzformációs eszköz az előfizetői e-mailek előzetes ellenőrzésének API-ját is futtatja.

előzetes ellenőrzésinformáció

Alapértelmezés szerint csak az előzetes ellenőrzés hibái (azaz a beüzemelést blokkoló problémák) szerepelnek a kivételjelentésben. A zászló hozzáadása sikeres előzetes ellenőrzési eredményeket is tartalmazni fog (pl. ha már létezik olyan Webex-szervezet, amely automatikusan csatolható).

Terminálnaplók

A következő naplók a terminálban a sikeres átalakításról:

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

Kivételjelentés

A Transzformációs eszköz kivételjelentést hoz létre a output/<timestamp>/exception_report.txt könyvtárban. Ez a jelentés segítségével azonosíthatja az áttelepítést érintő problémákat, és kijavíthatja azokat a Cisco BroadWorks rendszerben.

Miután módosította a felhasználói adatokat a kivétel feloldásához, futtassa újra a Kivonatoló és átalakító eszközöket az új adatokkal. A minta kivételjelentés fájlja a következő:

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

Hozam

Egy kimeneti JSON (customer.json) fájl elérhető lesz a output/<timestamp>/<groupid> könyvtárban. A customer.json minta fájl a következő:

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

A beüzemelési eszköz bármely számítógépen futtatható, általában (a partner rendszergazdai laptopján), és a Webex nyilvános API-kat használja. Beolvassa az átalakító eszköz kimeneti JSON (customer.json) fájlt bemenetként és a Webex Wholesale RTM-megoldásban lévő ügyfelek, helyszínek, számok, felhasználók, szolgáltatások és eszközök üzembe helyezésével.

Előfeltételek

Konfigurálja a következő előfeltételeket a szolgáltató eszköz könyvtárában:

1. Telepítse a Java 8, 11, 17 vagy 21 alkalmazást a számítógépre. A Java számos forrásból áll rendelkezésre, többek között:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Az áttelepítési eszközök bináris fájljainak letöltése és kinyerése után állítsa be a JAVA_HOME környezeti változót a provisioning_tool.sh for MAC és a provisioning_tool.bat for Windows fájlban.
3. A partner.cfg fájl:
   • Állítsa be a NAGYKERESKEDELMI_ELLÁTÁSI_azonosítót és a FRISSÍTÉSI_TOKENT (a Tokengenerátor eszközből másolt token). A partnerrendszergazdáknak kapcsolatba kell lépniük a fiókjuk csapatával, hogy megkapják a KIÉPÍTÉSI_azonosítót:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Állítsa be a RENDSZERGAZDA__MEGHÍVÓ_E-MAILEK hamisítványra, ha a partner nem szeretne üdvözlő e-mailt küldeni a felhasználóknak. Az alapértelmezett érték true.

4. Használja a Webex for BroadWorks áttelepítések WEBEX4BWKS_E-MAIL_tárgy tulajdonságát, hogy elküldje a Webex for BroadWorks előfizetői számára a jelszóváltoztatási kérés e-mail tárgyát.
5. Használja a Webex for BroadWorks áttelepítések WEBEX4BWKS_E-MAIL_BODY tulajdonságát, hogy elküldje a Webex for BroadWorks előfizetői e-mail-törzsét.
6. A hálózati kiszolgáló szinkronizálási funkciója lehetővé teszi a rendszergazdák számára, hogy az azonos régió áttelepítése során telefonszámokat, MAC-címeket és felhasználói e-mail-címeket üzemeltessenek be. Az engedélyezéséhez állítsa be a következőt: USE_NS_SYNC=yesconf/partner.cfg.

   Ha az NS-szinkronizálás le van tiltva, a telefonszám és az eszköz beüzemelése kihagyásra kerül, és a felhasználók ideiglenes e-mail-címeket kapnak.

BroadCloud-áttelepítések esetén ugyanazon a régióban:

1. Az eszköz átugorja a számok, eszközök és megosztott hívások megjelenéseinek beüzemelését.
2. Az eszköz mellékkel és ideiglenes mellékkel felhasználókat és virtuális felhasználókat hoz létre.

Egy másik régió BroadCloud-áttelepítéséhez:

1. Az eszköz számokat, eszközöket és megosztott hívásmegjelenéseket biztosít.
2. Az eszköz tényleges telefonszámmal és mellékkel felhasználókat és virtuális felhasználókat hoz létre.
   Az összes európai BroadCloud-áttelepítés egy másik régióba irányul.

Futtatandó utasítások

Az eszköz Windows és macOS rendszerben történő futtatásához kövesse az alábbi lépéseket:

Windows

Az eszköz Windows operációs rendszeren való futtatásához hajtsa végre a következő lépéseket:

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

macOS

Hajtsa végre a következő lépéseket az eszköz macOS rendszeren való futtatásához:

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

A Webex for BroadWorks áttelepítésének előfeltételei

A partnerrendszergazdáknak frissíteniük kell a Webex for BroadWorks egyidejű létezés funkcióihoz tartozó BroadWorks beléptetési sablonjukat. Lásd a következő képet:

Miután frissült a Webex for BroadWorks beléptetési sablonja az áttelepítés támogatására, kérje meg a Cisco fiókcsapatot, hogy aktiválják a „wholesale-partner-blending-enabled” funkcióváltást a partner szintjén. Ez lehetővé teszi, hogy a beüzemelés során nagykereskedelmi csomagokat adjanak hozzá a meglévő Webex for BroadWorks ügyfélszervezetekhez.

Futtassa a beüzemelési eszközt egy további argumentummal.

Előkészítési fázis: az az alapértelmezett fázis, amikor a rendszergazdák nagykereskedelmi előfizetőként beüzemelhetik a BroadWorks-felhasználókat, és folytathatják a Webex for BroadWorks-felhasználókkal.

Karbantartási fázis: ez a második szakasz, ahol a rendszergazdák hozzárendelhetik a nagykereskedelmi licencet a meglévő Webex for BroadWorks felhasználókhoz. A beüzemelési eszközt argumentummal karbantartás alatt kell futtatni.

Áttelepítés utáni szakasz: Ez az utolsó fázis, amikor a rendszergazdák teljesen átalakíthatják a BroadWorks nagykereskedelemre. A beüzemelési eszközt az áttelepítés utáni argumentummal kell futtatni.

Terminálnaplók

A következők a sikeres beüzemelés naplói a terminálban:

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

Az egyes futásokhoz létrehozott helyszínek számát tartalmazó táblázat jelenik meg:

Hozam

A beüzemelési eszköz siker- és hibajelentéseket hoz létre a output/<external_id>/*.success/error fájlokban. Ellenőrizze a kimeneti sikerességi és hibanaplókat a sikeres beüzemelés ellenőrzéséhez.

A partnerrendszergazdák a Partner Hub és a Control Hub portálon ellenőrizhetik az ügyfél beüzemelését. Lásd a következő illusztrációkat a Partner Hub és a Control Hub portálról:

8. ábra: Partnerközpont

9. ábra: Control Hub

10. ábra: Eszközök

11. ábra: Hívás folyamatban

BroadCloud esetén

A BroadCloud-partnerek esetében használja a Szolgáltató portálját a számok, eszközök és SCA-áttelepítések áttelepítésének kérelmezéséhez.

A szolgáltató portálján belül az áttelepítési kérelem legfeljebb 50 ügyfelet tartalmazhat. Egy napon belül legfeljebb 10 kérelem nyújtható be.

A Hálózati kiszolgáló szinkronizálása funkció lehetővé teszi a rendszergazdák számára, hogy inaktiválják a BroadCloud helyszínt, és aktiválják a Webex Calling helyszínt a(z) USE_NS_SYNC=yes beállításakor a(z) conf/partner.cfg-ben. Áttelepítés után a rendszer aktiválja az eszközöket és a telefonszámokat a Webex Calling-helyszínen.

A rendszergazdák engedélyezhetik az automatikus visszaállítást ROLLBACK_TO_BROADCLOUD=true a conf/partner.cfg fájlban, amely az áttelepítés után visszahelyezi az eszközöket a BroadCloud-ba. Az NS-szinkronizálással támogatja az azonos és eltérő régiós áttelepítést, de csak a sikeres áttelepítések esetén. Sikertelenségek esetén a rendszergazdáknak a visszahívás kérése előtt fel kell emelniük a Cisco TAC-t.

Az alábbi számok a szolgáltató portálját mutatják.

12. ábra: Szolgáltatói portál

13. ábra: Szolgáltatói portál

Cisco BroadWorks részére és Webex a BroadWorks részére

A Cisco BroadWorks és a Webex for BroadWorks áttelepítések esetén az eszköz a másodlagos Cisco BroadWorks alkalmazáskiszolgálón fut a partnerhálózaton, és OCI-P-n keresztül kapcsolódik az AS-hez. Bemenetként a Transform Tool kimeneti JSON (customer.json) fájlt használja, és futtatja az OCI-P parancsokat az eszközök és szoftveres kliensek áttelepítéséhez.

Sikeres művelet esetén az eszközáthelyezési eszköz:

1. Törölje az eszközök regisztrációját a Cisco BroadWorks alkalmazásból, és regisztrálhatja őket a nagykereskedelemben.
2. Az UC-One klienst használó felhasználókat a rendszer átirányítja a Webex alkalmazásra az első bejelentkezéskor.
3. Inaktiválja a telefonszámokat a Cisco BroadWorks alkalmazásból, vagy távolítsa el a telefonszámokat a BroadCloud szolgáltatásból.
4. Számok aktiválása nagykereskedelmi csomagban.
5. Megosztott hívások megjelenésének létrehozása nagykereskedelmi szinten a BroadCloud-áttelepítésekhez. [Ez a lépés csak a BroadCloud-áttelepítésekre vonatkozik].

SCP és SSH

1. SCP az eszköz áthelyezése eszköz a másodlagos Cisco BroadWorks alkalmazáskiszolgálóra.
2. SSH-t a másodlagos Cisco BroadWorks alkalmazáskiszolgálóra az előfeltételek konfigurálásához és az eszközáthelyezési eszköz futtatásához.

Előfeltételek

1. Állítsa be a FRISSÍTÉSI_TOKENT (a Tokengenerátor eszközből másolt token) a conf/partner.cfg fájlban:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Győződjön meg arról, hogy a másodlagos Cisco BroadWorks Application Server felhasználói azonosítója, jelszava és állomásneve helyes a conf/deviceMoveTool.conf fájlban:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Az aktiváló e-mailek újraküldéséhez be kell állítania a RESEND_INVITATION_EMAILS=true beállítást a conf/partner.cfg fájlban.

   Ha a rendszergazdák az áttelepítés során szeretnék meghívó e-maileket küldeni felhasználóiknak, meg kell szüntetniük a „RESEND_INVITATION_EMAILS=true” tulajdonság megjegyzését a conf/partner.cfg fájlban. Ellenkező esetben a tulajdonság változatlan marad.

4. Ellenőrizze, hogy a JDK/JRE környezeti útvonal helyes-e a devicemove.sh fájlban

   JAVA_HOME=/usr/local/java/java_base

5. A rendszergazdák a bemeneti címtárban található locations.csv fájlt használhatják az adott csoportok áttelepítéséhez a nagyvállalati csoport összes csoportja helyett.

Polycom telefonok

Ha a Polycom telefonokat a Cisco BroadWorks rendszeréből a nagykereskedelmi hívásba szeretné áthelyezni, a partnerrendszergazdának a Cisco BroadWorks minden Polycom eszközsablonban rendszerszinten új identitás-/eszközprofil-típust kell létrehoznia. Lásd a 14. ábrát, és töltse fel az egyéni fájlt device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Az új eszközfájl feltöltése után ellenőrizze, hogy az újonnan létrehozott fájl létezik-e csoportszinten. Győződjön meg arról is, hogy a(z) migration_%BWMAC ADDRESS%.cfg fájl nem ütközik a rendszerben meglévő fájlokkal.)

Belsőleg az eszköz-áthelyezési eszköz használja.

A Polycom telefonok áttelepítési folyamata:

1. Az eszközáthelyezési eszköz az eszköz szintjén a %BWMACADDRESS%.cfg fájlt a polycom_vvx2.cfg-re cseréli. Ez a fájl a(z) migration_%BWMACADDRESS%.cfg fájlra hivatkozik.
2. Építse újra az eszközprofilokat csoport- vagy eszközszinten.
   A csoport- vagy eszközszinten való cselekvés a deviceLevelRebuild paraméter konfigurációjától függ a device-move-tool/conf/partner.cfg fájlban.
3. Az eszközáthelyezési eszköz felkéri a Cisco BroadWorks alkalmazáskiszolgálót, hogy indítsa újra a telefonokat csoport- vagy eszközszinten.
4. Az újraindítási kérés után a Polycom telefonok letöltése és feldolgozása% BWMACADDRESS%.cfg, amely arra kéri a Polycom telefonokat, hogy töltse le és feldolgozza a migration_%BWMACADDRESS%.cfg fájlt, amely a device.prov.serverName-et https://plcm.sipflash.com. értékre állítja.
   https://plcm.sipflash.com az amerikai régió esetében a többi régió eltérő URL-címmel rendelkezik.
5. A Polycom telefon letölti a következőt: %BWMACADDRESS%.cfg innen: https://plcm.sipflash.com , és a Webex Calling DMS fogja kezelni.

14. ábra: Identitás/eszközprofil típusának fájlhozzáadása

Futtatandó utasítások

A DMT meghívásának két módja van: az egyik az, hogy egyszerre egyetlen ügyfélen keresztül kell meghívni, a másik pedig az, hogy egyszerre több ügyfélen keresztül kell futtatni.

Az eszközáthelyezési eszköz a másodlagos Cisco BroadWorks alkalmazáskiszolgálóról fut az eszközáthelyezési eszköz címtárán belül:

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

Terminálnaplók

A következők a naplók a terminálban az eszközáthelyezési eszköz sikeres futtatásakor az eszköz áttelepítéséhez:

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

Hozam

Az eszköz áttelepítése után az eszközök online állapotba kerültek, és készen állnak hívások indítására/fogadására. Az eszköz állapotára vonatkozó példát lásd a 15. ábrán:

15. ábra: Eszköz állapota

Az eszköz áttelepítése után a számok aktívak lettek. A 16. ábrán talál egy példát arra, hogy milyen számok aktívak:

16. ábra: Aktív számok

A visszaállítási műveletet egyszerre egy vállalat esetében kell végrehajtani.

BroadCloud szolgáltató számára

A BroadCloud-partnerek visszaállítási folyamata a következő:

1. Az eszköz visszaállításához nyisson jegyet a Cisco TAC rendszerén keresztül.
2. Futtassa az eszközáthelyezési eszközt visszaállítási módban:
   • A telefonszámok hozzárendelése megszűnik a Webex Calling alkalmazásból, így a felhasználók és szolgáltatások csak a mellékkel rendelkeznek.
   • A Webex Callingban lévő e-mail-címek visszaállnak az ideiglenes e-mail-címekre.
   • A telefonok törlődnek a Webex Callingból.
   • Az alternatedId azonosítóként használt telefonszámok, e-mail-címek és telefonok újra létre lesznek hozva a BroadCloudban.
   • A telefonok újraindulnak.
3. A partnerrendszergazdáknak vissza kell helyezniük a PSTN-telefonszámokat a BroadCloud szolgáltatóhoz.

Cisco BroadWorks részére és Webex a BroadWorks részére

A Cisco BroadWorks és a Webex a BroadWorks számára a visszaállítási folyamat a következő:

1. Az eszköz visszaállításához nyisson jegyet a Cisco TAC rendszerén keresztül.
2. Az eszközáttelepítések visszaállításához futtassa az eszközáthelyezési eszközt visszaállítási módban a másodlagos BroadWorks alkalmazáskiszolgálón. Ezzel a rendszer visszaállítja a DMS URL-t a szolgáltató DMS URL-címére a Cisco BroadWorks eszközprofiljaihoz, és újra aktiválja a telefonszámokat.
3. A Webex Calling csapat állítja vissza a DMS URL-t a szolgáltató DMS URL-címére a Webex Calling eszközprofiljaiban.
4. A partnerrendszergazdáknak inaktiválniuk vagy törölniük kell a telefonszámokat a Webex Calling szolgáltatásban a Control Hub portálon keresztül.
5. A partnerrendszergazdáknak vissza kell helyezniük a PSTN-telefonszámokat a Cisco BroadWorks rendszerébe.

Utasítások az eszköz áthelyezése eszköz visszaállítási módban történő futtatásához

Kövesse az alábbi lépéseket az eszközáthelyezési eszköz visszaállítási módban való futtatásához:

Futtassa az alábbi parancsot a másodlagos Cisco BroadWorks alkalmazáskiszolgálón az eszközáthelyezési eszköz címtárán belül:

Profilok visszavonása

./devicemove.sh -input=  -revertProfiles

Számok visszaállítása

./devicemove.sh -input=  -revertNumbers

Terminálnaplók

A következő naplókat fogjuk megkapni a terminálban, amikor sikeresen futtatja az eszköz áthelyezési eszközt a visszavonási művelethez:

Profilok visszavonása

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

Számok visszaállítása

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