Ondersteunde telefoons worden automatisch door de inrichtingstool gemaakt en toegewezen aan gebruikers in Webex Calling. De telefoons die in de kolom 'Ondersteund in de tool voor apparaatverplaatsing' met 'ja' zijn gemarkeerd, worden ook automatisch van Cisco BroadWorks of BroadCloud naar Webex Calling verplaatst wanneer de tool voor apparaatverplaatsing wordt uitgevoerd. Telefoons die in die kolom met 'Nee' zijn gemarkeerd, vereisen een handmatige tussenkomst om de DMS-URL in de Cisco BroadWorks-apparaatsjabloon of in de telefoon zelf te wijzigen.

De laatste kolom geeft de toewijzing van telefoonmodellen aan de kolom 'Apparaattype' van het bestand weer transform-tool/input/newphones.csv. (Zie het gedeelte Transformatietool van dit artikel voor meer informatie over newphones.csv).

Partnerbeheerders voeren dit hulpprogramma voor het genereren van tokens ten minste één keer uit voordat ze beginnen met het uitvoeren van migratietools. Het uitvoeren van deze tool is een eenmalige activiteit nadat het partneraccount is toegevoegd aan de Wholesale RTM-oplossing. Met deze tool kunnen partnerbeheerders via een webbrowser inloggen om het unieke TOKEN te verkrijgen dat nodig is om de partnerconfiguratiebestanden voor de migratietools bij te werken.

Voorwaarden

Installeer Java 8, 11, 17 of 21 op de computer. Java is beschikbaar via veel bronnen, waaronder:

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

Na het downloaden pakt u de binaire bestanden van de migratietool uit.

Instructies om te draaien

Voer de volgende opdracht uit in de terminal in de map van de tokengenerator:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Uitvoer:

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

Open de URL in de webbrowser op de terminal, meld u aan met de partnerbeheerdergegevens om het TOKEN te verkrijgen en kopieer dit voor later gebruik.

Hieronder vindt u ter referentie de illustraties van de gebruikersinterface:

Afbeelding 3: Inloggen met Cisco Webex

Afbeelding 4: Venster met referenties

Afbeelding 5: Tokengeneratie

Configureer de volgende stappen voordat u de hulpprogramma's voor uitpakken en verplaatsen van apparaten op de secundaire BroadWorks-server uitvoert.

OCI-P-connectiviteit inschakelen

De tool voor het verplaatsen van apparaten communiceert met BroadWorks via OCI-P-opdrachten. Om OCI-P-connectiviteit in te schakelen, volgt u onderstaande stappen:

Stap 1: Gebruik de CLI om algemene instellingen te configureren.

Voer de volgende opdracht uit in de CLI om naar de map GeneralSettings te gaan:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Voer de volgende opdracht uit in CLI om de huidige GeneralSettings op te halen:

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

Als uw instellingen niet overeenkomen met het bovenstaande, gebruikt u de opdracht set om uw instellingen opnieuw te configureren.

Stap 2: Gebruik de CLI om de OCI-proxy te configureren.

Wijzig de directory naar OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Voer de volgende CLI uit om de huidige instellingen op te halen. U zou het volgende moeten zien:

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

Als uw instellingen niet overeenkomen met het bovenstaande, gebruikt u de opdracht set om uw instellingen opnieuw te configureren.

Stap 3: Gebruik de CLI om OCI Provisioning te configureren.

Ga naar de Provisioning-directory:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Voer de volgende opdracht uit om de huidige OCI-provisioninginstellingen op te halen:

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

Stap 4: Voer de onderstaande opdracht uit in CLI om te controleren of uw configuratie correct is.

 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.

Controleer of de open clientserver is geïmplementeerd en actief is

Gebruik de onderstaande opdrachten om de Open Client Server te implementeren en te starten op de secundaire Application Server als deze nog niet is geïmplementeerd of nog niet is gestart.

Stap 1: Implementeer de server met de volgende CLI-opdracht:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Stap 2: Start de server met deze opdracht:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Activering van nummers inschakelen

Voer de volgende opdrachten uit in CLI om de activering van de nummers in te schakelen:

Stap 1: Voer de nummeractiveringsopdracht uit:

AS_CLI> cd SubscriberMgmt/NumberActivation

Stap 2: Voer de opdracht 'Activering ingeschakeld' uit:

AS_CLI> set dnMode groupAndUserActivationEnabled

Stap 3: Voer bij de bevestigingsvraag Y in.

Voor BroadCloud

De extractietool is geïntegreerd in het BroadCloud Service Provider-portaal. Een beheerder van een serviceprovider kan:

1. U kunt per aanvraag uittrekselverzoeken indienen voor maximaal 50 klanten.
   Een extractieverzoek kan voor dezelfde klant niet vaker dan 10 keer per dag worden ingediend.
2. Download het geëxtraheerde gegevensbestand in ZIP-formaat, tot maximaal 28 dagen na de datum van indiening van de aanvraag.

De onderstaande afbeeldingen tonen het Service Provider-portaal.

Afbeelding 6: Service Provider-portaal

Afbeelding 7: Service Provider-portaal

CSV-extractverzoek

CSV-extractverzoek starten

1. Download het klant-CSV-bestand

   Klik op de link Klant-CSV downloaden in de rechterbovenhoek van de sectie CSV-extractieverzoek starten.

2. De klantenlijst bewerken

   De beheerder kan dit CSV-bestand bewerken, zodat het alleen de klanten bevat waarvoor de extractie moet worden uitgevoerd.

3. Uploaden en verzenden

   Nadat u het aangepaste CSV-bestand hebt bewerkt, uploadt u het.

   Klik op Verzenden om een extractieverzoek te starten voor de vermelde klanten en de bijbehorende locaties.

Een extractieverzoek starten voor een klant met een locatie-CSV

1. Selecteer klant- en downloadlocaties

   Selecteer een klant uit de keuzelijst.

   Download de bijbehorende locaties.csv van Klanten bekijken→ tabblad Vestigingen → Locaties exporteren als CSV.

2. Bewerk het locatiebestand

   De beheerder kan het CSV-bestand bewerken, zodat het alleen de locaties bevat die hij wil extraheren.

3. Uploaden en verzenden

   Upload de bewerkte locaties.csv en klik op Verzenden.

   Alleen de opgegeven locaties voor de geselecteerde klant worden opgenomen in het extractieverzoek.

Initieer een extractieverzoek voor alle klanten

1. Klik op Verzenden om een extractieverzoek te starten voor alle klanten en al hun locaties onder de huidige serviceprovider.

Voor Cisco BroadWorks en Webex voor BroadWorks

1. De extractietool draait op de secundaire Cisco BroadWorks Application Server binnen het partnernetwerk en maakt verbinding via OCI-P.
2. De tool haalt onbewerkte bedrijfs-, groeps-, getallen-, gebruikers-, service-, apparaat- en softclientgegevens op van het Cisco BroadWorks- of BroadCloud-platform en voert deze gegevens uit naar XML-bestanden die de invoer voor de transformatietool vormen.

In de volgende secties wordt uitgelegd hoe u de extracttool installeert en configureert.

Voorwaarden

1. SCP de extract tool-binaries naar secundaire Cisco BroadWorks Application Server.
2. Maak via SSH verbinding met de secundaire Cisco BroadWorks Application Server om de vereisten te configureren en de extractietool uit te voeren.
3. Configureer de serviceprovider en groeps-ID die u uit Cisco BroadWorks wilt halen in de conf/exportTool.yml. Raadpleeg het volgende voorbeeld-YAML-fragment:

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

4. Zorg ervoor dat de secundaire Cisco BroadWorks Application Server-gebruikers-ID, het wachtwoord en de hostnaam correct zijn in de conf/partner.cfg bestand:

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

   De eigenschap REFRESH_TOKEN is verplicht voor een Webex voor BroadWorks-migratie.

5. Wijzig de JDK/JRE omgevingspad in het export.sh-bestand als de secundaire Cisco BroadWorks Application Server JDK/JRE omgevingspad is anders dan het bestand:

   JAVA_HOME=/usr/local/java/java_base

Instructies om te draaien

Voer de volgende opdracht uit in de secundaire Cisco BroadWorks Application Server vanuit de map met extracttools:

./export.sh

Terminallogboeken

Bij succesvolle export zijn de volgende logs beschikbaar in de terminal: BroadSoft Data Export Tool uitvoeren:

 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

Een ZIP-uitvoerbestand (extracted_data_<timestamp>.zip) is beschikbaar in dezelfde map van de uitpaktool. Gebruik de volgende opdracht om het ZIP-bestand te bekijken en te gebruiken voor de invoer van de Transformatietool:

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

Deze transformatietool wordt uitgevoerd voor alle migraties. De transformatietool kan op elke computer worden uitgevoerd, inclusief de beheerderslaptop van een partner, en maakt gebruik van de openbare API's van Webex. Het leest het ZIP-bestand (extracted_data_<timestamp>.zip) van de uitvoer van de extractietool als invoer en transformeert de onbewerkte XML naar een JSON-indeling die wordt gebruikt door de provisioningtool.

Voorwaarden

Nadat u de binaire bestanden van de migratietools hebt gedownload en uitgepakt, configureert u de volgende vereisten:

1. Stel de REFRESH_TOKEN (Token gekopieerd uit de Token Generator Tool) en NAAM_VAN_HOOFD_LOCATIE in de conf/partner.cfg bestand:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Optioneel kunt u de PROVISIONING_ID (gekopieerd uit de sjabloon in Partner Hub) in de conf/partner.cfg bestand:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Voor een volledigere verificatie van het e-mailadres van de klant kunt u optioneel de PROVISIONING_ID instellen.
3. Configureer ontbrekende informatie in de input/customers.csv bestand (zie volgende sectie) indien dit ontbreekt.
4. Voeg het e-mailadres van de eindgebruiker toe in de input/users.csv bestand.
5. Als er nieuwe telefoons moeten worden ingericht, voegt u het MAC-adres en e-mailadres van de nieuwe telefoon van de gebruiker toe aan input/newphones.csv bestand. Dit is alleen vereist als de partnerbeheerders nieuwe telefoons willen inrichten voor Groothandelsgesprekken.
6. Converteer de BroadWorks Call Centers naar CxEssentials met behulp van de input/cxessentials.csv bestand.
7. Schakel optioneel de eigenschap UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS in om alle callcenters naar CxEssentials te converteren.
8. Gebruik de input/locations.csv bestand ter ondersteuning van de grote ondernemingsmigratie waarmee beheerders de locaties van hun klanten per locatie kunnen migreren
9. U kunt optioneel het gebruik van MAC-adressen inschakelen vanuit de User-Agent-header van het SIP REGISTER-bericht wanneer het MAC-adres niet beschikbaar is in het Cisco BroadWorks-apparaatprofiel. Verwijder de commentaartekens voor de regel "USE_MAC_ADRES_VAN_SIP_REGISTER=yes" in bestand conf/partner.cfg
10. Met de functie voor netwerkserversynchronisatie kunnen beheerders telefoonnummers, MAC-adressen en e-mailadressen van gebruikers inrichten tijdens de migratie naar dezelfde regio. Om dit in te schakelen, stelt u USE_NS_SYNC=yes in conf/partner.cfgin.

    Als NS-synchronisatie is uitgeschakeld, worden telefoonnummer- en apparaatinrichting overgeslagen en krijgen gebruikers tijdelijke e-mailadressen.

11. Schakel optioneel de eigenschappen ANALOG_GEBRUIKER_TYPE_INSCHAKELEN [_OPROEP_WACHTEN, ANALOG_GEBRUIKER_TYPE_INSCHAKELEN_MUZIEK_IN_WACHTEN en ANALOG_GEBRUIKER_TYPE [_UITSCHAKELEN_T38 in om oproep in de wacht te configureren, muziek in de wacht te zetten en T38-instellingen uit te schakelen voor alle gebruikers van het analoge type.

Het vullen van de input/customers.csv

Het bestand input/customers.csv biedt gegevens die mogelijk ontbreken in Cisco BroadWorks of BroadCloud. Dit bestand kan leeg worden gelaten als alle verplichte informatie al beschikbaar is. U hoeft niet alle kolommen in te vullen, alleen de ontbrekende informatie is verplicht.

De onderstaande tabel geeft de belangrijkste kolommen in input/customers.csv.

Het vullen van de input/users.csv

Het bestand input/users.csv biedt gegevens die mogelijk ontbreken in Cisco BroadWorks of BroadCloud. Dit bestand kan leeg worden gelaten als alle verplichte informatie al beschikbaar is. U hoeft niet alle kolommen in te vullen, alleen de ontbrekende informatie is verplicht.

Instructies om te draaien

Voer de Transformatietool uit op elk besturingssysteem. Gebruik de onderstaande stappen om de tool uit te voeren in Windows en macOS:

Windows

Voer de onderstaande opdracht uit om de Transformatietool in Windows uit te voeren:

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

macOS

Voer de volgende stappen uit om de transformatietool op macOS uit te voeren:

1. Maak een virtuele omgeving en installeer afhankelijkheden om de transformatietool uit te voeren met 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. Voer de transformatietool uit:

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

Customer/user voorcontrole

De Transform Tool voert API-aanroepen uit naar Webex om mogelijke inrichtingsproblemen op te sporen. Standaard worden het adres en het primaire e-mailadres van de klant gevalideerd. Als de waarde van de PROVISIONING_ID is opgegeven in de conf/partner.cfg bestand, zal het ook de locatie-informatie valideren. De resultaten van de voorafgaande controle worden opgenomen in het uitzonderingsrapport.

Bovendien kunnen de volgende optionele parameters worden toegevoegd wanneer u de transformatietool uitvoert:

voorcontrole

Naast het uitvoeren van de precheck-API voor de klantgegevens, voert de Transform Tool ook de precheck-API uit voor de e-mails van de abonnees.

precheckinfo

Standaard worden alleen fouten voorafgaand aan de controle (d.w.z. problemen die de inrichting blokkeren) in het uitzonderingsrapport opgenomen. Als u deze vlag toevoegt, worden ook succesvolle resultaten van de voorcontrole meegenomen (bijvoorbeeld als er al een Webex-organisatie bestaat die automatisch kan worden gekoppeld).

Terminallogboeken

Het volgende wordt in de terminal geregistreerd bij een succesvolle transformatie:

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

Uitzonderingsrapport

Transform Tool genereert het uitzonderingsrapport in de output/<timestamp>/exception_report.txt map. Met dit rapport kunt u de problemen identificeren die van invloed zijn op de migratie en deze in het Cisco BroadWorks-systeem oplossen.

Nadat u de gebruikersgegevens hebt gewijzigd om de uitzondering op te lossen, voert u de hulpmiddelen voor extraheren en transformeren opnieuw uit met de nieuwe gegevens. Het voorbeeld van een uitzonderingsrapportbestand ziet er als volgt uit:

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

Een JSON-uitvoerbestand (customer.json) zal beschikbaar zijn in de output/<timestamp>/<groupid> map. Het voorbeeldbestand customer.json ziet er als volgt uit:

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

De provisioning tool kan op elke computer worden uitgevoerd, meestal de laptop van de beheerder van de partner, en maakt gebruik van de openbare API's van Webex. Het leest het JSON-uitvoerbestand (customer.json) van de transformatietool als invoer en richt de klanten, locaties, nummers, gebruikers, services en apparaten in de Webex Wholesale RTM-oplossing in.

Voorwaarden

Configureer de volgende vereisten in de map met de provisioningtool:

1. Installeer Java 8, 11, 17 of 21 op de computer. Java is beschikbaar via veel bronnen, waaronder:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Nadat u de binaire bestanden van de migratietools hebt gedownload en uitgepakt, stelt u de JAVA_HOME-omgevingsvariabele in provisioning_tool.sh voor MAC en provisioning_tool.bat voor Windows in.
3. Het partner.cfg-bestand:
   • Stel de WHOLESALE_PROVISIONING_ID en REFRESH_TOKEN in (token gekopieerd uit de Token Generator Tool). De partnerbeheerders moeten contact opnemen met hun accountteam om de PROVISIONING_ID te verkrijgen:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Stel ALLOW_ADMIN_INVITE_EMAILS in op false als de partner geen welkomstmail naar de gebruikers wil sturen. De standaardwaarde is true.

4. Gebruik de eigenschap WEBEX4BWKS_EMAIL_SUBJECT voor Webex voor BroadWorks-migraties om het onderwerp van het e-mailbericht met het verzoek om wachtwoord te wijzigen te verzenden naar Webex voor BroadWorks-abonnees.
5. Gebruik de eigenschap WEBEX4BWKS_EMAIL_BODY voor Webex voor BroadWorks-migraties om de e-mailtekst met het verzoek om wachtwoord te wijzigen te verzenden naar Webex voor BroadWorks-abonnees.
6. Met de functie voor netwerkserversynchronisatie kunnen beheerders telefoonnummers, MAC-adressen en e-mailadressen van gebruikers inrichten tijdens de migratie naar dezelfde regio. Om dit in te schakelen, stelt u USE_NS_SYNC=yes in conf/partner.cfgin.

   Als NS-synchronisatie is uitgeschakeld, worden telefoonnummer- en apparaatinrichting overgeslagen en krijgen gebruikers tijdelijke e-mailadressen.

Voor BroadCloud-migraties dezelfde regio:

1. De tool slaat de inrichting van nummers, apparaten en gedeelde oproepweergaven over.
2. De tool maakt gebruikers en virtuele gebruikers met extensie en tijdelijke extensie.

Voor BroadCloud-migraties een andere regio:

1. Met de tool kunt u nummers, apparaten en gedeelde oproepweergaven inrichten.
2. De tool creëert gebruikers en virtuele gebruikers met echte telefoonnummers en toestelnummers.
   Alle BroadCloud-migraties binnen Europa vinden plaats naar een andere regio.

Instructies om te draaien

Gebruik de volgende stappen om de tool uit te voeren in Windows en macOS:

Windows

Voer de volgende stappen uit om het hulpprogramma op Windows uit te voeren:

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

macOS

Voer de volgende stappen uit om de tool op macOS uit te voeren:

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

Vereisten voor Webex voor BroadWorks-migratie

Partnerbeheerders moeten hun BroadWorks-onboardingsjabloon bijwerken voor Webex voor BroadWorks-coexistentiefuncties. Zie de volgende afbeelding:

Zodra de Webex voor BroadWorks Onboarding-sjabloon is bijgewerkt ter ondersteuning van migratie, vraagt u het Cisco Account Team om de functie 'wholesale-partner-blending-enabled' op partnerniveau in te schakelen. Hierdoor kunnen Wholesale-pakketten worden toegevoegd aan bestaande Webex voor BroadWorks-klantorganisaties tijdens de inrichting.

Voer de inrichtingstool uit met een extra argument.

Voorbereidingsfase: is de standaardfase waarin beheerders BroadWorks-gebruikers kunnen inrichten als groothandelsabonnees en kunnen doorgaan met Webex voor BroadWorks-gebruikers.

Onderhoudsfase: is de tweede fase waarin beheerders de Wholesale-licentie kunnen toewijzen aan de bestaande Webex voor BroadWorks-gebruikers. U moet de provisioningtool uitvoeren met een argument maintenance.

Post-migratiefase: Dit is de laatste fase waarin beheerders BroadWorks volledig naar Wholesale kunnen converteren. U moet de provisioningtool uitvoeren met een argument postmigration.

Terminallogboeken

Hieronder staan de logboeken in de terminal bij succesvolle inrichting:

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

Er wordt een tabel afgedrukt met het aantal locaties dat voor elke run is aangemaakt:

Output

De provisioningtool genereert succes- en foutrapporten in de output/<external_id>/*.success/error bestanden. Controleer de uitvoersucces- en foutlogboeken om te controleren of de inrichting succesvol is uitgevoerd.

Partnerbeheerders kunnen de klantinrichting controleren in de Partner Hub- en Control Hub-portal. Raadpleeg de volgende illustraties uit de Partner Hub- en Control Hub-portal:

Afbeelding 8: Partnerhub

Afbeelding 9: Control Hub

Afbeelding 10: Apparaten

Afbeelding 11: Oproepen

Voor BroadCloud

BroadCloud-partners kunnen via de Service Provider-portal een migratieverzoek indienen voor de migratie van nummers, apparaten en Shared Call Appearances (SCA).

Binnen het Service Provider-portaal kan een migratieverzoek maximaal 50 klanten betreffen. Er kunnen maximaal 10 verzoeken per dag worden ingediend.

Met de functie Netwerkserversynchronisatie kunnen beheerders de broadCloud-locatie deactiveren en de Webex Calling-locatie activeren door USE_NS_SYNC=yes in te stellen in de conf/partner.cfg. Na de migratie worden apparaten en telefoonnummers geactiveerd op de Webex Calling-locatie.

Beheerders kunnen automatisch terugdraaien inschakelen door ROLLBACK_TO_BROADCLOUD=true in te stellen in het conf/partner.cfg -bestand. Hiermee worden apparaten na de migratie teruggezet naar BroadCloud. Het ondersteunt zowel migraties naar dezelfde als naar verschillende regio's met NS Sync, maar alleen voor succesvolle migraties. Bij mislukte pogingen moeten beheerders een Cisco TAC indienen voordat ze een terugdraaiing kunnen aanvragen.

Er zijn twee opties beschikbaar voor het selecteren van het migratietype in de portal:

• Migratie – Selecteer deze optie om een aanvraag te starten voor het migreren van nummers, apparaten en Shared Call Appearances (SCA).
• Apparaatstatus – Selecteer deze optie om de huidige status van een apparaat op BroadCloud en Calling te bekijken.

De onderstaande afbeeldingen tonen het Service Provider-portaal.

Afbeelding 12: Service Provider-portaal

Afbeelding 13: Service Provider-portaal

Geselecteerde locaties migreren (optioneel)

Om de migratie voor een specifieke subset van locaties te starten die in het customer.json -bestand staan vermeld, voegt u een locations.csv -bestand toe aan uw aanvraag. In dit CSV-bestand moeten alleen de locaties worden vermeld die u wilt migreren.

Om de lijst met beschikbare actieve sites te downloaden, navigeert u naar Klanten bekijken → Selecteer een klant → Locaties exporteren als CSV.

Afbeelding 14: Locaties exporteren als CSV

Voor Cisco BroadWorks en Webex voor BroadWorks

Voor Cisco BroadWorks- en Webex voor BroadWorks-migraties wordt de tool uitgevoerd op de secundaire Cisco BroadWorks Application Server binnen het partnernetwerk en maakt verbinding met de AS via OCI-P. Het gebruikt het JSON-uitvoerbestand (customer.json) van de Transform Tool als invoer en voert de OCI-P-opdrachten uit om apparaten en softclients te migreren.

Bij een succesvolle bewerking zal het hulpmiddel voor het verplaatsen van het apparaat:

1. Apparaten afmelden bij Cisco BroadWorks en registreren bij Wholesale.
2. Gebruikers die de UC-One-client gebruiken, worden bij de eerste aanmelding omgeleid naar de Webex-app.
3. Deactiveer de telefoonnummers van Cisco BroadWorks of verwijder de telefoonnummers van BroadCloud.
4. Activeer nummers in Groothandel.
5. Maak gedeelde oproepweergaven in Wholesale voor BroadCloud-migraties. [This stap is alleen van toepassing op BroadCloud migrations].

SCP en SSH

1. SCP het hulpmiddel voor het verplaatsen van apparaten naar de secundaire Cisco BroadWorks Application Server.
2. Maak via SSH verbinding met de secundaire Cisco BroadWorks Application Server om de vereisten te configureren en de tool voor het verplaatsen van apparaten uit te voeren.

Voorwaarden

1. Stel de REFRESH_TOKEN (Token gekopieerd van de Token Generator Tool) in de conf/partner.cfg bestand:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Zorg ervoor dat de secundaire Cisco BroadWorks Application Server-gebruikers-ID, het wachtwoord en de hostnaam correct zijn in de conf/deviceMoveTool.conf bestand:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Om activeringsmails opnieuw te versturen, moet u RESEND_INVITATION_instellen EMAILS=true in de conf/partner.cfg bestand.

   Als beheerders tijdens de migratie uitnodigingsmails naar hun gebruikers willen sturen, moeten ze de optie 'OPNIEUW VERZENDEN_UITNODIGING_' uit het commentaar verwijderen. EMAILS=true" eigendom in de conf/partner.cfg bestand. Anders zou de eigenschap ongewijzigd moeten blijven.

4. Controleer de JDK/JRE omgevingspad is correct in devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Beheerders kunnen het bestand locations.csv uit de invoermap gebruiken om specifieke groepen te migreren in plaats van alle groepen onder een onderneming.

Polycom-telefoons

Om Polycom-telefoons van Cisco BroadWorks naar Wholesale Calling te verplaatsen, moet een partnerbeheerder een nieuw Identity/Device Profieltypebestand op systeemniveau in Cisco BroadWorks elk Polycom-apparaatsjabloon. Raadpleeg figuur 14 en upload het aangepaste bestand device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Nadat u het nieuwe apparaatbestand hebt geüpload, controleert u of het nieuw gemaakte bestand op groepsniveau bestaat. Zorg er ook voor dat bestand migration_%BWMAC ADDRESS%.cfg geen conflict veroorzaakt met een bestaand bestand op uw systeem.

Het wordt intern gebruikt door de tool voor het verplaatsen van apparaten.

Het migratieproces voor Polycom-telefoons:

1. Met de tool voor het verplaatsen van apparaten wordt het bestand %BWMACADDRESS%.cfg op apparaatniveau vervangen door polycom_vvx2.cfg. Dit bestand verwijst naar migration_%BWMACADDRESS%.cfg.
2. Bouw de apparaatprofielen opnieuw op groepsniveau of apparaatniveau.
   Het handelen op groepsniveau of apparaatniveau is afhankelijk van de configuratie van de parameter deviceLevelRebuild in het bestand device-move-tool/conf/partner.cfg.
3. Met de tool voor het verplaatsen van apparaten wordt de Cisco BroadWorks Application Server gevraagd om telefoons opnieuw op te starten op groepsniveau of apparaatniveau.
4. Na het verzoek om opnieuw op te starten, downloaden en verwerken Polycom-telefoons% BWMACADDRESS%.cfg, waarmee de Polycom-telefoons worden gevraagd migration_%BWMACADDRESS%.cfg te downloaden en te verwerken, waarmee device.prov.serverName wordt ingesteld op https://plcm.sipflash.com.
   https://plcm.sipflash.com voor de regio VS hebben andere regio's verschillende URL's.
5. De Polycom-telefoon downloadt %BWMACADDRESS%.cfg van https://plcm.sipflash.com en wordt beheerd door Webex Calling DMS.

Afbeelding 14: Identity/device profieltype bestand toevoegen

Instructies om te draaien

Er zijn twee methoden om de DMT aan te roepen. De eerste is om dit via één klant tegelijk te doen en de andere is om dit via meerdere klanten tegelijk te doen.

De tool voor het verplaatsen van apparaten wordt uitgevoerd vanaf de secundaire Cisco BroadWorks Application Server in de directory van de tool voor het verplaatsen van apparaten:

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

Terminallogboeken

Hieronder staan de logboeken in de terminal bij een succesvolle uitvoering van de tool voor apparaatverplaatsing voor apparaatmigratie:

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

Na de apparaatmigratie zijn de apparaten online gekomen en klaar voor gebruik. make/receive oproepen. Zie figuur 15 voor een voorbeeld van de apparaatstatus:

Afbeelding 15: Apparaatstatus

Na de apparaatmigratie zijn de nummers actief geworden. Zie figuur 16 voor een voorbeeld van welke nummers actief zijn:

Afbeelding 16: Actieve nummers

De terugzetbewerking moet voor één onderneming tegelijk worden uitgevoerd.

Voor BroadCloud Carrier

Het terugzetproces voor BroadCloud-partners verloopt als volgt:

1. Open een ticket bij Cisco TAC om een verzoek tot terugzetten van het apparaat in te dienen.
2. Voer het hulpmiddel voor het verplaatsen van het apparaat uit in de herstelmodus:
   • Telefoonnummers worden niet meer toegewezen aan Webex Calling, waardoor gebruikers en services alleen nog maar toestellen hebben.
   • E-mailadressen in Webex Calling worden teruggezet naar tijdelijke e-mailadressen.
   • Telefoons worden uit Webex Calling verwijderd.
   • Telefoonnummers, e-mailadressen die als alternatieve ID's worden gebruikt en telefoonnummers worden opnieuw aangemaakt in BroadCloud.
   • Telefoons worden opnieuw opgestart.
3. Partnerbeheerders moeten PSTN-telefoonnummers terugzetten naar BroadCloud Carrier.

Voor Cisco BroadWorks en Webex voor BroadWorks

Het terugzetproces voor Cisco BroadWorks en Webex voor BroadWorks verloopt als volgt:

1. Open een ticket bij Cisco TAC om een verzoek tot terugzetten van het apparaat in te dienen.
2. Voer het hulpmiddel voor het verplaatsen van apparaten uit in de herstelmodus op de secundaire BroadWorks Application Server om de apparaatmigraties terug te draaien. Hiermee wordt de DMS-URL weer ingesteld op de DMS-URL van de serviceprovider voor apparaatprofielen in Cisco BroadWorks en worden telefoonnummers opnieuw geactiveerd.
3. Het Webex Calling-team stelt de DMS-URL terug naar de DMS-URL van de serviceprovider in apparaatprofielen in Webex Calling.
4. Partnerbeheerders moeten de telefoonnummers in Webex Calling deactiveren of verwijderen via de Control Hub-portal.
5. Partnerbeheerders moeten PSTN-telefoonnummers terugzetten naar Cisco BroadWorks.

Instructies voor het uitvoeren van de tool voor het verplaatsen van apparaten in de herstelmodus

Volg de onderstaande stappen om het hulpmiddel voor het verplaatsen van apparaten in de herstelmodus uit te voeren:

Voer de onderstaande opdracht uit in de secundaire Cisco BroadWorks Application Server in de map Device Move Tool:

Profielen terugzetten

./devicemove.sh -input=  -revertProfiles

Nummers terugdraaien

./devicemove.sh -input=  -revertNumbers

Terminallogboeken

Bij een succesvolle uitvoering van de tool voor het verplaatsen van apparaten voor het terugdraaien van de bewerking, krijgen we de volgende logs in de terminal:

Profielen terugzetten

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

Nummers terugdraaien

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