Støttede telefoner opprettes automatisk og tilordnes brukere i Webex Calling av klargjøringsverktøyet. Telefonene merket "Ja" i kolonnen "Støttes i flyttingsverktøyet for enheten" flyttes også automatisk fra Cisco BroadWorks eller BroadCloud til Webex Calling når flyttingsverktøyet for enheten kjøres. Telefoner merket "Nei" i den kolonnen trenger en manuell inngripen for å endre DMS URL-adressen i Cisco BroadWorks-enhetsmalen eller i selve telefonen.

Den siste kolonnen inneholder 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 starter å kjøre overføringsverktøy. Å kjøre dette verktøyet er en engangsaktivitet etter at partnerkontoen blir innlemmet i Wholesale RTM-løsningen. Dette verktøyet gjør det mulig for partneradministratorer å logge på via nettleseren for å få det unike TOKEN som er nødvendig for å oppdatere til partnerkonfigurasjonsfilene for overføringsverktø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 nedlasting, pakk ut overføringsverktøybinærene.

Instruksjoner å kjøre

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

Vinduer:

token_generator.bat

MacOS

./token_generator.sh

Utgang:

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

Åpne URL-adressen i nettleseren på terminalen, logg på med partneradministratorlegitimasjonen for å få TOKENET og kopier det samme for videre bruk.

Illustrasjonene i brukergrensesnittet er gitt nedenfor for referanse:

Figur 3: Logg på med Cisco Webex

Figur 4: Vinduet for legitimasjon

Figur 5: Tokengenerasjon

Konfigurer følgende trinn før du kjører verktøyene for utvinning og flytting av enheter i den sekundære BroadWorks-serveren.

Aktiver OCI-P-tilkobling

Flytteverktøyet for enheten kommuniserer med BroadWorks via OCI-P-kommandoer, for å aktivere OCI-P-tilkobling, bruk trinnene nedenfor:

Trinn 1: Bruk CLI til å konfigurere generelle innstillinger.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

Hvis innstillingene ikke samsvarer med det ovennevnte, bruker du kommandoen set til å konfigurere innstillingene på nytt.

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

Endre katalogen til OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Kjør følgende CLI for å få 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 ikke samsvarer med det ovennevnte, bruker du kommandoen set til å konfigurere innstillingene på nytt.

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

Endre til klargjøringskatalogen:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kjør følgende kommando for å få 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 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 distribuert og aktiv åpen klientserver

Bruk kommandoene nedenfor til å distribuere og starte Åpne klientserveren på den sekundære programserveren 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 aktivering av numre

Utfør følgende kommandoer i CLI for å aktivere aktivering av numrene:

Trinn 1: Kjør kommandoen for nummeraktivitet:

AS_CLI> cd SubscriberMgmt/NumberActivation

Trinn 2: Kjør aktivert kommando:

AS_CLI> set dnMode groupAndUserActivationEnabled

Trinn 3: Skriv inn Y ved bekreftelsesmeldingen.

For BroadCloud

Utvinningsverktøyet er integrert i BroadCloud-tjenesteleverandørportalen. Administrator for en tjenesteleverandør kan:

1. Send ut forespørsler om utdrag for opptil 50 kunder per forespørsel.
   Utdrag forespørsel kan ikke sendes inn for samme kunde mer enn 10 ganger i løpet av en dag.
2. Last ned den utpakkede datafilen, i ZIP-format, i opptil 28 dager fra datoen for forespørsel.

Tallene nedenfor viser tjenesteleverandørportalen.

Figur 6: Tjenesteleverandørportal

Figur 7: Tjenesteleverandørportal

For Cisco BroadWorks og Webex for BroadWorks

1. Utpakkingsverktøyet kjører på den sekundære Cisco BroadWorks Application Server i partnernettverket og kobles til via OCI-P.
2. Verktøyet henter rå data fra bedrifter, grupper, numre, brukere, tjenester, enheter og myke klienter fra Cisco BroadWorks- eller BroadCloud-plattformen og sender disse dataene til XML-filer som gir inndataene for transformeringsverktøyet.

De neste delene forklarer hvordan du installerer og konfigurerer utvinningsverktøyet.

Forutsetninger

1. SCP utvinningsverktøybinærene til sekundær Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks Application Server for å konfigurere forutsetningene og kjøre utvinningsverktøyet.
3. Konfigurer tjenesteleverandøren og gruppe-ID-en til å trekke ut fra Cisco BroadWorks i conf/exportTool.yml. Se YAML-utskriften nedenfor:

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

4. Kontroller at den sekundære bruker-ID, passord og vertsnavnet for Cisco BroadWorks-programserveren er riktig i filen conf/partner.cfg:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

   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 Application Server JDK/JRE-miljøbanen er forskjellig fra filen:

   JAVA_HOME=/usr/local/java/java_base

Instruksjoner å kjøre

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks Application Server fra utvinningsverktøykatalogen:

./export.sh

Terminallogger

Følgende logger er tilgjengelige i terminalen ved 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
**************************************************

Utdata

En utdatazip-fil (extracted_data_<timestamp>.zip) vil være tilgjengelig i samme utdataverktøykatalog. Bruk kommandoen nedenfor for å vise og bruke ZIP-filen for inndata for transformeringsverktøy:

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 transformeringsverktøyet kjøres for alle overføringer. Transformeringsverktøyet kjører på en hvilken som helst datamaskin, inkludert en partnerens administratorbærbare datamaskin, og bruker Webex Public API-er. Den leser utdataverktøyets utdatafil ZIP (extracted_data_<timestamp>.zip) som en inndata og konverterer den rå XML til et JSON-format som brukes av klargjøringsverktøyet.

Forutsetninger

Når du har lastet ned og ekstrahert de binære overføringsverktøyene, konfigurerer du følgende forutsetninger:

1. Angi REFRESH_TOKEN (token kopiert fra tokengenereringsverktøyet) og NAVNET_PÅ_HOVEDPLASSERINGEN_ i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Angi eventuelt KLARGJØRINGS-ID_ (kopiert fra malen i Partner Hub) i filen conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For å få mer fullstendig bekreftelse av kundens e-postadresse kan du eventuelt angi KLARGJØRINGS-ID_.
3. Konfigurer manglende informasjon i inndata/customers.csv-filen (se neste avsnitt) hvis den mangler.
4. Legg til sluttbrukerens e-postadresse i inndata/users.csv-filen.
5. Hvis nye telefoner skal klargjøres, legger du til mac-adressen og e-postadressen til brukerens nye telefon i inndata/newphones.csv-filen. Dette er kun nødvendig hvis partneradministratorene ønsker å klargjøre nye telefoner i engrossamtaler.
6. Konverter BroadWorks Call Centers til CxEssentials ved hjelp av input/cxessentials.csv-filen.
7. Du kan også aktivere egenskapen OPPGRADERE_ALLE_SAMTALESENTRE__TIL_CX_ESSENTIALS for å konvertere alle samtalesentre til CxEssentials.
8. Bruk inndata/locations.csv-filen til å støtte den store bedriftsmigreringen som gjør det mulig for administratorer å migrere kundens steder etter sted
9. Du kan også aktivere bruk av MAC-adresser fra User-Agent-toppteksten i SIP REGISTER-meldingen når MAC-adressen ikke er tilgjengelig i Cisco BroadWorks-enhetsprofilen. Fjern kommentaren på linjen «USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes» i filen conf/partner.cfg
10. Funksjonen for synkronisering av nettverksserver gjør det mulig for administratorer å klargjøre telefonnumre, MAC-adresser og brukeres e-postadresser under klargjøring i samme områdeoverføring. For å aktivere den, sett USE_NS_SYNC=yes inn conf/partner.cfg.

    Hvis NS-synkronisering er deaktivert, vil telefonnummer og enhetsklargjøring hoppes over, og brukere vil få midlertidige e-postadresser.

Fylling av inndata/customers.csv

Filinndataene/customers.csv inneholder 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 kolonner, bare den manglende informasjonen er obligatorisk.

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

Instruksjoner å kjøre

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

Windows

Utfør kommandoen nedenfor for å kjøre transformeringsverktøyet 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=

Forhåndskontroll av kunde/bruker

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

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

forhåndskontroll

I tillegg til å kjøre forhåndskontrollens API for kundeinformasjon, vil transformeringsverktøyet også kjøre forhåndskontrollens API for abonnentens e-postmeldinger.

forhåndskontrollinformasjon

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

Terminallogger

Følgende logger i terminalen ved vellykket transformering:

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

Transformeringsverktøy genererer unntaksrapporten i output/<timestamp>/exception_report.txt -katalogen. Du kan bruke denne rapporten til å identifisere problemene som vil påvirke overføringen, og fikse dem i Cisco BroadWorks-systemet.

Etter å ha endret brukerdataene for å løse unntaket, kan du kjøre utvinnings- og transformeringsverktøyene på nytt med de nye dataene. Eksempelunntaksrapportfilen 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

Utdata

En utdata-JSON-fil (customer.json) vil være tilgjengelig i utdata/<timestamp>/<groupid> -katalogen. 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øre på en hvilken som helst maskin, vanligvis (partnerens administratorbærbare) og bruker Webex Public API-er. Den leser JSON-filen for transformeringsverktøyutdata (customer.json) som en inndata og klargjøring til kunder, steder, numre, brukere, tjenester og enheter i Webex Wholesale RTM-løsningen.

Forutsetninger

Konfigurer følgende forutsetninger i klargjøringsverktøykatalogen:

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 nedlasting og utpakking av binærene for overføringsverktøy, angir du variabelen JAVA_HOME-miljø i provisioning_tool.sh for MAC og provisioning_tool.bat for Windows.
3. Filen partner.cfg:
   • Angi ENGROS_KLARGJØRINGS_ID og OPPDATER_TOKEN (token kopiert fra tokengeneratorverktøyet). Partneradministratorene må kontakte kontoteamet sitt for å få KLARGJØRINGS-ID_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Angi ALLOW_ADMIN_INVITE_E-POST til usann hvis partneren ikke ønsker å sende en velkomst-e-post til brukerne. Standardverdien er sann.

4. Bruk egenskapen WEBEX4BWKS_EMAIL_SUBJECT for Webex for BroadWorks-migreringer til å sende e-postemnet for forespørsel om endring av passord for Webex for BroadWorks-abonnenter.
5. Bruk egenskapen WEBEX4BWKS_EMAIL_BODY for Webex for BroadWorks-migreringer for å sende e-postteksten for forespørsel om endring av passord for Webex for BroadWorks-abonnenter.
6. Funksjonen for synkronisering av nettverksserver gjør det mulig for administratorer å klargjøre telefonnumre, MAC-adresser og brukeres e-postadresser under klargjøring i samme områdeoverføring. For å aktivere den, sett USE_NS_SYNC=yes inn conf/partner.cfg.

   Hvis NS-synkronisering er deaktivert, vil telefonnummer og enhetsklargjøring hoppes over, og brukere vil få midlertidige e-postadresser.

For BroadCloud-migreringer samme region:

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

For BroadCloud-migreringer en annen region:

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

Instruksjoner å kjøre

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

Windows

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-innføringsmal for Webex for BroadWorks sameksistensfunksjoner. Se følgende bilde:

Når Webex for BroadWorks-innføringsmalen er oppdatert for å støtte migrering, ber du Cisco-kontoteamet om å aktivere funksjonen «engros-partner-blending-aktivert» på partnernivå. Dette gjør det mulig å legge til engrospakker i eksisterende Webex for BroadWorks-kundeorganisasjoner under klargjøringen.

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

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

Vedlikeholdsfase: er den andre fasen der administratorer kan tilordne engroslisensen til eksisterende Webex for BroadWorks-brukere. Du må kjøre klargjøringsverktøyet med et argument vedlikehold.

