Støttede telefoner opprettes automatisk og tilordnes brukere i Webex Calling av klargjøringsverktøyet. Telefonene merket med «ja» i kolonnen «Støttes i enhetsflytteverktøyet» vil også automatisk bli flyttet fra Cisco BroadWorks eller BroadCloud til Webex Calling når enhetsflytteverktøyet kjøres. Telefoner merket med «Nei» i den kolonnen krever en manuell inngripen for å endre DMS-URL-en i Cisco BroadWorks-enhetsmalen eller i selve telefonen.

Den siste kolonnen viser tilordningen av telefonmodeller til kolonnen «Enhetstype» i filen. transform-tool/input/newphones.csv. (Se delen Transformeringsverktøy i denne artikkelen for mer informasjon om newphones.csv).

Partneradministratorer kjører dette tokengeneratorverktøyet minst én gang før de begynner å kjøre migreringsverktøy. Kjøring av dette verktøyet er en engangsaktivitet etter at partnerkontoen er registrert i Wholesale RTM-løsningen. Dette verktøyet lar partneradministratorer logge inn via nettleseren for å få den unike TOKEN-en som trengs for å oppdatere partnerkonfigurasjonsfilene for migreringsverktøyene.

Forutsetninger

Installer Java 8, 11, 17 eller 21 på datamaskinen. Java er tilgjengelig fra mange kilder, inkludert:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

Etter nedlastingen, pakk ut binærfilene for migreringsverktøyet.

Instruksjoner for å kjøre

Kjør følgende kommando i terminalen i tokengeneratorkatalogen:

Vinduer:

token_generator.bat

MacOS:

./token_generator.sh

Produksjon:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

Åpne URL-en i nettleseren på terminalen, logg inn med partneradministratorens påloggingsinformasjon for å hente TOKEN-en, og kopier den for videre bruk.

Illustrasjonene av brukergrensesnittet er gitt nedenfor som referanse:

Figur 3: Logg inn med Cisco Webex

Figur 4: Vinduet for legitimasjon

Figur 5: Tokengenerering

Konfigurer følgende trinn før du kjører verktøyene for uttrekking og enhetsflytting på den sekundære BroadWorks-serveren.

Aktiver OCI-P-tilkobling

Verktøyet for enhetsflytting kommuniserer med BroadWorks via OCI-P-kommandoer. Følg trinnene nedenfor for å aktivere OCI-P-tilkobling:

Trinn 1: Bruk CLI til å konfigurere generelle innstillinger.

Kjør følgende kommando i CLI for å bytte til GeneralSettings-katalogen:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Kjør følgende kommando i CLI for å hente gjeldende GeneralSettings:

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

Hvis innstillingene dine ikke samsvarer med det ovennevnte, bruk kommandoen set for å konfigurere innstillingene på nytt.

Trinn 2: Bruk CLI-en til å konfigurere OCI-proxyen.

Endre katalogen til OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Kjør følgende CLI for å hente gjeldende innstillinger. Du bør se følgende:

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

Hvis innstillingene dine ikke samsvarer med det ovennevnte, bruk kommandoen set for å konfigurere innstillingene på nytt.

Trinn 3: Bruk CLI-en til å konfigurere OCI-klargjøring.

Endre til klargjøringskatalogen:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kjør følgende kommando for å hente de gjeldende OCI-klargjøringsinnstillingene:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

Trinn 4: Kjør kommandoen nedenfor i CLI for å bekrefte at konfigurasjonen din er riktig.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
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 entries found.

Bekreft at åpen klientserver er distribuert og aktiv

Bruk kommandoene nedenfor for å distribuere og starte Open Client Server på den sekundære applikasjonsserveren hvis den ikke er distribuert eller ikke allerede har startet.

Trinn 1: Distribuer serveren med følgende CLI-kommando:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Trinn 2: Start serveren med denne kommandoen:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktiver tallaktivering

Kjør følgende kommandoer i CLI for å aktivere aktivering av tallene:

Trinn 1: Kjør kommandoen for tallaktivering:

AS_CLI> cd SubscriberMgmt/NumberActivation

Trinn 2: Kjør kommandoen for aktivering aktivert:

AS_CLI> set dnMode groupAndUserActivationEnabled

Trinn 3: Skriv inn Y ved bekreftelsesspørsmålet.

For BroadCloud

Uttrekksverktøyet er integrert i BroadCloud-tjenesteleverandørportalen. En tjenesteleverandøradministrator kan:

1. Send utdragsforespørsler for opptil 50 kunder per forespørsel.
   Uttrekksforespørsel kan ikke sendes inn for samme kunde mer enn 10 ganger om dagen.
2. Last ned den utpakkede datafilen, i ZIP-format, i opptil 28 dager fra forespørselens innsendingsdato.

Figurene nedenfor viser tjenesteleverandørportalen.

Figur 6: Tjenesteleverandørportal

Figur 7: Tjenesteleverandørportal

Forespørsel om CSV-uttrekk

Start forespørsel om CSV-uttrekk

1. Last ned kundens CSV-fil

   Klikk på lenken Last ned kunde-CSV øverst til høyre i delen Start forespørsel om CSV-uttrekk.

2. Rediger kundelisten

   Administratoren kan redigere denne CSV-filen slik at den bare inkluderer kundene som uttrekket må utføres for.

3. Last opp og send inn

   Etter redigering, last opp den endrede CSV-filen.

   Klikk på Send inn for å starte en uttrekksforespørsel for de oppførte kundene og deres tilknyttede lokasjoner.

Start uttrekksforespørsel for en kunde med lokasjons-CSV

1. Velg kunde- og nedlastingssteder

   Velg en kunde fra rullegardinmenyen.

   Last ned den tilhørende locations.csv fra Vis kunder→ Steder-fanen → Eksporter steder som CSV.

2. Rediger plasseringsfilen

   Administratoren kan redigere CSV-filen slik at den bare inkluderer de stedene de ønsker å trekke ut.

3. Last opp og send inn

   Last opp den redigerte locations.csv-filen og klikk på Send inn.

   Bare de angitte stedene for den valgte kunden vil bli inkludert i uttrekksforespørselen.

Start uttrekksforespørsel for alle kunder

1. Klikk på Send inn for å starte en uttrekksforespørsel for alle kunder og alle deres lokasjoner under den nåværende tjenesteleverandøren.

For Cisco BroadWorks og Webex for BroadWorks

1. Uttrekksverktøyet kjører på den sekundære Cisco BroadWorks Application Server i partnernettverket og kobler til via OCI-P.
2. Verktøyet henter rå data fra bedrifter, grupper, tall, brukere, tjenester, enheter og mykklienter fra Cisco BroadWorks- eller BroadCloud-plattformen og sender disse dataene ut til XML-filer som gir inndata for transformasjonsverktøyet.

De neste avsnittene forklarer hvordan du installerer og konfigurerer uttrekksverktøyet.

Forutsetninger

1. SCP-ekstraktverktøyets binærfiler til den sekundære Cisco BroadWorks-applikasjonsserveren.
2. SSH til den sekundære Cisco BroadWorks-applikasjonsserveren for å konfigurere forutsetningene og kjøre utpakkingsverktøyet.
3. Konfigurer tjenesteleverandøren og gruppe-ID-en for å hente ut fra Cisco BroadWorks i conf/exportTool.yml. Se følgende eksempel på YAML-kodebit:

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

4. Sørg for at bruker-ID, passord og vertsnavn for den sekundære Cisco BroadWorks-applikasjonsserveren er riktige i conf/partner.cfg fil:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   Egenskapen REFRESH_TOKEN er obligatorisk for en Webex for BroadWorks-migrering.

5. Endre JDK/JRE miljøbanen i export.sh-filen hvis den sekundære Cisco BroadWorks-applikasjonsserveren JDK/JRE miljøstien er forskjellig fra filen:

   JAVA_HOME=/usr/local/java/java_base

Instruksjoner for å kjøre

Kjør følgende kommando i den sekundære Cisco BroadWorks-applikasjonsserveren fra utpakkingsverktøykatalogen:

./export.sh

Terminallogger

Følgende logger er tilgjengelige i terminalen etter vellykket eksport: Kjører BroadSoft Data Export Tool:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

Produksjon

