Unterstützte Telefone werden vom Bereitstellungstool automatisch in Webex Calling erstellt und den Benutzern zugewiesen. Die in der Spalte „Unterstützt im Tool zum Verschieben von Geräten“ mit „Ja“ markierten Telefone werden ebenfalls automatisch von Cisco BroadWorks oder BroadCloud zu Webex Calling verschoben, wenn das Tool zum Verschieben von Geräten 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 im Telefon selbst zu ändern.

Die letzte Spalte bietet die Zuordnung von Telefonmodellen zur Spalte „Gerätetyp“ der Datei-Transformationstool/input/newphones.csv. (Weitere Informationen zu newphones.csv finden Sie im Abschnitt Transformationstool in diesem Artikel).

Partner-Administratoren führen dieses Token-Generator-Utility-Tool mindestens einmal aus, bevor Sie mit der Ausführung der Migrationstools beginnen. Die Ausführung dieses Tools ist eine einmalige Aktivität, nachdem das Partnerkonto in die Wholesale RTM-Lösung integriert wurde. Dieses Tool ermöglicht es Partner-Administratoren, sich über den Webbrowser anzumelden, um den eindeutigen TOKEN zu erhalten, der für die Aktualisierung in die Partner-Konfigurationsdateien für die Migrations-Tools erforderlich ist.

Voraussetzungen

Extrahieren Sie nach dem Download die Binärdateien des Migrationstools.

Legen Sie den Pfad für die JRE/JDK-Umgebung in token_generator.sh für MAC und token_generator.bat für Windows fest. Wenn der 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 für die Ausführung

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

Windows:

token_generator. Fledermaus

MacOS:

./token_generator.sch

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 abzurufen und dieses zur weiteren Verwendung zu kopieren.

Die Abbildungen der Benutzeroberfläche finden Sie unten als Referenz:

Abbildung 3: Anmeldung mit Cisco Webex

Abbildung 4: Anmeldeinformationen-Fenster

Abbildung 5: Token-Generierung

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

OCI-P-Konnektivität aktivieren

Das Tool zum Verschieben von Geräten kommuniziert über OCI-P-Befehle mit den BroadWorks. Um die OCI-P-Konnektivität zu aktivieren, führen Sie die folgenden Schritte aus:

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Führen Sie den folgenden Befehl in CLI aus, um die aktuellen GeneralSettings 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. Sie sollten Folgendes sehen:

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enableResponseCaching = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 messageQueueCapacity = 50 messageQueueTimeoutSeconds = 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, um die OCI-Bereitstellung zu konfigurieren.

Änderung im Bereitstellungsverzeichnis:

AS_CLI> cd /System/NetworkAccessLists/OCI/Bereitstellung

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 als 

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

 AS_CLI/Maintenance/ManagedObjects> erhalten Sie Broadworks und überprüfen Sie, ob Ihre Ausgabe OK aussieht. Nachfolgend finden Sie eine Beispielausgabe: AS_CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== * Server: Identität..............: AS-Version...............: Rel_21.sp1_1.551 Verwaltungsstatus..: Entsperrte * Anwendungen: Name Version Bereitgestellt Verwaltungsstatus Effektive StatusausführungAndProvisioning 21.sp1_1.551 true Entsperrt Entsperrt FlashPolicy 21.sp1_1.551 false Entsperrt Beendet OpenClientServer 21.sp1_1.551 true Entsperrt Entsperrt WebContainer 21.sp1_1.551 true Entsperrt Entsperrt 4 Einträge gefunden. * Gehostete Anwendungen: Name Version Context Path Deployed ================================================================== CommPilot 21.sp1_1.551 / true DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true JWSFiles 21.sp1_1.551 /FileRepos true MediaFiles 21.sp1_1.551 /media true OCIFiles 21.sp1_1.551 /ocifiles true 5 Einträge gefunden. 

Überprüfen Sie, ob der offene Client-Server bereitgestellt und aktiv ist.

Verwenden Sie die folgenden Befehle, um den Open Client Server auf dem sekundären Anwendungsserver bereitzustellen und zu starten, falls dieser nicht bereitgestellt wurde oder noch nicht begonnen hat.

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

Nummernaktivierung aktivieren

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

Schritt 1: Führen Sie den Nummernaktivierungsbefehl aus:

AS_CLI> CD-Abonnentenverwaltung/Nummernaktivierung

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

AS_CLI> dnMode groupAndUserActivationEnabled festlegen

Schritt 3: Geben Sie in der Bestätigungsaufforderung J ein.

Für BroadCloud

Das Extract-Tool ist im BroadCloud Service Provider-Portal integriert. Ein Service-Provider-Administrator kann:

1. Senden Sie Extraktionsanfragen für bis zu 50 Kunden pro Anfrage.
   Eine Extraktionsanfrage 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 dem Datum der Anfrage herunter.

Die folgenden Zahlen zeigen das Dienstleister-Portal.

Abbildung 6: Dienstleister-Portal

Abbildung 7: Dienstleister-Portal

Für Cisco BroadWorks und Webex für BroadWorks

1. Das Extract-Tool wird auf dem sekundären Cisco BroadWorks-Anwendungsserver im Partnernetzwerk ausgeführt und über OCI-P verbunden.
2. Das Tool ruft rohe Unternehmens-, Gruppen-, Nummern-, Benutzer-, Services-, Geräte- und Soft-Client-Daten 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 Extraktionstool installiert und konfiguriert wird.

Voraussetzungen

1. SCP die Binärdateien des Extraktionstools zum sekundären Cisco BroadWorks-Anwendungsserver.
2. SSH zum sekundären Cisco BroadWorks-Anwendungsserver, um die Voraussetzungen zu konfigurieren und das Extraktionstool auszuführen.
3. Konfigurieren Sie den Serviceanbieter und die Gruppen-ID, um aus Cisco BroadWorks in conf/exportTool.yml zu extrahieren. Siehe den folgenden Beispiel-YAML-Ausschnitt:

   Dienstanbieter-ID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        – alle 

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

   BROADWORKS_BENUTZER_ID = admin BROADWORKS_PASSWORT = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Aktualisierungstoken des Partneradministrators, kopiert aus dem Token-Generator-Tool. MIGRATIONSMODUS_ = 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 AKTUALISIERUNGS_TOKEN ist für eine Migration von Webex für BroadWorks erforderlich.

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

   JAVA_HOME=/usr/local/java/java_base

Anweisungen für die Ausführung

Führen Sie den folgenden Befehl auf dem sekundären Cisco BroadWorks-Anwendungsserver aus dem Verzeichnis des Extraktionstools aus:

./export.sh

Terminal-Protokolle

Bei einem erfolgreichen Export sind die folgenden Protokolle im Terminal verfügbar: Ausführen des BroadSoft Daten-Export-Tools:

 Ausführen des BroadSoft Data Export Tool ************************************************ Start Export Tool v: 1.15.0 Export gestartet für SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export von Benutzern für SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export von Benutzern für SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export für SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export abgeschlossen Export Dump Zip Directory : output/20221017223452_ExportTool Export Dump ZIP Dateiname:extracted_data_1666060500618.zip Die ZIP-Datei mit dem Namen extracted_data_1666060500618.zip wurde erstellt ZIP-Dateierstellungsprozess abgeschlossen Exportierte Dateien werden als ZIP-Datei konvertiert ************************************************** 

Ausgabe

Eine Ausgabe-ZIP-Datei (extracted_data_.zip) steht im selben Verzeichnis des Extraktionstools zur Verfügung. Verwenden Sie den folgenden Befehl, um die ZIP-Datei für die Transformationstool-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 Okt 17 22:34 Ausgabe/ drwxrwxr-x 2 bwadmin bwadmin 4096 Okt 17 22:34 Protokolle/ -rw-rw-r-- 1 bwadmin bwadmin 46341 Okt 17 22:35 extracted_data_1666060500618.zip 

Dieses Transformationstool wird für alle Migrationen ausgeführt. Das Transformationstool wird auf jedem beliebigen Computer ausgeführt, auch auf dem Administrator-Laptop eines Partners, und verwendet die öffentlichen Webex-APIs. Sie liest die ZIP-Datei für die Ausgabe des Extraktionswerkzeugs (extracted_data_.zip) als Eingabe und wandelt die Raw-XML in ein JSON-Format um, das vom Bereitstellungstool verwendet wird.

