Støttede telefoner opprettes automatisk og tilordnes brukere i Webex Calling av klargjøringsverktøyet. Telefonene merket "Ja" i kolonnen "Støttes i flyttingsverktøyet for enheten" flyttes også automatisk fra Cisco BroadWorks eller BroadCloud til Webex Calling når flyttingsverktøyet for enheten kjøres. Telefoner merket "Nei" i den kolonnen trenger en manuell inngripen for å endre DMS URL-adressen i Cisco BroadWorks-enhetsmalen eller i selve telefonen.

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

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

Forutsetninger

Etter nedlasting, pakk ut overføringsverktøybinærene.

Angi banen for JRE/JDK-miljøet i token_generator.sh for MAC og token_generator.bat for Windows. Hvis JAVA_HOME-banen allerede finnes, brukes den på nytt av verktøyet.

• mac: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Content/Home/"

• Vinduer: JAVA_HOME=C:\Forbedring~1\Java\jre1.8.0_321

Instruksjoner å kjøre

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

Vinduer:

token_generator.bat

MacOS

./token_generator.sh

Utgang:

Verktøynavn: Token Generator verktøyversjon: 1.13.0 Last inn URL-adressen i nettleseren din: http://localhost:8080 

Åpne URL-adressen i nettleseren på terminalen, logg på med partneradministratorlegitimasjonen for å få TOKENET og kopier det samme for videre bruk.

Illustrasjonene i brukergrensesnittet er gitt nedenfor for referanse:

Figur 3: Logg på med Cisco Webex

Figur 4: Vinduet for legitimasjon

Figur 5: Tokengenerasjon

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

Aktiver OCI-P-tilkobling

Flytteverktøyet for enheten kommuniserer med BroadWorks via OCI-P-kommandoer, for å aktivere OCI-P-tilkobling, bruk trinnene nedenfor:

Trinn 1: Bruk CLI til å konfigurere generelle innstillinger.

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

AS_CLI> CD /Applications/OpenClientServer/GeneralSettings.

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

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

Hvis innstillingene ikke samsvarer med det ovennevnte, bruker du kommandoen set til å konfigurere innstillingene på nytt.

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

Endre katalogen til OCI Proxy:

AS_CLI> CD /Applications/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginNivåScreening = false enableResponsCaching = false responseCacheVarighetTimer = 24 responsCacheRenewPeriodMinutter = 30 meldingKøKapasitet = 50 meldingKøTidsavbruddSekunder = 1800 

Hvis innstillingene ikke samsvarer med det ovennevnte, bruker du kommandoen set til å 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 å få de gjeldende OCI-klargjøringsinnstillingene:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> få 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> få broad works og sjekk at utdataene ser OK ut. Se nedenfor for prøveutdata: AS_CLI/Maintenance/ManagedObjects> få broadWorks BroadWorks-administrerte objekter ========================== * Server: Identitet..............: AS-versjon...............: Rel_21.sp1_1.551 Administrativ tilstand..: Ulåste * Programmer: Navneversjon Distribuert Administrativ tilstand Effektiv tilstand ========================================================================================= Utførelse og klargjøring 21.sp1_1.551 true Ulåst Ulåst FlashPolicy 21.sp1_1.551 false Ulåst Stopped 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: Navneversjon Context Path 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. 

Bekreft distribuert og aktiv åpen klientserver

Bruk kommandoene nedenfor til å distribuere og starte Åpne klientserveren på den sekundære programserveren hvis den ikke er distribuert eller ikke allerede har startet.

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

AS_CLI/Maintenance/ManagedObjects> distribuer programmet OpenClientServer

Trinn 2: Start serveren med denne kommandoen:

AS_CLI/Maintenance/ManagedObjects> starte programmet OpenClientServer

Aktiver aktivering av numre

Utfør følgende kommandoer i CLI for å aktivere aktivering av numrene:

Trinn 1: Kjør kommandoen for nummeraktivitet:

AS_CLI> cd SubscriberMgmt/NumberActivation

Trinn 2: Kjør aktivert kommando:

AS_CLI> set dnMode groupAndUserActivationEnabled

Trinn 3: Skriv inn Y ved bekreftelsesmeldingen.

For BroadCloud

Utvinningsverktøyet er integrert i BroadCloud-tjenesteleverandørportalen. Administrator for en tjenesteleverandør kan:

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

Tallene nedenfor viser tjenesteleverandørportalen.

Figur 6: Tjenesteleverandørportal

Figur 7: Tjenesteleverandørportal

For Cisco BroadWorks og Webex for BroadWorks

1. Utpakkingsverktøyet kjører på den sekundære Cisco BroadWorks Application Server i partnernettverket og kobles til via OCI-P.
2. Verktøyet henter rå data fra bedrifter, grupper, numre, brukere, tjenester, enheter og myke klienter fra Cisco BroadWorks- eller BroadCloud-plattformen og sender disse dataene til XML-filer som gir inndataene for transformeringsverktøyet.

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

Forutsetninger

1. SCP utvinningsverktøybinærene til sekundær Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks Application Server for å konfigurere forutsetningene og kjøre utvinningsverktøyet.
3. Konfigurer tjenesteleverandøren og gruppe-ID-en til å trekke ut fra Cisco BroadWorks i conf/exportTool.yml. Se YAML-utskriften nedenfor:

   Tjenesteleverandør ID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - alle 

4. Kontroller at den sekundære bruker-ID, passord og vertsnavnet for Cisco BroadWorks-programserveren er riktig i filen conf/partner.cfg:

   BROADWORKS_BRUKER_ID = admin BROADWORKS_PASSORD = admin BROADWORKS_VERT_NAVN = localhost OPPDATERING_TOKEN = partneradministratorens oppdateringstoken kopiert fra tokengeneratorverktøyet. MIGRERINGSMODUS_ = Støttede verdier er webex_for_broadworks_to_wholesale. Standardverdien er broadworks_to_wholesale. Bruk webex_for_broadworks_to_wholesale for Webex for BroadWorks-overføringer. 

   Egenskapen OPPDATER_TOKEN er obligatorisk for en Webex for BroadWorks-migrering.

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

   JAVA_HOME=/usr/local/java/java_base

Instruksjoner å kjøre

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks Application Server fra utvinningsverktøykatalogen:

./export.sh

Terminallogger

Følgende logger er tilgjengelige i terminalen ved vellykket eksport: Kjører BroadSoft Data Export Tool:

 Kjører BroadSoft Data Export Tool ************************************************ Starter Export Tool v: 1.15.0 Eksport startet for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport av brukere for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport av brukere fullført for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport fullført for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport fullført Export Dump Zip Directory : utdata/20221017223452_ExportTool Export Dump Zip-filnavn:extracted_data_1666060500618.zip Zip-fil med navnet extracted_data_1666060500618.zip har blitt opprettet ZIP-filopprettelsesprosessen fullført Eksporterte filer konvertert til ZIP-fil ************************************************** 

Utdata

En utdatafil ZIP (extracted_data_.zip) vil være tilgjengelig i samme utdataverktøykatalog. Bruk kommandoen nedenfor for å vise og bruke ZIP-filen for inndata for transformeringsverktøy:

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 konf/ drwxrwxr-x 3 bwadmin bwadmin 4096 oktober 17 22:34 utgang/ drwxrwxr-x 2 bwadmin bwadmin 4096 oktober 17 22:34 logger/ -rw-rw-r-- 1 bwadmin bwadmin 46341 oktober 17 22:35 extracted_data_1666060500618.zip 

Dette transformeringsverktøyet kjøres for alle overføringer. Transformeringsverktøyet kjører på en hvilken som helst datamaskin, inkludert en partnerens administratorbærbare datamaskin, og bruker Webex Public API-er. Den leser ZIP-filen (extracted_data_.zip) som en inndata og konverterer den rå XML til et JSON-format som brukes av klargjøringsverktøyet.

Forutsetninger

Når du har lastet ned og ekstrahert de binære overføringsverktøyene, konfigurerer du følgende forutsetninger:

1. Angi REFRESH_TOKEN (token kopiert fra tokengenereringsverktøyet) og NAVNET_PÅ_HOVEDPLASSERINGEN_ i filen conf/partner.cfg:

   OPPDATERING_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main 

2. Angi eventuelt KLARGJØRINGS-ID_ (kopiert fra malen i Partner Hub) i filen conf/partner.cfg:

   KLARGJØRING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For å få mer fullstendig bekreftelse av kundens e-postadresse kan du eventuelt angi KLARGJØRINGS-ID_.
3. Konfigurer manglende informasjon i inndata/customers.csv-filen (se neste avsnitt) hvis den mangler.
4. Legg til sluttbrukerens e-postadresse i inndata/users.csv-filen.
5. Hvis nye telefoner skal klargjøres, legger du til mac-adressen og e-postadressen til brukerens nye telefon i inndata/newphones.csv-filen. Dette er kun nødvendig hvis partneradministratorene ønsker å klargjøre nye telefoner i engrossamtaler.
6. Konverter BroadWorks Call Centers til CxEssentials ved hjelp av input/cxessentials.csv-filen.
7. Du kan også aktivere egenskapen OPPGRADERE_ALLE_SAMTALESENTRE__TIL_CX_ESSENTIALS for å konvertere alle samtalesentre til CxEssentials.
8. Bruk inndata/locations.csv-filen til å støtte den store bedriftsmigreringen som gjør det mulig for administratorer å migrere kundens steder etter sted
9. Du kan også aktivere bruk av MAC-adresser fra User-Agent-toppteksten i SIP REGISTER-meldingen når MAC-adressen ikke er tilgjengelig i Cisco BroadWorks-enhetsprofilen. Fjern kommentaren på linjen «USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes» i filen conf/partner.cfg

Fylling av inndata/customers.csv

Filinndataene/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 inndata/customers.csv.

Instruksjoner å kjøre

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

Windows

Utfør kommandoen nedenfor for å kjøre transformeringsverktøyet i Windows:

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

macOS

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

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

   python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. Kjør transformeringsverktøyet:

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

Forhåndskontroll av kunde/bruker

Transformeringsverktøyet foretar API-anrop til Webex for å fange opp potensielle klargjøringsproblemer. Som standard vil den validere kundens adresse og primære e-post. Hvis PROVISIONING_ID-verdien er angitt i filen conf/partner.cfg, vil den også validere stedsinformasjon. Resultatene av forhåndskontrollen er inkludert i unntaksrapporten.

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

forhåndskontroll

I tillegg til å kjøre forhåndskontrollens API for kundeinformasjon, vil transformeringsverktøyet også kjøre forhåndskontrollens API for abonnentens e-postmeldinger.

forhåndskontrollinformasjon

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 legges ved automatisk).

Terminallogger

Følgende logger i terminalen ved vellykket transformering:

Sammendragsrapport for BroadWorks-bedrifter som kan overføres: 1 BroadWorks-bedrifter som ikke kan overføres: 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

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

Etter å ha endret brukerdataene for å løse unntaket, kan du kjøre utvinnings- og transformeringsverktøyene på nytt med de nye dataene. Eksempelunntaksrapportfilen som følger:

Unntaksrapport tue. okt. 18 08:12:09 2022 Virksomheter med anbefaling av kommunikasjonsblokkering: konfigurere planen for utgående anrop manuelt i Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Utdata

En utdatafil JSON (customer.json) vil være tilgjengelig i utdatakatalogen// . Eksempelfilen customer.json er som følger:

{ "customer": { "provisioningId": "!!!!!!!!!!REPLACE_med_KLARGJØRINGS-ID!!!!!!!!!!", "pakker": [ "webex_calling","common_area_calling" ], "externalId": "external_id_engg_grp1", "adresse": { "addressLine1": "100 Main Street", "addressLine2": "", "by": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "US" }, "customerInfo": { "name": "Engineering Group - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "location": { "name": "Main", "address": { "addressLine1": "100 Main", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "US" }, "timezone": "Amerika/New_York", "språk": "en_us", "numre": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "hovednummer": "+15205551101" } } } , "broadworks_info«{»service_provider_id": "samarbeidsmigreringstestSP_engg","group_id": "samarbeidsmigreringstestGRP_engg" }, "abonnenter": [ { "amareswaranvel+benjaminjack@gmail.com": { "abonnent": { "customerId": "!!!!!!!!!!REPLACE_med_CUSTOMERID!!!!!!!!!!", "e-post": "amareswaranvel+benjaminjack@gmail.com", "pakke": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/talepost": { "enabled": sann, "sendBusyCalls": { "aktivert": sann, "hilsen": "DEFAULT" }, "send ubesvarte anrop": { "aktivert": sann, "hilsen": "STANDARD", "RingsNumber": 3 }, "messageStorage": { "mwiEnabled": sann, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "abonnent": { "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": sann, "sendBusyCalls": { "aktivert": sann, "hilsen": "DEFAULT" }, "send ubesvarte anrop": { "aktivert": sann, "hilsen": "STANDARD", "RingsNumber": 3 }, "messageStorage": { "mwiEnabled": sann, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "abonnent": { "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": sann, "sendBusyCalls": { "aktivert": sann, "hilsen": "DEFAULT" }, "send ubesvarte anrop": { "aktivert": sann, "hilsen": "STANDARD", "RingsNumber": 3 }, "messageStorage": { "mwiEnabled": sann, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "abonnent": { "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": sann, "sendBusyCalls": { "aktivert": sann, "hilsen": "DEFAULT" }, "send ubesvarte anrop": { "aktivert": sann, "hilsen": "STANDARD", "RingsNumber": 3 }, "messageStorage": { "mwiEnabled": sann, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_med_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "tidsplaner": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "navn": "Automatisert taleportal", "fornavn": "Automatisert", "etternavn": "Taleportal", "languageCode": "en_us", "telefonnummer": "+15205551105", "internnummer": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "steder": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Klargjøringsverktøyet kan kjøre på en hvilken som helst maskin, vanligvis (partnerens administratorbærbare) og bruker Webex Public API-er. Den leser JSON-filen for transformeringsverktøyutdata (customer.json) som en inndata og klargjøring av kunder, steder, numre, brukere, tjenester og enheter i Webex Wholesale RTM-løsningen.

Forutsetninger

Konfigurer følgende forutsetninger i klargjøringsverktøykatalogen:

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. Etter nedlasting og utpakking av binærene for overføringsverktøy, angir du variabelen JAVA_HOME-miljø i provisioning_tool.sh for MAC og provisioning_tool.bat for Windows.
3. Filen partner.cfg:
   • Angi ENGROS_KLARGJØRINGS_ID og OPPDATER_TOKEN (token kopiert fra tokengeneratorverktøyet). Partneradministratorene må kontakte kontoteamet sitt for å få KLARGJØRINGS-ID_:

     KLARGJØRING_ENGROS_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Angi ALLOW_ADMIN_INVITE_E-POST til usann hvis partneren ikke ønsker å sende en velkomst-e-post til brukerne. Standardverdien er sann.

4. Bruk egenskapen WEBEX4BWKS_EMAIL_SUBJECT for Webex for BroadWorks-migreringer til å sende e-postemnet for forespørsel om endring av passord for Webex for BroadWorks-abonnenter.
5. Bruk egenskapen WEBEX4BWKS_EMAIL_BODY for Webex for BroadWorks-migreringer for å sende e-postteksten for forespørsel om endring av passord for Webex for BroadWorks-abonnenter.

For BroadCloud-migreringer samme region:

1. Verktøyet hopper over klargjøring av numre, enheter og delte anropsvisninger.
2. Verktøyet oppretter brukere og virtuelle brukere med utvidelse og midlertidig utvidelse.

For BroadCloud-migreringer en annen region:

1. Verktøyet vil klargjøre numre, enheter og delte anropsvisninger.
2. Verktøyet oppretter brukere og virtuelle brukere med faktiske telefonnumre og internnumre.
   Alle BroadCloud-migreringer i Europa er til en annen region.

Instruksjoner å kjøre

Bruk følgende trinn 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= Klargjør flere kunder: provision.bat -input= 

macOS

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

Klargjør én kunde: ./transform.sh -input= Klargjør flere kunder: ./transform.sh -input= 

Forutsetninger for Webex for BroadWorks-migrering

Partneradministratorer må oppdatere sin BroadWorks-innføringsmal for Webex for BroadWorks sameksistensfunksjoner. Se følgende bilde:

Når Webex for BroadWorks-innføringsmalen er oppdatert for å støtte migrering, ber du Cisco-kontoteamet om å aktivere funksjonen «engros-partner-blending-aktivert» på partnernivå. Dette gjør det mulig å legge til engrospakker i eksisterende Webex for BroadWorks-kundeorganisasjoner under klargjøringen.

Kjør klargjøringsverktøyet med et ekstra argument.

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

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

Post-migreringsfase: Er den siste fasen når administratorer kan konvertere BroadWorks til engroshandel fullstendig. Du må kjøre klargjøringsverktøyet med et argument postmigrering.

Terminallogger

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

Verktøynavn: Klargjøringsverktøyversjon: 1.15.0 ********** Startet behandling av fil: input/customer.json **************** Klargjøring av kunde Venter på at kunde external_id_engg_grp1 skal fullføre klargjøringen... Venter på at kunde external_id_engg_grp1 skal fullføre klargjøringen …   Status for kunde external_id_engg_grp1: klargjorte klargjøringsnumre klargjøringsbrukere klargjøringsbrukerfunksjoner klargjøringshilsener klargjøringsplaner klargjøringsenheter klargjøringsenheter klargjøringsenheter klargjøringsenheter klargjøringsenheter klargjøringsenheter klargjøringsenheter klargjøringsenheter klargjøringsenheter klargjøringsenheter taleportal ********** fullført fil : inndata/customer.json **************** 

En tabell vil bli trykt med antall plasseringer som er opprettet for hver kjøring:

Utdata

Klargjøringsverktøyet genererer suksess- og feilrapporter i utdata/<external_id>/*.success/error -filene. Gå gjennom vellykket 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: Partner Hub

Figur 9: Control Hub

Figur 10: Enheter

Figur 11: Ringe

For BroadCloud

For BroadCloud-partnere bruker du tjenesteleverandørportalen til å sende inn 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 inn innen en dag.

Tallene 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-migrering kjører verktøyet på den sekundære Cisco BroadWorks-programserveren i partnernettverket og kobler seg til AS via OCI-P. Den bruker utdatafilen JSON (customer.json) som inndata og kjører OCI-P-kommandoene for å overføre enheter og myke klienter.

Når funksjonen er vellykket, vil flytteverktøyet for enheten:

1. Avregistrer enheter fra Cisco BroadWorks og registrer dem i engroshandel.
2. Brukere som bruker UC-One-klienten vil omdirigere til Webex-appen ved første gangs pålogging.
3. Deaktiver telefonnumrene fra Cisco BroadWorks eller fjern telefonnumrene fra BroadCloud.
4. Aktiver numre i engroshandel.
5. Opprett delte anropsvisninger i engroshandel for BroadCloud-overføringer. [Dette trinnet gjelder bare for BroadCloud-overføringer].

SCP og SSH

1. SCP enheten flytter verktøyet til den sekundære Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks-programserveren for å konfigurere forutsetningene og kjøre verktøyet for flytting av enheten.

Forutsetninger

1. Angi REFRESH_TOKEN (token kopiert fra tokengenerator-verktøyet) i filen conf/partner.cfg:

   OPPDATERING_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Kontroller at den sekundære bruker-ID, passord og vertsnavnet for Cisco BroadWorks-programserveren er riktig i filen conf/deviceMoveTool.conf:

   BROADWORKS_BRUKER_ID = admin BROADWORKS_PASSORD = admin BROADWORKS_VERT_NAVN = localhost 

3. Hvis du vil sende aktiverings-e-poster på nytt, må du angi SEND PÅ NYTT_invitasjon_EMAILS=sann i filen conf/partner.cfg.

   Hvis administratorer ønsker å sende invitasjons-e-poster til brukerne sine under overføringen, bør de fjerne kommentaren i egenskapen «SEND INVITASJONS_E-MAILS_=true» i filen conf/partner.cfg. Ellers skal eiendommen forbli uendret.

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom-telefoner

For å flytte Polycom-telefoner fra Cisco BroadWorks 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 egendefinerte filen device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Når du har lastet opp den nye enhetsfilen, må du kontrollere at den nylig opprettede filen finnes på gruppenivå. Kontroller også at filen migration_%BWMAC ADDRESS%.cfg ikke er i konflikt med noen eksisterende fil i systemet).

Den brukes internt av flyttingsverktøyet for enheten.

Overføringsprosessen for Polycom-telefoner:

1. Flytteverktøyet for enheten erstatter filen %BWMACADDRESS%.cfg på enhetsnivå med polycom_vvx2.cfg. Denne filen refererer til migration_%BWMACADDRESS%.cfg.
2. Gjenoppbygg enhetsprofilene på gruppenivå eller enhetsnivå.
   Handling på gruppenivå eller enhetsnivå avhenger av konfigurasjonen av parameteren deviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Verktøyet for flytting av enheten ber Cisco BroadWorks-programserveren om å starte telefoner på nytt på gruppenivå eller enhetsnivå.
4. Etter omstartsforespørselen lastes Polycom-telefonene ned og prosesser% BWMACADDRESS%.cfg, som ber Polycom-telefonene om å laste ned og prosesser migration_%BWMACADDRESS%.cfg, som angir device.prov.serverName til https://plcm.sipflash.com.
   https://plcm.sipflash.com for den amerikanske regionen har andre regioner forskjellige URL-adresser.
5. Polycom-telefonen laster ned %BWMACADDRESS%.cfg fra https://plcm.sipflash.com og vil bli administrert av Webex Calling DMS.

Figur 14: Legg til fil for identitets-/enhetsprofil

Instruksjoner å kjøre

Det finnes to metoder for å påkalle DMT, den første er å påkalle gjennom en enkelt kunde om gangen, og den andre er å kjøre gjennom flere kunder samtidig.

Flytteverktøyet for enheten kjøres fra den sekundære Cisco BroadWorks-programserveren i katalogen for flytteverktøy for enheten:

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 enhetsflyttingsverktøyet migrering av enkelttelefoner/spesifikke telefoner fra 1.35.0-utgivelse. Bruk kommandoen nedenfor: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminallogger

Følgende er loggene i terminalen på vellykket kjøring av verktøyet for flytting av enheten for flytting av enheten:

Verktøynavn: Verktøyversjon for flytting av enhet: 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_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 | ------------------------------------------------------------------------------------------------------------------- Vil du overføre alle disse enhetene? ([Y]er eller [N]o) ja Opplasting av enhetsprofiler for DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Completed Reboot Process Started Reboot Process Completed Endring av profiler for Business Communicator under gruppesamarbeidsmigreringtestGRP_engg Aktiver Webex-telefonnummerprosessen startet for kundeorganisasjon Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktiver fullført prosess for Webex-telefonnumre for kunde-organisasjons-ID: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Deaktiver telefonnummerprosessen startet for groupId : collabmigrationtestGRP_engg Deaktiver broad works telefonnummerprosess fullført for groupId : samarbeidsmigreringstestGRP_engg Enhetsoverføring fullført 

Utdata

Etter enhetsmigreringen har enhetene kommet på nettet og er klare til å foreta/motta anrop. Se figur 15 for et eksempel på enhetsstatusen:

Figur 15: Enhetsstatus

Etter enhetsmigreringen har numrene blitt aktive. Se figur 16 for å se et eksempel på hvilke tall som er aktive:

Figur 16: Aktive numre

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

For BroadCloud-transportør

Tilbakestillingsprosessen for BroadCloud-partnere er som følger:

1. Åpne en billett med Cisco TAC for å be om tilbakestilling av enheten.
2. Kjør enhetens flytteverktøy i tilbakestilt modus:
   • Telefonnumre vil ikke bli tilordnet fra Webex Calling, slik at brukere og tjenester kun kan få utvidelser.
   • E-postadresser i Webex Calling tilbakestilles til midlertidige e-postadresser.
   • Telefoner slettes fra Webex Calling.
   • Telefonnumre, e-postadresser som brukes som alternerende ID-er og telefoner vil bli gjenopprettet i BroadCloud.
   • Telefoner 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 tilbakestilling av enheten.
2. Kjør verktøyet for flytting av enheten i tilbakestillingsmodus på den sekundære BroadWorks Application Server for å tilbakestille enhetsoverføringer. Dette vil sette DMS URL-adressen tilbake til tjenesteleverandørens DMS URL for enhetsprofiler i Cisco BroadWorks og aktivere telefonnumre på nytt.
3. Webex Calling-teamet setter DMS URL-adressen tilbake til tjenesteleverandørens DMS URL i enhetsprofiler i Webex Calling.
4. Partneradministratorer må deaktivere eller slette telefonnumrene i Webex Calling gjennom Control Hub-portalen.
5. Partneradministratorer må flytte PSTN-telefonnumre tilbake til Cisco BroadWorks.

Instruksjoner for å kjøre verktøyet for flytting av enheten i tilbakestilt modus

Følg trinnene nedenfor for å kjøre enhetens flyttingsverktøy i tilbakestilt modus:

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks-programserveren inne i verktøykatalogen for flytting av enheten:

Sett tilbake profiler

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Tilbakestill numre

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

Terminallogger

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

Sett tilbake profiler

Verktøynavn: Verktøyversjon for flytting av enhet: 1.15.0 Enhetsverktøy startet for tilbakestilling av prosess... 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_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 | ------------------------------------------------------------------------------------------------------------------- Vil du flytte disse enhetene tilbake fra Webex Calling til BroadWorks? (Ja, Y, Nei, N):  Ja Opplasting av enhetsprofiler for DMS Cisco MPP LC Rebuild enhetsprosess startet Rebuild enhetsprosess fullført Reboot prosess startet Reboot prosess fullført Migrering av enhet fullført for avklaringsprosess 

Tilbakestill numre

Verktøynavn: Verktøyversjon for flytting av enhet: 1.15.0 Vil du fortsette å tilbakestille numre til Broadworks?  ([Y]er eller [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Start å tilbakestille Aktiver BroadWorks telefonnummerprosess startet for groupId : collabmigrationtestGRP_engg Aktiver broad works telefonnummerprosess fullført for groupId : samarbeidsmigreringstestGRP_engg Enhetsoverføring Tilbakestill prosess fullført