Migreringsverktyg till övergång från BroadWorks, Webex för BroadWorks och BroadCloud till grossist-RTM-lösningar

Telefoner som stöds skapas och tilldelas automatiskt till användare i Webex Calling via etableringsverktyget. De telefoner som är markerade ”ja” i kolumnen ”Stöds i verktyget för enhetsflyttning” 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 en manuell åtgärd för att ändra DMS-URL:en i Cisco BroadWorks-enhetsmallen eller i själva telefonen.

I den sista kolumnen visas mappning av telefonmodeller till kolumnen ”Enhetstyp” i filen transform-tool/input/newphones.csv. (Se avsnittet Omvandla verktyg i denna artikel för mer information på newphones.csv).

Partneradministratörer kör det här verktyget token generator minst en gång innan de börjar köra migreringsverktyg. Att köra det här verktyget är en engångsaktivitet när partnerkontot registreras i RTM-lösningen i grossistledet. Med det här verktyget kan partneradministratörer logga in via webbläsare för att få den unika TOKEN som krävs för att uppdatera till partnerkonfigurationsfilerna för migreringsverktygen.

Förutsättningar

Efter hämtningen extraherar du migreringsverktygsbinarier.

Ställ in sökvägen för JRE/JDK-miljön i token_generator.sh för MAC och token_generator.bat för Windows. Om JAVA_HOME-sökvägen redan finns kommer den att återanvändas av verktyget.

• mac: JAVA_HOME="/ANVÄNDARE/CISCO/JDK/ZULU@1.8.282/Innehåll/Hem/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Instruktioner att köra

Kör följande kommando i terminalen i token generatorkatalogen:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Utgång:

Verktygsnamn: Version av verktyget för token generator: 1.13.0 Ladda in URL:en i din webbläsare: http://localhost:8080 

Öppna URL:en i webbläsaren på terminalen, logga in med partneradministratörens inloggningsuppgifter för att hämta TOKEN och kopiera samma för ytterligare användning.

Illustrationerna i användargränssnittet visas nedan för referens:

Figur 3: Logga in med Cisco Webex

Figur 4: Fönstret Inloggningsuppgifter

Figur 5: Generering av token

Konfigurera följande steg innan du kör extraktet och enhetens flyttverktyg på den sekundära BroadWorks-servern.

Aktivera OCI-P-anslutning

Verktyget för enhetsflyttning kommunicerar med BroadWorks via OCI-P-kommandon, för att aktivera OCI-P-anslutning använder 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 ändra katalogen Allmännainställningar:

AS_CLI> cd /Applications/OpenClientServer/Allmännainställningar.

Kör följande kommando i CLI för att hämta aktuella allmännainställningar:

AS_CLI/Applications/OpenClientServer/GeneralSettings> hämta klientPort = 2208 klientPortAktiverad = true secureClientPort = 2209 secureClientPortEnabled = true systemDomain = <> 

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

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

Ändra katalogen till OCI-proxy:

AS_CLI> cd /Applications/OpenClient

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

AS_CLI/Applications/OpenClientServer/OCIProxy> get activated = true activatedLoginLevelScreening = falskt aktiverat svarCaching = falskt svarCachingDurationHours = 24 svarCacheförnyelseperiodmins = 30 meddelandenKökapacitet = 50 meddelandenTimeoutsekunder = 1800 

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

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

Ändra etableringskatalogen:

AS_CLI> cd /System/NetworkAccess-listor/OCI/Provisioning

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> få adressbeskrivning ======================== 127.0.0.1 lokal som 

Steg 4: Kör kommandot nedan i CLI för att kontrollera att konfigurationen är korrekt.

 AS_CLI/Maintenance/ManagedObjects> får broadworks och kontrollera att din utgång ser ok. Se nedan för provresultat: SOM_CLI/Maintenance/ManagedObjects> få broadworks BroadWorks Managed Objects ========================== * Server: Identitet..............: AS-version...............: Rel_21.sp1_1.551 Administrativ stat..: Olåst * Program: Namn Version Distribuerad Administrativ status Effektiv State ========================================================================================= ExecutionAnd========================================================================================= Provisioning 21.sp1_1.551 true Oplåst Oplåst FlashPolicy 21.sp1_1.551 false Oplåst stoppade öppna Klientserver 21.sp1_1.551 true Oplåst Oplåst WebContainer 21.sp1_1.551 true Oplåst Oplåst 4 poster hittades. * Värdprogram: Namn Version Context Path Deployed ================================================================== CommPilot 21.sp1_1.551 / true DeviceManagementfiler 21.sp1_1.551 /DeviceManagement true JWSF iles 21.sp1_1.551 /Filerepos true Mediafiles 21.sp1_1.551 /media true OCIF iles 21.sp1_1.551 /ocifiles true 5 poster hittades. 

Verifiera öppen klientserver distribuerad och aktiv

Använd kommandona nedan för att distribuera och starta Öppna klientservern på den sekundära programservern om den inte har distribuerats eller inte redan har startats.

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

AS_CLI/Maintenance/ManagedObjects> distribuera programmet Öppenklientserver

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

AS_CLI/Maintenance/ManagedObjects> starta programmet Öppnaklientserver

Aktivera aktivering av nummer

Kör följande kommandon i CLI för att aktivera aktivering av nummer:

Steg 1: Kör kommandot för nummeraktivitet:

AS_CLI> cd-prenumerantens Mgmt/nummer aktivering

Steg 2: Kör kommandot aktiverade för aktivering:

AS_CLI> ange dnMode gruppOchAnvändaraktivering

Steg 3: Ange Y vid bekräftelseuppmaningen.

För brettmoln

Extraverktyget är integrerat i portalen BroadCloud Service Provider. En tjänsteleverantörsadministratör kan:

1. Skicka in extraförfrågningar för upp till 50 kunder per begäran.
   Begäran om extrakt kan inte skickas in för samma kund mer än 10 gånger per dag.
2. Hämta den extraherade datafilen i ZIP-format i upp till 28 dagar från datumet för inlämning av begäran.

Siffrorna nedan visar tjänsteleverantörsportalen.

Figur 6: Portal för tjänsteleverantör

Figur 7: Portal för tjänsteleverantör

För Cisco BroadWorks och Webex för Broadworks

1. Extraktet körs på den sekundära Cisco BroadWorks-programservern inom partnernätverket och ansluts via OCI-P.
2. Verktyget hämtar råa företagsdata, grupp, nummer, användare, tjänster, enheter och mjukvaruklientens data från Cisco BroadWorks- eller BroadCloud-plattformen och skickar dessa data till XML-filer som tillhandahåller inmatningarna för transformeringsverktyget.

Följande avsnitt beskriver hur du installerar och konfigurerar extraverktyget.

Förutsättningar

1. SCP extraverktygsbinärer till sekundär Cisco BroadWorks-programserver.
2. SSH till den sekundära Cisco BroadWorks-programservern för att konfigurera förutsättningarna och köra extraverktyget.
3. Konfigurera tjänsteleverantör och grupp-ID för att extrahera från Cisco Broad Works i conf/exportTool.yml. Se provet YAML-snippet nedan:

   Tjänsteleverantör-ID-A:      - GruppID-A1 - GruppID-A2 - GruppID-A3-tjänsteleverantör-ID-B:                        - alla 

4. Kontrollera att användar-ID, lösenord och värdnamn för Cisco BroadWorks-programserver är korrekt i filen conf/partner.cfg:

   BROADWORKS_ANVÄNDAR_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = lokaliseringsvärd REFRESH_TOKEN = partneradministratörens uppdateringstoken kopierad från verktyget token Generator. MIGRERING_LÄGE = Värden som stöds är webex_for_broadworks_to_wholesale. Standardvärdet är broadworks_to_wholesale. Använd webex_for_broadworks_to_wholesale för migreringar av Webex för BroadWorks. 

   Egenskapen REFRESH_TOKEN är obligatorisk för migrering av Webex för BroadWorks.

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

   JAVA_HOME=/usr/local/java/java_base

Instruktioner att köra

Kör kommandot nedan på den sekundära Cisco BroadWorks-programservern från katalogen för extraverktyg:

./export.sh

Terminalloggar

Följande loggar är tillgängliga i terminalen vid export: Verktyg för BroadSoft Data Export:

 Running Wide************************************************ Soft Data Export Tool Startar Export Tool v: 1.15.0 Export påbörjad för SP=collabmigrationstest_engg, Grupp=collabmigrationstestGRP_engg Exporterar användare för SP=collabmigrationstest_engg, Grupp=collabmigrationstest_engg GRP Exportera användare som har slutförts för SP=collabmigrationstest_engg, Grupp=collabmigrationstest_engg GRP_engg, Grupp=collabmigrationstest_engg GRP Export slutförd Export Dump Zip Directory : output/20221017223452_Exporteraverktyg Export Dump Zip File name :extracted_data_1666060500618.zip Zip-fil med namnet extracted_data_1666060500618.zip har skapats ZIP-fil skapande process slutförd Exporterade filer konverterade som ZIP-fil ************************************************** 

Produktionen

En utdata-ZIP-fil (extracted_data_.zip) kommer att finnas tillgänglig i samma katalog över extraverktyg. Använd kommandot nedan för att visa och använda ZIP-filen för inmatningen Transform Tool:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 okt  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 okt  4 11:53 exporterajar -rwxr-xr-x 1 bwadmin bwadmin 2635 okt  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 okt  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 17 okt 22:34 utgång/ drwxrwxr-x 2 bwadmin bwadmin 4096 okt 17 22:34 loggar/ -rw-rw-r-- 1 bwadmin bwadmin 46341 okt 17 22:35 extracted_data_1666060500618.zip 

Det här transformatorverktyget körs för alla migreringar. Transformeringsverktyget körs på valfri dator, inklusive en partners administratörsbärare, och använder Webex Public API:er. Den läser ZIP-filen (extracted_data_.zip) som en inmatning och omvandlar den råa XML till ett JSON-format som används av etableringsverktyget.

Förutsättningar

När du har hämtat och extraherat migreringsverktygsbinärer konfigurerar du följande förutsättningar:

1. Ange UPPDATERA_TOKEN (Token kopierad från token Generator Tool) och NAMN_PÅ_MAIN_PLATS i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_AV_MAIN_LOCATION=Main 

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2Nj

   Om du vill få mer fullständig verifiering av kundens e-postadress kan du alternativt ange ETABLERINGS-ID_för etablering.
3. Konfigurera saknade information i input/customers.csv-filen (se nästa avsnitt) om den saknas.
4. Lägg till slutanvändarens e-postadress i inmatnings-/users.csv-filen.
5. Om nya telefoner ska etableras lägger du till Mac-adressen och e-postadressen till användarens nya telefon i inmatnings-/newphones.csv-filen. Detta krävs endast om partneradministratörer vill tillhandahålla nya telefoner i grossistsamtal.
6. Konvertera Broad Works Call Centers till CxEssentials med hjälp av inmatnings-/cxessentials.csv-filen.
7. Du kan även aktivera egenskapen UPPGRADERA_ALLA_CALL CENTER__TO_CX_ESSENTIALS för att konvertera alla samtalscenter till CxEssentials.
8. Använd input/locations.csv-filen för att stödja den stora företagsmigreringen som gör det möjligt för administratörer att migrera kundens platser efter plats
9. Du kan även aktivera användning av MAC-adresser från rubriken User-Agent i SIP REGISTER-meddelandet när MAC-adressen inte är tillgänglig i enhetsprofilen för Cisco BroadWorks. Avkommentera raden "USE_MAC_ADDRESS_FROM_SIP_REGISTER=ja" i filen conf/partner.cfg

Fyll i inmatningen/customers.csv

Filinmatningen/customers.csv ger data som kanske saknas i Cisco Broad Works eller BroadCloud. Den här filen kan lämnas tom om all obligatorisk information redan är tillgänglig. Du behöver inte fylla i alla kolumner, endast den saknade informationen är obligatorisk.

Tabellen nedan beskriver de viktigaste kolumnerna i input/customers.csv.

Instruktioner att köra

Kör Transform-verktyget i valfritt operativsystem. Använd följande steg för att köra verktyget i Windows och MacOS:

Windows

Kör kommandot nedan för att köra Transform-verktyget i Windows:

transform.bat -extract= -kunder= -användare= -newphones=

MacOS

Utför följande steg för att köra transformeringsverktyget på MacOS:

1. Skapa en virtuell miljö och installera beroende för att köra transformeringsverktyget med Python:

   python3 -m venv venv källa venv/bin/aktivera python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. Kör transformatorverktyget:

   ./transform.sh -extract= -kunder= -användare= -newphones=

Förkontroll av kund/användare

Transform-verktyget gör API-samtal till Webex för att fånga potentiella etableringsproblem. Som standard kommer den att validera kundens adress och primära e-postadress. Om PROVISIONING_ID-värdet anges i filen conf/partner.cfg kommer det också att validera platsinformation. Resultaten av förhandskontrollen ingår i undantagsrapporten.

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

förhandskontroll

Förutom att köra förhandskontrollens API för kundinformationen kommer Transform-verktyget också att köra förhandskontrollens API för prenumerantens e-postmeddelanden.

förcheckinformation

Som standard ingår endast förkontrollfel (d.v.s. problem som blockerar etablering) i undantagsrapporten. Om du lägger till den här flaggan kommer även resultaten från förhandskontrollen (t.ex. om det redan finns en Webex-organisation som kan bifogas automatiskt).

Terminalloggar

Följande loggar i terminalen med lyckad omvandling:

Sammanfattningsrapport BroadWorks företag som kan migreras med framgång: 1 StoraFöretag som inte kan migreras: 0 BroadWorks-användare som kan migreras: 4 Broad Works-användare som inte kan migreras: 0 telefoner som kan migreras: 3 telefoner som inte är kompatibla med Webex Calling: 0 

Undantagsrapport

Transform Tool genererar undantagsrapporten i output//exception_report.txt katalogen. Du kan använda den här rapporten för att identifiera de problem som kommer att påverka 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 på nytt Extract- och Transform-verktygen med de nya uppgifterna. Exempelrapportfilen enligt följande:

Undantagsrapport tue okt 18 08:12:09 2022 Företag med Kommunikation Blockeringsfunktion Rekommendation: konfigurera manuellt utgående samtalsplan i Control Hub ________________________________________________________________________________ samtalstest GRP_engg 

Produktionen

En utdata-JSON-fil (customer.json) kommer att finnas tillgänglig i output// katalogen. Exemplet customer.json -filen är följande:

{ "kund": { "etablerings-ID": "!!!!!!!!!!ERSÄTT_med_PROVISIONINGID!!!!!!!!!!", "paket": [ "webex_calling", "common_area_calling" ], "externtID": "external_id_engg_grp1", "adress": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "delstat eller provins": "MD", "postnummer eller postnummer": "20877", "land": "US" }, "kundinformation": { "namn": "Engineering Group - 1", "primäre-post": "amareswaranvel+engineeringgroup1@gmail.com" }, "etableringsparametrar": { "calling": { "plats": { "namn": "Main", "adress": { "adressLine1": "100 Main Street", "adressLine2": "", "city": "Gaithersburg", "delstatEllerProvince": "MD", "zipOrPostal Code": "20877", "land": "US" }, "tidszon": "America/New_York", "språk": "en_us", " nummer": ["+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "huvudnummer": "+15205551101" } } }, "broadworks_info": { "service_provider_id": "SamarbetstestSP_engg", "group_id": "Samarbetstest GRP_engg" }, "prenumeranter": [ { "amareswaranvel+benjaminjack@gmail.com": { "prenumerant": { "kundID": "!!!!!!!!!!ERSÄTT_med_CUSTOMERID!!!!!!!!!!", "e-post": "amareswaranvel+benjaminjack@gmail.com", "paket": "webex_calling", "etableringsparametrar": { "förnamn": "Benjamin", "efternamn": "Jack", "primärttelefonnummer": "+15205551102", "anknytning": "1102" } }, "funktioner": [ { "/v1/people/{personID}/funktioner/röstbrevlåda": { "aktiverad": sant, "skicka upptagnasamtal": { "aktiverat": sant, "hälsning": "DEFAULT" }, "skicka obesvaradesamtal": { "aktiverad": sant, "hälsningsfras": "STANDARD", "antalringar": 3 }, "meddelandelagring": { "mwiaktiverad": true, "storageTyp": "EXTERNAL", "externe-post": "engineering17861@mailnator.com" } } } ], "enheter": [ { "cisUuid": "!!!!!!!!!!REPLACE_MED_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "kundID": "!!!!!!!!!!REPLACE_MED_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling", "etableringsparametrar": { "förnamn": "Lucas", "efternamn": "Oliver", "primärttelefonnummer": "+15205551103", "anknytning": "1103" }, "funktioner": [ { "/v1/people/{personId}/features/röstmail": { "aktiverad": sant, "skicka upptagnasamtal": { "aktiverat": sant, "hälsning": "DEFAULT" }, "skicka obesvaradesamtal": { "aktiverad": sant, "hälsningsfras": "STANDARD", "antalringar": 3 }, "meddelandelagring": { "mwiaktiverad": true, "storageTyp": "EXTERNAL", "externe-post": "engineering16821@mailnator.com" } } } ], "enheter": [ { "cisUuid": "!!!!!!!!!!REPLACE_MED__PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "kundID": "!!!!!!!!!!REPLACE_MED_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "package": "webex_calling", "etableringsparametrar": { "förnamn": "Leo", "efternamn": "Jackson", "primärttelefonnummer": "+15205551104", "anknytning": "1104" }, "funktioner": [ { "/v1/people/{personId}/features/röstmail": { "aktiverad": sant, "skicka upptagnasamtal": { "aktiverat": sant, "hälsning": "DEFAULT" }, "skicka obesvaradesamtal": { "aktiverad": sant, "hälsningsfras": "STANDARD", "antalringar": 3 }, "meddelandelagring": { "mwiaktiverad": true, "storageTyp": "EXTERNAL", "externe-post": "engineeringmacpc@mailnator.com" } } } ], "enheter": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "kundID": "!!!!!!!!!!ERSÄTT_MED_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling", "etableringsparametrar": { "förnamn": "Owen", "efternamn": "Alexander", "primärttelefonnummer": "+15205551101", "anknytning": "1101" } }, "funktioner": [ { "/v1/people/{personid}/features/röstmail": { "aktiverad": sant, "skicka upptagnasamtal": { "aktiverat": sant, "hälsning": "DEFAULT" }, "skicka obesvaradesamtal": { "aktiverad": sant, "hälsningsfras": "STANDARD", "antalringar": 3 }, "meddelandelagring": { "mwiaktiverad": sant, "lagringstyp": "EXTERNT", "externte-postmeddelande": "engineering8811@mailnator.com" } } } ], "enheter": [ { "cisUuid": "!!!!!!!!!!REPLACE_med_PERSONID!!!!!!!!!!", ”produkt”: ”DMS Cisco 8811”, ”mac”: ”F87B204E4066” } ] } } ], ”auto_attendants": [], "call_queues": [], "hunt_groups": [], "scheman": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "namn": "Automatiserad röstportal", "förnamn": "Automatiserad", "efternamn": "Röstportal", "språkkod": "en_us", "telefonnummer": "+15205551105", "anknytning": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": ["PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "platser": [], "webex_for_broadworks_info": { "användare": [ { "id": "Y2lzY28zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTLKNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY63zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY63zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Etableringsverktyget kan köras på valfri dator (partnerns administratörsbärare) och använder Webex offentliga API:er. Den läser JSON-filen (customer.json) som en inmatning och etablering av kunder, platser, nummer, användare, tjänster och enheter i Webex Grossist RTM-lösningen.

Förutsättningar

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

1. Installera Java 8, 11 eller 17 på datorn. Java finns tillgängligt från många källor, bland annat:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. När du har hämtat och extraherat Migreringsverktygsbinärer ställer du in JAVA_HOME-miljövariabeln i provisioning_tool.sh för MAC och provisioning_tool.bat för Windows.
3. Filen partner.cfg:
   • Ange GROSSIST_ETABLERINGS-ID_och UPPDATERA_TOKEN (Token kopieras från token Generator Tool). Partneradministratörer måste kontakta sitt kontoteam för att få ETABLERINGS_ID:

     PARTIHANDEL_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUZJQ1NTEyZTViNzJkOTdj 

   • Ange TILLÅT_ADMIN_INVITE_E-POST att falska om partnern inte vill skicka välkomstmeddelande till användarna. Standardvärdet är sant.

4. Använd WEBEX4BWKS_EMAIL_SUBJECT-egenskapen 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-prenumeranter.
5. Använd WEBEX4BWKS_EMAIL_BODY-egenskapen för Webex för BroadWorks-migreringar för att skicka e-postmeddelandet för begäran om ändring av lösenord för Webex för BroadWorks-prenumeranter.

För BroadCloud-migreringar samma region:

1. Verktyget hoppar över nummer, enheter och tillhandahållande av delade samtalsföreställningar.
2. Verktyget skapar användare och virtuella användare med anknytning och tillfällig anknytning.

För BroadCloud-migreringar en annan region:

1. Verktyget tillhandahåller nummer, enheter och delade samtalsföreställningar.
2. Verktyget skapar användare och virtuella användare med faktiska telefonnummer och anknytning.
   Alla migrationer i Europa BroadCloud är till en annan region.

Instruktioner att köra

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

Windows

Utför följande steg för att köra verktyget på Windows OS:

Så här tillhandahåller du en enskild kund: provision.bat -input= För att tillhandahålla flera kunder: provision.bat -input= 

MacOS

Utför följande steg för att köra verktyget på MacOS:

För att tillhandahålla en enskild kund: ./transform.sh -input= För att tillhandahålla flera kunder: ./transform.sh -input= 

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

Partneradministratörer måste uppdatera sin registreringsmall för BroadWorks för funktioner för samexistens i Webex för Broad Works. Se bilden nedan:

Kör etableringsverktyget med ytterligare ett argument för Webex för BroadWorks till grossistmigrering.

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.

Fas efter migrering: Är den slutliga fasen där administratörer kan konvertera Broad Works till Grossist helt. Du måste köra etableringsverktyget med ett argument efter migrering.

Terminalloggar

Följande är loggarna i terminalen om etableringen har slutförts:

Verktygsnamn: Version av etableringsverktyg: 1.15.0 ********** Påbörjade bearbetningsfil: inmatning/customer.json **************** Etablering kund Väntar på kund external_id_engg_grp1 att slutföra etableringen ... Väntar på att kund external_id_engg_grp1 ska slutföra etableringen ...   Kund external_id_engg_grp1-status: Etablerade etableringsnummer Etableringsanvändare Etablering Användarfunktioner Etableringshälsningar Etableringsscheman Etablering Enheter Etablering Delade samtalsföreställningar Etablering Automatiska deltagare Etablering Samtalsköer Etablering Svarsgrupper Etablering Etablering Samtalsparker Etablering Samtalssökningar Etablering Röstportal ********** Slutförd fil : inmatning/kund.json **************** 

En tabell kommer att skrivas ut med antalet platser som har skapats för varje körning:

Produktionen

Etableringsverktyget genererar framgång- och felrapporter i output/<external_id>/*.framgång/felfiler . Granska utdata och felloggar för att verifiera att etableringen har slutförts.

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

Bild 8: Partnerhubb

Figur 9: Control Hub

Figur 10: Enheter

Bild 11: Ringa

För brettmoln

För BroadCloud-partner använder du tjänsteleverantörsportalen för att skicka in en migreringsbegäran för nummer, enheter och SCA-migreringar.

I tjänsteleverantörsportalen kan en migreringsbegäran innehålla upp till 50 kunder. Högst 10 förfrågningar kan skickas in inom en dag.

Siffrorna nedan visar tjänsteleverantörsportalen.

Figur 12: Portal för tjänsteleverantör

Figur 13: Portal för tjänsteleverantör

För Cisco BroadWorks och Webex för Broadworks

För migreringar av Cisco BroadWorks och Webex för BroadWorks körs verktyget på den sekundära Cisco BroadWorks-programservern inom partnernätverket och ansluts till AS via OCI-P. Den använder Transform Tool output JSON (customer.json)-filen som inmatning och kör OCI-P-kommandon för att migrera enheter och mjukklienter.

Om funktionen är lyckad kommer verktyget för enhetsflyttning att:

1. Avregistrera enheter från Cisco Broad Works och registrera dem i grossistledet.
2. Användare som använder UC-One-klienten omdirigeras till Webex-appen vid första inloggning.
3. Inaktivera telefonnumren från Cisco Broad Works eller ta bort telefonnumren från BroadCloud.
4. Aktivera nummer i grossistledet.
5. Skapa delade samtalsframträdanden i grossistledet för migreringar i BroadCloud. [Det här steget gäller endast migreringar i BroadCloud].

SCP och SSH

1. SCP-verktyget för att flytta enheten till den sekundära Cisco BroadWorks-programservern.
2. SSH till den sekundära Cisco BroadWorks-programservern för att konfigurera förutsättningarna och köra verktyget för enhetsflyttning.

Förutsättningar

1. Ange UPPDATERA_TOKEN (token kopierad från token Generator Tool) i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJk

2. Kontrollera att det sekundära användar-ID, lösenord och värdnamn för Cisco BroadWorks-programservern är korrekt i filen conf/deviceMoveTool.conf:

   BROADWORKS_ANVÄNDAR_ID = admin BROADWORKS_LÖSENORD = admin BROADWORKS_HOST_NAME = lokaliseringsvärd 

3. Kontrollera att sökvägen för JDK/JRE-miljön är korrekt i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. Administratörer kan använda location.csv-filen från inmatningskatalogen för att migrera specifika grupper istället för alla grupper under ett företag.

Polykomtelefoner

För att flytta Polycom-telefoner från Cisco BroadWorks till grossistsamtal måste en partneradministratör skapa en ny identitets-/enhetsprofiltyp på systemnivå i Cisco Broadvarje Polycom-enhetsmalle. Se figur 14 och ladda upp den anpassade filfilen device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. När du har laddat upp den nya enhetsfilen ska du se till att den nyligen skapade filen finns på gruppnivå. Se också till att file migration_%BWMAC ADDRESS%.cfg inte är i konflikt med någon befintlig fil i ditt system).

Den används internt av verktyget för att flytta enheten.

Migreringsprocessen för Polycom-telefoner:

1. Verktyget för enhetsflyttning ersätter fil %BWMACADDRESS%.cfg på enhetsnivå med polycom_vvx2.cfg. Observera att den här filen avser migration_%BWMACADDRESS%.cfg.
2. Återskapa enhetsprofilerna på gruppnivå eller enhetsnivå.
   Om du agerar på gruppnivå eller enhetsnivå beror på konfigurationen av parameterenhetsnivåRebuild-up in file device-move-tool/conf/partner.cfg.
3. Verktyget för enhetsflyttning ber Cisco BroadWorks-programservern att starta om telefoner på gruppnivå eller enhetsnivå.
4. Efter begäran om omstart hämtar Polycom-telefoner och bearbetar% BWMACADDRESS%.cfg, som ber Polycom-telefonerna att hämta och process migration_%BWMACADDRESS%.cfg, som ställer in enheten.prov.serverNamn till https://plcm.sipflash.com.
   https://plcm.sipflash.com för den amerikanska regionen har andra regioner olika URL:er.
5. Polycom-telefonen hämtar %BWMACADDRESS%.cfg från https://plcm.sipflash.com och hanteras av Webex Calling DMS.

Bild 14: Lägg till identitets-/enhetsprofiltyp

Instruktioner 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 genom flera kunder samtidigt.

Verktyget för enhetsflyttning körs från den sekundära Cisco BroadWorks-programservern i katalogen för enhetsflyttning:

För enhetsflytta enkel kund: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json För enhetsflytta flera kunder: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json kund2.json kund3.json Dessutom har verktyget för enhetsflyttning stöd för migrering av enskilda/specifika telefoner från version 1.35.0. Använd kommandot nedan: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminalloggar

Följande är loggarna i terminalen vid körning av verktyget för enhetsflyttning för enhetsmigrering:

Verktygsnamn: Version av verktyg för enhetsflytta: 1.15.0 Enhetsverktyget har startats ... Giltiga enheter för migrering: ------------------------------------------------------------------------------------------------------------------- | Enhetstyp | Mac | Version | E-post | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | cc98914eaad7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5486bcae7e45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | f87b204e4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Vill du migrera alla dessa enheter? ([Y]es eller [N]o) ja Uppladdning av enhetsprofiler för DMS Cisco MPP LC Rebuild Enhetsprocess Started Reboot Process Started Reboot Process Completed Modified Profiles for Business Communicator under samarbetstest_engg Aktivera processen Webex-telefonnummer som har påbörjats för kundens organisations-ID: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktivera processen för Webex-telefonnummer slutförd för kundens org-ID: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Inaktivera processen för broadworks-telefonnummer påbörjad för gruppID: collabmigrationstest GRP_engg Inaktivera processen för broadworks-telefonnummer slutförd för grupp-ID: collabmigrationstest GRP_engg Enhetsmigrering har slutförts 

Produktionen

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

Figur 15: Enhetsstatus

Efter enhetsmigreringen har nummer aktiverats. Se figur 16 för att se ett exempel på hur nummer är aktiva:

Figur 16: Nummer aktiva

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

För BroadCloud Carrier

Återställningsprocessen för BroadCloud-partner är följande:

1. Öppna ett ärende med Cisco TAC för att begära att enheten återställs.
2. Kör verktyget för enhetsflyttning i återställningsläge:
   • Telefonnummer kommer att tas bort från Webex Calling, vilket lämnar användare och tjänster endast med anknytningar.
   • E-postadresser i Webex Calling återställs till tillfälliga e-postadresser.
   • Telefoner kommer att tas bort från Webex Calling.
   • Telefonnummer, e-postadresser som används som alternativaID och telefoner kommer att återskapas i BroadCloud.
   • Telefoner startas om.
3. Partneradministratörer måste flytta PSTN-telefonnummer tillbaka till BroadCloud Carrier.

För Cisco BroadWorks och Webex för Broadworks

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

1. Öppna ett ärende med Cisco TAC för att begära att enheten återställs.
2. Kör verktyget för enhetsflyttning i återställningsläge på den sekundära BroadWorks-programservern för att återställa enhetsmigreringar. Då återställs DMS-URL till tjänsteleverantörens DMS-URL för enhetsprofiler i Cisco Broad Works och återaktivera telefonnummer.
3. Webex Calling-teamet återställer DMS-URL till tjänsteleverantörens DMS-URL i enhetsprofiler i Webex Calling.
4. Partneradministratörer måste inaktivera eller ta bort telefonnumren i Webex Calling via Control Hub-portalen.
5. Partneradministratörer måste flytta PSTN-telefonnummer tillbaka till Cisco BroadWorks.

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

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

Kör kommandot nedan på den sekundära Cisco BroadWorks-programservern i katalogen för enhetens flyttverktyg:

Återställ profiler

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -återställ profiler

Återställ nummer

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -återställ nummer

Terminalloggar

Vi får följande loggar i terminalen när verktyget för enhetsflyttning för återställning körs:

Återställ profiler

Verktygsnamn: Version av verktyg för enhetsflytta: 1.15.0 Enhetsverktyg startade för återställningsprocessen ... Enheter som kan flyttas tillbaka från Webex Calling till Broadfungerar: - ------------------------------------------------------------------------------------------------------------------- | Enhetstyp | Mac | Version | E-post | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | cc98914eaad7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5486bcae7e45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | f87b204e4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Vill du flytta tillbaka dessa enheter från Webex Calling till BroadWorks? (Ja, Y, Nej, N):  ja Uppladdning av enhetsprofiler för DMS Cisco MPP LC Rekonstruktion av enhetsprocess påbörjad Rekonstruktion av enhetsprocess slutförd Omstartaprocess påbörjad Omstartaprocess slutförd Enhetsmigrering slutförd för avskaffningsprocessen slutförd 

Återställ nummer

Verktygsnamn: Version av verktyg för enhetsflytta: 1.15.0 Vill du fortsätta att återställa nummer till Broadworks?  ([Y]es eller [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Starta återställning Aktivera broadworks-telefonnummerprocessen påbörjad för gruppId : collabmigrationstest GRP_engg Aktivera processen för broadworks-telefonnummer slutförd för grupp-ID: collabmigrationstest GRP_engg – återställningsprocess för enhetsmigrering slutfördes