Voraussetzungen

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

1. Legen Sie den AKTUALISIERUNGS_TOKEN (der aus dem Token-Generator-Tool kopierte Token) und den NAMEN_DES_HAUPTSTANDORTS_ in der Datei conf/partner.cfg fest:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main 

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

   BEREITSTELLUNG_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Um eine vollständigere Verifizierung der E-Mail-Adresse des Kunden 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), wenn sie fehlen.
4. Fügen Sie die E-Mail-Adresse des Endbenutzers in der Datei „input/users.csv“ hinzu.
5. Wenn neue Telefone bereitgestellt werden sollen, fügen Sie die MAC-Adresse und die E-Mail-Adresse des neuen Telefons des Benutzers zur Datei input/newphones.csv hinzu. Dies ist nur erforderlich, wenn die Partneradministratoren neue Telefone in Wholesale-Anrufen bereitstellen möchten.
6. Konvertieren Sie die BroadWorks-Callcenter mithilfe der Datei input/cxessentials.csv in CxEssentials.
7. Aktivieren Sie optional die Eigenschaft „UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS“, um alle Call Center in CxEssentials zu konvertieren.
8. Verwenden Sie die Datei input/locations.csv, um die Migration großer Unternehmen zu unterstützen, mit der Administratoren die Standorte ihrer Kunden nach Standorten migrieren können.
9. Aktivieren Sie optional die Verwendung von MAC-Adressen über den User-Agent-Header der SIP REGISTER-Nachricht, wenn die MAC-Adresse im Cisco BroadWorks-Geräteprofil nicht verfügbar ist. Kommentieren der Zeile „_MAC_ADDRESS_FROM_SIP_REGISTER=yes“ in der Datei „conf/partner.cfg“ aufheben

Eingabe/customers.csv ausfüllen

Die Datei input/customers.csv enthält Daten, die möglicherweise in Cisco BroadWorks oder BroadCloud fehlen. Diese Datei kann leer gelassen werden, wenn bereits alle Pflichtangaben 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 erklärt.

Anweisungen für die Ausführung

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

Windows

Führen Sie den folgenden Befehl aus, um das Transformationstool in Windows auszuführen:

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

macOS

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

1. Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten, um das Transformationstool 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 Transformationstool aus:

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

Kunden-/Benutzervorabüberprüfung

Das Transformationstool führt API-Anrufe an Webex durch, um mögliche Bereitstellungsprobleme zu beheben. Standardmäßig werden die Adresse und die primäre E-Mail-Adresse des Kunden validiert. Wenn die BEREITSTELLUNG_Der ID-Wert wird in der Datei conf/partner.cfg angegeben. Außerdem werden die 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 Transformationstool ausgeführt wird:

Vorabüberprüfung

Zusätzlich zur Ausführung der Vorabüberprüfung-API für die Kundeninformationen führt das Transformationstool auch die Vorabüberprüfung-API für die Subscriber-E-Mails aus.

VorschauInfo

Standardmäßig sind nur Fehler bei der Vorabüberprüfung (d. h. Probleme, die die Bereitstellung blockieren) im Ausnahmebericht enthalten. Das Hinzufügen dieses Kennzeichens umfasst auch erfolgreiche Ergebnisse der Vorabüberprüfung (z. B. wenn bereits eine Webex-Organisation vorhanden ist, die automatisch angehängt werden kann).

Terminal-Protokolle

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 BroadWorks-Benutzer, die erfolgreich migriert werden können: 4 BroadWorks-Benutzer, die nicht migriert werden können: 0 Telefone, die erfolgreich migriert werden können: 3 Telefone, die nicht mit Webex Calling kompatibel sind: 0 

Ausnahmebericht

Das Transformationstool generiert den Ausnahmebericht im Verzeichnis output//exception_report.txt . Mit diesem Bericht können Sie die Probleme identifizieren, die sich auf die Migration auswirken, und sie im Cisco BroadWorks-System beheben.

Nachdem Sie die Benutzerdaten geändert haben, um die Ausnahme zu beheben, führen Sie die Extract- und Transform-Tools mit den neuen Daten erneut aus. Die Beispiel-Ausnahmeberichtsdatei lautet wie folgt:

Ausnahmebericht Di 18. Okt 08:12:09 2022 Enterprises with Communication Barring Feature Recommendation: den Plan für ausgehende Anrufe im Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Ausgabe

Eine JSON-Ausgabedatei (customer.json) steht im Verzeichnis output// zur Verfügung. Die Beispieldatei customer.json lautet wie folgt:

{ "customer": { "provisioningId": "!!!!!!!!!!ERSETZEN_mit_PROVISIONINGID!!!!!!!!!!", "Pakete": [ "webex_calling„, „common_area_calling" ], "externalId": "external_id_engg_grp1“, „Adresse“: { „addressLine1“: „100 Main Street“, „addressLine2“: „“, „city“: „Gaithersburg“, „stateOrProvince“: „MD“, „zipOrPostalCode“: „20877“, „country“: „US“ }, „customerInfo“: { „name“: „Engineering Group – 1“, „primaryEmail“: „amareswaranvel+engineeringgroup1@gmail.com“ }, „provisioningParameters“: { „calling“: { „location“: { „name“: „Main“, „address“: { „addressLine1“: „100 Main Street“, „addressLine2“: „“, „city“: „Gaithersburg“, „stateOrProvince“: „MD“, „zipOrPostalCode“: „20877“, „country“: „US“ }, „timezone“: „Amerika/New_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" }, "Abonnenten": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ERSETZEN_mit_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "provisionparameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "BusyCalls senden": { "aktiviert": true, "Begrüßung": "STANDARD" }, "Nicht beantwortete Anrufe senden": { "aktiviert": wahr, „Begrüßung“: „STANDARD“, „Anzahl der Klingelzeichen“: 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externalEmail": "engineering17861@mailnator.com" } } ], "devices": [ { "cisUuid": "!!!!!!!!!!ERSETZEN_MIT_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ERSETZEN_MIT_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, "BusyCalls senden": { "aktiviert": true, "Begrüßung": "STANDARD" }, "Nicht beantwortete Anrufe senden": { "aktiviert": wahr, „Begrüßung“: „STANDARD“, „Anzahl der Klingelzeichen“: 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externalEmail": "engineering16821@mailnator.com" } } ], "devices": [ { "cisUuid": "!!!!!!!!!!ERSETZEN_MIT_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ERSETZEN_MIT_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, "BusyCalls senden": { "aktiviert": true, "Begrüßung": "STANDARD" }, "Nicht beantwortete Anrufe senden": { "aktiviert": wahr, „Begrüßung“: „STANDARD“, „Anzahl der Klingelzeichen“: 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externalEmail": "engineeringmacpc@mailnator.com" } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!ERSETZEN_DURCH_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, "BusyCalls senden": { "aktiviert": true, "Begrüßung": "STANDARD" }, "Nicht beantwortete Anrufe senden": { "aktiviert": wahr, „Begrüßung“: „STANDARD“, „Anzahl der Klingelzeichen“: 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERN", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!ERSETZEN_mit_PERSONID!!!!!!!!!!", "product": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "Zeitpläne": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Automatisiertes Sprachportal", "firstName": "automatisch", "lastName": "Sprachportal", "languageCode": "en_us", "phoneNumber": "+15205551105", "Durchwahl": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg-Geräteprofil" ], "connect_client_to_upgrade_to_webex_app": [], "Standorte": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Das Bereitstellungstool kann auf jedem beliebigen Computer in der Regel auf dem Administrator-Laptop des Partners ausgeführt werden und verwendet die öffentlichen Webex-APIs. Sie liest die JSON-Datei (customer.json) für die Ausgabe des Transformationstools als Eingabe 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 Binärdateien der Migrationstools heruntergeladen und extrahiert haben, legen Sie die Umgebungsvariable JAVA_HOME in provisioning_tool.sh für MAC und provisioning_tool.bat für Windows fest.
3. Die Datei partner.cfg:
   • Legen Sie die WHOLESALE_BEREITSTELLUNGS_ID und das AKTUALISIERUNGS_TOKEN fest (der aus dem Token-Generator-Tool kopierte Token). Die Partneradministratoren müssen sich an ihr Account-Team wenden, um die Bereitstellungs-ID_zu erhalten:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Legen Sie ALLOW_ADMIN_INVITE_E-MAILS 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_SUBJECT für Webex für BroadWorks-Migrationen, um den Betreff für die Anforderung zum Ändern des Passworts für Webex für BroadWorks-Abonnenten zu senden.
5. Verwenden Sie die WEBEX4BWKS_EMAIL_BODY-Eigenschaft für Webex für BroadWorks-Migrationen, um den E-Mail-Text für Anfragen zur Änderung des Passworts für Webex für BroadWorks-Abonnenten zu senden.

Bei BroadCloud-Migrationen dieselbe Region:

1. Das Tool überspringt die Bereitstellung von Nummern, Geräten und gemeinsam genutzten Anrufnutzungen.
2. Das Tool erstellt Benutzer und virtuelle Benutzer mit einer Durchwahl und einer temporären Durchwahl.

Für BroadCloud-Migrationen eine andere Region:

1. Das Tool stellt Nummern, Geräte und gemeinsame Anrufnutzungen bereit.
2. Das Tool erstellt Benutzer und virtuelle Benutzer mit tatsächlichen Telefonnummern und Durchwahlen.
   Alle europäischen BroadCloud-Migrationen erfolgen in eine andere Region.

Anweisungen für die Ausführung

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

Windows

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

So stellen Sie einen einzelnen Kunden bereit: provision.bat -input= So stellen Sie mehrere Kunden bereit: 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 Webex für BroadWorks-Koexistenzfunktionen aktualisieren. Siehe folgendes Bild:

Nachdem die Webex für BroadWorks-Onboarding-Vorlage aktualisiert wurde, um die Migration zu unterstützen, fordern Sie das Cisco Account Team auf, die Funktion „Wholesale-Partner-Blending-enabled“ auf Partnerebene zu aktivieren. Auf diese Weise können Wholesale-Pakete während der Bereitstellung zu vorhandenen Webex für BroadWorks-Kundenorganisationen hinzugefügt werden.

Führen Sie das Bereitstellungstool mit einem zusätzlichen Argument aus.

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

Erhaltungsphase: ist die zweite Phase, in der Administratoren die Wholesale-Lizenz vorhandenen Webex für BroadWorks-Benutzern zuweisen können. Sie müssen das Bereitstellungstool mit einem Argument Wartung 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 Nach der Migration ausführen.

Terminal-Protokolle

Bei erfolgreicher Bereitstellung finden Sie die Protokolle im Terminal:

Werkzeugname: Version des Bereitstellungstools: 1.15.0 ********** Beginn der Verarbeitung der Datei: input/customer.json **************** Bereitstellung Kunde Wartet darauf, dass Kunde external_id_engg_grp1 die Bereitstellung abgeschlossen hat... Warten darauf, dass Kunde external_id_engg_grp1 die Bereitstellung abgeschlossen hat...   Status von Kunde external_id_engg_grp1: bereitgestellte Bereitstellungsnummern Bereitstellungsbenutzer Bereitstellungsbenutzerfunktionen Bereitstellungsbegrüßungen Bereitstellungszeitpläne Bereitstellungsgeräte Bereitstellung Gemeinsame Anrufanzeigen Bereitstellung Auto Attendants Bereitstellung Anrufwarteschlangen Bereitstellung Sammelanschlüsse Bereitstellung Gruppen Pagings Bereitstellung Anruf parken Bereitstellung Anrufannahmen Bereitstellung Sprachportal ********** Abgeschlossen Datei: eingabe/customer.json **************** 

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

Ausgabe

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

Partneradministratoren können die Kundenbereitstellung im Partner Hub- und Control Hub-Portal überprüfen. Weitere Informationen finden Sie in den 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 verwenden Sie das Service-Provider-Portal, um eine Migrationsanfrage für Nummern, Geräte und SCA-Migrationen zu senden.

Innerhalb des Serviceanbieterportals kann eine Migrationsanfrage bis zu 50 Kunden umfassen. Innerhalb eines Tages können maximal 10 Anfragen eingereicht werden.

Die folgenden Zahlen zeigen das Dienstleister-Portal.

Abbildung 12: Dienstleister-Portal

Abbildung 13: Dienstleister-Portal

Für Cisco BroadWorks und Webex für BroadWorks

Für Cisco BroadWorks- und Webex für BroadWorks-Migrationen wird das Tool auf dem sekundären Cisco BroadWorks-Anwendungsserver im Partnernetzwerk ausgeführt und über OCI-P mit dem Nebensystem verbunden. Es verwendet die JSON-Datei (customer.json) für die Ausgabe des Transformationstools als Eingabe und führt die OCI-P-Befehle aus, um Geräte und Soft-Clients zu migrieren.

Bei einem erfolgreichen Vorgang führt das Tool zum Verschieben des Geräts Folgendes aus:

1. Heben Sie die Registrierung von Geräten bei Cisco BroadWorks auf und registrieren Sie sie in Wholesale.
2. Benutzer, die den UC-One-Client verwenden, werden bei der erstmaligen 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 gemeinsam genutzte Anrufnutzungen in Wholesale für BroadCloud-Migrationen. [Dieser Schritt gilt nur für BroadCloud-Migrationen].

SCP und SSH

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

Voraussetzungen

1. Legen Sie den AKTUALISIERUNGS_TOKEN (der aus dem Token-Generator-Tool kopierte Token) in der Datei conf/partner.cfg fest:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_BENUTZER_ID = Administrator BROADWORKS_PASSWORT = Administrator BROADWORKS_GASTGEBER_NAME = localhost 

3. Um Aktivierungs-E-Mails erneut zu senden, müssen Sie RESEND_INVITATION_EMAILS=true in der Datei conf/partner.cfg festlegen.

   Wenn Administratoren während der Migration Einladungs-E-Mails an ihre Benutzer senden möchten, sollten sie die Eigenschaft „RESEND_INVITATION_EMAILS=true“ in der Datei conf/partner.cfg deaktivieren. Ansonsten soll die Immobilie unverändert bleiben.

4. Stellen Sie sicher, dass der Pfad für die JDK-/JRE-Umgebung in devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

   korrekt ist.
5. Administratoren können die Datei locations.csv aus dem Eingabeverzeichnis verwenden, um die bestimmten 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 jeder Polycom-Gerätevorlage erstellen. Siehe Abbildung 14 und laden Sie die benutzerdefinierte Datei 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 datei migration_%BWMAC ADDRESS%.cfg nicht mit einer vorhandenen Datei in Ihrem System in Konflikt steht).

