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

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

Partnerbeheerders voeren dit hulpprogramma voor het genereren van tokens ten minste één keer uit voordat ze de migratiehulpprogramma's starten. Deze tool wordt uitgevoerd als eenmalige activiteit nadat het partneraccount is geïntegreerd in de Wholesale RTM-oplossing. Met dit hulpprogramma kunnen partnerbeheerders zich via de webbrowser aanmelden om het unieke TOKEN op te halen dat nodig is om bij te werken naar de partnerconfiguratiebestanden voor de migratiehulpprogramma's.

Voorwaarden

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

Stel het pad van de JRE/JDK-omgeving in op token_generator.sh voor MAC en token_generator.bat voor Windows. 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 het hulpprogramma 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 referenties van de partnerbeheerder om het TOKEN op te halen en kopieer het voor verder gebruik.

Hieronder vindt u ter referentie de illustraties van de gebruikersinterface:

Afbeelding 3: Inloggen met Cisco Webex

Afbeelding 4: Venster Aanmeldgegevens

Afbeelding 5: Tokengeneratie

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

OCI-P-verbinding inschakelen

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

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

Wijzig de map naar OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> ingeschakeld worden = waar enabledLoginLevelScreening = false enableResponseCaching = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 messageQueueCapacity = 50 messageQueueTimeoutSeconds = 1800 

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

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

Wijzig naar de inrichtingsdirectory:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

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

 AS_CLI/Maintenance/ManagedObjects> krijgt u broadworks en controleert u of uw uitvoer er goed uitziet. Zie hieronder voor een voorbeelduitvoer: AS_CLI/Maintenance/ManagedObjects> BroadWorks-beheerde objecten ophalen ========================== * Server: Identiteit..............: AS-versie...............: Rel_21.sp1_1.551 Administratieve status..: Ontgrendelde * toepassingen: Naamversie Geïmplementeerde beheerstatus Effectieve uitvoeringEnProvisioning ========================================================================================= 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 vermeldingen gevonden. * Gehoste toepassingen: Naamversie Contextpad 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 vermeldingen gevonden. 

Controleren of open clientserver is geïmplementeerd en actief is

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

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

AS_CLI/Maintenance/ManagedObjects> 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 nummeractiviteit uit:

AS_CLI> cd SubscriberMgmt/NumberActivation

Stap 2: Voer de opdracht Activering ingeschakeld uit:

AS_CLI> dnMode groupAndUserActivationEnabled instellen

Stap 3: Voer bij de bevestigingsprompt J in.

Voor BroadCloud

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

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

De onderstaande figuren geven de serviceproviderportal weer.

Afbeelding 6: Serviceproviderportal

Afbeelding 7: Serviceproviderportal

Voor Cisco BroadWorks en Webex voor BroadWorks

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

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

Voorwaarden

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

   Serviceprovider-id:      - GroepID-A1 - GroepID-A2 - GroepID-A3 ServiceProviderID-B:                        - alles 

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

   BROADWORKS_GEBRUIKERS_ID = beheerder BROADWORKS_WACHTWOORD = beheerder BROADWORKS_HOST_NAAM = localhost VERNIEUWEN_TOKEN = Vernieuwingstoken voor partnerbeheerder gekopieerd uit het hulpprogramma Tokengenerator. 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 TOKEN_VERNIEUWEN 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 Cisco BroadWorks Application Server anders is dan het bestand:

   JAVA_HOME=/usr/local/java/java_base

Uit te voeren instructies

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

./export.sh

Terminallogboeken

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

 BroadSoft Data Export Tool wordt uitgevoerd ************************************************ Exporttool wordt gestart v: 1.15.0 Export gestart voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Gebruikers exporteren voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Gebruikers exporteren voltooid voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exporteren voltooid voor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exporteren voltooid Export Dump Zip Directory: output/20221017223452_ExportTool Export Dump Zip-bestandsnaam:extracted_data_1666060500618.zip Zipbestand met de naam extracted_data_1666060500618.zip is gemaakt Proces voor het maken van zipbestand voltooid Geëxporteerde bestanden geconverteerd als zipbestand ************************************************** 

Output

Een output-ZIP-bestand (extracted_data_.zip) is beschikbaar in dezelfde map met uitpakken-hulpprogramma's. Gebruik de onderstaande opdracht om het ZIP-bestand weer te geven en te gebruiken voor de invoer van het transformatiehulpprogramma:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 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 uitvoer/drwxrwxr-x 2 bwadmin bwadmin 4096 okt 17 22:34 logboeken/ -rw-rw-r-- 1 bwadmin bwadmin 46341 okt 17 22:35 extracted_data_1666060500618.zip 

Deze transformatietool wordt uitgevoerd voor alle migraties. De transformatietool wordt op elke computer uitgevoerd, inclusief de laptop van de beheerder van een partner en gebruikt de openbare API's van Webex. Het leest het ZIP-bestand uit de uitpakken-tool (extracted_data_.zip) als een invoer en transformeert de onbewerkte XML in een JSON-indeling die wordt gebruikt door de inrichtingstool.

