Tak for din feedback.

Understøttede telefoner oprettes automatisk og tildeles brugere Webex Calling af klargøringsværktøjet. Telefonerne markeret „ja“ i kolonnen „Understøttet i enhedsflytnings værktøjet“ flyttes også automatisk fra Cisco BroadWorks eller BroadCloud til, Webex Calling når enhedsflytningsværktøjet køres. Telefoner markeret „Nej“ i den kolonne har brug for en manuel indgriben for at ændre DMS-URL'en i Cisco BroadWorks-enhedsskabelonen eller i selve telefonen .

Den sidste kolonne indeholder kortlægningen af telefonmodeller til kolonnen „Enhedstype“ i filen transform-tool/input/newphones.csv. (Se afsnittet Transformeringsværktøj i denne artikel for at få flere oplysninger om newphones.csv).

Partneradministratorer kører dette værktøjsværktøj til tokengenerering mindst én gang, før de begynder at køre overførselsværktøjer. At køre dette værktøj er en engangsaktivitet, efter at partner kontoen er blevet indbygget i Wholesale RTM-løsningen. Dette værktøj giver partner administratorer mulighed for at logge ind via webbrowser for at få det unikke TOKEN, der er nødvendigt for at opdatere til partnerkonfigurationsfilerne for migreringsværktøjerne.

Forudsætninger

Installer Java 8, 11, 17 eller 21 på computeren. Java er tilgængelig fra mange kilder, herunder:

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

Efter download skal du udtrække migrationsværktøjets binære filer.

Instruktioner til at køre

Kør følgende kommando i terminalen inde i tokengeneratormappen:

Vinduer:

token_generator.bat

MacOS:

./token_generator.sh

Udgang:

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

Åbn URL'en i webbrowseren på terminalen, log ind med partneradministratorens legitimationsoplysninger for at få TOKEN og kopier det samme til videre brug.

Illustrationerne til brugergrænsefladen er angivet nedenfor til reference:

Figur 3: Log ind med Cisco Webex

Figur 4: Vinduet med legitimationsoplysninger

Figur 5: Generering af token

Konfigurer følgende trin, før du kører værktøjerne til udtræk og flytning af enheder på den sekundære BroadWorks-server.

Aktivér OCI-P-forbindelse

Enhedsflytningsværktøjet kommunikerer med BroadWorks via OCI-P-kommandoer, for at aktivere OCI-P-forbindelse skal du bruge nedenstående trin:

Trin 1: Brug CLI til at konfigurere generelle indstillinger.

Kør følgende kommando i CLI for at skifte til GeneralSettings-biblioteket:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Kør følgende kommando i CLI for at få de aktuelle GeneralSettings:

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

Hvis dine indstillinger ikke stemmer overens med ovenstående, skal du bruge kommandoen set til at konfigurere dine indstillinger igen.

Trin 2: Brug CLI til at konfigurere OCI Proxy.

Skift mappen til OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Kør følgende CLI for at få aktuelle indstillinger. Du skal se følgende:

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

Hvis dine indstillinger ikke stemmer overens med ovenstående, skal du bruge kommandoen set til at konfigurere dine indstillinger igen.

Trin 3: Brug CLI til at konfigurere OCI Provisioning.

Skift til klargøringsmappen:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kør følgende kommando for at hente de aktuelle OCI Provisioning-indstillinger:

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

Trin 4: Kør kommandoen nedenfor i CLI for at kontrollere, at din konfiguration er korrekt.

 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.

Bekræft, at åben klientserver er installeret og aktiv

Brug nedenstående kommandoer til at installere og starte Open Client Server på den sekundære applikationsserver, hvis den ikke er implementeret eller ikke allerede er startet.

Trin 1: Implementer serveren med følgende CLI-kommando:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Trin 2: Start serveren med denne kommando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktivér nummeraktivering

Udfør følgende kommandoer i CLI for at aktivere aktiveringen af numrene:

Trin 1: Kør nummeraktiveringskommandoen:

AS_CLI> cd SubscriberMgmt/NumberActivation

Trin 2: Kør aktiveringsaktiveret kommando:

AS_CLI> set dnMode groupAndUserActivationEnabled

Trin 3: Skriv Y på bekræftelsesprompten.

Til BroadCloud

Uddragsværktøjet er integreret i BroadCloud Service Provider-portalen. En administrator af tjenesteudbyderen kan:

1. Indsend anmodninger om ekstrakt for op til 50 kunder pr. anmodning.
   Uddragsanmodning kan ikke indsendes for den samme kunde mere end 10 gange på en dag.
2. Download den udpakkede datafil, i ZIP-format, i op til 28 dage fra datoen for indsendelse af anmodningen.

Følgende figurer viser tjenesteudbyderportalen.

Figur 6: Tjenesteudbyderportal

Figur 7: Tjenesteudbyderportal

Anmodning om CSV-ekstrakt

Start anmodning om CSV-ekstrakt

1. Download Customer CSV

   Klik på linket Download kunde-CSV øverst til højre i afsnittet Start anmodning om CSV-udtræk.

2. Rediger kundelisten

   Administratoren kan redigere denne CSV-fil, så den kun omfatter de kunder, som ud draget skal udføres for.

3. Upload og indsend

   Upload den ændrede CSV efter redigering.

   Klik på Send for at starte en anmodning om uddrag for de angivne kunder og deres tilknyttede lokationer.

Start udtrækningsanmodning for en kunde med placerings-CSV

1. Vælg kunde- og downloadlokationer

   Vælg en kunde fra rullemenuen.

   Download den tilsvarende locations.csv fra fanen Vis kunder → Websteder → Eksporter placeringer som CSV.

2. Rediger placeringsfilen

   Administratoren kan redigere CSV'en, så den kun omfatter de placeringer, de ønsker at udtrække.

3. Upload og indsend

   Upload den redigerede locations.csv, og klik på Send.

   Kun de angivne placeringer for den valgte kunde vil blive inkluderet i anmodningen om ud drag.

Start uddragsanmodning for alle kunder

1. Klik på Send for at starte en anmodning om uddrag for alle kunder og alle deres lokationer under den aktuelle tjenesteudbyder.

Til Cisco BroadWorks og Webex til BroadWorks

1. Udtrækningsværktøjet kører på den sekundære Cisco BroadWorks Application Server i partnernetværket og opretter forbindelse via OCI-P.
2. Værktøjet henter rå virksomheds-, gruppe-, tal-, brugere, tjenester, enheder og bløde klienters data fra Cisco BroadWorks- eller BroadCloud-platformen og udsender disse data til XML-filer, der leverer input til transformeringsværktøjet.

De næste afsnit forklarer, hvordan du installerer og konfigurerer ekstraktionsværktøjet.

Forudsætninger

1. SCP ekstraktionsværktøjsbinærfiler til sekundær Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks Application Server for at konfigurere forudsætningerne og køre ekstraktionsværktøjet.
3. Konfigurer tjenesteudbyderen og gruppe-id'et til at udtrække fra Cisco BroadWorks i Conf/ExportTool.yml. Se følgende eksempel på YAML-ud drag:

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

4. Sørg for, at det sekundære Cisco BroadWorks Application Server-bruger-id, adgangskode og værtsn avn er korrekte 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.
   

   Egenskaben REFRESH_TOKEN er obligatorisk for en Webex til BroadWorks-overførsel.

5. Rediger JDK/JRE-miljøstien i filen export.sh, hvis den sekundære Cisco BroadWorks Application Server JDK/JRE miljøsti er anderledes end filen:

   JAVA_HOME=/usr/local/java/java_base

Instruktioner til at køre

Kør følgende kommando i den sekundære Cisco BroadWorks Application Server fra ekstraktværktøjsmappen:

./export.sh

Terminallogfiler

Følgende logfiler er tilgængelige i terminalen ved vellykket eksport: Kø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
**************************************************

Udgang

En output ZIP (extracted_data_ .zip<timestamp>) -fil er tilgængelig i den samme mappe med ekstraktionsværktøjer. Brug følgende kommando til at få vist og bruge ZIP-filen til input til transformationsværktøjet:

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 betjener værktøjet bag en virksomhedsproxy, skal du følge nedenstående trin for at konfigurere og udføre eksportscriptet.

Trin til at konfigurere og udføre eksportscriptet

1. Åbn filen export.sh.
2. Find variablen HTTPS_PROXY_HOST og fjern den (fjern det førende #).

3. Indstil værdien HTTPS_PROXY_HOST som:

   HTTPS_PROXY_HOST=<proxy-host>

4. Find variablen HTTPS_PROXY_PORT og fjern den (fjern det førende #).
5. Indstil værdien HTTPS_PROXY_PORT som:

   HTTPS_PROXY_PORT=<proxy-port>

6. Gem og luk filen export.sh.
7. Åbn filen partner.cfg og tilføj den krævede refresh token.
8. Kontroller, at BroadWorks-værten, brugernavnet og adgangskoden er korrekt konfigureret i partner.cfg.
9. Kør scriptet:

   ./export.sh

Forlovelsesformular:

Udtræksværktøjet (BroadCloud og BroadWorks) genererer nu automatisk en konsolideret XLSX-fil med titlen Engagement Form SUA.xlsx under udførelse. Filen er forudfyldt med alle tilgængelige data på tværs af relevante regneark, hvilket hjælper med at strømline og fremskynde partnerfærdiggørelsen.

Dette transformeringsværktøj kører for alle migreringer. Transformeringsværktøjet kører på enhver computer, herunder en partners administratorbærbare computer, og bruger Webex Public API'er. Den læser ekstraktionsværktøjets output ZIP (extracted_data_ .zip<timestamp>) fil som et input og omdanner den rå XML til et JSON-format, der bruges af klargøringsværktøjet.

Forudsætninger

Når du har downloadet og udtrukket binærfilerne til migrationsværktøjer, skal du konfigurere følgende forudsætninger:

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Indstil eventuelt PROVISIONING_ID (kopieret fra skabelonen i Partner Hub) i filen conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For at få en mere komplet bekræftelse af kundens e-mail-adresse kan du valgfrit indstille PROVISIONING_ID.
3. Konfigurer manglende oplysninger i filen input/customers.csv (se næste afsnit), hvis de mangler.
4. Tilføj slutbrugerens e-mail-adresse i filen input/users.csv.
5. Hvis nye telefoner skal klarlægges, skal du tilføje mac-adressen og e-mail-adressen på bruger ens nye telefon til filen input/newphones.csv. Dette er kun påkrævet, hvis partneradministratorerne ønsker at oprette nye telefoner i engrosopkald.
6. Konverter BroadWorks Call Centers til CXEssentials ved hjælp af filen input/cxessentials.csv.
7. Du kan eventuelt aktivere egenskaben UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS for at konvertere alle callcentre til CXEssentials.
8. Brug filen input/locations.csv til at understøtte migrering af store virksomheder, der gør det muligt for administratorer at migrere deres kunders placeringer efter placering
9. Du kan eventuelt aktivere brugen af MAC-adresser fra User-Agent header i SIP REG ISTER-meddelelsen, når MAC-adressen ikke er tilgængelig i Cisco BroadWorks- enhedsprofilen. Fjern kommentar til linjen USE_MAC_ADDRESS_FROM_SIP_REGISTER=Ja i fil conf/partner.cfg
10. Du kan eventuelt aktivere egenskaberne ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_ MUSIC_ON_HOLD og ANALOG_USER_TYPE_DISABLE_T38 for at konfigurere ventende opkald, musik på vent og deaktivere T38-indstillinger for alle analoge brugere.

11. Hvis du vil konfigurere generiske gateway-enheder, skal du tilføje enhedens MAC-adresse og bruger-id til filen input/genericgateways.csv. Angiv også, om brugeren er den PRIMÆRE ejer eller en DELT bruger (for delte opkaldsoptrædener). Dette er kun nødvendigt, hvis partneradministratorer planlægger at bruge generiske gateway-enheder i Wholesale Calling.

    Denne funktion er ikke tilgængelig for overførsler fra BroadCloud til Wholesale .

12. Hvis du vil konvertere alle brugere med meddelelsesstationstypen til voice_mail_group til BroadCloud-overførsler, skal du opdatere filen conf/rialto_station_type_to_wholesale_package.csv ved at erstatte værdien Wholesale Package med voice_mail_group for den række, hvor Rialto-stationstypen sender beskeder.

    Du kan eventuelt aktivere egenskaben COMMON_VOICE_MAIL_GROUP_PASSCODE i partner.cfg for at konfigurere standard-PIN-koden for talebeskedgrupper.

    Hvis denne egenskab ikke er angivet i partner.cfg, skal den angives pr. kunde i filen customers.csv under kolonnen CommonVoicEmailGroupPassCode.

13. For overførsel af fælles kontakter til Webex Calling

    Det er forbedringen til styring af fælles kontakter på virksomheds- og webstedsniveau. Disse kontakter kan nu overføres enten som organisationskontakter (Org kontakter) eller som virtuelle udvidelser baseret på konfigurationsindstillingerne. Nedenfor er detaljerne til at guide dig gennem denne migreringsproces.

    Nøglekonfiguration:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      En ny egenskab, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, introduceres i filen partner.cfg. Denne egenskab bestemmer, hvordan almindelige kontakter overføres fra Rialto tilWebex Calling.

    • Uden COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfigureret

      Almindelige kontakter overføres som organisationskon takter (Orgkontakter).

      Ingen yderligere konfiguration er påkrævet.

      Kontakter forbliver tilgængelige på organisations niveau.

    • Med COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfigureret

      Almindelige kontakter overføres som virtuelle udvidelser.

      Hver kontakt vil blive tilføjet med et udvidelsesnummer, og startom rådet for udvidelsen er defineret i egenskaben COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE i partner.cfg.

      Virtuelle udvidelser understøttes på både organisationsniveau og placeringsniveau afhængigt af kontak tens omfang.

14. Aktivér standardoptagelsesleverandør til Webex.

    Dette trin er kun påkrævet, når du migrerer indstillinger for opkaldsoptagelse for brugere, der er konfigureret med Dubber til Cisco Native Call Rec ording i Webex.

    Sådan aktiverer du denne indstilling:

    • I filen partner.cfg skal du indstille følgende egenskab, default _call_recording_vendor=WebEx.
    • Brug desuden egenskaben WEBEX_CALL_RECORDING_STORAGE_REGION til at konfigurere lagerområdet.

      Indstill ingen On Dem and-optagelse fra BroadCloud understøttes ikke iWebex Calling. Disse indstillinger for opkaldsoptagelse migreres ikke og vises i undtagelsesrapporten.

15. Udelukkelse af udvalgte telefonnumre fra migrering:

    Hvis du vil udelukke bestemte telefonnumre fra overførselsprocessen, skal følgende totrinsprocedure ved hjælp af transformationsværktøjet følges:

    • Udfør oprindeligt transformationsværktøjet for første gang. Efter fær diggørelsen genererer værktøjet en fil med navnet telephone_numbers_inventory.csv, der er placeret i output/timestamp/mappen. Kunden skal gennemgå denne fil og angive „Ja“ i kolonnen „Drop Tn's“ for hvert telefonnummer, der skal udelukkes fra den kommende overførsel.
    • Efter opdatering af filen telephone_numbers_inventory.csv med de relevante udelukkelsesflag udføres transformeringsværktøjet en anden gang. Den opdaterede fil skal sendes som et argument i følgende format.

      . /transform.sh -extract=input/ekstraheret_data_1747640608219.zip -nedlæggelsesnumre = {filepath/telephone_numbers_inventory.csv}

16. Du kan også angive egenskaben ALLOW_RESTRICT_BY_PARTNER_MODE til OFF for at give kundeadministratorer mulighed for at ændre partnerdefinerede indstillinger i Control Hub.
17. Til migrering af mobilnumre (BroadWorks Mobility) fra BroadCloud til Webex Calling

    Dette afsnit beskriver migreringen af funktionen BroadWorks Mobility (kundemobilnumre) fra BroadCloud (Mobile Network Integration) til engros Webex Calling (Webex Go Mobile Network Operator).

    Forudsætninger - Inden migreringsprocessen påbegyndes, skal partneradministratorer kontakte Cisco-konto teamet for at udføre konfigurationen af Cloud Connected PSTN (CCP) leverandør og Custom Carrier List (CCL).

    En ny egenskab, ASSIGN_MOBILE_NUMBERS_TO_USERS, føjes til filen partner.cfg. Aktivér denne egenskab for at tillade, at mobilnumre til deles og overføres til brugere.

    • Denne funktion understøttes kun til overførsler fra Broadcloud til engros.
    • I Wholesale Webex kan slutbrugere enten have et mobil nummer eller et PSTN-nummer (ikke begge dele), i modsætning til i BroadCloud.
    • Når et mobilnummer tildeles en bruger, bliver deres primære PSTN-nummer deres sekundære (alternative) nummer.
    • Mobilnumre kan ikke overføres til brugere, der konverteres til arbejdsområder eller virtuelle linjer.
    • Når et mobilnummer er tildelt i Wholesale Webex, vises det som Aktivt i Control Hub. Denne status betyder ikke, at nummeret straks er klar til at modtage opkald. Opkal dsfunktionen vil kun være tilgængelig, når overførslen er fuldført.
    • Indstillinger for mobiltelefonintegration, der er konfigureret af slutbrugere i Calling User Portal (CUP), overføres ikke. Efter migrering ringer alle brugerens enheder, når der ring es til et telefonnummer, mobilnummer eller en udvidelse.

18. Hvis du eventuelt vil konfigurere pakkemængdegrænser under kunde overførsel, skal du angive mængden for hver pakke i filen input/package_quantity.csv. Den konfigurerede pakkemængde skal være større end eller lig med antallet af tildelte pakker til bruger/arbejdsområde.

    Pakkemængdebegrænsninger understøttes i øjeblikket ikke for Webex for BroadWorks til engrosoverførsler.

    Når du kører transformationsværktøjet, angiv den opdaterede fil som en input parameter:. <extract_zip_file>/transform.sh -extract= -packagelimits=input/pakke_mængde.csv .

19. Overfør websteder fra flere kunder fra Broadworks/Broadcloud til en enkelt kunde i engrossalg Webex Calling
    • En ny runtime-tilstand, -ConsolidatedMigration, introduceres i værktøjet Transform for at understøtte migrering af flere kundewebsteder fra Broadcloud/Broadworks til Webex Wholesale Platform under en enkelt engroskundeorganisation. Når denne tilstand er aktiveret, konsoliderer værktøjet flere kundewebsteder i én engroskunde organisation

      -consolidatedMigration

    • Der er andre valgfrie argumenter, der kan gives sammen med -ConsolidatedMigration såsom

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

    • Hvis -TargetEnterpriseID er angivet, og id'et findes i outputfilen til værktøjet Udtræk, vil det blive brugt til at oprette eng roskundeorganisationen, og hvis id ikke findes, vil værktøjet vende tilbage til at bruge alle tilgængelige kundeoplysninger fra outputfilen til værktøjet Udtræk.
    • hvis -ConsolidateDexternalId gives, vil det indstille ExternalId for kunden, og hvis det ikke er angivet, vil værktøjet falde tilbage til at bruge eksisterende flow til eksternt Id.
    • <timestamp>En konsolideret JSON (customer.json) fil vil være tilgængelig i output//konsolideret mappe.

Udfyldning af input/customers.csv

Filen input/customers.csv indeholder data, der måske mangler i Cisco BroadWorks eller BroadCloud. Denne fil kan stå tom, hvis alle obligatoriske oplysninger allerede er tilgængelige. Du behøver ikke udfylde alle kolonner, kun de manglende oplysninger er obligatoriske.

Tabellen nedenfor forklarer de vigtigste kolonner i input/customers.csv.

Udfyldning af input/users.csv

Filen input/users.csv indeholder data, der måske mangler i Cisco BroadWorks eller BroadCloud. Denne fil kan stå tom, hvis alle obligatoriske oplysninger allerede er tilgængelige. Du behøver ikke udfylde alle kolonner, kun de manglende oplysninger er obligatoriske.

Instruktioner til at køre

Kør transformationsværktøjet i ethvert operativsystem. Brug nedenstående trin til at køre værktøjet i Windows og macOS:

Vinduer

Udfør kommandoen nedenfor for at kø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

Udfør følgende trin for at køre transformationsværktøjet på macOS:

1. Opret et virtuelt miljø og installer afhængigheder for at køre transformationsværktøjet ved hjælp af 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. Kør transformations værktøjet:

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

Forhåndskontrol af kunde/bruger

Transformeringsværktøjet foretager API-opkald til Webex for at fange potentielle klargøringsproblemer. Som standard validerer det kundens adresse og primære e-mail. Hvis værdien PROVISIONING_ID er angivet i filen conf/partner.cfg, vil den også validere placeringsoplysninger. Resultaterne af forhåndskontrollen er inkluderet i undtagelsesrapporten.

Derudover kan følgende valgfrie parametre tilføjes, når du kører transformerings værktøjet:

forhåndskontrol

Ud over at køre forhåndskontrol-API'en for kundeoplysningerne kører Transformeringsværktøjet også forhånd skontroll-API'en for abonnentens e-mails.

forcheckinfo

Som standard medtages kun fejl i forhåndskontrollen (dvs. problemer, der blokerer klargøring) i undtagelsesrapporten. Tilføjelse af dette flag inkluderer også vellykkede præcheckresultater (f.eks. hvis der allerede findes en Webex-organisation, der automatisk kan vedhæftes).

Terminallogfiler

Følgende logfiler i terminalen ved vellykket transformation:

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

Undtagelsesrapport

Transform Tool genererer undtagelsesrapporten i mappen output/ /exception_report.txt<timestamp>. Du kan bruge denne rapport til at identificere de problemer, der vil påvirke migreringen, og løse dem i Cisco BroadWorks- systemet.

Når du har ændret brugerdataene for at løse undtagelsen, skal du køre værktøjerne til udtræk og transform ering igen med de nye data. Eksempelundtagelsesrapportfilen 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

Udgang

<timestamp><groupid>En output JSON (customer.json) -fil vil være tilgængelig i output// -mappen. Eksempelfilen customer.json 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"
    }
}

Klargøringsværktøjet kan køre på enhver computer, normalt (partnerens administratorbærbare computer) og bruger Webex Public API'er. Den læser transformationsværktøjets output JSON (customer.json) fil som input og klargøring af kunder, placeringer, numre, brugere, tjenester og enheder i Webex Wholesale RTM-løsningen.

Forudsætninger

Konfigurer følgende forudsætninger i klargøringsværktøjsmappen:

1. Installer Java 8, 11, 17 eller 21 på computeren. Java er tilgængelig fra mange kilder, herunder:
   • 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 downloadet og udpakket de binære filer til migreringsværktøjer, skal du angive miljøvariablen JAVA_HOME i provisioning_tool.sh til MAC og provisioning_tool.bat til Windows.
3. Den partner.cfg fil:
   • Indstil WHOLESALE_PROVISIONING_ID og REFRESH_TOKEN (Token kopieret fra Token Generator Tool). Partneradministratorerne skal kontakte deres kontoteam for at få PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Indstil SEND_SUBSCRIBERS_WELCOME_EMAIL til false, hvis partnere ikke ønsker at sende en velkomstmail til brugerne. Standardværdien er sand.

     Webex sender kun velkomstmails til slutbrugere. Kundeadministratorer modtager ikke velkomstmails.

     Brugere og kundeadministratorer med base i USA og Canada modtager en separat e-mail-meddelelse fra RedSky. RedSky E911-plat formen sender denne e-mail for at bekræfte oprettelsen af kunde kontoen til nødtjenester. Denne RedSky-e-mail er adskilt fra Webex-velkomstmails og styres ikke af Webex-e-mail-indstillinger. For engrosorganisationer i USA og Canada aktiveres RedSky automatisk som nødtjenesteudbyder.

4. Brug egenskaben WEBEX4BWKS_EMAIL_SUBJECT for Webex til BroadWorks-migreringer til at sende e-mail-emnet for anmodning om ændring af adgangskode for Webex for BroadWorks-abonn enter.
5. Brug egenskaben WEBEX4BWKS_EMAIL_BODY til Webex til BroadWorks-migreringer til at sende e-mail-brødteksten til anmodning om ændring af adgangskode til Webex for BroadWorks-abonnenter .
6. Brug egenskaben CUSTOM_TAG S til at tilføje tags efter kundeoprettelse.
7. For at anvende engrosrabatter skal partneradministratorer kontakte Cisco-konto teamet, før du starter overførslen.

   En ny egenskab, APPLY_WHOLESALE_DISCOUNTS føjes til partner.cfg. Aktivér denne egenskab for at anvende rabatter på brugere og arbejdsområder.

8. (Valgfrit) Konfigurer PSTN-forbindelsen eksplicit

   Hvis du vil angive PSTN-forbindelsen for alle placeringer, der er klargjort under overførslen, herunder hovedplaceringen, skal du tilføje følgende egenskab til filen partner.cfg:

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

   Hvis egenskaben ikke er konfigureret eller er kommenteret ud, bruger klargøringsværktøjet standardprocessen til valg af PSTN-forbindelse.