En ZIP-fil (extracted_data_<timestamp>.zip) som utdata er tilgjengelig i samme katalog for utpakkingsverktøyet. Bruk følgende kommando for å vise og bruke ZIP-filen for inndata i Transform Tool:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

Dette transformasjonsverktøyet kjører for alle migreringer. Transformeringsverktøyet kjører på alle datamaskiner, inkludert en partners administrator-bærbare PC, og bruker Webex Public API-er. Den leser ZIP-filen (extracted_data_<timestamp>.zip) fra utpakkingsverktøyet som input og transformerer den rå XML-filen til et JSON-format som brukes av klargjøringsverktøyet.

Forutsetninger

Etter at du har lastet ned og pakket ut binærfilene for migreringsverktøyene, konfigurerer du følgende forutsetninger:

1. Angi REFRESH_TOKEN (token kopiert fra Token Generator Tool) og NAVN_PÅ_HOVEDPLASSERING_i conf/partner.cfg fil:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Angi eventuelt PROVISIONING_-ID-en (kopiert fra malen i Partner Hub) i conf/partner.cfg fil:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For å få en mer fullstendig bekreftelse av kundens e-postadresse kan du eventuelt angi PROVISIONING_ID.
3. Konfigurer manglende informasjon i input/customers.csv fil (se neste avsnitt) hvis den mangler.
4. Legg til sluttbrukerens e-postadresse i input/users.csv fil.
5. Hvis nye telefoner skal klargjøres, legg til MAC-adressen og e-postadressen til brukerens nye telefon i input/newphones.csv fil. Dette er bare nødvendig hvis partneradministratorene ønsker å klargjøre nye telefoner i Engrosanrop.
6. Konverter BroadWorks-kundesentrene til CxEssentials ved å bruke input/cxessentials.csv fil.
7. Du kan eventuelt aktivere egenskapen OPPGRADER_ALLE_KUNDESENTRE__TIL_CX_ESSENTIALS for å konvertere alle kundesentre til CxEssentials.
8. Bruk input/locations.csv fil for å støtte migreringen av store bedrifter som lar administratorer migrere kundenes lokasjoner etter lokasjon
9. Aktiver eventuelt bruk av MAC-adresser fra User-Agent-overskriften i SIP REGISTER-meldingen når MAC-adressen ikke er tilgjengelig i Cisco BroadWorks-enhetsprofilen. Fjern kommenteringen av linjen «BRUK_MAC_ADRESSE_FRA_SIP_» REGISTER=yes" i filen conf/partner.cfg
10. Funksjonen for synkronisering av nettverksserveren lar administratorer klargjøre telefonnumre, MAC-adresser og brukeres e-postadresser under klargjøringen i samme regionmigrering. For å aktivere det, sett USE_NS_SYNC=yes i conf/partner.cfg.

    Hvis NS-synkronisering er deaktivert, vil klargjøring av telefonnummer og enhet bli hoppet over, og brukerne vil få midlertidige e-postadresser.

11. Aktiver eventuelt egenskapene ANALOG_BRUKER_TYPE_AKTIVER_SAMTALE_VENTER, ANALOG_BRUKER_TYPE_AKTIVER_MUSIKK_PÅ_HOLD og ANALOG_BRUKER_TYPE_DEAKTIVER_T38 for å konfigurere samtale venter, musikk på vent og deaktivere T38-innstillinger for alle brukere av analog type.

Fylling av input/customers.csv

Filen input/customers.csv gir data som kanskje mangler i Cisco BroadWorks eller BroadCloud. Denne filen kan stå tom hvis all obligatorisk informasjon allerede er tilgjengelig. Du trenger ikke å fylle ut alle kolonnene, bare manglende informasjon er obligatorisk.

Tabellen nedenfor forklarer de viktigste kolonnene i input/customers.csv.

Fylling av input/users.csv

Filen input/users.csv gir data som kanskje mangler i Cisco BroadWorks eller BroadCloud. Denne filen kan stå tom hvis all obligatorisk informasjon allerede er tilgjengelig. Du trenger ikke å fylle ut alle kolonnene, bare manglende informasjon er obligatorisk.

Instruksjoner for å kjøre

Kjør Transform Tool i et hvilket som helst operativsystem. Bruk trinnene nedenfor for å kjøre verktøyet i Windows og macOS:

Vinduer

Kjør kommandoen nedenfor for å kjøre Transform Tool i Windows:

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

macOS

Utfør følgende trinn for å kjøre transformeringsverktøyet på macOS:

1. Opprett et virtuelt miljø og installer avhengigheter for å kjøre transformeringsverktøyet ved hjelp av Python:

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

2. Kjør transformeringsverktøyet:

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

Customer/user forhåndssjekk

Transformeringsverktøyet foretar API-kall til Webex for å fange opp potensielle klargjøringsproblemer. Som standard vil den validere kundens adresse og primære e-postadresse. Hvis verdien for PROVISIONING_ID er spesifisert i conf/partner.cfg filen, vil den også validere posisjonsinformasjon. Resultatene av forhåndskontrollen er inkludert i unntaksrapporten.

I tillegg kan følgende valgfrie parametere legges til når transformeringsverktøyet kjøres:

forhåndssjekk

I tillegg til å kjøre forhåndssjekk-API-et for kundeinformasjonen, vil Transform Tool også kjøre forhåndssjekk-API-et for abonnentens e-postadresser.

forhåndssjekkinformasjon

Som standard er det bare forhåndssjekkfeil (dvs. problemer som blokkerer klargjøring) som inkluderes i unntaksrapporten. Hvis du legger til dette flagget, vil det også inkludere vellykkede forhåndssjekkresultater (f.eks. hvis det allerede finnes en Webex-organisasjon som kan kobles til automatisk).

Terminallogger

Følgende logger i terminalen ved vellykket transformasjon:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Unntaksrapport

Transform Tool genererer unntaksrapporten i output/<timestamp>/exception_report.txt katalog. Du kan bruke denne rapporten til å identifisere problemene som vil påvirke migreringen og løse dem i Cisco BroadWorks-systemet.

Etter at du har endret brukerdataene for å løse unntaket, kjør uttrekks- og transformeringsverktøyene på nytt med de nye dataene. Eksempelfilen for unntaksrapporten er som følger:

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

Produksjon

En JSON-utdatafil (customer.json) vil være tilgjengelig i output/<timestamp>/<groupid> katalog. Eksempelfilen customer.json er som følger:

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

Klargjøringsverktøyet kan kjøres på hvilken som helst maskin, vanligvis (partnerens administrator-bærbare PC), og bruker Webex Public API-er. Den leser JSON-filen (customer.json) fra transformeringsverktøyet som inndata og klargjør kunder, steder, numre, brukere, tjenester og enheter i Webex Wholesale RTM-løsningen.

Forutsetninger

Konfigurer følgende forutsetninger i katalogen for klargjøringsverktøyet:

1. Installer Java 8, 11, 17 eller 21 på datamaskinen. Java er tilgjengelig fra mange kilder, inkludert:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Etter at du har lastet ned og pakket ut binærfilene for migreringsverktøyene, angir du JAVA_HOME-miljøvariabelen i provisioning_tool.sh for MAC og provisioning_tool.bat for Windows.
3. partner.cfg-filen:
   • Angi ID-en for ENGROS_PROVISIONING_og OPPDATERINGS-TOKEN_(token kopiert fra tokengeneratorverktøyet). Partneradministratorene må kontakte kontoteamet sitt for å få PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Sett ALLOW_ADMIN_INVITE_EMAILS til false hvis partneren ikke ønsker å sende en velkomst-e-post til brukerne. Standardverdien er sann.

4. Bruk WEBEX4BWKS_EMAIL_SUBJECT-egenskapen for Webex for BroadWorks-migreringer for å sende e-posten med emnet for forespørsel om passordendring for Webex for BroadWorks-abonnenter.
5. Bruk WEBEX4BWKS_EMAIL_BODY-egenskapen for Webex for BroadWorks-migreringer til å sende e-postforespørselen om passordendring for Webex for BroadWorks-abonnenter.
6. Funksjonen for synkronisering av nettverksserveren lar administratorer klargjøre telefonnumre, MAC-adresser og brukeres e-postadresser under klargjøringen i samme regionmigrering. For å aktivere det, sett USE_NS_SYNC=yes i conf/partner.cfg.

   Hvis NS-synkronisering er deaktivert, vil klargjøring av telefonnummer og enhet bli hoppet over, og brukerne vil få midlertidige e-postadresser.