Voorwaarden

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

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

   VERNIEUWEN_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj-NAAM_VAN_HOOFDLOCATIE_LOCATIE=Hoofd

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

   INRICHTING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

De invoer/customers.csv invullen

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

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

Uit te voeren instructies

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

Windows

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

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

macOS

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

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

   python3 -m venv venv source venv/bin/activate python3 -m pip installatieaanvragen python3 -m pip installatieaanvragen-oauthlib 

2. Voer de transformatietool uit:

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

Controle vooraf door klant/gebruiker

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

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

vooraf controleren

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

pre fo

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

Terminallogboeken

De volgende logboeken in de terminal bij een succesvolle transformatie:

Overzichtsrapport BroadWorks-bedrijven die kunnen worden gemigreerd: 1 BroadWorks-bedrijven die niet kunnen worden gemigreerd: 0 BroadWorks-gebruikers die 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

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

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

Uitzonderingsrapport di 18 okt 08:12:09 2022 Bedrijven met communicatieblokkering functieaanbeveling: het uitgaande belplan handmatig configureren in Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Output

Een JSON-uitvoerbestand (customer.json) is beschikbaar in de map output// . Het voorbeeld van het bestand customer.json is als volgt:

{ "customer": { "provisioningId": "!!!!!!!!!!VERVANGEN_met_PROVISIONINGID!!!!!!!!!!", 'pakketten': [ 'webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "adres": { "addressLine1": "100 hoofdstraat", "addressLine2": "", "stad": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "VS" }, "customerInfo": { "name": "Engineering Group - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "location": { "name": "Main", "adres": { "addressLine1": "100 hoofdstraat", "addressLine2": "", "stad": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "land": "VS" }, "tijdzone": "Amerika/New_York", "taal": "en_us", "nummers": [ "+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": "!!!!!!!!!!VERVANGEN_met_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "toestel": "1102" } }, "functies": [ { "/v1/people/{personId}/features/voicemail": { "ingeschakeld": waar, "sendBusyCalls": { "ingeschakeld": waar, "begroeting": "STANDAARD" }, "sendUnansweredCalls": { "ingeschakeld": waar, "begroeting": "STANDAARD", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externEmail": "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", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externEmail": "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", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externEmail": "engineeringmacpc@mailnator.com" } } ], "apparaten": [] }}, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!VERVANGEN_MET_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "toestel": "1101" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": waar, "sendBusyCalls": { "ingeschakeld": waar, "begroeting": "STANDAARD" }, "sendUnansweredCalls": { "ingeschakeld": waar, "begroeting": "STANDAARD", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externalEmail": "engineering8811@mailnator.com" } } } ], "apparaten": [ { "cisUuid": "!!!!!!!!!!VERVANGEN_met_PERSONID!!!!!!!!!!", "product": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "planningen": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Geautomatiseerde spraakportal", "firstName": "Geautomatiseerd", "lastName": "Spraakportal", "languageCode": "en_us", "phoneNumber": "+15205551105", "toestel": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg-apparaatprofiel" ], "connect_client_to_upgrade_to_webex_app": [], "locaties": [], "webex_for_broadworks_info": { "users": [{ "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

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

Voorwaarden

Configureer de volgende vereisten in de directory van de inrichtingstool:

1. Installeer Java 8, 11 of 17 op de computer. Java is verkrijgbaar in vele bronnen, waaronder:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Stel na het downloaden en uitpakken van de binaire bestanden van de migratietools de JAVA_HOME-omgevingsvariabele in op provisioning_tool.sh voor MAC en provisioning_tool.bat voor Windows.
3. Het bestand partner.cfg:
   • Stel de WHOLESALE_PROVISIONING_-id en het VERNIEUWINGSTOKEN_ in (Token gekopieerd uit het hulpprogramma Tokengenerator). De partnerbeheerders moeten contact opnemen met het accountteam om de inrichtings-id_op te halen:

     GROOTHANDEL_INRICHTING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 VERNIEUWEN_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. Gebruik de WEBEX4BWKS_E-MAIL_ONDERWERP-eigenschap voor Webex for BroadWorks-migraties om de e-mailonderwerp voor de aanvraag voor het wijzigen van het wachtwoord voor Webex for BroadWorks-abonnees te verzenden.
5. Gebruik de WEBEX4BWKS_EMAIL_BODY-eigenschap voor Webex for BroadWorks-migraties om de e-mailtekst voor de aanvraag voor het wijzigen van het wachtwoord voor Webex voor BroadWorks-abonnees te verzenden.

Voor BroadCloud-migraties in dezelfde regio:

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

Voor BroadCloud-migraties naar een andere regio:

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

Uit te voeren instructies

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

Windows

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

Eén klant inrichten: provision.bat -input= Meerdere klanten inrichten: provision.bat -input= 

macOS

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

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

Vereisten voor migratie van Webex for BroadWorks

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

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

Voer de inrichtingstool uit met een extra argument.

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

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

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

Terminallogboeken

Hieronder vindt u de logboeken in de terminal bij succesvolle inrichting:

Toolnaam: Versie inrichtingstool: 1.15.0 ********** Bezig met verwerken van bestand: input/customer.json Inrichten **************** Klant Wachten tot klant external_id_engg_grp1 het inrichten heeft voltooid... Wachten tot klant external_id_engg_grp1 het inrichten heeft voltooid...   Status external_id_engg_grp1: inrichtingsnummers inrichten gebruikers inrichten gebruikersfuncties inrichten begroetingen inrichtingsplanningen inrichtingsapparaten inrichten gedeelde gespreksweergaven inrichten automatische beantwoorders inrichten gesprekswachtrijen inrichten hunt-groepen inrichten groep pagings inrichten gesprek parken inrichten aangenomen gesprekken inrichten spraakportal ********** voltooid bestand: invoer/klant.json **************** 

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

Output

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

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

Afbeelding 8: Partnerhub

Afbeelding 9: Control Hub

Afbeelding 10: Apparaten

Afbeelding 11: Bellen

Voor BroadCloud

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

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

De onderstaande figuren geven de serviceproviderportal weer.

Afbeelding 12: Serviceproviderportal

Afbeelding 13: Serviceproviderportal

Voor Cisco BroadWorks en Webex voor BroadWorks

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

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

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

SCP en SSH

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

Voorwaarden

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

   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_GEBRUIKERS_ID = beheerder BROADWORKS_WACHTWOORD = beheerder BROADWORKS_HOST_NAAM = localhost 

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

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

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom-telefoons

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

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

Het migratieproces voor Polycom-telefoons:

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

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

Uit te voeren instructies

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

Het verplaatsingstool voor apparaten wordt uitgevoerd vanaf de secundaire Cisco BroadWorks-toepassingsserver in de map voor het verplaatsingstool voor apparaten:

Voor apparaat verplaatsen van één klant: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Voor apparaat verplaatsen van meerdere klanten: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Daarnaast ondersteunt het apparaat verplaatsen het migreren van één/specifieke telefoon(s) vanaf de release 1.35.0. Gebruik de onderstaande opdracht: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminallogboeken

Hieronder staan de logboeken in de terminal wanneer het verplaatsingshulpprogramma voor apparaatmigratie is uitgevoerd:

Toolnaam: Versie van het hulpmiddel voor het verplaatsen van apparaten: 1.15.0 Apparaathulpprogramma 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? ([J]en of [N]o) ja Apparaatprofielen uploaden voor DMS Cisco MPP LC Proces voor opnieuw opbouwen Gestart Proces voor opnieuw opbouwen Voltooid Proces voor opnieuw opstarten Proces voor opnieuw opstarten Voltooid Profielen voor Business Communicator onder groep collabmigrationtestGRP_engg Proces voor Webex-telefoonnummers activeren gestart voor klantorganisatie-id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Proces voor het activeren van Webex-telefoonnummers is voltooid voor klantorganisatie-id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Proces voor BroadWorks-telefoonnummers deactiveren gestart voor groeps-id: collabmigrationtestGRP_engg Proces BroadWorks-telefoonnummers deactiveren voltooid voor groupId: collabmigrationtestGRP_engg -apparaatmigratie voltooid 

Output

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

Afbeelding 15: Apparaatstatus

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

Afbeelding 16: Actieve nummers

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

Voor BroadCloud-provider

Het terugzetproces voor BroadCloud-partners is als volgt:

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

Voor Cisco BroadWorks en Webex voor BroadWorks

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

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

Instructies om het verplaatsingshulpprogramma uit te voeren in de terugvalmodus

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

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

Profielen terugzetten

./devicemove.sh -input=  -revertProfiles

Nummers terugzetten

./devicemove.sh -input=  -revertNumbers

Terminallogboeken

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

Profielen terugzetten

Toolnaam: Versie van het hulpmiddel voor het verplaatsen van apparaten: 1.15.0 Apparaathulpprogramma gestart voor terugzetten... Apparaten die terug kunnen worden verplaatst 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 terugverplaatsen van Webex Calling naar BroadWorks? (Ja, J, Nee, N):  ja Apparaatprofielen uploaden voor DMS Cisco MPP LC Proces voor opnieuw opbouwen gestart Proces voor opnieuw opbouwen Proces voor opnieuw opbouwen Proces voor opnieuw opstarten Proces voor opnieuw opstarten Proces voor opnieuw opstarten Succesvol Apparaatmigratie voltooid voor proces voor inrichten 

Nummers terugzetten

Toolnaam: Versie van het hulpmiddel voor het verplaatsen van apparaten: 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] Terugzetten starten Proces voor BroadWorks-telefoonnummers activeren gestart voor groeps-id: collabmigrationtestGRP_engg Proces BroadWorks-telefoonnummers activeren voltooid voor groeps-id: collabmigrationtestGRP_engg Apparaatmigratie Terugzetten proces voltooid