Hartelijk dank voor uw feedback

Ondersteunde telefoons worden automatisch aangemaakt en toegewezen aan gebruikers Webex Calling via de provisioningtool. De telefoons met de aanduiding „Ja” in de kolom „Ondersteund in de tool voor het verplaatsen van apparaten” worden ook automatisch verplaatst van Cisco BroadWorks of BroadCloud naar Webex Calling wanneer de tool voor het verplaatsen van apparaten wordt uitgevoerd. Telefoons die in die kolom met „Nee” zijn gemarkeerd, hebben een handmatige tussenkomst nodig om de DMS-URL in de Cisco BroadWorks-apparaatsjabloon of in de telefoon zelf te wijzigen.

De laatste kolom bevat de toewijzing van telefoonmodellen aan de kolom „Apparaattype” van het bestand transform-tool/input/newphones.csv. (Zie de sectie Transform tool in dit artikel voor meer informatie over newphones.csv).

Partnerbeheerders gebruiken dit hulpprogramma voor het genereren van tokens minstens één keer voordat ze migratietools gaan gebruiken. Het gebruik van deze tool is een eenmalige activiteit nadat het partneraccount is toegevoegd aan de Wholesale RTM-oplossing. Met deze tool kunnen partnerbeheerders inloggen via een webbrowser om het unieke TOKEN te krijgen dat nodig is om de configuratiebestanden van de partners voor de migratietools bij te werken.

Vereisten

Installeer Java 8, 11, 17 of 21 op de computer. Java is beschikbaar via 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 de migratietool uit.

Instructies om te rennen

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, log in met de beheerdersgegevens van de partner om de TOKEN te krijgen en kopieer deze voor verder gebruik.

De illustraties van de gebruikersinterface worden hieronder ter referentie gegeven:

Figuur 3: Inloggen met Cisco Webex

Figuur 4: Venster voor inloggegevens

Figuur 5: Generatie van tokens

Configureer de volgende stappen voordat u de tools Extract en Device Move op de secundaire BroadWorks-server uitvoert.

OCI-P-connectiviteit inschakelen

De tool voor het verplaatsen van apparaten communiceert met de BroadWorks via OCI-P-opdrachten. Gebruik de onderstaande stappen om OCI-P-connectiviteit mogelijk te maken :

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

Als uw instellingen niet overeenkomen met de bovenstaande, gebruik dan de opdracht set om uw instellingen opnieuw te configureren.

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

Verander de directory naar OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Voer de volgende CLI uit om de huidige instellingen te krijgen. 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 de 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 instellingen voor OCI Provisioning op te halen:

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

Stap 4: Voer de onderstaande opdracht uit in CLI om te controleren of uw configuratie 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.

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

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

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Stap 2: Start de server met dit commando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Activering van nummers inschakelen

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

Stap 1: Voer de opdracht voor nummeractivering uit:

AS_CLI> cd SubscriberMgmt/NumberActivation

Stap 2: Voer de opdracht Activation enabled uit:

AS_CLI> set dnMode groupAndUserActivationEnabled

Stap 3: Voer Yin bij de bevestigingsprompt.

Voor BroadCloud

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

1. Dien uittrekselaanvragen in voor maximaal 50 klanten per aanvraag.
   Een uittrekselaanvraag kan niet meer dan 10 keer per dag worden ingediend voor dezelfde klant.
2. Download het geëxtraheerde gegevensbestand, in ZIP-formaat, gedurende maximaal 28 dagen vanaf de datum van indiening van het verzoek.

De volgende afbeeldingen tonen het portaal voor serviceproviders.

Figuur 6: Portaal voor serviceproviders

Figuur 7: Portaal voor serviceproviders

CSV-uittreksel aanvragen

CSV-uittrekselverzoek initiëren

1. Het CSV-bestand voor klanten downloaden

   Klik op de link CSV voor klanten downloaden in de rechterbovenhoek van de sectie CSV-extractaanvraag starten.

2. De klantenlijst bewerken

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

3. Uploaden en verzenden

   Upload na de bewerking het gewijzigde CSV-bestand.

   Klik op Verzenden om een uittreksel aan te vragen voor de vermelde klanten en de bijbehorende locaties.

Initieer een uittrekselverzoek voor een klant met een CSV-locatie

1. Klant- en downloadlocaties selecteren

   Kies een klant in de keuzelijst.

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

2. Het locatiebestand bewerken

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