Instruktioner til at køre

Brug følgende trin til at køre værktøjet i Windows og macOS:

Vinduer

Udfør følgende trin for at køre værktøjet 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

Udfør følgende trin for at køre værktøjet 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>

Forudsætninger for Webex til BroadWorks-migrering

Partner administratorer skal opdatere deres BroadWorks-onboarding-skabelon til Webex for Broad Works-sameksistensfunktioner. Se følgende billede:

Når Webex for BroadWorks Onboarding-skabelonen er opdateret for at under støtte migrering, skal du bede Cisco-kontoteamet om at aktivere funktionen „Engros-partner-blanding aktiveret“ på partnerniveau. Denne indstilling gør det muligt for klargøringsværktøjet automatisk at tilføje engrospakker til eksisterende Webex for BroadWorks- kunder under klargøring.

Kør kørselsværktøjet med et ekstra argument.

Forberedelsesfase: er standardfasen, hvor administratorer kan klargøre BroadWorks-brugerne som engrosabonnent og fortsætte med Webex for BroadWorks-brugere.

Vedligeholdelsesfase: er den anden fase, hvor administratorer kan tildele engroslicensen til de eksisterende Webex for BroadWorks-brugere. Du skal køre klargøringsværktøjet med et argument vedligeholdelse.

Postmigrerings fase: Er den sidste fase, hvor administratorer kan konvertere BroadWorks til engros fuldstændigt. Du skal køre klargøringsværktøjet med et argument post migration.

Terminallogfiler

Følgende er logfilerne i terminalen ved vellykket k largø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 ****************

Der udskrives en tabel med antallet af placeringer, der er oprettet for hvert løb:

Udgang

Tilvejebringelsesværktøjet genererer succes- og fejlrapporter inde i output//*.success/ <external_id>fejlfilerne. Gennemgå outputsucces- og fejl logfiler for at kontrollere, at klargøring er vellykket.

Systemet genererer en provisioning_report_*.csv-fil i mappen output/consolidated_report s/. Denne fil indeholder både succesoplysninger og fiaskoplysninger for hvert objekt og dets indstillinger, hvilket giver en omfattende klargørings rapport.

Klargøringsværktøjet genererer også en provisioning_statistics_*.csv-fil i mappen output/consolidated_reports/. Denne rapport indeholder antallet af kunder, placeringer, brugere, enheder og grup pefunktioner, der er klargjort med succes og uden held.

Partneradministratorer kan verificere kundetilvejebringelsen i portalen Partner Hub og Control Hub. Se følgende illustrationer fra Partner Hub og Control Hub- portalen:

Figur 8: Partner Hub

Figur 9: Kontrolhub

Figur 10: Enheder

Figur 11: Opkald

Restriktioner efter tilvejebringelse

Når klargøringen er fuldført for en BroadCloud-overførsel, blokeres følgende handlinger:

• CAP Portal - Tilføjelse af brugere eller porterede enheder.
• SP Portal - Oprettelse af ADD-ordrer med enheder eller numre.
• RSB API - Oprettelse af ADD-ordrer med enheder eller numre og oprettelse af brugere. RSB ADD-ordrer foretaget med enheder eller numre afvises.

BroadCloud til engrosmigrering - begrænsning af enhedsregistrering

For partneradministratorer, der migrerer kunder fra BroadCloud til Wholesale inden for samme region, kan enheder tilføjes i Wholesale, når kørselsværktøjet er kørt. Disse enheder bliver dog kun kvalificerede til at registrere sig på Webex-platformen, når overfør slen (enhedsflytningen) for den tilsvarende placering er afsluttet.

Denne begrænsning gælder ikke for:

• Kunder, der migrerer fra Broadworks/W4b til engros.
• BroadCloud til engrosmigrationer på tværs af forskellige regioner.

Anbefalet vejledning

For at undgå problemer med enhedsregistrering skal du fuldføre overførslen af enhedsflytning på placeringsniveau, før du forsøger at registrere enheder på Webex-platformen til overførsler fra BroadCloud til engros i samme region.

Til BroadCloud

For BroadCloud-partnere skal du bruge tjen esteudbyderportalen til at indsende en overførselsanmodning for numre, enheder og SCA-overførsler ( Shared Call Appearances).

Inden for tjenesteudbyderportalen kan en overfør selsanmodning omfatte op til 50 kunder. Maksimalt 10 anmodninger kan indsendes inden for en dag.

Administratorer kan aktivere automatisk tilbagekaldelse ved at indstille rollback_to_broadcloud=true i filen conf/partner.cfg, som flytter enheder tilbage til BroadCloud efter migrering. Det understøtter både migreringer i samme og forskellige regioner med NS Sync, men kun til vellykkede migreringer. For mislykkede skal administratorer hæve en, Cisco TAC før de anmoder om tilbagek aldelse.

Der er to muligheder for at vælge overførselstype i portalen:

• Overførsel — Vælg denne indstilling for at starte en anmodning om overførsel af numre, enheder og delte opkaldsoptrædener (SCA).
• Enhedsstatus — Vælg denne indstilling for at se den aktuelle status for en enhed på BroadCloud og opkald.

