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

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

Partnerbeheerders moeten deze tool voor het genereren van tokens minstens één keer uitvoeren voordat ze migratietools gaan gebruiken. Het uitvoeren van deze tool is een eenmalige handeling 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 via diverse bronnen verkrijgbaar, 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, pak je de binaire bestanden van de migratietool uit.

Instructies voor het uitvoeren

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, log in met de inloggegevens van de partnerbeheerder om het TOKEN te verkrijgen en kopieer dit voor verder gebruik.

Hieronder vindt u illustraties van de gebruikersinterface ter referentie:

Afbeelding 3: Inloggen met Cisco Webex

Afbeelding 4: Inloggegevensvenster

Afbeelding 5: Tokengeneratie

Configureer de volgende stappen voordat u de extractie- en apparaatverplaatsingstools uitvoert op de secundaire BroadWorks-server.

Schakel OCI-P-connectiviteit in.

De tool voor het verplaatsen van apparaten communiceert met BroadWorks via OCI-P-opdrachten. Volg de onderstaande stappen om OCI-P-connectiviteit in te schakelen:

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Voer de volgende opdracht uit in de 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 bovenstaande, gebruik dan 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-opdracht uit om de huidige instellingen te bekijken. 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 bovenstaande, gebruik dan 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-provisioneringsinstellingen 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 de 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 Client Server is geïmplementeerd en actief is.

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

Stap 1: Implementeer de server met het volgende CLI-commando:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Stap 2: Start de server met dit commando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Nummers activeren inschakelen

Voer de volgende opdrachten in de CLI uit om de nummers te activeren:

Stap 1: Voer het activeringscommando voor het nummer uit:

AS_CLI> cd SubscriberMgmt/NumberActivation

Stap 2: Voer het commando 'activatie ingeschakeld' uit:

AS_CLI> set dnMode groupAndUserActivationEnabled

Stap 3: Voer bij de bevestigingsprompt Y in.

Voor BroadCloud

De extractietool is geïntegreerd in het BroadCloud Service Provider-portaal. Een serviceproviderbeheerder kan:

1. U kunt extractverzoeken indienen voor maximaal 50 klanten per verzoek.
   Een extractieverzoek kan voor dezelfde klant niet meer dan 10 keer per dag worden ingediend.
2. Download het uitgepakte gegevensbestand in ZIP-formaat gedurende maximaal 28 dagen vanaf de datum van indiening van het verzoek.

De volgende afbeeldingen tonen het serviceproviderportaal.

Afbeelding 6: Portaal voor dienstverleners

Afbeelding 7: Portaal voor dienstverleners

CSV-extractieverzoek

Start een CSV-extractieverzoek

1. Download het CSV-bestand met de klantgegevens

   Klik op de link Klant-CSV downloaden rechtsboven in het gedeelte CSV-extractieverzoek starten.

2. Bewerk de klantenlijst

   De beheerder kan dit CSV-bestand bewerken om alleen de klanten op te nemen voor wie de extractie moet worden uitgevoerd.

3. Uploaden en indienen

   Upload na het bewerken het aangepaste CSV-bestand.

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

Start een extractieverzoek voor een klant met locatiegegevens in een CSV-bestand.

1. Selecteer klant- en downloadlocaties

   Selecteer een klant uit het keuzemenu.

   Download het bijbehorende locations.csv via Klanten bekijken→ Tabblad Locaties → Locaties exporteren als CSV.

2. Bewerk het locatiebestand.

   De beheerder kan het CSV-bestand bewerken om alleen de locaties op te nemen die hij of zij wil extraheren.

3. Uploaden en indienen

   Upload het bewerkte locations.csv-bestand en klik op Verzenden.

   Alleen de door de geselecteerde klant opgegeven locaties worden in het extractverzoek opgenomen.

Start een extractieverzoek voor alle klanten.

1. Klik op Verzenden om een extractverzoek 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 ruwe bedrijfs-, groeps-, nummer-, gebruikers-, service-, apparaat- en softclientgegevens op van het Cisco BroadWorks- of BroadCloud-platform en zet deze gegevens om naar XML-bestanden die als invoer dienen voor de transformatietool.

In de volgende paragrafen wordt uitgelegd hoe u de extractietool installeert en configureert.

Voorwaarden

1. Kopieer de binaire bestanden van de extractietool via SCP 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 extractietool uit te voeren.
3. Configureer de serviceprovider en groeps-ID om gegevens uit Cisco BroadWorks te extraheren in de conf/exportTool.yml. Raadpleeg het volgende YAML-voorbeeldfragment:

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

4. Zorg ervoor dat de secundaire gebruikers-ID, het wachtwoord en de hostnaam van de Cisco BroadWorks-applicatieserver correct zijn. 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 Het omgevingspad in het export.sh-bestand als de secundaire Cisco BroadWorks Application Server JDK/JRE Het omgevingspad is anders dan het bestand:

   JAVA_HOME=/usr/local/java/java_base

Instructies voor het uitvoeren

Voer de volgende opdracht uit op de secundaire Cisco BroadWorks Application Server vanuit de map van het extractieprogramma:

./export.sh

Terminallogboeken

De volgende logberichten zijn beschikbaar in de terminal na een succesvolle export: Het uitvoeren van de BroadSoft-gegevensexporttool:

 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 uitvoer-ZIP-bestand (extracted_data_<timestamp>.zip) is beschikbaar in dezelfde map als waar het extractieprogramma is uitgevoerd. Gebruik de volgende opdracht om het ZIP-bestand voor de invoer van de Transform Tool te bekijken en te gebruiken:

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 voor alle migraties uitgevoerd. De transformatietool werkt op elke computer, inclusief de beheerderslaptop van een partner, en maakt gebruik van de openbare Webex API's. Het leest het uitvoerbestand (ZIP-bestandextracted_data_<timestamp>.zip) van de extractietool als invoer en zet de ruwe XML om in een JSON-formaat dat door de provisioningtool wordt gebruikt.

Voorwaarden

Na het downloaden en uitpakken van de binaire bestanden van de migratietools, configureert u de volgende vereisten:

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Stel optioneel de PROVISIONING_ID (gekopieerd uit de sjabloon in Partner Hub) in. conf/partner.cfg bestand:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Om het e-mailadres van de klant vollediger te verifiëren, kunt u optioneel de PROVISIONING_ID instellen.
3. Configureer ontbrekende informatie in de input/customers.csv bestand (zie volgende sectie) indien ontbreekt.
4. Voeg het e-mailadres van de eindgebruiker toe aan de input/users.csv bestand.
5. Als er nieuwe telefoons geconfigureerd moeten worden, voeg dan het MAC-adres en het e-mailadres van de nieuwe telefoon van de gebruiker toe aan input/newphones.csv bestand. Dit is alleen nodig als de partnerbeheerders nieuwe telefoons willen configureren voor groothandelgesprekken.
6. Converteer de BroadWorks-callcenters naar CxEssentials met behulp van de input/cxessentials.csv bestand.
7. U kunt desgewenst de eigenschap UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS inschakelen om alle callcenters naar CxEssentials te converteren.
8. Gebruik de input/locations.csv bestand ter ondersteuning van de grootschalige bedrijfsmigratie waarmee beheerders de locaties van hun klanten locatie voor locatie kunnen migreren
9. Schakel optioneel het gebruik van MAC-adressen uit de User-Agent-header van het SIP REGISTER-bericht in wanneer het MAC-adres niet beschikbaar is in het Cisco BroadWorks-apparaatprofiel. Verwijder het commentaarteken voor de regel USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes in bestand conf/partner.cfg
10. Schakel optioneel de eigenschappen ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD en ANALOG_USER_TYPE_DISABLE_T38 in om de instellingen voor oproepwacht, muziek in de wacht en het uitschakelen van T38 voor alle analoge gebruikers te configureren.

11. Als u generieke gateway-apparaten wilt instellen, voegt u het MAC-adres en de gebruikers-ID van het apparaat toe aan de input/genericgateways.csv bestand. Vermeld ook of de gebruiker de primaire eigenaar is of een gedeelde gebruiker (voor gedeelde gespreksweergaven). Dit is alleen nodig als partnerbeheerders van plan zijn om generieke gateway-apparaten te gebruiken in Wholesale Calling.

    Deze functie is niet beschikbaar voor migraties van BroadCloud naar Wholesale.