For BroadCloud-migreringer i samme region:

1. Verktøyet hopper over klargjøring av numre, enheter og delte samtaleopptredener.
2. Verktøyet oppretter brukere og virtuelle brukere med utvidelse og midlertidig utvidelse.

For BroadCloud-migreringer til en annen region:

1. Verktøyet vil klargjøre numre, enheter og delte samtaleopptredener.
2. Verktøyet oppretter brukere og virtuelle brukere med faktiske telefonnumre og internnummer.
   Alle BroadCloud-migreringer i Europa skjer til en annen region.

Instruksjoner for å kjøre

Bruk følgende trinn for å kjøre verktøyet i Windows og macOS:

Vinduer

Utfør følgende trinn for å kjøre verktøyet på Windows OS:

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

Utfør følgende trinn for å kjøre verktøyet på macOS:

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

Forutsetninger for Webex for BroadWorks-migrering

Partneradministratorer må oppdatere sin BroadWorks-introduksjonsmal for Webex for BroadWorks-sameksistensfunksjoner. Se følgende bilde:

Når Webex for BroadWorks onboarding-malen er oppdatert for å støtte migrering, ber du Cisco-kontoteamet om å aktivere funksjonen «engros-partner-blanding-aktivert» på partnernivå. Dette vil tillate at engrospakker legges til eksisterende Webex for BroadWorks-kundeorganisasjoner under klargjøring.

Kjør klargjøringsverktøyet med et ekstra argument.

Forberedelsesfase: er standardfasen der administratorer kan klargjøre BroadWorks-brukere som en engros-abonnent og fortsette med Webex for BroadWorks-brukere.

Vedlikeholdsfase: er den andre fasen der administratorer kan tilordne engros-lisensen til eksisterende Webex for BroadWorks-brukere. Du må kjøre klargjøringsverktøyet med argumentet maintenance.

Fase etter migrering: Er den siste fasen der administratorer kan konvertere BroadWorks til Wholesale fullstendig. Du må kjøre klargjøringsverktøyet med et argument postmigration.

Terminallogger

Følgende er loggene i terminalen for vellykket klargjøring:

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

En tabell vil bli skrevet ut med antall lokasjoner opprettet for hver kjøring:

Produksjon