Sie wird intern vom Tool zum Verschieben von Geräten verwendet.

Der Migrationsprozess für Polycom-Telefone:

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

Abbildung 14: Identitäts-/Geräteprofiltyp Datei hinzufügen

Anweisungen für die Ausführung

Es gibt zwei Methoden, um das DMT aufzurufen. Die erste besteht darin, das DMT jeweils über einen einzelnen Kunden zu öffnen, die andere besteht darin, mehrere Kunden gleichzeitig zu durchlaufen.

Das Tool zum Verschieben von Geräten wird über den sekundären Cisco BroadWorks-Anwendungsserver im Verzeichnis des Tools zum Verschieben von Geräten ausgeführt:

Für das Verschieben einzelner Kunden auf Geräte: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Für das Verschieben mehrerer Kunden auf Geräte: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Darüber hinaus unterstützt das Tool für das Verschieben einzelner/spezifischer Telefone von der Version 1.35.0. Verwenden Sie den folgenden Befehl: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminal-Protokolle

Bei erfolgreicher Ausführung des Tools für die Gerätemigration finden Sie im Terminal die folgenden Protokolle:

Werkzeugname: Version des Tools zum Verschieben von Geräten: 1.15.0 Geräte-Tool gestartet... Gültige Geräte für Migration: ------------------------------------------------------------------------------------------------------------------- | Gerätetyp | Mac | Version | 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 | ------------------------------------------------------------------------------------------------------------------- Möchten Sie alle diese Geräte migrieren? ([J]e oder [N]o) ja Geräteprofile für DMS hochladen Cisco MPP LC Geräteprozess neu erstellen Geräteprozess neu erstellen Erfolgreich abgeschlossen Neustartprozess gestartet Neustartprozess erfolgreich abgeschlossen Profile für Business Communicator under group collabmigrationtestGRP_engg Webex-Telefonnummernprozess für Kunden-Org-ID aktivieren: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktivierung des Webex-Telefonnummernprozesses für die Kunden-Org-ID abgeschlossen: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c BroadWorks-Telefonnummernprozess für Gruppen-ID deaktivieren: collabmigrationtestGRP_engg Deaktivieren des BroadWorks-Telefonnummernprozesses 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 aktiviert. Abbildung 16 zeigt, welche Nummern aktiv sind:

Abbildung 16: Aktive Nummern

Der Revert-Vorgang muss für jeweils ein Unternehmen ausgeführt werden.

Für BroadCloud-Anbieter

Der Revert-Prozess für BroadCloud-Partner lautet wie folgt:

1. Öffnen Sie ein Ticket mit Cisco TAC, um die Wiederherstellung eines Geräts anzufordern.
2. Führen Sie das Tool für die Geräteverschiebung im Revert-Modus aus:
   • Die Zuweisung von Telefonnummern zu Webex Calling wird aufgehoben, sodass Benutzer und Dienste nur mit Durchwahlen übrig bleiben.
   • 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 in BroadCloud Carrier verschieben.

Für Cisco BroadWorks und Webex für BroadWorks

Der Reverseprozess für Cisco BroadWorks und Webex für BroadWorks verläuft wie folgt:

1. Öffnen Sie ein Ticket mit Cisco TAC, um die Wiederherstellung eines Geräts anzufordern.
2. Führen Sie das Tool für die Geräteverschiebung im Revert-Modus 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 auf die DMS-URL des Serviceanbieters zurückgesetzt und Telefonnummern werden erneut aktiviert.
3. Das Webex Calling-Team setzt die DMS-URL in Geräteprofilen in Webex Calling zurück auf die DMS-URL des Serviceanbieters.
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 in Cisco BroadWorks verschieben.

Anweisungen zum Ausführen des Geräteverschiebungswerkzeugs im Reversemodus

Führen Sie die folgenden Schritte aus, um das Tool für die Geräteverschiebung im Reversemodus auszuführen:

Führen Sie den folgenden Befehl auf dem sekundären Cisco BroadWorks-Anwendungsserver im Verzeichnis des Tools zum Verschieben von Geräten aus:

Profile zurücksetzen

./devicemove.sh -input=  -revertProfiles

Nummern zurücksetzen

./devicemove.sh -input=  -revertNumbers

Terminal-Protokolle

Bei erfolgreicher Ausführung des Geräteverschiebungswerkzeugs für den Revert-Vorgang erhalten wir die folgenden Protokolle im Terminal:

Profile zurücksetzen

Werkzeugname: Version des Tools zum Verschieben von Geräten: 1.15.0 Gerätetool für Revert-Prozess gestartet... Geräte, die von Webex Calling zu BroadWorks zurückverschoben werden können: - ------------------------------------------------------------------------------------------------------------------- | Gerätetyp | Mac | Version | 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 | ------------------------------------------------------------------------------------------------------------------- Möchten Sie diese Geräte von Webex Calling zu BroadWorks wiederherstellen? (Ja, Y, Nein, N):  ja Hochladen von Geräteprofilen für DMS Cisco MPP LC Rebuild Geräteprozess gestartet Rebuild Geräteprozess erfolgreich abgeschlossen Neustartprozess gestartet Neustartprozess erfolgreich abgeschlossen Gerätemigration für Deprovisionierungsprozess abgeschlossen 

Nummern zurücksetzen

Werkzeugname: Version des Tools zum Verschieben von Geräten: 1.15.0 Möchten Sie das Zurücksetzen von Nummern auf BroadWorks fortsetzen?  ([J]e oder [N]e):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Vorgang „Zurücksetzen“ wird gestartet Broadworks-Telefonnummernprozess für Gruppen-ID aktiviert: collabmigrationtestGRP_engg Aktivieren des BroadWorks-Telefonnummernprozesses für groupId abgeschlossen: collabmigrationtestGRP_engg Rückgängigprozess der Gerätemigration erfolgreich abgeschlossen