3. Uploaden en verzenden

   Upload het bewerkte locations.csv en klik op Verzenden.

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

Initieer een uittrekselverzoek voor alle klanten

1. Klik op Verzenden om een uittreksel aan te vragen voor alle klanten en al hun locaties onder de huidige serviceprovider.

Voor Cisco BroadWorks en Webex voor BroadWorks

1. De extractietool draait op de secundaire Cisco BroadWorks Application Server binnen het partnernetwerk en maakt verbinding via OCI-P.
2. De tool haalt onbewerkte gegevens van bedrijven, groepen, cijfers, gebruikers, diensten, apparaten en soft clients van het Cisco BroadWorks- of BroadCloud-platform en voert deze gegevens uit naar XML-bestanden die de input leveren voor de transformatietool.

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

Vereisten

1. SCP, de binaire bestanden van de tool voor het extraheren van binaire bestanden naar de secundaire Cisco BroadWorks Application Server.
2. SSH naar de secundaire Cisco BroadWorks Application Server om de vereisten te configureren en de extractietool uit te voeren.
3. Configureer de serviceprovider en de groeps-ID om te extraheren uit Cisco BroadWorks in de Conf/ExportTool.yml. Raadpleeg het volgende voorbeeld van een YAML-fragment:

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

4. Controleer of de secundaire gebruikersnaam, het wachtwoord en de hostnaam van de Cisco BroadWorks Application Server 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.
   

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

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

   JAVA_HOME=/usr/local/java/java_base

Instructies om te rennen

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

./export.sh

Terminallogboeken

De volgende logboeken zijn beschikbaar in de terminal bij een succesvolle export: BroadSoft Data Export Tool 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
**************************************************

Uitvoer

Er is een ZIP-bestand (extracted_data_.zip<timestamp>) voor uitvoer beschikbaar in dezelfde map met de extractietool. Gebruik de volgende opdracht om het ZIP-bestand voor de Transform Tool-invoer 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

Als de beheerder de tool achter een zakelijke proxy gebruikt, volg dan de onderstaande stappen om het exportscript te configureren en uit te voeren.

Stappen om het exportscript te configureren en uit te voeren

1. Open het bestand export.sh.
2. Zoek de variabele HTTPS_PROXY_HOST op en verwijder het commentaar (verwijder de voorloopcode).

3. Stel de waarde HTTPS_PROXY_HOST in als:

   HTTPS_PROXY_HOST=<proxy-host>

4. Lokaliseer de variabele HTTPS_PROXY_PORT en verwijder het commentaar (verwijder de voorloopcode).
5. Stel de waarde HTTPS_PROXY_PORT in als:

   HTTPS_PROXY_PORT=<proxy-port>

6. Sla het bestand export.sh op en sluit het.
7. Open het bestand partner.cfg en voeg de vereiste refresh_token toe.
8. Controleer of de BroadWorks-host, gebruikersnaam en wachtwoord correct zijn geconfigureerd in partner.cfg.
9. Voer het script uit:

   ./export.sh

Formulier voor verloving:

De Extract Tool (BroadCloud en BroadWorks) genereert nu automatisch een geconsolideerd XLSX-bestand met de titel Engagement Form SUA.xlsx tijdens de uitvoering. Het bestand is vooraf ingevuld met alle beschikbare gegevens op relevante werkbladen, wat helpt om de voltooiing van de gegevens door partners te stroomlijnen en te versnellen .

Deze transformatietool is geschikt voor alle migraties. De transformatietool werkt op elke computer, inclusief de beheerderslaptop van een partner, en maakt gebruik van de openbare API's van Webex. Het leest het ZIP-bestand (extracted_data_ .zip<timestamp>) als invoer en zet de onbewerkte XML om in een JSON-formaat dat wordt gebruikt door de provisioning tool.

Vereisten

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Voor een volledigere verificatie van het e-mailadres van de klant kunt u optioneel de PROVISIONING_ID instellen.
3. Configureer ontbrekende informatie in het bestand input/customers.csv (zie volgende sectie) indien deze ontbreekt.
4. Voeg het e-mailadres van de eindgebruiker toe aan het bestand input/users.csv.
5. Als er nieuwe telefoons moeten worden bevoorraad, voeg dan het mac-adres en e-mailadres van de nieuwe telefoon van de gebruiker toe aan het bestand input/newphones.csv. Dit is alleen nodig als de beheerders van de partners nieuwe telefoons willen aanbieden in het kader van Wholesale Calling.
6. Converteer de BroadWorks Call Centers naar de CXEssentials met behulp van het bestand input/cxessentials.csv.
7. Schakel optioneel de eigenschap UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS in om alle callcenters naar CXEssentials te converteren.
8. Gebruik het bestand input/locations.csv ter ondersteuning van de migratie van grote ondernemingen, waarbij beheerders de locaties van hun klanten naar 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 de opmerking use_mac_address_from_sip_register=Yes in het 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 wachttijd in te stellen en de T38-instellingen uit te schakelen voor alle analoge gebruikers.

11. Als u generieke gateway-apparaten wilt instellen, voegt u het MAC-adres en de gebruikers-ID van het apparaat toe aan het bestand input/genericgateways.csv. Vermeld ook of de gebruiker de PRIMAIRE eigenaar is of een GEDEELDE gebruiker (voor gedeelde gesprekken). 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 moet u het bestand conf/rialto_station_type_to_wholesale_package.csv bijwerken door de waarde van het Wholesale Package te vervangen door voice_mail_group door de waarde van het Wholesale Package te vervangen door voice_mail_group voor de rij waarin het Rialto Station Type berichten verzendt.

    Schakel optioneel de eigenschap COMMON_VOICE_MAIL_GROUP_PASSCODE in partner.cfg in om de standaardpincode 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 de migratie van gemeenschappelijke contactpersonen naar Webex Calling

    Het is de verbetering voor het beheer van gemeenschappelijke contacten op bedrijfs- en locatieniveau. Deze contactpersonen kunnen nu worden gemigreerd als contactpersonen van de organisatie (Org Contacts) of als virtuele extensies, op basis van de configuratie-instellingen. Hieronder vindt u de informatie om u te begeleiden bij dit migratieproces.

    Sleutelconfiguratie:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

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

    • Zonder COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE geconfigureerd

      Gemeenschappelijke contactpersonen worden gemigreerd als contactpersonen van de organisatie (Org Contacts).

      Er is geen aanvullende configuratie vereist.

      Contacten blijven toegankelijk op organisatieniveau.

    • 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 de extensie wordt gedefinieerd in de eigenschap COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE in partner.cfg.

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

14. Schakel Webex de standaardleverancier voor gespreksopname in.

    Deze stap is alleen vereist bij de migratie van instellingen voor gespreksopname voor gebruikers die met Dubber zijn geconfigureerd naar Cisco Native Call Recording in Webex.

    Om deze optie in te schakelen:

    • 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 de opslagregio te configureren.

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

15. Uitsluiting van geselecteerde telefoonnummers van migratie:

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

    • Voer de transformatietool in eerste instantie voor de eerste keer uit. Na voltooiing genereert de tool een bestand met de naam telephone_numbers_inventory.csv, dat zich in de map output/timestamp/ bevindt. De klant moet dit bestand bekijken en „Ja” aangeven in de kolom „Drop Tn's” voor elk telefoonnummer dat moet worden uitgesloten van de komende migratie.
    • Nadat het bestand telephone_numbers_inventory.csv is bijgewerkt met de juiste uitsluitingsvlaggen, wordt de transformatietool een tweede keer uitgevoerd. Het bijgewerkte bestand moet als argument worden doorgegeven in de volgende indeling.

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

16. Stel optioneel de eigenschap ALLOW_RESTRICT_BY_PARTNER_MODE in op OFF zodat klantenbeheerders de door de partner gedefinieerde instellingen in Control Hub kunnen wijzigen.
17. Voor de migratie van mobiele nummers (BroadWorks Mobility) van BroadCloud naar Webex Calling

    In dit gedeelte wordt de migratie beschreven van de functie BroadWorks Mobility (mobiele nummers voor klanten) van BroadCloud (Mobile Network Integration) naar Wholesale Webex Calling (Webex Go Mobile Network Operator).

    Vereisten - Voordat het migratieproces wordt gestart, moeten partnerbeheerders contact opnemen met het Cisco-accountteam om de Cloud Connected PSTN (CCP) -leverancier en de Custom Carrier List (CCL) -configuratie uit te voeren.

    Een nieuwe eigenschap, ASSIGN_MOBILE_NUMBERS_TO_USERS, wordt toegevoegd aan het bestand partner.cfg. Schakel deze eigenschap in zodat mobiele nummers kunnen worden toegewezen en naar gebruikers kunnen worden gemigreerd.

    • Deze functie wordt alleen ondersteund voor migraties van Broadcloud naar Wholesale.
    • In Wholesale Webex kunnen eindgebruikers een mobiel nummer of een PSTN-nummer hebben (niet beide), in tegenstelling tot BroadCloud.
    • Wanneer een mobiel nummer wordt toegewezen aan een gebruiker, wordt zijn primaire PSTN-nummer het secundaire (alternatieve) nummer.
    • Mobiele nummers kunnen niet worden gemigreerd voor gebruikers die worden omgezet naar werkruimten of virtuele lijnen.
    • Nadat een mobiel nummer is toegewezen in Wholesale Webex, wordt dit weergegeven als Actief in Control Hub. Deze status betekent niet dat het nummer onmiddellijk klaar is om oproepen te ontvangen. Gespreksmogelijkheden zijn pas beschikbaar nadat de migratie volledig is voltooid.
    • Instellingen voor de integratie van mobiele telefoons die door eindgebruikers in het Calling User Portal (CUP) zijn geconfigureerd, worden niet gemigreerd. Na de migratie, wanneer een telefoonnummer, mobiel nummer of toestel wordt gebeld, gaan alle apparaten van de gebruiker over.

18. Om optioneel de limieten voor de hoeveelheid pakketten te configureren tijdens de migratie van klanten, specificeert u de hoeveelheid voor elk pakket in het bestand input/package_quantity.csv. De geconfigureerde hoeveelheid pakketten moet groter zijn dan of gelijk zijn aan het aantal pakketten dat aan de gebruiker/werkruimte is toegewezen.

    De maximale hoeveelheid pakketten wordt momenteel niet ondersteund voor migraties van Webex for BroadWorks naar Wholesale.

    Wanneer u de transformatietool gebruikt, geef dan het bijgewerkte bestand op als invoerparameter:. <extract_zip_file>/transform.sh -extract= -pakketlimiet=invoer/pakketaantal.csv .

19. Migreer sites van meerdere klanten van Broadworks/BroadCloud naar één klant in de groothandel Webex Calling
    • In de Transform-tool wordt een nieuwe runtime-modus, -ConsolidatedMigration, geïntroduceerd ter ondersteuning van de migratie van meerdere klantensites van Broadcloud/Broadworks naar het Webex Wholesale Platform onder één Wholesale Customer Organization. Als deze modus is ingeschakeld, consolideert de tool meerdere klantensites in één groothandelsklantenorganisatie

      -consolidatedMigration

    • Naast -ConsolidatedMigration kunnen er nog andere optionele argumenten worden gegeven, zoals

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • als -TargetEnterpriseID is gegeven en de ID bestaat in het uitvoerbestand van de Extract-tool, dan wordt dat gebruikt om de klantenorganisatie voor de groothandel op te richten en als de ID niet wordt gevonden, zal de tool terugvallen om alle beschikbare klantgegevens uit het uitvoerbestand van de Extract-tool te gebruiken.
    • als -ConsolidateExternalId wordt gegeven, wordt de ExternalId voor de klant ingesteld en als die niet wordt gegeven, zal de tool terugvallen om de bestaande flow te gebruiken voor een extern ID.
    • <timestamp>Een geconsolideerd JSON-bestand (customer.json) zal beschikbaar zijn in de map output//consolidated.

De input/customers.csv is aan het invullen

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

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

De input/users.csv is aan het invullen

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

Instructies om te rennen

Voer de Transform Tool 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 uit te voeren:

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

MacOS

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

1. Creëer een virtuele omgeving en installeer afhankelijkheden om de transformatietool uit te voeren met Python:

   python3 -m venv venv
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. Voer de transformatietool uit:

   ./transform.sh -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Voorcontrole klant/gebruiker

De Transform Tool voert API-aanroepen naar Webex om mogelijke problemen met de bevoorrading op te sporen. Standaard worden het adres en het primaire e-mailadres van de klant gevalideerd. Als de waarde PROVISIONING_ID is opgegeven in het bestand conf/partner.cfg, worden ook de locatiegegevens gevalideerd. De resultaten vóór de controle zijn opgenomen in het uitzonderingsrapport.

Daarnaast kunnen de volgende optionele parameters worden toegevoegd wanneer de transformatietool wordt uitgevoerd:

voorafgaand aan de controle

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

informatie voorafgaand aan de controle

Standaard worden alleen fouten die vooraf zijn gecontroleerd (dat wil zeggen problemen die de bevoorrading blokkeren) opgenomen in het uitzonderingsrapport. Als u deze vlag toevoegt, worden ook succesvolle resultaten vóór de controle opgenomen (bijvoorbeeld als er al een Webex-organisatie bestaat die automatisch kan worden gekoppeld).

Terminallogboeken

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

Rapport over uitzonderingen

Transform Tool genereert het uitzonderingsrapport in de map output/ /exception_report.txt<timestamp>. 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 Extract and Transform Tools opnieuw uit met de nieuwe gegevens. Het voorbeeldbestand van het uitzonderingsrapport is 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

Uitvoer

Er zal een JSON-bestand (customer.json) voor de uitvoer beschikbaar zijn in de map output//. <timestamp><groupid> 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 computer worden uitgevoerd, meestal op de beheerderslaptop van de partner (van de partner) en maakt gebruik van de openbare API's van Webex. Het leest het JSON-bestand (customer.json) met uitvoer van de transformatietool als invoer en bevoorrading van de klanten, locaties, nummers, gebruikers, services en apparaten in de Webex Wholesale RTM-oplossing.

Vereisten

Configureer de volgende vereisten in de directory van de provisioning tool:

1. Installeer Java 8, 11, 17 of 21 op de computer. Java is beschikbaar via 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. Nadat u de binaire bestanden van de Migratietools hebt gedownload en uitgepakt, stelt u de omgevingsvariabele JAVA_HOME in op provisioning_tool.sh voor MAC en provisioning_tool.bat voor Windows.
3. Het bestand partner.cfg:
   • 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 krijgen:

     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 true.

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

     Gebruikers en klantenbeheerders die gevestigd zijn op locaties in de VS en Canada ontvangen een afzonderlijke e-mailmelding van RedSky. Het RedSky E911-platform verstuurt deze e-mail om te bevestigen dat er een klantenaccount voor de hulpdiensten is aangemaakt. Deze e-mail van RedSky staat los van de welkomstmails van Webex en wordt niet beheerd door de e-mailinstellingen van Webex. Voor groothandelsorganisaties in de VS en Canada wordt RedSky automatisch ingeschakeld als hulpverlener.

4. Gebruik de eigenschap WEBEX4BWKS_EMAIL_SUBJECT voor Webex for BroadWorks-migraties om het onderwerp voor het wijzigen van het wachtwoord te verzenden voor Webex for BroadWorks-abonnees.
5. Gebruik de eigenschap WEBEX4BWKS_EMAIL_BODY voor Webex for BroadWorks-migraties om de hoofdtekst voor het wijzigen van het wachtwoord te verzenden voor Webex for BroadWorks-abonnees.
6. Gebruik de eigenschap CUSTOM_TAGS om tags toe te voegen nadat de klant is aangemaakt.
7. Om groothandelskortingen toe te passen, moeten partnerbeheerders contact opnemen met het Cisco-accountteam voordat u met de migratie begint.

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

8. (Optioneel) Configureer de PSTN-verbinding expliciet

   Om de PSTN-verbinding te specificeren voor alle locaties die tijdens de migratie zijn ingericht, inclusief de hoofdlocatie, voegt u de volgende eigenschap toe aan het bestand partner.cfg:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Als de eigenschap niet is geconfigureerd of als er opmerkingen worden weergegeven, gebruikt de provisioningtool het standaardproces voor het selecteren van PSTN-verbindingen.

Instructies om te rennen

Volg de volgende stappen om de tool in Windows en MacOS uit te voeren:

Windows

Voer de volgende stappen uit om de tool op Windows OS uit te voeren:

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

MacOS

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

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Vereisten voor de migratie van Webex naar BroadWorks

Partnerbeheerders moeten hun BroadWorks-onboarding-sjabloon bijwerken voor de coëxistentiefuncties van Webex for BroadWorks. Raadpleeg de volgende afbeelding:

Zodra de Webex for BroadWorks Onboarding-sjabloon is bijgewerkt om de migratie te ondersteunen, moet u het Cisco-accountteam vragen om de functie „Wholesale-partner-blending-enabled” op partnerniveau in te schakelen. Met deze instelling kan de Provisioning-tool tijdens de provisioning automatisch groothandelspakketten toevoegen aan bestaande Webex for BroadWorks-klanten .

Voer de provisioningstool uit met een extra argument.

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

Onderhoudsfase: is de tweede fase waarin beheerders de groothandelslicentie kunnen toewijzen aan de bestaande Webex for BroadWorks-gebruikers. U moet de provisioningstool gebruiken met onderhoud van argumenten.

Fase na de migratie: is de laatste fase waarin beheerders de BroadWorks volledig naar Wholesale kunnen omzetten. U moet de provisioningstool gebruiken met een argument na de migratie.

Terminallogboeken

Hieronder vindt u de logboeken in de terminal van succesvolle bevoorrading:

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 wordt aangemaakt:

Uitvoer

<external_id>De provisioningtool genereert succes- en foutrapporten in de uitvoer-//*.succes-/foutbestanden. Controleer het succes van de uitvoer en de foutenlogboeken om te controleren of de levering is gelukt.

Het systeem zal een Provisioning_Report_*.csv-bestand genereren in de map output/consolidated_reports/. Dit bestand bevat zowel succes - als foutgegevens voor elke entiteit en de instellingen ervan, en biedt een uitgebreid leveringsrapport.

De provisioningtool genereert ook een Provisioning_Statistics_*.csv-bestand in de map output/consolidated_reports/. Dit rapport bevat het aantal succesvol en niet succesvol ingerichte klanten, locaties, gebruikers, apparaten en functies van de groep.

Partnerbeheerders kunnen de klantenbevoorrading verifiëren in het Partner Hub- en Control Hub-portaal. Raadpleeg de volgende afbeeldingen van het Partner Hub- en Control Hub-portaal:

Figuur 8: Partner Hub

Figuur 9: Control Hub

Figuur 10: Apparaten

Figuur 11: Bellen

Beperkingen na de bevoorrading

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

• CAP Portal — Gebruikers of apparaten met poorten toevoegen.
• SP Portal — ADD-bestellingen aanmaken met apparaten of nummers.
• RSB API — ADD-orders aanmaken met apparaten of nummers en gebruikers aanmaken. RSB ADD-bestellingen die met apparaten of nummers worden gedaan, worden afgewezen.

Migratie van BroadCloud naar Wholesale — Beperking van de registratie van apparaten

Voor partnerbeheerders die klanten migreren van BroadCloud naar Wholesale binnen dezelfde regio, kunnen apparaten worden toegevoegd aan Wholesale nadat de provisioningtool is uitgevoerd. Die apparaten komen echter pas in aanmerking voor registratie op het Webex-platform nadat de migratie (verplaatsing van het apparaat) naar de corresponderende locatie is voltooid.

Deze beperking is niet van toepassing op:

• Klanten die migreren van Broadworks/W4B naar Wholesale.
• Migraties van BroadCloud naar Wholesale in verschillende regio's.

Aanbevolen begeleiding

Om problemen met de apparaatregistratie te voorkomen, moet u de migratie van apparaten op locatieniveau voltooien voordat u probeert apparaten te registreren op het Webex-platform voor migraties van BroadCloud naar Wholesale in dezelfde regio.

Voor BroadCloud

Voor BroadCloud-partners: gebruik het portaal van de serviceprovider om een migratieaanvraag in te dienen voor nummers, apparaten en Shared Call Appearances (SCA) migraties.

Binnen het portaal van de serviceprovider kan een migratieaanvraag betrekking hebben op maximaal 50 klanten. Er kunnen maximaal 10 aanvragen binnen een dag worden ingediend.

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

Er zijn twee opties beschikbaar om het migratietype in de portal te selecteren:

• Migratie — Selecteer deze optie om een aanvraag in te dienen voor de migratie van nummers, apparaten en Shared Call Appearances (SCA).
• Apparaatstatus — Selecteer deze optie om de huidige status van een apparaat op BroadCloud en Calling te bekijken.

De volgende afbeeldingen tonen het portaal voor serviceproviders.

Figuur 12: Portaal voor serviceproviders

Figuur 13: Portaal voor serviceproviders

Migreer geselecteerde locaties (optioneel)

Om de migratie te starten voor een specifieke subset van locaties die zijn opgenomen in het bestand customer.json, moet u een bestand locations.csv bij uw verzoek voegen. In dit CSV-bestand moeten alleen de locaties worden vermeld die u wilt migreren.

Om de lijst met beschikbare actieve websites te downloaden, gaat u naar Klanten bekijken → Een klant selecteren → Locaties exporteren als CSV.

Figuur 14: Exporteer locaties als CSV

Schakel de optie voor het verbreken van nummers in

Als u dezelfde SIP-trunk gebruikt voor Webex Calling en BroadCloud Carrier, moeten beheerders de optie Disconnect Numbers gebruiken. Dit zorgt ervoor dat telefoonnummers geen inkomende oproepen meer ontvangen na de migratie in BroadCloud.

Om deze optie in te schakelen,

1. In het bestand partner.cfg stelt u DISCONNECT_NUMBERS_FROM_RIALTO = ja in.
2. Voer de migratietool opnieuw uit met hetzelfde customer.json-bestand en de bijgewerkte partner.cfg.

Als de verbinding met nummers niet wordt verbroken, dien dan een Cisco TAC-verzoek in.

Voor Cisco BroadWorks en Webex voor BroadWorks

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

Bij een succesvolle bediening zal het gereedschap voor het verplaatsen van het apparaat:

1. Apparaten deregistreren bij Cisco BroadWorks en ze registreren bij Wholesale.
2. Gebruikers die de UC-One-client gebruiken, worden bij de eerste aanmelding omgeleid naar de Webex-app.
3. Deactiveer de telefoonnummers van Cisco BroadWorks of verwijder de telefoonnummers uit BroadCloud.
4. Activeer nummers in de groothandel.
5. Creëer gedeelde gespreksoptredens in Wholesale voor BroadCloud-migraties. [Deze stap is alleen van toepassing op BroadCloud-migraties].

6. Als de beheerder de tool achter een zakelijke proxy gebruikt, volg dan de onderstaande stappen om het inrichtingsscript te configureren en uit te voeren.

   Configuratieprocedure

   1. Open het bestand devicemove.sh.
   2. Zoek de variabele PROXY_HOST op en verwijder de commentaren (verwijder de eerste # voor devicemove.sh).

   3. Stel de PROXY_HOST-waarde in als:

      PROXY_HOST=<proxy-host>

   4. Zoek de variabele PROXY_PORT op en verwijder de commentaren (verwijder de eerste # voor devicemove.sh).

   5. Stel de waarde PROXY_PORT in als:

      PROXY_PORT=<proxy-port>

   6. Zoek de variabele PROXY_SCHEME op en verwijder het commentaar (verwijder de eerste # voor devicemove.sh). Deze stap is optioneel; als er commentaar blijft staan, is de standaardwaarde voor PROXY_SCHEME HTTP.

   7. Stel de waarde PROXY_SCHEME in als:

      PROXY_SCHEME=<proxy-scheme>

   8. Sla het bestand devicemove.sh op en sluit het.
   9. Open het bestand partner.cfg en voeg de vereiste refresh_token toe.
   10. Controleer of de BroadWorks-host, gebruikersnaam en wachtwoord correct zijn geconfigureerd in partner.cfg

   11. Voer het script uit:

       ./devicemove.sh

SCP en SSH

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

Vereisten

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Controleer of de secundaire gebruikersnaam, het wachtwoord en de hostnaam van de Cisco BroadWorks Application Server juist zijn in het bestand Conf/DeviceMoveTool.conf :

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Om activeringsmails opnieuw te verzenden, moet u send_subscribers_welcome_email=true instellen in het bestand conf/partner.cfg.

   Als beheerders tijdens de migratie uitnodigingsmails naar hun gebruikers willen sturen, moeten ze de eigenschap „send_subscribers_welcome_email=true” in het bestand conf/partner.cfg verwijderen. Anders moet de accommodatie ongewijzigd blijven.

4. Controleer of het pad voor de JDK/JRE-omgeving 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 binnen een onderneming.

Polycom-telefoons

Om Polycom-telefoons over te zetten van Cisco BroadWorks naar Wholesale Calling, moet een partnerbeheerder een nieuw identiteits-/apparaatprofieltypebestand aanmaken op systeemniveau in Cisco BroadWorks voor elk Polycom-apparaatsjabloon. Raadpleeg figuur 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 nieuw aangemaakte bestand op groepsniveau bestaat. Zorg er ook voor dat het bestand Migration_%BWMAC-adres%.cfg niet conflicteert met een bestaand bestand op uw systeem).

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

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 op apparaatniveau.
   Handelen op groeps- 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 Application Server om telefoons opnieuw op te starten op groeps- of apparaatniveau.
4. Na het herstartverzoek downloaden en verwerken Polycom-telefoons %BWMacAddress%.cfg, waarbij de Polycom-telefoons worden gevraagd Migration_%BWMacAddress%.cfg te downloaden en te verwerken, waarbij de Device.prov.ServerName wordt ingesteld op https://plcm.sipflash.com.
   https://plcm.sipflash.com voor de Amerikaanse regio hebben andere regio's verschillende URL's.
5. De Polycom-telefoon downloadt %BWMacAddress%.cfg van https://plcm.sipflash.com en wordt beheerd door het DMS. Webex Calling

Figuur 14: Identiteit/apparaatprofieltype toevoegen

Instructies om te rennen

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

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

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Terminallogboeken

Hieronder vindt u de logboeken in de terminal over het succesvol uitvoeren van de Device Move-tool voor de migratie van apparaten:

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

Uitvoer

Na de migratie van het apparaat zijn de apparaten online gekomen en klaar om te bellen of gebeld te worden. Zie figuur 15 voor een voorbeeld van de status van het apparaat:

Figuur 15: Status van het apparaat

Na de migratie van het apparaat zijn de nummers actief geworden. Zie figuur 16 om een voorbeeld te zien van welke nummers actief zijn:

Figuur 16: Getallen actief

Als de beheerder de tool achter een zakelijke proxy gebruikt, volg dan de onderstaande stappen om het devicemove-script te configureren en uit te voeren .

Stappen om het devicemove-script te configureren en uit te voeren

1. Open het bestand devicemove.sh.
2. Zoek de variabele HTTPS_PROXY_HOST op en verwijder het commentaar (verwijder de voorloopcode).

3. Stel de waarde HTTPS_PROXY_HOST in als:

   HTTPS_PROXY_HOST=<proxy-host>

4. Lokaliseer de variabele HTTPS_PROXY_PORT en verwijder het commentaar (verwijder de voorloopcode).
5. Stel de waarde HTTPS_PROXY_PORT in als:

   HTTPS_PROXY_PORT=<proxy-port>

6. Sla het bestand devicemove.sh op en sluit het.
7. Open het bestand partner.cfg en voeg de vereiste refresh_token toe.
8. Controleer of de BroadWorks-host, gebruikersnaam en wachtwoord correct zijn geconfigureerd in partner.cfg.
9. Voer het script uit:

   ./devicemove.sh

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

Voor BroadCloud Carrier

Beheerders kunnen rollback_to_broadcloud=true instellen in conf/partner.cfg om automatisch terugdraaien mogelijk te maken. Hiermee worden apparaten teruggezet naar BroadCloud na een succesvolle migratie in dezelfde of een andere regio met NS Sync. Neem voor mislukte migraties contact op Cisco TAC voordat u een terugdraaiing aanvraagt.

Voor Cisco BroadWorks en Webex voor BroadWorks

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

1. Open een ticket met Cisco TAC om een apparaat terug te zetten.
2. Voer de tool voor het verplaatsen van apparaten uit in de omgekeerde modus op de secundaire BroadWorks Application Server om de migratie van het apparaat ongedaan te maken. Hiermee wordt de DMS-URL teruggezet naar de DMS-URL van de serviceprovider voor apparaatprofielen in Cisco BroadWorks en worden de telefoonnummers opnieuw geactiveerd.
3. Het Webex Calling team stelt de DMS-URL terug naar de DMS-URL van de serviceprovider in de apparaatprofielen in. Webex Calling
4. Partnerbeheerders moeten de telefoonnummers in het Webex Calling via de Control Hub-portal deactiveren of verwijderen.
5. Partnerbeheerders moeten PSTN-telefoonnummers terugzetten naar Cisco BroadWorks.

Instructies om de Device Move Tool in de omgekeerde modus uit te voeren

Volg de onderstaande stappen om de tool voor het verplaatsen van het apparaat in omgekeerde modus uit te voeren:

Voer de onderstaande opdracht uit op de secundaire Cisco BroadWorks Application Server in de directory van de Device Move Tool:

Profielen terugdraaien

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Nummers terugdraaien

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

Terminallogboeken

We krijgen de volgende logboeken in de terminal als de tool voor het verplaatsen van het apparaat succesvol wordt uitgevoerd om de bewerking ongedaan te maken:

Profielen terugdraaien

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

Nummers terugdraaien

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully