Migratietools voor de overgang van BroadWorks, Webex voor BroadWorks en BroadCloud naar RTM-oplossingen voor groothandels

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

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

Partnerbeheerders voeren dit hulpprogramma voor tokengenerator ten minste één keer uit voordat ze beginnen met het uitvoeren van migratiehulpprogramma's. Het uitvoeren van deze tool is een eenmalige activiteit nadat het partneraccount is geïntegreerd in de Wholesale RTM-oplossing. Met deze tool kunnen partnerbeheerders zich aanmelden via de webbrowser om het unieke TOKEN te krijgen dat nodig is om bij te werken naar de partnerconfiguratiebestanden voor de migratietools.

Voorwaarden

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

Stel het JRE/JDK-omgevingspad in de token_generator.sh voor MAC en token_generator.bat voor Windows in. Als het JAVA_HOME-pad al bestaat, wordt het opnieuw gebruikt door de tool.

• MAC: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Uit te voeren instructies

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

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Uitvoer:

Toolnaam: Versie van de tool voor tokengenerator: 1.13.0 Laad de URL in uw webbrowser: http://localhost:8080 

Open de URL in de webbrowser op de terminal, meld u aan met de aanmeldgegevens van de partnerbeheerder om het TOKEN op te halen en kopieer dit voor verder gebruik.

De illustraties van de gebruikersinterface vindt u hieronder ter referentie:

Afbeelding 3: Aanmelden met Cisco Webex

Afbeelding 4: Aanmeldvenster

Afbeelding 5: Token genereren

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

OCI-P-connectiviteit inschakelen

Het hulpprogramma voor het verplaatsen van apparaten communiceert met BroadWorks via OCI-P-opdrachten, om OCI-P-connectiviteit in te schakelen, gebruikt u de volgende stappen:

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

Voer de volgende opdracht uit in CLI om de GeneralSettings-directory te wijzigen:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

Wijzig de directory naar OCI-proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

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

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

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

Wijzigen in de inrichtingsdirectory:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> adresbeschrijving ophalen ======================== 127.0.0.1 lokaal als 

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

 AS_CLI/Maintenance/ManagedObjects> krijg broadworks en controleer of uw output in orde is. Zie hieronder voor voorbeeldoutput: AS_CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== * Server: Identiteit..............: AS-versie...............: Rel_21.sp1_1.551 Administratieve Staat..: Ontgrendeld * Toepassingen: Naamversie Geïmplementeerde administratieve status Effectieve status uitvoerenAndProvisioning 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 gevonden. * Hosted Applications: Naam Versie Context Path Geïmplementeerd ================================================================== 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 gevonden. 

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

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

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

AS_CLI/Maintenance/ManagedObjects> toepassing OpenClientServer implementeren

Stap 2: Start de server met deze opdracht:

AS_CLI/Maintenance/ManagedObjects> toepassing OpenClientServer starten

Nummeractivering inschakelen

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

Stap 1: Voer de opdracht voor de nummeractivitie uit:

AS_CLI> cd SubscriberMgmt/NumberActivation

Stap 2: Voer de opdracht Activering ingeschakeld uit:

AS_CLI> dnMode-groep instellenAndUserActivationEnabled

Stap 3: Voer bij de bevestigingsprompt Y in.

Voor BroadCloud

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

1. Stuur extractieaanvragen in voor maximaal 50 klanten per aanvraag.
   Extractieverzoek kan niet meer dan 10 keer per dag voor dezelfde klant worden verzonden.
2. Download het uitgepakte gegevensbestand, in ZIP-indeling, gedurende maximaal 28 dagen vanaf de verzenddatum van het verzoek.

De onderstaande cijfers tonen het portaal van de serviceprovider.

Afbeelding 6: Portal voor serviceproviders

Afbeelding 7: Portal voor serviceproviders

Voor Cisco BroadWorks en Webex voor BroadWorks

1. Het extractiehulpprogramma wordt uitgevoerd op de secundaire Cisco BroadWorks-toepassingsserver binnen het partnernetwerk en maakt verbinding via OCI-P.
2. De tool haalt de onbewerkte gegevens van de onderneming, groep, nummers, gebruikers, services, apparaten en softclient van het Cisco BroadWorks- of BroadCloud-platform en voert deze gegevens uit naar XML-bestanden die de ingangen voor de transformatietool leveren.

In de volgende secties wordt uitgelegd hoe u het hulpprogramma Extract installeert en configureert.

Voorwaarden

1. SCP de extractiehulpprogramma binaire bestanden naar de secundaire Cisco BroadWorks-toepassingsserver.
2. SSH naar de secundaire Cisco BroadWorks-toepassingsserver om de vereisten te configureren en het extractiehulpprogramma uit te voeren.
3. Configureer de serviceprovider en de groeps-id om uit Cisco BroadWorks te extraheren in conf/exportTool.yml. Zie onderstaande sample YAML snippet:

   Serviceprovider-id-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceproviderID-B:                        - ALLE 

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Vernieuwingstoken van partnerbeheerder gekopieerd van het hulpprogramma Token Generator. MIGRATIE_MODUS = Ondersteunde waarden zijn webex_for_broadworks_to_wholesale. De standaardwaarde is broadworks_to_wholesale. Gebruiken webex_for_broadworks_to_wholesale voor Webex voor BroadWorks-migraties. 

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

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

   JAVA_HOME=/usr/local/java/java_base

Uit te voeren instructies

Voer de onderstaande opdracht uit in de secundaire Cisco BroadWorks-toepassingsserver vanuit de map Extract-hulpprogramma:

./export.sh

Terminallogboeken

De volgende logboeken zijn beschikbaar op de terminal bij een geslaagde export: Het BroadSoft-hulpprogramma voor gegevensexport uitvoeren:

 Uitvoeren BroadSoft Data Export Tool ************************************************ Start Export Tool v: 1.15.0 Export gestart voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exporterende gebruikers voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exporterende gebruikers voltooid voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export voltooid voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export voltooid Export Dump Zip Directory: output/20221017223452_ExportTool Export Dump Zip-bestandsnaam:extracted_data_1666060500618.zip-bestand met de naam extracted_data_1666060500618.zip is gemaakt ZIP-bestand maken voltooid Geëxporteerde bestanden geconverteerd als ZIP-bestand ************************************************** 

Output

Een output ZIP-bestand (extracted_data_.zip) is beschikbaar in dezelfde map van het uitpakhulpprogramma. Gebruik de onderstaande opdracht om het ZIP-bestand te bekijken en te gebruiken voor de invoer van het transformeer hulpprogramma:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 okt  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 okt  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 okt  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 okt  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 okt 17 22:34 output/ drwxrwxr-x 2 bwadmin bwadmin 4096 okt 17 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 okt 17 22:35 extracted_data_1666060500618.zip 

Deze transformatietool wordt uitgevoerd voor alle migraties. Het transformatiehulpprogramma wordt op elke computer uitgevoerd, inclusief de beheerderslaptop van een partner, en gebruikt de openbare Webex-API's. Het leest het output ZIP-bestand (extracted_data_.zip) van het hulpprogramma voor uitpakken als een invoer en transformeert de ruwe XML in een JSON-indeling die wordt gebruikt door het hulpprogramma voor inrichting.

Voorwaarden

Nadat u de binaire bestanden met migratietools hebt gedownload en verwijderd, configureert u de volgende vereisten:

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

   VERNIEUWEN_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAAM_VAN_HOOFDLOCATIE_=Hoofdlocatie 

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

   INRICHTING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Voor een meer volledige verificatie van het e-mailadres van de klant kunt u optioneel de PROVISIONING_ID instellen.
3. Configureer ontbrekende informatie in het invoer-/customer.csv-bestand (zie het volgende gedeelte) als deze ontbreekt.
4. Voeg het e-mailadres van de eindgebruiker toe in het invoer-/gebruikers.csv-bestand.
5. Als er nieuwe telefoons moeten worden ingericht, voegt u het mac-adres en e-mailadres van de nieuwe telefoon van de gebruiker toe om het bestand newphones.csv in te voeren. Dit is alleen vereist als de partnerbeheerders nieuwe telefoons willen inrichten in gesprekken voor groothandels.
6. Converteer de BroadWorks-callcenters naar de CxEssentials met het bestand input/cxessentials.csv.
7. Schakel desgewenst de eigenschap ALLE_CALL_CENTERS__UPGRADEN NAAR_CX_ESSENTIALS in om alle Call Centers te converteren naar CxEssentials.
8. Gebruik het bestand input/locations.csv om de grote bedrijfsmigratie te ondersteunen waarmee beheerders de locaties van hun klanten per locatie kunnen migreren
9. Schakel optioneel het gebruik van MAC-adressen in via de koptekst User-Agent van het SIP REGISTER-bericht wanneer het MAC-adres niet beschikbaar is in het Cisco BroadWorks-apparaatprofiel. Uncomment the line "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" in file conf/partner.cfg

Input/customers.csv invullen

De bestandsinvoer/customer.csv biedt gegevens die mogelijk ontbreken in Cisco BroadWorks of BroadCloud. Dit bestand kan leeg blijven als alle verplichte informatie al beschikbaar is. Je hoeft niet alle kolommen in te vullen, enkel de ontbrekende informatie is verplicht.

Onderstaande tabel legt de belangrijkste kolommen uit in input/customers.csv.

Uit te voeren instructies

Voer de Transform Tool uit in elk besturingssysteem. Gebruik de onderstaande stappen om het hulpprogramma in Windows en macOS uit te voeren:

Windows

Voer de opdracht hieronder uit om het transformatiehulpprogramma in Windows uit te voeren:

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

macOS

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

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

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

2. Voer de transformatietool uit:

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

Voorcontrole klant/gebruiker

Met het hulpprogramma Transformeren worden API-oproepen naar Webex geplaatst om mogelijke inrichtingsproblemen op te lossen. Standaard wordt het adres en het primaire e-mailadres van de klant gevalideerd. Als de PROVISIONING_ID-waarde is opgegeven in het bestand conf/partner.cfg, wordt ook de locatiegegevens gevalideerd. De resultaten van de precontrole worden opgenomen in het uitzonderingsrapport.

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

voorcontrole

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

precheckinfo

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

Terminallogboeken

De volgende logboeken in de terminal bij een geslaagde transformatie:

Overzichtsrapport BroadWorks-ondernemingen die met succes kunnen worden gemigreerd: 1 BroadWorks-ondernemingen die niet kunnen worden gemigreerd: 0 BroadWorks-gebruikers die met succes kunnen worden gemigreerd: 4 BroadWorks-gebruikers die niet kunnen worden gemigreerd: 0 Telefoons die kunnen worden gemigreerd: 3 Telefoons die niet compatibel zijn met Webex Calling: 0 

Uitzonderingsrapport

Transform Tool genereert het uitzonderingsrapport in de output//exception_report.txt directory. 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 extractie- en transformatietools opnieuw uit met de nieuwe gegevens. Het voorbeeldbestand van het uitzonderingsrapport is als volgt:

Uitzonderingsrapport di okt 18 08:12:09 2022 Bedrijven met communicatie Barring Feature Aanbeveling: het uitgaande belplan handmatig configureren in Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Output

Een output JSON (customer.json) bestand is beschikbaar in de output// directory. Het voorbeeldbestand customer.json is als volgt:

{ "customer": { "provisioningId": "!!!!!!!!!!VERVANGEN_MET_PROVISIONINGID!!!!!!!!!!", "packages": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "adres": { "addressLine1": "100 Main Street", "addressLine2": "", "stad": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "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", "taal": "en_us", "nummers": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info": { "service_provider_id": "collabmigationtestSP_engg", "group_id": "collabmigationtestGRP_engg" }, "abonnees": [ { "amareswaranvel+benjaminjack@gmail.com": { "abonnee": { "customerId": "!!!!!!!!!!VERVANGEN_MET_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": waar, 'sendBusyCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD' }, 'sendUnansweredCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD', 'aantal keren overgaan': 3 }, 'messageStorage': { 'mwiEnabled': true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!VERVANGEN_MET_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!VERVANGEN_MET_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": waar, 'sendBusyCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD' }, 'sendUnansweredCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD', 'aantal keren overgaan': 3 }, 'messageStorage': { 'mwiEnabled': true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!VERVANGEN_MET_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!VERVANGEN_MET_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": waar, 'sendBusyCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD' }, 'sendUnansweredCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD', 'aantal keren overgaan': 3 }, 'messageStorage': { 'mwiEnabled': true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" }} } ], "devices": [] }}, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!VERVANGEN_DOOR_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": waar, 'sendBusyCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD' }, 'sendUnansweredCalls': { 'ingeschakeld': waar, 'begroeting': 'STANDAARD', 'aantal keren overgaan': 3 }, 'messageStorage': { 'mwiEnabled': waar, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!VERVANGEN_MET_PERSONID!!!!!!!!!!", "product": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "schema's": [], "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": [], "locaties": [], "webex_for_broadworks_info": { "gebruikers": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

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

Voorwaarden

Configureer de volgende vereisten in de telefoonlijst van de inrichtingstool:

1. Installeer Java 8, 11 of 17 op de computer. Java is beschikbaar uit vele bronnen, waaronder:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Na het downloaden en extraheren van de binaire migratiehulpprogramma's stelt u de JAVA_HOME-omgevingsvariabele in de provisioning_tool.sh voor MAC en provisioning_tool.bat voor Windows in.
3. Het bestand partner.cfg:
   • Stel de WHOLESALE_PROVISIONING_ID en REFRESH_TOKEN in (token gekopieerd van de tool Token Generator). De partnerbeheerders moeten contact opnemen met hun accountteam om de PROVISIONING_ID op te halen:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Stel ALLOW_ADMIN_INVITE_EMAILS in op onwaar als de partner geen welkomstmail naar de gebruikers wil verzenden. Standaardwaarde is waar.

4. Gebruik WEBEX4BWKS_E-MAIL_ONDERWERPEIGENSCHAP voor Webex voor BroadWorks-migraties om het e-mailonderwerp voor het verzoek tot wijziging van het wachtwoord te verzenden voor Webex voor BroadWorks-abonnees.
5. Gebruik WEBEX4BWKS_EMAIL_BODY-eigenschap voor Webex voor BroadWorks-migraties om de e-mailtekst voor het verzoek tot wijziging van het wachtwoord te verzenden voor Webex voor BroadWorks-abonnees.

Voor BroadCloud-migraties dezelfde regio:

1. Met het hulpprogramma worden de nummers, apparaten en de inrichting voor gedeelde gespreksweergaven overgeslagen.
2. De tool maakt gebruikers en virtuele gebruikers met een toestel en een tijdelijk toestel.

Voor BroadCloud-migraties is er een andere regio:

1. Het hulpprogramma richt nummers, apparaten en weergaven voor gedeeld gesprek in.
2. De tool maakt gebruikers en virtuele gebruikers met werkelijke telefoonnummers en toestelnummers.
   Alle Europe BroadCloud-migraties zijn naar een andere regio.

Uit te voeren instructies

Gebruik de onderstaande stappen om het hulpprogramma in Windows en macOS uit te voeren:

Windows

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

Eén klant inrichten: provision.bat -input= Om meerdere klanten in te richten: provision.bat -input= 

macOS

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

Eén klant inrichten: ./transform.sh -input= Meerdere klanten inrichten: ./transform.sh -input= 

Vereisten voor Webex voor BroadWorks-migratie

Partnerbeheerders moeten hun BroadWorks-onboardsjabloon voor co-existentiefuncties van Webex voor BroadWorks bijwerken. Raadpleeg de onderstaande afbeelding:

Voer de inrichtingstool uit met een extra argument voor migratie van Webex voor BroadWorks naar groothandel.

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

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

Fase na de migratie: Is de laatste fase waar Beheerders de BroadWorks volledig kunnen converteren naar Wholesale. U moet de inrichtingstool uitvoeren met een argument postmigratie.

Terminallogboeken

Hieronder staan de logboeken in de terminal bij succesvolle inrichting:

Toolnaam: Versie inrichtingstool: 1.15.0 ********** Gestart met verwerken bestand: input/customer.json **************** Provisioning Klant Wacht op klant external_id_engg_grp1 om inrichting te voltooien... Wachten tot klant external_id_engg_grp1 de inrichting voltooit...   Status klant external_id_engg_grp1: inrichtingsnummers Inrichtingsgebruikersfuncties Inrichtingsbegroetingen Inrichtingsschema's Inrichtingsapparaten Gedeelde gespreksweergaven inrichten Virtuele operators inrichten Gesprekswachtrijen inrichten Hunt-groepen Inrichtingsgroeppagings Inrichten Gesprek parkeren Inrichten Gesprek aannemen Inrichten Spraakportal ********** Voltooid bestand: invoer/klant.json **************** 

Er wordt een tabel afgedrukt met het aantal aangemaakte locaties voor elke run:

Output

De inrichtingstool genereert succes- en foutrapporten in de output-/<external_id>/*.success/error -bestanden. Controleer de uitvoer- en foutenlogboeken om te controleren of de inrichting geslaagd is.

Partnerbeheerders kunnen de inrichting van de klant verifiëren 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: Bellen

Voor BroadCloud

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

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

De onderstaande cijfers tonen het portaal van de serviceprovider.

Afbeelding 12: Portal voor serviceproviders

Afbeelding 13: Portal voor serviceproviders

Voor Cisco BroadWorks en Webex voor BroadWorks

Voor Cisco BroadWorks- en Webex voor BroadWorks-migraties wordt het hulpprogramma uitgevoerd op de secundaire Cisco BroadWorks-toepassingsserver binnen het partnernetwerk en maakt het verbinding met het AS via OCI-P. Het gebruikt het JSON-bestand (customer.json) voor de uitvoer van de transformatietool als invoer en voert de OCI-P-opdrachten uit om apparaten en softclients te migreren.

Bij een succesvolle werking zal het hulpprogramma voor het verplaatsen van het apparaat:

1. Verbreek de registratie van apparaten van Cisco BroadWorks en registreer deze in de groothandel.
2. Gebruikers die de UC-One-client gebruiken, worden bij de eerste aanmelding omgeleid naar de Webex-app.
3. Deactiveer de telefoonnummers van Cisco BroadWorks of verwijder de telefoonnummers van BroadCloud.
4. Nummers in Groothandel activeren.
5. Gedeelde gespreksweergaven maken in de groothandel voor BroadCloud-migraties. [Deze stap is alleen van toepassing op BroadCloud-migraties].

SCP en SSH

1. SCP het hulpprogramma voor apparaatmigratie naar de secundaire Cisco BroadWorks-toepassingsserver.
2. SSH naar de secundaire Cisco BroadWorks-toepassingsserver om de vereisten te configureren en het hulpprogramma voor apparaatmigratie uit te voeren.

Voorwaarden

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

   VERNIEUWEN_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost 

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom-telefoons

Als u Polycom-telefoons wilt verplaatsen van Cisco BroadWorks naar Wholesale Calling, moet een partnerbeheerder een nieuw identiteits-/apparaatprofieltypebestand maken op systeemniveau in Cisco BroadWorks elke Polycom-apparaatsjabloon. Raadpleeg figuur 14 en upload het aangepaste bestandsbestand device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Nadat u het nieuwe apparaatbestand hebt geüpload, moet u ervoor zorgen dat het nieuwe bestand op groepsniveau bestaat. Zorg er ook voor dat bestand migration_%BWMAC ADDRESS%.cfg niet conflicteert met een bestaand bestand in uw systeem).

Het wordt intern gebruikt door het hulpprogramma voor het verplaatsen van het apparaat.

Het migratieproces voor Polycom-telefoons:

1. Het hulpprogramma voor apparaatbewegingen vervangt bestand %BWMACADDRESS%.cfg op apparaatniveau met polycom_vvx2.cfg. Dit bestand verwijst naar migration_%BWMACADDRESS%.cfg.
2. Maak de apparaatprofielen opnieuw op groepsniveau of op apparaatniveau.
   Handelen op groepsniveau of apparaatniveau hangt af van de configuratie van parameter deviceLevelRebuild in file device-move-tool/conf/partner.cfg.
3. Het hulpprogramma voor apparaatverplaatsing vraagt de Cisco BroadWorks-toepassingsserver om telefoons opnieuw op te starten op groepsniveau of op apparaatniveau.
4. Na het verzoek om opnieuw op te starten, downloaden en verwerken van Polycom-telefoons% BWMACADDRESS%.cfg, waarbij de Polycom-telefoons wordt gevraagd om te downloaden en te verwerken migration_%BWMACADDRESS%.cfg, waarbij het apparaat.prov.serverName wordt ingesteld op https://plcm.sipflash.com.
   https://plcm.sipflash.com voor de regio van de VS hebben andere regio's verschillende URL's.
5. De Polycom-telefoon downloads %BWMACADDRESS%.cfg vanaf https://plcm.sipflash.com en wordt beheerd door het Webex Calling DMS.

Afbeelding 14: Bestand met type identiteit/apparaatprofiel toevoegen

Uit te voeren instructies

Er zijn twee methoden om de DMT in te roepen, de eerste is door één klant tegelijk in te roepen en de andere is door meerdere klanten tegelijk te lopen.

Het hulpprogramma voor apparaatverhuizing wordt uitgevoerd vanaf de secundaire Cisco BroadWorks-toepassingsserver in de map met apparaatverhuizing:

Voor device move single customer: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Voor device move multiple customers: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Daarnaast ondersteunt de device move tool het migreren van één/specifieke telefoon(s) uit 1.35.0 release. Gebruik de onderstaande opdracht: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminallogboeken

Hieronder staan de logboeken van de terminal waarop het hulpprogramma Apparaatverplaatsing voor apparaatmigratie is uitgevoerd:

Toolnaam: Versie van hulpprogramma voor apparaatverhuizing: 1.15.0 Apparaattool gestart... Geldige apparaten voor migratie: ------------------------------------------------------------------------------------------------------------------- | Apparaattype | Mac | Versie | E-mail | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Wilt u al deze apparaten migreren? ([Y]es of [N]o) ja Het uploaden van apparaatprofielen voor DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Completed 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 Activeer het proces voor Webex-telefoonnummers die zijn voltooid voor de organisatie-id van de klant: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Het proces voor het deactiveren van Broadworks-telefoonnummers is gestart voor groupId: collabmigrationtestGRP_engg Het proces voor het deactiveren van BroadWorks-telefoonnummers is voltooid voor GroupId: collabmigrationtest_engg GRP-apparaatmigratie voltooid 

Output

Na de apparaatmigratie zijn apparaten online gekomen en klaar om te bellen/gebeld te worden. Zie afbeelding 15 voor een voorbeeld van de apparaatstatus:

Afbeelding 15: Apparaatstatus

Na de migratie van het apparaat zijn de nummers actief geworden. Zie afbeelding 16 voor een voorbeeld van actieve nummers:

Afbeelding 16: Nummers actief

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

Voor BroadCloud-provider

Het omkeerproces voor BroadCloud-partners ziet er als volgt uit:

1. Open een ticket met Cisco TAC om te verzoeken dat het apparaat wordt teruggezet.
2. Voer het hulpprogramma voor het verplaatsen van het apparaat uit in de modus Terugzetten:
   • Telefoonnummers worden niet toegewezen aan Webex Calling, waardoor gebruikers en services alleen toestelnummers hebben.
   • E-mailadressen in Webex Calling worden teruggezet naar tijdelijke e-mailadressen.
   • Telefoons worden verwijderd uit Webex Calling.
   • Telefoonnummers, e-mailadressen die als alternatedIds worden gebruikt en telefoons worden opnieuw gemaakt in BroadCloud.
   • De telefoons worden opnieuw opgestart.
3. Partnerbeheerders moeten PSTN-telefoonnummers terugzetten naar BroadCloud-provider.

Voor Cisco BroadWorks en Webex voor BroadWorks

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

1. Open een ticket met Cisco TAC om te verzoeken dat het apparaat wordt teruggezet.
2. Voer het hulpprogramma Apparaatbeweging uit op de modus Terugzetten op de secundaire BroadWorks-toepassingsserver om de apparaatmigraties terug te zetten. Hiermee wordt de DMS-URL teruggezet naar de DMS-URL van de serviceprovider voor apparaatprofielen in Cisco BroadWorks en worden telefoonnummers opnieuw geactiveerd.
3. Het Webex Calling-team stelt de DMS-URL terug in op de DMS-URL van de serviceprovider in apparaatprofielen in Webex Calling.
4. Partnerbeheerders moeten de telefoonnummers in Webex Calling deactiveren of verwijderen via de Control Hub-portal.
5. Partnerbeheerders moeten PSTN-telefoonnummers terugzetten naar Cisco BroadWorks.

Instructies voor het uitvoeren van het hulpprogramma voor apparaatbeweging in de modus Terugzetten

Volg de onderstaande stappen om het hulpprogramma voor apparaatbeweging in de terugschakelmodus uit te voeren:

Voer de onderstaande opdracht uit in de secundaire Cisco BroadWorks-toepassingsserver in de map met het hulpprogramma Apparaat verplaatsen:

Profielen terugzetten

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

Nummers terugzetten

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

Terminallogboeken

We krijgen de volgende logboeken in de terminal bij succesvolle uitvoering van het hulpprogramma voor het verplaatsen van het apparaat voor het terugzetten:

Profielen terugzetten

Toolnaam: Versie van hulpprogramma voor apparaatverhuizing: 1.15.0 Apparaattool gestart voor terugzetten proces... Apparaten die kunnen worden teruggezet van Webex Calling naar BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Apparaattype | Mac | versie | E-mail | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Wilt u deze apparaten terugzetten van Webex Calling naar BroadWorks? (Ja, J, Nee, N):  ja Uploaden van apparaatprofielen voor DMS Cisco MPP LC Opnieuw opbouwen apparaatproces gestart Opnieuw opbouwen apparaatproces voltooid Opnieuw opstarten Proces gestart Opnieuw opstarten Proces voltooid Apparaatmigratie voltooid voor deinderingsproces 

Nummers terugzetten

Toolnaam: Versie van hulpprogramma voor apparaatverhuizing: 1.15.0 Wilt u doorgaan met het terugzetten van nummers naar Broadworks?  ([J]en of [N]o):  J [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Begin met terugzetten Activeer broadworks telefoonnummers proces gestart voor groepId: collabmigrationtestGRP_engg Het proces voor het activeren van BroadWorks-telefoonnummers is voltooid voor groupId: collabmigrationtest_engg GRP-apparaatmigratieproces met succes voltooid