Takk for tilbakemeldingen.

Støttede telefoner opprettes automatisk og tilordnes brukere Webex Calling av klar gjøringsverktøyet. Telefonene merket «ja» i kolonnen «Støttet i enhetsflytte verktøyet» flyttes også automatisk fra Cisco BroadWorks eller BroadCloud til Webex Calling når enhetsflytteverktøyet kjøres. Telefoner merket «Nei» i den kolonnen trenger en manuell intervensjon for å endre DMS-URL i Cisco BroadWorks-enhetsmalen eller i selve telefonen .

Den siste kolonnen gir kartlegging 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 begynner å kjøre overføringsverktøy. Å kjøre dette verktøyet er en engangsaktivitet etter at partner kontoen er koblet til Wholesale RTM-løsningen. Dette verktøyet lar partner administratorer logge på via nettleseren for å få den unike TOKEN som trengs for å oppdatere til partnerkonfigurasjonsfilene for migreringsverktøyene.

Forutsetninger

Installer Java 8, 11, 17 eller 21 på datamaskinen. Java er tilgjengelig fra mange kilder, inkludert:

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

Etter nedlasting, trekk ut migreringsverktøyets binære filer.

Instruksjoner for å kjøre

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

Vinduer:

token_generator.bat

MacOS:

./token_generator.sh

Utgang:

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

Åpne URL-en i nettleseren på terminalen, logg inn med partneradministratorens legitimasjon for å få TOKEN og kopier det samme for videre bruk.

Illustrasjonene til brukergrensesnittet er gitt nedenfor for referanse:

Figur 3: Logg inn med Cisco Webex

Figur 4: Legitimasjonsvindu

Figur 5: Tokengenerering

Konfigurer følgende trinn før du kjører utpaknings- og enhetsflytteverktøyene i den sekundære BroadWorks-serveren.

Aktiver OCI-P-tilkobling

Enhetsflytteverktøyet kommuniserer med BroadWorks gjennom 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 å endre til GeneralSettings-katalogen:

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 dine ikke samsvarer med ovenstående, bruker du kommandoen sett til å 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 bør 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 dine ikke samsvarer med ovenstående, bruker du kommandoen sett til å konfigurere innstillingene på nytt.

Trinn 3: Bruk CLI til å konfigurere OCI Provisioning.

Endre til klargjøringskatalogen:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Bekreft åpen klientserver 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> deploy application OpenClientServer

Trinn 2: Start serveren med denne kommandoen:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktiver nummeraktivering

Utfø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 aktiveringsaktiveringskommandoen:

AS_CLI> set dnMode groupAndUserActivationEnabled

Trinn 3: Ved bekreftelsesledeteksten skriver du inn Y.

For BroadCloud

Utdragsverktøyet er integrert i BroadCloud Service Provider-portalen. En tjenesteleverandøradministrator kan:

1. Send inn utdragsforespørsler for opptil 50 kunder per forespørsel.
   Utdragsforespø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 innsending av forespørselen.

Følgende figurer viser tjenesteleverandørportalen.

Figur 6: Tjenesteleverandørportal

Figur 7: Tjenesteleverandørportal

CSV-ekstraktforespørsel

Start CSV-uttrekks forespørsel

1. Last ned kunde-CSV

   Klikk på Last ned kunde-CSV- koblingen øverst til høyre i delen Start C SV-uttrekksforespørsel.

2. Rediger kundelisten

   Administratoren kan redigere denne CSV-filen slik at den bare inkluderer kundene som utdraget må utføres for.

3. Last opp og send inn

   Etter redigering, last opp den endrede CSV-en.

   Klikk Send for å starte en utdragsforespørsel for de oppførte kundene og deres tilknyttede lokasjoner.

Start uttrekksforespørsel for en kunde med Locations CSV

1. Velg kunde- og nedlastingssteder

   Velg en kunde fra rullegardinmenyen.

   Last ned den tilsvarende locations.csv fra Vis kunder → Nett steder fanen → Ek sporter steder som CSV.

2. Rediger lokasjonsfilen

   Administratoren kan redigere CSV-en slik at den bare inkluderer stedene de ønsker å trekke ut.

3. Last opp og send inn

   Last opp den redigerte locations.csv og klikk Send.

   Bare de angitte plasseringene for den valgte kunden vil bli inkludert i utdrag sforespørselen.

