Tack för din feedback.

Telefoner som stöds skapas automatiskt och tilldelas användare Webex Calling av provision eringsverktyget. Telefonerna markerade ”ja” i kolumnen ”Stöds i enhetsflytt verktyget” flyttas också automatiskt från Cisco BroadWorks eller BroadCloud till Webex Calling när verktyget för enhetsflyttning körs. Telefoner markerade ”Nej” i den kolumnen behöver ett manuellt ingripande för att ändra DMS-URL i Cisco BroadWorks-enhetsmallen eller i själva telefonen .

Den sista kolumnen ger mappning av telefonmodeller till kolumnen ”Enhetstyp” i filen transform-tool/input/newphones.csv. (Se avsnittet Transformeringsverktyg i den här artikeln för mer information om newphones.csv).

Partneradministratörer kör verktyget för tokengenerering minst en gång innan de börjar köra migreringsverktyg. Att köra det här verktyget är en engångsaktivitet efter att partner kontot har integrerats i RTM-lösningen för grossistförsäljning. Detta verktyg gör det möjligt för partner administratörer att logga in via webbläsaren för att få den unika TOKEN som behövs för att uppdatera till partnerkonfigurationsfilerna för migreringsverktygen.

Förutsättningar

Installera Java 8, 11, 17 eller 21 på datorn. Java är tillgängligt från många källor, inklusive:

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

Efter nedladdning extraherar du migreringsverktygets binärer.

Instruktioner för att köra

Kör följande kommando i terminalen i tokengeneratorkatalogen:

Fönster:

token_generator.bat

MacOS:

./token_generator.sh

Utgång:

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

Öppna webbadressen i webbläsaren på terminalen, logga in med partneradministratörsuppgifterna för att få TOKEN och kopiera samma för vidare användning.

Illustrationerna för användargränssnittet ges nedan för referens:

Figur 3: Logga in med Cisco Webex

Bild 4: Inloggningsfönstret

Figur 5: Generering av token

Konfigurera följande steg innan du kör verktygen för extrahering och enhetsflyttning på den sekundära BroadWorks-servern.

Aktivera OCI-P-anslutning

Enhetsflyttningsverktyget kommunicerar med BroadWorks via OCI-P-kommandon, för att aktivera OCI-P-anslutning, använd stegen nedan:

Steg 1: Använd CLI för att konfigurera allmänna inställningar.

Kör följande kommando i CLI för att byta till katalogen GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Kör följande kommando i CLI för att få de aktuella GeneralSettings:

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

Om dina inställningar inte överensstämmer med ovanstående använder du kommandot set för att konfigurera om dina inställningar.

Steg 2: Använd CLI för att konfigurera OCI Proxy.

Ändra katalogen till OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Kör följande CLI för att få aktuella inställningar. Du bör se följande:

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

Om dina inställningar inte överensstämmer med ovanstående använder du kommandot set för att konfigurera om dina inställningar.

Steg 3: Använd CLI för att konfigurera OCI Provisioning.

Ändra till Provisioning-katalogen:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kör följande kommando för att hämta de aktuella OCI-provisioneringsinställningarna:

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

Steg 4: Kör kommandot nedan i CLI för att verifiera att din konfiguration är 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.

Kontrollera att öppen klientserver är distribuerad och aktiv

Använd kommandona nedan för att distribuera och starta Open Client Server på den sekundära programservern om den inte är distribuerad eller inte redan har startat.

Steg 1: Distribuera servern med följande CLI-kommando:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Steg 2: Starta servern med det här kommandot:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktivera nummeraktivering

Kör följande kommandon i CLI för att aktivera aktiveringen av siffrorna:

Steg 1: Kör nummeraktiveringskommandot:

AS_CLI> cd SubscriberMgmt/NumberActivation

Steg 2: Kör aktiveringsaktiverat kommando:

AS_CLI> set dnMode groupAndUserActivationEnabled

Steg 3: Skriv Y. vid bekräftelseprompten.

För BroadCloud

Extraheringsverktyget är integrerat i BroadCloud Service Provider-portalen. En administratör av tjänsteleverantörer kan:

1. Skicka utdragsförfrågningar för upp till 50 kunder per förfrågan.
   Extraktförfrågan kan inte skickas in för samma kund mer än 10 gånger per dag.
2. Ladda ner den extraherade datafilen, i ZIP-format, i upp till 28 dagar från inlämningsdatum för begäran.

Följande siffror visar tjänsteleverantörsportalen.

Figur 6: Tjänsteleverantörsportalen

Figur 7: Tjänsteleverantörsportalen

CSV-extraheringsförfrågan

Initiera begäran om CSV-extrahering

1. Ladda ner Customer CSV

   Klicka på länken Ladda ner kund-CSV längst upp till höger i avsnittet Initi era begäran om CSV-extrahering.

2. Redigera kundlistan

   Administratören kan redigera den här CSV-filen så att den bara inkluderar de kunder för vilka extraktet behöver utföras.

3. Ladda upp och skicka

   Ladda upp den ändrade CSV-filen efter redigering.

   Klicka på Skicka för att initiera en utdragsbegäran för de listade kunderna och deras associerade platser.

Initiera extraheringsbegäran för en kund med Locations CSV

1. Välj kund- och nedladdningsplatser

   Välj en kund i rullgardinsmenyn.

   Hämta motsvarande locations.csv från fliken Visa kunder → Webbplatser → Exportera platser som CSV.

2. Redigera platsfilen

   Administratören kan redigera CSV så att den bara innehåller de platser de vill extrahera.

3. Ladda upp och skicka

   Ladda upp den redigerade locations.csv och klicka på Skicka.

   Endast de angivna platserna för den valda kunden kommer att inkluderas i utdrags förfrågan.

Initiera utdragsbegäran för alla kunder

1. Klicka på Skicka för att initiera en utdragsbegäran för alla kunder och alla deras platser under den aktuella tjänsteleverantören.

För Cisco BroadWorks och Webex för BroadWorks

1. Extraheringsverktyget körs på den sekundära Cisco BroadWorks Application Server i partnernätverket och ansluter via OCI-P.
2. Verktyget hämtar rå företags-, grupp-, nummer-, användare, tjänster, enheter och mjuk klientdata från Cisco BroadWorks- eller BroadCloud-plattformen och matar ut dessa data till XML-filer som tillhandahåller ingångarna för transformeringsverktyget.

Nästa avsnitt förklarar hur du installerar och konfigurerar extraktionsverktyget.

Förutsättningar

1. SCP extraheringsverktygsbinärer till sekundär Cisco BroadWorks Application Server.
2. SSH till den sekundära Cisco BroadWorks Application Server för att konfigurera förutsättningarna och köra extraheringsverktyget.
3. Konfigurera tjänsteleverantören och grupp-ID för att extrahera från Cisco BroadWorks i Conf/ExportTool.yml. Se följande exempel på YAML-ut drag:

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

4. Kontrollera att användar-ID, lösenord och värd namn för den sekundära Cisco BroadWorks Application Server är korrekta 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 är obligatorisk för en Webex för BroadWorks-migrering.

5. Ändra JDK/JRE-miljösökvägen i filen export.sh om den sekundära Cisco BroadWorks Application Server JDK/JRE-miljösökvägen skiljer sig från filen:

   JAVA_HOME=/usr/local/java/java_base

Instruktioner för att köra

Kör följande kommando i den sekundära Cisco BroadWorks Application Server från katalogen för extraheringsverktyg:

./export.sh

Terminalloggar

Följande loggar är tillgängliga i terminalen vid framgångsrik export: Kör 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
**************************************************

Utgång

En utdata-ZIP-fil (extraherad_data_ .zip<timestamp>) är tillgänglig i samma katalog för extraheringsverktyg. Använd följande kommando för att visa och använda ZIP-filen för omformningsverkty gets inmatning:

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

Om administratören använder verktyget bakom en företagsproxy följer du stegen nedan för att konfigurera och köra exportskriptet.

Steg för att konfigurera och köra exportskriptet

1. Öppna filen export.sh.
2. Leta reda på HTTPS_PROXY_HOST-variabeln och avkommentera den (ta bort inledande #).

3. Ange värdet HTTPS_PROXY_HOST som:

   HTTPS_PROXY_HOST=<proxy-host>

4. Leta reda på HTTPS_PROXY_PORT-variabeln och avkommentera den (ta bort inledande #).
5. Ställ in HTTPS_PROXY_PORT-värdet som:

   HTTPS_PROXY_PORT=<proxy-port>

6. Spara och stäng filen export.sh.
7. Öppna filen partner.cfg och lägg till önskad refresh token.
8. Kontrollera att BroadWorks värd, användarnamn och lösenord är korrekt konfigurerade i partner.cfg.
9. Kör skriptet:

   ./export.sh

Förlovningsformulär:

Extraheringsverktyget (BroadCloud och BroadWorks) genererar nu automatiskt en konsoliderad XLSX-fil med titeln Engagement Form SUA.xlsx under körning. Filen är förfylld med all tillgänglig data i relevanta kalkylblad, vilket hjälper till att effektivisera och påskynda partnerns slutförande.

Det här transformeringsverktyget körs för alla migreringar. Transformeringsverktyget körs på vilken dator som helst, inklusive en partners bärbara administratörsdator, och använder Webex Public API: er. Den läser extraheringsverktygets utdata ZIP (extracted_data_ .zip<timestamp>) fil som en ingång och omvandlar den råa XML till ett JSON-format som används av provisioneringsverktyget.

Förutsättningar

När du har hämtat och extraherat binärfilerna för migreringsverktyg konfigurerar du följande förutsättningar:

1. Ställ in REFRESH_TOKEN (Token kopierad från Token Generator Tool) och NAME_OF_MAIN_LOCATION i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Du kan även ange PROVISIONING_ID (kopierat från mallen i Partner Hub) i filen conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   För att få en mer fullständig verifiering av kundens e-postadress kan du valfritt ställa in PROVISIONING_ID.
3. Konfigurera saknad information i filen input/customers.csv (se nästa avsnitt) om den saknas.
4. Lägg till slutanvändarens e-postadress i filen input/users.csv.
5. Om nya telefoner ska etableras lägger du till mac-adressen och e-postadressen för användar ens nya telefon i filen input/newphones.csv. Detta krävs endast om partneradministratörerna vill tillhandahålla nya telefoner i grossistsamtal.
6. Konvertera BroadWorks callcenter till CXEssentials med hjälp av filen input/cxessentials.csv.
7. Om du vill kan du aktivera egenskapen UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS för att konvertera alla callcenter till CXEssentials.
8. Använd filen input/locations.csv för att stödja migrering av stora företag som gör det möjligt för administratörer att migrera sina kunders platser efter plats
9. Aktivera eventuellt användning av MAC-adresser från User-Agent-rubriken i SIP REGISTER-meddelandet när MAC-adressen inte är tillgänglig i Cisco BroadWorks- enhetsprofilen. Avkommentera raden USE_MAC_ADDRESS_FROM_SIP_REGISTER=Ja i filen conf/partner.cfg
10. Aktivera eventuellt egenskaperna ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_ MUSIC_ON_HOLD och ANALOG_USER_TYPE_DISABLE_T38 för att konfigurera väntande samtal, musik i vänteläge och inaktivera T38-inställningar för alla användare av analog typ.

11. Om du vill konfigurera generiska gateway-enheter lägger du till enhetens MAC-adress och användar-ID i filen input/genericgateways.csv. Ange även om användaren är den PRIMÄRA ägaren eller en DELAD användare (för delade samtalsutträdanden). Detta behövs bara om partneradministratörer planerar att använda generiska gateway-enheter i grossistsamtal.

    Den här funktionen är inte tillgänglig för migreringar från BroadCloud till Wholesale.

12. För BroadCloud-migreringar, om du vill konvertera alla användare med meddelandestation stypen till voice_mail_group, uppdaterar du filen conf/rialto_station_type_to_wholesale_package.csv genom att ersätta värdet för grossistpaket med voice_mail_group för raden där Rialto Station Type skickar meddelanden.

    Om du vill kan du aktivera egenskapen COMMON_VOICE_MAIL_GROUP_PASSCODE i partner.cfg för att konfigurera standard-PIN-koden för röst brevlådegrupper.

    Om den här egenskapen inte anges i partner.cfg måste den anges per kund i filen customers.csv under kolumnen CommonVoicEmailGroupPassCode.

13. För migrering av gemensamma kontakter till Webex Calling

    Det är förbättringen för att hantera gemensamma kontakter på företags- och webbplatsnivå. Dessa kontakter kan nu migreras antingen som organisationskontakter (Organisation skontakter) eller som virtuella tillägg, baserat på konfigurationsinställningarna. Nedan följer detaljerna för att vägleda dig genom denna migreringsprocess.

    Nyckelkonfiguration:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      En ny egenskap, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, introduceras i filen partner.cfg. Den här egenskapen avgör hur vanliga kontakter migreras från Rialto tillWebex Calling.

    • Utan COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfigurerad

      Vanliga kontakter migreras som organisationskontak ter (Organisationskontakter).

      Ingen ytterligare konfiguration krävs.

      Kontakter förblir tillgängliga på organisations nivå.

    • Med COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfigurerad

      Vanliga kontakter migreras som virtuella tillägg.

      Varje kontakt kommer att läggas till med ett tilläggsnummer, och startintervallet för tillägget definieras i egenskapen COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE i partner.cfg.

      Virtuella tillägg stöds på både organisationsnivå och platsnivå, beroende på kontak tens omfattning.

14. Aktivera standardleverantör för samtalsinspelning till Webex.

    Det här steget krävs endast när du migrerar inställningar för samtalsinspelning för användare konfigurerade med Dubber till Cisco Native Call Rec ording i Webex.

    Så här aktiverar du det här alternativet:

    • I filen partner.cfg anger du följande egenskap, default _call_recording_vendor=WebEx.
    • Använd dessutom egenskapen WEBEX_CALL_RECORDING_STORAGE_REGION för att konfigurera lagringsregionen.

      Alternati vet On Dem and-inspelning från BroadCloud stöds inte iWebex Calling. Dessa inställningar för samtalsinspelning migreras inte och visas i undantagsrapporten.

15. Uteslutning av utvalda telefonnummer från migrering:

    Om du vill utesluta specifika telefonnummer från migreringsprocessen måste följande tvåstegsprocedur med hjälp av transformeringsverktyget följas:

    • Kör initialt transformeringsverktyget för första gången. När verktyget är klart kommer verktyget att generera en fil med namnet telephone_numbers_inventory.csv, som ligger i katalogen output/timestamp/. Kunden måste granska den här filen och ange ”Ja” i kolumnen ”Drop Tn” för varje telefonnummer som ska uteslutas från den kommande migreringen.
    • Efter uppdatering av filen telephone_numbers_inventory.csv med lämpliga uteslutningsflaggor körs transformeringsverktyget en andra gång. Den uppdaterade filen ska skickas som ett argument i följande format.

      . /transform.sh -extract=inmatning/extraherad_data_1747640608219.zip -decommissionnumbers= {filepath/telephone_numbers_inventory.csv}

16. Om du vill kan du ställa in egenskapen ALLOW_RESTRICT_BY_PARTNER_MODE till OFF så att kundadministratörer kan ändra partnerdefinierade inställningar i Control Hub.
17. För att migrera mobilnummer (BroadWorks Mobility) från BroadCloud till Webex Calling

    Det här avsnittet beskriver migreringen av funktionen BroadWorks Mobility (kundmobilnummer) från BroadCloud (Mobile Network Integration) till W holesale Webex Calling (Webex Go Mobile Network Operator).

    Förut sättningar - Innan migreringsprocessen påbörjas måste partneradministratörer kontakta Ciscos konto team för att utföra konfigurationen av Cloud Connected PSTN (CCP) och Custom Carrier List (CCL).

    En ny egenskap, ASSIGN_MOBILE_NUMBERS_TO_USERS, läggs till i filen partner.cfg. Aktivera den här egenskapen om du vill tillåta att mobilnummer till delas och migreras till användare.

    • Den här funktionen stöds endast för Broadcloud-till- grossistmigreringar.
    • I Wholesale Webex kan slutanvändare ha antingen ett mobil nummer eller ett PSTN-nummer (inte båda), till skillnad från i BroadCloud.
    • När ett mobilnummer tilldelas en användare blir deras primära PSTN-nummer deras sekundära (alternativa) nummer.
    • Mobilnummer kan inte migreras för användare som konverteras till arbetsytor eller virtuella linjer.
    • När ett mobilnummer har tilldelats i Wholesale Webex visas det som Aktivt i Control Hub. Denna status betyder inte att numret är omedelbart redo att ta emot samtal. Samtal sfunktionen kommer endast att vara tillgänglig efter att migreringen är helt klar.
    • Inställningar för mobiltelefonintegration som konfigurerats av slutanvändare i Calling User Portal (CUP) migreras inte. När ett telefonnummer, mobilnummer eller tillägg anrop as efter migreringen ringer alla användarens enheter.

18. Om du vill konfigurera paketkvantitetsgränser under kundmigrering anger du kvantiteten för varje paket i filen input/package_quantity.csv. Den konfigurerade paketmängden måste vara större än eller lika med antalet tilldelade paket för användare/arbetsyta.

    Begränsningar för paketkvantitet stöds för närvarande inte för migreringar från Webex för BroadWorks till grossistförsäljning.

    När du kör transformeringsverktyget, ange den uppdaterade filen som en inmatning sparameter:. <extract_zip_file>/transform.sh -extract= -packagelimits=input/package_quantity.csv .

19. Migrera webbplatser från flera kunder från Broadworks/Broadcloud till en enda kund i grossistledet Webex Calling
    • Ett nytt runtime-läge, -ConsolidatedMigration, introduceras i verktyget Transform för att stödja migrering av flera kundwebbplatser från Broadcloud/Broadworks till Webex Wholesale Platform under en enda grossistkundorganisation. När det här läget är aktiverat konsoliderar verktyget flera kundplatser till en grossistkundorganisation

      -consolidatedMigration

    • Det finns andra valfria argument som kan ges tillsammans med -ConsolidatedMigration, t.ex.

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

    • om -TargetEnterpriseID anges och Id finns i utdatafilen för extraherings verktyget kommer det att användas för att skapa grossist kundorganisationen och om ID inte hittas kommer verktyget att återgå till att använda alla tillgängliga kunduppgifter från utdatafilen för verktyget Extract.
    • om -ConsolidateDexternalID ges kommer det att ställa in externalID för kunden och om det inte anges kommer verktyget att återgå till att använda befintligt flöde för externt ID.
    • <timestamp>En konsoliderad JSON-fil (customer.json) kommer att finnas tillgänglig i katalogen output//.

Fylla i input/customers.csv

Filen input/customers.csv ger data som kanske saknas i Cisco BroadWorks eller BroadCloud. Filen kan lämnas tom om all obligatorisk information redan finns tillgänglig. Du behöver inte fylla i alla kolumner, bara den saknade informationen är obligatorisk.

Tabellen nedan förklarar de viktigaste kolumnerna i input/customers.csv.

Fylla i input/users.csv

Filen input/users.csv ger data som kanske saknas i Cisco BroadWorks eller BroadCloud. Filen kan lämnas tom om all obligatorisk information redan finns tillgänglig. Du behöver inte fylla i alla kolumner, bara den saknade informationen är obligatorisk.

Instruktioner för att köra

Kör transformeringsverktyget i vilket operativsystem som helst. Använd stegen nedan för att köra verktyget i Windows och macOS:

Fönster

Kör kommandot nedan för att köra transformeringsverktyget 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öljande steg för att köra transformeringsverktyget på macOS:

1. Skapa en virtuell miljö och installera beroenden för att köra transformeringsverktyget med 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 transformerings verktyget:

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

Förkontroll för kund/användare

Transformeringsverktyget gör API-anrop till Webex för att fånga potentiella provisioneringsproblem. Som standard validerar den kundens adress och primära e-post. Om värdet PROVISIONING_ID anges i filen conf/partner.cfg valideras även platsinformation. Resultaten av förkontrollen ingår i undantagsrapporten.

Dessutom kan följande valfria parametrar läggas till när transformerings verktyget körs:

förhandskontroll

Förutom att köra förkontroll-API:et för kundinformationen kör Transform Tool också förhandsgransknings-API för abonnentens e-postmeddelanden.

förcheckinfo

Som standard ingår endast förhandsgranskningsfel (dvs. problem som blockerar etablering) i undantagsrapporten. Att lägga till den här flaggan kommer också att inkludera framgångsrika förkontrollresultat (t.ex. om en Webex-organisation redan finns som kan bifogas automatiskt).

Terminalloggar

Följande loggar i terminalen vid framgångsrik 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

Undantagsrapport

Transform Tool genererar undantagsrapporten i <timestamp>katalogen output/ /exception_report.txt. Du kan använda den här rapporten för att identifiera de problem som påverkar migreringen och åtgärda dem i Cisco BroadWorks- systemet.

När du har ändrat användardata för att lösa undantaget kör du om verktygen för extrahering och omvandling med de nya data. Exempelrapportfilen för undantag enligt följande:

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

Utgång

<timestamp><groupid>En utdatafilen JSON (customer.json) kommer att finnas tillgänglig i katalogen output//. Exempelfilen customer.json är som följer:

{
    "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"
    }
}

Provisionsverktyget kan köras på vilken dator som helst, vanligtvis (partnerns administratörsbärbara dator) och använder Webex Public API: er. Den läser JSON-filen (customer.json) som en inmatning och tillhandahåller kunder, platser, nummer, användare, tjänster och enheter i Webex Wholesale RTM-lösningen.

Förutsättningar

Konfigurera följande förutsättningar i katalogen för etableringsverktyg:

1. Installera Java 8, 11, 17 eller 21 på datorn. Java är tillgängligt från många källor, inklusive:
   • 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 hämtat och extraherat binärfilerna för migreringsverktyg ställer du in miljövariabeln JAVA_HOME i provisioning_tool.sh för MAC och provisioning_tool.bat för Windows.
3. Den partner.cfg filen:
   • Ställ in WHOLESALE_PROVISIONING_ID och REFRESH_TOKEN (Token kopierad från Token Generator Tool). Partneradministratörerna måste kontakta sitt kontoteam för att få PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Ställ in SEND_SUBSCRIBERS_WELCOME_EMAIL till false, om partners inte vill skicka ett välkomstmeddelande till användarna. Standardvärdet är true.

     Webex skickar endast välkomstmejl till slutanvändare. Kundadministratörer får inte välkomstmejl.

     Användare och kundadministratörer baserade på platser i USA och Kanada får ett separat e-postmeddelande från RedSky. RedSky E911- plattformen skickar detta e-postmeddelande för att bekräfta skapandet av kund kontot för räddningstjänster. Detta RedSky-e-postmeddelande är separat från Webex välkomstmejl och styrs inte av Webex e-postinställningar. För grossistorganisationer i USA och Kanada aktiveras RedSky automatiskt som leverantör av räddningstjänster.

4. Använd egenskapen WEBEX4BWKS_EMAIL_SUBJECT för Webex för BroadWorks-migreringar för att skicka e-postämnet för begäran om ändring av lösenord för Webex för BroadWorks-prenumer anter.
5. Använd egenskapen WEBEX4BWKS_EMAIL_BODY för Webex för BroadWorks-migreringar för att skicka e-posttexten för begäran om ändring av lösenord för Webex för BroadWorks-prenumeranter.
6. Använd egenskapen C USTOM_TAGS för att lägga till taggar efter att kunden har skapats.
7. För att tillämpa grossistrabatter måste partneradministratörer kontakta Ciscos konto team innan du påbörjar migreringen.

   En ny egenskap, APPLY_WHOLESALE_DISCOUNTS läggs till i partner.cfg. Aktivera den här egenskapen om du vill tillämpa rabatter på användare och arbetsytor.

8. (Valfritt) Konfigurera PSTN-anslutningen uttryckligen

   Om du vill ange PSTN-anslutningen för alla platser som etableras under migreringen, inklusive huvudplatsen, lägger du till följande egenskap i filen partner.cfg:

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

   Om egenskapen inte är konfigurerad eller kommenteras, använder etableringsverktyget standardprocessen för val av PSTN-anslutning.

Instruktioner för att köra

Använd följande steg för att köra verktyget i Windows och macOS:

Fönster

Utför följande steg för att köra verktyget 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öljande steg för att köra verktyget 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>

Förutsättningar för Webex för BroadWorks-migrering

Partner administratörer måste uppdatera sin BroadWorks-onboardingmall för Webex för Broad Works samexistensfunktioner. Se följande bild:

När mallen för Webex för BroadWorks Onboarding har uppdaterats för att stödja migrering begär du Cisco-kontoteamet att aktivera funktionen ”grossist-partner-blandning aktiverad” på partnernivå. Med den här inställ ningen kan provisioneringsverktyget automatiskt lägga till grossistpaket till befintliga Webex for BroadWorks- kunder under etablering.

Kör provisioneringsverktyget med ytterligare ett argument.

Förberedelsefas: är standardfasen där administratörer kan tillhandahålla BroadWorks-användare som grossistprenumerant och fortsätta med Webex för BroadWorks-användare.

Underhållsfas: är den andra fasen där administratörer kan tilldela grossistlicensen till befintliga Webex för BroadWorks-användare. Du måste köra etableringsverktyget med ett argument underhåll.

Postmigrerings fas: Är den sista fasen när administratörer kan konvertera BroadWorks till grossistförsäljning helt. Du måste köra etableringsverktyget med ett argument post migration.

Terminalloggar

Följande är loggarna i terminalen vid framgångsrik etabler ing:

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 kommer att skrivas ut med antalet platser som skapats för varje körning:

Utgång

Provisionsverktyget genererar framgångs- och felrapporter i utdata/*. success/ <external_id>felfilerna. Granska framgångs- och fel loggar för utdata för att verifiera framgångsrik etablering.

Systemet kommer att generera en provisioning_report_*.csv-fil i katalogen output/consolidated_report s/. Den här filen innehåller både uppgifter om framgång och misslyckande för varje entitet och dess inställningar, vilket ger en omfattande provisionerings rapport.

Provisionsverktyget genererar också en provisioning_statistics_*.csv-fil i katalogen output/consolidated_reports/. Den här rapporten innehåller antalet etablerade kunder, platser, användare, enheter och grupp funktioner som framgångsrikt och misslyckats.

Partneradministratörer kan verifiera kundprovisioneringen i portalen Partner Hub och Control Hub. Se följande illustrationer från portalen Partner Hub och Control Hub:

Bild 8: Partner Hub

Bild 9: Control Hub

Figur 10: Enheter

Figur 11: Samtal

Restriktioner efter tillhandahållande

När etableringen är klar för en BroadCloud-migrering blockeras följande åtgärder:

• CAP Portal — Lägga till användare eller portade enheter.
• SP Portal - Skapa ADD-beställningar med enheter eller nummer.
• RSB API - Skapa ADD-beställningar med enheter eller nummer och skapa användare. RSB ADD-beställningar gjorda med enheter eller nummer kommer att avvisas.

BroadCloud till grossistmigration - begränsning av enhetsregistrering

För partneradministratörer som migrerar kunder från BroadCloud till Wholesale inom samma region kan enheter läggas till i Wholesale efter att ha kört provisioneringsverktyget. Dessa enheter kommer dock att bli berättigade att registrera sig på Webex-plattformen först efter att migreringen (enhetsflyttning) för motsvarande plats har slutförts.

Denna begränsning gäller inte för

• Kunder som migrerar från Broadworks/W4b till Wholesale.
• BroadCloud till grossistmigreringar över olika regioner.

Rekommenderad vägledning

Om du vill undvika problem med enhetsregistrering slutför du migreringen av enhetsflyttning på platsnivå innan du försöker registrera enheter på Webex-plattformen för migreringar från BroadCloud till Wholesale i samma region.

För BroadCloud

För BroadCloud-partners använder du tjänstel everantörsportalen för att skicka en migreringsbegäran för nummer, enheter och SCA-migreringar ( Shared Call Appearances).

Inom tjänsteleverantörsportalen kan en migrerings begäran omfatta upp till 50 kunder. Högst 10 förfrågningar kan skickas in inom en dag.

Administratörer kan aktivera automatisk återställning genom att ställa in rollback_to_broadcloud=true i filen conf/partner.cfg, som flyttar enheter tillbaka till BroadCloud efter migrering. Den stöder både migreringar av samma och olika regioner med NS Sync, men endast för framgångsrika migreringar. För misslyc kade måste administratörer höja en Cisco TAC innan de begär återställning.

Det finns två alternativ för att välja migreringstyp i portalen:

• Migrering — Välj det här alternativet om du vill initiera en begäran om migrering av nummer, enheter och delade samtalsutseende (SCA).
• Enhetsstatus — Välj det här alternativet om du vill visa aktuell status för en enhet på BroadCloud och Calling.

Följande siffror visar tjänsteleverantörsportalen.

Figur 12: Tjänsteleverantörsportalen

Figur 13: Tjänsteleverantörsportalen

Migrera valda platser (valfritt)

Om du vill starta migreringen för en viss delmängd av platser som anges i customer.json- filen, inkludera en locations.csv fil med din begäran. Den här CSV-filen ska bara lista de platser du tänker migrera.

För att ladda ner listan över tillgängliga aktiva webbplatser navigerar du till Visa kunder → Välj en kund → Exportera platser som CSV.

Figur 14: Exportera platser som CSV

Aktivera alternativet för att koppla bort nummer

När du använder samma SIP-trunk för Webex Calling och BroadCloud Carrier bör administratörer använda alternativet Koppla bort nummer. Detta tar bort telefonnummer från att ta emot inkommande samtal efter migrering i BroadCloud.

För att aktivera det här alternativet,

1. I filen partner.cfg ställer du in DISCONNECT_NUMBERS_FROM_RIALTO = yes.
2. Kör migreringsverktyget igen med samma customer.json- fil och den uppdaterade partner.cfg.

Om nummer inte kan kopplas bort, ta upp en Cisco TAC- förfrågan.

För Cisco BroadWorks och Webex för BroadWorks

För migreringar från Cisco BroadWorks och Webex för BroadWorks körs verktyget på den sekundära Cisco BroadWorks Application Server i partnernätverket och ansluter till AS via OCI-P. Den använder Transform Tool output JSON (customer.json) -filen som indata och kör OCI-P-kommandona för att migrera enheter och mjuka klienter.

Vid framgångsrik drift kommer enhetens flyttverktyg att:

1. Avregistrera enheter från Cisco BroadWorks och registrera dem i grossistledet.
2. Användare som använder UC-One-klienten omdirigeras till Webex-appen vid första inloggningen.
3. Inaktivera telefonnumren från Cisco BroadWorks eller ta bort telefonnumren från BroadCloud.
4. Aktivera nummer i grossistledet.
5. Skapa delade samtalsutträdanden i grossistledet för BroadCloud-migreringar. [Detta steg är endast tillämpligt för BroadCloud-migreringar].

6. Om administratören använder verktyget bakom en företagsproxy följer du stegen nedan för att konfigurera och köra provisioneringsskriptet.

   Konfigurationsprocedur

   1. Öppna filen devicemove.sh.
   2. Leta reda på variabeln PROXY_HOST och avkommentera den (ta bort inledande # för devicemove.sh).

   3. Ställ in värdet PROXY_HOST som:

      PROXY_HOST=<proxy-host>

   4. Leta reda på variabeln PROXY_PORT och avkommentera den (ta bort inledande # för devicemove.sh).

   5. Ställ in PROXY_PORT-värdet som:

      PROXY_PORT=<proxy-port>

   6. Leta reda på variabeln PROXY_SCHEME och avkommentera den (ta bort inledande # för devicemove.sh). Det här steget är valfritt. Om det förblir kommenterat kommer standardvärdet för PROXY_SCHEME att vara HTTP.

   7. Ställ in värdet PROXY_SCHEME som:

      PROXY_SCHEME=<proxy-scheme>

   8. Spara och stäng filen devicemove.sh.
   9. Öppna filen partner.cfg och lägg till önskad refresh token.
   10. Kontrollera att BroadWorks värd, användarnamn och lösenord är korrekt konfigurerade i partner.cfg

   11. Kör skriptet:

       ./devicemove.sh

SCP och SSH

1. SCP enheten flyttar verktyget till den sekundära Cisco BroadWorks Application Server.
2. SSH till den sekundära Cisco BroadWorks Application Server för att konfigurera förutsättningarna och köra enhetsflyttningsverktyget.

Förutsättningar

1. Ställ in REFRESH_TOKEN (Token kopierad från Token Generator Tool) i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Kontrollera att användar-ID, lösenord och värd namn för den sekundära Cisco BroadWorks Application Server är korrekta i filen conf/ DeviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. För att skicka aktiveringsmeddelanden igen måste du ställa in send_subscribers_welcome_email=true i filen conf/partner.cfg.

   Om administratörer vill skicka inbjudningsmeddelanden till sina användare under migreringen bör de avkommentera egenskapen ”send_subscribers_welcome_email=true” i filen conf/partner.cfg. Annars bör fastigheten förbli oförändrad.

4. Kontrollera att JDK/JRE-miljövägen är korrekt i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratörer kan använda filen locations.csv från indatakatalogen för att migrera specifika grupper istället för alla grupper under ett företag.

Polycom-telefoner

För att flytta Polycom-telefoner från Cisco BroadWorks till grossist samtal måste en partneradministratör skapa en ny identitets-/enhetsprofiltypfil på systemnivå i Cisco BroadWorks varje Polycom-enhetsmall. Se figur 14 och ladda upp den anpassade filen Device-move-tool/conf/DeviceProfile/ {region} /polycom_vvx.cfg. När du har laddat upp den nya enhetsfilen, se till att den nyskapade filen finns på gruppnivå. Se också till att filmigration_%BWMAC-adress%.cfg inte står i konflikt med någon befintlig fil i systemet).

Den används internt av enhetens flyttverktyg.

Migreringsprocessen för Polycom-telefoner:

1. Verktyget för enhetsflyttning ersätter filen %BWMACAddress%.cfg på enhetsnivå med polycom_vvx2.cfg. Den här filen hänvisar till Migration_%BWMACAddress%.cfg.
2. Bygg om enhetsprofilerna på grupp- eller enhetsnivå.
   Att agera på gruppnivå eller enhetsnivå beror på konfigurationen av parametern DeviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Enhetsflyttningsverktyget ber Cisco BroadWorks Application Server att starta om telefoner på gruppnivå eller enhetsnivå.
4. Efter omstartsbegäran hämtar och bearbetar Polycom-telefoner% BWMACAddress%.cfg, som ber Polycom-telefonerna att ladda ner och bearbeta migration_%BWMACAddress%.cfg, vilket ställer in Device.prov.ServerName till https://plcm.sipflash.com.
   https://plcm.sipflash.com för regionen USA har andra regioner olika webbadresser.
5. Polycom-telefonen hämtar %BWMACAddress%.cfg från https://plcm.sipflash.com och hanteras av DMS. Webex Calling

Figur 14: Lägg till fil för identitet/enhetsprofiltyp

Instruktioner för att köra

Det finns två metoder för att åberopa DMT, den första är att åberopa genom en enda kund åt gången och den andra är att köra igenom flera kunder samtidigt.

Verktyget för enhetsflyttning körs från den sekundära Cisco BroadWorks Application Server i katalogen för enhetsflyttningsverktyg:

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

Terminalloggar

Följande är loggarna i terminalen för framgångsrik körning av enhetsflyttningsverktyget för 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

Utgång

Efter enhetsmigreringen har enheterna kommit online och redo att ringa/ta emot samtal. Se figur 15 för att se ett exempel på enhets status:

Figur 15: Enhetsstatus

Efter enhetsmigreringen har siffrorna blivit aktiva. Se figur 16 för att se ett exempel på vilka nummer som är aktiva:

Figur 16: Aktiva siffror

Om administratören använder verktyget bakom en företagsproxy följer du stegen nedan för att konfigurera och köra DeviceMo ve-skriptet.

Steg för att konfigurera och köra DeviceMove-skriptet

1. Öppna filen devicemove.sh.
2. Leta reda på HTTPS_PROXY_HOST-variabeln och avkommentera den (ta bort inledande #).

3. Ange värdet HTTPS_PROXY_HOST som:

   HTTPS_PROXY_HOST=<proxy-host>

4. Leta reda på HTTPS_PROXY_PORT-variabeln och avkommentera den (ta bort inledande #).
5. Ställ in HTTPS_PROXY_PORT-värdet som:

   HTTPS_PROXY_PORT=<proxy-port>

6. Spara och stäng filen devicemove.sh.
7. Öppna filen partner.cfg och lägg till önskad refresh token.
8. Kontrollera att BroadWorks värd, användarnamn och lösenord är korrekt konfigurerade i partner.cfg.
9. Kör skriptet:

   ./devicemove.sh

Återställningsåtgärden måste utföras för ett företag i taget.

För BroadCloud Carrier

Administratörer kan ställa in rollback_to_broadcloud= true i conf/partner.cfg för att aktivera automatisk återställning. Detta returnerar enheter till BroadCloud efter framgångsrik migrering i samma eller tvärregion med NS Sync. Vid misslyckade migreringar, kontakta Cisco TAC innan du begär återställning.

För Cisco BroadWorks och Webex för BroadWorks

Återställningsprocessen för Cisco BroadWorks och Webex för BroadWorks är som följer:

1. Öppna en biljett med Cisco TAC för att begära återställning av enheten.
2. Kör verktyget för enhetsflyttning i återställningsläge på den sekundära BroadWorks Application Server för att återställa enhetsmigreringarna. Detta ställer in DMS-webbadressen tillbaka till tjänsteleverantörens DMS-URL för enhetsprofiler i Cisco BroadWorks och återaktiverar telefonnummer.
3. Te Webex Calling amet ställer in DMS-webbadressen tillbaka till tjänsteleverantörens DMS-URL i enhets profiler i. Webex Calling
4. Partneradministratörer måste inaktivera eller ta bort telefonnumren i portalen Webex Calling via Control Hub.
5. Partneradministratörer måste flytta PSTN-telefonnummer tillbaka till Cisco BroadWorks.

Instruktioner för att köra enhetsflyttningsverktyget i återställningsläge

Följ stegen nedan för att köra enhetens flyttverktyg i återställningsläge:

Kör kommandot nedan i den sekundära Cisco BroadWorks Application Server i enhetens flyttverktygskatalog:

Återställ profiler

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

Återställ nummer

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

Terminalloggar

Vi kommer att få följande loggar i terminalen när du lyckas köra enhetens flyttverktyg för återställning:

Återställ 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

Återställ nummer

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