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

De laatste kolom biedt de toewijzing van telefoonmodellen aan de kolom 'Apparaattype' van het bestand transform-tool/input/newphones.csv. (Zie het gedeelte Transformeer 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 de migratiehulpprogramma's starten. Deze tool wordt uitgevoerd als eenmalige activiteit nadat het partneraccount is geïntegreerd in de Wholesale RTM-oplossing. Met dit hulpprogramma kunnen partnerbeheerders zich via de webbrowser aanmelden om het unieke TOKEN op te halen dat nodig is om bij te werken naar de partnerconfiguratiebestanden voor de migratiehulpprogramma's.

Voorwaarden

Installeer Java 8, 11, 17 of 21 op de computer. Java is verkrijgbaar in vele bronnen, waaronder:

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

Pak na het downloaden de binaire bestanden van het migratieprogramma uit.

Uit te voeren instructies

Voer de volgende opdracht uit in de terminal in de directory 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 referenties van de partnerbeheerder om het TOKEN op te halen en kopieer het voor verder gebruik.

Hieronder vindt u ter referentie de illustraties van de gebruikersinterface:

Afbeelding 3: Inloggen met Cisco Webex

Afbeelding 4: Venster Aanmeldgegevens

Afbeelding 5: Tokengeneratie

Configureer de volgende stappen voordat u de hulpprogramma's Extraheren en Apparaat verplaatsen in de secundaire BroadWorks-server uitvoert.

OCI-P-verbinding inschakelen

Het hulpmiddel voor het verplaatsen van apparaten communiceert met de BroadWorks via OCI-P-opdrachten. Gebruik de onderstaande stappen om OCI-P-connectiviteit in te schakelen:

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

Voer de volgende opdracht uit in CLI om te wijzigen naar de directory Algemene instellingen:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

Wijzig de map naar OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Voer de volgende CLI uit om de huidige instellingen op te halen. U ziet het volgende:

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 de bovenstaande, gebruikt u de opdracht instellen om uw instellingen opnieuw te configureren.

Stap 3: Gebruik de CLI om OCI-inrichting te configureren.

Wijzig naar de inrichtingsdirectory:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Voer de volgende opdracht uit om de huidige OCI-inrichtingsinstellingen 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 verifiëren of uw configuratie juist 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.

Controleren of open clientserver is geïmplementeerd en actief is

Gebruik de onderstaande opdrachten om de open clientserver te implementeren en te starten op de secundaire toepassingsserver als deze 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

Nummeractivering inschakelen

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

Stap 1: Voer de opdracht voor nummeractiviteit uit:

AS_CLI> cd SubscriberMgmt/NumberActivation

Stap 2: Voer de opdracht Activering ingeschakeld uit:

AS_CLI> set dnMode groupAndUserActivationEnabled

Stap 3: Voer bij de bevestigingsprompt J in.

Voor BroadCloud

De extract-tool is geïntegreerd in de BroadCloud serviceproviderportal. Een serviceproviderbeheerder kan:

1. Verzend extractieaanvragen voor maximaal 50 klanten per aanvraag.
   Het extraheren-verzoek kan niet meer dan 10 keer per dag worden verzonden voor dezelfde klant.
2. Download het geëxtraheerde gegevensbestand, in ZIP-indeling, gedurende maximaal 28 dagen vanaf de datum van indiening van de aanvraag.

De onderstaande figuren geven de serviceproviderportal weer.

Afbeelding 6: Serviceproviderportal

Afbeelding 7: Serviceproviderportal

Voor Cisco BroadWorks en Webex voor BroadWorks

1. Het hulpprogramma Extraheren wordt uitgevoerd op de secundaire Cisco BroadWorks-toepassingsserver in het partnernetwerk en maakt verbinding via OCI-P.
2. Het hulpprogramma haalt onbewerkte bedrijfs-, groep-, nummers, gebruikers, services, apparaten en softclientgegevens op van het Cisco BroadWorks- of BroadCloud-platform en voert deze gegevens uit in XML-bestanden die de invoer voor het transformatiehulpprogramma leveren.

In de volgende secties wordt uitgelegd hoe u het hulpprogramma Uitpakken kunt installeren en configureren.

Voorwaarden

1. Hiermee kunt u de binaire hulpmiddelen extraheren naar de secundaire Cisco BroadWorks Application Server.
2. SSH met de secundaire Cisco BroadWorks-toepassingsserver om de vereisten te configureren en het hulpprogramma Extract uit te voeren.
3. Configureer de serviceprovider en groeps-id om uit Cisco BroadWorks te extraheren in conf/exportTool.yml. Raadpleeg het onderstaande voorbeeld-YAML-fragment:

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

4. Zorg ervoor dat de gebruikers-id, het wachtwoord en de hostnaam van de secundaire Cisco BroadWorks-toepassingsserver juist zijn in het bestand conf/partner.cfg:

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

   De REFRESH_TOKEN eigenschap is verplicht voor een migratie van Webex for BroadWorks.

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

   JAVA_HOME=/usr/local/java/java_base

Uit te voeren instructies

Voer de onderstaande opdracht uit in de secundaire Cisco BroadWorks-toepassingsserver uit de map met het uitpakken van hulpprogramma's:

./export.sh

Terminallogboeken

De volgende logboeken zijn beschikbaar in de terminal bij succesvol exporteren: BroadSoft Data-exporttool wordt uitgevoerd:

 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 output-ZIP-bestand (extracted_data_<timestamp>.zip) is beschikbaar in dezelfde map met uitpakken-hulpprogramma's. Gebruik de onderstaande opdracht om het ZIP-bestand weer te geven en te gebruiken voor de invoer van het transformatiehulpprogramma:

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 wordt op elke computer uitgevoerd, inclusief de laptop van de beheerder van een partner en gebruikt de openbare API's van Webex. Het leest het ZIP-bestand (extracted_data_<timestamp>.zip) uit de uitpakken-tool als een invoer en transformeert de onbewerkte XML in een JSON-indeling die wordt gebruikt door de inrichtingstool.

Voorwaarden

Configureer de volgende vereisten na het downloaden en uitpakken van de migratiehulpmiddelen-binaire bestanden:

1. Stel het VERNIEUWINGSTOKEN_ (Token gekopieerd uit het hulpprogramma Tokengenerator) en de NAAM_VAN DE_HOOFDLOCATIE_in het bestand conf/partner.cfg in:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. U kunt desgewenst de inrichtings-_ID (gekopieerd uit de sjabloon in Partnerhub) instellen in het bestand conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Als u een volledigere verificatie van het e-mailadres van de klant wilt krijgen, kunt u optioneel de inrichtings-_ID instellen.
3. Configureer ontbrekende informatie in het bestand input/customers.csv (zie volgende gedeelte) als deze informatie ontbreekt.
4. Voeg het e-mailadres van de eindgebruiker toe in het bestand input/users.csv.
5. Als er nieuwe telefoons moeten worden ingericht, voegt u het mac-adres en het e-mailadres van de nieuwe telefoon van de gebruiker toe aan het bestand input/newphones.csv. Dit is alleen vereist als de partnerbeheerders nieuwe telefoons willen inrichten voor groothandelgesprekken.
6. Converteer de BroadWorks-callcenters naar de CxEssentials met het bestand input/cxessentials.csv.
7. U kunt ook de eigenschap UPGRADE_ALLE_CALL_CENTERS_NAAR_CX_ESSENTIALS inschakelen om alle Call Centers te converteren naar CxEssentials.
8. Gebruik het bestand input/locations.csv om de grote bedrijfsmigratie te ondersteunen waarmee beheerders de locaties van hun klant kunnen migreren per locatie
9. Schakel het gebruik van MAC-adressen optioneel in via de koptekst User-Agent van het SIP REGISTER-bericht wanneer het MAC-adres niet beschikbaar is in het Cisco BroadWorks-apparaatprofiel. Verwijder de regel "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" uit het bestand conf/partner.cfg
10. Met de synchronisatiefunctie van de netwerkserver kunnen beheerders telefoonnummers, MAC-adressen en e-mailadressen van gebruikers inrichten tijdens de inrichting in dezelfde regionale migratie. Als u dit wilt inschakelen, stelt u USE_NS_SYNC=yes in conf/partner.cfg in.

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

De invoer/customers.csv invullen

De bestandsinvoer/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 gegevens zijn verplicht.

In de onderstaande tabel worden de belangrijkste kolommen in input/customers.csv uitgelegd.

Uit te voeren instructies

Voer de Transform Tool uit in een besturingssysteem. Gebruik de onderstaande stappen om het hulpprogramma 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 het transformatiehulpprogramma op macOS uit te voeren:

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

Controle vooraf door klant/gebruiker

De Transform Tool maakt API-gesprekken naar Webex om mogelijke inrichtingsproblemen op te vangen. Standaard worden het adres en het primaire e-mailadres van de klant gevalideerd. Als de waarde van de INRICHTINGS_ID is opgegeven in het bestand conf/partner.cfg, wordt ook de locatiegegevens gevalideerd. De resultaten van de voorafgaande controles zijn opgenomen in het uitzonderingsrapport.

Bovendien kunnen de volgende optionele parameters worden toegevoegd bij het uitvoeren van het transformatiehulpprogramma:

vooraf controleren

Naast het uitvoeren van de precheck-API voor de klantgegevens, zal de Transform Tool ook de precheck-API voor de abonnee-e-mails uitvoeren.

pre fo

Standaard worden alleen fouten met voorafgaande controles (d.w.z. problemen die inrichting blokkeren) opgenomen in het uitzonderingsrapport. Als u deze vlag toevoegt, worden ook de resultaten van geslaagde voorafgaande controles weergegeven (bijvoorbeeld als er al een Webex-organisatie bestaat die automatisch kan worden toegevoegd).

Terminallogboeken

De volgende logboeken in de terminal 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

De transformatietool genereert het uitzonderingsrapport in de map output/<timestamp>/exception_report.txt . U kunt dit rapport gebruiken om de problemen te identificeren die van invloed zijn op de migratie en deze op te lossen in het Cisco BroadWorks-systeem.

Nadat u de gebruikersgegevens hebt gewijzigd om de uitzondering op te lossen, voert u de hulpprogramma's Uitpakken en Transformeren opnieuw uit met de nieuwe gegevens. Het voorbeeldbestand met een uitzonderingsrapport als volgt:

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 (klant.json) is beschikbaar in de map uitvoer/<timestamp>/<groupid> . Het voorbeeld van het bestand customer.json is als volgt:

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

Het inrichtingstool kan op elke computer worden uitgevoerd, doorgaans de (laptop van de partnerbeheerder) en gebruikt de openbare API's van Webex. Het leest het bestand JSON-uitvoer (customer.json) van de transformatietool als een invoer en inrichting van de klanten, locaties, nummers, gebruikers, services en apparaten in de Webex Wholesale RTM-oplossing.

Voorwaarden

Configureer de volgende vereisten in de directory van de inrichtingstool:

1. Installeer Java 8, 11, 17 of 21 op de computer. Java is verkrijgbaar in vele 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. Stel na het downloaden en uitpakken van de binaire bestanden van de migratietools de JAVA_HOME-omgevingsvariabele in op provisioning_tool.sh voor MAC en provisioning_tool.bat voor Windows.
3. Het bestand partner.cfg:
   • Stel de WHOLESALE_PROVISIONING_-id en het VERNIEUWINGSTOKEN_ in (Token gekopieerd uit het hulpprogramma Tokengenerator). De partnerbeheerders moeten contact opnemen met het accountteam om de inrichtings-id_op te halen:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Stel E-MAILS _BEHEERDERS_UITNODIGINGEN_ TOESTAAN in op onwaar als de partner geen e-mail met welkomstboodschap naar de gebruikers wil verzenden. De standaardwaarde is Waar.

4. Gebruik de WEBEX4BWKS_E-MAIL_ONDERWERP-eigenschap voor Webex for BroadWorks-migraties om de e-mailonderwerp voor de aanvraag voor het wijzigen van het wachtwoord voor Webex for BroadWorks-abonnees te verzenden.
5. Gebruik de WEBEX4BWKS_EMAIL_BODY-eigenschap voor Webex for BroadWorks-migraties om de e-mailtekst voor de aanvraag voor het wijzigen van het wachtwoord voor Webex voor BroadWorks-abonnees te verzenden.
6. Met de synchronisatiefunctie van de netwerkserver kunnen beheerders telefoonnummers, MAC-adressen en e-mailadressen van gebruikers inrichten tijdens de inrichting in dezelfde regionale migratie. Als u dit wilt inschakelen, stelt u USE_NS_SYNC=yes in conf/partner.cfg in.

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

Voor BroadCloud-migraties in dezelfde regio:

1. De tool slaat de nummers, apparaten en het inrichten van gedeelde gesprekken over.
2. De tool maakt gebruikers en virtuele gebruikers met een toestel en een tijdelijk toestel.

Voor BroadCloud-migraties naar een andere regio:

1. Het hulpprogramma richt nummers, apparaten en weergaven van gedeelde gesprekken in.
2. Het hulpprogramma maakt gebruikers en virtuele gebruikers met de werkelijke telefoonnummers en toestellen.
   Alle Europe BroadCloud-migraties zijn naar een andere regio.

Uit te voeren instructies

Voer de volgende stappen uit om het hulpprogramma in Windows en macOS uit te voeren:

Windows

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

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

macOS

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

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

Vereisten voor migratie van Webex for BroadWorks

Partnerbeheerders moeten hun BroadWorks-introductiesjabloon voor Webex voor BroadWorks-co-existentiefuncties bijwerken. Raadpleeg de volgende afbeelding:

Zodra de sjabloon voor Webex voor BroadWorks-onboarding is bijgewerkt om de migratie te ondersteunen, vraagt u het Cisco Account Team om de functieschakelaar 'wholesale-partner-blending-enabled' in te schakelen op partnerniveau. Hiermee kunnen tijdens het inrichten pakketten voor groothandels worden toegevoegd aan bestaande Webex for BroadWorks-klantorganisaties.

Voer de inrichtingstool uit met een extra argument.

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

Onderhoudsfase: is de tweede fase waarin beheerders de groothandellicentie kunnen toewijzen aan de bestaande Webex for BroadWorks-gebruikers. U moet de inrichtingstool uitvoeren met een argument onderhoud.

Na de migratiefase: Is de laatste fase waarin beheerders de BroadWorks volledig kunnen converteren naar Groothandel. U moet de inrichtingstool uitvoeren met een argument postmigratie.

Terminallogboeken

Hieronder vindt u 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 gemaakte locaties voor elke run:

Output

De inrichtingstool genereert slaagings- en foutenrapporten in de output/<external_id>/*.success/error -bestanden. Controleer de uitvoersuccessen en foutlogboeken om de inrichting te verifiëren.

Partnerbeheerders kunnen de inrichting van de klant verifiëren in de Partner Hub en de Control Hub-portal. Raadpleeg de volgende illustraties van de Partnerhub en de Control Hub-portal:

Afbeelding 8: Partnerhub

Afbeelding 9: Control Hub

Afbeelding 10: Apparaten​

Afbeelding 11: Calling​

Voor BroadCloud

Gebruik voor BroadCloud-partners de serviceproviderportal om een migratieverzoek voor nummers, apparaten en SCA-migraties in te dienen.

In de serviceproviderportal kan een migratieverzoek maximaal 50 klanten bevatten. Er kunnen maximaal 10 aanvragen binnen een dag worden ingediend.

Met de functie Netwerkserver synchroniseren kunnen beheerders de broadCloud-locatie deactiveren en de Webex Calling-locatie activeren bij het instellen van de USE_NS_SYNC=yes 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 het conf/partner.cfg bestand in te stellen waarmee apparaten na de migratie terug naar BroadCloud worden verplaatst. Het ondersteunt migraties van dezelfde en andere regio's met NS Sync, maar alleen voor geslaagde migraties. Voor mislukte gevallen moeten beheerders een Cisco TAC verhogen voordat ze de terugdraaien aanvragen.

De onderstaande figuren geven de serviceproviderportal weer.

Afbeelding 12: Serviceproviderportal

Afbeelding 13: Serviceproviderportal

Voor Cisco BroadWorks en Webex voor BroadWorks

Voor migraties van Cisco BroadWorks en Webex voor BroadWorks wordt het hulpprogramma uitgevoerd op de secundaire Cisco BroadWorks-toepassingsserver in het partnernetwerk en maakt het via OCI-P verbinding met de AS. Het gebruikt het bestand JSON-uitvoer (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. Maak de registratie van apparaten bij Cisco BroadWorks ongedaan en registreer deze in Groothandel.
2. Gebruikers die de UC-One-client gebruiken, worden omgeleid naar de Webex-app bij de eerste aanmelding.
3. Deactiveer de telefoonnummers van Cisco BroadWorks of verwijder de telefoonnummers uit BroadCloud.
4. Nummers activeren in groothandel.
5. Weergave van gedeelde gesprekken in Groothandel maken voor BroadCloud-migraties. [Deze stap is alleen van toepassing op BroadCloud-migraties].

SCP en SSH

1. Hiermee verplaatst u het apparaat naar de secundaire Cisco BroadWorks-toepassingsserver.
2. SSH met de secundaire Cisco BroadWorks-toepassingsserver om de vereisten te configureren en de apparaatverplaatsingstool uit te voeren.

Voorwaarden

1. Stel het VERNIEUWINGSTOKEN_ (Token gekopieerd uit het hulpprogramma Tokengenerator) in het bestand conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Zorg ervoor dat de secundaire gebruikers-id, het wachtwoord en de hostnaam van de Cisco BroadWorks-toepassingsserver juist zijn in het bestand conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Als u activeringse-mails opnieuw wilt verzenden, moet u RESEND_INVITATION_EMAILS=true instellen in het bestand conf/partner.cfg.

   Als beheerders uitnodigingsmails naar hun gebruikers willen verzenden tijdens de migratie, moeten ze de eigenschap 'RESEND_INVITATION_EMAILS=true' uit het bestand conf/partner.cfg verwijderen. Anders moet het onroerend goed ongewijzigd blijven.

4. Controleer of het JDK/JRE-omgevingspad correct is in devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Polycom-telefoons

Als u Polycom-telefoons van Cisco BroadWorks naar Groothandelgesprekken wilt verplaatsen, moet een partnerbeheerder een nieuw bestand met het type identiteit/apparaatprofiel maken op systeemniveau in Cisco BroadWorks in elke Polycom-apparaatsjabloon. Raadpleeg afbeelding 14 en upload het aangepaste bestand device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Na het uploaden van het nieuwe apparaatbestand, controleert u of het nieuwe bestand bestaat op groepsniveau. Zorg er ook voor dat file migration_%BWMAC ADDRESS%.cfg niet conflicteert met een bestaand bestand in uw systeem).

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

Het migratieproces voor Polycom-telefoons:

1. De verplaatsingstool voor apparaten vervangt het bestand %BWMACADDRESS%.cfg op apparaatniveau door polycom_vvx2.cfg. Dit bestand verwijst naar migration_%BWMACADDRESS%.cfg.
2. Bouw de apparaatprofielen opnieuw op groepsniveau of apparaatniveau.
   Actie op groepsniveau of apparaatniveau is afhankelijk van de configuratie van de parameter deviceLevelRebuild in het bestand device-move-tool/conf/partner.cfg.
3. De tool voor het verplaatsen van apparaten vraagt de Cisco BroadWorks-toepassingsserver om de telefoons opnieuw op te starten op groepsniveau of op apparaatniveau.
4. Na de aanvraag voor opnieuw opstarten downloaden en verwerken Polycom-telefoons% BWMACADDRESS%.cfg. Hierdoor worden de Polycom-telefoons gevraagd migration_%BWMACADDRESS%.cfg te downloaden en verwerken. Hierdoor wordt de device.prov.serverName 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 het Webex Calling DMS.

Afbeelding 14: Voeg het bestand met het type identiteit/apparaatprofiel toe

Uit te voeren instructies

Er zijn twee methoden om de DMT aan te roepen: de eerste is via één klant tegelijk oproepen en de andere door meerdere klanten tegelijk.

Het verplaatsingstool voor apparaten wordt uitgevoerd vanaf de secundaire Cisco BroadWorks-toepassingsserver in de map voor het verplaatsingstool voor 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 wanneer het verplaatsingshulpprogramma voor apparaatmigratie is uitgevoerd:

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 om te bellen/gebeld te worden. Zie afbeelding 15 voor een voorbeeld van de apparaatstatus:

Afbeelding 15: Apparaatstatus

Na de apparaatmigratie zijn nummers actief geworden. Zie afbeelding 16 om een voorbeeld te zien van welke nummers actief zijn:

Afbeelding 16: Actieve nummers

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

Voor BroadCloud-provider

Het terugzetproces voor BroadCloud-partners is als volgt:

1. Open een ticket bij Cisco TAC om een apparaat terug te laten keren.
2. Voer het verplaatsingstool van het apparaat uit in de terugbelmodus:
   • De toewijzing van telefoonnummers aan Webex Calling wordt ongedaan gemaakt, waardoor gebruikers en services alleen met toestellen worden overgelaten.
   • E-mailadressen in Webex Calling worden teruggezet naar tijdelijke e-mailadressen.
   • Telefoons worden verwijderd uit Webex Calling.
   • Telefoonnummers, e-mailadressen die als alternatedId's worden gebruikt en telefoons worden opnieuw gemaakt in BroadCloud.
   • Telefoons worden opnieuw gestart.
3. Partnerbeheerders moeten PSTN-telefoonnummers weer verplaatsen naar de BroadCloud-provider.

Voor Cisco BroadWorks en Webex voor BroadWorks

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

1. Open een ticket bij Cisco TAC om een apparaat terug te laten keren.
2. Voer het verplaatsingstool voor apparaten uit in de terugzetmodus op de secundaire BroadWorks-toepassingsserver 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 in 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 weer verplaatsen naar Cisco BroadWorks.

Instructies om het verplaatsingshulpprogramma uit te voeren in de terugvalmodus

Volg de onderstaande stappen om het verplaatsingstool van het apparaat in de terugschakelmodus uit te voeren:

Voer de onderstaande opdracht uit in de secundaire Cisco BroadWorks-toepassingsserver in de map voor apparaatverplaatsingstools:

Profielen terugzetten

./devicemove.sh -input=  -revertProfiles

Nummers terugzetten

./devicemove.sh -input=  -revertNumbers

Terminallogboeken

We ontvangen de volgende logboeken in de terminal als de apparaatverplaatsingstool is uitgevoerd voor de terugzetbewerking:

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 terugzetten

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