Overføringsverktøy for overgang fra BroadWorks, Webex for BroadWorks og BroadCloud til Wholesale RTM-løsninger

Støttede telefoner opprettes automatisk og tilordnes brukere i Webex Calling av klargjøringsverktøyet. Telefonene merket med «ja» i kolonnen «Støttes i verktøyet for enhetsflytting» blir også automatisk flyttet fra Cisco BroadWorks eller BroadCloud til Webex Calling når verktøyet for flytting av enhet kjøres. Telefoner merket med «Nei» i den kolonnen trenger et manuelt inngrep for å endre DMS-URL-en i Cisco BroadWorks-enhetsmalen eller i selve telefonen.

Den siste kolonnen viser tilordningen av telefonmodeller til «Enhetstype»-kolonnen i filen transform-tool/input/newphones.csv. (Se Transformasjonsverktøy delen av denne artikkelen for mer informasjon om newphones.csv).

Partneradministratorer kjører dette tokengeneratorverktøyet minst én gang før de begynner å kjøre overføringsverktøy. Kjøring av dette verktøyet er en engangsaktivitet etter at partnerkontoen blir integrert i Wholesale RTM-løsningen. Dette verktøyet lar partneradministratorer logge på via nettleseren for å få det unike TOKEN som er nødvendig for å oppdatere til partnerkonfigurasjonsfilene for overføringsverktøyene.

Forutsetninger

Etter nedlastingen pakker du ut binære filer for overføringsverktøyet.

Angi JRE/JDK-miljøbanen itoken_generator .sh for MAC ogtoken_generator .bat for Windows. Hvis JAVA_ HOME-banen finnes allerede, den vil bli brukt på nytt av verktøyet.

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

• Windows: JAVA_ HOME=C:\Progra~1\Java\jre1.8.0_ 321

Instruksjoner for kjøring

Kjør følgende kommando i terminalen i tokengeneratorkatalogen:

Windows:

token_generator.bat

MacOS:

./token_generator .sh

Utdata:

Verktøynavn: Versjon av tokengeneratorverktøy: 1.13.0 Last inn nettadressen i nettleseren din: http://localvert:8080 

Åpne URL-adressen i nettleseren på terminalen, logg på med partnerens administrator for å hente TOKEN, og kopier det samme for videre bruk.

Illustrasjonene av brukergrensesnitt er gitt nedenfor som referanse:

Figur 3: Logg på med Cisco Webex

Figur 4: Påloggingsvindu

Figur 5: Tokengenerering

Konfigurer følgende trinn før du kjører verktøyene for utpakking og flytting av enhet i den sekundære BroadWorks-serveren.

Aktiver OCI-P-tilkobling

Verktøyet for enhetsflytting kommuniserer med BroadWorks via OCI-P-kommandoer. Bruk fremgangsmåten nedenfor for å aktivere OCI-P-tilkobling:

Trinn 1 : Bruk CLI til å konfigurere generelle innstillinger.

Kjør følgende kommando i CLI for å endre til katalogen GeneralSettings:

AS_ CLI> cd /Applications/OpenClientServer/GeneralSettings.

Kjør følgende kommando i CLI for å hente gjeldende GeneralSettings:

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

Hvis innstillingene ikke samsvarer med ovennevnte, bruker du angi kommandoen for å konfigurere innstillingene på nytt.

Trinn 2 : Bruk CLI til å konfigurere OCI-proxy.

Endre katalogen til OCI-proxy:

AS_ CLI> cd /Applications/OpenClientServer/OCIProxy

Kjør følgende CLI for å få gjeldende innstillinger. Du skal se følgende:

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

Hvis innstillingene ikke samsvarer med ovennevnte, bruker du angi kommandoen for å konfigurere innstillingene på nytt.

Trinn 3 : Bruk CLI til å konfigurere OCI-klargjøring.

Endre til klargjøringskatalogen:

AS_ CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kjør følgende kommando for å hente gjeldende OCI-klargjøringsinnstillinger:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> hent adressebeskrivelse ========================= 127.0.0.1 lokal som 

Trinn 4 : Kjør kommandoen nedenfor i CLI for å bekrefte at konfigurasjonen er riktig.

 AS_ CLI/Maintenance/ManagedObjects> hente Broadworks og kontroller at utskriften ser OK ut. Se nedenfor for eksempelutdata: AS_ CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ===============================================================* Server: Identitet ................: AS-versjon................: Rel_ 21.sp1_ 1.551 Administrativ delstat...: Ulåst * Programmer: Navn Versjon distribuert Administrativ tilstand Effektiv tilstand =========================================== ============================================== ExecutionAndProvisioning 21.sp1_ 1.551 true Ulåst Ulåst FlashPolicy 21.sp1_ 1.551 false Ulåst Stoppet OpenClientServer 21.sp1_ 1.551 true Ulåst ulåst WebContainer 21.sp1_ 1.551 true Ulåst Ulåst 4 oppføringer funnet. * Vertsbaserte programmer: Kontekstbane for navn, versjon distribuert ============================================== ====================== 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 oppføringer funnet. 

Kontroller at åpen klientserver er distribuert og aktiv

Bruk kommandoene nedenfor til å distribuere og starte Open Client Server på den sekundære applikasjonsserveren hvis den ikke er distribuert eller ikke allerede har startet.

Trinn 1 : Distribuer serveren med følgende CLI-kommando:

AS_CLI/Maintenance/ManagedObjects> distribuere programmet OpenClientServer

Trinn 2 : Start serveren med denne kommandoen:

AS_CLI/Maintenance/ManagedObjects> start programmet OpenClientServer

Aktiver nummeraktivering

Kjør følgende kommandoer i CLI for å aktivere aktivering av tallene:

Trinn 1 : Kjør nummeraktiveringskommandoen:

AS_ CLI> cd SubscriberMgmt/NumberActivation

Trinn 2 : Kjør den aktiveringsaktiverte kommandoen:

AS_ CLI> set dnMode groupAndUserActivationEnabled

Trinn 3 : Når du blir bedt om å bekrefte, skriver du inn Y.

For BroadCloud

Utdragsverktøyet er integrert i BroadCloud-tjenesteleverandørportalen. En administrator for tjenesteleverandør kan:

1. Send inn forespørsler om uttrekk for opptil 50 kunder per forespørsel.
   Forespørsel om uttrekk kan ikke sendes inn for samme kunde mer enn 10 ganger i løpet av dagen.
2. Last ned den utpakkede datafilen, i ZIP-format, i opptil 28 dager fra datoen for innsending av forespørselen.

Figurene nedenfor viser tjenesteleverandørportalen.

Figur 6: Tjenesteleverandørportal

Figur 7: Tjenesteleverandørportal

For Cisco BroadWorks og Webex for BroadWorks

1. Utpakkingsverktøyet kjøres på den sekundære Cisco BroadWorks-applikasjonsserveren i partnernettverket og kobles til via OCI-P.
2. Verktøyet henter rå bedrifts-, gruppe-, tall, brukere, tjenester, enheter og myke klientdata fra Cisco BroadWorks- eller BroadCloud-plattformen og sender disse dataene til XML-filer som gir inngangene for transformasjonsverktøyet.

De neste delene forklarer hvordan du installerer og konfigurerer uttrekksverktøyet.

Forutsetninger

1. SCP uttrekksverktøyets binære filer til sekundær Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks Application Server for å konfigurere forutsetningene og kjøre uttrekksverktøyet.
3. Konfigurer tjenesteleverandøren og gruppe-ID-en som skal pakkes ut fra Cisco BroadWorks i filen conf/exportTool.yml. Se eksempelet på YAML-kodebiten nedenfor:

   ServiceProviderID-A:      – GroupID-A1 – GroupID-A2 – GroupID-A3 ServiceProviderID-B:                        – ALT 

4. Kontroller at den sekundære bruker-ID-en, passordet og vertsnavnet for Cisco BroadWorks-applikasjonsserveren er riktige i filen conf/partner.cfg:

   BROADWORKS_ BRUKER_ ID = admin BROADWORKS_ PASSWORD = admin BROADWORKS_ VERT_ NAVN = lokal vert OPPDATERT_ TOKEN = Partneradministratorens oppdateringstoken kopiert fra Token Generator-verktøyet. MIGRERING_ MODE = Verdiene som støttes erwebex_for_broadworks_to_wholesale . standardverdi erbroadworks_to_wholesale . Brukwebex_for_broadworks_to_wholesale for Webex for BroadWorks-overføringer. 

   Den OPPDATERT_ TOKEN egenskapen er obligatorisk for en Webex for BroadWorks-overføring.

