Tuetut puhelimet luodaan automaattisesti ja osoitetaan käyttäjille Webex Callingissa käyttöönottotyökalun avulla. Puhelimet, jotka on merkitty "kyllä" sarakkeeseen "Tuettu laitteen siirtotyökalussa", siirretään myös automaattisesti Cisco BroadWorksista tai BroadCloudista Webex Callingiin, kun laitteen siirtotyökalu suoritetaan. Puhelimet, joissa on merkintä "Ei" kyseisessä sarakkeessa, tarvitsevat manuaalisen toimenpiteen DMS URL-osoitteen muuttamiseksi Cisco BroadWorks -laitemallissa tai itse puhelimessa.

Viimeisessä sarakkeessa esitetään puhelinmallien yhdistäminen tiedoston transform-tool/input/newphones.csv sarakkeeseen "Device type". (Lisätietoja newphones.csv-tiedostosta on tämän artikkelin osassa Transform-työkalu ).

Yhteistyökumppanin järjestelmänvalvojat suorittavat tämän token-generaattori-aputyökalun vähintään kerran ennen siirtotyökalujen suorittamisen aloittamista. Työkalun käyttäminen on kertaluonteinen toimenpide sen jälkeen, kun kumppanuustili on otettu käyttöön Tukkukaupan RTM-ratkaisussa. Tämän työkalun avulla kumppanin ylläpitäjät voivat kirjautua sisään verkkoselaimen kautta saadakseen yksilöllisen TOKENin, jota tarvitaan kumppanin konfiguraatiotiedostojen päivittämiseen siirtotyökaluja varten.

Edellytykset

Asenna Java 8, 11, 17 tai 21 tietokoneeseen. Java on saatavilla monista lähteistä, kuten:

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

Pura siirtotyökalun binääritiedostot lataamisen jälkeen.

Ohjeet suorittamiseen

Suorita seuraava komento terminaalissa token-generaattorihakemiston sisällä:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Lähtö:

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

Avaa URL-osoite päätelaitteen verkkoselaimessa, kirjaudu sisään kumppanin järjestelmänvalvojan tunnuksilla saadaksesi TOKENin ja kopioi se myöhempää käyttöä varten.

Käyttöliittymäkuvat on esitetty alla viitteellisesti:

Kuva 3: Sisäänkirjautuminen Cisco Webexillä

Kuva 4: Valtakirjat-ikkuna

Kuva 5: Tokenien luominen

Määritä seuraavat vaiheet, ennen kuin käytät ote- ja laitteen siirtotyökaluja toissijaisessa BroadWorks-palvelimessa.

Ota OCI-P-yhteys käyttöön

Laitteen siirtotyökalu kommunikoi BroadWorksin kanssa OCI-P-komennoilla. Ota OCI-P-yhteys käyttöön seuraavien ohjeiden mukaisesti:

Vaihe 1: Määritä yleiset asetukset CLI:n avulla.

Suorita CLI:ssä seuraava komento vaihtaaksesi GeneralSettings-hakemistoon:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Suorita seuraava komento CLI:ssä saadaksesi nykyiset GeneralSettings-asetukset:

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

Jos asetuksesi eivät vastaa edellä mainittuja, määritä asetukset uudelleen komennolla set .

Vaihe 2: Määritä OCI-välityspalvelin CLI:n avulla.

Vaihda hakemistoksi OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Suorita seuraava CLI saadaksesi nykyiset asetukset. Sinun pitäisi nähdä seuraavat tiedot:

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

Jos asetuksesi eivät vastaa edellä mainittuja, määritä asetukset uudelleen komennolla set .

Vaihe 3: Määritä OCI Provisioning CLI:n avulla.

Mene Provisioning-hakemistoon:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Suorita seuraava komento saadaksesi nykyiset OCI Provisioning -asetukset:

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

Vaihe 4: Suorita alla oleva komento CLI:ssä tarkistaaksesi, että kokoonpano on oikea.

 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.

Tarkista, että avoin asiakaspalvelin on käytössä ja aktiivinen

Käytä alla olevia komentoja Open Client Serverin käyttöönottoon ja käynnistämiseen toissijaisella sovelluspalvelimella, jos sitä ei ole otettu käyttöön tai jos se ei ole vielä käynnistynyt.

Vaihe 1: Ota palvelin käyttöön seuraavalla CLI-komennolla:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Vaihe 2: Käynnistä palvelin tällä komennolla:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Ota numeroiden aktivointi käyttöön

Suorita seuraavat komennot CLI:ssä, jotta numerot voidaan aktivoida:

Vaihe 1: Suorita numeron aktivointikomento:

AS_CLI> cd SubscriberMgmt/NumberActivation

Vaihe 2: Suorita komento aktivointi käytössä:

AS_CLI> set dnMode groupAndUserActivationEnabled

Vaihe 3: Kirjoita vahvistuskehotteeseen Y.

BroadCloudin osalta

Otetyökalu on integroitu BroadCloud-palveluntarjoajaportaaliin. Palveluntarjoajan ylläpitäjä voi:

1. Lähetä otepyyntöjä enintään 50 asiakkaalle pyyntöä kohden.
   Otepyyntöä ei voi lähettää samalle asiakkaalle useammin kuin 10 kertaa päivässä.
2. Lataa poimittu ZIP-muotoinen tiedosto enintään 28 päivän ajan pyynnön jättämispäivästä.

Alla olevissa kuvissa on esitetty palveluntarjoajan portaali.

Kuva 6: Palveluntarjoajan portaali

Kuva 7: Palveluntarjoajan portaali

Cisco BroadWorksin ja Webex for BroadWorksin osalta

1. Otetyökalu toimii kumppaniverkon toissijaisella Cisco BroadWorks -sovelluspalvelimella ja muodostaa yhteyden OCI-P:n kautta.
2. Työkalu hakee raa'at yritys-, ryhmä-, numero-, käyttäjä-, palvelu-, laite- ja softa-asiakastiedot Cisco BroadWorks- tai BroadCloud-alustasta ja tuottaa nämä tiedot XML-tiedostoiksi, jotka ovat muunnostyökalun syötteitä.

Seuraavissa luvuissa kerrotaan, miten purkaustyökalu asennetaan ja konfiguroidaan.

Edellytykset

1. SCP:n avulla poimintatyökalun binäärit toissijaiseen Cisco BroadWorks -sovelluspalvelimeen.
2. Siirry SSH-yhteydellä toissijaiseen Cisco BroadWorks -sovelluspalvelimeen määrittääksesi edellytykset ja suorittaaksesi purkutyökalun.
3. Määritä palveluntarjoaja ja ryhmätunnus Cisco BroadWorksista poimittavaksi conf/exportTool.yml-tiedostossa. Katso alla oleva YAML-esimerkki:

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

4. Varmista, että toissijaisen Cisco BroadWorks -sovelluspalvelimen käyttäjätunnus, salasana ja isäntänimi ovat oikein conf/partner.cfg-tiedostossa:

   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 -ominaisuus on pakollinen Webex for BroadWorks -siirtymässä.

5. Muokkaa export.sh-tiedoston JDK/JRE-ympäristön polkua, jos toissijaisen Cisco BroadWorks -sovelluspalvelimen JDK/JRE-ympäristön polku on eri kuin tiedostossa:

   JAVA_HOME=/usr/local/java/java_base

Ohjeet suorittamiseen

Suorita alla oleva komento toissijaisessa Cisco BroadWorks -sovelluspalvelimessa extract tool -hakemistosta:

./export.sh

Terminaalin lokit

Seuraavat lokit ovat saatavilla päätelaitteessa onnistuneen viennin jälkeen: BroadSoft Data Export Toolin suorittaminen:

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

Lähtö

Tulostettu ZIP-tiedosto (extracted_data_<timestamp>.zip) on saatavilla samassa extract-työkalun hakemistossa. Käytä alla olevaa komentoa tarkastellaksesi ja käyttääksesi ZIP-tiedostoa Transform Tool -syöttöä varten:

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

Tämä muunnostyökalu suoritetaan kaikkien siirtojen yhteydessä. Transform-työkalu toimii millä tahansa tietokoneella, myös kumppanin järjestelmänvalvojan kannettavalla tietokoneella, ja se käyttää Webexin julkisia sovellusrajapintoja. Se lukee uuttotyökalun tulostetun ZIP-tiedoston (extracted_data_<timestamp>.zip) syötetiedostona ja muuntaa raa'an XML:n JSON-muotoon, jota provisiointityökalu käyttää.

Edellytykset

Kun olet ladannut ja purkanut siirtotyökalujen binääritiedostot, määritä seuraavat ennakkoedellytykset:

1. Aseta REFRESH_TOKEN (Token Generator Toolista kopioitu Token) ja NAME_OF_MAIN_LOCATION conf/partner.cfg-tiedostossa:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Aseta valinnaisesti PROVISIONING_ID (kopioitu Partner Hubin mallista) conf/partner.cfg-tiedostossa:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Jos haluat saada täydellisemmän varmennuksen asiakkaan sähköpostiosoitteesta, voit valinnaisesti asettaa PROVISIONING_ID:n.
3. Määritä puuttuvat tiedot input/customers.csv-tiedostossa (katso seuraava kohta), jos ne puuttuvat.
4. Lisää loppukäyttäjän sähköpostiosoite input/users.csv-tiedostoon.
5. Jos uusia puhelimia otetaan käyttöön, lisää käyttäjän uuden puhelimen mac-osoite ja sähköpostiosoite tiedostoon input/newphones.csv. Tämä on tarpeen vain, jos kumppanin järjestelmänvalvojat haluavat ottaa käyttöön uusia puhelimia tukkuhinnoittelussa.
6. Muunna BroadWorks-puhelinkeskukset CxEssentialsiksi käyttämällä input/cxessentials.csv-tiedostoa.
7. Ota valinnaisesti käyttöön UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS -ominaisuus, jos haluat muuntaa kaikki Call Centers CxEssentials -ominaisuudeksi.
8. Käytä input/locations.csv-tiedostoa tukemaan suuren yrityksen migraatiota, jonka avulla järjestelmänvalvojat voivat siirtää asiakkaidensa toimipaikat sijainnin mukaan.
9. Voit ottaa käyttöön MAC-osoitteiden käytön SIP REGISTER -sanoman User-Agent-otsakkeesta, kun MAC-osoite ei ole käytettävissä Cisco BroadWorks -laiteprofiilissa. Poista kommentti riviltä "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" tiedostossa conf/partner.cfg.
10. Verkkopalvelimen synkronointiominaisuuden avulla järjestelmänvalvojat voivat määrittää puhelinnumerot, MAC-osoitteet ja käyttäjien sähköpostiosoitteet käyttöönoton aikana samalla alueella siirtymisen aikana. Ota se käyttöön asettamalla USE_NS_SYNC=yes osoitteessa conf/partner.cfg.

    Jos NS-synkronointi on poistettu käytöstä, puhelinnumeron ja laitteen määrittäminen jätetään väliin, ja käyttäjät saavat väliaikaiset sähköpostiosoitteet.

Input/customers.csv-tiedoston täyttäminen

Tiedosto input/customers.csv sisältää tietoja, jotka saattavat puuttua Cisco BroadWorksista tai BroadCloudista. Tämä tiedosto voidaan jättää tyhjäksi, jos kaikki pakolliset tiedot ovat jo saatavilla. Kaikkia sarakkeita ei tarvitse täyttää, ainoastaan puuttuvat tiedot ovat pakollisia.