Følgende figurer viser tjenesteudbyderportalen.

Figur 12: Tjenesteudbyderportal

Figur 13: Tjenesteudbyderportal

Overfør valgte placeringer (valgfrit)

Hvis du vil starte overførslen for en bestemt undergruppe af placeringer, der er angivet i customer.json-filen, skal du medtage en locations.csv fil med din anmodning. Denne CSV skal kun angive de placeringer, du har til hensigt at migrere.

Hvis du vil downloade listen over tilgængelige aktive websteder, skal du gå til Vis kunder → Vælg en kunde → Eksporter placeringer som CSV.

Figur 14: Eksporter placeringer som CSV

Aktivér indstillingen Afbryd numre

Når du bruger den samme SIP-trunk til Webex Calling og BroadCloud Carrier, skal administratorer bruge indstillingen Af bryd numre. Dette fjerner telefonnumre fra at modtage indgående opkald efter migrering i BroadCloud.

For at aktivere denne indstilling,

1. I filen partner.cfg skal du indstille DISCONNECT_NUMBERS_FROM_RIALTO = ja.
2. Kør overførselsværktøjet igen ved hjælp af den samme customer.json- fil og den opdaterede partner.cfg.

Hvis numre ikke afbrydes, skal du oprette en Cisco TAC- anmodning.

Til Cisco BroadWorks og Webex til BroadWorks

For Cisco BroadWorks- og Webex til BroadWorks-migreringer kører værktøjet på den sekundære Cisco BroadWorks Application Server i partnernetværket og opretter forbindelse til AS via OCI-P. Den bruger Transform Tool output JSON (customer.json) fil som input og kører OCI-P-kommandoerne til at migrere enheder og bløde klienter.

Ved vellykket drift vil enhedens flytteværktøj:

1. Afregistrer enheder fra Cisco BroadWorks, og registrer dem i engros.
2. Brugere, der bruger UC-One-klienten, vil omdirigere til Webex-appen ved første gangs login.
3. Deaktiver telefonnumrene fra Cisco BroadWorks, eller fjern telefonnumrene fra BroadCloud.
4. Aktivér numre i engros.
5. Opret delte opkaldsoptrædener i engros til BroadCloud-migreringer. [Dette trin gælder kun for BroadCloud-migreringer].

6. Hvis administratoren betjener værktøjet bag en virksomhedsproxy, skal du følge nedenstående trin for at konfigurere og udføre klargøringsscriptet.

   Konfigurationsprocedure

   1. Åbn filen devicemove.sh.
   2. Find variablen PROXY_HOST og fjern kommentaren (fjern det førende # for devicemove.sh).

   3. Indstil PROXY_HOST-værdien som:

      PROXY_HOST=<proxy-host>

   4. Find variablen PROXY_PORT og fjern kommentaren (fjern det førende # for devicemove.sh).

   5. Indstil PROXY_PORT-værdien som:

      PROXY_PORT=<proxy-port>

   6. Find variablen PROXY_SCHEME og fjern kommentaren (fjern det førende # for devicemove.sh). Dette trin er valgfrit. Hvis det forbliver kommenteret, vil standardværdien for PROXY_SCHEME være HTTP.

   7. Indstil PROXY_SCHEME-værdien som:

      PROXY_SCHEME=<proxy-scheme>

   8. Gem og luk filen devicemove.sh.
   9. Åbn filen partner.cfg og tilføj den krævede refresh token.
   10. Kontroller, at BroadWorks-værten, brugernavnet og adgangskoden er korrekt konfigureret i partner.cfg

   11. Kør scriptet:

       ./devicemove.sh

SCP og SSH

1. SCP enhedens flytteværktøj til den sekundære Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks Application Server for at konfigurere forudsætningerne og køre enhedsflytningsværktøjet.

Forudsætninger

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Sørg for, at det sekundære Cisco BroadWorks Application Server-bruger-id, adgangskode og værtsn avn er korrekte i filen conf/ DeviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Hvis du vil sende aktiverings-e-mails igen, skal du indstille send_subscribers_welcome_email=true i filen conf/partner.cfg.

   Hvis administratorer ønsker at sende invitations-e-mails til deres brugere under overførslen, skal de fjerne kommentaren til egenskaben „send_subscribers_welcome_email=true“ i filen conf/partner.cfg. Ellers skal ejendommen forblive uændret.

4. Kontroller, at JDK/JRE-miljøstien er korrekt i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratorer kan bruge filen locations.csv fra inputmappen til at overføre de specifikke grupper i stedet for alle grupper under en virksomhed.

Polycom-telefoner

For at flytte Polycom-telefoner fra Cisco BroadWorks til Wholesale C alling skal en partneradministrator oprette en ny identitets-/enhedsprofiltypefil på systemniveau i Cisco BroadWorks hver Polycom-enhedsskabelon. Se figur 14, og upload den brugerdefinerede fil Device-move-tool/conf/DeviceProfile/ {region} /polycom_vvx.cfg. Når du har uploadet den nye enhedsfil, skal du sikre dig, at den nyoprettede fil findes på gruppeniveau. Sørg også for, at filmigration_%BWMAC Address%.cfg ikke er i konflikt med nogen eksisterende fil i dit system).

Det bruges internt af enhedens flytningsværktøj.

Migreringsprocessen for Polycom-telefoner:

1. Værktøjet til flytning af enhed erstatter filen %BWMACAddress%.cfg på enhedsniveau med polycom_vvx2.cfg. Denne fil henviser til Migration_%BWMACAddress%.cfg.
2. Genopbyg enhedsprofilerne på gruppe- eller enhedsniveau.
   Handling på gruppe- eller enhedsniveau afhænger af konfigurationen af parameteren DeviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Enhedsflytningsværktøjet beder Cisco BroadWorks Application Server om at genstarte telefoner på grup peniveau eller enhedsniveau.
4. Efter genstartsanmodningen downloader og behandler Polycom-telefoner% BWMACAddress%.cfg, som beder Polycom-telefonerne om at downloade og behandle Migration_%BWMACAddress%.cfg, som indstiller Device.prov.ServerName til https://plcm.sipflash.com.
   https://plcm.sipflash.com for den amerikanske region har andre regioner forskellige webadresser.
5. Polycom-telefonen downloader %BWMACAddress%.cfg fra https://plcm.sipflash.com og administreres af DMS. Webex Calling

Figur 14: Tilføj fil til identitet/enhedsprofiltype

Instruktioner til at køre

Der er to metoder til at påkalde DMT, den første er at påkalde gennem en enkelt kunde ad gangen, og den anden er at køre gennem flere kunder samtidigt.

Enhedsflytningsværktøjet køres fra den sekundære Cisco BroadWorks Application Server inde i enhedsflytningsværktøjsmappen :

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

Terminallogfiler

Følgende er logfilerne i terminalen for vellykket kørsel af enhedsflytningsværktøjet til enhedsover førsel:

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

Udgang

Efter enhedsoverførslen er enhederne kommet online og klar til at foretage/modtage opkald. Se figur 15 for at se et eksempel på enhedens status:

Figur 15: Enhedsstatus

Efter enhedens migrering er tallene blevet aktive. Se figur 16 for at se et eksempel på, hvilke tal der er aktive:

Figur 16: Aktive tal

Hvis administratoren betjener værktøjet bag en virksomhedsproxy, skal du følge nedenstående trin for at konfigurere og udføre devicemove-scrip tet.

Trin til at konfigurere og udføre devicemove-scriptet

1. Åbn filen devicemove.sh.
2. Find variablen HTTPS_PROXY_HOST og fjern den (fjern det førende #).

3. Indstil værdien HTTPS_PROXY_HOST som:

   HTTPS_PROXY_HOST=<proxy-host>

4. Find variablen HTTPS_PROXY_PORT og fjern den (fjern det førende #).
5. Indstil værdien HTTPS_PROXY_PORT som:

   HTTPS_PROXY_PORT=<proxy-port>

6. Gem og luk filen devicemove.sh.
7. Åbn filen partner.cfg og tilføj den krævede refresh token.
8. Kontroller, at BroadWorks-værten, brugernavnet og adgangskoden er korrekt konfigureret i partner.cfg.
9. Kør scriptet:

   ./devicemove.sh

Tilbageføringsoperationen skal udføres for en virksomhed ad gangen.

Til BroadCloud Carrier

Administratorer kan indstille rollback_to_broadcloud= true i conf/partner.cfg for at aktivere automatisk tilbagekaldelse. Dette returnerer enheder til BroadCloud efter vellykket migrering i samme eller på tværs af regioner med NS Sync. Ved mislykkede overfør sler skal Cisco TAC du kontakte, før du anmoder om tilbagekaldelse.

Til Cisco BroadWorks og Webex til BroadWorks

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

1. Åbn en billet med Cisco TAC for at anmode om en enhedsåbning.
2. Kør enhedsflytningsværktøjet i tilbageførselstilstand på den sekundære BroadWorks Application Server for at vende tilbage til enhedsmigrationerne. Dette indstiller DMS-URL'en tilbage til tjenesteudbyderens DMS-URL for enhedsprofiler i Cisco BroadWorks og genaktiverer telefonnumre.
3. Teamet Webex Calling indstiller DMS-URL'en tilbage til tjenesteudbyderens DMS-URL i enheds profiler i. Webex Calling
4. Partneradministratorer skal deaktivere eller slette telefonnumrene i portalen Webex Calling via Control Hub.
5. Partneradministratorer skal flytte PSTN-telefonnumre tilbage til Cisco BroadWorks.

Instruktioner til at køre enhedsflytningsværktøj i tilbageførselstilstand

Følg nedenstående trin for at køre enhedens flytningsværktøj i tilbageførselstilstand:

Kør kommandoen nedenfor i den sekundære Cisco BroadWorks Application Server inde i enhedens flytte værktøjsmappe:

Tilbage profiler

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

Tilbage tal

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

Terminallogfiler

Vi får følgende logfiler i terminalen ved vellykket kørsel af enhedsflytningsværktøjet til tilbageføringsoperation:

Tilbage 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

Tilbage tal

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