Provisioneringsverktøyet genererer suksess- og feilrapporter i output/<external_id>/*.success/error filer. Gjennomgå logger for suksess og feil for å bekrefte vellykket klargjøring.

Partneradministratorer kan bekrefte kundeklargjøringen i Partner Hub og Control Hub-portalen. Se følgende illustrasjoner fra Partner Hub og Control Hub-portalen:

Figur 8: Partnerhub

Figur 9: Kontrollsenter

Figur 10: Enheter

Figur 11: Ringer

For BroadCloud

For BroadCloud-partnere, bruk tjenesteleverandørportalen til å sende inn en migreringsforespørsel for numre, enheter og migreringer av delte samtaleopptredener (SCA).

Innenfor tjenesteleverandørportalen kan en migreringsforespørsel inkludere opptil 50 kunder. Maksimalt 10 forespørsler kan sendes inn i løpet av en dag.

Funksjonen for nettverksserversynkronisering lar administratorer deaktivere broadCloud-plasseringen og aktivere Webex Calling-plasseringen ved å angi USE_NS_SYNC=yes i conf/partner.cfg. Etter migrering aktiveres enheter og telefonnumre på Webex Calling-plasseringen.

Administratorer kan aktivere automatisk tilbakerulling ved å angi ROLLBACK_TO_BROADCLOUD=true i conf/partner.cfg -filen, som flytter enheter tilbake til BroadCloud etter migrering. Den støtter både migreringer i samme og forskjellige regioner med NS Sync, men bare for vellykkede migreringer. For mislykkede systemer må administratorer opprette en Cisco TAC før de ber om tilbakestilling.

Det finnes to alternativer for å velge migreringstype i portalen:

• Migrering – Velg dette alternativet for å starte en forespørsel om migrering av numre, enheter og delte samtaleopptredener (SCA).
• Enhetsstatus – Velg dette alternativet for å se gjeldende status for en enhet på BroadCloud og Calling.

Figurene nedenfor viser tjenesteleverandørportalen.

Figur 12: Tjenesteleverandørportal

Figur 13: Tjenesteleverandørportal

Migrer valgte steder (valgfritt)

For å starte migreringen for et bestemt delsett av steder som er oppført i customer.json -filen, må du legge ved en locations.csv -fil med forespørselen din. Denne CSV-filen skal bare liste opp stedene du har tenkt å migrere.

For å laste ned listen over tilgjengelige aktive steder, naviger til Vis kunder → Velg en kunde → Eksporter steder som CSV.

Figur 14: Eksporter steder som CSV

For Cisco BroadWorks og Webex for BroadWorks

For Cisco BroadWorks- og Webex for BroadWorks-migreringer kjører verktøyet på den sekundære Cisco BroadWorks-applikasjonsserveren i partnernettverket og kobler seg til AS-et via OCI-P. Den bruker Transform Tool-utdatafilen JSON (customer.json) som input og kjører OCI-P-kommandoene for å migrere enheter og programvareklienter.

Ved vellykket operasjon vil verktøyet for enhetsflytting:

1. Avregistrer enheter fra Cisco BroadWorks og registrer dem i Wholesale.
2. Brukere som bruker UC-One-klienten vil omdirigere til Webex-appen ved første gangs pålogging.
3. Deaktiver telefonnumrene fra Cisco BroadWorks eller fjern telefonnumrene fra BroadCloud.
4. Aktiver tall i Engros.
5. Opprett delte anropsopptredener i Wholesale for BroadCloud-migreringer. [This trinnet gjelder kun for BroadCloud migrations].

SCP og SSH

1. SCP verktøyet for enhetsflytting til den sekundære Cisco BroadWorks-applikasjonsserveren.
2. SSH til den sekundære Cisco BroadWorks-applikasjonsserveren for å konfigurere forutsetningene og kjøre verktøyet for enhetsflytting.

Forutsetninger

1. Sett REFRESH_TOKEN (token kopiert fra tokengeneratorverktøyet) i conf/partner.cfg fil:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Sørg for at bruker-ID, passord og vertsnavn for den sekundære Cisco BroadWorks-applikasjonsserveren er riktige i conf/deviceMoveTool.conf fil:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. For å sende aktiverings-e-poster på nytt, må du angi SEND_INVITASJON_PÅ NYTT EMAILS=true i conf/partner.cfg fil.

   Hvis administratorer ønsker å sende invitasjons-e-poster til brukerne sine under migreringen, bør de fjerne kommentaren for «SEND INVITASJON_PÅ NYTT_EMAILS=true" eiendommen i conf/partner.cfg fil. Ellers skal eiendommen forbli uendret.

4. Bekreft JDK/JRE miljøstien er riktig i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratorer kan bruke locations.csv-filen fra input-katalogen til å migrere de spesifikke gruppene i stedet for alle gruppene under en bedrift.

Polycom-telefoner

For å flytte Polycom-telefoner fra Cisco BroadWorks til Wholesale Calling, må en partneradministrator opprette en ny Identity/Device Profiltypefil på systemnivå i Cisco BroadWorks hver Polycom-enhetsmal. Se figur 14 og last opp den tilpassede filen device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Etter at du har lastet opp den nye enhetsfilen, må du sørge for at den nyopprettede filen finnes på gruppenivå. Sørg også for at filen migration_%BWMAC ADDRESS%.cfg ikke er i konflikt med noen eksisterende filer på systemet ditt.

Den brukes internt av verktøyet for enhetsflytting.

Migreringsprosessen for Polycom-telefoner:

1. Verktøyet for enhetsflytting erstatter filen %BWMACADDRESS%.cfg på enhetsnivå med polycom_vvx2.cfg. Denne filen refererer til migration_%BWMACADDRESS%.cfg.
2. Gjenoppbygg enhetsprofilene på gruppenivå eller enhetsnivå.
   Handling på gruppenivå eller enhetsnivå avhenger av konfigurasjonen av parameteren deviceLevelRebuild i filen. device-move-tool/conf/partner.cfg.
3. Verktøyet for enhetsflytting ber Cisco BroadWorks-applikasjonsserveren om å starte telefoner på nytt på gruppenivå eller enhetsnivå.
4. Etter omstartsforespørselen laster Polycom-telefoner ned og behandler% BWMACADDRESS%.cfg, som ber Polycom-telefonene om å laste ned og behandle migration_%BWMACADDRESS%.cfg, som setter device.prov.serverName til https://plcm.sipflash.com..
   https://plcm.sipflash.com For USA-regionen har andre regioner andre URL-er.
5. Polycom-telefonen laster ned %BWMACADDRESS%.cfg fra https://plcm.sipflash.com og vil bli administrert av Webex Calling DMS.

Figur 14: Identity/device profiltype fil legg til

Instruksjoner for å kjøre

Det finnes to metoder for å aktivere DMT-en. Den første er å aktivere én kunde om gangen, og den andre er å kjøre gjennom flere kunder samtidig.

Verktøyet for enhetsflytting kjøres fra den sekundære Cisco BroadWorks-applikasjonsserveren i katalogen for verktøyet for enhetsflytting:

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

Terminallogger

Følgende er loggene i terminalen etter vellykket kjøring av enhetsflyttingsverktøyet for enhetsmigrering:

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| 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 |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

Produksjon

Etter enhetsoverføringen har enhetene kommet på nett og er klare til bruk. make/receive samtaler. Se figur 15 for et eksempel på enhetsstatusen:

Figur 15: Enhetsstatus

Etter enhetsmigreringen har numrene blitt aktive. Se figur 16 for et eksempel på hvilke tall som er aktive:

Figur 16: Aktive tall

Tilbakestillingsoperasjonen må utføres for én bedrift om gangen.

For BroadCloud-operatør

Tilbakeføringsprosessen for BroadCloud-partnere er som følger:

1. Åpne en sak med Cisco TAC for å be om en tilbakestilling av enheten.
2. Kjør verktøyet for enhetsflytting i tilbakestillingsmodus:
   • Telefonnumre vil bli fjernet fra Webex Calling, slik at brukere og tjenester bare får utvidelser.
   • E-postadresser i Webex Calling vil bli tilbakestilt til midlertidige e-postadresser.
   • Telefoner vil bli slettet fra Webex Calling.
   • Telefonnumre, e-postadresser brukt som alternative ID-er og telefoner vil bli gjenskapt i BroadCloud.
   • Telefonene vil bli startet på nytt.
3. Partneradministratorer må flytte PSTN-telefonnumre tilbake til BroadCloud Carrier.

For Cisco BroadWorks og Webex for BroadWorks

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

1. Åpne en sak med Cisco TAC for å be om en tilbakestilling av enheten.
2. Kjør verktøyet for enhetsflytting i tilbakestillingsmodus på den sekundære BroadWorks-applikasjonsserveren for å tilbakestille enhetsmigreringene. Dette vil sette DMS-URL-en tilbake til tjenesteleverandørens DMS-URL for enhetsprofiler i Cisco BroadWorks og aktivere telefonnumre på nytt.
3. Webex Calling-teamet setter DMS-URL-en tilbake til tjenesteleverandørens DMS-URL i enhetsprofiler i Webex Calling.
4. Partneradministratorer må deaktivere eller slette telefonnumrene i Webex Calling via Control Hub-portalen.
5. Partneradministratorer må flytte PSTN-telefonnumre tilbake til Cisco BroadWorks.

Instruksjoner for å kjøre enhetsflyttingsverktøyet i tilbakestillingsmodus

Følg trinnene nedenfor for å kjøre verktøyet for enhetsflytting i tilbakestillingsmodus:

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks-applikasjonsserveren i katalogen for enhetsflyttingsverktøyet:

Tilbakestill profiler

./devicemove.sh -input=  -revertProfiles

Tilbakestill tall

./devicemove.sh -input=  -revertNumbers

Terminallogger

Vi vil få følgende logger i terminalen når enhetsflyttingsverktøyet kjøres for tilbakestillingsoperasjon:

Tilbakestill profiler

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| 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 |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

Tilbakestill tall

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully