Migrationstools für den Übergang von BroadWorks, Webex für BroadWorks und BroadCloud zu Wholesale RTM-Lösungen

Unterstützte Telefone werden automatisch erstellt und Benutzern in Webex Calling mit dem Bereitstellungstool zugewiesen. Die Telefone, die in der Spalte „Unterstützt im Tool zum Verschieben des Geräts“ mit „Ja“ gekennzeichnet sind, werden auch automatisch von Cisco BroadWorks oder BroadCloud zu Webex Calling verschoben, wenn das Tool zum Verschieben des Geräts ausgeführt wird. Telefone, die in dieser Spalte mit „Nein“ gekennzeichnet sind, benötigen einen manuellen Eingriff, um die DMS-URL in der Cisco BroadWorks-Gerätevorlage oder auf dem Telefon selbst zu ändern.

Die letzte Spalte stellt die Zuordnung von Telefonmodellen zur Spalte „Gerätetyp“ der Datei transform-tool/input/newphones.csv bereit. (Siehe Transformations-Tool Abschnitt dieses Artikels für weitere Informationen über newphones.csv).

Partner-Administratoren führen dieses Dienstprogramm für den Token-Generator mindestens einmal aus, bevor sie mit der Ausführung von Migrationstools beginnen. Das Ausführen dieses Tools ist eine einmalige Aktivität, nachdem das Partnerkonto in die Wholesale RTM-Lösung integriert wurde. Dieses Tool ermöglicht es Partneradministratoren, sich über einen Webbrowser anzumelden, um das eindeutige TOKEN zu erhalten, das für die Aktualisierung auf die Partnerkonfigurationsdateien für die Migrationstools erforderlich ist.

Voraussetzungen

Extrahieren Sie nach dem Download die Migrationstool-Binärdateien.

Legen Sie den JRE/JDK-Umgebungspfad in der token_generator.sh für MAC und token_generator.bat für Windows fest. Wenn JAVA _ HOME-Pfad bereits vorhanden ist, wird er vom Tool wiederverwendet.

• MAC: JAVA _ HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA _ HOME=C:\Progra~1\Java\jre1.8.0 _ 321

Anweisungen zum Ausführen

Führen Sie den folgenden Befehl im Terminal im Token-Generatorverzeichnis aus:

Windows:

token_generator. Fledermaus

MacOS:

./token_generator.sh 

Ausgabe:

Werkzeugname: Version des Token Generator-Tools: 1.13.0 Laden Sie die URL in Ihren Webbrowser: http://localhost:8080 

Öffnen Sie die URL im Webbrowser auf dem Terminal, melden Sie sich mit den Anmeldeinformationen des Partneradministrators an, um das TOKEN zu erhalten und kopieren Sie dasselbe für die weitere Verwendung.

Die Abbildungen der Benutzeroberfläche dienen als Referenz:

Abbildung 3: Mit Cisco Webex anmelden

Abbildung 4: Anmeldeinformationen-Fenster

Abbildung 5: Token-Generierung

Konfigurieren Sie die folgenden Schritte, bevor Sie die Tools zum Extrahieren und Verschieben des Geräts auf dem sekundären BroadWorks-Server ausführen.

OCI-P-Konnektivität aktivieren

Das Tool zum Verschieben des Geräts kommuniziert über OCI-P-Befehle mit BroadWorks. Führen Sie die folgenden Schritte aus, um die OCI-P-Konnektivität zu aktivieren:

Schritt 1 : Verwenden Sie die CLI, um allgemeine Einstellungen zu konfigurieren.

Führen Sie den folgenden Befehl in CLI aus, um zum Verzeichnis GeneralSettings zu wechseln:

 AS _ CLI> cd /Applications/OpenClientServer/GeneralSettings.

Führen Sie den folgenden Befehl in CLI aus, um die aktuellen Generaleinstellungen abzurufen:

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

Wenn Ihre Einstellungen nicht mit den oben genannten übereinstimmen, verwenden Sie den Befehl set , um Ihre Einstellungen neu zu konfigurieren.

Schritt 2 : Verwenden Sie die CLI, um den OCI-Proxy zu konfigurieren.

Ändern Sie das Verzeichnis in OCI-Proxy:

 AS _ CLI> cd /Applications/OpenClientServer/OCIProxy 

Führen Sie die folgende CLI aus, um die aktuellen Einstellungen abzurufen. Folgendes sollte angezeigt werden:

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

Wenn Ihre Einstellungen nicht mit den oben genannten übereinstimmen, verwenden Sie den Befehl set , um Ihre Einstellungen neu zu konfigurieren.

Schritt 3 : Verwenden Sie die CLI zum Konfigurieren der OCI-Bereitstellung.

In das Bereitstellungsverzeichnis ändern:

 AS _ CLI> cd/System/NetworkAccessLists/OCI/Provisioning 

Führen Sie den folgenden Befehl aus, um die aktuellen OCI-Bereitstellungseinstellungen abzurufen:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> Adressbeschreibung ======================== 127.0.0.1 lokal abrufen als 

Schritt 4 : Führen Sie den folgenden Befehl in CLI aus, um zu überprüfen, ob Ihre Konfiguration korrekt ist.

 AS _ CLI/Maintenance/ManagedObjects> erhalten Broadworks und überprüfen, ob Ihre Ausgabe OK aussieht. Siehe unten für Beispielausgabe: ALS _ CLI/Maintenance/ManagedObjects> BroadWorks BroadWorks Managed Objects ========================== * Server abrufen: Identität ..............: ALS Version ...............: R el_ 21.sp1 _ 1.551 Verwaltungsstatus: Entsperrt * Anwendungen: 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 Einträge gefunden. * Hosted Applications: Name Version Kontext Pfad Bereitgestellt ================================================================== 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 Einträge gefunden. 

Offenen Client-Server bereitgestellt und aktiv überprüfen

Verwenden Sie die folgenden Befehle, um den Open Client Server auf dem sekundären Anwendungsserver bereitzustellen und zu starten, wenn er nicht bereitgestellt wird oder noch nicht gestartet wurde.

Schritt 1 : Stellen Sie den Server mit dem folgenden CLI-Befehl bereit:

AS_CLI/Maintenance/ManagedObjects> Anwendung OpenClientServer bereitstellen

Schritt 2 : Starten Sie den Server mit diesem Befehl:

AS_CLI/Maintenance/ManagedObjects> Anwendung OpenClientServer starten

Aktivierung von Nummern aktivieren

Führen Sie die folgenden Befehle in CLI aus, um die Aktivierung der Nummern zu aktivieren:

Schritt 1 : Führen Sie den Befehl Nummernaktivierung aus:

 AS _ CLI> cd SubscriberMgmt/NumberActivation 

Schritt 2 : Führen Sie den Befehl „Aktivierung aktiviert“ aus:

 AS _ CLI> dnMode groupAndUserActivationEnabled festlegen 

Schritt 3 : Geben Sie bei der Bestätigungsaufforderung Y ein.

Für BroadCloud

Das Extrakt-Tool ist in das BroadCloud Service Provider-Portal integriert. Ein Dienstanbieteradministrator kann:

1. Senden Sie Extrakt-Anfragen für bis zu 50 Kunden pro Anfrage.
   Extrahierungsanforderung kann nicht mehr als 10 Mal pro Tag für denselben Kunden eingereicht werden.
2. Laden Sie die extrahierte Datendatei im ZIP-Format für bis zu 28 Tage ab Einreichung der Anfrage herunter.

Die folgenden Zahlen zeigen das Service Provider-Portal.

Abbildung 6: Dienstleisterportal

Abbildung 7: Dienstleisterportal

Für Cisco BroadWorks und Webex für BroadWorks

1. Das Extrakt-Tool wird auf dem sekundären Cisco BroadWorks-Anwendungsserver im Partnernetzwerk ausgeführt und stellt eine Verbindung über OCI-P her.
2. Das Tool ruft Rohdaten von Unternehmen, Gruppen, Nummern, Benutzern, Diensten, Geräten und Soft Clients von der Cisco BroadWorks- oder BroadCloud-Plattform ab und gibt diese Daten in XML-Dateien aus, die die Eingaben für das Transformationstool bereitstellen.

In den nächsten Abschnitten wird erläutert, wie das Extrakt-Tool installiert und konfiguriert wird.

Voraussetzungen

1. SCP das Extrakt-Tool binäriert an den sekundären Cisco BroadWorks-Anwendungsserver.
2. SSH an den sekundären Cisco BroadWorks-Anwendungsserver senden, um die Voraussetzungen zu konfigurieren und das Extrakt-Tool auszuführen.
3. Konfigurieren Sie die Dienstanbieter- und Gruppen-ID zum Extrahieren aus Cisco BroadWorks in conf/exportTool.yml. Siehe das folgende Beispiel YAML Schnipsel:

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

4. Stellen Sie sicher, dass die sekundäre Benutzer-ID, das Kennwort und der Host-Name des Cisco BroadWorks-Anwendungsservers in der Datei conf/partner.cfg korrekt sind:

    BROADWORKS _ USER _ ID = admin BROADWORKS _ PASSWORD = admin BROADWORKS _ HOST _ NAME = localhost REFRESH _ TOKEN = Aktualisierungs-Token des Partneradministrators, der vom Token Generator-Tool kopiert wurde. MIGRATION _ MODE = Unterstützte Werte sind webex_for_broadworks_to_wholesale. Der Standardwert ist broadworks_to_wholesale. Verwenden Sie webex_for_broadworks_to_wholesale für Webex für BroadWorks-Migrationen. 

   Die Eigenschaft REFRESH _ TOKEN ist für eine Webex für BroadWorks-Migration obligatorisch.

5. Ändern Sie den JDK/JRE-Umgebungspfad in der export.sh-Datei, wenn sich der sekundäre JDK/JRE-Umgebungspfad des Cisco BroadWorks-Anwendungsservers von der Datei unterscheidet:

    JAVA _ HOME=/usr/local/java/java_base

Anweisungen zum Ausführen

Führen Sie den folgenden Befehl im sekundären Cisco BroadWorks-Anwendungsserver aus dem Verzeichnis des Extrakt-Tools aus:

./export.sh

Terminalprotokolle

Die folgenden Protokolle sind beim erfolgreichen Export im Terminal verfügbar: Ausführen des BroadSoft Data Export-Tools:

 Ausführen des BroadSoft Data Export-Tools ************************************************ Starten des Export-Tools v: 1.15.0 Export gestartet für SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Benutzer exportieren für SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Benutzer exportieren abgeschlossen für SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Export abgeschlossen für SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Export abgeschlossen Export Dump Zip Directory : output/20221017223452 _ ExportTool Export Dump Zip Dateiname:extracted_data_1666060 500618.zip Zip-Datei mit dem Namen extracted_data_1666060 500618.zip wurde erstellt ZIP-Datei Erstellungsprozess abgeschlossen Exportierte Dateien als ZIP-Datei konvertiert ************************************************** 

Ausgabe

Eine ZIP-Ausgabedatei (extracted_data_.zip ) ist im gleichen Verzeichnis des Ausgabetools verfügbar. Verwenden Sie den folgenden Befehl, um die ZIP-Datei für die Transform Tool-Eingabe anzuzeigen und zu verwenden:

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 17. Oktober 22:34 output/ drwxrwxr-x 2 bwadmin bwadmin 4096 17. Oktober 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 17. Oktober 22:35 extracted_data_1666060 500618.zip 

Dieses Transformationstool wird für alle Migrationen ausgeführt. Das Transformationstool wird auf jedem Computer ausgeführt, einschließlich des Administratorlaptop eines Partners, und verwendet die öffentlichen Webex-APIs. Sie liest die ZIP-Datei (extracted_data_.zip ) des Extraktwerkzeugs als Eingabe und wandelt die rohe XML in ein JSON-Format um, das vom Bereitstellungstool verwendet wird.

Voraussetzungen

Konfigurieren Sie nach dem Herunterladen und Extrahieren der Migrationstools-Binärdateien die folgenden Voraussetzungen:

1. Legen Sie den REFRESH _ TOKEN (Token aus dem Token Generator Tool kopiert) und den NAMEN _ OF _ MAIN _ LOCATION in der Datei conf/partner.cfg fest:

    REFRESH _ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME _ VON _ HAUPTSTANDORT _ Main 

2. Legen Sie optional die Provisioning _ -ID (aus der Vorlage in Partner Hub kopiert) in der Datei conf/partner.cfg fest:

    BEREITSTELLUNG _ ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1 

   Um eine umfassendere Verifizierung der Kunden-E-Mail-Adresse zu erhalten, können Sie optional die BEREITSTELLUNGS-ID _ festlegen.
3. Konfigurieren Sie fehlende Informationen in der Datei input/customers.csv (siehe nächster Abschnitt), falls diese fehlen.
4. Fügen Sie die E-Mail-Adresse des Endbenutzers in die Datei input/users.csv ein.
5. Wenn neue Telefone bereitgestellt werden sollen, fügen Sie die MAC-Adresse und die E-Mail-Adresse des neuen Telefons des Benutzers zur Eingabe-/newphones.csv-Datei hinzu. Dies ist nur erforderlich, wenn die Partneradministratoren neue Telefone für Wholesale Calling bereitstellen möchten.
6. Konvertieren Sie die BroadWorks Call Center mit der Datei input/cxessentials.csv in CxEssentials.
7. Aktivieren Sie optional die Eigenschaft UPGRADE _ ALL _ CALL _ CENTER _ TO _ CX _ ESSENTIALS, um alle Call Center in CxEssentials zu konvertieren.
8. Verwenden Sie die Datei input/locations.csv zur Unterstützung der Migration großer Unternehmen, bei der Administratoren die Standorte ihrer Kunden nach Standort migrieren können.
9. Aktivieren Sie optional die Verwendung von MAC-Adressen über den Header „User-Agent“ der SIP REGISTER-Nachricht, wenn die MAC-Adresse im Cisco BroadWorks-Geräteprofil nicht verfügbar ist. Entkommentieren Sie die Zeile "USE _ MAC _ ADDRESS _ FROM _ SIP _ REGISTER=yes" in der Datei conf/partner.cfg

Eingabe/customers.csv wird aktualisiert

Die Dateieingabe/customers.csv enthält Daten, die möglicherweise in Cisco BroadWorks oder BroadCloud fehlen. Diese Datei kann leer bleiben, wenn bereits alle erforderlichen Informationen verfügbar sind. Sie müssen nicht alle Spalten ausfüllen, nur die fehlenden Informationen sind obligatorisch.

In der folgenden Tabelle werden die wichtigsten Spalten in input/customers.csv erläutert.

Anweisungen zum Ausführen

Führen Sie das Transform Tool in einem beliebigen Betriebssystem aus. Führen Sie die folgenden Schritte aus, um das Tool in Windows und macOS auszuführen:

Windows

Führen Sie den folgenden Befehl aus, um das Transform Tool unter Windows auszuführen:

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

macOS

Führen Sie die folgenden Schritte aus, um das Transformations-Tool auf macOS auszuführen:

1. Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten, um das Transformationsprogramm mit Python auszuführen:

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

2. Führen Sie das Transformationsprogramm aus:

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

Kunden-/Benutzervorabfrage

Das Transform-Tool führt API-Anrufe an Webex durch, um potenzielle Bereitstellungsprobleme zu erkennen. Standardmäßig werden die Adresse und die primäre E-Mail-Adresse des Kunden validiert. Wenn der Wert Provisioning _ ID in der Datei conf/partner.cfg angegeben ist, werden auch Standortinformationen validiert. Die Ergebnisse der Vorabüberprüfung sind im Ausnahmebericht enthalten.

Zusätzlich können die folgenden optionalen Parameter hinzugefügt werden, wenn das Transformations-Tool ausgeführt wird:

Vorabüberprüfung

Neben der Ausführung der precheck API für die Kundeninformationen führt das Transform Tool auch die precheck API für die Subscriber-E-Mails aus.

Vorschaukontrollinformationen

Standardmäßig sind nur Vorüberprüfungsfehler (d. h. Probleme, die die Bereitstellung blockieren) im Ausnahmebericht enthalten. Das Hinzufügen dieser Markierung umfasst auch erfolgreiche Vorabüberprüfungsergebnisse (z. B. wenn bereits eine Webex-Organisation vorhanden ist, die automatisch angehängt werden kann).

Terminalprotokolle

Die folgenden Protokolle im Terminal bei erfolgreicher Transformation:

Kurzbericht BroadWorks-Unternehmen, die erfolgreich migriert werden können: 1 BroadWorks-Unternehmen, die nicht migriert werden können: 0 erfolgreich migrierbare BroadWorks-Benutzer: 4 BroadWorks-Benutzer, die nicht migriert werden können: 0 Telefone, die migriert werden können: 3 Telefone, die nicht mit Webex Calling kompatibel sind: 0 

Ausnahmebericht

Transform Tool generiert den Ausnahmebericht im Verzeichnis output//exception_report.txt . Sie können diesen Bericht verwenden, um die Probleme zu identifizieren, die sich auf die Migration auswirken, und sie im Cisco BroadWorks-System zu beheben.

Nachdem Sie die Benutzerdaten geändert haben, um die Ausnahme zu beheben, führen Sie die Tools zum Extrahieren und Transformieren mit den neuen Daten erneut aus. Die Beispielausnahmeberichtsdatei wie folgt:

Ausnahmebericht vom 18. Okt. 08:12:09 2022 Enterprises with Communication Barring Feature Recommendation: Konfigurieren Sie den Plan für ausgehende Anrufe manuell in Control Hub ________________________________________________________________________________ collabmigrationtestGRP _engg 

Ausgabe

Eine JSON-Ausgabedatei ( customer.json ) ist im output// Verzeichnis verfügbar. Die Beispieldatei customer.json lautet wie folgt:

{ „Kunde“: { „Bereitstellungs-ID“: "!!!!!!!!!! ERSETZEN_MIT_PROVISIONINGID !!!!!!!!!!", "Pakete": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "Adresse": { "AdressLine1": "100 Main Street", "AdressLine2": "", "Stadt": "Gaithersburg", "StaatOrProvince": "MD", "zipOrPostalCode": "20877", "Land": "US" }, "CustomerInfo": { "name": "Engineering Group - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "ProvisioningParameter": { "Calling": { "Ort": { "Name": { "Adresse": { "AdressLine1": "100 Main Street", "AdressLine2": "", "Stadt": "Gaithersburg", "StaatOrProvince": "MD", "zipOrPostalCode": "20877", "Land": "US" }, "Zeitzone": "America/N"ew_York", "Sprache": "en_us", "Nummern": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } } } "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "Subscriber": [ { "amareswaranvel+benjaminjack@gmail.com": { "Subscriber": { "customerId": "!!!!!!!!!! ERSETZEN_MIT_KUNDEN !!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "Paket": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "enabled": true, "greeting": "STANDARD" }, "sendUnansweredCalls": { "enabled": true, "Gruß": "STANDARD", "NummerOfRings": 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": "STANDARD" }, "sendUnansweredCalls": { "enabled": true, "Gruß": "STANDARD", "NummerOfRings": 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": "STANDARD" }, "sendUnansweredCalls": { "enabled": true, "Gruß": "STANDARD", "NummerOfRings": 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": "STANDARD" }, "sendUnansweredCalls": { "enabled": true, "Gruß": "STANDARD", "NummerOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!! REPLACE_MIT_PERSONID !!!!!!!!!!", "Produkt": "DMS Cisco 8811", "Mac": "F87B E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "Zeitpläne": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Automatisiertes Sprachportal", "firstName": "Automatisiert", "lastName": "Sprachportal", "Sprachcode": "en_us", "phoneNumber": "+15205551105", "extension": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Geräteprofil" ], "connect_client_to_upgrade_to_webex_app": [], "Orte": [], "webex_for_broadworks_info": { "Benutzer": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Das Bereitstellungstool kann auf jedem Computer ausgeführt werden, der normalerweise vom Administrator-Laptop des Partners stammt, und verwendet die öffentlichen Webex-APIs. Es liest die Ausgabe-JSON-Datei ( customer.json ) des Transformationstools als Eingabe ein und stellt die Kunden, Standorte, Nummern, Benutzer, Dienste und Geräte in der Webex Wholesale RTM-Lösung bereit.

Voraussetzungen

Konfigurieren Sie die folgenden Voraussetzungen im Verzeichnis des Bereitstellungstools:

1. Installieren Sie Java 8, 11 oder 17 auf dem Computer. Java ist aus vielen Quellen verfügbar, darunter:
   • 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. Nachdem Sie die Migrationstools heruntergeladen und extrahiert haben, legen Sie die Umgebungsvariable JAVA _ HOME in der provisioning_tool.sh für MAC und provisioning_tool.bat für Windows fest.
3. Die Datei partner.cfg:
   • Legen Sie die WHOLESALE _ PROVISIONING _ ID und REFRESH _ TOKEN (Token aus dem Token Generator Tool kopiert). Die Partneradministratoren müssen sich an ihr Account-Team wenden, um die Provisioning _ ID zu erhalten:

      GROSSHANDEL _ BEREITSTELLUNG _ ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH _ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Legen Sie „ALLOW _ ADMIN _ INVITE _ EMAILS“ auf „false“ fest, wenn der Partner keine Willkommens-E-Mail an die Benutzer senden möchte. Der Standardwert ist "true".

4. Verwenden Sie die Eigenschaft WEBEX4BWKS _ E-MAIL _ BETREFF für Webex für BroadWorks-Migrationen, um den E-Mail-Betreff für die Anforderung der Passwortänderung für Webex für BroadWorks-Abonnenten zu senden.
5. Verwenden Sie die Webex4BWKS _ E-MAIL _ BODY-Eigenschaft für Webex für BroadWorks-Migrationen, um den E-Mail-Text für die Anforderung der Passwortänderung für Webex für BroadWorks-Abonnenten zu senden.

Für BroadCloud-Migrationen dieselbe Region:

1. Das Tool überspringt die Bereitstellung von Nummern, Geräten und der Darstellung gemeinsam genutzter Anrufe.
2. Das Tool erstellt Benutzer und virtuelle Benutzer mit Anschluss und temporärem Anschluss.

Für BroadCloud-Migrationen eine andere Region:

1. Das Tool stellt Nummern, Geräte und die gemeinsame Leitungsnutzung bereit.
2. Das Tool erstellt Benutzer und virtuelle Benutzer mit tatsächlichen Telefonnummern und Anschlüssen.
   Alle BroadCloud-Migrationen in Europa verlaufen in eine andere Region.

Anweisungen zum Ausführen

Führen Sie die folgenden Schritte aus, um das Tool in Windows und macOS auszuführen:

Windows

Führen Sie die folgenden Schritte aus, um das Tool unter Windows OS auszuführen:

So stellen Sie einen einzelnen Kunden bereit: provision.bat -input= Zur Bereitstellung mehrerer Kunden: provision.bat -input= 

macOS

Führen Sie die folgenden Schritte aus, um das Tool auf macOS auszuführen:

So stellen Sie einen einzelnen Kunden bereit: ./transform.sh -input= So stellen Sie mehrere Kunden bereit: ./transform.sh -input= 

Voraussetzungen für die Migration von Webex für BroadWorks

Partneradministratoren müssen ihre BroadWorks-Onboarding-Vorlage für die Funktionen Webex für die BroadWorks-Koexistenz aktualisieren. Siehe Bild unten:

Führen Sie das Bereitstellungstool mit einem zusätzlichen Argument für die Migration von Webex für BroadWorks zu Wholesale aus.

Vorbereitungsphase: ist die Standardphase, in der Administratoren die BroadWorks-Benutzer als Wholesale-Subscriber bereitstellen und mit Webex für BroadWorks-Benutzer fortfahren können.

Wartungsphase: ist die zweite Phase, in der Administratoren die Wholesale-Lizenz den vorhandenen Webex for BroadWorks-Benutzern zuweisen können. Sie müssen das Bereitstellungstool mit dem Argument maintenance ausführen .

Phase nach der Migration: Ist die letzte Phase, in der Administratoren BroadWorks vollständig in Wholesale konvertieren können. Sie müssen das Bereitstellungstool mit dem Argument postmigration ausführen.

Terminalprotokolle

Im Folgenden sind die Protokolle im Terminal bei erfolgreicher Bereitstellung aufgeführt:

Werkzeugname: Version des Bereitstellungstools: 1.15.0 ********** Begonnene Verarbeitungsdatei: input/customer.json **************** Provisioning Customer Warten auf Customer external_id_engg_grp 1 bis die Bereitstellung abgeschlossen ist... Warten auf Bereitstellung von external_id_engg_grp Kunde 1 ...   Status „Kunde external_id_engg_grp 1“: Provisioning Numbers Provisioning Users Provisioning User Features Provisioning Greetings Provisioning Schedules Provisioning Devices Provisioning Shared Call Appearances Provisioning Auto Attendants Provisioning Call Queues Provisioning Hunt Groups Provisioning Group Pagings Provisioning Call Parks Provisioning Call Pickups Provisioning Voice Portal ********** Abgeschlossene Datei : Eingabe/Kunde.json **************** 

Es wird eine Tabelle mit der Anzahl der für jeden Lauf erstellten Standorte gedruckt:

Ausgabe

Das Bereitstellungstool generiert Erfolgs- und Fehlerberichte in den Dateien output/<external_id>/*.success/error . Überprüfen Sie die Ausgabeerfolge und die Fehlerprotokolle, um die erfolgreiche Bereitstellung zu überprüfen.

Partner-Administratoren können die Kundenbereitstellung im Partner Hub und im Control Hub-Portal überprüfen. Lesen Sie die folgenden Abbildungen im Partner Hub- und Control Hub-Portal:

Abbildung 8: Partner Hub

Abbildung 9: Control Hub

Abbildung 10: Geräte

Abbildung 11: Anrufe

Für BroadCloud

Für BroadCloud-Partner können Sie über das Service Provider-Portal Migrationsanfragen für Nummern, Geräte und SCA-Migrationen senden.

Im Service Provider-Portal kann eine Migrationsanforderung bis zu 50 Kunden umfassen. Innerhalb eines Tages können maximal 10 Anfragen eingereicht werden.

Die folgenden Zahlen zeigen das Service Provider-Portal.

Abbildung 12: Dienstleisterportal

Abbildung 13: Dienstleisterportal

Für Cisco BroadWorks und Webex für BroadWorks

Bei Cisco BroadWorks- und Webex für BroadWorks-Migrationen wird das Tool auf dem sekundären Cisco BroadWorks Application Server im Partnernetzwerk ausgeführt und über OCI-P mit dem AS verbunden. Sie verwendet die Transform Tool-Ausgabedatei JSON ( customer.json ) als Eingabe und führt die OCI-P-Befehle aus, um Geräte und Soft Clients zu migrieren.

Bei einem erfolgreichen Vorgang wird das Tool zum Verschieben des Geräts:

1. Deregistrieren Sie Geräte über Cisco BroadWorks und registrieren Sie sie in Wholesale.
2. Benutzer, die den UC-One-Client verwenden, werden bei der ersten Anmeldung zur Webex-App umgeleitet.
3. Deaktivieren Sie die Telefonnummern von Cisco BroadWorks oder entfernen Sie die Telefonnummern von BroadCloud.
4. Aktivieren Sie Nummern in Wholesale.
5. Erstellen Sie die Anzeige gemeinsam genutzter Anrufe in Wholesale für BroadCloud-Migrationen. [Dieser Schritt gilt nur für BroadCloud-Migrationen].

SCP und SSH

1. SCP das Tool zum Verschieben des Geräts auf den sekundären Cisco BroadWorks-Anwendungsserver.
2. SSH auf den sekundären Cisco BroadWorks-Anwendungsserver, um die Voraussetzungen zu konfigurieren und das Tool zum Verschieben des Geräts auszuführen.

Voraussetzungen

1. Legen Sie den REFRESH _ TOKEN (Token aus dem Token Generator Tool kopiert) in der Datei conf/partner.cfg fest:

    REFRESH _ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

2. Stellen Sie sicher, dass die sekundäre Benutzer-ID, das Kennwort und der Host-Name des Cisco BroadWorks-Anwendungsservers in der Datei conf/deviceMoveTool.conf korrekt sind:

    BROADWORKS _ BENUTZER _ ID = admin BROADWORKS _ PASSWORD = admin BROADWORKS _ GASTGEBER _ NAME = localhost 

3. Stellen Sie sicher, dass der JDK/JRE-Umgebungspfad in devicemove.sh

    JAVA _ HOME=/usr/local/java/java_base

   korrekt ist.
4. Administratoren können die Datei locations.csv aus dem Eingabeverzeichnis verwenden, um die spezifischen Gruppen anstelle aller Gruppen unter einem Unternehmen zu migrieren.

Polycom-Telefone

Um Polycom-Telefone von Cisco BroadWorks zu Wholesale Calling zu verschieben, muss ein Partneradministrator eine neue Datei für den Identitäts-/Geräteprofiltyp auf Systemebene in Cisco BroadWorks erstellen – jede Polycom-Gerätevorlage . Siehe Abbildung 14 und laden Sie die benutzerdefinierte Datei file device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg hoch. Stellen Sie nach dem Hochladen der neuen Gerätedatei sicher, dass die neu erstellte Datei auf Gruppenebene vorhanden ist. Stellen Sie außerdem sicher, dass file migration_%BWMAC ADDRESS%.cfg nicht mit einer vorhandenen Datei in Ihrem System kollidiert).

Es wird intern durch das Gerät bewegen Werkzeug verwendet.

Der Migrationsprozess für Polycom-Telefone:

1. Das Tool zum Verschieben des Geräts ersetzt die Datei %BWMACADDRESS%.cfg auf Geräteebene durch polycom_vvx 2.cfg. Beachten Sie, dass sich diese Datei auf migration_%BWMACADDRESS%.cfg bezieht.
2. Erstellen Sie die Geräteprofile auf Gruppenebene oder Geräteebene neu.
   Das Handeln auf Gruppen- oder Geräteebene hängt von der Konfiguration des Parameters deviceLevelRebuild in file device-move-tool/conf/partner.cfg ab.
3. Das Tool zum Verschieben des Geräts fordert den Cisco BroadWorks-Anwendungsserver auf, die Telefone auf Gruppenebene oder Geräteebene neu zu starten.
4. Nach der Neustartanforderung laden Polycom-Telefone herunter und verarbeiten % BWMACADDRESS%.cfg, wodurch die Polycom-Telefone aufgefordert werden, migration_%BWMACADDRESS%.cfg herunterzuladen und zu verarbeiten, wodurch device.prov.serverName auf https://plcm.sipflash.com. festgelegt wird.
   https://plcm.sipflash.com für die US-Region haben andere Regionen unterschiedliche URLs.
5. Das Polycom-Telefon lädt %BWMACADDRESS%.cfg von https://plcm.sipflash.com herunter und wird von der Webex Calling DMS verwaltet.

Abbildung 14: Datei vom Typ Identität/Geräteprofil hinzufügen

Anweisungen zum Ausführen

Es gibt zwei Methoden zum Aufrufen der DMT. Die erste Methode besteht darin, sich durch einen einzelnen Kunden gleichzeitig aufzurufen, und die andere Methode besteht darin, mehrere Kunden gleichzeitig zu durchlaufen.

Das Tool zum Verschieben des Geräts wird über den sekundären Cisco BroadWorks-Anwendungsserver im Verzeichnis „Tool zum Verschieben des Geräts“ ausgeführt:

Für Geräteverschiebung einzelner Kunde: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Für Geräteverschiebung mehrerer Kunden: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Darüber hinaus unterstützt das Tool Geräteverschiebung die Migration einzelner/bestimmter Telefone ab Version 1.35.0. Verwenden Sie den folgenden Befehl: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminalprotokolle

Im Folgenden werden die Protokolle im Terminal bei erfolgreicher Ausführung des Tools für die Gerätemigration aufgeführt:

Werkzeugname: Version des Tools zum Verschieben des Geräts: 1.15.0 Gerätetool gestartet... Gültige Geräte für die Migration: ------------------------------------------------------------------------------------------------------------------- | Gerätetyp | Mac | Version | E-Mail-Adresse | ------------------------------------------------------------------------------------------------------------------- | 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 | F87B E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Möchten Sie alle diese Geräte migrieren? ([Y]es oder [N]o) ja Hochladen von Geräteprofilen für DMS Cisco MPP LC Rebuild-Geräteprozess gestartet Rebuild-Geräteprozess erfolgreich abgeschlossen Reboot-Prozess gestartet Reboot-Prozess erfolgreich abgeschlossen Ändern von Profilen für Business Communicator unter GruppenmigrationtestGRP _engg Webex-Telefonnummern aktivieren Prozess für Kundenorganisation gestartet Id: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktivieren des Webex-Telefonnummernprozesses für die Kunden-Organisations-ID abgeschlossen: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Deaktivieren des Prozesses für BroadWorks-Telefonnummern, der für GroupId gestartet wurde: collabmigrationtestGRP _engg Deaktivieren des Prozesses für BroadWorks-Telefonnummern für GroupId abgeschlossen: collabmigrationtestGRP _engg Gerätemigration abgeschlossen 

Ausgabe

Nach der Gerätemigration sind die Geräte online und können Anrufe tätigen/empfangen. Ein Beispiel für den Gerätestatus finden Sie in Abbildung 15:

Abbildung 15: Gerätestatus

Nach der Gerätemigration sind die Nummern aktiv geworden. Siehe Abbildung 16, um ein Beispiel für aktive Nummern zu sehen:

Abbildung 16: Aktive Nummern

Der Rücksetzvorgang muss für jeweils ein Unternehmen ausgeführt werden.

Für BroadCloud Carrier

Der Rücksetzprozess für BroadCloud-Partner ist wie folgt:

1. Öffnen Sie ein Ticket mit Cisco TAC, um das Zurücksetzen eines Geräts anzufordern.
2. Führen Sie das Tool zum Verschieben des Geräts im Zurücksetzungsmodus aus:
   • Die Zuweisung von Telefonnummern zu Webex Calling wird aufgehoben, sodass Benutzer und Dienste nur noch Anschlüsse haben.
   • E-Mail-Adressen in Webex Calling werden auf temporäre E-Mail-Adressen zurückgesetzt.
   • Telefone werden aus Webex Calling gelöscht.
   • Telefonnummern, E-Mail-Adressen, die als alternative Ids verwendet werden, und Telefone werden in BroadCloud neu erstellt.
   • Die Telefone werden neu gestartet.
3. Partneradministratoren müssen PSTN-Telefonnummern zurück an den BroadCloud-Netzbetreiber verschieben.

Für Cisco BroadWorks und Webex für BroadWorks

Der Rücksetzvorgang für Cisco BroadWorks und Webex für BroadWorks ist wie folgt:

1. Öffnen Sie ein Ticket mit Cisco TAC, um das Zurücksetzen eines Geräts anzufordern.
2. Führen Sie das Tool zum Verschieben des Geräts im Zurücksetzungsmodus auf dem sekundären BroadWorks-Anwendungsserver aus, um die Gerätemigrationen zurückzusetzen. Dadurch wird die DMS-URL für Geräteprofile in Cisco BroadWorks wieder auf die DMS-URL des Serviceanbieters festgelegt und die Telefonnummern erneut aktiviert.
3. Das Webex Calling-Team legt die DMS-URL in Geräteprofilen in Webex Calling auf die DMS-URL des Serviceanbieters zurück.
4. Partneradministratoren müssen die Telefonnummern in Webex Calling über das Control Hub-Portal deaktivieren oder löschen.
5. Partneradministratoren müssen PSTN-Telefonnummern zurück zu Cisco BroadWorks verschieben.

Anweisungen zum Ausführen des Tools zum Verschieben des Geräts im Rückwärtsmodus

Führen Sie die folgenden Schritte aus, um das Tool zum Verschieben des Geräts im Rückwärtsmodus auszuführen:

Führen Sie den folgenden Befehl im sekundären Cisco BroadWorks-Anwendungsserver im Verzeichnis des Tools für die Geräteverschiebung aus:

Profile zurücksetzen

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

Nummern zurücksetzen

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

Terminalprotokolle

Wir erhalten die folgenden Protokolle im Terminal, wenn das Tool zum Verschieben des Geräts zum Zurücksetzen erfolgreich ausgeführt wurde:

Profile zurücksetzen

Werkzeugname: Version des Tools zum Verschieben des Geräts: 1.15.0 Gerätetool für Wiederherstellungsprozess gestartet... Geräte, die von Webex Calling zurück zu BroadWorks verschoben werden können: - ------------------------------------------------------------------------------------------------------------------- | Gerätetyp | Mac | Version | E-Mail-Adresse | ------------------------------------------------------------------------------------------------------------------- | 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 | F87B E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- Möchten Sie diese Geräte von Webex Calling zurück zu BroadWorks verschieben? (Ja, Y, Nein, N):  yes Hochladen von Geräteprofilen für DMS Cisco MPP LC-Rebuild-Geräteprozess gestartet Rebuild-Geräteprozess erfolgreich abgeschlossen Reboot-Prozess gestartet Neustartprozess erfolgreich abgeschlossen Gerätemigration für Deprovision-Prozess abgeschlossen 

Nummern zurücksetzen

Werkzeugname: Version des Tools zum Verschieben des Geräts: 1.15.0 Möchten Sie mit dem Zurückkehren der Nummern zu Broadworks fortfahren?  ([Y]es oder [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Zurücksetzen starten Aktivieren des Prozesses für BroadWorks-Telefonnummern für GroupId gestartet: collabmigrationtestGRP _engg Prozess der Aktivierung von BroadWorks-Telefonnummern für GroupId abgeschlossen: collabmigrationtestGRP _engg Gerätemigration erfolgreich abgeschlossen