Understøttede telefoner oprettes automatisk og tildeles brugere i Webex Calling af klargøringsværktøjet. Telefonerne markeret med "ja" i kolonnen "Understøttes af værktøjet til flytning af enhed" vil også automatisk blive flyttet fra Cisco BroadWorks eller BroadCloud til Webex Calling, når værktøjet til flytning af enhed køres. Telefoner markeret med "Nej" i den kolonne kræver manuel indgriben for at ændre DMS-URL'en i Cisco BroadWorks-enhedsskabelonen eller i selve telefonen.

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

Partneradministratorer kører dette tokengeneratorvæ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, efter partnerkontoen er blevet onboardet i Wholesale RTM-løsningen. Dette værktøj giver partneradministratorer mulighed for at logge ind via webbrowseren for at få den unikke TOKEN, der er nødvendig for at opdatere partnerkonfigurationsfilerne til migreringsværktøjerne.

Forudsætninger

Installer Java 8, 11, 17 eller 21 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://www.oracle.com/java/technologies/downloads/#java21

Udpak de binære filer fra migreringsværktøjet efter download.

Instruktioner til at køre

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

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Produktion:

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

Åbn URL'en i webbrowseren på terminalen, log ind med partneradministratorens legitimationsoplysninger for at hente TOKEN'en, og kopier den til senere brug.

Illustrationerne af brugergrænsefladen er vist nedenfor til reference:

Figur 3: Log ind med Cisco Webex

Figur 4: Vindue med legitimationsoplysninger

Figur 5: Tokengenerering

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

Aktivér OCI-P-forbindelse

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

Trin 1: Brug CLI'en til at konfigurere generelle indstillinger.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

Skift mappen til OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Kør følgende CLI for at hente de aktuelle indstillinger. 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 dine indstillinger ikke stemmer overens med ovenstående, skal du bruge kommandoen set til at omkonfigurere dine indstillinger.

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

Skift til klargøringsmappen:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kør følgende kommando for at hente de aktuelle OCI Provisioning-indstillinger:

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

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

 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.

Bekræft åben klientserver, der er installeret og aktiv

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

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Trin 2: Start serveren med denne kommando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktivér talaktivering

Udfør følgende kommandoer i CLI for at aktivere aktiveringen af tallene:

Trin 1: Kør kommandoen for talaktivering:

AS_CLI> cd SubscriberMgmt/NumberActivation

Trin 2: Kør kommandoen "aktiveret aktivering":

AS_CLI> set dnMode groupAndUserActivationEnabled

Trin 3: Indtast Y ved bekræftelsesprompten.

Til BroadCloud

Udtrækningsværktøjet er integreret i BroadCloud Service Provider-portalen. En administrator af en tjenesteudbyder 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 anmodningens indsendelsesdato.

De følgende figurer viser tjenesteudbyderportalen.

Figur 6: Tjenesteudbyderportal

Figur 7: Tjenesteudbyderportal

Anmodning om CSV-udtræk

Start anmodning om CSV-udtræk

1. Download kundens CSV-fil

   Klik på linket Download kunde-CSV i øverste højre hjørne af afsnittet Start anmodning om CSV-udtræk.

2. Rediger kundelisten

   Administratoren kan redigere denne CSV-fil, så den kun inkluderer de kunder, som udtrækket skal udføres for.

3. Upload og indsend

   Upload den ændrede CSV-fil efter redigering.

   Klik på Send for at starte en udtræksanmodning for de anførte kunder og deres tilknyttede lokationer.

Start udtræksanmodning for en kunde med lokations-CSV

1. Vælg kunde- og downloadplaceringer

   Vælg en kunde fra rullemenuen.

   Download den tilsvarende locations.csv fra Vis kunder→ fanen Lokationer → Eksporter lokationer som CSV.

2. Rediger placeringsfilen

   Administratoren kan redigere CSV-filen, så den kun inkluderer de placeringer, de ønsker at udtrække.

3. Upload og indsend

   Upload den redigerede locations.csv, og klik på Send.

   Kun de angivne placeringer for den valgte kunde vil blive inkluderet i udtræksanmodningen.

Start udtræksanmodning for alle kunder

1. Klik på Send for at starte en udtræksanmodning for alle kunder og alle deres lokationer under den nuværende tjenesteudbyder.

Til Cisco BroadWorks og Webex til BroadWorks

1. Udtrækningsværktøjet kører på den sekundære Cisco BroadWorks Application Server i partnernetværket og opretter forbindelse via OCI-P.
2. Værktøjet henter rå virksomheds-, gruppe-, tal-, bruger-, service-, enheds- og softklientdata fra Cisco BroadWorks- eller BroadCloud-platformen og sender disse data ud til XML-filer, der leverer input til transformationsværktøjet.

De næste afsnit forklarer, hvordan man installerer og konfigurerer udpakningsværktøjet.

Forudsætninger

1. SCP udpakningsværktøjets binære filer til den sekundære Cisco BroadWorks Application Server.
2. SSH til den sekundære Cisco BroadWorks-applikationsserver for at konfigurere forudsætningerne og køre udpakningsværktøjet.
3. Konfigurer tjenesteudbyderen og gruppe-ID'et, der skal udtrækkes fra Cisco BroadWorks i conf/exportTool.yml. Se følgende eksempel på et YAML-snippet:

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

4. Sørg for, at det sekundære Cisco BroadWorks Application Server-bruger-ID, -adgangskode og -værtsnavn er korrekte 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.
   

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

5. Rediger JDK/JRE miljøstien i export.sh-filen, hvis den sekundære Cisco BroadWorks-applikationsserver JDK/JRE miljøstien er forskellig fra filen:

   JAVA_HOME=/usr/local/java/java_base

Instruktioner til at køre

Kør følgende kommando i den sekundære Cisco BroadWorks Application Server fra udpakningsværktøjsmappen:

./export.sh

Terminallogfiler

Følgende logfiler er tilgængelige i terminalen efter vellykket eksport: Kørsel af 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
**************************************************

Output

En output-ZIP-fil (extracted_data_<timestamp>.zip) er tilgængelig i den samme mappe for udpakningsværktøjet. Brug følgende kommando til at se og bruge ZIP-filen til input fra 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 transformeringsværktøj kører for alle migreringer. Transformeringsværktøjet kører på enhver computer, herunder en partners administratorbærbare computer, og bruger Webex Public API'er. Den læser udpakningsværktøjets ZIP-fil (extracted_data_<timestamp>.zip) som input og transformerer den rå XML til et JSON-format, der bruges af klargøringsværktøjet.

Forudsætninger

Når du har downloadet og udpakket de binære filer til migreringsværktøjerne, skal du konfigurere følgende forudsætninger:

1. Indstil REFRESH_TOKEN (token kopieret fra Token Generator Tool) og NAVN_PÅ_HOVEDPLACERING_i conf/partner.cfg fil:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Angiv eventuelt PROVISIONING_ID (kopieret fra skabelonen i Partner Hub) i conf/partner.cfg fil:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For at få en mere komplet verifikation af kundens e-mailadresse kan du valgfrit indstille PROVISIONING_ID'et.
3. Konfigurer manglende oplysninger i input/customers.csv fil (se næste afsnit), hvis den mangler.
4. Tilføj slutbrugerens e-mailadresse i input/users.csv fil.
5. Hvis nye telefoner skal provisioneres, skal du tilføje MAC-adressen og e-mailadressen på brugerens nye telefon til input/newphones.csv fil. Dette er kun påkrævet, hvis partneradministratorerne ønsker at provisionere nye telefoner i Engrosopkald.
6. Konverter BroadWorks callcentre til CxEssentials ved hjælp af input/cxessentials.csv fil.
7. Aktiver eventuelt egenskaben OPGRADER_ALLE_CALL_CENTRE_TIL_CX_ESSENTIALS for at konvertere alle callcentre til CxEssentials.
8. Brug input/locations.csv fil til at understøtte migrering af store virksomheder, der giver administratorer mulighed for at migrere deres kunders lokationer efter lokation
9. Aktiver eventuelt brugen af MAC-adresser fra User-Agent-headeren i SIP REGISTER-meddelelsen, når MAC-adressen ikke er tilgængelig i Cisco BroadWorks-enhedsprofilen. Fjern kommentaren fra linjen "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" i filen conf/partner.cfg
10. Funktionen til synkronisering af netværksservere giver administratorer mulighed for at provisionere telefonnumre, MAC-adresser og brugeres e-mailadresser under provisioneringen i samme region. For at aktivere det, skal du indstille USE_NS_SYNC=yes i conf/partner.cfg.

    Hvis NS-synkronisering er deaktiveret, springes telefonnummer- og enhedsklargøring over, og brugerne får midlertidige e-mailadresser.

11. Aktiver eventuelt egenskaberne ANALOG_BRUGER_TYPE_AKTIV_OPKALD_VENTER, ANALOG_BRUGER_TYPE_AKTIV_MUSIK_PÅ_HOLD og ANALOG_BRUGER_TYPE_DEAKTIVER_T38 for at konfigurere ventende opkald, musik på hold og deaktivere T38-indstillinger for alle brugere af analogtypen.

Opfyldning af input/customers.csv

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

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

Opfyldning af input/users.csv

Filen input/users.csv leverer data, der muligvis mangler i Cisco BroadWorks eller BroadCloud. Denne fil kan stå tom, hvis alle obligatoriske oplysninger allerede er tilgængelige. Du behøver ikke at udfylde alle kolonner, kun de manglende oplysninger er obligatoriske.

Instruktioner til at køre

Kør Transform Tool 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 Transform Tool i Windows:

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

macOS

Udfør følgende trin for at køre transformeringsvæ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
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. Kør transformeringsværktøjet:

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

Customer/user forhåndstjek

Transform-værktøjet foretager API-kald til Webex for at opdage potentielle klargøringsproblemer. Som standard validerer den kundens adresse og primære e-mail. Hvis værdien PROVISIONING_ID er angivet i conf/partner.cfg fil, vil den også validere placeringsoplysninger. Resultaterne af forhåndskontrollen er inkluderet i undtagelsesrapporten.

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

forhåndstjek

Udover at køre precheck-API'en for kundeoplysningerne, vil Transform Tool også køre precheck-API'en for abonnenternes e-mails.

forhåndstjekinfo

Som standard er det kun forhåndskontrolfejl (dvs. problemer, der blokerer klargøring), der er inkluderet i undtagelsesrapporten. Tilføjelse af dette flag vil også inkludere succesfulde forhåndstjekresultater (f.eks. hvis en Webex-organisation allerede findes, der automatisk kan tilknyttes).

Terminallogfiler

Følgende logger i terminalen ved vellykket transformation:

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

Undtagelsesrapport

Transform Tool genererer undtagelsesrapporten i output/<timestamp>/exception_report.txt mappe. Du kan bruge denne rapport til at identificere de problemer, der vil påvirke migreringen, og løse dem i Cisco BroadWorks-systemet.

Når du har ændret brugerdataene for at løse undtagelsen, skal du køre værktøjerne Udtræk og Transformér igen med de nye data. Eksempelfilen på undtagelsesrapporten 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

Output

En output JSON (customer.json) fil vil være tilgængelig i output/<timestamp>/<groupid> mappe. 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"
    }
}

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

Forudsætninger

Konfigurer følgende forudsætninger i klargøringsværktøjsmappen:

1. Installer Java 8, 11, 17 eller 21 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://www.oracle.com/java/technologies/downloads/#java21
2. Når du har downloadet og udpakket de binære filer med migreringsværktøjerne, skal du indstille JAVA_HOME-miljøvariablen i provisioning_tool.sh til MAC og provisioning_tool.bat til Windows.
3. partner.cfg-filen:
   • Angiv ID'et for ENGROS_PROVISIONING_og OPDATER TOKEN_(token kopieret fra tokengeneratorværktøjet). Partneradministratorerne skal kontakte deres kontoteam for at få PROVISIONING_ID'et:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Sæt ALLOW_ADMIN_INVITE_EMAILS til false, hvis partneren ikke ønsker at sende en velkomstmail til brugerne. Standardværdien er sand.

4. Brug egenskaben WEBEX4BWKS_EMAIL_SUBJECT for Webex til BroadWorks-migreringer til at sende emnet for e-mailen med anmodning om ændring af adgangskode til Webex til BroadWorks-abonnenter.
5. Brug egenskaben WEBEX4BWKS_EMAIL_BODY for Webex til BroadWorks-migreringer til at sende e-mailens brødtekst med anmodningen om ændring af adgangskode til Webex til BroadWorks-abonnenter.
6. Funktionen til synkronisering af netværksservere giver administratorer mulighed for at provisionere telefonnumre, MAC-adresser og brugeres e-mailadresser under provisioneringen i samme region. For at aktivere det, skal du indstille USE_NS_SYNC=yes i conf/partner.cfg.

   Hvis NS-synkronisering er deaktiveret, springes telefonnummer- og enhedsklargøring over, og brugerne får midlertidige e-mailadresser.

For BroadCloud-migreringer i samme region:

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

For BroadCloud-migreringer til en anden region:

1. Værktøjet vil klargøre numre, enheder og delte opkaldsvisninger.
2. Værktøjet opretter brugere og virtuelle brugere med faktiske telefonnumre og lokalnummer.
   Alle BroadCloud-migreringer i Europa sker til en anden region.

Instruktioner til at køre

Brug følgende trin til at køre værktøjet i Windows og macOS:

Windows

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

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

macOS

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

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

Forudsætninger for Webex til BroadWorks-migrering

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

Når Webex til BroadWorks onboarding-skabelonen er opdateret for at understøtte migrering, skal du anmode Cisco-kontoteamet om at aktivere funktionen "Wholesale-Partner-Blending-Enabled" på partnerniveau. Dette vil give mulighed for at tilføje engrospakker til eksisterende Webex til BroadWorks-kundeorganisationer under klargøring.

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

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

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

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

Terminallogfiler

Følgende er loggene i terminalen over vellykket provisionering:

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

Der udskrives en tabel med antallet af lokationer, der er oprettet for hver kørsel:

Output

Provisioneringsværktøjet genererer succes- og fejlrapporter i output/<external_id>/*.success/error filer. Gennemgå succes- og fejllogge for output for at bekræfte vellykket provisionering.

Partneradministratorer kan bekræfte kundens klargøring 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: Opkald

Til BroadCloud

For BroadCloud-partnere skal du bruge tjenesteudbyderportalen til at indsende en migreringsanmodning for numre, enheder og migreringer af Shared Call Appearances (SCA).

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

Funktionen Netværksserversynkronisering giver administratorer mulighed for at deaktivere BroadCloud-placeringen og aktivere Webex Calling-placeringen ved at indstille USE_NS_SYNC=yes i conf/partner.cfg. Efter migrering aktiveres enheder og telefonnumre på Webex Calling-placeringen.

Administratorer kan aktivere automatisk rollback ved at indstille ROLLBACK_TO_BROADCLOUD=true i conf/partner.cfg -filen, hvilket flytter enheder tilbage til BroadCloud efter migrering. Den understøtter både migreringer i samme og forskellige regioner med NS Sync, men kun for vellykkede migreringer. For mislykkede systemer skal administratorer oprette en Cisco TAC, før de anmoder om tilbagerulning.

Der er to muligheder for at vælge migreringstype i portalen:

• Migrering – Vælg denne indstilling for at starte en anmodning om migrering af numre, enheder og delte opkaldsappearances (SCA).
• Enhedsstatus – Vælg denne indstilling for at se den aktuelle status for en enhed på BroadCloud og i Opkald.

De følgende figurer viser tjenesteudbyderportalen.

Figur 12: Tjenesteudbyderportal

Figur 13: Tjenesteudbyderportal

Migrer valgte placeringer (valgfrit)

For at starte migreringen for en specifik delmængde af placeringer, der er angivet i customer.json -filen, skal du inkludere en locations.csv -fil i din anmodning. Denne CSV-fil bør kun angive de placeringer, du har til hensigt at migrere.

For at downloade listen over tilgængelige aktive lokationer skal du navigere til Vis kunder → Vælg en kunde → Eksporter lokationer som CSV.

Figur 14: Eksportér placeringer som CSV

Til Cisco BroadWorks og Webex til BroadWorks

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

Når operationen er vellykket, vil værktøjet til flytning af enhed:

1. Afregistrer enheder fra Cisco BroadWorks, og registrer dem i Engros.
2. Brugere, der bruger UC-One-klienten, omdirigeres til Webex-appen ved første login.
3. Deaktiver telefonnumrene fra Cisco BroadWorks, eller fjern telefonnumrene fra BroadCloud.
4. Aktivér numre i Engros.
5. Opret delte opkaldsvisninger i Wholesale til BroadCloud-migreringer. [This Trinet gælder kun for BroadCloud migrations].

SCP og SSH

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

Forudsætninger

1. Indstil REFRESH_TOKEN (token kopieret fra tokengeneratorværktøjet) i conf/partner.cfg fil:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Sørg for, at det sekundære Cisco BroadWorks Application Server-bruger-ID, -adgangskode og -værtsnavn er korrekte i conf/deviceMoveTool.conf fil:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. For at sende aktiveringsmails igen, skal du indstille SEND_INVITATION_EMAILS=true i conf/partner.cfg fil.

   Hvis administratorer ønsker at sende invitationsmails til deres brugere under migreringen, skal de fjerne kommentaren fra "SEND_INVITATION_GENOPTAGELSE EMAILS=true" ejendom i conf/partner.cfg fil. Ellers skal ejendommen forblive uændret.

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom-telefoner

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

Det bruges internt af værktøjet til flytning af enhed.

Migreringsprocessen for Polycom-telefoner:

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

Figur 14: Identity/device profiltype filtilføjelse

Instruktioner til at køre

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

Værktøjet til enhedsflytning køres fra den sekundære Cisco BroadWorks-applikationsserver i mappen med værktøjet til enhedsflytning:

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

Terminallogfiler

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

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

Output

Efter enhedsmigreringen er enhederne online og klar til brug make/receive opkald. Se figur 15 for et eksempel på enhedens status:

Figur 15: Enhedsstatus

Efter enhedsmigreringen er numrene blevet aktive. Se figur 16 for et eksempel på, hvilke tal der er aktive:

Figur 16: Aktive tal

Tilbageførselsoperationen skal udføres for én virksomhed ad gangen.

For BroadCloud-operatør

Tilbageførselsprocessen for BroadCloud-partnere er som følger:

1. Åbn en sag hos Cisco TAC for at anmode om en enhedsgendannelse.
2. Kør værktøjet til flytning af enhed i tilbageførselstilstand:
   • Telefonnumre vil blive fjernet fra Webex Calling, hvilket kun giver brugere og tjenester lokalnumre.
   • E-mailadresser i Webex Calling vil blive gendannet til midlertidige e-mailadresser.
   • Telefoner vil blive slettet fra Webex Calling.
   • Telefonnumre, e-mailadresser brugt som alternative id'er og telefoner vil blive genskabt i BroadCloud.
   • Telefonerne vil blive genstartet.
3. Partneradministratorer skal flytte PSTN-telefonnumre tilbage til BroadCloud Carrier.

Til Cisco BroadWorks og Webex til BroadWorks

Tilbageførselsprocessen for Cisco BroadWorks og Webex til BroadWorks er som følger:

1. Åbn en sag hos Cisco TAC for at anmode om en enhedsgendannelse.
2. Kør værktøjet til flytning af enhed i tilbageføringstilstand på den sekundære BroadWorks-applikationsserver for at fortryde enhedsmigreringerne. Dette vil indstille DMS-URL'en tilbage til tjenesteudbyderens DMS-URL for enhedsprofiler i Cisco BroadWorks og genaktivere telefonnumre.
3. Webex Calling-teamet indstiller DMS-URL'en tilbage til tjenesteudbyderens DMS-URL 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.

Instruktioner til at køre værktøjet til flytning af enhed i tilbageførselstilstand

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

Kør kommandoen nedenfor i den sekundære Cisco BroadWorks-applikationsserver i mappen med værktøjet til flytning af enheder:

Tilbagefør profiler

./devicemove.sh -input=  -revertProfiles

Tilbagefør numre

./devicemove.sh -input=  -revertNumbers

Terminallogfiler

Vi får følgende logfiler i terminalen, når værktøjet til enhedsflytning køres med succes for at gendanne handlingen:

Tilbagefør 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

Tilbagefør 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