Understøttede telefoner oprettes automatisk og tildeles til brugere i Webex Calling af klargøringsværktøjet. Telefoner, der er markeret "Ja" i kolonnen "Understøttet i værktøjet til flytning af enhed", flyttes også automatisk fra Cisco BroadWorks eller BroadCloud til Webex Calling, når værktøjet til flytning af enhed kører. Telefoner, der er markeret "Nej" i den pågældende kolonne, skal have en manuel indgriben for at ændre DMS-URL-adressen i Cisco BroadWorks-enhedsskabelonen eller i selve telefonen.

Den sidste kolonne angiver tilknytningen af telefonmodeller til kolonnen "Enhedstype" i filen transform-tool/input/newphones.csv. (Se afsnittet Transformationsværktøj i denne artikel for yderligere oplysninger om newphones.csv).

Partneradministratorer kører dette værktøj til tokengenerator mindst én gang, før de begynder at køre migreringsværktøjer. Kørsel af dette værktøj er en engangsaktivitet, når partnerkontoen er onboardet i RTM-løsningen til engroshandel. Dette værktøj giver partneradministratorer mulighed for at logge på via webbrowser for at få den entydige TOKEN, der er nødvendig for at opdatere til partnerkonfigurationsfilerne for migreringsværktøjerne.

Forudsætninger

Når du har downloadet, skal du udtrække binærerne til migrationsværktøjet.

Indstil JRE/JDK-miljøstien i token_generator.sh for MAC og token_generator.bat for Windows. Hvis JAVA_HOME-stien allerede findes, vil den blive genbrugt af værktøjet.

• mac: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

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

Vejledning til at køre

Kør følgende kommando i terminalen inde i tokengeneratorens mappe:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Visning:

Værktøjsnavn: Token Generator værktøj version: 1.13.0 Indlæs URL-adressen i din webbrowser: http://localhost:8080 

Åbn URL-adressen i webbrowseren på terminalen, log ind med legitimationsoplysningerne for partneradministratoren for at få TOKENET, og kopiér det samme til yderligere brug.

Illustrationerne i brugergrænsefladen er angivet nedenfor som reference:

Figur 3: Log ind med Cisco Webex

Figur 4: Vinduet med legitimationsoplysninger

Figur 5: Generering af token

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

Aktivér OCI-P-forbindelse

Værktøjet til flytning af enheden kommunikerer med BroadWorks via OCI-P-kommandoer. For at aktivere OCI-P-forbindelse skal du bruge nedenstående trin:

Trin 1: Brug CLI til at konfigurere generelle indstillinger.

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

AS_CLI> cd /Applikationer/OpenClientServer/GeneralSettings.

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

AS_CLI/Applications/OpenClientServer/GeneralSettings> få klientPort = 2208 klientPortAktiveret = sand sikkerKlientPort = 2209 sikkerKlientPortAktiveret = sand systemDomain = <> 

Hvis dine indstillinger ikke stemmer overens med ovenstående, skal du bruge kommandoen indstil til at omkonfigurere dine indstillinger.

Trin 2: Brug CLI til at konfigurere OCI-proxyen.

Skift telefonbogen til OCI-proxy:

AS_CLI> cd /applikationer/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> få aktiveret = sand aktiveretLoginNiveauScreening = falsk aktiveretSvarCaching = falsk svarCacheVarighedTimer = 24 svarCacheFornyPeriodeMinutter = 30 meddelelserKøKapacitet = 50 meddelelserKøTimeoutSekunder = 1800 

Hvis dine indstillinger ikke stemmer overens med ovenstående, skal du bruge kommandoen indstil til at omkonfigurere dine indstillinger.

Trin 3: Brug CLI til at konfigurere OCI-klargøring.

Skift til klargøringskatalog:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kør følgende kommando for at få de aktuelle OCI-klargøringsindstillinger:

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

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

 SOM_CLI/Maintenance/ManagedObjects> få BroadWorks, og kontrollér, at dit output ser i orden. Se nedenfor for eksempel output: AS_CLI/Maintenance/ManagedObjects> få BroadWorks-administrerede objekter ========================== * Server: Identitet..............: AS-version...............: Rel_21.sp1_1.551 Administrativ tilstand..: Ulåste * Applikationer: Navn Version Installeret Administrativ tilstand Effektiv tilstand Udførelse ========================================================================================= og klargøring 21.sp1_1.551 sand Ulåst Ulåst FlashPolicy 21.sp1_1.551 falsk Ulåst Stoppet OpenClientServer 21.sp1_1.551 sand Ulåst Ulåst WebContainer 21.sp1_1.551 sand Ulåst Ulåst 4 poster fundet. * Hostede applikationer: Navn Version Kontekststi Implementeret 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 fundet. 

Bekræft, at den åbne klientserver er installeret og aktiv

Brug kommandoerne nedenfor til at installere og starte Open Client-serveren på den sekundære applikationsserver, hvis den ikke er installeret eller ikke allerede er startet.

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

AS_CLI/Maintenance/ManagedObjects> installer programmet OpenClientServer

Trin 2: Start serveren med denne kommando:

AS_CLI/Maintenance/ManagedObjects> start applikationen OpenClientServer

Aktivér aktivering af numre

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

Trin 1: Kør kommandoen for nummeraktivitet:

AS_CLI> cd SubscriberMgmt/NumberActivation

Trin 2: Kør kommandoen til aktivering:

AS_CLI> sæt dnMode groupAndUserActivationEnabled

Trin 3: I bekræftelsesanmodningen skal du angive Y.

Til BroadCloud

Udtrækningsværktøjet er integreret i BroadCloud-tjenesteudbyderportalen. En tjenesteudbyders administrator kan:

1. Indsend anmodninger om udtræk for op til 50 kunder pr. anmodning.
   Anmodning om udtræk kan ikke sendes for den samme kunde mere end 10 gange om dagen.
2. Download den udpakkede datafil i ZIP-format i op til 28 dage fra datoen for indsendelse af anmodning.

Nedenstående tal viser tjenesteudbyderportalen.

Figur 6: Tjenesteudbyderportal

Figur 7: Tjenesteudbyderportal

Til Cisco BroadWorks og Webex til BroadWorks

1. Ekstraktionsværktøjet kører på den sekundære Cisco BroadWorks-programserver i partnernetværket og opretter forbindelse via OCI-P.
2. Værktøjet trækker rå virksomheds-, gruppe-, numre-, brugere-, tjenester-, enheds- og softwareklientdata fra Cisco BroadWorks- eller BroadCloud-platformen og udsender disse data til XML-filer, der leverer input til transformationsværktøjet.

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

Forudsætninger

1. SCP udtrækker værktøjsbinære filer til sekundær Cisco BroadWorks-applikationsserver.
2. SSH til den sekundære Cisco BroadWorks-programserver for at konfigurere forudsætningerne og køre ekstraktionsværktøjet.
3. Konfigurer tjenesteudbyderen og gruppe-id'et til at udtrække fra Cisco BroadWorks i conf/exportTool.yml. Se nedenstående eksempel på YAML-snippet:

   TjenesteudbyderID-A:      - GruppeID-A1 - GruppeID-A2 - GruppeID-A3 ServiceudbyderID-B:                        - alle 

4. Sørg for, at det sekundære bruger-id, adgangskode og værtsnavn til Cisco BroadWorks-applikationsserver er korrekte i filen conf/partner.cfg:

   BROADWORKS_BRUGER_ID = administrator BROADWORKS_ADGANGSKODE = administrator BROADWORKS_VÆRT_NAVN = lokal vært OPDATERING_TOKEN = partneradministratorens opdateringstoken kopieret fra værktøjet Token Generator. Migreringstilstand_ = UNDERSTØTTEDE værdier er webex_for_broadworks_to_wholesale. Standardværdien er broadworks_to_wholesale. Brug webex_for_broadworks_to_wholesale til Webex til BroadWorks-migreringer. 

   Egenskaben OPDATERINGSTOKEN_ er obligatorisk for en Webex til BroadWorks-migrering.

5. Rediger JDK/JRE-miljøstien i export.sh-filen, hvis den sekundære JDK/JRE-miljøsti til Cisco BroadWorks-applikationsserver er en anden end filen:

   JAVA_HOME=/usr/local/java/java_base

Vejledning til at køre

Kør kommandoen nedenfor i den sekundære Cisco BroadWorks-programserver fra mappen udtræk værktøj:

./export.sh

Terminallogfiler

Følgende logfiler er tilgængelige i terminalen ved vellykket eksport: Kører BroadSoft-dataeksportværktøj:

 Kører BroadSoft Data Export Tool ************************************************ Starter eksportværktøj v: 1.15.0 Eksport startet for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport af brugere for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport af brugere fuldført for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport fuldført for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport fuldført Eksport Dump Zip-mappe: output/20221017223452_ExportTool Export Dump Zip-filnavn:extracted_data_1666060500618.zip Zip-fil med navnet extracted_data_1666060500618.zip er blevet oprettet ZIP-fil oprettelsesprocessen fuldført Eksporterede filer konverteret som ZIP-fil ************************************************** 

Output

En output-ZIP-fil (extracted_data_.zip) vil være tilgængelig i den samme udtrækningsværktøjsmappe. Brug kommandoen nedenfor til at se og bruge ZIP-filen til input af transformationsværktøj:

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 logfiler/ -rw-rw-r-- 1 bwadmin bwadmin 46341 okt 17 22:35 extracted_data_1666060500618.zip 

Dette transformationsværktøj køres for alle migreringer. Transformationsværktøjet kører på enhver computer, herunder en partneradministrators bærbare computer, og bruger Webex Public API'er. Den læser ZIP-filen (extracted_data_.zip), som et input og omdanner den rå XML til et JSON-format, der bruges af klargøringsværktøjet.

Forudsætninger

Når du har downloadet og udpakket binærerne til migreringsværktøjer, skal du konfigurere følgende forudsætninger:

1. Indstil opdateringstokenet_ (TOKEN kopieret fra værktøjet Token Generator) og NAVNET_PÅ_HOVEDPLACERINGEN_ i filen conf/partner.cfg:

   GENINDLÆS_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main 

2. Du kan vælge at indstille KLARGØRINGEN_ID (kopieret fra skabelonen i Partner Hub) i filen conf/partner.cfg:

   KLARGØRING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For at få mere komplet bekræftelse af kundens e-mailadresse kan du vælge at angive KLARGØRINGS_-id'et.
3. Konfigurer manglende oplysninger i input/customers.csv-filen (se næste afsnit), hvis de mangler.
4. Tilføj slutbrugerens e-mailadresse i input/users.csv-filen.
5. Hvis nye telefoner skal klargøres, skal du føje MAC-adressen og e-mailadressen på brugerens nye telefon til input/newphones.csv-filen. Dette er kun påkrævet, hvis partneradministratorerne ønsker at klargøre nye telefoner i engrosopkald.
6. Konverter BroadWorks-opkaldscentre til CxEssentials ved hjælp af filen input/cxessentials.csv.
7. Du kan også aktivere egenskaben OPGRADER_ALLE_OPKALDSCENTRE__TIL_CX_ESSENTIALS for at konvertere alle opkaldscentre til CxEssentials.
8. Brug input/locations.csv-filen til at understøtte den store virksomhedsmigrering, der giver administratorer mulighed for at overføre deres kundes placeringer efter placering
9. Du kan vælge at aktivere brug af MAC-adresser fra brugeragentheaderen i SIP REGISTER-meddelelsen, når MAC-adressen ikke er tilgængelig i Cisco BroadWorks-enhedsprofilen. Fjern kommentar til linjen "BRUG_MAC_ADRESSE_FRA_SIP_REGISTER=ja" i filen conf/partner.cfg

Udfyldning af input/customers.csv

Filindtastningen/customers.csv indeholder data, der muligvis mangler i Cisco BroadWorks eller BroadCloud. Denne fil kan efterlades tom, hvis alle obligatoriske oplysninger allerede er tilgængelige. Du behøver ikke at udfylde alle kolonner. Det er kun de manglende oplysninger, der er obligatoriske.

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

Vejledning til at køre

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

Windows

Udfør kommandoen nedenfor for at køre transformationsværktøjet i Windows:

transform.bat -extract= -customers= -users= -newphones=

macOS

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

1. Opret et virtuelt miljø, og installer afhængigheder for at køre transformationsværktøjet ved hjælp af Python:

   python3 -m venv venv kilde venv/bin/aktiver python3 -m pip-installationsanmodninger python3 -m pip-installationsanmodninger-oauthlib 

2. Kør transformationsværktøjet:

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

Forhåndskontrol af kunde/bruger

Transformationsværktøjet foretager API-opkald til Webex for at indhente potentielle klargøringsproblemer. Som standard validerer den kundens adresse og primære e-mail. Hvis klargørings_ID-værdien er angivet i filen conf/partner.cfg, validerer den også oplysninger om placering. Resultaterne af forhåndskontrollen er inkluderet i undtagelsesrapporten.

Derudover kan følgende valgfrie parametre tilføjes, når transformationsværktøjet køres:

forhåndskontrol

Ud over at køre forhåndskontrol-API for kundeoplysninger kører transformationsværktøjet også forhåndskontrol-API for abonnent-e-mails.

oplysninger om forhåndskontrol

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

Terminallogfiler

Følgende logfiler i terminalen, når transformationen er gennemført:

Oversigtsrapport for BroadWorks-virksomheder, der kan overføres: 1 BroadWorks-virksomheder, der ikke kan overføres: 0 BroadWorks-brugere, der kan overføres: 4 BroadWorks-brugere, der ikke kan overføres: 0 telefoner, der kan migreres: 3 telefoner, der ikke er kompatible med Webex Calling: 0 

Undtagelsesrapport

Transformationsværktøjet genererer undtagelsesrapporten i mappen output//exception_report.txt . Du kan bruge denne rapport til at identificere de problemer, der vil påvirke migreringen, og løse dem i Cisco BroadWorks-systemet.

Når du har ændret brugerdataene for at løse undtagelsen, skal du køre udtræk- og omdannelsesværktøjerne igen med de nye data. Eksempelundtagelsesrapportfilen er som følger:

Undtagelsesrapport tue. okt. 18 08:12:09 2022 Virksomheder med anbefaling af kommunikationsspærringsfunktion: konfigurer planen for udgående opkald manuelt i Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Output

En output-JSON-fil (customer.json) vil være tilgængelig i mappen output// . Eksemplet på customer.json -filen er som følger:

{ "kunde": { "provisioningId": "!!!!!!!!!!ERSTAT_med_KLARGØRINGS-ID!!!!!!!!!!", "pakker": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "adresse": { "addressLine1": "100 Main Street", "addressLine2": "", "by": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "US" }, "customerInfo": { "name": "Engineering Group - 1", "primærEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "location": { "name": "Main", "adresse": { "addressLine1": "100 Main", "addressLine2": "", "by": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "US" }, "tidszone": "America/New_York", "sprog": "en_us", "numre": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "hovednummer": "+15205551101" } } }, "broadworks_info": { "service_provider_id": "kollabormigrationstestSP_engg", "group_id": "kollabormigrationstestGRP_engg" }, "abonnenter": [ { "amareswaranvel+benjaminjack@gmail.com": { "abonnent": { "customerId": "!!!!!!!!!!ERSTAT_med_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "pakke": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "lokalnummer": "1102" } }, "funktioner": [ { "/v1/people/{personId}/features/voicemail": { "aktiveret": sand, "sendOptagetOpkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "sendUbesvaredeOpkald": { "aktiveret": sand, "hilsen": "STANDARD", "antalRingetoner": 3 }, "meddelelseslagring": { "mwiEnabled": sand, "storageType": "EKSTERN", "externalEmail": "engineering17861@mailnator.com" } } } ], "enheder": [ { "cisUuid": "!!!!!!!!!!ERSTAT_MED_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "abonnent": { "customerId": "!!!!!!!!!!ERSTAT_MED_CUSTOMERID!!!!!!!!!!", "e-mail": "amareswaranvel+lucasoliver@gmail.com", "pakke": "webex_calling", "provisioningParameters": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "lokalnummer": "1103" } }, "funktioner": [ { "/v1/people/{personId}/features/voicemail": { "enabled": sand, "sendOptagetOpkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "sendUbesvaredeOpkald": { "aktiveret": sand, "hilsen": "STANDARD", "antalRingetoner": 3 }, "meddelelseslagring": { "mwiEnabled": sand, "storageType": "EKSTERN", "externalEmail": "engineering16821@mailnator.com" } } } ], "enheder": [ { "cisUuid": "!!!!!!!!!!ERSTAT_MED_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "abonnent": { "customerId": "!!!!!!!!!!ERSTAT_MED_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "pakke": "webex_calling", "provisioningParameters": { "firstName": "Leo", "lastName": "Jackson", "primaryPhoneNumber": "+15205551104", "lokalnummer": "1104" } }, "funktioner": [ { "/v1/people/{personId}/features/voicemail": { "enabled": sand, "sendOptagetOpkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "sendUbesvaredeOpkald": { "aktiveret": sand, "hilsen": "STANDARD", "antalRingetoner": 3 }, "meddelelseslagring": { "mwiEnabled": sand, "storageType": "EKSTERN", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "enheder": [] } }, { "amareswaranvel+owenalex@gmail.com": { "abonnent": { "customerId": "!!!!!!!!!!ERSTAT_MED_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "pakke": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "lokalnummer": "1101" } }, "funktioner": [ { "/v1/people/{personId}/features/voicemail": { "enabled": sand, "sendOptagetOpkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "sendUbesvaredeOpkald": { "aktiveret": sand, "hilsen": "STANDARD", "antalRingetoner": 3 }, "meddelelseslagring": { "mwiEnabled": sand, "storageType": "EKSTERN", "externalEmail": "engineering8811@mailnator.com" } } } ], "enheder": [ { "cisUuid": "!!!!!!!!!!ERSTAT_med_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "tidsplaner": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Automatisk stemmeportal", "fornavn": "Automatisk", "efternavn": "Stemmeportal", "languageCode": "en_us", "telefonnummer": "+15205551105", "lokalnummer": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "placeringer": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

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

Forudsætninger

Konfigurer følgende forudsætninger i mappen med klargøringsværktøjer:

1. Installer Java 8, 11 eller 17 på computeren. Java er tilgængelig fra mange kilder, herunder:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Når du har downloadet og udvundet binærerne til migrationsværktøjer, skal du indstille variablen JAVA_HOME-miljø i provisioning_tool.sh til MAC og provisioning_tool.bat til Windows.
3. Filen partner.cfg:
   • Indstil engrosforhandlerklargørings-id'et og opdater token (token kopieret fra værktøjet Token Generator).___ Partneradministratorerne skal kontakte deres kontoteam for at få KLARGØRINGS-ID'et_:

     ENGROSKLARGØRING__ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Indstil TILLAD_ADMIN_INVITER_E-MAILS til falsk, hvis partneren ikke ønsker at sende en velkomst-e-mail til brugerne. Standardværdien er sand.

4. Brug emneegenskaben WEBEX4BWKS_E-MAIL_TIL Webex for BroadWorks-migreringer til at sende e-mailemnet for anmodning om ændring af adgangskode for Webex for BroadWorks-abonnenter.
5. Brug WEBEX4BWKS_E-MAIL_BODY PROPERTY for Webex for BroadWorks-migreringer til at sende e-mailbody for anmodning om ændring af adgangskode for Webex for BroadWorks-abonnenter.

For BroadCloud-migreringer samme område:

1. Værktøjet springer over klargøring af numre, enheder og delte opkaldsvisninger over.
2. Værktøjet opretter brugere og virtuelle brugere med lokalnummer og midlertidigt lokalnummer.

For BroadCloud-migreringer gælder et andet område:

1. Værktøjet klargør numre, enheder og visninger af delte opkald.
2. Værktøjet opretter brugere og virtuelle brugere med faktiske telefonnumre og lokalnumre.
   Alle BroadCloud-migreringer i Europa er til en anden region.

Vejledning til at køre

Benyt følgende fremgangsmåde til at køre værktøjet i Windows og macOS:

Windows

Udfør følgende trin for at køre værktøjet på Windows OS:

Sådan klargøres en enkelt kunde: provision.bat -input= Sådan klargøres flere kunder: provision.bat -input= 

macOS

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

Sådan klargøres en enkelt kunde: ./transform.sh -input= Sådan klargøres flere kunder: ./transform.sh -input= 

Forudsætninger for Webex til BroadWorks-migrering

Partneradministratorer skal opdatere deres BroadWorks-onboarding-skabelon til Webex for BroadWorks-sameksistensfunktioner. Se følgende billede:

Når Webex til BroadWorks-onboarding-skabelonen er opdateret for at understøtte migrering, skal du anmode Cisco-kontoteamet om at aktivere funktionen "wholesale-partner-blending-enabled" på partnerniveau. Dette gør det muligt at føje engrospakker til eksisterende Webex til BroadWorks-kundeorganisationer under klargøring.

Kør klargøringsværktøjet med et yderligere argument.

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

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

Fase efter migrering: Er den sidste fase, hvor administratorer helt kan konvertere BroadWorks til engroshandel. Du skal køre klargøringsværktøjet med et argument efter migration.

Terminallogfiler

Følgende er logfilerne i terminalen ved vellykket klargøring:

Værktøjsnavn: Version af klargøringsværktøj: 1.15.0 ********** Startede behandling af fil: input/customer.json **************** Klargøring af kunde Venter på, at kunde external_id_engg_grp1 fuldfører klargøringen... Venter på, at kunde external_id_engg_grp1 fuldfører klargøringen...   Status for kunde external_id_engg_grp1: klargjorte klargøringsnumre Klargøring af brugere Klargøring af brugerfunktioner Klargøringshilsner Klargøringsplaner Klargøringsenheder Klargøring af delte opkaldsvisninger Klargøring af automatiske omstillinger Klargøring af opkaldskøer Klargøring af søgegrupper Klargøring af opkaldsparker Klargøring af opkaldsbesvarelser Klargøring af stemmeportal ********** Fuldført fil : input/customer.json **************** 

En tabel udskrives med antallet af oprettede placeringer for hver kørsel:

Output

Klargøringsværktøjet genererer succesrapporter og fejlrapporter i output/<external_id>/*.success/error -filerne. Gennemgå vellykket output og fejllogfiler for at bekræfte vellykket klargøring.

Partneradministratorer kan bekræfte kundeklargøringen i Partner Hub- og Control Hub-portalen. Se følgende illustrationer fra Partner Hub- og Control Hub-portalen:

Figur 8: Partner Hub

Figur 9: Control Hub

Figur 10: Enheder

Figur 11: Ringer op

Til BroadCloud

For BroadCloud-partnere skal du bruge tjenesteudbyderportalen til at indsende en migreringsanmodning for numre, enheder og SCA-migreringer.

Inden for serviceudbyderportalen kan en migreringsanmodning omfatte op til 50 kunder. Der kan maksimalt indsendes 10 anmodninger inden for en dag.

Nedenstående tal viser tjenesteudbyderportalen.

Figur 12: Tjenesteudbyderportal

Figur 13: Tjenesteudbyderportal

Til Cisco BroadWorks og Webex til BroadWorks

For Cisco BroadWorks- og Webex til BroadWorks-migreringer kører værktøjet på den sekundære Cisco BroadWorks-programserver i partnernetværket og opretter forbindelse til AS via OCI-P. Den bruger JSON-filen (customer.json) til transformationsværktøj som input og kører OCI-P-kommandoerne til at migrere enheder og softwareklienter.

Når handlingen er fuldført, vil værktøjet til flytning af enhed:

1. Fjern registreringen af enheder fra Cisco BroadWorks, og registrer dem i engroshandel.
2. Brugere, der bruger UC-One-klienten, omdirigeres til Webex-appen ved første login.
3. Deaktiver telefonnumre fra Cisco BroadWorks, eller fjern telefonnumrene fra BroadCloud.
4. Aktivér numre i engrossalg.
5. Opret delte opkaldsforekomster i engroshandel med henblik på BroadCloud-migreringer. [Dette trin gælder kun for BroadCloud-migreringer].

SCP og SSH

1. SCP-værktøjet til flytning af enheden til den sekundære Cisco BroadWorks-programserver.
2. SSH til den sekundære Cisco BroadWorks-programserver for at konfigurere forudsætningerne og køre værktøjet til flytning af enheden.

Forudsætninger

1. Indstil OPDATERINGSTOKEN_ (token kopieret fra værktøjet Token Generator) i filen conf/partner.cfg:

   OPDATER_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Sørg for, at det sekundære bruger-id, adgangskode og værtsnavn til Cisco BroadWorks-applikationsserver er korrekte i filen conf/deviceMoveTool.conf:

   BROADWORKS_BRUGER_ID = admin BROADWORKS_ADGANGSKODE = admin BROADWORKS_VÆRT_NAVN = lokal vært 

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

   Hvis administratorer ønsker at sende e-mailinvitationer til deres brugere under migreringen, skal de fjerne kommentarer fra egenskaben "SEND_INVITATION_E-MAILS=true" i filen conf/partner.cfg. Ellers skal ejendommen forblive uændret.

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom-telefoner

For at flytte Polycom-telefoner fra Cisco BroadWorks til engrosopkald skal en partneradministrator oprette en ny identitets-/enhedsprofiltypefil på systemniveau i hver Polycom-enhedsskabelon i Cisco BroadWorks. Se figur 14, og overfør den brugerdefinerede fil device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Når du har overført den nye enhedsfil, skal du sørge for, at den nyoprettede fil findes på gruppeniveau. Sørg også for, at filen migration_%BWMAC ADDRESS%.cfg ikke er i konflikt med en eksisterende fil i dit system).

Den bruges internt af værktøjet til flytning af enheden.

Migrationsprocessen for Polycom-telefoner:

1. Værktøjet til flytning af enhed erstatter filen %BWMACADDRESS%.cfg på enhedsniveau med polycom_vvx2.cfg. Denne fil henviser til migration_%BWMACADDRESS%.cfg.
2. Genopbyg enhedsprofilerne på gruppeniveau eller enhedsniveau.
   Handling på gruppeniveau eller enhedsniveau afhænger af konfigurationen af parameteren deviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Værktøjet til flytning af enheder beder Cisco BroadWorks-applikationsserveren om at genstarte telefoner på gruppeniveau eller enhedsniveau.
4. Efter genstartsanmodningen downloader og process% BWMACADDRESS%.cfg, hvilket beder Polycom-telefonerne om at downloade og process migration_%BWMACADDRESS%.cfg, hvilket indstiller device.prov.serverName til https://plcm.sipflash.com.
   https://plcm.sipflash.com for den amerikanske region har andre regioner forskellige URL-adresser.
5. Polycom-telefonen downloader %BWMACADDRESS%.cfg fra https://plcm.sipflash.com og vil blive administreret af Webex Calling DMS.

Figur 14: Tilføj profiltypefil for identitet/enhed

Vejledning til at køre

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

Enhedsflytningsværktøjet køres fra den sekundære Cisco BroadWorks-programserver i mappen med enhedsflytningsværktøjer:

For enhedsflytning af enkelt kunde: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json For enhedsflytning af flere kunder: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Desuden understøtter enhedsflytningsværktøjet migrering af enkelte/specifikke telefoner fra version 1.35.0. Brug kommandoen nedenfor: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminallogfiler

Følgende logfiler i terminalen om enhedsflytningsværktøjet til enhedsmigrering blev kørt:

Værktøjsnavn: Version af enhedsflytningsværktøj: 1.15.0 Enhedsværktøj startet... Gyldige enheder til overførsel: ------------------------------------------------------------------------------------------------------------------- | Enhedstype | Mac | Version | E-mail | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Vil du overføre alle disse enheder? ([Y]er eller [n]o) ja Overførsel af enhedsprofiler for DMS Cisco MPP LC Genopbyg-enhedsproces Påbegyndt Genopbyg-enhedsproces Fuldført Genstartsproces Påbegyndt Genstartsproces fuldført Modificering af profiler for Business Communicator under group collabmigrationtestGRP_engg Aktivér Webex-telefonnummerproces startet for kundeorganisations-id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Processen med aktivering af Webex-telefonnumre er fuldført for kunde-organisations-id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Deaktiver BroadWorks-telefonnummerproces startet for gruppe-id: collabmigrationtestGRP_engg Deaktiver BroadWorks-telefonnummerproces fuldført for gruppe-id: test af kollabormigrationGRP_engg Enhedsmigration fuldført 

Output

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

Figur 15: Enhedsstatus

Efter enhedsoverførslen er numre blevet aktive. Se figur 16 for at se et eksempel på, hvilke numre der er aktive:

Figur 16: Numrene er aktive

Gendannelseshandlingen skal udføres for én virksomhed ad gangen.

For BroadCloud-udbyder

Gendannelsesprocessen for BroadCloud-partnere er som følger:

1. Åbn en supportanmodning hos Cisco TAC for at anmode om genoprettelse af en enhed.
2. Kør værktøjet til flytning af enheden i gendannelsestilstand:
   • Tildelingen af telefonnumre vil blive fjernet fra Webex Calling, så brugere og tjenester kun får lokalnumre.
   • E-mailadresser i Webex Calling vil blive gendannet til midlertidige e-mailadresser.
   • Telefoner slettes fra Webex Calling.
   • Telefonnumre, e-mailadresser, der bruges som alternative id'er, og telefoner vil blive genoprettet i BroadCloud.
   • Telefoner genstartes.
3. Partneradministratorer skal flytte PSTN-telefonnumre tilbage til BroadCloud Carrier.

Til Cisco BroadWorks og Webex til BroadWorks

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

1. Åbn en supportanmodning hos Cisco TAC for at anmode om genoprettelse af en enhed.
2. Kør værktøjet til flytning af enheden i gendannelsestilstand på den sekundære BroadWorks-applikationsserver for at gendanne enhedsoverførsler. Dette vil nulstille DMS-URL-adressen til tjenesteudbyderens DMS-URL-adresse for enhedsprofiler i Cisco BroadWorks og genaktivere telefonnumre.
3. Webex Calling-teamet indstiller DMS URL-adressen tilbage til tjenesteudbyderens DMS URL-adresse i enhedsprofiler i Webex Calling.
4. Partneradministratorer skal deaktivere eller slette telefonnumrene i Webex Calling via Control Hub-portalen.
5. Partneradministratorer skal flytte PSTN-telefonnumre tilbage til Cisco BroadWorks.

Vejledninger til at køre værktøjet til flytning af enhed i gendannelsestilstand

Følg nedenstående trin for at køre værktøjet til flytning af enheden i gendannelsestilstand:

Kør kommandoen nedenfor i den sekundære Cisco BroadWorks-programserver i mappen med enhedsflytningsværktøj:

Returnér profiler

./devicemove.sh -input=  -revertProfiles

Returner numre

./devicemove.sh -input=  -revertNumbers

Terminallogfiler

Vi får følgende logfiler i terminalen, når værktøjet til flytning af enheden er blevet kørt med henblik på genoprettelse:

Returnér profiler

Værktøjsnavn: Version af enhedsflytningsværktøj: 1.15.0 Enhedsværktøj startet til gendannelsesproces... Enheder, der kan flyttes tilbage fra Webex Calling til BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Enhedstype | Mac | Version | E-mail | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Vil du flytte disse enheder tilbage fra Webex Calling til BroadWorks? (Ja, Y, Nej, N):  Ja Overførsel af enhedsprofiler for DMS Cisco MPP LC Genopbyg-enhedsproces Påbegyndt Genopbyg-enhedsproces Fuldført Genstartsproces Startet Genstartsproces Fuldført Enhedsmigration fuldført til fjernelse af klargøring 

Returner numre

Værktøjsnavn: Version af enhedsflytningsværktøj: 1.15.0 Vil du fortsætte med at gendanne numre til Broadworks?  ([Y]er eller [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Start gendan Aktivér BroadWorks-telefonnummerproces startet for gruppe-id: collabmigrationtestGRP_engg Aktivér BroadWorks-telefonnummerproces fuldført for gruppe-id: Processen til gendannelse af kollabormigrationtestGRP_engg -enhedsoverførsel blev fuldført