Start utdragsforespørsel for alle kunder

1. Klikk Send for å starte en utdragsforespørsel for alle kunder og alle deres lokasjoner under gjeldende tjenesteleverandør.

For Cisco BroadWorks og Webex for BroadWorks

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

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

Forutsetninger

1. SCP ekstraksjonsverktøybinærfilene til sekundær Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks Application Server for å konfigurere forutsetningene og kjøre ekstraksjonsverktøyet.
3. Konfigurer tjenesteleverandøren og gruppe-ID for å trekke ut fra Cisco BroadWorks i Conf/ExportTool.yml. Se følgende eksempel på YAML-kodebiten :

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

4. Kontroller at den sekundære Cisco BroadWorks Application Server-bruker-ID-en, passordet og vertsn avnet er riktig i filen conf/partner.cfg:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   Egenskapen REFRESH_TOKEN er obligatorisk for en Webex for BroadWorks-overføring.

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

   JAVA_HOME=/usr/local/java/java_base

Instruksjoner for å kjøre

Kjør følgende kommando i den sekundære Cisco BroadWorks Application Server fra katalogen for ekstraksjonsverktøy:

./export.sh

Terminallogger

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

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

Utgang

En utdata-ZIP-fil (ekstrakted_data_ .zip<timestamp>) er tilgjengelig i samme katalog for utpakningsverktøy. Bruk følgende kommando til å vise og bruke ZIP-filen for transformasjonsverktøyinndata:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

Hvis administratoren bruker verktøyet bak en bedriftsproxy, følger du trinnene nedenfor for å konfigurere og utføre eksportskriptet.

Fremgangsmåte for å konfigurere og utføre eksportskriptet

1. Åpne filen export.sh.
2. Finn HTTPS_PROXY_HOST-variabelen og fjern kommentaren (fjern det ledende #).

3. Angi HTTPS_PROXY_HOST-verdien som:

   HTTPS_PROXY_HOST=<proxy-host>

4. Finn HTTPS_PROXY_PORT-variabelen og fjern kommentaren (fjern det ledende #).
5. Angi HTTPS_PROXY_PORT-verdien som:

   HTTPS_PROXY_PORT=<proxy-port>

6. Lagre og lukk filen export.sh.
7. Åpne filen partner.cfg og legg til ønsket refresh token.
8. Kontroller at BroadWorks-verten, brukernavnet og passordet er riktig konfigurert i partner.cfg.
9. Kjør skriptet:

   ./export.sh

Engasjementsskjema:

Utdragsverktøyet (BroadCloud og BroadWorks) genererer nå automatisk en konsolidert XLSX-fil med tittelen Engagement Form SUA.xlsx under kjøring. Filen er forhåndsfylt med alle tilgjengelige data på tvers av relevante regneark, noe som bidrar til å effektivisere og akselerere fullføring av partnere.

Dette transformeringsverktøyet kjører for alle migreringer. Transformeringsverktøyet kjører på hvilken som helst datamaskin, inkludert en partners bærbare administrator, og bruker Webex Public API-er. Den leser utpakningsverktøyets ZIP (extracted_data_.zip<timestamp>) -fil som en inngang og transformerer rå XML til et JSON-format som brukes av klargjøringsverktøyet.

Forutsetninger

Når du har lastet ned og trukket ut binærfilene for migreringsverktøy, konfigurerer du følgende forutsetninger:

1. Sett REFRESH_TOKEN (Token kopiert fra Token Generator Tool) og NAME_OF_MAIN_LOCATION i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Angi eventuelt PROVISIONING_ID (kopiert fra malen i Partner Hub) i filen conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For å få mer fullstendig bekreftelse av kundens e-postadresse kan du eventuelt angi PROVISIONING_ID.
3. Konfigurer manglende informasjon i filen input/customers.csv (se neste avsnitt) hvis den mangler.
4. Legg til sluttbrukerens e-postadresse i filen input/users.csv.
5. Hvis nye telefoner skal klargjøres, legger du til mac-adressen og e-postadressen til bruker ens nye telefon i filen input/newphones.csv. Dette kreves bare 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 egenskapen UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS for å konvertere alle telefonsentre til CXEssentials.
8. Bruk filen input/locations.csv til å støtte migrering av store bedrifter som gjør det mulig for administratorer å migrere kundens lokasjoner etter plassering
9. Aktiver eventuelt bruk av MAC-adresser fra User-Agent-overskriften til SIP REGISTER-meldingen når MAC-adressen ikke er tilgjengelig i Cisco BroadWorks- enhetsprofilen. Fjern kommentar fra linjen USE_MAC_ADDRESS_FROM_SIP_REGISTER=Ja i filen conf/partner.cfg
10. Aktiver eventuelt egenskapene ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_ MUSIC_ON_HOLD og ANALOG_USER_TYPE_DISABLE_T38 for å konfigurere ventende anrop, musikk på vent og deaktivere T38-innstillinger for alle analoge brukere.

11. Hvis du vil konfigurere generiske gateway-enheter, legger du til enhetens MAC-adresse og bruker-ID i filen input/genericgateways.csv. Nevn også om brukeren er den PRIMÆRE eieren eller en DELT-bruker (for delte anropsopptredener). Dette er bare nødvendig hvis partneradministratorer planlegger å bruke generiske gateway-enheter i Wholesale Calling.

    Denne funksjonen er ikke tilgjengelig for overføringer fra BroadCloud til Wholesale .

12. For BroadCloud-overføringer, hvis du vil konvertere alle brukere med meldingsstasjon stypen til voice_mail_group, oppdaterer du filen conf/rialto_station_type_to_wholesale_package.csv ved å erstatte verdien for engrospak ke med voice_mail_group for raden der Rialto-stasjonstypen sender meldinger.

    Du kan eventuelt aktivere egenskapen COMMON_VOICE_MAIL_GROUP_PASSCODE i partner.cfg for å konfigurere standard PIN-kode for talemeldingsgrupper.

    Hvis denne egenskapen ikke er angitt i partner.cfg, må den oppgis per kunde i filen customers.csv under kolonnen CommonVoicEmailGroupPassCode.

13. For migrering av felles kontakter til Webex Calling

    Det er forbedringen for å administrere felles kontakter på bedrifts- og nettstedsnivå. Disse kontaktene kan nå overføres enten som organisasjonskontakter (Org Contacts) eller som virtuelle utvidelser, basert på konfigurasjonsinnstillingene. Nedenfor er detaljene for å veilede deg gjennom denne migreringsprosessen.

    Nøkkelkonfigurasjon:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      En ny egenskap, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, er introdusert i filen partner.cfg. Denne egenskapen bestemmer hvordan vanlige kontakter overføres fra Rialto tilWebex Calling.

    • Uten COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfigurert

      Vanlige kontakter overføres som organisasjonskontak ter (Org Contacts).

      Ingen ekstra konfigurasjon er nødvendig.

      Kontakter forblir tilgjengelige på organisasjons nivå.

    • Med COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfigurert

      Vanlige kontakter vil bli migrert som virtuelle utvidelser.

      Hver kontakt vil bli lagt til med et utvidelsesnummer, og star tområdet til utvidelsen er definert i egenskapen COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE i partner.cfg.

      Virtuelle utvidelser støttes både på organisasjonsnivå og lokasjonsnivå, avhengig av kontak tens omfang.

14. Aktiver standard leverandør av anropsopptak til Webex.

    Dette trinnet kreves bare når du overfører innstillinger for anropsopptak for brukere konfigurert med Dubber til Cisco Native Call Rec ording i Webex.

    Slik aktiverer du dette alternativet:

    • I filen partner.cfg angir du følgende egenskap, default _call_recording_vendor=WebEx.
    • I tillegg bruker du egenskapen WEBEX_CALL_RECORDING_STORAGE_REGION til å konfigurere lagringsområdet.

      Alternati vet On Dem and-opptak fra BroadCloud støttes ikke iWebex Calling. Disse innstillingene for samtaleopptak migreres ikke og vises i unntaksrapporten.

15. Utelukkelse av valgte telefonnumre fra migrering:

    Hvis du vil ekskludere bestemte telefonnumre fra overføringsprosessen, må følgende totrinnsprosedyre ved hjelp av transformeringsverktøyet følges:

    • Utfør først transformasjonsverktøyet for første gang. Etter fer digstillelse vil verktøyet generere en fil med navnet telephone_numbers_inventory.csv, plassert i output/timestamp/katalogen. Kunden må gjennomgå denne filen og angi «Ja» i «Drop Tn's» -kolonnen for hvert telefonnummer som skal ekskluderes fra den kommende overføringen.
    • Etter oppdatering av filen telephone_numbers_inventory.csv med de riktige ekskluderingsflaggene, utføres transformeringsverktøyet en gang til. Den oppdaterte filen skal sendes som et argument i følgende format.

      . /transform.sh -ekstrakt=inndata/ekstrahert_data_1747640608219.zip -nedleggelsesnumre = {filepath/telephone_numbers_inventory.csv}

16. Du kan også angi egenskapen ALLOW_RESTRICT_BY_PARTNER_MODE til OFF for å tillate kundeadministratorer å endre partnerdefinerte innstillinger i Control Hub.
17. For migrering av mobilnumre (BroadWorks Mobility) fra BroadCloud til Webex Calling

    Denne delen skisserer migreringen av BroadWorks Mobil ity-funksjonen (kundemobilnumre) fra BroadCloud (Mobile Network Integration) til W holesale Webex Calling (Webex Go Mobile Network Operator).

    Forutsetninger — Før du starter overføringsprosessen, må partneradministratorer kontakte Cisco-konto teamet for å utføre Cloud Connected PSTN (CCP) -leverandørkonfigurasjonen og Custom Carrier List (CCL).

    En ny egenskap, ASSIGN_MOBILE_NUMBERS_TO_USERS, legges til i filen partner.cfg. Aktiver denne egenskapen for å tillate at mobilnumre tilordnes og overføres til brukere.

    • Denne funksjonen støttes bare for overføringer fra Broadcloud til Wholesale.
    • I Wholesale Webex kan sluttbrukere ha enten et mobil nummer eller et PSTN-nummer (ikke begge deler), i motsetning til i BroadCloud.
    • Når et mobilnummer tildeles en bruker, blir deres primære PSTN-nummer deres sekundære (alternative) nummer.
    • Mobilnumre kan ikke overføres for brukere som konverteres til arbeidsområder eller virtuelle linjer.
    • Etter at et mobilnummer er tildelt i Wholesale Webex, vises det som Aktivt i Control Hub. Denne statusen betyr ikke at nummeret umiddelbart er klar til å motta anrop. Anrop skapasiteten vil bare være tilgjengelig etter at overføringen er fullført.
    • Innstillinger for mobiltelefonintegrering som er konfigurert av sluttbrukere i Calling User Portal (CUP), overføres ikke. Etter overføring, når et telefonnummer, mobilnummer eller en utvidelse ringes, ringer alle brukerens enheter.

18. Hvis du eventuelt vil konfigurere pakkemengdegrenser under kunde overføring, angir du antall for hver pakke i filen input/package_quantity.csv. Den konfigurerte pakkemengden må være større enn eller lik antall tildelte pakker for bruker/arbeidsområde.

    Begrensninger for pakkemengder støttes for øyeblikket ikke for Webex for BroadWorks til engrosoverføringer.

    Når du kjører transformasjonsverktøyet, oppgi den oppdaterte filen som en inngang sparameter:. <extract_zip_file>/transform.sh -extract= -packagelimits=input/package_quantity.csv .

19. Overfør nettsteder fra flere kunder fra Broadworks/Broadcloud til én kunde i Wholesale Webex Calling
    • En ny kjøretidsmodus, -ConsolidatedMigration, introduseres i Transformeringsverktøyet for å støtte migrering av flere kundenettsteder fra Broadcloud/Broadworks til Webex Wholesale Platform under en enkelt engroskundeorganisasjon. Når denne modusen er aktivert, konsoliderer verktøyet flere kundenettsteder i én engroskunde organisasjon

      -consolidatedMigration

    • Det er andre valgfrie argumenter som kan gis sammen med -ConsolidatedMigration, for eksempel

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • Hvis -TargetEnterpriseID er gitt og Iden finnes i utdatafilen for verktøyet for ekstraksjon, vil den bli brukt til å opprette eng roskundeorganisasjonen, og hvis Id ikke blir funnet, vil verktøyet falle tilbake for å bruke alle tilgjengelige kundedetaljer fra utdatafilen for verktøyet for ekstraksjon.
    • hvis -ConsolidateDexternalId er gitt, vil det angi eksternalID for kunden, og hvis det ikke er gitt, vil verktøyet falle tilbake til å bruke eksisterende flyt for ekstern ID.
    • <timestamp>En konsolidert JSON (customer.json) -fil vil være tilgjengelig i output//konsolidert katalog.

Fylle opp input/customers.csv

Filen input/customers.csv gir 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 kolonnene, bare den manglende informasjonen er obligatorisk.

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

Fylle opp input/users.csv

Filen input/users.csv gir 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 kolonnene, bare den manglende informasjonen er obligatorisk.

Instruksjoner for å kjøre

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

Vinduer

Utfør kommandoen nedenfor for å kjøre Transform Tool i Windows:

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

MacOS

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

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

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

2. Kjør transformerings verktøyet:

   ./transform.sh -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Forhåndskontroll av kunde/bruker

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

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

forhåndssjekk

I tillegg til å kjøre forhåndssjekk-API for kundeinformasjonen, vil Transform Tool også kjøre forhåndssjekk-API for abonnentens e-postmeldinger.

forhåndsinformasjon

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

Terminallogger

Følgende logger i terminalen på vellykket transformasjon:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Unntaksrapport

Transform Tool genererer unntaksrapporten i output/ /exception_report.txt <timestamp>katalogen. Du kan bruke denne rapporten til å identifisere problemene som vil påvirke overføringen og fikse dem i Cisco BroadWorks- systemet.

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

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

Utgang

<timestamp><groupid>En utdata JSON (customer.json) -fil vil være tilgjengelig i output// -katalogen. Eksempel kunden.json- filen er som følger:

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

Klargjøringsverktøyet kan kjøres på hvilken som helst maskin, vanligvis (partnerens administratorbærbare datamaskin) og bruker Webex offentlige API-er. Den leser transformasjonsverktøyets JSON-fil (customer.json) som en inngang og klargjøring av kunder, steder, tall, brukere, tjenester og enheter i Webex Wholesale RTM-løsningen.

Forutsetninger

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

1. Installer Java 8, 11, 17 eller 21 på datamaskinen. Java er tilgjengelig fra mange kilder, inkludert:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Når du har lastet ned og pakket ut binærfilene for migreringsverktøy, angir du miljøvariabelen JAVA_HOME i provisioning_tool.sh for MAC og provisioning_tool.bat for Windows.
3. Den partner.cfg filen:
   • Angi WHOLESALE_PROVISIONING_ID og REFRESH_TOKEN (Token kopiert fra Token Generator Tool). Partneradministratorene må kontakte kontoteamet for å få PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Sett SEND_SUBSCRIBERS_WELCOME_EMAIL til false, hvis partnere ikke vil sende en velkomst-e-post til brukerne. Standardverdien er sann.

     Webex sender velkomst-e-post bare til sluttbrukere. Kundeadministratorer mottar ikke velkomst-e-post.

     Brukere og kundeadministratorer basert på steder i USA og Canada mottar et eget e-postvarsel fra RedSky. RedSky E911- plattformen sender denne e-posten for å bekrefte opprettelsen av kunde kontoen for nødetjenester. Denne RedSky-e-posten er atskilt fra Webex velkomst-e-post og styres ikke av Webex e-postinnstillinger. For engrosorganisasjoner i USA og Canada aktiveres RedSky automatisk som nødetjenesteleverandør.

4. Bruk egenskapen WEBEX4BWKS_EMAIL_SUBJECT for Webex for BroadWorks-overføringer til å sende e-postemnet for forespørselen om endring av passord for Webex for BroadWorks-abonn enter.
5. Bruk egenskapen WEBEX4BWKS_EMAIL_BODY for Webex for BroadWorks-overføringer til å sende e-postteksten for forespørsel om endring av passord for Webex for BroadWorks-abonnenter.
6. Bruk egenskapen C USTOM_TAGS til å legge til koder etter at kunden har opprettet.
7. For å bruke engrosrabatter må partneradministratorer kontakte Cisco-konto teamet før du starter overføringen.

   En ny egenskap, APPLY_WHOLESALE_DISCOUNTS, legges til partner.cfg. Aktiver denne egenskapen for å bruke rabatter på brukere og arbeidsområder.

8. (Valgfritt) Konfigurer PSTN-tilkoblingen eksplisitt

   Hvis du vil angi PSTN-tilkoblingen for alle lokasjoner som er klargjort under overføringen, inkludert hovedplasseringen, legger du til følgende egenskap i filen partner.cfg:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Hvis egenskapen ikke er konfigurert eller kommenteres ut, bruker klargjøringsverktøyet standardprosessen for valg av PSTN-tilkobling.

Instruksjoner for å kjøre

Bruk følgende trinn for å kjøre verktøyet i Windows og macOS:

Vinduer

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

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

MacOS

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

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Forutsetninger for Webex for BroadWorks-migrering

Partner administratorer må oppdatere sin BroadWorks-onboarding-mal for Webex for Broad Works sameksistensfunksjoner. Se følgende bilde:

Når Webex for BroadWorks Onboarding-malen er oppdatert for å støtte migrering, ber du Cisco-kontoteamet om å aktivere funksjonen «engros-partner-blanding aktivert» på partnernivå. Denne innstillingen lar klar gjøringsverktøyet automatisk legge til engrospakker til eksisterende Webex for BroadWorks- kunder under klargjøring.

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.

Ettermigr eringsfase: Er den siste fasen når administratorer kan konvertere BroadWorks til engros fullstendig. Du må kjøre klargjøringsverktøyet med et argument etter migrering .

Terminallogger

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

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

En tabell vil bli skrevet ut med antall steder som er opprettet for hver kjøring:

Utgang

Klargjøringsverktøyet genererer suksessrapporter og feilrapporter i utdata/*. success/ <external_id>feilfilene. Gjennomgå suksessloggene for utdata og feil logger for å bekrefte vellykket klargjøring.

Systemet vil generere en Provisioning_Report_*.csv-fil i katalogen output/consolidated_report s/. Denne filen inneholder både suksess- og feilinformasjon for hver enhet og dens innstillinger, og gir en omfattende klargjørings rapport.

Klargjøringsverktøyet genererer også en Pro visioning_Statistics_*.csv-fil i katalogen output/consolidated_reports/. Denne rapporten inneholder antall kunder, lokasjoner, brukere, enheter og grup pefunksjoner som er klargjort og ikke lykkes.

Partneradministratorer kan verifisere 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: Kontrollhub

Figur 10: Enheter

Figur 11: Anrop

Restriksjoner etter tilveiebringelse

Når klargjøringen er fullført for en BroadCloud-overføring, blokkeres følgende handlinger:

• CAP Portal - Legge til brukere eller portede enheter.
• SP Portal - Opprette ADD-bestillinger med enheter eller tall.
• RSB API - Opprette ADD-ordrer med enheter eller tall og opprette brukere. RSB ADD-bestillinger gjort med enheter eller numre vil bli avvist.

BroadCloud til engrosmigrering - begrensning av enhetsregistrering

For partneradministratorer som overfører kunder fra BroadCloud til Wholesale i samme region, kan enheter legges til i Wholesale etter å ha kjørt klargjøringsverktøyet. Disse enhetene vil imidlertid bli kvalifisert til å registrere seg på Webex-plattformen først etter at overfør ingen (enhetsflytting) for den tilsvarende plasseringen er fullført.

Denne begrensningen gjelder ikke for:

• Kunder som migrerer fra Broadworks/W4b til engros.
• BroadCloud til engrosmigreringer på tvers av forskjellige regioner.

Anbefalt veiledning

For å unngå problemer med enhetsregistrering, fullfør overføringen av enhetsflytting på posisjonsnivå før du prøver å registrere enheter på Webex-plattformen for overføringer fra BroadCloud til engros i samme region.

For BroadCloud

For BroadCloud-partnere kan du bruke Tjenesteleverandørportalen til å sende inn en overføringsforespørsel for numre, enheter og SCA-overføringer ( Shared Call Appearances).

Innenfor tjenesteleverandørportalen kan en overførings forespørsel omfatte opptil 50 kunder. Maksimalt 10 forespørsler kan sendes inn innen en dag.

Administratorer kan aktivere automatisk tilbakestilling ved å angi rollback_to_broadcloud=true i filen conf/partner.cfg, som flytter enheter tilbake til BroadCloud etter overføring. Den støtter både migreringer i samme og forskjellige regioner med NS Sync, men bare for vellykkede migreringer. For misly kkede må administratorer heve en Cisco TAC før de ber om tilbakestilling.

Det finnes to alternativer for å velge overføringstype i portalen:

• Migrering — Velg dette alternativet for å starte en forespørsel om overføring av numre, enheter og delte anropsopptredener (SCA).
• Enhetsstatus — Velg dette alternativet for å vise gjeldende status for en enhet på BroadCloud og Calling.

Følgende figurer viser tjenesteleverandørportalen.

Figur 12: Tjenesteleverandørportal

Figur 13: Tjenesteleverandørportal

Over før valgte steder (valgfritt)

Hvis du vil starte overføringen for et bestemt delsett av lokasjoner som er oppført i customer.json- filen, må du inkludere en locations.csv fil med forespørselen. Denne CSV-filen skal bare vise stedene du har tenkt å migrere.

Hvis du vil laste ned listen over tilgjengelige aktive nettsteder, navigerer du til Vis kunder → Velg en kunde → Eksporter steder som CSV.

Figur 14: Eksporter steder som CSV

Aktiver alternativet Koble fra numre

Når du bruker samme SIP-trunk for Webex Calling og BroadCloud Carrier, bør administratorer bruke alternativet Kob le fra numre. Dette fjerner telefonnumre fra å motta innkommende anrop etter migrering i BroadCloud.

For å aktivere dette alternativet,

1. I filen partner.cfg setter du DISCONNECT_NUMBERS_FROM_RIALTO = ja.
2. Kjør migreringsverktøyet på nytt ved hjelp av den samme customer.json- filen og den oppdaterte partner.cfg.

Hvis tallene ikke kobles fra, kan du sende en Cisco TAC- forespørsel.

For Cisco BroadWorks og Webex for BroadWorks

For overføringer av Cisco BroadWorks og Webex for BroadWorks kjører verktøyet på den sekundære Cisco BroadWorks Application Server i partnernettverket og kobles til AS via OCI-P. Den bruker Transform Tool output JSON (customer.json) -fil som input og kjører OCI-P-kommandoene for å migrere enheter og myke klienter.

Ved vellykket drift vil verktøyet for flytting av enheten:

1. Avregistrer enheter fra Cisco BroadWorks og registrer dem i Wholesale.
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 tall i engros.
5. Opprett delte anropsopptredener i engros for BroadCloud-migreringer. [Dette trinnet gjelder bare for BroadCloud-overføringer].

6. Hvis administratoren bruker verktøyet bak en bedriftsproxy, følger du trinnene nedenfor for å konfigurere og utføre klargjøringsskriptet.

   Konfigurasjonsprosedyre

   1. Åpne filen devicemove.sh.
   2. Finn PROXY_HOST-variabelen og fjern kommentaren (fjern ledende # for devicemove.sh).

   3. Angi PROXY_HOST-verdien som:

      PROXY_HOST=<proxy-host>

   4. Finn PROXY_PORT-variabelen og fjern kommentaren (fjern ledende # for devicemove.sh).

   5. Angi PROXY_PORT-verdien som:

      PROXY_PORT=<proxy-port>

   6. Vennligst finn variabelen PROXY_SCHEME og fjern den (fjern ledende # for devicemove.sh). Dette trinnet er valgfritt. Hvis det forblir kommentert, vil standardverdien for PROXY_SCHEME være HTTP.

   7. Angi PROXY_SCHEME-verdien som:

      PROXY_SCHEME=<proxy-scheme>

   8. Lagre og lukk filen devicemove.sh.
   9. Åpne filen partner.cfg og legg til ønsket refresh token.
   10. Kontroller at BroadWorks-verten, brukernavnet og passordet er riktig konfigurert i partner.cfg

   11. Kjør skriptet:

       ./devicemove.sh

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 Application Server for å konfigurere forutsetningene og kjøre enhetsflytteverktøyet.

Forutsetninger

1. Sett REFRESH_TOKEN (Token kopiert fra Token Generator Tool) i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Kontroller at den sekundære Cisco BroadWorks Application Server-bruker-ID-en, passordet og vertsn avnet er riktig i filen conf/ DeviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. For å sende aktiverings-e-post på nytt, må du angi send_subscribers_welcome_email=true i filen conf/partner.cfg.

   Hvis administratorer ønsker å sende invitasjons-e-post til brukerne sine under overføringen, bør de fjerne kommentaren til egenskapen «send_subscribers_welcome_email=true» i filen conf/partner.cfg. Ellers bør 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 filen locations.csv fra inndatakatalogen til å overføre bestemte grupper i stedet for alle gruppene under en bedrift.

Polycom-telefoner

For å flytte Polycom-telefoner fra Cisco BroadWorks til Wholesale C alling, 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 eksisterer på gruppenivå. Forsikre deg også om at filmigrering_%BWMAC Address%.cfg ikke er i konflikt med noen eksisterende fil i systemet).

Den brukes internt av enhetsflytteverktøyet.

Migrasjonsprosessen for Polycom-telefoner:

1. Enhetsflytteverktøyet erstatter filen %BWMACAddress%.cfg på enhetsnivå med polycom_vvx2.cfg. Denne filen refererer til Migration_%BWMACAddress%.cfg.
2. Gjenopprett enhetsprofilene på gruppenivå eller enhetsnivå.
   Å handle på gruppenivå eller enhetsnivå avhenger av konfigurasjonen av parameteren DeviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Enhetsflytteverktøyet ber Cisco BroadWorks Application Server om å starte telefoner på nytt på grup penivå eller enhetsnivå.
4. Etter omstartforespørselen laster Polycom-telefoner ned og behandler% BWMACAddress%.cfg, som ber Polycom-telefonene laste ned og behandle Migration_%BWMACAddress%.cfg, som setter Device.prov.ServerName til https://plcm.sipflash.com.
   https://plcm.sipflash.com for den amerikanske regionen har andre regioner forskjellige nettadresser.
5. Polycom-telefonen laster ned %BWMACAddress%.cfg fra https://plcm.sipflash.com og vil bli administrert av DMS. Webex Calling

Figur 14: Identitets-/enhetsprofiltype fil legg til

Instruksjoner for å kjøre

Det er 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.

Enhetsflytteverktøyet kjøres fra den sekundære Cisco BroadWorks Application Server inne i katalogen for enhetsflytteverktøy:

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Terminallogger

Følgende er loggene i terminalen for vellykket kjøring av enhetsflytteverktøyet for enhets migrering:

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

Utgang

Etter enhetsmigreringen har enhetene kommet online og klare til å ringe/motta anrop. Se figur 15 for å se et eksempel på enhets status:

Figur 15: Enhetsstatus

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

Figur 16: Tall aktive

Hvis administratoren bruker verktøyet bak en bedriftsproxy, følger du trinnene nedenfor for å konfigurere og utføre DeviceMo ve-skriptet.

Fremgangsmåte for å konfigurere og utføre devicemove-skriptet

1. Åpne filen devicemove.sh.
2. Finn HTTPS_PROXY_HOST-variabelen og fjern kommentaren (fjern det ledende #).

3. Angi HTTPS_PROXY_HOST-verdien som:

   HTTPS_PROXY_HOST=<proxy-host>

4. Finn HTTPS_PROXY_PORT-variabelen og fjern kommentaren (fjern det ledende #).
5. Angi HTTPS_PROXY_PORT-verdien som:

   HTTPS_PROXY_PORT=<proxy-port>

6. Lagre og lukk filen devicemove.sh.
7. Åpne filen partner.cfg og legg til ønsket refresh token.
8. Kontroller at BroadWorks-verten, brukernavnet og passordet er riktig konfigurert i partner.cfg.
9. Kjør skriptet:

   ./devicemove.sh

Tilbakestillingsoperasjonen må utføres for ett foretak om gangen.

For BroadCloud Carrier

Administratorer kan angi rollback_to_broadcloud= true i conf/partner.cfg for å aktivere automatisk tilbakestilling. Dette returnerer enheter til BroadCloud etter vellykket migrering i samme eller på tvers av regioner med NS Sync. For mislykkede overføringer, kontakt Cisco TAC før du ber om tilbakestilling.

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 enhetsflytteverktøyet i tilbakestillingsmodus på den sekundære BroadWorks Application Server for å tilbakestille enhetsoverføringene. Dette vil sette DMS-URL-en tilbake til tjenesteleverandørens DMS-URL for enhetsprofiler i Cisco BroadWorks og aktivere telefonnumre på nytt.
3. Te Webex Calling amet angir DMS-URL-adressen tilbake til tjenesteleverandørens DMS-URL i enhet sprofiler 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 enhetsflytteverktøy i tilbakestillingsmodus

Følg trinnene nedenfor for å kjøre enhetsflytteverktøyet i tilbakestillingsmodus:

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks Application Server inne i enhetsoverføringsverktøykatalogen:

Tilbakestill profiler

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

Tilbakestill tall

./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 enhetsflytteverktøyet for tilbakeføring:

Tilbakestill profiler

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

Tilbakestill tall

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully