Telefoner som stöds skapas automatiskt och tilldelas till användare i Webex Calling av etableringsverktyget. Telefoner som är markerade ”Ja” i kolumnen ”Stöds i verktyget för enhetsflytt” flyttas också automatiskt från Cisco BroadWorks eller BroadCloud till Webex Calling när verktyget för enhetsflytt körs. Telefoner som är markerade ”Nej” i den kolumnen behöver en manuell åtgärd 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 på newphones.csv).

Partneradministratörer kör det här verktyget för tokengenerator minst en gång innan de börjar köra migreringsverktygen. Att köra det här verktyget är en engångsaktivitet när partnerkontot har registrerats i grossisthandelns RTM-lösning. 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

När du har hämtat migreringsverktyget extraherar du binärfiler.

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/Contents/Home/"

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

Anvisningar för körning

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

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Utgång:

Verktygsnamn: Version av token generator verktyg: 1.13.0 Läs in URL:en i webbläsaren: http://localhost:8080 

Öppna URL:en i webbläsaren på terminalen, logga in med inloggningsuppgifterna för partneradministratören för att få TOKEN och kopiera samma för vidare användning.

Illustrationerna i användargränssnittet ges nedan som referens:

Figur 3: Logga in med Cisco Webex

Figur 4: Fönster för autentiseringsuppgifter

Figur 5: Generering av token

Konfigurera följande steg innan du kör verktygen för extrakt och enhetsflytt i den sekundära BroadWorks-servern.

Aktivera OCI-P-anslutning

Verktyget för enhetsflytt kommunicerar med BroadWorks via OCI-P-kommandon. För att aktivera OCI-P-anslutning använder du 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 till GeneralSettings-katalogen:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

Om inställningarna inte stämmer överens med ovanstående använder du kommandot set för att konfigurera om inställningarna.

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

Ändra katalogen till OCI-proxy:

AS_CLI> cd/program/OpenClientServer/OCIProxy

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 enabled = true enabledLoginLevelScreening = false enableResponseCaching = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 meddelandeKöKapacitet = 50 meddelandeKöTimeoutSeconds = 1800 

Om inställningarna inte stämmer överens med ovanstående använder du kommandot set för att konfigurera om inställningarna.

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

Ändra till etableringskatalogen:

AS_CLI> cd/System/NetworkAccessLists/OCI/Provisioning

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> hämta adressbeskrivning ======================== 127.0.0.1 lokalt som 

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

 AS_CLI/Maintenance/ManagedObjects> få broadworks och kontrollera att utdata ser OK ut. Se nedan för exempelutmatning: AS_CLI/Maintenance/ManagedObjects> hämta broadworks BroadWorks-hanterade objekt ========================== * Server: Identitet..............: AS-version...............: Rel_21.sp1_1.551 Administrativ status..: Upplåst * Program: Namnversion distribuerad Administrativt tillstånd Effektivt ========================================================================================= utförandeOch etablering 21.sp1_1.551 sant Olåst Olåst FlashPolicy 21.sp1_1.551 falskt Olåst Stoppad OpenClientServer 21.sp1_1.551 sant Olåst Olåst WebContainer 21.sp1_1.551 sant Olåst Olåst 4 poster hittades. * Värdprogram: Namn Version Kontext Sökväg Distribuerad ================================================================== 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 poster hittades. 

Verifiera att klientservern är distribuerad och aktiv

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

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

AS_CLI/Maintenance/ManagedObjects> distribuera OpenClientServer-program

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

AS_CLI/Maintenance/ManagedObjects> starta programmet OpenClientServer

Aktivera aktivering av nummer

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

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

AS_CLI> cd-prenumerantMgmt/NumberActivation

Steg 2: Kör det aktiveringsaktiverade kommandot:

AS_CLI> ställ in dnMode gruppAndUserActivationEnabled

Steg 3: När du blir uppmanad att bekräfta anger du Y.

För BroadCloud

Extraheringsverktyget är integrerat i BroadCloud tjänsteleverantörsportalen. En tjänsteleverantörsadministratör kan:

1. Skicka extraheringsförfrågningar för upp till 50 kunder per begäran.
   Extraheringsbegäran kan inte skickas för samma kund mer än 10 gånger per dag.
2. Hämta den utökade datafilen, i ZIP-format, i upp till 28 dagar från inlämningsdatumet för begäran.

Siffrorna nedan visar tjänsteleverantörsportalen.

Figur 6: Tjänsteleverantörsportal

Figur 7: Tjänsteleverantörsportal

För Cisco BroadWorks och Webex för BroadWorks

1. Extraheringsverktyget körs på den sekundära Cisco BroadWorks-programservern i partnernätverket och ansluter via OCI-P.
2. Verktyget hämtar råvarudata för företag, grupper, nummer, användare, tjänster, enheter och klienter från Cisco BroadWorks- eller BroadCloud-plattformen och matar ut dessa data till XML-filer som ger inmatningar för transformeringsverktyget.

Följande avsnitt förklarar hur du installerar och konfigurerar extraheringsverktyget.

Förutsättningar

1. SCP extraheringsverktyget binärkoder 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 extraheringsverktyget.
3. Konfigurera tjänsteleverantören och grupp-ID för att extrahera från Cisco BroadWorks i conf/exportTool.yml. Se nedanstående exempel på YAML-fragment:

   Tjänsteleverantörs-ID-A:      - GruppID-A1 - GruppID-A2 - GruppID-A3 TjänsteleverantörsID-B:                        - alla 

4. Kontrollera att användar-ID, lösenord och värdnamn för den sekundära Cisco BroadWorks-programservern är korrekta i filen conf/partner.cfg:

   BROADWORKS_ANVÄNDAR_ID = admin BROADWORKS_LÖSENORD = admin BROADWORKS_VÄRD_NAMN = lokal VÄRDUPPDATERING_TOKEN = partneradministratörens uppdateringstoken som kopierats från tokengeneratorn. MIGRERINGSLÄ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 Webex för BroadWorks-migreringar. 

   Egenskapen UPPDATERINGSTOKEN_ är obligatorisk för en Webex för BroadWorks-migrering.

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

   JAVA_HOME=/usr/local/java/java_base

Anvisningar för körning

Kör kommandot nedan i den sekundära Cisco BroadWorks Application Server från katalogen med extraheringsverktyget:

./export.sh

Terminalloggar

Följande loggar är tillgängliga i terminalen efter lyckad export: Kör BroadSoft-dataexportverktyg:

 Kör BroadSoft-dataexportverktyg ************************************************ Starta exportverktyg v: 1.15.0 Export påbörjad för SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportera användare för SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportera användare slutförda för SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export slutförd för SP=collabmigrationtest_engg, Grupp=collabmigrationtestGRP_engg Export slutförd Exportera dumpad zip-katalog : output/20221017223452_ExportTool Export Dump Zip-filnamn:extracted_data_1666060500618.zip Zip-fil med namnet extracted_data_1666060500618.zip har skapats ZIP-filprocessen har slutförts Exporterade filer konverteras som ZIP-filer ************************************************** 

Produktionen

En ZIP-fil (extracted_data_.zip) kommer att finnas tillgänglig i samma katalog med extraheringsverktyg. Använd kommandot nedan för att visa och använda ZIP-filen för indata i transformationsverktyget:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 okt  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 okt  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 okt  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 okt  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 okt 17 22:34 output/ 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 transformeringsverktyget körs för alla migreringar. Transformeringsverktyget körs på alla datorer, inklusive en partners administratörs bärbara dator, och använder Webex offentliga API:er. Extraheringsverktyget läser ut ZIP-filen (extracted_data_.zip) som en indata och omvandlar den obehandlade XML-filen till ett JSON-format som används av etableringsverktyget.

Förutsättningar

När du har hämtat och hämtat migreringsverktygens binärkoder konfigurerar du följande förutsättningar:

1. Ställ in UPPDATERINGSTOKEN_ (token kopierad från token generator-verktyget) och NAMNET_PÅ_HUVUDPLATSEN_ i filen conf/partner.cfg:

   UPPDATERA_TOKEN=MzDinYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAMN_ELLER_HUVUD_PLATS=Huvud 

2. Ange RESERVERINGEN_ID (kopierat från mallen i Partner Hub) i filen conf/partner.cfg:

   ETABLERING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   För att få en mer fullständig verifiering av kundens e-postadress kan du välja att ange ETABLERINGS-ID:t_.
3. Konfigurera information som saknas 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 tillhandahållas lägger du till Mac-adressen och e-postadressen för användarens nya telefon i filen input/newphones.csv. Detta krävs endast om partneradministratörerna vill tillhandahålla nya telefoner i grossistsamtal.
6. Konvertera BroadWorks-samtalscentraler till CxEssentials genom att använda filen input/cxessentials.csv.
7. Du kan även aktivera egenskapen UPPGRADERA_ALLA_SAMTALSCENTER__TILL_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 sina kunders platser efter plats
9. Aktivera alternativt 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 ”ANVÄND_MAC_ADRESS_FRÅN_SIP_REGISTER=ja” i filen conf/partner.cfg

Fylla i indata/kunder.csv

Filinmatningen/customers.csv innehåller data som kanske saknas i Cisco BroadWorks 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, bara den information som saknas är obligatorisk.

I tabellen nedan beskrivs de viktigaste kolumnerna i input/customers.csv.

Anvisningar för körning

Kör transformeringsverktyget i valfritt operativsystem. Använd nedanstående 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= -customers= -users= -newphones=

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 omvandlingsverktyget med Python:

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

2. Kör transform-verktyget:

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

Förhandskontroll av kund/användare

Transformeringsverktyget ringer API-samtal till Webex för att fånga potentiella etableringsproblem. Som standard valideras kundens adress och primära e-postadress. Om TILLHANDAHÅLLANDET_ID-värdet anges i filen conf/partner.cfg, det validerar även platsinformation. Resultaten av förkontrollen ingår i undantagsrapporten.

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

förkontroll

Förutom att köra förhandskontroll-API för kundinformation kommer Transform-verktyget även att köra förhandskontroll-API för prenumerantens e-postmeddelanden.

förhandskontrollinformation

Som standard inkluderas endast förhandskontrollfel (dvs. problem som blockerar etablering) i undantagsrapporten. Om du lägger till den här flaggan inkluderas även lyckade förhandskontrollresultat (t.ex. om det redan finns en Webex-organisation som kan bifogas automatiskt).

Terminalloggar

Följande loggar i terminalen vid lyckad omvandling:

Sammanfattningsrapport för BroadWorks-företag som kan migreras: 1 BroadWorks-företag som inte kan migreras: 0 BroadWorks-användare som kan migreras: Fyra BroadWorks-användare som inte kan migreras: 0 Telefoner som kan migreras: 3 Telefoner som inte är kompatibla med Webex Calling: 0 

Undantagsrapport

Transform-verktyget genererar undantagsrapporten i katalogen output//exception_report.txt . Du kan använda den här rapporten för att identifiera 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 verktyget Extrahera och omvandla igen med de nya uppgifterna. Exempelrapportfilen enligt följande:

Undantagsrapport tis 18 okt 08:12:09 2022 Rekommendation för företag med kommunikationsspärrar: konfigurera den utgående samtalsplanen manuellt i Control Hub ________________________________________________________________________________ samtalsmigreringstestGRP_engg 

Produktionen

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

{"kund": {"provisioningId": "!!!!!!!!!!ERSÄTT_med_PROVISIONINGID!!!!!!!!!!", "paket": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "adress": { "addressLine1": "100 Main Street", "addressLine2": "", "stad": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "US" }, "kundinformation": { "namn": "Teknikgrupp - 1", "primaryE-post": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "plats": { "namn": "huvud", "adress": { "addressLine1": "100 Main Street", "addressLine2": "", "stad": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "US" }, "tidszon": "Amerika/New_York", "språk": "en_us", "nummer": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551108", "+15205551109", "+15205551110" ], "huvudnummer": "+15205551101" } } }, "broadworks_info": {"service_provider_id": "samverkande migreringstestSP_engg", "group_id": "samverkande migreringstestGRP_engg" }, "prenumeranter": [ { "amareswaranvel+benjaminjack@gmail.com": { "prenumerant": { "kundId": "!!!!!!!!!!ERSÄTT_med_CUSTOMERID!!!!!!!!!!", "e-post": "amareswaranvel+benjaminjack@gmail.com", "paket": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "efternamn": "Jack", "primaryPhoneNumber": "+15205551102", "anknytning": "1102" } }, "funktioner": [ { "/v1/people/{personId}/features/röstbrevlåda": { "aktiverad": sant, ”sendBusyCalls”: { ”aktiverad”: sant, "hälsning": "STANDARD" }, "sendUnansweredCalls": { "aktiverad": sant, ”hälsning”: ”STANDARD”, ”numberOfRings”: 3 }, ”messageStorage”: { ”mwiEnabled”: sant, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "enheter": [ { "cisUuid": "!!!!!!!!!!ERSÄTT_MED_PERSONNUMMER!!!!!!!!!!", "produkt": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "prenumerant": { "customerId": "!!!!!!!!!!ERSÄTT_MED_CUSTOMERID!!!!!!!!!!", "e-post": "amareswaranvel+lucasoliver@gmail.com", "paket": "webex_calling", "provisioningParameters": { "firstName": "Lucas", "efternamn": "Oliver", "primaryPhoneNumber": "+15205551103", "anknytning": "1103" } }, "funktioner": [ {"/v1/people/{personId}/features/voicemail": { "aktiverad": sant, ”sendBusyCalls”: { ”aktiverad”: sant, "hälsning": "STANDARD" }, "sendUnansweredCalls": { "aktiverad": sant, ”hälsning”: ”STANDARD”, ”numberOfRings”: 3 }, ”messageStorage”: { ”mwiEnabled”: sant, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "enheter": [ { "cisUuid": "!!!!!!!!!!ERSÄTT_MED_PERSONNUMMER!!!!!!!!!!", "produkt": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "abonnent": { "customerId": "!!!!!!!!!!ERSÄTT_MED_CUSTOMERID!!!!!!!!!!", "e-post": "amareswaranvel+leojackson@gmail.com", "paket": "webex_calling", "provisioningParameters": { "firstName": "Leo", "efternamn": "Jackson", "primaryPhoneNumber": "+15205551104", "anknytning": "1104" } }, "funktioner": [ {"/v1/people/{personId}/features/voicemail": { "aktiverad": sant, ”sendBusyCalls”: { ”aktiverad”: sant, "hälsning": "STANDARD" }, "sendUnansweredCalls": { "aktiverad": sant, ”hälsning”: ”STANDARD”, ”numberOfRings”: 3 }, ”messageStorage”: { ”mwiEnabled”: sant, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "enheter": [] } }, { "amareswaranvel+owenalex@gmail.com": { "prenumerant": { "customerId": "!!!!!!!!!!ERSÄTT_MED_CUSTOMERID!!!!!!!!!!", "e-post": "amareswaranvel+owenalex@gmail.com", "paket": "webex_calling", "provisioningParameters": { "firstName": "Owen", "efternamn": "Alexander", "primaryPhoneNumber": "+15205551101", "anknytning": "1101" } }, "funktioner": [ {"/v1/people/{personId}/features/voicemail": { "aktiverad": sant, ”sendBusyCalls”: { ”aktiverad”: sant, "hälsning": "STANDARD" }, "sendUnansweredCalls": { "aktiverad": sant, ”hälsning”: ”STANDARD”, ”numberOfRings”: 3 }, ”messageStorage”: { ”mwiEnabled”: sant, ”storageType”: ”EXTERN”, ”externalEmail”: ”engineering8811@mailnator.com” } } } ], ”enheter”: [ { ”cisUuid”: "!!!!!!!!!!ERSÄTT_med_PERSONLIGT ID!!!!!!!!!!", "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 - Enhetsprofil för Engg" ], "connect_client_to_upgrade_to_webex_app": [], "platser": [], "webex_for_broadworks_info": { "användare": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Etableringsverktyget kan köras på valfri dator som vanligtvis är (partnerns administratörs bärbara dator) och använder Webex offentliga API:er. Den läser JSON-filen för transformationsverktyget (customer.json) som en inmatning och etablering av kunder, platser, nummer, användare, tjänster och enheter i Webex RTM-lösning för grossist.

Förutsättningar

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

1. Installera Java 8, 11 eller 17 på datorn. Java är 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 hämtat migreringsverktygens binärkoder 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:
   • Ställ in GROSSIST_ETABLERINGS-ID_ och UPPDATERINGSTOKEN_ (token kopierades från tokenverktyget). Partneradministratörerna måste kontakta sitt kontoteam för att få ETABLERINGS-ID:t_:

     GROSSISTETABLERING__ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 UPPDATERING_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Ställ in TILLÅT_ADMINISTRATÖRSINBJUDNINGAR__som falskt om partnern inte vill skicka välkomstmeddelanden till användarna. Standardvärdet är sant.

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

För BroadCloud-migreringar samma region:

1. Verktyget hoppar över tillhandahållande av nummer, enheter och utseende för delade samtal.
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 utseende för delade samtal.
2. Verktyget skapar användare och virtuella användare med faktiska telefonnummer och anknytning.
   Alla BroadCloud-migreringar i Europa är till en annan region.

Anvisningar för körning

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:

Så här tillhandahåller du en kund: ./transform.sh -input= Så här tillhandahåller du flera kunder: ./transform.sh -input= 

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

Partneradministratörer måste uppdatera sin BroadWorks-mall för registrering av Webex för BroadWorks-funktioner för samexistens. Se följande bild:

När Webex för BroadWorks-registreringsmallen har uppdaterats för att stödja migrering ber du Ciscos kontoteam att aktivera funktionsväxlingen ”grossist-partner-blending-enabled” på partnernivå. Detta gör det möjligt att lägga till grossistpaket i befintliga Webex för BroadWorks-kundorganisationer under provisioneringen.

Kör etableringsverktyget med ett ytterligare argument.

Förberedelsefas: är standardfasen där administratörer kan etablera 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 sista fasen när administratörer kan konvertera BroadWorks till grossist helt. Du måste köra etableringsverktyget med ett argument efter migrering.

Terminalloggar

Följande loggar i terminalen när etableringen har slutförts:

Verktygsnamn: Version av etableringsverktyg: 1.15.0 ********** Påbörjad bearbetning av filen: input/customer.json **************** Etableringskund Väntar på att kund external_id_engg_grp1 ska slutföra etableringen ... Väntar på att kund external_id_engg_grp1 ska slutföra reserveringen ...   Status external_id_engg_grpför kund 1: reserverade provisioneringsnummer Reservering användare Reservering användarfunktioner Reservering hälsningar Reservering scheman Reservering enheter Reservering delade samtal Reservering autoassistenter Reservering samtalsköer Reservering sökgrupper Reservering gruppsökning Reservering samtalsparkeringar Reservering samtalssvar Reservering röstportal ********** Slutförd fil: input/customer.json **************** 

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

Produktionen

Etableringsverktyget genererar lyckade rapporter och felrapporter i output/<external_id>/*.success/error -filerna. Granska lyckade utdata och felloggar för att verifiera lyckad reservering.

Partneradministratörer kan verifiera kundetableringen i Partner Hub och Control Hub-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 BroadCloud

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

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

Siffrorna nedan visar tjänsteleverantörsportalen.

Figur 12: Tjänsteleverantörsportal

Figur 13: Tjänsteleverantörsportal

För Cisco BroadWorks och Webex för BroadWorks

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

När åtgärden lyckas gör verktyget för enhetsflytt följande:

1. Avregistrera enheter från Cisco BroadWorks och registrera dem i grossist.
2. Användare som använder UC-One-klienten omdirigeras till Webex-appen vid första inloggningen.
3. Inaktivera telefonnummer från Cisco BroadWorks eller ta bort telefonnummer från BroadCloud.
4. Aktivera nummer i grossisten.
5. Skapa utseende för delade samtal i grossist för BroadCloud-migreringar. [Det här steget gäller endast för BroadCloud-migreringar].

SCP och SSH

1. SCP verktyget för enhetsflytt 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 enhetsflytt.

Förutsättningar

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

   REFRESH_TOKEN=MzDinYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_ANVÄNDAR-ID_ = admin BROADWORKS_LÖSENORD = admin BROADWORKS_VÄRD_NAMN = lokal värd 

3. Om du vill skicka aktiveringsmeddelanden på nytt måste du ställa in SKICKA NY_INBJUDAN_E-POSTMEDDELANDEN=true i filen conf/partner.cfg.

   Om administratörer vill skicka e-postinbjudningar till sina användare under migreringen ska de avkommentera egenskapen ”SKICKA NY_INBJUDAN_E-POSTMEDDELANDEN=true” i filen conf/partner.cfg. I annat fall ska fastigheten förbli oförändrad.

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom-telefoner

För att flytta Polycom-telefoner från Cisco BroadWorks till grossistsamtal måste en partneradministratör skapa en ny fil för identitet/enhetsprofil 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 överfört den nya enhetsfilen ska du se till att den nyligen skapade filen finns på gruppnivå. Kontrollera också att filen migration_%BWMAC ADDRESS%.cfg inte står i konflikt med någon befintlig fil i systemet).

Det används internt av verktyget för enhetsflytt.

Migreringsprocessen för Polycom-telefoner:

1. Verktyget för enhetsflytt ersätter filen %BWMACADDRESS%.cfg på enhetsnivå med polycom_vvx2.cfg. Den här filen hänvisar till migration_%BWMACADDRESS%.cfg.
2. Återskapa enhetsprofilerna på gruppnivå eller enhetsnivå.
   Åtgärder på gruppnivå eller enhetsnivå beror på konfigurationen av parametern deviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Verktyget för enhetsflytt ber Cisco BroadWorks-programservern att starta om telefoner på grupp- eller enhetsnivå.
4. Efter omstartsbegäran hämtar och bearbetar Polycom-telefoner% BWMACADDRESS%.cfg, som ber Polycom-telefonerna att hämta och bearbeta migration_%BWMACADDRESS%.cfg, vilket ställer in device.prov.serverName på 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 kommer att hanteras av Webex Calling DMS.

Bild 14: Lägg till fil med identitets-/enhetsprofiltyp

Anvisningar för körning

Det finns två sätt att starta DMT: den första är att starta via en enda kund åt gången och den andra är att köra genom flera kunder samtidigt.

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

För enhetsflytta en kund: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json För enhetsflytta flera kunder: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Dessutom stöder enhetsflyttverktyget migrering av enskilda/specifika telefoner från utgåvor 1.35.0. Använd kommandot nedan: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminalloggar

Följande loggar i terminalen när verktyget för enhetsmigrering har körts:

Verktygsnamn: Version av verktyget för enhetsflytt: 1.15.0 Enhetsverktyget har startat ... 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 Överföring av enhetsprofiler för DMS Cisco MPP LC Rebuild-enhetsprocess startad Rebuild-enhetsprocess slutförd Omstartsprocess påbörjad Omstartsprocess slutförd Ändring av profiler för Business Communicator under gruppmigreringtestGRP_engg Aktivera Webex-telefonnummerprocess startad för kundens organisations-ID: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktivering av processen för Webex-telefonnummer har slutförts för kund organisations-ID: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Inaktivera processen för BroadWorks-telefonnummer startad för gruppId: kollabmigreringstestGRP_engg Inaktivering av process för broadworks-telefonnummer slutförd för gruppId: kollabortmigreringstestGRP_engg -enhetsmigrering slutförd 

Produktionen

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

Figur 15: Enhetsstatus

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

Figur 16: Aktiva nummer

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

För BroadCloud-operatör

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

1. Öppna ett ärende med Cisco TAC för att begära en enhetsåterställning.
2. Kör verktyget för enhetsflytt i återställningsläge:
   • Telefonnummer kommer att tas bort från Webex Calling, vilket gör att användare och tjänster endast har anknytningar.
   • E-postadresser i Webex Calling återgår till tillfälliga e-postadresser.
   • Telefoner kommer att tas bort från Webex Calling.
   • Telefonnummer, e-postadresser som används som alternatedId och telefoner kommer att återskapas i BroadCloud.
   • Telefoner kommer att startas om.
3. Partneradministratörer måste flytta tillbaka PSTN-telefonnummer till BroadCloud-nätoperatören.

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 en enhetsåterställning.
2. Kör verktyget för enhetsflytt i återställningsläge på den sekundära BroadWorks-programservern för att återställa enhetsmigreringarna. Detta ställer in DMS-URL:en tillbaka till tjänsteleverantörens DMS-URL för enhetsprofiler i Cisco BroadWorks och återaktiverar telefonnummer.
3. Webex Calling-teamet ställer tillbaka DMS-URL:en 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 tillbaka PSTN-telefonnummer till Cisco BroadWorks.

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

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

Kör kommandot nedan i den sekundära Cisco BroadWorks Application Server i katalogen med verktyget för enhetsflytt:

Återställ profiler

./devicemove.sh -input=  -revertProfiler

Återställ nummer

./devicemove.sh -input=  -revertNumbers

Terminalloggar

Vi får följande loggar i terminalen när enhetsflyttningsverktyget för återställningsåtgärden har körts:

Återställ profiler

Verktygsnamn: Version av verktyget för enhetsflytt: 1.15.0 Enhetsverktyg startat för återställningsprocessen ... Enheter som kan flyttas tillbaka från Webex Calling till BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | 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 Återskapa enhetsprocess startad Återskapa enhetsprocess slutförd Starta om process slutförd Enhetsmigrering slutförd för avetableringsprocess 

Återställ nummer

Verktygsnamn: Version av verktyget för enhetsflytt: 1.15.0 Vill du fortsätta att återställa nummer till BroadWorks?  ([Y]är eller [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Startar återställning Aktivera BroadWorks-telefonnummerprocess startad för gruppId: kollabmigration testGRP_engg Aktivering av process för broadworks-telefonnummer slutförd för gruppId: sammigreringstestGRP_engg återställningsprocess för enhetsmigrering har slutförts