Översikt

Syftet med detta dokument är att ge detaljerade anvisningar om hur du använder verktyg för att migrera från Cisco BroadWorks, Webex för BroadWorks och BroadCloud till grossist och Webex Calling. Det här dokumentet omfattar en uppsättning migreringsverktyg som har utformats för att hjälpa till att migrera befintliga Cisco BroadWorks, Webex för BroadWorks och BroadCloud-kunder till lösningen Route-to-Market i grossistledet.

Migreringsverktygen är avsedda att underlätta en fullständig övergång från BroadWorks till Grossist. De är inte utformade för långsiktig samexistens mellan båda tjänsterna inom samma kundorganisation.

Inverkan på migreringen

Följderna efter migreringen är följande:

Administratörer

Efter migreringen måste administratörer:

  • Börja använda Partner Hub och Control Hub för att konfigurera funktioner istället för CommPilot.
  • Konfigurera om alla funktioner som inte ingår i migreringen.
    Du måste migrera funktionerna manuellt som inte migreras automatiskt efter att migreringsverktygen har slutförts.

Användare

Funktioner som stöds bör fungera efter migreringen på samma sätt som de fungerade före migreringen. Webex Calling-funktioner som inte stöds av migreringen måste konfigureras om på Webex efter migreringen:

  • Användare förlorar sin samtalshistorik och meddelandehistorik.
  • Användare förlorar alla inställningar och anpassningar för personliga knapplinjer och måste konfigurera om dessa inställningar efter migreringen. Exempel är kortnummer.
  • Användare måste återställa sina åtkomstkoder och lösenord vid första inloggningen.
  • Användare som använder UC-One-klienten måste vid första inloggningen uppgradera till Webex-appen.

Migreringsverktygsarkitektur

Migreringsverktygsarkitekturen består av fyra olika verktyg:

  1. Extraverktyg – Extraherar företag, grupper, nummer, användare, tjänster, telefoner och mjukvaruklienter från Cisco BroadWorks. BroadCloud-partner måste skicka in en extrabegäran i tjänsteleverantörsportalen.
  2. Transform-verktyg – Omvandlar informationen som extraheras av extraktet till en JSON-fil som kan redigeras.
  3. Etableringsverktyg – Använder JSON-utgångsfilen från Transform-verktyget för att tillhandahålla kunder, platser, nummer, användare, tjänster och telefoner med Webex offentliga API:er.
  4. Verktyg för enhetsflyttning – Använder JSON-utgångsfilen för Transform Tool för att återställa profiler och starta om telefoner, aktivera nummer i RTM-lösningen för grossistföretag och inaktivera telefonnummer i Cisco BroadWorks.
    • Det här verktyget har stöd för att återställa telefon- och mjuka klientprofiler och nummeraktivering i Cisco BroadWorks.
    • BroadCloud-partner måste skicka in en migreringsbegäran i tjänsteleverantörsportalen.

Följande illustration visar hur de fyra verktygen fungerar i följd genom att kommunicera med Cisco BroadWorks, offentliga API:er och överföra värden till Webex-tjänsterna för framtida analyser efter att administratören har startat migreringsuppgifterna.

Arkitekturdiagram för migreringsverktyg

Figur 1: Migreringsverktyg

Krav

Innan migreringsverktygen körs måste partnern uppfylla följande krav:

  1. Partnerns- och partneradministratörskonto måste vara registrerat i RTM-lösningen i grossistledet. Under etappen före försäljningen behöver inte partners registreras i grossistledet RTM-lösningen för att köra extraverktyget.
  2. Partnern måste gå igenom checklistan före migreringen för att se till att alla krav uppfylls.
  3. Inloggningsuppgifter för systemadministratör för Cisco BroadWorks krävs för att köra verktyg för extrakt och enhetsflyttning. Detta gäller inte för BroadCloud-partner.
  4. Extrakts- och enhetsflyttningsverktygen måste köras från den sekundära Cisco BroadWorks-programservern under ett underhållsfönster för att minimera risken. BroadCloud-partner kör verktyget Enhetsflytta från tjänsteleverantörsportalen.
  5. Granska listan över Webex Calling-enheter.
  6. Granska listan över Webex Calling-enheter som inte stöds.
  7. Partner måste be sina kontoteam på Cisco att få den version av den fasta programvaran som stöds för telefoner och enheter.
  8. UC-One-klienter måste uppgradera till följande versioner:
    • Skrivbordskommunikatorklienter måste vara version 22.9.12 eller senare
    • Mobile Connect-klienter måste vara version 3.9.14 eller senare.
  9. Administratörens dator måste ha:
    • JDK/JRE 1.8 krävs för etableringsverktyget.
    • MAC- och Linux-datorer kräver Python 3.10.5 eller senare för Transform Tool.
  10. Kunder måste ha en giltig faktureringsadress och slutanvändare måste ha en e-postadress för företag konfigurerad i Cisco BroadWorks. Om värdena inte har ställts in måste partneradministratörer kontakta sina kunder för att få dem. Dessa uppgifter måste läggas till i CSV-filerna (kommaseparerade värden) innan transformeringsverktyget körs. Exempel på CSV-filer tillhandahålls med transformatorverktyget.