Alla olevassa taulukossa selitetään input/customers.csv-tiedoston tärkeimmät sarakkeet.

Ohjeet suorittamiseen

Suorita Transform Tool millä tahansa käyttöjärjestelmällä. Suorita työkalu Windowsissa ja macOS:ssä alla olevien ohjeiden avulla:

Windows

Suorita alla oleva komento Transform Tool -työkalun suorittamiseksi Windowsissa:

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

macOS

Suorita seuraavat vaiheet muuntajatyökalun suorittamiseksi macOS-käyttöjärjestelmässä:

1. Luo virtuaaliympäristö ja asenna riippuvuudet muuntotyökalun suorittamiseksi Pythonilla:

   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. Käynnistä muunnostyökalu:

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

Asiakkaan/käyttäjän ennakkotarkastus

Transform Tool tekee API-kutsuja Webexiin mahdollisten käyttöönottoon liittyvien ongelmien havaitsemiseksi. Oletusarvoisesti se vahvistaa asiakkaan osoitteen ja ensisijaisen sähköpostin. Jos PROVISIONING_ID -arvo on määritetty conf/partner.cfg-tiedostossa, se vahvistaa myös sijaintitiedot. Esitarkastuksen tulokset sisältyvät poikkeusraporttiin.

Lisäksi seuraavat valinnaiset parametrit voidaan lisätä, kun muunnostyökalua käytetään:

ennakkotarkastus

Sen lisäksi, että Transform Tool suorittaa asiakastietojen ennakkotarkistus-API:n, se suorittaa myös tilaajien sähköpostien ennakkotarkistus-API:n.

precheckinfo

Oletusarvoisesti poikkeusraporttiin sisällytetään vain ennakkotarkistusvirheet (eli ongelmat, jotka estävät käyttöönoton). Tämän lipun lisääminen sisältää myös onnistuneen ennakkotarkastuksen tulokset (esim. jos Webex-organisaatio on jo olemassa ja se voidaan liittää automaattisesti).

Terminaalin lokit

Seuraavat lokit näkyvät terminaalissa onnistuneen muunnoksen yhteydessä:

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

Poikkeusraportti

Transform Tool luo poikkeusraportin hakemistoon output/<timestamp>/exception_report.txt . Tämän raportin avulla voit tunnistaa siirtymiseen vaikuttavat ongelmat ja korjata ne Cisco BroadWorks -järjestelmässä.

Kun olet muuttanut käyttäjätietoja poikkeuksen korjaamiseksi, suorita Extract- ja Transform-työkalut uudelleen uusilla tiedoilla. Esimerkki poikkeusraporttitiedostosta on seuraava:

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

Lähtö

JSON-tulostiedosto (customer.json) on saatavilla hakemistossa output/<timestamp>/<groupid> . Esimerkki customer.json -tiedostosta on seuraava:

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

Käyttöönottotyökalu voi toimia millä tahansa koneella, yleensä (kumppanin järjestelmänvalvojan kannettavalla tietokoneella), ja se käyttää Webexin julkisia sovellusrajapintoja. Se lukee muunnostyökalun tulostetun JSON-tiedoston (customer.json) syötteenä ja määrittää asiakkaat, sijainnit, numerot, käyttäjät, palvelut ja laitteet Webex Wholesale RTM -ratkaisussa.

Edellytykset

Määritä seuraavat ennakkoedellytykset käyttöönottotyökaluhakemiston sisällä:

1. Asenna Java 8, 11, 17 tai 21 tietokoneeseen. Java on saatavilla monista lähteistä, kuten:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Kun olet ladannut ja purkanut siirtotyökalujen binääritiedostot, aseta JAVA_HOME-ympäristömuuttuja provisioning_tool.sh MAC-ohjelmassa ja provisioning_tool.bat Windows-ohjelmassa.
3. Partner.cfg-tiedosto:
   • Aseta WHOLESALE_PROVISIONING_ID ja REFRESH_TOKEN (Token Generator Toolista kopioitu Token). Kumppanin ylläpitäjien on otettava yhteyttä tilitiimiinsä saadakseen PROVISIONING_ID:n:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Aseta ALLOW_ADMIN_INVITE_EMAILS arvoksi false, jos kumppani ei halua lähettää käyttäjille tervetulosähköpostia. Oletusarvo on true.

4. Käytä WEBEX4BWKS_EMAIL_SUBJECT -ominaisuutta Webex for BroadWorks -siirtymissä lähettääksesi salasananvaihtopyynnön sähköpostin aiheen Webex for BroadWorks -tilaajille.
5. Käytä WEBEX4BWKS_EMAIL_BODY -ominaisuutta Webex for BroadWorks -siirtymissä lähettääksesi salasananvaihtopyynnön sähköpostin runko Webex for BroadWorks -tilaajille.
6. Verkkopalvelimen synkronointiominaisuuden avulla järjestelmänvalvojat voivat määrittää puhelinnumerot, MAC-osoitteet ja käyttäjien sähköpostiosoitteet käyttöönoton aikana samalla alueella siirtymisen aikana. Ota se käyttöön asettamalla USE_NS_SYNC=yes osoitteessa conf/partner.cfg.

   Jos NS-synkronointi on poistettu käytöstä, puhelinnumeron ja laitteen määrittäminen jätetään väliin, ja käyttäjät saavat väliaikaiset sähköpostiosoitteet.

BroadCloud-siirtymille sama alue:

1. Työkalu ohittaa numeroiden, laitteiden ja Shared Call Appearances -palvelun määrityksen.
2. Työkalu luo käyttäjiä ja virtuaalikäyttäjiä, joilla on laajennus ja väliaikainen laajennus.

BroadCloud-siirtymiä varten toinen alue:

1. Työkalu määrittää numerot, laitteet ja jaetut puhelutapahtumat.
2. Työkalu luo käyttäjiä ja virtuaalikäyttäjiä, joilla on todelliset puhelinnumerot ja laajennukset.
   Kaikki Europe BroadCloud -siirtymiset tapahtuvat toiselle alueelle.

Ohjeet suorittamiseen

Suorita työkalu Windowsissa ja macOS:ssä seuraavien ohjeiden mukaisesti:

Windows

Suorita seuraavat vaiheet työkalun suorittamiseksi Windows-käyttöjärjestelmässä:

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

macOS

Suorita seuraavat vaiheet työkalun suorittamiseksi macOS-käyttöjärjestelmässä:

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

Webex for BroadWorks -siirtymän edellytykset

Kumppanien ylläpitäjien on päivitettävä BroadWorksin käyttöönottomalli Webexin rinnakkaiseloominaisuuksia varten. Katso seuraava kuva:

Kun Webex for BroadWorks Onboarding -malli on päivitetty tukemaan siirtymistä, pyydä Ciscon tilitiimiä ottamaan käyttöön "wholesale-partner-blending-enabled" -ominaisuuden vaihtaminen kumppanitasolla. Tämä mahdollistaa tukkupakettien lisäämisen olemassa oleviin Webex for BroadWorks -asiakasorganisaatioihin käyttöönoton aikana.

Suorita käyttöönottotyökalu lisäargumentilla.

Valmisteluvaihe: on oletusvaihe, jossa järjestelmänvalvojat voivat tarjota BroadWorks-käyttäjille tukkutason tilaajan ja jatkaa Webex for BroadWorks -käyttäjille.

Ylläpitovaihe: on toinen vaihe, jossa järjestelmänvalvojat voivat määrittää tukkukaupan lisenssin nykyisille Webex for BroadWorks -käyttäjille. Käyttöönottotyökalua on ajettava argumentilla maintenance.

Siirtymisen jälkeinen vaihe: Tämä on viimeinen vaihe, jossa järjestelmänvalvojat voivat muuntaa BroadWorksin kokonaan tukkukaupaksi. Käyttöönottotyökalu on ajettava argumentilla postmigration.

Terminaalin lokit

Seuraavassa on päätelaitteen lokit onnistuneesta käyttöönotosta:

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

Tulostetaan taulukko, jossa ilmoitetaan kunkin ajon aikana luotujen paikkojen määrä:

Lähtö

Käyttöönottotyökalu luo onnistumis- ja virheraportit output/<external_id>/*.success/error -tiedostoihin. Tarkista tulostuksen onnistuminen ja virhelokit varmistaaksesi, että käyttöönotto on onnistunut.

Kumppanin ylläpitäjät voivat tarkistaa asiakkaan käyttöönoton Partner Hub- ja Control Hub -portaalissa. Katso seuraavat kuvat Partner Hub- ja Control Hub -portaalista:

Kuva 8: Partner Hub

Kuva 9: Control Hub

Kuva 10: Laitteet

Kuva 11: Puhelut

BroadCloudin osalta

BroadCloud-kumppanit voivat lähettää numeroita, laitteita ja SCA-siirtoja koskevan siirtopyynnön palveluntarjoajaportaalin kautta.

Palveluntarjoajaportaalissa siirtymispyyntö voi sisältää enintään 50 asiakasta. Yhden päivän aikana voidaan lähettää enintään 10 pyyntöä.

Verkkopalvelimen synkronointiominaisuuden avulla järjestelmänvalvojat voivat poistaa broadCloud-sijainnin käytöstä ja aktivoida Webex Calling -sijainnin asettamalla USE_NS_SYNC=yes osoitteessa conf/partner.cfg. Siirtymisen jälkeen laitteet ja puhelinnumerot aktivoidaan Webex Calling -sijainnissa.

Järjestelmänvalvojat voivat ottaa automaattisen palautuksen käyttöön asettamalla ROLLBACK_TO_BROADCLOUD=trueconf/partner.cfg -tiedostossa, jolloin laitteet siirretään takaisin BroadCloudiin migraation jälkeen. Se tukee sekä saman että eri alueiden siirtoja NS Syncillä, mutta vain onnistuneita siirtoja. Epäonnistuneiden versioiden osalta järjestelmänvalvojien on otettava yhteyttä Ciscon TACiin ennen palautuspyyntöä.

Alla olevissa kuvissa on esitetty palveluntarjoajan portaali.

Kuva 12: Palveluntarjoajan portaali

Kuva 13: Palveluntarjoajan portaali

Cisco BroadWorksin ja Webex for BroadWorksin osalta

Cisco BroadWorksin ja Webex for BroadWorksin migraatioissa työkalu toimii kumppaniverkossa sijaitsevalla toissijaisella Cisco BroadWorks -sovelluspalvelimella ja muodostaa yhteyden AS:ään OCI-P:n kautta. Se käyttää Transform Tool -työkalun tulostettua JSON-tiedostoa (customer.json) syötteenä ja suorittaa OCI-P-komennot laitteiden ja pehmeiden asiakkaiden siirtämiseksi.

Onnistuneen toiminnon jälkeen laitteen siirtotyökalu:

1. Poista laitteiden rekisteröinti Cisco BroadWorksista ja rekisteröi ne tukkukaupassa.
2. UC-One-asiakasohjelmaa käyttävät käyttäjät ohjautuvat Webex-sovellukseen ensimmäisellä kirjautumiskerralla.
3. Deaktivoi puhelinnumerot Cisco BroadWorksista tai poista puhelinnumerot BroadCloudista.
4. Aktivoi numerot tukkukaupassa.
5. Luo jaettuja soittonäkymiä tukkukaupassa BroadCloud-siirtymiä varten. [Tämä vaihe koskee vain BroadCloud-siirtoja].

SCP ja SSH

1. SCP-laitteen siirtotyökalu toissijaiseen Cisco BroadWorks -sovelluspalvelimeen.
2. Siirry SSH-yhteydellä toissijaiseen Cisco BroadWorks -sovelluspalvelimeen määrittääksesi ennakkoedellytykset ja suorittaaksesi laitteen siirtotyökalun.

Edellytykset

1. Aseta REFRESH_TOKEN (Token Generator Tool -työkalusta kopioitu Token) conf/partner.cfg-tiedostossa:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Varmista, että toissijaisen Cisco BroadWorks -sovelluspalvelimen käyttäjätunnus, salasana ja isäntänimi ovat oikein conf/deviceMoveTool.conf-tiedostossa:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Jos haluat lähettää aktivointisähköpostit uudelleen, sinun on asetettava conf/partner.cfg-tiedostossa RESEND_INVITATION_EMAILS=true.

   Jos järjestelmänvalvojat haluavat lähettää kutsusähköposteja käyttäjilleen migraation aikana, heidän on poistettava conf/partner.cfg-tiedoston "RESEND_INVITATION_EMAILS=true"-ominaisuuden kommentti. Muussa tapauksessa ominaisuuden pitäisi pysyä muuttumattomana.

4. Tarkista, että JDK/JRE-ympäristön polku on oikea tiedostossa devicemove.sh.

   JAVA_HOME=/usr/local/java/java_base

5. Järjestelmänvalvojat voivat käyttää syöttöhakemiston locations.csv-tiedostoa siirtääkseen tietyt ryhmät yrityksen kaikkien ryhmien sijasta.

Polycom-puhelimet

Jotta Polycom-puhelimet voidaan siirtää Cisco BroadWorksista Wholesale Calling -palveluun, kumppanin järjestelmänvalvojan on luotava uusi Identity/Device Profile Type File (identiteetti-/laiteprofiilityyppitiedosto) Cisco BroadWorksin järjestelmätasolla osoitteessa jokaiselle Polycom-laitemallille. Katso kuva 14 ja lataa mukautettu tiedosto device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Kun olet ladannut uuden laitetiedoston, varmista, että juuri luotu tiedosto on olemassa ryhmätasolla. Varmista myös, että tiedosto migration_%BWMAC ADDRESS%.cfg ei ole ristiriidassa minkään järjestelmässäsi olevan tiedoston kanssa).

Laitteen siirtotyökalu käyttää sitä sisäisesti.

Polycom-puhelinten siirtymisprosessi:

1. Laitteen siirtotyökalu korvaa laitetason tiedoston %BWMACADDRESS%.cfg tiedostolla polycom_vvx2.cfg. Tämä tiedosto viittaa osoitteeseen migration_%BWMACADDRESS%.cfg.
2. Luo laiteprofiilit uudelleen ryhmä- tai laitetasolla.
   Toimiminen ryhmä- tai laitetasolla riippuu deviceLevelRebuild-parametrin määrityksestä tiedostossa device-move-tool/conf/partner.cfg.
3. Laitteen siirtotyökalu pyytää Cisco BroadWorks -sovelluspalvelinta käynnistämään puhelimet uudelleen ryhmä- tai laitetasolla.
4. Uudelleenkäynnistyspyynnön jälkeen Polycom-puhelimet lataavat ja käsittelevät% BWMACADDRESS%.cfg-tiedoston, jossa Polycom-puhelimia pyydetään lataamaan ja käsittelemään migration_%BWMACADDRESS%.cfg-tiedosto, jossa device.prov.serverName asetetaan arvoon https://plcm.sipflash.com.
   https://plcm.sipflash.com Yhdysvaltain alueella, muilla alueilla on eri URL-osoitteet.
5. Polycom-puhelin lataa %BWMACADDRESS%.cfg-tiedoston osoitteesta https://plcm.sipflash.com , ja sitä hallinnoi Webex Calling DMS.

Kuva 14: Identiteetin/laitteen profiilityyppitiedoston lisääminen

Ohjeet suorittamiseen

DMT:tä voidaan käyttää kahdella tavalla, joista ensimmäinen on käyttää yhtä asiakasta kerrallaan ja toinen on käyttää useita asiakkaita samanaikaisesti.

Laitteen siirtotyökalu suoritetaan toissijaisesta Cisco BroadWorks -sovelluspalvelimesta laitteen siirtotyökaluhakemiston sisällä:

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

Terminaalin lokit

Seuraavassa on päätelaitteen lokit, kun laitteen siirtotyökalu on onnistuneesti suoritettu laitteen siirtoa varten:

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

Lähtö

Laitteiden siirtämisen jälkeen laitteet ovat nyt verkossa ja valmiita soittamaan/vastaanottamaan puheluita. Kuvassa 15 on esimerkki laitteen tilasta:

Kuva 15: Laitteen tila

Laitemuutoksen jälkeen numerot ovat aktivoituneet. Kuvassa 16 on esimerkki aktiivisista numeroista:

Kuva 16: Numerot aktiiviset

Palautustoiminto on suoritettava yhdelle yritykselle kerrallaan.

BroadCloud Carrierin osalta

BroadCloud-kumppaneiden palautusprosessi on seuraava:

1. Avaa tiketti Ciscon TACille ja pyydä laitteen palautusta.
2. Suorita laitteen siirtotyökalu palautustilassa:
   • Puhelinnumerot poistetaan Webex Callingista, jolloin käyttäjille ja palveluille jäävät vain laajennukset.
   • Webex Callingin sähköpostiosoitteet palautetaan väliaikaisiksi sähköpostiosoitteiksi.
   • Puhelimet poistetaan Webex Callingista.
   • Puhelinnumerot, vaihtoehtoisina tunnuksina käytetyt sähköpostiosoitteet ja puhelimet luodaan uudelleen BroadCloudissa.
   • Puhelimet käynnistetään uudelleen.
3. Kumppanin ylläpitäjien on siirrettävä PSTN-puhelinnumerot takaisin BroadCloud Carrierille.

Cisco BroadWorksin ja Webex for BroadWorksin osalta

Cisco BroadWorksin ja Webex for BroadWorksin palautusprosessi on seuraava:

1. Avaa tiketti Ciscon TACille ja pyydä laitteen palautusta.
2. Suorita laitteen siirtotyökalu palautustilassa toissijaisessa BroadWorks-sovelluspalvelimessa laitteen siirtojen palauttamiseksi. Tämä asettaa DMS URL-osoitteen takaisin palveluntarjoajan DMS URL-osoitteeksi Cisco BroadWorksin laiteprofiileille ja aktivoi puhelinnumerot uudelleen.
3. Webex Calling -tiimi asettaa DMS URL-osoitteen takaisin palveluntarjoajan DMS URL-osoitteeseen Webex Callingin laiteprofiileissa.
4. Kumppanien ylläpitäjien on poistettava Webex Calling -puhelinnumerot käytöstä tai poistettava ne Control Hub -portaalin kautta.
5. Kumppanin ylläpitäjien on siirrettävä PSTN-puhelinnumerot takaisin Cisco BroadWorksiin.

Ohjeet laitteen siirtotyökalun käyttämiseen palautustilassa

Suorita laitteen siirtotyökalu palautustilassa noudattamalla seuraavia ohjeita:

Suorita alla oleva komento toissijaisessa Cisco BroadWorks -sovelluspalvelimessa laitteen siirtotyökaluhakemiston sisällä:

Profiilien peruuttaminen

./devicemove.sh -input=  -revertProfiles

Peruuta numerot

./devicemove.sh -input=  -revertNumbers

Terminaalin lokit

Saamme seuraavat lokit päätelaitteeseen, kun laitteen siirtotyökalu on suoritettu onnistuneesti palautustoimintoa varten:

Profiilien peruuttaminen

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

Peruuta numerot

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