Post-migreringsfase: Er den siste fasen når administratorer kan konvertere BroadWorks til engroshandel fullstendig. Du må kjøre klargjøringsverktøyet med et argument postmigrering.

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 trykt med antall plasseringer som er opprettet for hver kjøring:

Utdata

Klargjøringsverktøyet genererer suksess- og feilrapporter i utdata/<external_id>/*.success/error -filene. Gå gjennom vellykket utdata og feillogger 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: Partner Hub

Figur 9: Control Hub

Figur 10: Enheter

Figur 11: Ringe

For BroadCloud

For BroadCloud-partnere bruker du tjenesteleverandørportalen til å sende inn en overføringsforespørsel for numre, enheter og SCA-overføringer.

I tjenesteleverandørportalen kan en overføringsforespørsel omfatte opptil 50 kunder. Maksimalt 10 forespørsler kan sendes inn innen en dag.

Funksjonen Network Server Sync gjør det mulig for administratorer å deaktivere broadCloud-plasseringen og aktivere Webex Calling-plasseringen ved å angi USE_NS_SYNC=yes i conf/partner.cfg. Etter overføring aktiveres enheter og telefonnumre på Webex Calling-stedet.

Administratorer kan aktivere automatisk tilbakerulling ved å angi ROLLBACK_TO_BROADCLOUD=true i filenconf/partner.cfg , som flytter enheter tilbake til BroadCloud etter overføring. Den støtter både like- og ulike regionoverføringer med NS Sync, men bare for vellykkede overføringer. For mislykkede, må administratorer generere en Cisco TAC før de ber om tilbakerulling.

Tallene nedenfor viser tjenesteleverandørportalen.

Figur 12: Tjenesteleverandørportal

Figur 13: Tjenesteleverandørportal

For Cisco BroadWorks og Webex for BroadWorks

For Cisco BroadWorks og Webex for BroadWorks-migrering kjører verktøyet på den sekundære Cisco BroadWorks-programserveren i partnernettverket og kobler seg til AS via OCI-P. Den bruker utdatafilen JSON (customer.json) som inndata og kjører OCI-P-kommandoene for å overføre enheter og myke klienter.

Når funksjonen er vellykket, vil flytteverktøyet for enheten:

1. Avregistrer enheter fra Cisco BroadWorks og registrer dem i engroshandel.
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 numre i engroshandel.
5. Opprett delte anropsvisninger i engroshandel for BroadCloud-overføringer. [Dette trinnet gjelder bare for BroadCloud-overføringer].

SCP og SSH

1. SCP enheten flytter verktøyet til den sekundære Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks-programserveren for å konfigurere forutsetningene og kjøre verktøyet for flytting av enheten.

Forutsetninger

1. Angi REFRESH_TOKEN (token kopiert fra tokengenerator-verktøyet) i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Kontroller at den sekundære bruker-ID, passord og vertsnavnet for Cisco BroadWorks-programserveren er riktig i filen conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Hvis du vil sende aktiverings-e-poster på nytt, må du angi SEND PÅ NYTT_INVITASJON_EMAILS=sann i filen conf/partner.cfg.

   Hvis administratorer ønsker å sende invitasjons-e-poster til brukerne sine under overføringen, bør de fjerne kommentaren i egenskapen «SEND INVITASJONS_E-MAILS_=true» i filen conf/partner.cfg. Ellers skal eiendommen forbli uendret.

4. Kontroller at JDK/JRE-miljøbanen er riktig i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratorer kan bruke locations.csv-filen fra inndatakatalogen til å overføre de spesifikke gruppene i stedet for alle grupper under en bedrift.

Polycom-telefoner

For å flytte Polycom-telefoner fra Cisco BroadWorks til Wholesale Calling må en partneradministrator opprette en ny identitets-/enhetsprofiltypefil på systemnivå i Cisco BroadWorks hver Polycom-enhetsmal. Se figur 14 og last opp den egendefinerte filen device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Når du har lastet opp den nye enhetsfilen, må du kontrollere at den nylig opprettede filen finnes på gruppenivå. Kontroller også at filen migration_%BWMAC ADDRESS%.cfg ikke er i konflikt med noen eksisterende fil i systemet).

Den brukes internt av flyttingsverktøyet for enheten.

Overføringsprosessen for Polycom-telefoner:

1. Flytteverktøyet for enheten 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 flytting av enheten ber Cisco BroadWorks-programserveren om å starte telefoner på nytt på gruppenivå eller enhetsnivå.
4. Etter omstartsforespørselen lastes Polycom-telefonene ned og prosesser% BWMACADDRESS%.cfg, som ber Polycom-telefonene om å laste ned og prosesser migration_%BWMACADDRESS%.cfg, som angir device.prov.serverName til https://plcm.sipflash.com.
   https://plcm.sipflash.com for den amerikanske regionen har andre regioner forskjellige URL-adresser.
5. Polycom-telefonen laster ned %BWMACADDRESS%.cfg fra https://plcm.sipflash.com og vil bli administrert av Webex Calling DMS.

Figur 14: Legg til fil for identitets-/enhetsprofil

Instruksjoner å kjøre

Det finnes to metoder for å påkalle DMT, den første er å påkalle gjennom en enkelt kunde om gangen, og den andre er å kjøre gjennom flere kunder samtidig.

Flytteverktøyet for enheten kjøres fra den sekundære Cisco BroadWorks-programserveren i katalogen for flytteverktøy for enheten:

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 på vellykket kjøring av verktøyet for flytting av enheten for flytting av enheten:

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

Utdata

Etter enhetsmigreringen har enhetene kommet på nettet og er klare til å foreta/motta anrop. Se figur 15 for et eksempel på enhetsstatusen:

Figur 15: Enhetsstatus

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

Figur 16: Aktive numre

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

For BroadCloud-transportør

Tilbakestillingsprosessen for BroadCloud-partnere er som følger:

1. Åpne en billett med Cisco TAC for å be om tilbakestilling av enheten.
2. Kjør enhetens flytteverktøy i tilbakestilt modus:
   • Telefonnumre vil ikke bli tilordnet fra Webex Calling, slik at brukere og tjenester kun kan få utvidelser.
   • E-postadresser i Webex Calling tilbakestilles til midlertidige e-postadresser.
   • Telefoner slettes fra Webex Calling.
   • Telefonnumre, e-postadresser som brukes som alternerende ID-er og telefoner vil bli gjenopprettet i BroadCloud.
   • Telefoner 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 billett med Cisco TAC for å be om tilbakestilling av enheten.
2. Kjør verktøyet for flytting av enheten i tilbakestillingsmodus på den sekundære BroadWorks Application Server for å tilbakestille enhetsoverføringer. Dette vil sette DMS URL-adressen tilbake til tjenesteleverandørens DMS URL for enhetsprofiler i Cisco BroadWorks og aktivere telefonnumre på nytt.
3. Webex Calling-teamet setter DMS URL-adressen tilbake til tjenesteleverandørens DMS URL i enhetsprofiler i Webex Calling.
4. Partneradministratorer må deaktivere eller slette telefonnumrene i Webex Calling gjennom Control Hub-portalen.
5. Partneradministratorer må flytte PSTN-telefonnumre tilbake til Cisco BroadWorks.

Instruksjoner for å kjøre verktøyet for flytting av enheten i tilbakestilt modus

Følg trinnene nedenfor for å kjøre enhetens flyttingsverktøy i tilbakestilt modus:

Kjør kommandoen nedenfor i den sekundære Cisco BroadWorks-programserveren inne i verktøykatalogen for flytting av enheten:

Sett tilbake profiler

./devicemove.sh -input=  -revertProfiles

Tilbakestill numre

./devicemove.sh -input=  -revertNumbers

Terminallogger

Vi får følgende logger i terminalen ved vellykket kjøring av flyttingsverktøyet for tilbakestilling av drift:

Sett tilbake 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 numre

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