Migreringsværktøjer til overgang fra BroadWorks, Webex til Broad Worksog Broad Cloud til engros-RTM-løsninger

Understøttede telefoner oprettes automatisk og tildeles til brugere i Webex Calling af klargøringsværktøjet. De telefoner, der er mærket "Ja" i kolonnen "Understøttet i værktøjet til flytning af enheder", flyttes også automatisk fra Cisco BroadWorks eller Broad Cloud til Webex Calling, når enhedsflytningsværktøjet køres. Telefoner, der er markeret med "Nej" i denne kolonne, skal bruge en manuel indgriben for at ændre DMS URL-adressen i Cisco Broad Works-enhedsskabelonen eller i selve telefonen.

Den sidste kolonne viser tilknytning af telefonmodeller til kolonnen "Enhedstype" i filtransform-tool/input/newphones.csv. (Se afsnittet Transformer værktøj i denne artikel for at få flere oplysninger om newphones.csv).

Partneradministratorer kører dette tokengenerator-værktøj 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 bliver onboardet til engros-RTM-løsningen. Dette værktøj giver partneradministratorer mulighed for at logge ind via webbrowser for at få det unikke TOKEN, der er nødvendigt for at opdatere til partnerkonfigurationsfilerne for migreringsværktøjerne.

Forudsætninger

Når du har downloadet, skal du udtrække migreringsværktøjets binarer.

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="/Brugere/cisco/jdk/zulu@1.8.282/Indhold/Home/"

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

Vejledninger til kørsel

Kør følgende kommando i terminalen i tokengeneratortelefonbogen:

Windows:

token_generator.bat

MacOS:

./token_generatorsh

Udgang:

Værktøjsnavn: Token-generatorværktøjsversion: 1.13.0 Indlæs URL-adressen i din webbrowser: http://lokal vært:8080 

Åbn URL-adressen i webbrowseren på terminalen, log ind med partneradministratorens legitimationsoplysninger for at få TOKEN og kopiere den til videre brug.

Illustrationerne i brugergrænsefladen er angivet nedenfor til reference:

Figur 3: Log ind med Cisco Webex

Figur 4: Vindue til legitimationsoplysninger

Figur 5: Token-generering

Konfigurer følgende trin, før du kører ekstrakt- og enhedsflytningsværktøjerne i den sekundære Broad Works-server.

Aktivér OCI-P-forbindelse

Enhedsflytningsværktøjet kommunikerer med Broad Works via OCI-P-kommandoer for at aktivere OCI-P-forbindelse skal du bruge trinnene nedenfor:

Trin 1: Brug CLI til at konfigurere generelle indstillinger.

Kør følgende kommando i CLI for at ændre til mappen Generelleindstillinger:

AS_CLI> cd /Applications/Open Client Server/Generelle

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

AS_CLI/Applications/OpenClientServer/GeneralSettings> få klientport = 2208 klientportaktiveret = sand sikkerklientport = 2209 sikker klientportaktiveret = sandt systemdomæne = <> 

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 /Applications/OpenClient Server/OCIP

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

AS_CLI/Applications/OpenClientServer/OCIProxy> få aktiveret = sand aktiveretLogin-niveauScreening = falsk aktiveringSvarCaching = falsk svarCacheVarighedTimer = 24 svarCache Renew PeriodMin = 30 meddelelseKøKapacitet = 50 meddelelseKøTimeout Sekunder = 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.

Ændring af klargøringstelefonbogen:

AS_CLI> cd /System/NetworkAccess List/OCI/Klargøring

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.

 AS_CLI/Maintenance/Managed Objects> få broadworks, og kontrollér, at din output ser OK ud. Se nedenfor for prøveudgang: AS_CLI/Maintenance/Managed Objects> få broadworks Broad Works Managed Objects ========================== * Server: Identitet..............: AS-version...............: Rel_21.sp1_1.551 Administrativ tilstand...: Ulåst * Applikationer: Navneversion Implementeret administrativ tilstand Effektiv tilstand ========================================================================================= Udførelse_og klargøring 21.sp1 1.551 sand Ulåst Ulåst Ulåst Ulåst Ulåst Flash-politik 21.sp1_1.551 falsk Ulåst stoppet åben klientserver 21.sp1_1.551 sand Ulåst ulåst Ulåst Ulåst Web_Container 21.sp1 1.551 sand ulåst ulåst ulåst webcontainer 21.sp1_1.551 sand ulåst ulåst ulåst 4 poster fundet. * Hostede applikationer: Navneversion Kontekststi installeret ================================================================== CommPilot 21.sp1_1.551 / True DeviceManagement Files 21.sp1_1.551 /Enhedsadministration True JWSF iles 21.sp1_1.551 /File Repos True Media Files 21.sp1_1.551 /media true OCIF iles 21.sp1_1.551 /ocifiles True 5 poster fundet. 

Bekræft installeret og aktiv åben klientserver

Brug kommandoerne nedenfor til at installere og starte den åbne klientserver 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> implementere applikationens åbneklientserver

Trin 2: Start serveren med denne kommando:

AS_CLI/Maintenance/ManagedObjects> start applikationens åbneklientserver

Aktivér nummeraktivering

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

Trin 1: Kør kommandoen til nummeraktivering:

AS_CLI> cd-abonnent

Trin 2: Kør den aktiverede aktiveringskommando:

AS_CLI> indstil dnTilstandsgruppe ogaktivering

Trin 3: Indtast Y i bekræftelses-prompten.

Til BroadCloud

Ekstraktværktøjet er integreret i Broad Cloud-tjenesteudbyderportalen. En tjenesteudbyderadministrator kan:

1. Indsend udtræksanmodninger for op til 50 kunder pr. anmodning.
   Udtræksanmodning kan ikke indsendes for den samme kunde mere end 10 gange om dagen.
2. Download den udtrukne datafil i ZIP-format i op til 28 dage fra datoen for anmodning om indsendelse.

Tallene nedenfor viser tjenesteudbyderportalen.

Figur 6: Tjenesteudbyderportal

Figur 7: Tjenesteudbyderportal

For Cisco BroadWorks og Webex forBroad Works

1. Ekstraktværktøjet kører på den sekundære Cisco Broad Works-applikationsserver i partnernetværket og opretter forbindelse via OCI-P.
2. Værktøjet trækker rå virksomhed, gruppe, numre, brugere, tjenester, enheder og softklientens data fra Cisco BroadWorks- eller Broad Cloud-platformen og outputter disse data ud til XML-filer, der leverer input til transformationsværktøjet.

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

Forudsætninger

1. SCP-binærerne til ekstraktværktøjet til sekundær Cisco Broad Works-applikationsserver.
2. SSH til den sekundære Cisco Broad Works-applikationsserver for at konfigurere forudsætningerne og køre ekstraktværktøjet.
3. Konfigurer tjenesteudbyderen og gruppe-id'et til at udtrække fra Cisco Broad Worksi conf/export Tool.yml. Se nedenstående YAML-udsnit:

   TjenesteudbyderID-A:      - gruppeID-A1 - gruppeID-A2 - gruppeID-A3-tjenesteudbyder ID-B:                        - alle 

4. Sørg for, at det sekundære Cisco Broad Works Application Server bruger-id, adgangskode og værtsnavn er korrekt i filen conf/partner.cfg:

   BROADWORKS_USER_ID = administrator BROADWORKS_ADGANGSKODE = administrator BROADWORKS_HOST_NAME = lokalværtsopdatering_TOKEN = partneradministratorens opdateringstoken kopieret fra token-generatorværktøjet. MIGRATION_TILSTAND = 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 Broad Works-migreringer. 

   Egenskaben OPDATER_TOKEN er obligatorisk for en Webex for Broad Works-migrering.

5. Rediger JDK/JRE-miljøstien i export.sh-filen, hvis den sekundære Cisco Broad Works Application Server JDK/JRE-miljøstien er anderledes end filen:

   JAVA_HOME=/usr/lokal/java/java_base

Vejledninger til kørsel

Kør kommandoen nedenfor i den sekundære Cisco Broad Works-applikationsserver fra udtræksværktøjsmappen:

./export.sh

Terminallogfiler

Følgende logfiler er tilgængelige i terminalen ved vellykket eksport: Kørende værktøj til eksport afbredt bløde data:

 Kørende værktøj til eksport af************************************************ bløde data, der starter eksportværktøj v: 1.15.0 Eksport startet for SP=kollalamigreringstest_engg, Group=kollalamigreringstest_engg GRP Eksporterende brugere for SP=kollalamigreringstest_engg, Group=kollalamigreringstest_engg GRP Eksportbrugere fuldført for SP=kollalamigreringstest_engg, Group=kollalamigreringstest_engg GRP Eksport fuldført for SP=kollalamigreringstest_engg, Group=kollalamigreringstest_engg GRP fuldført Export Dump Zip Directory: output/20221017223452_Eksportværktøj tileksport af dump-zip-fil:extracted_data_1666060500618.zip-fil med navnet extracted_data_1666060500618.zip er oprettet ZIP-filoprettelsesprocessen 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æksværktøjsmappe. Brug kommandoen nedenfor til at se og bruge ZIP-filen til input 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 Eksportér Tool.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 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 okt 17 22:35 extracted_data_1666060500618.zip 

Dette transformationsværktøj køres for alle overførsler. Transformationsværktøjet kører på enhver computer, herunder en partners bærbare administratorcomputer, og bruger Webex Public API'er. Den læser ekstraktværktøjets output-ZIP-fil (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 udtaget binarerne til migreringsværktøjer, skal du konfigurere følgende forudsætninger:

1. Indstil REFRESH_TOKEN (token kopieret fra token-generatorværktøjet) og NAVN_PÅ_HOVEDPLACERINGEN_i filen conf/partner.cfg:

   REFRESH_TOKEN=MzDin YjljODEtYm_Q4MS00NGV hLT gwNGU tZjQ1NTE yZTV iNzJk OT dj NAME_OF_MAIN_LOCATION=Main 

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

   KLARGØRING_ID=YmmE4MjFkZGY tYT lkNy00ND dlLWI wODctYmNkOTM2NjUy

   For at få mere komplet bekræftelse af kundens e-mailadresse kan du vælge KLARGØRING_-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 filen input/users.csv.
5. Hvis nye telefoner skal klargøres, skal du tilføje Mac-adressen og e-mailadressen på brugerens nye telefon til filen input/newphones.csv. Dette er kun påkrævet, hvis partneradministratorerne ønsker at klargøre nye telefoner i engrosopkald.
6. Konverter opkaldscentre til Cx Essentials ved at bruge filen input/cxessentials.csv.
7. Du kan også aktivere egenskaben OPGRADERING_ALL_CALL_CENTERS_TO_CX_ESSENTIALS for at konvertere alle opkaldscentre til CxEssentials.
8. Brug filen input/locations.csv til at understøtte den store virksomhedsmigrering, der giver administratorer mulighed for at migrere deres kunders placeringer efter placering
9. Du kan også aktivere brugen af MAC-adresser fra SIP REGISTER-meddelelsens brugeragentheader, når MAC-adressen ikke er tilgængelig i Cisco Broad Works-enhedsprofilen. Fjern kommentarer til linjen "BRUG_MAC_ADDRESS_FROM_SIP_REGISTER=ja" i fil conf/partner.cfg

Udfyldning af input/customers.csv

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

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

Vejledninger til kørsel

Kør transformationsværktøjet i ethvert 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

Benyt følgende fremgangsmåde 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/aktivér python3 -m pip installationsanmodninger python3 -m pip installationsanmodninger-oauthlib 

2. Kør transformationsværktøjet:

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

Forhåndskontrol for kunde/bruger

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

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

forhåndscheck

Ud over at køre præ-check-API'et for kundeoplysningerne kører transformeringsværktøjet også præ-check-API'et for abonnentens e-mails.

forudtjekningsoplysninger

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

Terminallogfiler

Følgende logfiler i terminalen på vellykket transformation:

Oversigtsrapportvirksomheder, der kanoverføres til store virksomheder: 1 StoreVirksomheder, der ikke kan migreres: 0 Broad Works-brugere, der kan overføres: 4 BredeVærker-brugere, der ikke kan overføres: 0 telefoner, der kan overføres: 3 telefoner, der ikke er kompatible med Webex Calling: 0 

Undtagelser rapport

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

Når brugerdataene er blevet ændret for at løse undtagelsen, skal du genåbne ekstrakt- og transformationsværktøjerne med de nye data. Eksempelundtagelsesrapportfilen er som følger:

Undtagelsesrapport d. 18. okt 08:12:09 2022 Virksomheder med anbefaling om kommunikationsforhindring: Konfigurer planen for udgående opkald manuelt i Control Hub ________________________________________________________________________________ collamigrationstest_engg 

Output

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

{ "kunde": { "klargøringsid"!!!!!!!!!!": UDSKIFT_med_PROVISIONINGID!!!!!!!!!!", "pakker": [ "webex_calling", "common_area_calling" ], "eksterntid": "external_id_engg_grp1", "adresse": { "addressLine1": "100 Main Street", "adresseLine2": "", "by": "Gaithersburg", "statEller Provins": "MD", "zipOr Postal Code": "20877", "land": "US" }, "kundeinfo": { "navn": "Engineering Group - 1", "primære-mail": "amareswaranvel+engineeringgroup1@gmail.com" }, "klargøringsparametre": { "calling": { "placering": { "name": "Main", "adresse": "100 Main Street", "adresseLine2": "", "city": "Gaithersburg", "statEllerew_York", "sprog": "en_us", "numre": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "hovednummer": "+15205551101" } } }, "broadworks_info'''{''service_provider_id": "CollamigreringstestSP_engg", "group_id": "CollamigreringstestGRP_engg" }, "abonnenter": [ { "amareswaranvel+benjaminjack@gmail.com": { "abonnent": {"kundeId": "!!!!!!!!!!UDSKIFT_med_CUSTOMERID!!!!!!!!!!", "e-mail": "amareswaranvel+benjaminjack@gmail.com", "pakke": "webex_calling", "klargøringsparametre": { "fornavn": "Benjamin", "efternavn": "Jack", "primærttelefonnummer": "+15205551102", "lokalnummer": "1102" } }, "funktioner": [ { "/v1/people/{personId}/features/voicemail": { "aktiveret": sandt, "sendoptagede opkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "send ubesvarede opkald": { "aktiveret": sandt, "hilsen": "STANDARD", "AntalRinge": 3 }, "meddelelseshukommelse": { "mwiaktiveret": sand, "lagringstype": "EKSTERN", "eksternE-mail": "engineering17861@mailnator.com" } } } ], "enheder": [ { "cisUuid": "!!!!!!!!!!ERSTAT_med_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 7861", "mac": "CC98914EAAD7" } }, { "amareswaranvel+lucasoliver@gmail.com": { "abonnent": { "kundeId": "!!!!!!!!!!REPLACE_med_CUSTOMERID!!!!!!!!!!", "e-mail": "amareswaranvel+lucasoliver@gmail.com", "pakke": "webex_calling", "klargøringsparametre": { "fornavn": "Lucas", "efternavn": "Oliver", "primærttelefonnummer": "+15205551103", "lokalnummer": "1103" } }, "funktioner": [ { "/v1/people/{personId}/features/voicemail": { "aktiveret": sandt, "sendoptagede opkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "send ubesvarede opkald": { "aktiveret": sandt, "hilsen": "STANDARD", "AntalRinge": 3 }, "meddelelseshukommelse": { "mwiaktiveret": sand, "lagringstype": "EKSTERN", "eksternwebex_calling": "engineering16821@mailnator.com" } } ], "enheder": [ {"cisUuid": "!!!!!!!!!!ERSTAT_MED_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 6821", "mac": "5486BCAE7E45" } }, { "amareswaranvel+leojackson@gmail.com": { "abonnent": {"customer_ID": "_REPLACE!!!!!!!!!!", WITH CUSTOMERID "email": "amareswaranvel+leojackson@gmail.com", "pakke": "webex_calling", "klargøringsparametre": { "fornavn": "Leo", "sidstenavn": "Jackson", "primærttelefonnummer": "+15205551104", "udvidelse": "1104" sandt, "sendoptagede opkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "send ubesvarede opkald": { "aktiveret": sandt, "hilsen": "STANDARD", "AntalRinge": 3 }, "meddelelseshukommelse": { "mwiaktiveret": sand, "hukommelsestype": "EKSTERN", "eksternE-mail": "engineeringmacpc@mailnator.com" } } ], "enheder": [] } }, { "amareswaranvel+owenalex@gmail.com": { "abonnent": { "kunde_id": "!!!!!!!!!!ERSTAT_MED_CUSTOMERID!!!!!!!!!!", "e-mail": "amareswaranvel+owenalex@gmail.com", "pakke": "webex_calling", "klargøringsparametre": { "fornavn": "Owen", "sidstenavn": "Alexander", "primærttelefonnummer": "+15205551101", "forlængelse": "1101" }, "funktioner": [ { "/v1/people/{personId}/features/voicemail": { "aktiveret": sandt, "sendoptagede opkald": { "aktiveret": sand, "hilsen": "STANDARD" }, "send ubesvarede opkald": { "aktiveret": sandt, "hilsen": "STANDARD", "AntalRinge": 3 }, "meddelelseshukommelse": { "mwiaktiveret": sand, "lagringstype": "EKSTERN", "eksterne-mail": "engineering8811@mailnator.com" } } } ], "enheder": [ { "cisUuid": "!!!!!!!!!!ERSTAT_med_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 8811", "mac": "F87B204E4066" } ], "auto_attendants":...call_queues":...hunt_groups": [], "planer": [], "call_parks":...call_pickups":...paging_groups":...voice_portals": [ { "navn": "Automatiseret stemmeportal", "fornavn": "Automatiseret", "efternavn": "Stemmeportal", "sprogkode": "en_us", "telefonnummer": "+15205551105", "forlængelse": "1105" } ], "shared_call_appearances":...business_communicator_desktop_to_upgrade_to_webex_app": ["PC Comm - Engg Enhedsprofil"], "connect_client_to_upgrade_to_webex_app": [], "placeringer": [], "webex_for_broadworks_info": { "brugere": [ { "id": "Y2lzY89zcGF yazovL3VzL1NVQLNDUKLCRVIVvY2QzNGV iNWY tYTVMMi00OWQ1LT lkNWM tZTG1MDJ iMDE4YTQ5" } ], "hydra_orgId": "Y2lzY500zcGFyazovL3VzL3VzL09SR0FOSVPBVELPTI9JMJJiYTM wNC1mODQ4LTR lOTktYWF mYy0zYWR lMjBmYTGZG", "hydra_customer_config_id": "Y2lzY աzcGF yazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDE tMTU zMS00MzNiLT llM2QtODEXY2FlYTEXYmVk" } } 

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

Forudsætninger

Konfigurer følgende forudsætninger i kataloget til klargøringsværktøj:

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 udtaget binærerne Migreringsværktøjer, skal du indstille variablen JAVA_HOME-miljø i provisioning_tool.sh for MAC og provisioning_tool.bat for Windows.
3. Filen partner.cfg:
   • Indstil ENGROS_KLARGØRING_ID og OPDATER_TOKEN (token kopieret fra token-generatorværktøjet). Partneradministratorer skal kontakte deres kontoteam for at få KLARGØRING_id'et:

     engroshandel_klargøring_ID = Y2U4YWQX YMQtMWZ lNy00NjRiLWE xMmItMGJ kODMZZN2U5NmU0 OPDATERING_TOKEN=MzDin YjljODEtYmQ4ms00ngvhLT gwNGU tZjQ1NTE yZTViNzJkOT dj 

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

4. Brug WEBEX4BWKS_EMAIL_SUBJECT-egenskab for Webex for Broad Works-migreringer til at sende e-mailemnet for anmodning om ændring af adgangskode for Webex for_ Broad Works-abonnenter.
5. Brug WEBEX4BWKS_EMAIL_BODY-egenskab til Webex for Broad Works-migreringer til at sende e-mailtekst til anmodning om ændring af adgangskode for abonnenter på Webex for_ Broad Works.

For Broad Cloud-migreringer er det samme område:

1. Værktøjet overskrider klargøringen af numre, enheder og visning af delte opkald.
2. Værktøjet opretter brugere og virtuelle brugere med lokalnummer og midlertidigt lokalnummer.

For Broad Cloud-migreringer en anden region:

1. Værktøjet klargør numre, enheder og visning af delte opkald.
2. Værktøjet opretter brugere og virtuelle brugere med faktiske telefonnumre og lokalnummer.
   Alle Europe Broad Cloud-migreringer er til en anden region.

Vejledninger til kørsel

Brug nedenstående trin til at køre værktøjet i Windows og macOS:

Windows

Benyt følgende fremgangsmåde for at køre værktøjet på Windows OS:

For at klargøre en enkelt kunde: provision.bat -input= For at klargøre flere kunder: provision.bat -input= 

macOS

Benyt følgende fremgangsmåde for at køre værktøjet på macOS:

For at klargøre enkelt kunde: ./transform.sh -input= For at klargøre flere kunder: ./transform.sh -input= 

Forudsætninger for Webex til Broad Works-migrering

Partneradministratorer skal opdatere deres Broad Works-onboardingskabelon til Webex forBroad Works-funktioner. Se billedet nedenfor:

Kør klargøringsværktøjet med et ekstra argument for Webex for Broad Works til engrosmigration.

Forberedelsesfase: er standardfasen, hvor administratorer kan klargøre brugerne afBroad Works som en engrosabonnement og fortsætte med Webex forBroad Works-brugere.

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

Fase efter migrering: Er den sidste fase, hvor administratorer kan konvertere det brede arbejde tilengroshandel fuldstændigt. Du skal køre klargøringsværktøjet med et argument efter migrering.

Terminallogfiler

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

Værktøjsnavn: Version af klargøringsværktøj: 1.15.0 ********** Påbegyndt behandlingsfil: input/customer.json **************** Klargøring af kunde venter på kunde external_id_engg_grp1 for at fuldføre klargøringen... Venter på, at kunde external_id_engg_grp1 fuldfører klargøringen ...   Kunde external_id_engg_grp1-status: klargjorte klargøringsnumre Klargøringsbrugere Klargøringsfunktioner Klargøringshilsner Klargøringsplaner Klargøringsenheder Enheder Klargøring Visning af delte opkald Klargøring Automatisk omstilling Klargøringskøer Klargøringskøer Klargøringsgrupper Klargøringsgrupper Klargøring Parkering af opkald Klargøring Opkaldsbesvarelser Klargøringsstemmeportal ********** Gennemført fil: indtast/kunde.json **************** 

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

Output

Klargøringsværktøjet genererer succesrapporter og fejlrapporter i output/<external_id>/*.success/error-filerne . Gennemgå succeslogfiler 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 Broad Cloud-partnere skal du bruge tjenesteudbyderportalen til at indsende en migreringsanmodning for numre, enheder og SCA-migreringer.

I tjenesteudbyderportalen kan en migreringsanmodning omfatte op til 50 kunder. Maksimalt 10 anmodninger kan indsendes inden for en dag.

Tallene nedenfor viser tjenesteudbyderportalen.

Figur 12: Tjenesteudbyderportal

Figur 13: Tjenesteudbyderportal

For Cisco BroadWorks og Webex forBroad Works

For Cisco Broad Worksog Webex for Broad Works-migreringer kører værktøjet på den sekundære Cisco Broad Works-applikationsserver i partnernetværket og opretter forbindelse til AS via OCI-P. Den bruger filen Transform Tool output JSON (customer.json) som input og udfører OCI-P-kommandoerne for at migrere enheder og softwareklienter.

Når funktionen er gennemført, vil enhedens flytningsværktøj:

1. Fjern registreringen af enheder fra Cisco Broad Works, og registrer dem i engros.
2. Brugere, der bruger UC-One-klienten, omdirigerer til Webex-appen ved første logon.
3. Deaktiver telefonnumrene fra Cisco Broad Works, eller fjern telefonnumrene fra BroadCloud.
4. Aktivér numre i engroshandel.
5. Opret delte opkaldsforekomster i engros for Broad Cloud-migreringer. [Dette trin gælder kun for Broad Cloud-migreringer].

SCP og SSH

1. SCP-enheden flyttes værktøjet til den sekundære Cisco Broad Works-applikationsserver.
2. SSH til den sekundære Cisco Broad Works-applikationsserver for at konfigurere forudsætningerne og køre enhedens flytningsværktøj.

Forudsætninger

1. Indstil REFRESH_TOKEN (token kopieret fra token-generatorværktøjet) i filen conf/partner.cfg:

   REFRESH_TOKEN=MzDin YjljODEtYmQ4ms00ngvhLT gwNGU tZjQ1NTE yZTV iNzJkOT dj

2. Sørg for, at det sekundære Cisco Broad Works Application Server bruger-id, adgangskode og værtsnavn er korrekt i filen conf/device MoveTool.conf:

   BROADWORKS_BRUGER_ID = administrator BROADWORKS_ADGANGSKODE = administrator BROADWORKS_VÆRT_NAVN = lokalvært 

3. Kontrollér, at JDK/JRE-miljøstien er korrekt i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. 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 Broad Works til Engrosopkald skal en partneradministrator oprette en ny identitetstypefil/enhedsprofil på systemniveau i Cisco Broad Works hver Polycom-enhedsskabelon. Se figur 14, og overfør den brugerdefinerede filfil device-move-tool/conf/devicepolycom_vvx.cfg. Efter overførsel af den nye enhedsfil skal du sikre, at den nyligt oprettede fil findes på gruppeniveau. Sørg også for, at filen migration_%BWMAC ADDRESS%.cfg ikke er i konflikt med nogen eksisterende fil i dit system).

Den bruges internt af enhedens flytningsværktøj.

Overførselsprocessen for Polycom-telefoner:

1. Enhedsflytningsværktøjet erstatter fil %BWMACADDRESS%.cfg på enhedsniveau med polycom_vvx2.cfg. Bemærk, at denne fil henviser til migration_%BWMACADDRESS%.cfg.
2. Genopret enhedsprofilerne på gruppeniveau eller enhedsniveau.
   Handling på gruppeniveau eller enhedsniveau afhænger af konfigurationen af parameterenhedsniveauRebuild i filenhed-move-tool/conf/partner.cfg.
3. Værktøjet til flytning af enheder beder Cisco Broad Works-applikationsserveren om at genstarte telefoner på gruppe- eller enhedsniveau.
4. Efter anmodningen om genstart downloader og processer Polycom-telefoner% BWMACADDRESS%.cfg, hvilket beder Polycom-telefonerne om at downloade og process migration_%BWMACADDRESS%.cfg, hvilket indstiller enheden.prov.server-navnet tilhttps://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 administreres af Webex Calling DMS.

Figur 14: Tilføjelse af identitetstypefil/enhedsprofil

Vejledninger til kørsel

Der er to metoder til at påberåbe DMT. Den første er at påberåbe sig 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 Broad Works-applikationsserver i enhedsflytningsværktøjslinjen:

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 Derudover understøtter enhedsflytningsværktøjet migrere enkelte/specifikke telefoner fra version 1.35.0. Brug kommandoen nedenfor: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminallogfiler

Følgende er logfilerne i terminalen ved vellykket kørsel af enhedsflytningsværktøjet til enhedsmigrering:

Værktøjsnavn: Version af værktøj til flytning af enhed: 1.15.0 Enhedsværktøj startet... Gyldige enheder til migrering: ------------------------------------------------------------------------------------------------------------------- | 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 migrere alle disse enheder? ([Y]es eller [N]o) ja Overførsel af enhedsprofiler til DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Completed Reboot Process Started Reboot Process Completed Modification Profiler for Business Communicator under Group Collamigration test GRP_engg Aktivér processen for Webex-telefonnumre, der er startet for kunde organisations-id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktivér processen for webex-telefonnumre gennemført for kunde organisations-id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Deaktiver proces for broadworks-telefonnumre startet for gruppe-id: collamigreringstest_engg GRP Deaktiver Broadworks-telefonnummerprocessen fuldført for gruppe-id: collamigreringstest_engg GRP-enhedsmigrering gennemført 

Output

Efter enhedsmigreringen er enheder kommet online og klar til at foretage/modtage opkald. Se figur 15 for at se et eksempel på enhedsstatus:

Figur 15: Enhedsstatus

Efter enhedsmigreringen er numre kommet aktive. Se figur 16 for at se et eksempel på tal er aktive:

Figur 16: Numre er aktive

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

Til BroadCloud-udbyder

Gendannelsesprocessen for Broad Cloud-partnere er som følger:

1. Åbn en billet med Cisco TAC for at anmode om, at enheden vender tilbage.
2. Kør værktøjet til flytning af enheden i tilbagevendende tilstand:
   • Telefonnumre vil blive fjernet fra Webex Calling, og brugere og tjenester vil kun blive efterladt med lokalnumre.
   • E-mailadresser i Webex Calling vil blive omstillet til midlertidige e-mailadresser.
   • Telefoner vil blive slettet fra Webex Calling.
   • Telefonnumre, e-mailadresser, der bruges som alternativeID'er, og telefoner gendannes i BroadCloud.
   • Telefoner genstartes.
3. Partneradministratorer skal flytte PSTN-telefonnumre tilbage til BroadCloud Carrier.

For Cisco BroadWorks og Webex forBroad Works

Tilbagekaldsprocessen for Cisco Broad Works og Webex forBroad Works er som følger:

1. Åbn en billet med Cisco TAC for at anmode om, at enheden vender tilbage.
2. Kør værktøjet til flytning af enheden i tilbagevendende tilstand på den sekundære applikationsserver tilBroad Works for at gendanne enhedsmigreringen. Dette vil indstille DMS-URL-adressen til tjenesteudbyderens DMS-URL-adresse for enhedsprofiler i Cisco Broad Works og genaktivere telefonnumre.
3. Webex Calling-teamet indstiller DMS-URL-adressen 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.

Vejledning i at køre enheden flyttes værktøjet i tilbagevendende tilstand

Følg trinene nedenfor for at køre enhedens flytningsværktøj i tilbagevendende tilstand:

Kør kommandoen nedenfor i den sekundære Cisco Broad Works-applikationsserver i enhedens flytningsværktøjslinje:

Gendan profiler

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

Gendan numre

./devicemove.sh -input=  -tilbagefør numre

Terminallogfiler

Vi henter følgende logfiler i terminalen ved vellykket kørsel af enhedens flytningsværktøj til nulstilling:

Gendan profiler

Værktøjsnavn: Version af værktøj til flytning af enhed: 1.15.0 Enhedsværktøj startet til tilbagevendelsesproces... 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 Broad Works-------------------------------------------------------------------------------------------------------------------? (Ja, Y, Nej, N):  ja Overførsel af enhedsprofiler til DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Completed Genstart Process Genstart Genstart Process Genstart Proces Fuldført Enhedsmigrering Enhedsoverførsel fuldført for Deklarationsprocessen 

Gendan numre

Værktøjsnavn: Version af værktøj til flytning af enhed: 1.15.0 Vil du fortsætte med at gendanne numre til Broadworks ?  ([Y]es eller [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Start tilbagekald Aktivér udsendelsestelefonnummerprocessen startet for gruppe-id: collamigreringstest_engg GRP Aktivér broadworks-telefonnummerprocessen fuldført for gruppe-ID: collamigreringstest_engg GRP – Enhedsmigrering – tilbagevendende proces gennemført