12. Voor BroadCloud-migraties, om alle gebruikers met het stationstype 'messaging' om te zetten naar voice_mail_group, moet u het bestand conf/rialto_station_type_to_wholesale_package.csv bijwerken door de waarde van Wholesale Package te vervangen door voice_mail_group voor de rij waar het Rialto Station Type 'messaging' is.

    U kunt optioneel de eigenschap COMMON_VOICE_MAIL_GROUP_PASSCODE in partner.cfg inschakelen om de standaard-PIN voor voicemailgroepen te configureren.

    Als deze eigenschap niet is gespecificeerd in partner.cfg, moet deze per klant worden opgegeven in het bestand customers.csv onder de kolom commonVoicemailGroupPassCode.

13. Voor het migreren van gemeenschappelijke contactpersonen naar Webex Calling

    Het betreft een verbetering voor het beheren van gemeenschappelijke contactpersonen op bedrijfs- en vestigingsniveau. Deze contactpersonen kunnen nu, afhankelijk van de configuratie-instellingen, worden gemigreerd als organisatiecontactpersonen (Org Contacts) of als virtuele extensies. Hieronder vindt u de details om u door dit migratieproces te leiden.

    Sleutelconfiguratie:

    • GEMEENSCHAPPELIJK_TELEFOON_LIJST_NAAR_VIRTUELE_UITBREIDING_START_BEREIK

      Een nieuwe eigenschap, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, wordt geïntroduceerd in het partner.cfg-bestand. Deze eigenschap bepaalt hoe vaak contactpersonen van Rialto naar Webex Calling worden gemigreerd.

    • Zonder COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE geconfigureerd

      Algemene contactpersonen worden gemigreerd als organisatiecontactpersonen (Org Contacts).

      Er is geen aanvullende configuratie nodig.

      Contactpersonen blijven op organisatieniveau bereikbaar.

    • Met COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE geconfigureerd

      Gemeenschappelijke contactpersonen worden gemigreerd als virtuele extensies.

      Aan elk contact wordt een toestelnummer toegevoegd en het beginbereik van het toestelnummer wordt gedefinieerd in de eigenschap COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE in partner.cfg.

      Virtuele extensies worden ondersteund op zowel organisatieniveau als locatieniveau, afhankelijk van de omvang van het contact.

14. Stel Webex in als standaardleverancier voor gespreksopnames.

    Deze stap is alleen nodig bij het migreren van instellingen voor gespreksopname voor gebruikers die geconfigureerd zijn met Dubber naar Cisco Native Call Recording in Webex.

    Om deze optie in te scha kelen:

    • Stel in het bestand partner.cfg de volgende eigenschap in: DEFAULT_CALL_RECORDING_VENDOR=Webex.
    • Gebruik bovendien de eigenschap WEBEX_CALL_RECORDING_STORAGE_REGION om het opslaggebied te configureren.

      De On Demand opnameoptie van BroadCloud wordt niet ondersteund in Webex Calling. Deze instellingen voor gespreksopname worden niet overgezet en verschijnen in het uitzonderingsrapport.

15. Uitsluiting van bepaalde telefoonnummers van de migratie:

    Om specifieke telefoonnummers uit te sluiten van het migratieproces, moet de volgende procedure in twee stappen met behulp van de transformatietool worden gevolgd:

    • Voer de transformatietool eerst voor de eerste keer uit. Na voltooiing genereert de tool een bestand met de naam telephone_numbers_inventory.csv, dat zich bevindt in de map output/timestamp/ map. De klant dient dit bestand te controleren en "Ja" aan te vinken in de kolom "Tn's verwijderen" voor elk telefoonnummer dat moet worden uitgesloten van de aanstaande migratie.
    • Nadat het telephone_numbers_inventory.csv-bestand is bijgewerkt met de juiste uitsluitingsvlaggen, wordt de transformatietool een tweede keer uitgevoerd. Het bijgewerkte bestand moet als argument worden doorgegeven in het volgende formaat.

      ./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}

16. U kunt er ook voor kiezen om de eigenschap ALLOW_RESTRICT_BY_PARTNER_MODE op OFF te zetten, zodat klantbeheerders partner-gedefinieerde instellingen in Control Hub kunnen wijzigen.
17. Voor het migreren van mobiele nummers (BroadWorks Mobility) van BroadCloud naar Webex Calling

    In dit gedeelte wordt de migratie beschreven van de BroadWorks Mobility(mobiele nummers van klanten) functie van BroadCloud (Mobiele netwerkintegratie) naar Wholesale Webex Calling (Webex Go mobiele netwerkoperator).

    Voorwaarden- Voordat het migratieproces van start gaat, moeten partnerbeheerders contact opnemen met het Cisco-accountteam om de Cloud Connected PSTN (CCP)-leverancier en de Custom Carrier List (CCL) te configureren.

    Een nieuwe eigenschap, ASSIGN_MOBILE_NUMBERS_TO_USERS, wordt toegevoegd aan het partner.cfg bestand. Schakel deze eigenschap in om het toewijzen en migreren van mobiele nummers aan gebruikers mogelijk te maken.

    • Deze functie wordt alleen ondersteund voor BroadCloud-naar-Wholesale migraties.
    • Bij Wholesale Webex kunnen eindgebruikers, in tegenstelling tot BroadCloud, kiezen tussen een mobiel nummer of een vast telefoonnummer (niet beide).
    • Wanneer een mobiel nummer aan een gebruiker wordt toegewezen, wordt hun primaire PSTN-nummer hun secundaire (alternatieve) nummer.
    • Mobiele nummers kunnen niet worden overgezet voor gebruikers die worden omgezet naar Workspaces of Virtual Lines.
    • Nadat een mobiel nummer is toegewezen in Wholesale Webex, wordt het als 'Actief' weergegeven in Control Hub. Deze status betekent niet dat het nummer direct klaar is om oproepen te ontvangen. De belfunctie is pas beschikbaar nadat de migratie volledig is afgerond.
    • Instellingen voor mobiele telefoonintegratie die door eindgebruikers in het Calling User Portal (CUP) zijn geconfigureerd, worden niet gemigreerd. Na de migratie zullen alle apparaten van de gebruiker overgaan wanneer een telefoonnummer, mobiel nummer of toestelnummer wordt gebeld.

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 gelaten worden als alle verplichte informatie al beschikbaar is. Je hoeft niet alle kolommen in te vullen, alleen de ontbrekende gegevens zijn verplicht.

De onderstaande tabel legt de belangrijkste kolommen uit 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 gelaten worden als alle verplichte informatie al beschikbaar is. Je hoeft niet alle kolommen in te vullen, alleen de ontbrekende gegevens zijn verplicht.

Instructies voor het uitvoeren

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

Windows

Voer de onderstaande opdracht uit om de Transform Tool in Windows te starten:

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

macOS

Volg de onderstaande stappen om de transformatietool op macOS uit te voeren:

1. Maak een virtuele omgeving aan en installeer de benodigde afhankelijkheden om de transformatietool met Python uit te voeren:

   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 vooraf controleren

De Transform Tool maakt API-aanroepen naar Webex om potentiële provisioningproblemen op te sporen. Standaard worden het adres en het primaire e-mailadres van de klant gevalideerd. Als de PROVISIONING_ID-waarde is gespecificeerd in de conf/partner.cfg Het bestand zal ook de locatiegegevens valideren. De resultaten van de voorcontrole zijn opgenomen in het uitzonderingsrapport.

Daarnaast kunnen de volgende optionele parameters worden toegevoegd bij het uitvoeren van de transformatietool:

vooraf controleren

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

precheckinfo

Standaard worden alleen fouten die tijdens de voorcontrole optreden (d.w.z. problemen die de inbedrijfstelling blokkeren) opgenomen in het uitzonderingsrapport. Door deze vlag toe te voegen, worden ook succesvolle precheck-resultaten meegenomen (bijvoorbeeld als er al een Webex-organisatie bestaat die automatisch kan worden gekoppeld).

Terminallogboeken

De volgende berichten verschijnen in de terminal na 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 de migratie kunnen beïnvloeden en deze oplossen in het Cisco BroadWorks-systeem.

Nadat u de gebruikersgegevens hebt aangepast om de uitzondering op te lossen, voert u de Extract and Transform Tools 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 uitvoer-JSON-bestand (customer.json) zal beschikbaar zijn in de map 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 provisioningtool kan op elke machine worden uitgevoerd, meestal de (beheerderslaptop van de partner) en maakt gebruik van de openbare Webex API's. Het leest het JSON-uitvoerbestand van de transformatietool (customer.json) als invoer en voorziet de klanten, locaties, nummers, gebruikers, services en apparaten in de Webex Wholesale RTM-oplossing.

Voorwaarden

Configureer de volgende vereisten in de map van de provisioningtool:

1. Installeer Java 8, 11, 17 of 21 op de computer. Java is via diverse bronnen verkrijgbaar, waaronder:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Na het downloaden en uitpakken van de binaire bestanden van de migratietools, stelt u de omgevingsvariabele JAVA_HOME in via het provisioning_tool.sh-bestand voor Mac en het provisioning_tool.bat-bestand voor Windows.
3. Het partner.cfg-bestand:
   • Stel de WHOLESALE_PROVISIONING_ID en REFRESH_TOKEN in (Token gekopieerd van 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 SEND_SUBSCRIBERS_WELCOME_EMAIL in op false als partners geen welkomstmail naar de gebruikers willen sturen. De standaardwaarde is waar.

     Webex verstuurt alleen welkomstmails naar eindgebruikers. Klantbeheerders ontvangen geen welkomstmails.

     Gebruikers en klantbeheerders in de VS en Canada ontvangen een aparte e-mailmelding van RedSky. Het RedSky E911-platform verstuurt deze e-mail ter bevestiging van de aanmaak van het klantaccount voor de hulpdiensten. Deze RedSky-e-mail staat los van de welkomstmails van Webex en wordt niet beheerd door de e-mailinstellingen van Webex. Voor groothandelsorganisaties in de VS en Canada is RedSky automatisch ingeschakeld als aanbieder van noodhulpdiensten.

4. Gebruik de eigenschap WEBEX4BWKS_EMAIL_SUBJECT voor Webex for BroadWorks-migraties om het onderwerp van de e-mail met het verzoek tot wachtwoordwijziging naar Webex for BroadWorks-abonnees te verzenden.
5. Gebruik de eigenschap WEBEX4BWKS_EMAIL_BODY voor Webex for BroadWorks-migraties om de e-mailtekst voor het wachtwoordwijzigingsverzoek naar Webex for BroadWorks-abonnees te verzenden.
6. Gebruik de eigenschap CUSTOM_TAGS om tags toe te voegen na het aanmaken van een klant.
7. Om groothandelskortingen toe te passen, moeten partnerbeheerders contact opnemen met het Cisco-accountteam voordat ze met de migratie beginnen.

   Een nieuwe eigenschap, APPLY_WHOLESALE_DISCOUNTS, wordt toegevoegd aan partner.cfg. Schakel deze eigenschap in om kortingen toe te passen op gebruikers en werkplekken.

Instructies voor het uitvoeren

Volg de onderstaande stappen om de tool in Windows en macOS uit te voeren:

Windows

Volg de onderstaande stappen om de tool op Windows te gebruiken:

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

macOS

Volg de onderstaande stappen om de tool op macOS uit te voeren:

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

Voorwaarden voor Webex voor BroadWorks-migratie

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

Zodra de Webex for BroadWorks Onboarding-sjabloon is bijgewerkt om migratie te ondersteunen, verzoekt u het Cisco Account Team om de functie "wholesale-partner-blending-enabled" op partnerniveau in te schakelen. Hierdoor kunnen groothandelspakketten tijdens de configuratie worden toegevoegd aan bestaande Webex for BroadWorks-klantorganisaties.

Voer de provisioningtool uit met een extra argument.

Voorbereidingsfase: Dit is de standaardfase waarin beheerders de BroadWorks-gebruikers kunnen aanmaken als groothandelsabonnees en verder kunnen gaan met Webex voor BroadWorks-gebruikers.

Onderhoudsfase: Dit is de tweede fase waarin beheerders de groothandelslicentie kunnen toewijzen aan de bestaande Webex for BroadWorks-gebruikers. Je moet de provisioningtool uitvoeren met het argument maintenance.

Fase na de migratie: Dit is de laatste fase waarin beheerders BroadWorks volledig kunnen omzetten naar Wholesale. Je moet de provisioningtool uitvoeren met het argument postmigration.

Terminallogboeken

Hieronder volgen de logbestanden in de terminal na een succesvolle provisioning:

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** 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 logboeken met succes- en foutmeldingen om te verifiëren of de inbedrijfstelling succesvol is verlopen.

Het systeem genereert een Provisioning_Report_*.csv bestand in de output/consolidated_reports/ map. Dit bestand bevat zowel details over geslaagde als mislukte configuraties voor elke entiteit en de bijbehorende instellingen, en biedt daarmee een uitgebreid rapport over de configuratie.

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

Afbeelding 8: Partnerhub

Afbeelding 9: Control Hub

Afbeelding 10: Apparaten

Afbeelding 11: Oproepen

Beperkingen na levering

Zodra de provisioning voor een BroadCloud-migratie is voltooid, worden de volgende acties geblokkeerd. :

• CAP-portaal – Gebruikers of geporteerde apparaten toevoegen.
• SP-portaal – ADD-bestellingen aanmaken met apparaten of nummers.
• RSB API – Het aanmaken van ADD-orders met apparaten of nummers en het aanmaken van gebruikers. RSB ADD-bestellingen die met apparaten of nummers worden geplaatst, worden afgewezen.

Voor BroadCloud

BroadCloud-partners kunnen via het Service Provider-portaal een migratieverzoek indienen voor telefoonnummers, apparaten en Shared Call Appearances (SCA)-migraties.

Binnen het serviceproviderportaal kan een migratieverzoek maximaal 50 klanten omvatten. Er kunnen maximaal 10 aanvragen per dag worden ingediend.

Beheerders kunnen automatisch terugdraaien inschakelen door ROLLBACK_TO_BROADCLOUD=true in het conf/partner.cfg bestand in te stellen, waardoor apparaten na de migratie terug naar BroadCloud worden verplaatst. Het ondersteunt zowel migraties binnen als tussen regio's met NS Sync, maar alleen voor succesvolle migraties. Bij mislukte pogingen moeten beheerders een Cisco TAC-ticket aanmaken voordat ze een terugdraaiverzoek kunnen indienen.

In het portaal zijn twee opties beschikbaar voor het selecteren van het migratietype:

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

De volgende afbeeldingen tonen het serviceproviderportaal.

Afbeelding 12: Portaal voor dienstverleners

Afbeelding 13: Portaal voor dienstverleners

Geselecteerde locaties migreren (optioneel)

Om de migratie te starten voor een specifieke subset van locaties die in het customer.json bestand worden vermeld, voegt u een locations.csv bestand toe aan uw verzoek. Dit CSV-bestand mag alleen de locaties bevatten die u wilt migreren.

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

Afbeelding 14: Exporteer locaties als CSV-bestand.

Schakel de optie voor verbroken verbindingen in.

Wanneer u dezelfde SIP-trunk gebruikt voor Webex Calling en BroadCloud Carrier, moeten beheerders de optie Nummers verbreken gebruiken. Hierdoor worden telefoonnummers na de migratie naar BroadCloud geblokkeerd voor inkomende oproepen.

Om deze optie in te schakelen,

1. Stel in het bestand partner.cfg de volgende regel in: DISCONNECT_NUMBERS_FROM_RIALTO = Ja.
2. Voer de migratietool opnieuw uit met hetzelfde customer.json bestand en het bijgewerkte partner.cfg.

Als de verbinding niet tot stand komt, dien dan een Cisco TAC verzoek in.

Voor Cisco BroadWorks en Webex voor BroadWorks

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

Na een succesvolle uitvoering zal het verplaatsingsgereedschap het volgende doen:

1. Verwijder de apparaten uit Cisco BroadWorks en registreer ze in Wholesale.
2. Gebruikers die de UC-One-client gebruiken, worden bij de eerste aanmelding doorgestuurd naar de Webex-app.
3. Deactiveer de telefoonnummers in Cisco BroadWorks of verwijder de telefoonnummers uit BroadCloud.
4. Activeer nummers in de groothandel.
5. Maak gedeelde gespreksweergaven aan in Wholesale voor BroadCloud-migraties. [This Deze stap is alleen van toepassing op BroadCloud. migrations].

SCP en SSH

1. Kopieer het apparaatverplaatsingsprogramma via SCP naar de secundaire Cisco BroadWorks-applicatieserver.
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 gebruikers-ID, het wachtwoord en de hostnaam van de Cisco BroadWorks-applicatieserver correct zijn. conf/deviceMoveTool.conf bestand:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Om de activeringsmails opnieuw te verzenden, moet u SEND_SUBSCRIBERS_WELCOME_instellen. EMAIL=true in de conf/partner.cfg bestand.

   Als beheerders tijdens de migratie uitnodigingsmails naar hun gebruikers willen sturen, moeten ze de regel "SEND_SUBSCRIBERS_WELCOME_" deactiveren door het commentaarteken ervoor te verwijderen. EMAIL=true" eigendom in de conf/partner.cfg bestand. Anders moet het pand ongewijzigd blijven.

4. Controleer de JDK/JRE Het 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 binnen een onderneming.

Polycom-telefoons

Om Polycom-telefoons van Cisco BroadWorks naar Wholesale Calling te migreren, moet een partnerbeheerder een nieuwe klant aanmaken. Identity/Device Profieltypebestand op systeemniveau in Cisco BroadWorks elk Polycom-apparaatsjabloon. Raadpleeg afbeelding 14 en upload het aangepaste bestand . device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Controleer na het uploaden van het nieuwe apparaatbestand of het zojuist aangemaakte bestand op groepsniveau bestaat. Zorg er ook voor dat het bestand migration_%BWMAC ADDRESS%.cfg geen conflicten veroorzaakt met bestaande bestanden op uw systeem.

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

Het migratieproces voor Polycom-telefoons:

1. De tool voor het verplaatsen van apparaten vervangt het bestand %BWMACADDRESS%.cfg op apparaatniveau door polycom_vvx2.cfg. Dit bestand verwijst naar migration_%BWMACADDRESS%.cfg.
2. Herbouw de apparaatprofielen op groepsniveau of apparaatniveau.
   Of de actie op groepsniveau of apparaatniveau plaatsvindt, hangt af 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 Application Server om telefoons opnieuw op te starten op groepsniveau of apparaatniveau.
4. Na het herstartverzoek downloaden en verwerken Polycom-telefoons% BWMACADDRESS%.cfg, waarin de Polycom-telefoons worden gevraagd om 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 VS gelden andere URL's; andere regio's hebben andere URL's.
5. De Polycom-telefoon downloadt %BWMACADDRESS%.cfg van https://plcm.sipflash.com en wordt beheerd door het Webex Calling DMS.

Afbeelding 14: Identity/device profieltypebestand toevoegen

Instructies voor het uitvoeren

Er zijn twee manieren om de DMT aan te roepen: de eerste is via één klant tegelijk en de tweede is om de DMT gelijktijdig via meerdere klanten uit te voeren.

De tool voor het verplaatsen van apparaten wordt uitgevoerd vanaf de secundaire Cisco BroadWorks Application Server in de map 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 volgen de logbestanden in de terminal na een succesvolle uitvoering van de tool 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 en klaar voor gebruik. make/receive oproepen. Zie afbeelding 15 voor een voorbeeld van de apparaatstatus:

Afbeelding 15: Apparaatstatus

Na de apparaatmigratie zijn de nummers geactiveerd. Zie afbeelding 16 voor een voorbeeld van welke nummers actief zijn:

Afbeelding 16: Actieve nummers

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

Voor BroadCloud-provider

Beheerders kunnen ROLLBACK_TO_BROADCLOUD=true in conf/partner.cfg plaatsen om automatisch terugdraaien mogelijk te maken. Hiermee worden apparaten na een succesvolle migratie binnen dezelfde of een andere regio met NS Sync teruggezet naar BroadCloud. Neem bij mislukte migraties contact op met Cisco TAC voordat u een terugdraaiverzoek indient.

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 terugzetting van het apparaat aan te vragen.
2. Voer de tool voor het verplaatsen van apparaten uit in de terugdraaimodus op de secundaire BroadWorks-applicatieserver om de apparaatmigraties ongedaan te maken. Hierdoor wordt de DMS-URL voor apparaatprofielen in Cisco BroadWorks teruggezet naar de DMS-URL van de serviceprovider en worden telefoonnummers opnieuw geactiveerd.
3. Het Webex Calling-team stelt de DMS-URL in de apparaatprofielen van Webex Calling terug naar de DMS-URL van de serviceprovider.
4. Partnerbeheerders moeten de telefoonnummers in Webex Calling deactiveren of verwijderen via het Control Hub-portaal.
5. Partnerbeheerders moeten PSTN-telefoonnummers terugzetten naar Cisco BroadWorks.

Instructies voor het uitvoeren van de tool voor het verplaatsen van apparaten in de terugzetmodus.

Volg de onderstaande stappen om de tool voor het verplaatsen van apparaten in de terugzetmodus uit te voeren:

Voer de onderstaande opdracht uit op de secundaire Cisco BroadWorks Application Server in de map van de tool voor het verplaatsen van apparaten:

Profielen terugzetten

./devicemove.sh -input=  -revertProfiles

Nummers terugzetten

./devicemove.sh -input=  -revertNumbers

Terminallogboeken

Na een succesvolle uitvoering van de tool voor het verplaatsen van apparaten voor de terugdraaibewerking, krijgen we de volgende logberichten in de terminal te zien:

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