Telefoner som stöds skapas automatiskt och tilldelas användare i Webex Calling av etableringsverktyget. Telefonerna markerade med "ja" i kolumnen "Stöds i enhetsflyttverktyget" kommer också automatiskt att flyttas från Cisco BroadWorks eller BroadCloud till Webex Calling när enhetsflyttverktyget körs. Telefoner markerade med "Nej" i den kolumnen kräver en manuell åtgärd för att ändra DMS-URL:en i Cisco BroadWorks-enhetsmallen eller i själva telefonen.

Den sista kolumnen visar mappningen av telefonmodeller till kolumnen "Enhetstyp" i filen. transform-tool/input/newphones.csv. (Se avsnittet Transformeringsverktyg i den här artikeln för mer information om newphones.csv).

Partneradministratörer kör det här tokengeneratorverktyget minst en gång innan de börjar köra migreringsverktygen. Att köra det här verktyget är en engångsaktivitet efter att partnerkontot har registrerats i Wholesale RTM-lösningen. Det här verktyget gör det möjligt för partneradministratörer att logga in via webbläsare för att hämta den unika TOKEN som behövs för att uppdatera partnerkonfigurationsfilerna för migreringsverktygen.

Förutsättningar

Installera Java 8, 11, 17 eller 21 på datorn. Java finns tillgängligt från många källor, inklusive:

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

Extrahera binärfilerna för migreringsverktyget efter nedladdningen.

Instruktioner för att köra

Kör följande kommando i terminalen i tokengeneratorkatalogen:

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

Öppna URL:en i webbläsaren på terminalen, logga in med partneradministratörens inloggningsuppgifter för att hämta TOKEN och kopiera den för vidare användning.

Illustrationerna av användargränssnittet ges nedan som referens:

Figur 3: Logga in med Cisco Webex

Figur 4: Fönster för autentiseringsuppgifter

Figur 5: Tokengenerering

Konfigurera följande steg innan du kör verktygen för extrahering och enhetsflyttning på den sekundära BroadWorks-servern.

Aktivera OCI-P-anslutning

Verktyget för enhetsflytt kommunicerar med BroadWorks via OCI-P-kommandon. För att aktivera OCI-P-anslutning, följ stegen nedan:

Steg 1: Använd CLI för att konfigurera allmänna inställningar.

Kör följande kommando i CLI för att byta till katalogen GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Kör följande kommando i CLI för att hämta aktuella GeneralSettings:

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

Om dina inställningar inte matchar ovanstående, använd kommandot set för att konfigurera om dina inställningar.

Steg 2: Använd CLI för att konfigurera OCI-proxy.

Ändra katalogen till OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Kör följande CLI för att hämta aktuella inställningar. Du bör se följande:

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

Om dina inställningar inte matchar ovanstående, använd kommandot set för att konfigurera om dina inställningar.

Steg 3: Använd CLI för att konfigurera OCI-provisionering.

Ändra till provisioneringskatalogen:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kör följande kommando för att hämta de aktuella OCI-provisioneringsinställningarna:

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

Steg 4: Kör kommandot nedan i CLI för att verifiera att din konfiguration är 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.

Verifiera att öppen klientserver är distribuerad och aktiv

Använd kommandona nedan för att distribuera och starta Open Client Server på den sekundära applikationsservern om den inte är distribuerad eller inte redan har startats.

Steg 1: Distribuera servern med följande CLI-kommando:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Steg 2: Starta servern med detta kommando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktivera siffror

Kör följande kommandon i CLI för att aktivera aktiveringen av siffrorna:

Steg 1: Kör kommandot för numerisk aktivering:

AS_CLI> cd SubscriberMgmt/NumberActivation

Steg 2: Kör kommandot aktivering aktiverat:

AS_CLI> set dnMode groupAndUserActivationEnabled

Steg 3: Vid bekräftelsefrågan skriver du Y.

För BroadCloud

Extraktionsverktyget är integrerat i BroadCloud Service Provider-portalen. En tjänsteleverantörsadministratör kan:

1. Skicka utdragsförfrågningar för upp till 50 kunder per begäran.
   En begäran om utdrag kan inte skickas in för samma kund mer än 10 gånger per dag.
2. Ladda ner den extraherade datafilen, i ZIP-format, i upp till 28 dagar från begäran om inlämning.

Följande bilder visar tjänsteleverantörsportalen.

Figur 6: Tjänsteleverantörsportal

Figur 7: Tjänsteleverantörsportal

CSV-extraktbegäran

Initiera begäran om CSV-extraktion

1. Ladda ner kundens CSV-fil

   Klicka på länken Ladda ner kund-CSV längst upp till höger i avsnittet Initiera begäran om CSV-extraktion.

2. Redigera kundlistan

   Administratören kan redigera denna CSV-fil för att endast inkludera de kunder för vilka extraktionen behöver utföras.

3. Ladda upp och skicka in

   Ladda upp den modifierade CSV-filen efter redigeringen.

   Klicka på Skicka för att initiera en utdragsbegäran för de listade kunderna och deras tillhörande platser.

Initiera utdragsbegäran för en kund med platser CSV

1. Välj kund- och nedladdningsplatser

   Välj en kund från rullgardinsmenyn.

   Ladda ner motsvarande locations.csv från Visa kunder→ fliken Platser → Exportera platser som CSV.

2. Redigera platsfilen

   Administratören kan redigera CSV-filen så att den endast inkluderar de platser de vill extrahera.

3. Ladda upp och skicka in

   Ladda upp den redigerade locations.csv-filen och klicka på Skicka.

   Endast de angivna platserna för den valda kunden kommer att inkluderas i utdragsbegäran.

Initiera utdragsbegäran för alla kunder

1. Klicka på Skicka för att initiera en utdragsbegäran för alla kunder och alla deras platser under den nuvarande tjänsteleverantören.

För Cisco BroadWorks och Webex för BroadWorks

1. Extraktionsverktyget körs på den sekundära Cisco BroadWorks Application Server inom partnernätverket och ansluter via OCI-P.
2. Verktyget hämtar råa företags-, grupp-, nummer-, användare-, tjänst-, enhets- och mjukvaruklientdata från Cisco BroadWorks- eller BroadCloud-plattformen och matar ut dessa data till XML-filer som tillhandahåller indata för transformeringsverktyget.

Nästa avsnitt förklarar hur man installerar och konfigurerar extraktionsverktyget.

Förutsättningar

1. SCP-kopiera extraktionsverktygets binärfiler till den sekundära Cisco BroadWorks-applikationsservern.
2. SSH till den sekundära Cisco BroadWorks-applikationsservern för att konfigurera förutsättningarna och köra extraheringsverktyget.
3. Konfigurera tjänsteleverantören och grupp-ID:t för att extrahera från Cisco BroadWorks i conf/exportTool.yml. Se följande exempel på YAML-kodavsnitt:

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

4. Se till att användar-ID, lösenord och värdnamn för den sekundära Cisco BroadWorks-applikationsservern är korrekta 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 är obligatorisk för en Webex för BroadWorks-migrering.

5. Ändra JDK/JRE miljösökvägen i export.sh-filen om den sekundära Cisco BroadWorks-applikationsservern JDK/JRE miljösökvägen skiljer sig från filen:

   JAVA_HOME=/usr/local/java/java_base

Instruktioner för att köra

Kör följande kommando i den sekundära Cisco BroadWorks-applikationsservern från extraheringsverktygskatalogen:

./export.sh

Terminalloggar

Följande loggar är tillgängliga i terminalen efter lyckad export: Köra 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
**************************************************

Produktionen

En ZIP-fil (extracted_data_<timestamp>.zip) som utdata finns i samma katalog för extraktionsverktyget. Använd följande kommando för att visa och använda ZIP-filen för inmatning 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

Det här transformeringsverktyget körs för alla migreringar. Transformeringsverktyget körs på vilken dator som helst, inklusive en partners administratörsbärbara dator, och använder Webex Public API:er. Den läser utdatafilen från extraktionsverktyget, ZIP (extracted_data_<timestamp>.zip), som indata och omvandlar den råa XML-filen till ett JSON-format som används av provisioneringsverktyget.

Förutsättningar

När du har laddat ner och extraherat binärfilerna för migreringsverktygen, konfigurera följande förutsättningar:

1. Ställ in REFRESH_TOKEN (Token kopierad från Token Generator Tool) och NAME_OF_MAIN_LOCATION i conf/partner.cfg fil:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Ange valfritt PROVISIONING_ID (kopierat från mallen i Partner Hub) i conf/partner.cfg fil:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   För att få en mer fullständig verifiering av kundens e-postadress kan du valfritt ange PROVISIONING_ID.
3. Konfigurera saknad information i input/customers.csv fil (se nästa avsnitt) om den saknas.
4. Lägg till slutanvändarens e-postadress i input/users.csv fil.
5. Om nya telefoner ska etableras, lägg till MAC-adressen och e-postadressen för användarens nya telefon i input/newphones.csv fil. Detta krävs endast om partneradministratörerna vill etablera nya telefoner i Wholesale calling.
6. Konvertera BroadWorks callcenter till CxEssentials med hjälp av input/cxessentials.csv fil.
7. Du kan också aktivera egenskapen UPPGRADERA_ALLA_CALL_CENTER_TILL_CX_ESSENTIALS för att konvertera alla callcenter till CxEssentials.
8. Använd input/locations.csv fil för att stödja migreringen av stora företag som gör det möjligt för administratörer att migrera sina kunders platser efter plats
9. Aktivera valfritt användning av MAC-adresser från User-Agent-rubriken i SIP REGISTER-meddelandet när MAC-adressen inte är tillgänglig i Cisco BroadWorks-enhetsprofilen. Avkommentera raden "ANVÄND_MAC_ADRESS_FRÅN_SIP_REGISTER=yes" i filen conf/partner.cfg
10. Funktionen för synkronisering av nätverksservern gör det möjligt för administratörer att etablera telefonnummer, MAC-adresser och användares e-postadresser under etableringen i migreringen i samma region. För att aktivera det, ställ in USE_NS_SYNC=yes i conf/partner.cfg.

    Om NS-synkronisering är inaktiverad hoppas administration av telefonnummer och enheter över, och användarna får tillfälliga e-postadresser.

11. Aktivera valfritt egenskaperna ANALOG_ANVÄNDARE_TYP_AKTIVERA_SAMTAL_VÄNTAR, ANALOG_ANVÄNDARE_TYP_AKTIVERA_MUSIK_PÅ_PARKERING och ANALOG_ANVÄNDARE_TYP_INAKTIVERA_T38 för att konfigurera samtal väntar, musik i vänteläge och inaktivera T38-inställningar för alla användare av analog typ.

Påfyllning av input/customers.csv

Filen input/customers.csv tillhandahåller data som kanske saknas i Cisco BroadWorks eller BroadCloud. Den här filen kan lämnas tom om all obligatorisk information redan finns tillgänglig. Du behöver inte fylla i alla kolumner, endast den information som saknas är obligatorisk.

Tabellen nedan förklarar de viktigaste kolumnerna i input/customers.csv.

Påfyllning av input/users.csv

Filen input/users.csv tillhandahåller data som kanske saknas i Cisco BroadWorks eller BroadCloud. Den här filen kan lämnas tom om all obligatorisk information redan finns tillgänglig. Du behöver inte fylla i alla kolumner, endast den information som saknas är obligatorisk.

Instruktioner för att köra

Kör Transform Tool i valfritt operativsystem. Använd stegen nedan för att köra verktyget i Windows och macOS:

Windows

Kör kommandot nedan för att köra Transform Tool i Windows:

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

MacOS

Utför följande steg för att köra transformeringsverktyget på macOS:

1. Skapa en virtuell miljö och installera beroenden för att köra transformeringsverktyget med 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 transformeringsverktyget:

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

Customer/user förhandskontroll

Transformverktyget gör API-anrop till Webex för att upptäcka potentiella provisioneringsproblem. Som standard validerar den kundens adress och primära e-postadress. Om värdet för PROVISIONING_ID anges i conf/partner.cfg filen, kommer den även att validera platsinformation. Resultaten av förkontrollen ingår i undantagsrapporten.

Dessutom kan följande valfria parametrar läggas till när transformeringsverktyget körs:

förhandskontroll

Förutom att köra förkontrolls-API:et för kundinformationen, kommer Transform Tool även att köra förkontrolls-API:et för prenumeranternas e-postadresser.

förhandskontrollinformation

Som standard inkluderas endast förkontrollsfel (dvs. problem som blockerar etablering) i undantagsrapporten. Om du lägger till den här flaggan inkluderas även lyckade förkontrollresultat (t.ex. om det redan finns en Webex-organisation som kan anslutas automatiskt).

Terminalloggar

Följande loggar i terminalen vid lyckad 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

Undantagsrapport

Transform Tool genererar undantagsrapporten inuti utdata/<timestamp>/exception_report.txt katalog. Du kan använda den här rapporten för att identifiera de problem som kommer att påverka migreringen och åtgärda dem i Cisco BroadWorks-systemet.

När du har ändrat användardata för att lösa undantaget, kör verktygen för extrahering och transformering igen med de nya uppgifterna. Exempelfilen för undantagsrapporten enligt följande:

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

Produktionen

En JSON-utdatafil (customer.json) kommer att finnas tillgänglig i output/<timestamp>/<groupid> katalog. Exempelfilen customer.json är som följer:

{
    "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"
    }
}

Provisioneringsverktyget kan köras på vilken maskin som helst, vanligtvis (partnerns administratörsbärbara dator) och använder Webex Public API:er. Den läser transformeringsverktygets JSON-fil (customer.json) som indata och etablerar kunder, platser, nummer, användare, tjänster och enheter i Webex Wholesale RTM-lösningen.

Förutsättningar

Konfigurera följande krav i provisioneringsverktygets katalog:

1. Installera Java 8, 11, 17 eller 21 på datorn. Java finns tillgängligt från många källor, inklusive:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Efter att du har laddat ner och extraherat binärfilerna för migreringsverktygen, ange miljövariabeln JAVA_HOME i provisioning_tool.sh för MAC och provisioning_tool.bat för Windows.
3. partner.cfg-filen:
   • Ställ in ID för GROSSIST_PROVISIONING_och UPPDATERA_TOKEN (token kopierad från tokengeneratorverktyget). Partneradministratörerna måste kontakta sitt kontoteam för att få PROVISIONING_ID:t:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Ställ in ALLOW_ADMIN_INVITE_EMAILS till false om partnern inte vill skicka ett välkomstmejl till användarna. Standardvärdet är sant.

4. Använd egenskapen WEBEX4BWKS_EMAIL_SUBJECT för Webex för BroadWorks-migreringar för att skicka e-postmeddelandet med begäran om lösenordsändring för Webex för BroadWorks-prenumeranter.
5. Använd egenskapen WEBEX4BWKS_EMAIL_BODY för Webex för BroadWorks-migreringar för att skicka e-postmeddelandet med begäran om lösenordsändring för Webex för BroadWorks-prenumeranter.
6. Funktionen för synkronisering av nätverksservern gör det möjligt för administratörer att etablera telefonnummer, MAC-adresser och användares e-postadresser under etableringen i migreringen i samma region. För att aktivera det, ställ in USE_NS_SYNC=yes i conf/partner.cfg.

   Om NS-synkronisering är inaktiverad hoppas administration av telefonnummer och enheter över, och användarna får tillfälliga e-postadresser.

För BroadCloud-migreringar i samma region:

1. Verktyget hoppar över etableringen av nummer, enheter och delade samtalsutseenden.
2. Verktyget skapar användare och virtuella användare med tillägg och tillfällig tillägg.

För BroadCloud-migreringar till en annan region:

1. Verktyget kommer att tillhandahålla nummer, enheter och delade samtalsvisningar.
2. Verktyget skapar användare och virtuella användare med faktiska telefonnummer och anknytning.
   Alla BroadCloud-migreringar i Europa sker till en annan region.

Instruktioner för att köra

Använd följande steg för att köra verktyget i Windows och macOS:

Windows

Utför följande steg för att köra verktyget på Windows OS:

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

MacOS

Utför följande steg för att köra verktyget på macOS:

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

Förutsättningar för Webex för BroadWorks-migrering

Partneradministratörer måste uppdatera sin BroadWorks-introduktionsmall för Webex för BroadWorks-samexistensfunktioner. Se följande bild:

När Webex för BroadWorks onboarding-mallen har uppdaterats för att stödja migrering, be Cisco-kontoteamet att aktivera funktionen "wholesale-partner-blending-enabled" på partnernivå. Detta gör det möjligt att lägga till grossistpaket i befintliga Webex för BroadWorks-kundorganisationer under etableringen.

Kör etableringsverktyget med ett ytterligare argument.

Förberedelsefas: är standardfasen där administratörer kan etablera BroadWorks-användare som grossistprenumeranter och fortsätta med Webex för BroadWorks-användare.

Underhållsfas: är den andra fasen där administratörer kan tilldela grossistlicensen till befintliga Webex för BroadWorks-användare. Du måste köra provisioneringsverktyget med argumentet maintenance.

Eftermigreringsfas: Är den sista fasen då administratörer kan konvertera BroadWorks till grossistförsäljning helt och hållet. Du måste köra provisioneringsverktyget med argumentet postmigration.

Terminalloggar

Följande är loggarna i terminalen för lyckad 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 ****************

En tabell kommer att skrivas ut med antalet platser som skapats för varje körning:

Produktionen

Provisioneringsverktyget genererar framgångs- och felrapporter i utdata/<external_id>/*.success/error filer. Granska loggar för lyckade utdata och fel för att verifiera att etableringen har lyckats.

Partneradministratörer kan verifiera kundprovisioneringen i Partner Hub och Control Hub-portalen. Se följande illustrationer från Partner Hub och Control Hub-portalen:

Bild 8: partnerhubben

Figur 9: Control Hub

Figur 10: Enheter

Bild 11: Samtal

För BroadCloud

För BroadCloud-partners, använd tjänsteleverantörsportalen för att skicka in en migreringsbegäran för nummer, enheter och migreringar av delade samtalsappearances (SCA).

Inom tjänsteleverantörsportalen kan en migreringsbegäran inkludera upp till 50 kunder. Maximalt 10 förfrågningar kan skickas in inom en dag.

Funktionen Nätverksserversynkronisering låter administratörer inaktivera BroadCloud-platsen och aktivera Webex Calling-platsen genom att ställa in USE_NS_SYNC=yes i conf/partner.cfg. Efter migreringen aktiveras enheter och telefonnummer på Webex Calling-platsen.

Administratörer kan aktivera automatisk återställning genom att ange ROLLBACK_TO_BROADCLOUD=true i conf/partner.cfg -filen, vilket flyttar enheter tillbaka till BroadCloud efter migreringen. Den stöder både migreringar från samma och olika regioner med NS Sync, men bara för lyckade migreringar. För misslyckade system måste administratörer skapa en Cisco TAC innan de begär återställning.

Det finns två alternativ för att välja migreringstyp i portalen:

• Migrering – Välj det här alternativet för att initiera en begäran om migrering av nummer, enheter och delade samtalsappearances (SCA).
• Enhetsstatus – Välj det här alternativet för att visa enhetens aktuella status på BroadCloud och i samtal.

Följande bilder visar tjänsteleverantörsportalen.

Figur 12: Tjänsteleverantörsportal

Figur 13: Tjänsteleverantörsportal

Migrera valda platser (valfritt)

För att starta migreringen för en specifik delmängd av platser som listas i customer.json -filen, inkludera en locations.csv -fil med din begäran. Denna CSV-fil ska endast lista de platser du avser att migrera.

För att ladda ner listan över tillgängliga aktiva webbplatser, navigera till Visa kunder → Välj en kund → Exportera platser som CSV.

Bild 14: Exportera platser som CSV

För Cisco BroadWorks och Webex för BroadWorks

För Cisco BroadWorks- och Webex för BroadWorks-migreringar körs verktyget på den sekundära Cisco BroadWorks-applikationsservern inom partnernätverket och ansluter till AS via OCI-P. Den använder Transform Tool-utdatafilen JSON (customer.json) som indata och kör OCI-P-kommandona för att migrera enheter och mjukvaruklienter.

Vid lyckad operation kommer enhetsflyttningsverktyget att:

1. Avregistrera enheter från Cisco BroadWorks och registrera dem i Wholesale.
2. Användare som använder UC-One-klienten omdirigeras till Webex-appen vid första inloggningen.
3. Inaktivera telefonnumren från Cisco BroadWorks eller ta bort telefonnumren från BroadCloud.
4. Aktivera nummer i Grossistledet.
5. Skapa delade samtalsframträdanden i Wholesale för BroadCloud-migreringar. [This steget gäller endast för BroadCloud migrations].

SCP och SSH

1. SCP-verktyget för enhetsflytt till den sekundära Cisco BroadWorks-applikationsservern.
2. SSH till den sekundära Cisco BroadWorks-applikationsservern för att konfigurera förutsättningarna och köra verktyget för enhetsflytt.

Förutsättningar

1. Ställ in REFRESH_TOKEN (Token kopierad från Token Generator Tool) i conf/partner.cfg fil:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Se till att användar-ID, lösenord och värdnamn för den sekundära Cisco BroadWorks-applikationsservern är korrekta i conf/deviceMoveTool.conf fil:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. För att skicka aktiveringsmejl igen måste du ställa in RESEND_INVITATION_EMAILS=true i conf/partner.cfg fil.

   Om administratörer vill skicka e-postinbjudningar till sina användare under migreringen bör de avkommentera "SKICKA RES_INVITATION_EMAILS=true" egendom i conf/partner.cfg fil. Annars bör fastigheten förbli oförändrad.

4. Verifiera JDK/JRE miljösökvägen är korrekt i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratörer kan använda filen locations.csv från indatakatalogen för att migrera specifika grupper istället för alla grupper under ett företag.

Polycom-telefoner

För att flytta Polycom-telefoner från Cisco BroadWorks till Wholesale Calling måste en partneradministratör skapa en ny Identity/Device Profiltypfil på systemnivå i Cisco BroadWorks varje Polycom-enhetsmall. Se figur 14 och ladda upp den anpassade filen device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Efter att du har laddat upp den nya enhetsfilen, se till att den nyskapade filen finns på gruppnivå. Se också till att filen migration_%BWMAC ADDRESS%.cfg inte står i konflikt med någon befintlig fil i ditt system).

Den används internt av enhetsflyttverktyget.

Migreringsprocessen för Polycom-telefoner:

1. Verktyget för enhetsflytt ersätter filen %BWMACADDRESS%.cfg på enhetsnivå med polycom_vvx2.cfg. Den här filen refererar till migration_%BWMACADDRESS%.cfg.
2. Återskapa enhetsprofilerna på gruppnivå eller enhetsnivå.
   Att agera på gruppnivå eller enhetsnivå beror på konfigurationen av parametern deviceLevelRebuild i filen. device-move-tool/conf/partner.cfg.
3. Verktyget för enhetsflytt ber Cisco BroadWorks-applikationsservern att starta om telefoner på gruppnivå eller enhetsnivå.
4. Efter omstartsbegäran laddar och bearbetar Polycom-telefonerna% BWMACADDRESS%.cfg, vilket ber Polycom-telefonerna att ladda ner och bearbeta migration_%BWMACADDRESS%.cfg, vilket ställer in device.prov.serverName till https://plcm.sipflash.com..
   https://plcm.sipflash.com För den amerikanska regionen har andra regioner andra URL:er.
5. Polycom-telefonen laddar ner %BWMACADDRESS%.cfg från https://plcm.sipflash.com och kommer att hanteras av Webex Calling DMS.

Bild 14: Identity/device profiltyp filtillägg

Instruktioner för att köra

Det finns två metoder för att anropa DMT:n, den första är att anropa en enda kund åt gången och den andra är att köra flera kunder samtidigt.

Enhetsflyttningsverktyget körs från den sekundära Cisco BroadWorks-applikationsservern inuti enhetsflyttningsverktygets katalog:

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

Terminalloggar

Följande är loggarna i terminalen när enhetsflyttningsverktyget för enhetsmigrering kördes:

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

Produktionen

Efter enhetsmigreringen har enheterna kommit online och är redo att användas make/receive samtal. Se figur 15 för ett exempel på enhetens status:

Figur 15: Enhetsstatus

Efter enhetsmigreringen har numren blivit aktiva. Se figur 16 för ett exempel på vilka nummer som är aktiva:

Figur 16: Aktiva nummer

Återställningsåtgärden måste utföras för ett företag i taget.

För BroadCloud-operatören

Återställningsprocessen för BroadCloud-partners är följande:

1. Öppna ett ärende med Cisco TAC för att begära en återställning av enheten.
2. Kör enhetsflyttningsverktyget i återställningsläge:
   • Telefonnummer kommer att tas bort från Webex Calling, vilket innebär att användare och tjänster endast har anknytningar.
   • E-postadresser i Webex Calling kommer att återställas till tillfälliga e-postadresser.
   • Telefoner kommer att raderas från Webex Calling.
   • Telefonnummer, e-postadresser som används som alternerade ID:n och telefoner kommer att återskapas i BroadCloud.
   • Telefonerna kommer att startas om.
3. Partneradministratörer måste flytta tillbaka PSTN-telefonnummer till BroadCloud Carrier.

För Cisco BroadWorks och Webex för BroadWorks

Återställningsprocessen för Cisco BroadWorks och Webex för BroadWorks är följande:

1. Öppna ett ärende med Cisco TAC för att begära en återställning av enheten.
2. Kör enhetsflyttningsverktyget i återställningsläge på den sekundära BroadWorks-applikationsservern för att återställa enhetsmigreringarna. Detta återställer DMS-URL:en till tjänsteleverantörens DMS-URL för enhetsprofiler i Cisco BroadWorks och återaktiverar telefonnummer.
3. Webex Calling-teamet ställer in DMS-URL:en tillbaka till tjänsteleverantörens DMS-URL i enhetsprofiler i Webex Calling.
4. Partneradministratörer måste inaktivera eller ta bort telefonnumren i Webex Calling via Control Hub-portalen.
5. Partneradministratörer måste flytta tillbaka PSTN-telefonnummer till Cisco BroadWorks.

Instruktioner för att köra enhetsflyttningsverktyget i återställningsläge

Följ stegen nedan för att köra enhetsflyttningsverktyget i återställningsläge:

Kör kommandot nedan i den sekundära Cisco BroadWorks-applikationsservern i katalogen för enhetsflyttningsverktyget:

Återställ profiler

./devicemove.sh -input=  -revertProfiles

Återställ siffror

./devicemove.sh -input=  -revertNumbers

Terminalloggar

Vi kommer att få följande loggar i terminalen när enhetsflyttningsverktyget körs för återställning:

Återställ 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

Återställ siffror

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