Siirtymätyökalut BroadWorks-, Webex for BroadWorks- ja BroadCloud-ratkaisuista tukkukaupan RTM-ratkaisuihin siirtymistä varten.

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

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

Aseta JRE/JDK-ympäristön polku MAC-ohjelmassa token_generator.sh ja Windows-ohjelmassa token_generator.bat. Jos JAVA_HOME-polku on jo olemassa, työkalu käyttää sitä uudelleen.

• MAC: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Ohjeet suorittamiseen

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

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Lähtö:

Työkalun nimi: Token Generator Tool Version: 1.13.0 Lataa URL-osoite selaimeen: 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 asetuksia, 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/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 asetuksia, 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 (Järjestelmä/Verkkoyhteysluettelot/OCI/Provisioning)

Suorita seuraava komento saadaksesi nykyiset OCI Provisioning -asetukset:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get Osoite Kuvaus ======================== 127.0.0.0.1 local as 

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks ja tarkista, että tulosteesi näyttää hyvältä. Katso alla oleva esimerkkituloste: AS_CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== * Palvelin: Identiteetti..............: AS Versio...............: Rel_21.sp1_1.551 Administrative State..: Lukitsematon * Sovellukset: Nimi 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 Unlocked WebContainer 21.sp1_1.551 true Unlocked Unlocked Löytyi 4 kohdetta. * 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 Löytyi 5 tiedostoa. 

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> ottaa käyttöön sovelluksen OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> käynnistä sovellus 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/Numeroaktivointi

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

AS_CLI> set dnMode groupAndUserActivationEnabled (ryhmäAndUserActivationEnabled)

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 olevaa YAML-esimerkkiä:

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

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

   BROADWORKS_KÄYTTÄJÄ_ID = admin BROADWORKS_SALASANA = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Kumppanin ylläpitäjän Token Generator -työkalusta kopioitu päivitystunniste. MIGRATION_MODE = Tuetut arvot ovat webex_for_broadworks_to_wholesale. Oletusarvo on broadworks_to_wholesale. Käytä webex_for_broadworks_to_wholesale for Webex for BroadWorks -siirtoihin. 

   REFRESH_TOKEN -ominaisuus on pakollinen Webex for BroadWorks -siirtymisessä.

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, kun vienti on onnistunut: BroadSoft Data Export Tool -työkalun suorittaminen:

 BroadSoft Data Export Toolin käynnistäminen ************************************************ Export Tool v: 1.15.0 Vienti aloitettu SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Käyttäjien vienti SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Käyttäjien vienti suoritettu SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Vienti suoritettu SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Vienti suoritettu Vienti Export Dump Zip Directory : output/20221017223452_ExportTool Export Dump Zip-tiedoston nimi :extracted_data_1666060500618.zip Zip-tiedosto, jonka nimi on extracted_data_1666060500618.zip, on luotu ZIP-tiedoston luontiprosessi on päättynyt Vietyjen tiedostojen muuntaminen ZIP-tiedostoksi ************************************************** 

Lähtö

Tulostettu ZIP-tiedosto (extracted_data_.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 lokakuu  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 lokakuu  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin bwadmin 2635 loka  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 lokakuu  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-rw-- 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_.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.

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 

2. Suorita 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ä muunnostyökalua käytettäessä:

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ä:

Yhteenvetoraportti BroadWorks-yritykset, joiden siirtäminen onnistuu: 1 BroadWorks-yritykset, joita ei voida siirtää: 0 BroadWorks-käyttäjää, jotka voidaan siirtää onnistuneesti: 4 BroadWorks-käyttäjää, joita ei voida siirtää: 0 Puhelimet, jotka voidaan siirtää onnistuneesti: 3 Puhelimet, jotka eivät ole yhteensopivia Webex Callingin kanssa: 0 

Poikkeusraportti

Transform Tool luo poikkeusraportin hakemistoon output//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:

Poikkeusraportti ti loka 18 08:12:09 2022 Yritykset, joilla on Communication Barring -ominaisuus Suositus: Määritä manuaalisesti lähtevien puhelujen suunnitelma Control Hubissa ________________________________________________________________________________ collabmigrationtestGRP_engg 

Lähtö

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

{ "asiakas": { "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!", "packages": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": ", "osoite": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "customerInfo": { "name": "primaryEmail": "customerEmail": "primaryEmail": "primaryEmail": "primaryEmail": "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": York", "language": "language": "timezone": "timezone": "America/New_York": "en_us", "numbers": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info": { "service_provider_id": "_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, "tervehdys": "}, "sendUnansweredCalls": { "enabled": true, "tervehdys": "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, "tervehdys": "}, "sendUnansweredCalls": { "enabled": true, "tervehdys": "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, "tervehdys": "}, "sendUnansweredCalls": { "enabled": true, "tervehdys": "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, "tervehdys": "}, "sendUnansweredCalls": { "enabled": true, "tervehdys": "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": "Automated Voice Portal", "languageCode": "en_us", "phoneNumber": "+15205551105", "extension": "1105" } ], "shared_call_appearances": "business_communicator_desktop_to_upgrade_to_webex_app": [], " ": "connect_client_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], " ": [], "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 tai 17 tietokoneeseen. Java on saatavilla monista lähteistä, kuten:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
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.

BroadCloud-migraatioissa 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 virtuaalisia käyttäjiä, joilla on todelliset puhelinnumerot ja laajennukset.
   Kaikki Europe BroadCloud -siirtymiset tapahtuvat toiselle alueelle.

Ohjeet suorittamiseen

Suorita työkalu Windowsissa ja macOS:ssä alla olevien ohjeiden avulla:

Windows

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

Yksittäisen asiakkaan toimittaminen: provision.bat -input= Useiden asiakkaiden varaaminen: provision.bat -input= 

macOS

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

Yhden asiakkaan tarjoaminen: ./transform.sh -input= Useiden asiakkaiden tarjoaminen: ./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 alla olevaa kuvaa:

Suorita käyttöönottotyökalu lisäargumentilla Webex for BroadWorks to Wholesale -siirtymistä varten.

Valmisteluvaihe: on oletusvaihe, jossa järjestelmänvalvojat voivat tarjota BroadWorks-käyttäjille tukkutilaajan 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:

Työkalun nimi: Käyttöönottotyökalun versio: 1.15.0 ********** Käynnistetty käsittelytiedosto : input/customer.json **************** Provisioning Customer Odotetaan, että asiakas external_id_engg_grp1 saa käyttöönoton päätökseen... Odotamme, että asiakas external_id_engg_grp1 saa käyttöönoton valmiiksi...   Asiakas external_id_engg_grp1 tila : provisioitu Numeroiden provisioiminen Käyttäjien provisioiminen Käyttäjäominaisuuksien provisioiminen Tervehdysten provisioiminen Aikataulujen provisioiminen Laitteiden provisioiminen Jaettujen puheluiden provisioiminen Automaattisten avustajien provisioiminen Puhelujonojen provisioiminen Hunt-ryhmien provisioiminen Ryhmäsivujen provisioiminen Puheluparkkien provisioiminen Puhelun poiminta Provisioning Voice Portal ********** Valmis tiedosto : 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öä.

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. Poistetaan laitteiden rekisteröinti Cisco BroadWorksista ja rekisteröidään ne tukkukauppaan.
2. UC-One-asiakasta 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 puheluesiintymiä 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_KÄYTTÄJÄ_ID = admin BROADWORKS_SALASANA = admin BROADWORKS_HOST_NIMI = localhost 

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

   JAVA_HOME=/usr/local/java/java_base

4. 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. Huomaa, että tämä tiedosto viittaa osoitteeseen migration_%BWMACADDRESS%.cfg.
2. Luo laiteprofiilit uudelleen ryhmä- tai laitetasolla.
   Toimiminen ryhmä- tai laitetasolla riippuu device-move-tool/conf/partner.cfg-tiedostossa olevan parametrin deviceLevelRebuild asetuksista.
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 yksittäisen asiakkaan käyttäminen kerrallaan ja toinen usean asiakkaan käyttäminen samanaikaisesti.

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

Yksittäisen asiakkaan siirtämiseksi laitteeseen: ./devicemove.sh -input=./devicemove.sh -input=/tmp/asiakasnimi.json Useiden asiakkaiden siirtämiseksi laitteeseen: ./devicemove.sh -input= ls -l /tmp/asiakkaiden hakemisto/ asiakas1.json asiakas2.json asiakas3.json Lisäksi laitteen siirtotyökalu tukee yksittäisen/erityisen puhelimen (puhelimien) siirtämistä 1.35.0-versiosta. Käytä alla olevaa komentoa: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminaalin lokit

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

Työkalun nimi: Laitteen siirtotyökalun versio: 1.15.0 Device Tool käynnistetty.... Kelvolliset laitteet siirtymistä varten : ------------------------------------------------------------------------------------------------------------------- | Laitetyyppi | Mac | Versio | Sähköposti | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Haluatko siirtää kaikki nämä laitteet? ([Y]es tai [N]o) kyllä Laiteprofiilien lataaminen DMS:lle Cisco MPP LC Laitteen uudelleenrakennusprosessi alkoi Laitteen uudelleenrakennusprosessi päättyi onnistuneesti Uudelleenkäynnistysprosessi alkoi Uudelleenkäynnistysprosessi päättyi onnistuneesti Profiilien muokkaaminen Business Communicatorille ryhmässä collabmigrationtestGRP_engg Aktivoi webex-puhelinnumerot -prosessi käynnistyi asiakkaalle org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Webex-puhelinnumeroiden aktivointiprosessi on saatettu päätökseen asiakkaan org-tunnuksella : 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 Laitteen siirtyminen päätökseen 

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

Työkalun nimi: Laitteen siirtotyökalun versio: 1.15.0 Laitetyökalu käynnistetty palautusprosessia varten... Laitteet, jotka voidaan siirtää takaisin Webex Callingista BroadWorksiin: ------------------------------------------------------------------------------------------------------------------- | Laitetyyppi | Mac | Versio | Sähköposti | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7 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 | ------------------------------------------------------------------------------------------------------------------- Haluatko siirtää nämä laitteet takaisin Webex Callingista BroadWorksiin? (Kyllä, Y, Ei, N):  kyllä Laiteprofiilien lataaminen DMS:ää varten Cisco MPP LC Laitteen uudelleenrakennusprosessi käynnistyi Laitteen uudelleenrakennusprosessi päättyi onnistuneesti Uudelleenkäynnistysprosessi käynnistyi Uudelleenkäynnistysprosessi päättyi onnistuneesti Laitteen siirto päättyi Deprovision-prosessia varten. 

Peruuta numerot

Työkalun nimi: Laitteen siirtotyökalun versio: 1.15.0 Haluatko jatkaa numeroiden palauttamista Broadworksille ?  ([J]es tai [EI]):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Aloitetaan palautus Aktivoi broadworks-puhelinnumerot -prosessi käynnistettiin groupId:lle : collabmigrationtestGRP_engg Aktivoi broadworks-puhelinnumerot -prosessi saatiin päätökseen groupId:n osalta : collabmigrationtestGRP_engg Laitemigraation palautusprosessi saatiin onnistuneesti päätökseen.