5. Endre JDK/JRE-miljøbanen i export.sh-filen hvis den sekundære JDK/JRE-miljøbanen for Cisco BroadWorks Application Server er forskjellig fra filen:

   JAVA_ HOME=/usr/local/java/java_base

Instruksjoner for kjøring

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks Application Server fra katalogen for uttrekksverktøyet:

./export.sh

Terminallogger

Følgende logger er tilgjengelige i terminalen ved vellykket eksport: Kjøre Broadsoft Dataeksportverktøy:

 Kjøre Broadsoft Data Export Tool ********************************************* *** Starte eksportverktøy v: 1.15.0 Eksporten startet for SP=collabmigrationtestSP_engg , Group=collabmigrationtestGRP_engg Eksporterer brukere for SP=collabmigrationtestSP_engg , Group=collabmigrationtestGRP_engg Eksport av brukere fullført for SP=collabmigrationtestSP_engg , Group=collabmigrationtestGRP_engg Eksporten fullført for SP=collabmigrationtestSP_engg , Group=collabmigrationtestGRP_engg Eksport fullført Eksport Dump Zip-katalog : output/20221017223452_ ExportTool Eksporter Dump Zip-filnavn :extracted_data_1666060500618.zip Zip-fil med navnetextracted_data_1666060 500618.zip har blitt opprettet Opprettingsprosessen for ZIP-fil fullført Eksporterte filer konvertert som ZIP-fil ********************************* *****************

Utdata

En utdata-zip-fil (extracted_data_ .zip )-filen vil være tilgjengelig i den samme mappen for uttrekksverktøyet. Bruk kommandoen nedenfor for å vise og bruke ZIP-filen for Transform Tool-inndata:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 okt  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 okt  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 okt  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 okt  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 17. okt 22:34 utdata/ drwxrwxr-x 2 bwadmin bwadmin 4096 17. okt 22:34 logger/ -rw-rw-r-- 641 35extracted_data_1666060 500618.zip

Dette transformasjonsverktøyet kjøres for alle overføringer. Transformasjonsverktøyet kjøres på en hvilken som helst datamaskin, inkludert en partners bærbare administrator , og bruker de offentlige Webex API-ene. Den leser utdata fra uttrekksverktøyet ZIP (extracted_data_ .zip )-filen som en inngang, og transformerer den rå XML-en til et JSON-format som brukes av klargjøringsverktøyet.

Forutsetninger

Når du har lastet ned og pakket ut binære filer for overføringsverktøy, konfigurerer du følgende forutsetninger:

1. Angi OPPDATERING_ TOKEN (token kopiert fra tokengeneratorverktøyet) og NAVN_ AV_ HOVED_ LOCATION i filen conf/partner.cfg:

   OPPDATERT_ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAVN_ AV_ HOVED_ LOCATION=Hovedside

2. Du kan eventuelt angi KLARGJØRING_ ID (kopiert fra malen i Partner Hub) i filen conf/partner.cfg:

   PROVISJONERING_ ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Hvis du vil ha mer fullstendig bekreftelse av kunde-e-post -postadresse, kan du velge å angi PROVISIONERING_ ID.
3. Konfigurer manglende informasjon i filen input/customers.csv (se neste avsnitt) hvis den mangler.
4. Legg til sluttbruker e-postadresse i filen input/users.csv.
5. Hvis nye telefoner skal klargjøres, legger du til Mac-adressen og e-postadresse til brukerens nye telefon i filen input/newphones.csv. Dette er bare nødvendig hvis partneradministratorene ønsker å klargjøre nye telefoner i Engrossamtaler.
6. Konverter BroadWorks Call Centers til CxEssentials ved hjelp av filen input/cxessentials.csv.
7. Du kan eventuelt aktivere OPPGRADERING_ ALLE_ RING_ SENTER_ TIL_ CX_ ESSENTIALS-egenskapen for å konvertere alle Call Centers til CxEssentials.
8. Bruk filen input/locations.csv til å støtte overføringen av store foretak som lar administratorer overføre kundens plasseringer etter sted
9. Du kan eventuelt aktivere bruk av MAC-adresser fra User-Agent-hodet i SIP-REGISTER-meldingen når MAC-adresse ikke er tilgjengelig i Cisco BroadWorks- enhetsprofil. Fjern kommentering av linjen «USE_ MAC_ ADRESSE_ FRA_ SIP_ REGISTER=yes" i filen conf/partner.cfg

Fyller ut input/customers.csv

Filen input/customers.csv inneholder data som kanskje mangler i Cisco BroadWorks eller BroadCloud. Denne filen kan stå tom hvis all obligatorisk informasjon allerede er tilgjengelig. Du trenger ikke å fylle ut alle kolonner, bare den manglende informasjonen er obligatorisk.

Tabellen nedenfor forklarer de viktigste kolonnene i input/customers.csv.

Instruksjoner for kjøring

Kjør transformasjonsverktøyet i et hvilket som helst operativsystem. Bruk fremgangsmåten nedenfor for å kjøre verktøyet i Windows og macOS:

Windows

Kjør kommandoen nedenfor for å kjøre transformasjonsverktøyet i Windows:

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

macOS

Utfør følgende trinn for å kjøre transformasjonsverktøyet på macOS:

1. Opprett et virtuelt miljø og installer avhengigheter for å kjøre transformasjonsverktøyet ved hjelp av Python:

   python3 -m venv venv kilde venv/bin/activate python3 -m pip installasjonsforespørsler python3 -m pip installasjonsforespørsler-oauthlib 

2. Kjør transformasjonsverktøyet:

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

Forhåndskontroll av kunde/bruker

Transformasjonsverktøyet foretar API-kall til Webex for å fange opp potensielle klargjøringsproblemer. Som standard vil den bekrefte kundens adresse og primære e-postadresse. Hvis PROVISIONEN_ ID-verdien er angitt i filen conf/partner.cfg. Den vil også validere stedsinformasjon. Resultatene fra forhåndskontrollen er inkludert i unntaksrapporten.

I tillegg kan følgende valgfrie parametere legges til når du kjører transformasjonsverktøyet:

forhåndssjekk

I tillegg til å kjøre API-et for forhåndssjekk for kundeinformasjon, vil transformasjonsverktøyet også kjøre API-et for forhåndssjekk for abonnent-e-postene.

forhåndssjekkinformasjon

Som standard er bare forhåndskontrollfeil (dvs. problemer som blokkerer klargjøring) inkludert i unntaksrapporten. Hvis du legger til dette flagget, vil det også inkludere vellykkede forhåndskontrollresultater (f.eks. hvis det allerede finnes en Webex-organisasjon som kan tilknyttes automatisk).

Terminallogger

Følgende logger i terminalen ved vellykket transformasjon:

Sammendragsrapport BroadWorks-bedrifter som kan overføres: 1 BroadWorks-bedrifter som ikke kan migreres: 0 BroadWorks-brukere som kan overføres: 4 BroadWorks-brukere som ikke kan overføres: 0 telefoner som kan overføres: 3 telefoner som ikke er kompatible med Webex Calling: 0 

Unntaksrapport

Transformasjonsverktøyet genererer unntaksrapporten i utdata/ /exception_report .txt katalogen. Du kan bruke denne rapporten til å identifisere problemene som vil påvirke overføringen, og løse dem i Cisco BroadWorks-systemet.

Når du har endret brukerdataene for å løse unntaket, kjører du verktøyene for utpakking og transformering på nytt med de nye dataene. Eksempelfilen for unntaksrapporten er som følger:

Unntaksrapport Tue 18. okt 08:12:09 2022 Anbefaling for bedrifter med kommunikasjonssperre: konfigurere planen for utgående anrop manuelt i Control Hub________________________________________________________________________________ collabmigrationtestGRP_engg 

Utdata

En utdata-JSON ( kunde.json )-filen vil være tilgjengelig i utdata/ / katalogen. Prøven kunde.json filen er som følger:

{ "customer": { "provisioningId": "!!!!!!!!!!REPLACE_ MED_ PROVISIONINGID!!!!!!!!!!", "packages": [ "webex_calling «, »common_area_calling " ], "externalId": "external_id_engg_grp 1", "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": "Amerika/New_ York", "language": "en_us ", "numbers": [ "+15205551101", "+152055551102", "+152055551103", "+15205551104", "+152055551105", "+152055551100", "5+51506", "5+1506", "5+1506", "5+1506", "5+1506", ", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info ": { "service_provider_id ": "collabmigrationtestSP_engg «, »group_id ": "collabmigrationtestGRP_engg " }, "subscribers": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_ MED_ 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": "STANDARD", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EKSTERN", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_ MED_ PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber" : { "customerId": "!!!!!!!!!!REPLACE_ MED_ 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": "STANDARD", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_ MED_ PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber" : { "customerId": "!!!!!!!!!!REPLACE_ MED_ 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": "STANDARD", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber" : { "customerId": "!!!!!!!!!!REPLACE_ MED_ 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": "STANDARD", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EKSTERN", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_ MED_ PERSONID!!!!!!!!!!", "product": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants «: [], «call_queues «: [], «hunt_groups ": [], "planer": [], "call_parks «: [], «call_pickups «: [], «paging_groups «: [], «voice_portals ": [ { "name": "Automatisert taleportal", "firstName": "Automatisert", "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_org Id": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id ": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDETMTUzMS00MzNiLTllM2QtODExY2FLYTExYmVk" } }

Klargjøringsverktøyet kan kjøres på en hvilken som helst maskin, vanligvis (partnerens bærbare administrator ) og bruker de offentlige Webex API-ene. Den leser transformasjonsverktøyets utdata JSON ( kunde.json )-filen som en inngang og klargjøring av kunder, steder, numre, brukere, tjenester og enheter i Webex Wholesale RTM-løsningen.

Forutsetninger

Konfigurer følgende forutsetninger i katalogen for klargjøringsverktøyet:

1. Installer Java 8, 11 eller 17 på datamaskinen. Java er tilgjengelig fra mange kilder, inkludert:
   • 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. Når du har lastet ned og trukket ut binærfilene for overføringsverktøy, angir du JAVA_ HOME-miljøvariabelen iprovisioning_tool .sh for MAC ogprovisioning_tool .bat for Windows.
3. Filen partner.cfg:
   • Angi engroshandel_ PROVISJONERING_ ID og Oppdater_ TOKEN (token kopiert fra tokengeneratorverktøyet). Partneradministratorene må kontakte kontoteamet for å få KLARGJØRING_ ID:

     ENGROSHANDEL_ PROVISJONERING_ ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 OPPDATERING_ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

   • Angi TILLAT_ ADMIN_ INVITERER_ EMAILS til false, hvis partneren ikke ønsker å sende velkomst-e-post til brukerne. Standardverdien er sann.

4. Bruk WEBEX4BWKS_ E-POST_ SUBJECT-egenskapen for Webex for BroadWorks-overføringer for å sende e-postemnet for endring av passordforespørselen for Webex for BroadWorks-abonnenter.
5. Bruk WEBEX4BWKS_ E-POST_ BODY-egenskapen for Webex for BroadWorks-overføringer for å sende e-postteksten for endring av passordforespørselen for Webex for BroadWorks-abonnenter.

For BroadCloud-overføringer samme region:

1. Verktøyet hopper over klargjøring av numre, enheter og delt samtale samtalevisninger.
2. Verktøyet oppretter brukere og virtuelle brukere med internnummer og midlertidig internnummer.

For BroadCloud-overføringer en annen region:

1. Verktøyet klargjør numre, enheter og delt samtale samtalevisninger.
2. Verktøyet oppretter brukere og virtuelle brukere med faktiske telefonnumre og internnummer.
   Alle Europe BroadCloud-overføringer skjer til en annen region.

Instruksjoner for kjøring

Bruk fremgangsmåten nedenfor for å kjøre verktøyet i Windows og macOS:

Windows

Utfør følgende trinn for å kjøre verktøyet på Windows OS:

For å klargjøre én kunde: provision.bat -input= Slik klargjør du flere kunder: provision.bat -input= 

macOS

Utfør følgende trinn for å kjøre verktøyet på macOS:

For å klargjøre enkeltkunde: ./transform.sh -input= Klargjøring av flere kunder: ./transform.sh -input= 

Forutsetninger for Webex for BroadWorks Migration

Partneradministratorer må oppdatere integreringsmalen for BroadWorks for sameksistensfunksjoner i Webex for BroadWorks. Se bildet nedenfor:

Kjør klargjøringsverktøyet med et ekstra argument for overføring av Webex for BroadWorks til engroshandel.

Forberedelsesfase: er standardfasen der administratorer kan klargjøre BroadWorks-brukere som engros-abonnenter og fortsette med Webex for BroadWorks-brukere.

Vedlikeholdsfase: er den andre fasen der administratorer kan tilordne engros-lisensen til eksisterende Webex for BroadWorks-brukere. Du må kjøre klargjøringsverktøyet med et argument vedlikehold .

Fase etter overføring: Er den siste fasen der administratorer kan konvertere BroadWorks til Wholesale fullstendig. Du må kjøre klargjøringsverktøyet med et argument ettermigrering .

Terminallogger

Følgende er loggene i terminalen for vellykket klargjøring:

Verktøynavn: Versjon av klargjøringsverktøy: 1.15.0 ********** Startet behandling av fil : input/customer.json **************** Klargjøringskunde venter på kundeexternal_id_engg_grp 1 for å fullføre klargjøringen … Venter på kundeexternal_id_engg_grp 1 for å fullføre klargjøringen …   Kundeexternal_id_engg_grp 1 status : klargjorte klargjøringsnumre Klargjøring av brukere Klargjøring av brukerfunksjoner Klargjøring hilsener Klargjøringsplaner Klargjøring av enheter Klargjøring av delt samtale samtalevisninger Klargjøring av automatiske resepsjonister Klargjøring av samtalekøer Klargjøring av Hunt-grupper Klargjøring av gruppeoppkall Klargjøring av samtaleparker Klargjøring av mottak av anrop Klargjøring Complet Tale Portal ********** Fil : input/customer.json **************** 

Det skrives ut en tabell med antall steder som er opprettet for hver kjøring:

Utdata

Klargjøringsverktøyet genererer suksess- og feilrapporter i output/<external_id >/*.success/error filer. Se gjennom utdata- og feillogger for å bekrefte vellykket klargjøring.

Partneradministratorer kan bekrefte kundeklargjøringen i Partner Hub- og Control Hub-portalen. Se følgende illustrasjoner fra Partner Hub og Control Hub-portalen:

Figur 8: Partnerhub

Figur 9: Kontrollhub

Figur 10: Enheter

Figur 11: Ringer

For BroadCloud

For BroadCloud-partnere bruker du tjenesteleverandørportalen til å sende en overføringsforespørsel for numre, enheter og SCA-overføringer.

I tjenesteleverandørportalen kan en overføringsforespørsel omfatte opptil 50 kunder. Maksimalt 10 forespørsler kan sendes i løpet av en dag.

Figurene nedenfor viser tjenesteleverandørportalen.

Figur 12: Tjenesteleverandørportal

Figur 13: Tjenesteleverandørportal

For Cisco BroadWorks og Webex for BroadWorks

For Cisco BroadWorks- og Webex for BroadWorks-overføringer kjøres verktøyet på den sekundære Cisco BroadWorks-applikasjonsserveren i partnernettverket og kobles til AS via OCI-P. Den bruker JSON-utdata fra Transform Tool ( kunde.json )-filen som inndata og kjør OCI-P-kommandoer for å overføre enheter og myke klienter.

Ved vellykket operasjon vil flyttingsverktøyet for enhet:

1. Avregistrer enheter fra Cisco BroadWorks og registrer dem i engroshandel.
2. Brukere som bruker UC-One-klienten, omdirigeres til Webex-appen ved førstegangspålogging.
3. Deaktiver telefonnumrene fra Cisco BroadWorks eller fjern telefonnumrene fra BroadCloud.
4. Aktiver numre i Engroshandel.
5. Opprett delt samtale samtalevisninger i engroshandel for BroadCloud-overføringer. [Dette trinnet gjelder bare for BroadCloud-overføringer].

SCP og SSH

1. SCP flytteverktøyet for enheten til den sekundære Cisco BroadWorks-applikasjonsserveren.
2. SSH til den sekundære Cisco BroadWorks Application Server for å konfigurere forutsetningene og kjøre verktøyet for enhetsflytting.

Forutsetninger

1. Angi OPPDATERING_ TOKEN (token kopiert fra tokengeneratorverktøyet) i filen conf/partner.cfg:

   OPPDATERT_ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Kontroller at den sekundære bruker-ID-en, passordet og vertsnavnet for Cisco BroadWorks-applikasjonsserveren er riktige i filen conf/deviceMoveTool.conf:

   BROADWORKS_ BRUKER_ ID = admin BROADWORKS_ PASSWORD = admin BROADWORKS_ VERT_ NAVN = lokal vert

3. Kontroller at JDK/JRE-miljøbanen er riktig i devicemove.sh

    JAVA_ HOME=/usr/local/java/java_base

4. Administratorer kan bruke filen locations.csv fra inndatakatalogen til å overføre de spesifikke gruppene i stedet for alle gruppene under en bedrift.

Polycom-telefoner

Hvis du vil flytte Polycom-telefoner fra Cisco administrator til Wholesale Calling, må en partneradministrator opprette en ny identitets-/enhetsprofiltypefil på systemnivå i Cisco BroadWorks hver Polycom-enhetsmal. Se figur 14 og last opp den tilpasset fil filfilen device-move-tool/conf/deviceProfile/{region}/polycom_vvx .cfg . Når du har lastet opp den nye enhetsfilen, må du kontrollere at den nyopprettede filen finnes på gruppenivå. Kontroller også den filenmigration_%BWMAC ADDRESS% .cfg er ikke i konflikt med eksisterende filer i systemet).

Den brukes internt av flyttverktøyet for enheten.

Overføringsprosessen for Polycom-telefoner:

1. Verktøyet for flytting av enhet erstatter fil%BWMACADDRESS% .cfg på enhetsnivå medpolycom_vvx 2.cfg. Merk at denne filen refererer tilmigration_%BWMACADDRESS% .cfg.
2. Bygg opp enhetsprofilene på nytt på gruppe- eller enhetsnivå.
   Å handle på gruppenivå eller enhetsnivå avhenger av konfigurasjonen av parameteren deviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Verktøyet for enhetsflytting ber Cisco BroadWorks Application Server om å starte telefoner på nytt på gruppenivå eller enhetsnivå.
4. Etter omstartsforespørselen laster Polycom-telefoner ned og behandler% BWMACADDRESS% .cfg, som ber Polycom-telefonene om å laste ned og behandlemigration_%BWMACADDRESS% .cfg, som setter device.prov.serverName tilhttps://plcm.sipflash.com.
   https://plcm.sipflash.com for USA-regionen har andre regioner andre nettadresser.
5. Polycom-telefonen kan lastes ned%BWMACADDRESS% .cfg frahttps://plcm.sipflash.com og vil bli administrert av Webex Calling DMS.

Figur 14: Identitet/ enhetsprofil fil lagt til

Instruksjoner for kjøring

Det finnes to metoder for å starte DMT, den første er å starte gjennom én kunde om gangen, og den andre er å kjøre gjennom flere kunder samtidig.

Verktøyet for enhetsflytting kjøres fra den sekundære Cisco BroadWorks Application Server i katalogen for verktøy for enhetsflytting:

For enhetsflytting av enkeltkunde: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json For enhetsflytting av flere kunder: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json I tillegg støtter verktøyet for enhetsflytting overføring av én/spesifikk telefon(er) fra 1.35.0-versjon. Bruk kommandoen nedenfor: ./devicemove.sh -integration -input= -macaddress=4CBC4883A6F8,48256741CBE9 

Terminallogger

Følgende er loggene i terminalen ved vellykket kjøring av enhetsflytteverktøyet for enhetsoverføring:

Verktøynavn: Versjon av verktøy for enhetsflytting: 1.15.0 Enhetsverktøy startet... Gyldige enheter for overføring : --------------------------------------------------- --------------------------------------------------- ---------------| Enhetstype| Mac| Versjon| E-post| --------------------------------------------------- --------------------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenalex@gmail.com| --------------------------------------------------- --------------------------------------------------- --------------- Vil du overføre alle disse enhetene? ([Y]es or [N]o) ja Laster opp enhetsprofiler for DMS Cisco MPP LC Gjenoppbygging av enhetsprosess startet Gjenoppbygging av enhetsprosess fullført Omstartsprosess Startet Omstartsprosess fullført Endrer profiler for Business Communicator under gruppe collabmigrationtestGRP_engg Aktiveringsprosess for webex-telefonnumre startet for kundeorganisasjons-ID : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktivering av webex-telefonnumre-prosess fullført for kundeorganisasjons-ID: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Prosessen for deaktivering av Broadworks-telefonnumre startet for groupId : collabmigrationtestGRP_engg Prosessen for deaktivering av Broadworks-telefonnumre er fullført for gruppe-ID : collabmigrationtestGRP_engg Enhetsoverføring fullført

Utdata

Etter enhetsoverføringen er enhetene koblet til og klare til å foreta/motta anrop. Se figur 15 for å se et eksempel på enhetsstatus:

Figur 15: Enhetsstatus

Etter enhetsoverføringen har numrene blitt aktive. Se figur 16 for å se et eksempel på tall som er aktive:

Figur 16: Aktive numre

Tilbakestillingsoperasjonen må utføres for én bedrift om gangen.

For BroadCloud Carrier

Tilbakestillingsprosessen for BroadCloud-partnere er som følger:

1. Åpne en billett med Cisco TAC for å be om en tilbakestilling av enheten.
2. Kjør flyttverktøyet for enhet i tilbakestillingsmodus:
   • Tilordning av telefonnumre fra Webex Calling, slik at brukere og tjenester kun har internnumre.
   • E-postadresser i Webex Calling blir tilbakestilt til midlertidige e-postadresser.
   • Telefoner blir slettet fra Webex Calling.
   • Telefonnumre, e-postadresser som brukes som alternative ID-er og telefoner blir gjenskapt i BroadCloud.
   • Telefonene vil bli startet på nytt.
3. Partneradministratorer må flytte PSTN-telefonnumre tilbake til BroadCloud Carrier.

For Cisco BroadWorks og Webex for BroadWorks

Tilbakestillingsprosessen for Cisco BroadWorks og Webex for BroadWorks er som følger:

1. Åpne en billett med Cisco TAC for å be om en tilbakestilling av enheten.
2. Kjør enhetsflytteverktøyet i tilbakestillingsmodus på den sekundære BroadWorks Application Server for å tilbakestille enhetsoverføringene. Dette vil sette DMS-URL-en tilbake til tjenesteleverandør DMS-URL for enhetsprofiler i Cisco BroadWorks, og telefonnumre aktiveres på nytt.
3. Webex Calling Team setter DMS-URL-en tilbake til tjenesteleverandør DMS-URL i enhetsprofiler i Webex Calling.
4. Partneradministratorer må deaktivere eller slette telefonnumrene i Webex Calling via Control Hub-portalen.
5. Partneradministratorer må flytte PSTN-telefonnumre tilbake til Cisco BroadWorks.

Instruksjoner for å kjøre verktøy for flytting av enhet i tilbakestillingsmodus

Følg trinnene nedenfor for å kjøre verktøyet for flytting av enhet i tilbakestillingsmodus:

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks Application Server i katalogen for flyttverktøy for enheten:

Gjenopprett profiler

./devicemove.sh -input= -revertProfiles

Tilbakestill tall

./devicemove.sh -input= -revertNumbers

Terminallogger

Vi får følgende logger i terminalen ved vellykket kjøring av flyttverktøyet for enhet for tilbakestilling:

Gjenopprett profiler

Verktøynavn: Versjon av verktøy for enhetsflytting: 1.15.0 Enhetsverktøy startet for tilbakestillingsprosess... Enheter som kan flyttes tilbake fra Webex Calling til BroadWorks: – -------------------------------------------------- --------------------------------------------------- ------------------| Enhetstype| Mac| Versjon| E-post| --------------------------------------------------- --------------------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenalex@gmail.com| --------------------------------------------------- --------------------------------------------------- --------------- Vil du flytte tilbake disse enhetene fra Webex Calling til BroadWorks? (Ja, Y, Nei, N):  ja Laster opp enhetsprofiler for DMS Cisco MPP LC Gjenoppbygging av enhetsprosess startet Gjenoppbygging av enhetsprosess fullført Omstartsprosess startet omstartsprosess fullført Enhetsoverføring fullført for avregistreringsprosess 

Tilbakestill tall

Verktøynavn: Versjon av verktøy for enhetsflytting: 1.15.0 Vil du fortsette å tilbakestille numre til Broadworks?  ([Y]es eller [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 Aktiveringsprosessen for Broadworks-telefonnumre er fullført for groupId : collabmigrationtestGRP_engg Gjenopprettingsprosess for enhetsoverføring er fullført