Migreringsplan

Migreringsplanen har 3 steg:

  1. Förberedelse
    • Få en kopia av användardata med extraktionsverktyget
    • Generera en token med hjälp av tokengeneratorverktyget
    • Använd Transform-verktyget för att formatera användardata
  2. Tillhandahåller
    • Hämta de senaste användardata med extraktverktyget
    • Använd Transform-verktyget för att formatera användardata
    • Tillhandahålla användare med etableringsverktyget
  3. Migrering
    • Migrera enheter med verktyget Enhetsflytta
    • Migreringar utan enheter [ Aktivera telefonnummer via Control Hub ]

    Om partneradministratörer inte har enheter att flytta från Cisco Broad Works till Grossist behöver du inte köra verktyget för att flytta enheten. Partneradministratörer kan använda den offentliga länken nedan för att aktivera telefonnumren direkt via Control Hub-portalen. Det finns mer information i Hantera telefonnummer i Control Hub.

    Inaktivering av telefonnummer i Cisco BroadWorks är valfritt om partneradministratörer aktiverar sina telefonnummer via Control Hub.

Funktioner migreras automatiskt till grossistsamtal

Dessa användarfunktioner migreras automatiskt med migreringsverktygen:

  • Inställningar för röstmeddelanden och anpassade hälsningar (röstmeddelanden, anpassat namnljud och användares PIN-kod migreras inte)
  • Alternativa nummer
  • BroadWorks Anywhere
  • Fält för upptagetlampa
  • Inringar-ID (anpassat namn och telefonnummer)
  • Samtal väntar
  • Inställningar för vidarekoppling av samtal (samtalskoppling alltid/upptaget/inget svar/kan inte nås)
  • Avlyssning av samtal
  • Stör ej
  • Faxinställningar
  • Fjärrkontor
  • Layout för samtalsdelning
  • Personlig ringning samtidigt (inklusive schemaläggning och selektiva kriterier)
  • Samtalsavisering (inklusive schemaläggning och selektiva kriterier)
  • Anonym samtalsavvisning
  • Selektiv samtalsavvisning
  • Selektiv samtalskoppling
  • Dirigerad samtalshämtning och inbrytning
  • Undantag för inbrytning
  • Tryck för att prata
  • Sekretess

Dessa gruppfunktioner migreras automatiskt med migreringsverktygen:

  • Automatisk receptionist
    • Endast en nivå
    • Anpassade hälsningsfraser
    • Inställningar för vidarekoppling av samtal (alltid, upptagen, selektiv)
    • Alternativa nummer
    • Semestermenyn är inte tillgänglig i Webex
    • Selektiv samtalsavvisning
  • Cisco BroadWorks Call Center-standard och BroadCloud-samtalskö:
    • Grundläggande konfiguration
    • Anpassade hälsningsfraser
    • Agenter och arbetsledare
    • Inställningar för vidarekoppling av samtal (alltid, upptagen, selektiv)
    • Alternativa nummer
    • Musik parkerad
  • Samtalsparkering
  • Besvara samtal
  • Sökgrupp
    • Inställningar för vidarekoppling av samtal (alltid, upptagen, selektiv, kan inte nås)
    • Alternativa nummer
  • Platskod (en per plats eller grupp)
  • Personsökningsgrupp
  • Scheman (endast på gruppnivå, företagsscheman migreras inte)
  • Röstbrevlåda
  • Virtuell linje
  • Musik parkerad

Enheter som stöds

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).

Telefonmodell

Stöds i verktyget för enhetsflyttning

Enhetstyp i newphones.csv

Cisco MPP 6821

Ja

DMS Cisco 6821

Cisco MPP 6841

Ja

DMS Cisco 6841

Cisco MPP 6851

Ja

DMS Cisco 6851

Cisco MPP 6861

Ja

DMS Cisco 6861

Cisco MPP 6871

Ja

DMS Cisco 6871

Cisco MPP 7811

Ja

DMS Cisco 7811

Cisco MPP 7821

Ja

DMS Cisco 7821

Cisco MPP 7832

Ja

DMS Cisco 7832

Cisco MPP 7841

Ja

DMS Cisco 7841

Cisco MPP 7861

Ja

DMS Cisco 7861

Cisco MPP 8811

Ja

DMS Cisco 8811

Cisco MPP 8832

Ja

DMS Cisco 8832

Cisco MPP 8841

Ja

DMS Cisco 8841

Cisco MPP 8845

Ja

DMS Cisco 8845

Cisco MPP 8851

Ja

DMS Cisco 8851

Cisco MPP 8861

Ja

DMS Cisco 8861

Cisco MPP 8865

Ja

DMS Cisco 8865

Cisco MPP 8875

Ja

DMS Cisco 8875

Cisco ATA191

Ja

DMS Cisco 191

Cisco ATA192

Ja

DMS Cisco 192

Polycom VVX101

Ja

DMS Polycom VVX101

Polycom VVX150

Ja

DMS Polycom VVX150

Polykom VVX201

Ja

DMS Polycom VVX201

Polycom VVX250

Ja

DMS Polycom VVX250

Polycom VVX301

Ja

DMS Polycom VVX301

Polycom VVX311

Ja

DMS Polycom VVX311

Polycom VVX350

Ja

DMS Polycom VVX350

Polycom VVX401

Ja

DMS Polycom VVX401

Polycom VVX411

Ja

DMS Polycom VVX411

Polycom VVX450

Ja

DMS Polycom VVX450

Polycom VVX501

Ja

DMS Polycom VVX501

Polykom VVX601

Ja

DMS Polycom VVX601

Polycom Trio 8300

Ja

DMS Polycom Trio8300

Polycom Trio 8500

Ja

DMS Polycom Trio8500

Polycom Trio 8800

Ja

DMS Polycom Trio8800

Polycom-ljudstation 5000

Ja

DMS Polycom SSIP5000

Polycom-ljudstation 6000

Ja

DMS Polycom SSIP6000

Yealink T33G

Ja

DMS Yealink T33G

Yealink T41S

Ja

DMS Yealink T41S

Yealink T42S

Ja

DMS Yealink T42S

Yealink T43U

Ja

DMS Yealink T43U

Yealink T46U

Ja

DMS Yealink T46U

Yealink T46S

Ja

DMS Yealink T46S

Yealink T48S

Ja

DMS Yealink T48S

Yealink T48U

Ja

DMS Yealink T48U

Yealink T53W

Ja

DMS Yealink T53W

Yealink T54W

Ja

DMS Yealink T54W

Yealink T240 W

Ja

DMS Yealink T240 W

Yealink T58V

Ja

DMS Yealink T58V

Yealink CP920

Ja

DMS Yealink CP920

Yealink CP960

Ja

DMS Yealink CP960

Yealink W63B

Ja

DMS Yealink W63P

Yealink W56B

Ja

DMS Yealink W56P

Yealink W60B

Ja

DMS Yealink W60P

Yealink W70B

Ja

DMS Yealink W70P

Yealink CP925

Ja

DMS Yealink CP925

Yealink CP965

Ja

DMS Yealink CP965

Enheter som inte stöds

Om kunden använder de enheter som inte stöds av RTM-lösningen i grossistledet är dessa enheter inte berättigade till migrering. I det här fallet har du följande alternativ:

  1. Etablera nya telefoner i Cisco BroadWorks innan du migrerar.
  2. Lämna de gamla telefonerna i Cisco BroadWorks och användare måste installera Webex-appen för att ringa och ta emot samtal.

Samtalspaket i grossistledet

Migreringsverktygen har en uppsättning standardinställningar för val av grossistsamtalspaket för prenumeranter. Om ett annat paket önskas senare kan det ändras i Control Hub av en partneradministratör.

Konfiguration av migreringspaket för Cisco BroadWorks

Alla prenumeranter som migrerar från Cisco BroadWorks kommer som standard till Webex Calling-paketet. Om Webex-röstpaketet önskas för prenumeranter som inte har tilldelats samtalsväntande eller röstbrevlåda kan detta aktiveras i Transform Tools partner.cfg-fil genom att avmarkera linjen ANVÄND_WEBEX_VOICE_PACKAGE.

Mappning av migreringspaket för Webex för BroadWorks

Webex för storaverk mappas automatiskt till samtalspaket i grossistledet. Detta kan inte konfigureras.

Webex för Broad Works-paket

Samtalspaket i grossistledet

Programvarutelefon

Webex Voice

Grundläggande

Webex-samtal

Standard

Webex-svit

Premium

Webex-svit

Mappning av brettmolnmigreringspaket

Migreringar från BroadCloud Carrier kartpaket baserat på stationstyp. Standardmappning kan konfigureras i omvandlingsverktygets konfigurationsfil conf/rialto_station_type_to_wholesale_package.csv.

Stationstyp för bredCloud Carrier

Samtalspaket i grossistledet

Grundläggande

Webex Voice

Konferensrum

Webex Voice

Meddelanden

Webex Voice

Standard

Webex Voice

Executive

Webex-svit

Alla andra stationstyper

Webex Voice

Omvandla ett BroadWorks- eller BroadCloud-användarkonto till en Webex Calling-arbetsyta

En Webex-arbetsyta är en telefon som delas mellan många personer, till exempel: till exempel: telefoner i ett konferensrum, lager eller lobby. Sådana telefoner kan konfigureras i Webex Calling som Webex-arbetsytor istället för Webex-användare. Det finns ett alternativ för att automatiskt omvandla användarkonton från Cisco BroadWorks eller BroadCloud Carrier till arbetsytor under migreringsprocessen.

Vidta

  1. I filen transform_tool/input/users.csv tilldelar ”common_area”-paketet till de användare som ska omvandlas till en arbetsyta.
    • Exempel: bwuser@domän,,common_area
  2. (Endast brettCloud) Om du vill konvertera alla användarkonton av en viss stationstyp till arbetsytor lägger du till en post för transform-tool/conf/rialto_station_type_to_wholesale_package.csv och ställer in grossistpaketet på ”common_area_calling”.
    • Exempel: conference_room_v2,common_area_calling
  3. Kör transformeringsverktyget.
  4. Kör etableringsverktyget.
  5. Öppna Control Hub för den nyligen skapade kundorganisationen och ställ in en SIP-domän (se figur 2, Konfigurera en SIP-domän i Control Hub).
  6. Kör etableringsverktyget igen. Detta skapar arbetsytor och tilldelar telefoner till den.

Begränsningar:

Konfiguration av användarfunktioner (till exempel vidarekoppling av samtal, stör ej) migreras inte automatiskt till arbetsytan.

Kontrollhubbfönstret i organisationsinställningarna som markerar SIP-adressen för avsnittet Cisco Webex Calling.

Figur 2: Konfigurera en SIP-domän i Control Hub

Token-generatorverktyg

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

Det här steget är valfritt

Instruktioner att köra

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

  • Följande portar måste vara tillgängliga för att köra token generatorverktyget. Hamnar: 8080, 50009, 50010, 50011, 50012 och 50013

  • Minst en av dessa portar måste vara öppen för anslutning i användarens dator.

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:

Logga in med Cisco Webex-skärmen

Figur 3: Logga in med Cisco Webex

Inloggningsskärm i inloggningsfönstret för inloggningsuppgifter

Figur 4: Fönstret Inloggningsuppgifter

Bildskärm för token

Figur 5: Generering av token

Konfigurationsuppgifter för BroadWorks

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

Detta gäller för Cisco BroadWorks och Webex för BroadWorks. Dessa steg gäller inte för BroadCloud.

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
Server/OCIP-roxy

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.

Extraverktyg

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.

Tjänsteleverantörsportalskärmen som visar den initierade begäran om grossimigreringsextrakt.

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

Tjänsteleverantörsportalskärmen som visar förfrågningar om grossistmigreringsextrakt

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 

Omvandlingsverktyg

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.

Alla dessa fält är valfria.

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

Kolumnnamn

Regler

Id

I Cisco BroadWorks företagsläge:

  • Detta är Cisco BroadWorks-tjänsteleverantörs-ID för företaget.
  • Dessutom behövs en separat linje för varje grupp inom företaget. ID är gruppens ID för Cisco BroadWorks.

I tjänsteleverantörsläget BroadWorks är detta Cisco BroadWorks gruppID.

I BroadCloud är detta Rialtos kund-ID.

externalId

Detta är en identifierare som matchar partnerns interna identifierare för den här kunden. Den här kolumnen måste vara unik i en Webex-partnerorganisation. Den här kolumnen är valfri. En unik identifierare genereras automatiskt av transformeringsverktyget.

Den här kolumnen används inte för grupper inom ett företag.

kundnamn

För företaget används den här kolumnen som fältet för Webex-kundnamn.

För en grupp inom ett företag används den här kolumnen som platsnamn. Platsnamn måste vara unika inom ett företag.

primäre-post

Detta används som e-postadress för Webex-kundadministratören.

Den här kolumnen är valfri för grupper inom ett företag.

Adresskolumner

För ett företag används adressen som faktureringsadress och den första platsadressen.

För en grupp inom ett företag används adressen som platsadress.

Tidszon

Se avsnittet om tidszon i den här artikeln.

språk

Se Språk som Webex stöder.

standard-pin för röstbrevlåda

Se Ställ in en PIN-kod för röstbrevlåda.

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).

Förhandsinformation tar extra tid att köra.

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

Egenskapen JSON 'webex_for_broadworks_info' finns endast för Webex för Broad Works-migreringar. Den `broadcloud_info` JSON-fastigheten finns endast för BroadCloud-migreringar.

Etableringsverktyg

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 
    • 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 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 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 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 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 ä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:

Tabell med antalet platser som 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.

Efter en lyckad etablering kommer kundadministratörer och slutanvändare att få ett e-postmeddelande från RTM-lösningen i grossistledet.

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

Skärmdump av Partner Hub som visar en sökning efter en grossistkund i rullgardinsmenyn Välj kund.

Bild 8: Partnerhubb

Skärmdump av Control Hub som visar fliken Användare och en lista över användare.

Figur 9: Control Hub

Skärmdump av Control Hub som visar skärmen Enheter och en lista över enheter.

Figur 10: Enheter

Skärmdump av Control Hub som visar nummerskärmen och en lista över telefonnummer.

Bild 11: Ringa

Verktyg för enhetsflyttning

För brettmoln

För BroadCloud-partner använder du tjänstleverantörsportalen för att skicka 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.

Tjänsteleverantörsportalen som visar begäran om migrering initieras.

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

Tjänsteleverantörsportal som visar Visa migreringsbegäran.

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

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.

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

  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 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].
Om det inte finns några enheter registrerade med Cisco BroadWorks eller BroadCloud som behöver migreras behöver du inte köra verktyget för enhetsflytt.

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. 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 för JDK/JRE-miljön är korrekt i devicemove.sh
    JAVA_HOME=/usr/local/java/java_base
  5. 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 filen 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å. Kontrollera också att filen migration_%BWMAC ADDRESS%.cfg inte står i konflikt med någon befintlig fil i systemet).

device-move-tool/conf/deviceProfile/{region}/polycom_vvx2.cfg

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 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.
Fil av identitets-/enhetsprofiltyp lägger till skärmbild

Bild 14: Lägg till identitets-/enhetsprofiltyp

I fältet ”MAC-adress i:” används samma värden som de andra filerna i Polycom-mallen. (I figur 14 använder du HTTP-begäran-URI, men detta kanske inte är lämpligt för partnerns distribution av Cisco BroadWorks-programserver).

Instruktioner att köra

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 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:

Skärmbild av sidan Control Hub-enheter som visar enhetens status.

Figur 15: Enhetsstatus

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

Skärmbild av skärmen Control Hub-nummer som visar aktiva nummer.

Figur 16: Nummer aktiva

Återställ migrering

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

Verktyget för enhetsflyttning inaktiverar inte numren i grossistsamtal på grund av tekniska begränsningar under återställningen.

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 

Tillägg

Stor företagsmigrering

Stora företag som har många platser kan inte migrera alla platser i ett enda underhållsfönster. Funktionerna som beskrivs i det här avsnittet gör det möjligt för partner att migrera några platser åt gången.

Steg

Använd följande steg för att planera fasade migreringar för ett stort företag:

  1. Extrahera företagsdata från BroadWorks eller BroadCloud.
  2. Kör Transform-verktyg utan platsalternativ på de extraherade uppgifterna.
  3. Leta efter avsnittet Rekommenderad plats att flytta samtidigt i exception_report.txt för att planera migreringsfaserna för att få mer information om platsberoende, granska filerna för funktionsagenter (se Transform-verktyget nedan).
  4. Generera inmatningen/locations.csv genom att ändra locations_to_be_edited.csv.
  5. Kör Transform-verktyget igen med platsalternativet.
  6. Examine exception_report.txt för att identifiera eventuella platsberoende problem för den aktuella fasen.
  7. Åtgärda platsberoende problem vid behov (genom att ändra locations.csv).
  8. Starta om Transform-verktyget för att generera kunder.json för den aktuella fasen.
  9. Kör etableringsverktyget för varje kund.json.
  10. Under underhållsfönstret kör du verktyget Enhetsflytta.
  11. Upprepa steg 4–10 för nästa fas.

Omvandlingsverktyg

För att uppnå målet att migrera platserna i en stor företagsfas för fas, som nämnts ovan, läggs en ny fil locations.csv till som valfri input (-locations=input/locations.csv) när transform-verktyget körs.

Locations.csv innehåller data som är specifika för platser. Den åsidosätter data som finns i input/customers.csv, som för närvarande innehåller både företagsdata och platsdata.

Följande tabell visar information om locations.csv:

Beskrivning

Värden

Standardvärde

Obligatorisk

Kartor i Broadverk

Kartor i BroadCloud

företags-ID

Unikt företags-id

Ja

tjänsteleverantörs-ID

Kund-ID för Rialto

platsID

Plats-ID, unikt inom företaget

Ja

grupp-ID

Webbplats-ID för Rialto

migreringsstatus

Har den här platsen migrerats?

migrerad, dont_migrate, migrerande

migrera

Nej

namn

Namn på den här platsen.

Lämna det tomt för att använda plats-ID.

Nej

Tidszon

Nej

språk

Nej

address1

Nej

address2

Nej

city

Nej

state

Nej

postnummer

Postnummer eller postnummer

Nej

country

2 bokstäver

Nej

Locations.csv kan komprimeras från den förfyllda locations_to_be_edited.csv när du kör Transform-verktyget på stora företag. Läs vidare för att se exempel.

Locations.csv är en valfri inmatning när du kör transformeringsverktyget, vilket innebär att transformeringsverktyget kommer att uppföra sig på samma sätt som tidigare om alternativet -locations=input/locations.csv inte finns.

Nya utmatningsfiler

Det finns 5 nya utdata från transformeringsverktyget:

  • locations_to_be_edited.csv – detta är förfyllt med all platsinformation för att det stora företaget ska migreras.

Exempel:

platsID, företagID, migreringsstatus, namn, tidszon, språk, adress1, adress2, stad, stat, postnummer, land auto_mig_ent_grp1,auto_mig_ent,,auto_mig_ent_grp1,, 100 huvudgatan, Gaithersburg, MD,20877, US auto_mig_ent_grp2,auto_mig_ent,,auto_mig_ent_grp2,, 101 huvudgatan, Gaithersburg, MD,20877, US auto_mig_ent_grp3,auto_mig_ent,,auto_mig_ent_grp3,,,102 huvudgatan, Gaithersburg, MD,20877,US 

Partnerna/kunderna kan använda den för att generera locations.csv för att styra de platser som ska migreras för en viss fas (och uppdatera platsinfo vid behov).

Exempel: locations.csv genereras från ovan locations_to_be_edited.csv

platsID, företagID, migreringsstatus, namn, tidszon, språk, adress1, adress2, stad, stat, postnummer, land auto_mig_ent_grp1,auto_mig_ent,auto_mig_ent migrerad,auto_mig_ent_grp1,,, 100 huvudgatan, Gaithersburg, MD,20877,US auto_mig_ent_grp2,auto_mig_ent migrerande,auto_mig_ent_grp2,,,101 huvudgatan, Gaithersburg, MD,20877,US auto_mig_ent_grp3,auto_mig_ent,dont_migrate,auto_mig_ent_grp3,, 102 huvudgatan, Gaithersburg, MD,20877,US 

Detta locations.csvinnebär: för den här fasen hade plats auto_mig_ent_grp1 migrerats, plats auto_mig_ent_grp2 migrerat, och migrera inte plats auto_mig_ent_grp3.

  • hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4 filer har samma syfte: generera fullständiga listor över motsvarande funktioner agenter/arbetsledare/originatorer/mål/monitored_elements på migrerande platser om migrerande platser har beroendeställning till andra platser.

De har nästan samma format (namnet på den 3:e kolumnen varierar beroende på funktion), som nedan (auto_mig_ent_grp2:s sökgrupps agentlista för ovanstående fas):

Exempel: följande är från hunt_group_agents.csv

funktionsnavn, funktionsplats, agent, plats Sarah Rodriguez,auto_mig_ent_grp2,agent_michael@domain.com,auto_mig_ent_grp1 Sarah Rodriguez,auto_mig_ent_grp2,agent_sally@domain.com,auto_mig_ent_grp1 

Om platsalternativet inte finns när verktyget Transform körs kommer ovanstående 4 filer att generera fullständiga listor över sökgruppen/samtalscentret/personsökningsgruppen/personsökningsgruppen/personsökargruppen/upptagetfältets agenter/arbetsledare/originatorer/mål/monitored_elements för hela företaget, som kan användas för att planera de fasade migreringarna.

Nya avsnitt i exception_report

Medan du utför fasisk migrering för stora företag kommer det att finnas några nya avsnitt i exception_report.txt om det finns platsberoende som inte tillgodoses.

Exempel: Följande nya avsnitt är för plats auto_mig_ent_grp2 jaktgrupp Sarah Rodriguez agenter på plats auto_mig_ent_grp3 som inte migreras och inte migreras i denna fas.

Beroende mellan platser - Sökgrupper Namn Plats Agent Agents plats Kommentar ________________________________________________________________________________________________________________ Sarah Rodriguez auto_mig_ent_grp2 agent_william@domain.com auto_mig_ent_grp3 Agent på olika platser har inte migrerats ännu Sarah Rodriguez auto_mig_ent_grp2 agent_melody@domain.com auto_mig_ent_grp3 Agent på olika platser har inte migrerats ännu 

Följande nya avsnitt innehåller en rekommendation om hur du grupperar platserna i migreringsfaserna.

Rekommenderade platser att flytta samtidigt:

Plats auto_mig_ent_grp1 är beroende av plats(er) auto_mig_ent_grp2, auto_mig_ent_grp3 Plats auto_mig_ent_grp2 är beroende av plats(er) auto_mig_ent_grp3

Om platsalternativet inte finns när verktyget Transform körs listar avsnittet rekommenderade platser för att flytta samtidigt alla platsberoende för att ge bekvämlighet för planeringen.

När verktyget Transform körs med platsalternativet (t.ex. för en migreringsfas) listar avsnittet Rekommenderade platser för att flytta samtidigt endast platsberoenden för den aktuella fasen.

Etableringsverktyg

För stora företag kan etableringsverktyget köras som vanligt.

Verktyg för enhetsflyttning

Verktyget för enhetsflyttning kan köras för en undergrupp av platser från kund.json.för att uppnå att lägga till en ny valfri locations.csv-fil som har två kolumner.

External_id

Platsnamn

Externt id-värde

Platsnamn/gruppnamn

  • Det här är en valfri fil. Om den inte tillhandahålls eller innehåller de tomma värdena migrerar den alla platser.
  • Om platsnamnen och deras respektive external_ID:er tillhandahålls kommer endast dessa platser att migreras.

Kommandot är följande:

./devicemove.sh -input=<input_path>/customer.json -locations=<input_path>/Location_names.csv

Tidszoner

USA:

"tidszoner":["America/Adak","America/Anchorage","America/Chicago","America/Denver","America/Los_Angeles","America/New_York","America/Phoenix","Pacific/Honolulu"]

Kanada:

"tidszoner":["America/Dawson_Creek","America/Edmonton","America/Halifax","America/Montreal","America/Regina","America/St_Johns","America/Vancouver","Winnipeg"]

Australien:

"tidszoner":["Australien/Adelaide","Australien/Brisbane","Australien/Broken_Hill","Australien/Darwin","Australien/Hobart","Australien/Lord_Howe","Australien/Perth","Australien/Sydney"]

Frankrike:

"tidszoner":["Europa/Paris"]

Portugal:

"tidszoner":["Atlanten/Azorerna", "Europa/Lissabon"]}

uk:

"tidszoner":["Europa/London"]

Italien:

"tidszoner":["Europa/Rom"]