Unterstützte Telefone werden vom Bereitstellungstool automatisch in Webex Calling erstellt und Benutzern zugewiesen. Die in der Spalte „Vom Geräteverschiebungstool unterstützt“ mit „Ja“ gekennzeichneten Telefone werden ebenfalls automatisch von Cisco BroadWorks oder BroadCloud zu Webex Calling verschoben, wenn das Geräteverschiebungstool ausgeführt wird. Bei Telefonen, die in dieser Spalte mit „Nein“ gekennzeichnet sind, ist ein manueller Eingriff erforderlich, um die DMS-URL in der Cisco BroadWorks-Gerätevorlage oder im Telefon selbst zu ändern.

Die letzte Spalte enthält die Zuordnung der Telefonmodelle zur Spalte „Gerätetyp“ der Datei. transform-tool/input/newphones.csv. (Weitere Informationen zu newphones.csv finden Sie im Abschnitt „ Transformationswerkzeug “ dieses Artikels).

Partneradministratoren müssen dieses Token-Generator-Tool mindestens einmal ausführen, bevor sie mit dem Ausführen 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 Partneradministratoren, sich über einen Webbrowser anzumelden, um das eindeutige TOKEN zu erhalten, das für die Aktualisierung der Partnerkonfigurationsdateien für die Migrationstools benötigt wird.

Voraussetzungen

Installieren Sie Java 8, 11, 17 oder 21 auf dem Computer. Java ist aus vielen Quellen erhältlich, darunter:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

Nach dem Herunterladen müssen die Binärdateien des Migrationstools extrahiert werden.

Anweisungen zum Ausführen

Führen Sie folgenden Befehl im Terminal im Verzeichnis des Token-Generators aus:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Ausgabe:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

Öffnen Sie die URL im Webbrowser auf dem Terminal, melden Sie sich mit den Partneradministrator-Zugangsdaten an, um das TOKEN zu erhalten, und kopieren Sie dieses zur weiteren Verwendung.

Die Abbildungen der Benutzeroberfläche sind unten zur Veranschaulichung dargestellt:

Abbildung 3: Mit Cisco Webex anmelden

Abbildung 4: Anmeldeinformationsfenster

Abbildung 5: Token-Generierung

Führen Sie die folgenden Schritte aus, 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 Gerätebewegungstool kommuniziert über OCI-P-Befehle mit BroadWorks. Um die OCI-P-Konnektivität zu aktivieren, führen Sie die folgenden Schritte aus:

Schritt 1: Verwenden Sie die Befehlszeilenschnittstelle (CLI), um die allgemeinen Einstellungen zu konfigurieren.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Führen Sie folgenden Befehl in der Befehlszeile aus, um die aktuellen GeneralSettings zu erhalten:

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

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

Wechseln Sie in das Verzeichnis OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Führen Sie den folgenden CLI-Befehl aus, um die aktuellen Einstellungen zu erhalten. Sie sollten Folgendes sehen:

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

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

Wechseln Sie in das Provisionierungsverzeichnis:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Überprüfen Sie, ob der 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 er noch nicht bereitgestellt oder gestartet wurde.

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Schritt 2: Starten Sie den Server mit diesem Befehl:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktivierung der Nummern

Führen Sie die folgenden Befehle in der Befehlszeile aus, um die Aktivierung der Nummern zu ermöglichen:

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

AS_CLI> cd SubscriberMgmt/NumberActivation

Schritt 2: Führen Sie den Befehl zur Aktivierung aus:

AS_CLI> set dnMode groupAndUserActivationEnabled

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

Für BroadCloud

Das Extraktionstool ist in das BroadCloud Service Provider Portal integriert. Ein Dienstanbieteradministrator kann:

1. Sie können Auszugsanfragen für bis zu 50 Kunden pro Anfrage einreichen.
   Für denselben Kunden können nicht mehr als 10 Auszugsanfragen pro Tag gestellt werden.
2. Sie können die extrahierte Datendatei im ZIP-Format bis zu 28 Tage nach dem Datum der Antragstellung herunterladen.

Die folgenden Abbildungen zeigen das Service Provider Portal.

Abbildung 6: Dienstanbieterportal

Abbildung 7: Dienstanbieterportal

CSV-Extrakt-Anfrage

CSV-Extraktionsanfrage initiieren

1. Kunden-CSV herunterladen

   Klicken Sie auf den Link Kunden-CSV herunterladen in der oberen rechten Ecke des Abschnitts CSV-Extraktionsanforderung initiieren.

2. Kundenliste bearbeiten

   Der Administrator kann diese CSV-Datei bearbeiten, sodass sie nur die Kunden enthält, für die der Datenextrakt durchgeführt werden soll.

3. Hochladen und Absenden

   Nach der Bearbeitung laden Sie die geänderte CSV-Datei hoch.

   Klicken Sie auf Absenden, um eine Extraktionsanfrage für die aufgelisteten Kunden und ihre zugehörigen Standorte zu starten.

Extraktionsanforderung für einen Kunden mit Standorten (CSV) initiieren

1. Kunden auswählen und Download-Standorte auswählen

   Wählen Sie einen Kunden aus der Dropdown-Liste aus.

   Laden Sie die entsprechende Datei locations.csv herunter von Kunden anzeigen→ Registerkarte Standorte → Standorte als CSV exportieren.

2. Bearbeiten Sie die Datei „Standorte“.

   Der Administrator kann die CSV-Datei bearbeiten und nur die gewünschten Speicherorte auswählen.

3. Hochladen und Absenden

   Laden Sie die bearbeitete locations.csv-Datei hoch und klicken Sie auf Absenden.

   Nur die für den ausgewählten Kunden angegebenen Standorte werden in die Extraktionsanforderung aufgenommen.

Datenextraktionsanfrage für alle Kunden initiieren

1. Klicken Sie auf Absenden, um eine Extraktionsanfrage für alle Kunden und alle ihre Standorte beim aktuellen Dienstanbieter zu initiieren.

Für Cisco BroadWorks und Webex für BroadWorks

1. Das Extraktionstool läuft auf dem sekundären Cisco BroadWorks Application Server innerhalb des Partnernetzwerks und stellt die Verbindung über OCI-P her.
2. Das Tool ruft Rohdaten zu Unternehmen, Gruppen, Nummern, Benutzern, Diensten, Geräten und Softclients von der Cisco BroadWorks- oder BroadCloud-Plattform ab und gibt diese Daten in XML-Dateien aus, die als Eingaben für das Transformationstool dienen.

In den folgenden Abschnitten wird die Installation und Konfiguration des Extraktionstools erläutert.

Voraussetzungen

1. Kopieren Sie die Binärdateien des Extraktionstools per SCP auf einen sekundären Cisco BroadWorks Application Server.
2. Stellen Sie eine SSH-Verbindung zum sekundären Cisco BroadWorks Application Server her, um die Voraussetzungen zu konfigurieren und das Extraktionstool auszuführen.
3. Konfigurieren Sie den Dienstanbieter und die Gruppen-ID, die aus Cisco BroadWorks extrahiert werden sollen. conf/exportTool.yml. Siehe folgendes YAML-Beispiel:

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

4. Stellen Sie sicher, dass die sekundäre Cisco BroadWorks Application Server-Benutzer-ID, das Passwort und der Hostname korrekt sind. conf/partner.cfg Datei:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   Die REFRESH_TOKEN -Eigenschaft ist für eine Webex-zu-BroadWorks-Migration obligatorisch.

5. Ändern Sie die JDK/JRE Umgebungspfad in der Datei export.sh, falls der sekundäre Cisco BroadWorks Application Server JDK/JRE Der Umgebungspfad unterscheidet sich vom Dateipfad:

   JAVA_HOME=/usr/local/java/java_base

Anweisungen zum Ausführen

Führen Sie im sekundären Cisco BroadWorks Application Server aus dem Verzeichnis des Extraktionstools folgenden Befehl aus:

./export.sh

Terminalprotokolle

Nach erfolgreichem Export sind im Terminal folgende Protokolle verfügbar: Ausführen des BroadSoft-Datenexporttools:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

Ausgabe

Eine Ausgabedatei im ZIP-Format (extracted_data_<timestamp>.zip) befindet sich im selben Verzeichnis wie das Extraktionstool. Verwenden Sie den folgenden Befehl, um die ZIP-Datei für die Eingabe des Transformationswerkzeugs anzuzeigen und zu verwenden:

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

Dieses Transformationstool wird für alle Migrationen ausgeführt. Das Transformationstool läuft auf jedem Computer, einschließlich des Administrator-Laptops eines Partners, und nutzt die öffentlichen Webex-APIs. Es liest die vom Extraktionstool ausgegebene ZIP-Datei (extracted_data_<timestamp>.zip) als Eingabe und wandelt das rohe XML in ein JSON-Format um, das vom Bereitstellungstool verwendet wird.

Voraussetzungen

Nach dem Herunterladen und Entpacken der Binärdateien der Migrationstools müssen die folgenden Voraussetzungen konfiguriert werden:

1. Legen Sie das REFRESH_TOKEN (Token aus dem Token-Generator-Tool kopiert) und den NAME_OF_MAIN_LOCATION in der conf/partner.cfg Datei:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Optional kann die PROVISIONING_- ID (aus der Vorlage im Partner Hub kopiert) in der conf/partner.cfg Datei:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Um eine vollständigere Überprüfung der Kunden-E-Mail-Adresse zu erhalten, können Sie optional die PROVISIONING_- ID festlegen.
3. Fehlende Informationen im input/customers.csv Datei (siehe nächster Abschnitt), falls fehlt.
4. Fügen Sie die E-Mail-Adresse des Endbenutzers hinzu in der input/users.csv Datei.
5. Wenn neue Telefone eingerichtet werden sollen, fügen Sie die MAC-Adresse und die E-Mail-Adresse des neuen Telefons des Benutzers hinzu. input/newphones.csv Datei. Dies ist nur erforderlich, wenn die Partneradministratoren neue Telefone im Rahmen des Wholesale-Telefonie-Programms bereitstellen möchten.
6. Konvertieren Sie die BroadWorks Call Center mithilfe von CxEssentials in CxEssentials. input/cxessentials.csv Datei.
7. Optional können Sie die Eigenschaft UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS aktivieren, um alle Call Center auf CxEssentials umzustellen.
8. Verwenden Sie die input/locations.csv Datei zur Unterstützung der Migration großer Unternehmen, die es Administratoren ermöglicht, die Standorte ihrer Kunden standortbezogen zu migrieren
9. Optional kann die Verwendung von MAC-Adressen aus dem User-Agent-Header der SIP REGISTER-Nachricht aktiviert werden, wenn die MAC-Adresse im Cisco BroadWorks-Geräteprofil nicht verfügbar ist. Entfernen Sie die Kommentarzeichen vor der Zeile USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes in Datei conf/partner.cfg
10. Optional können Sie die Eigenschaften ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD und ANALOG_USER_TYPE_DISABLE_T38 aktivieren, um die Einstellungen für Anklopfen und Wartemusik zu konfigurieren sowie T38 für alle Benutzer vom Typ Analog zu deaktivieren.

11. Wenn Sie generische Gateway-Geräte einrichten möchten, fügen Sie die MAC-Adresse und die Benutzer-ID des Geräts hinzu. input/genericgateways.csv Datei. Geben Sie außerdem an, ob es sich bei dem Benutzer um den primären Eigentümer oder einen gemeinsam genutzten Benutzer handelt (für gemeinsam genutzte Anrufe). Dies ist nur erforderlich, wenn Partneradministratoren planen, generische Gateway-Geräte im Wholesale Calling zu verwenden.

    Diese Funktion ist für Migrationen von BroadCloud zu Wholesale nicht verfügbar.

12. Um bei BroadCloud-Migrationen alle Benutzer mit dem Stationstyp „Messaging“ in voice_mail_groupumzuwandeln, aktualisieren Sie die Datei conf/rialto_station_type_to_wholesale_package.csv, indem Sie den Wert Wholesale Package in der Zeile, in der der Stationstyp Rialto „Messaging“ ist, durch voice_mail_group ersetzen.

    Optional können Sie die Eigenschaft COMMON_VOICE_MAIL_GROUP_PASSCODE in partner.cfg aktivieren, um die Standard-PIN für Voicemail-Gruppen zu konfigurieren.

    Wenn diese Eigenschaft nicht in partner.cfgangegeben ist, muss sie für jeden Kunden in der Datei customers.csv in der Spalte commonVoicemailGroupPassCode angegeben werden.

13. Für die Migration gemeinsamer Kontakte zu Webex Calling

    Es handelt sich um eine Erweiterung für die Verwaltung von gemeinsamen Kontakten auf Unternehmens- und Standortebene. Diese Kontakte können nun je nach Konfigurationseinstellungen entweder als Organisationskontakte (Org Contacts) oder als virtuelle Nebenstellen migriert werden. Nachfolgend finden Sie alle Details, die Sie durch diesen Migrationsprozess führen.

    Schlüsselkonfiguration:

    • Gemeinsame_Telefonnummer_Liste_bis_Virtuelle_Nebenstelle_Startbereich_

      In der Datei partner.cfg wird eine neue Eigenschaft eingeführt: COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE. Diese Eigenschaft legt fest, wie gemeinsame Kontakte von Rialto zu Webex Calling migriert werden.

    • Ohne COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfiguriert

      Gemeinsame Kontakte werden als Organisationskontakte (Org Contacts) migriert.

      Es ist keine zusätzliche Konfiguration erforderlich.

      Die Ansprechpartner bleiben auf Organisationsebene erreichbar.

    • Mit der Konfiguration COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Gemeinsame Kontakte werden als virtuelle Nebenstellen migriert.

      Jedem Kontakt wird eine Durchwahlnummer angehängt, und der Startbereich der Durchwahl wird in der Eigenschaft COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE in partner.cfg definiert.

      Virtuelle Nebenstellen werden je nach Umfang des Kontakts sowohl auf Organisationsebene als auch auf Standortebene unterstützt.

14. Aktivieren Sie Webex als Standardanbieter für die Anrufaufzeichnung.

    Dieser Schritt ist nur erforderlich, wenn die Anrufaufzeichnungseinstellungen für Benutzer, die mit Dubber konfiguriert sind, auf Cisco Native Call Recording in Webex migriert werden.

    So aktivieren Sie diese Option:

    • In der partner.cfg-Datei legen Sie die folgende Eigenschaft fest: DEFAULT_CALL_RECORDING_VENDOR=Webex.
    • Zusätzlich kann die Eigenschaft WEBEX_CALL_RECORDING_STORAGE_REGION verwendet werden, um den Speicherbereich zu konfigurieren.

      Die Aufzeichnungsoption On Demand von BroadCloud wird in Webex Calling nicht unterstützt. Diese Anrufaufzeichnungseinstellungen werden nicht migriert und erscheinen im Ausnahmereport.

15. Ausschluss ausgewählter Telefonnummern von der Migration:

    Um bestimmte Telefonnummern vom Migrationsprozess auszuschließen, muss das folgende zweistufige Verfahren unter Verwendung des Transformationstools befolgt werden:

    • Führen Sie das Transformationswerkzeug zunächst zum ersten Mal aus. Nach Abschluss des Vorgangs generiert das Tool eine Datei namens telephone_numbers_inventory.csv, die sich im folgenden Verzeichnis befindet: output/timestamp/ Verzeichnis. Der Kunde ist verpflichtet, diese Datei zu überprüfen und in der Spalte „Drop Tn's“ für jede Telefonnummer, die von der bevorstehenden Migration ausgeschlossen werden soll, ein „Ja“ anzugeben.
    • Nach der Aktualisierung der telephone_numbers_inventory.csv-Datei mit den entsprechenden Ausschlussflags wird das Transformationstool ein zweites Mal ausgeführt. Die aktualisierte Datei sollte als Argument im folgenden Format übergeben werden.

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

Auffüllen input/customers.csv

Die Datei input/customers.csv liefert Daten, die in Cisco BroadWorks oder BroadCloud möglicherweise fehlen. Diese Datei kann leer bleiben, wenn alle erforderlichen Informationen bereits vorliegen. Sie müssen nicht alle Spalten ausfüllen, nur die fehlenden Angaben sind Pflicht.

Die folgende Tabelle erläutert die wichtigsten Spalten in input/customers.csv.

Auffüllen input/users.csv

Die Datei input/users.csv liefert Daten, die in Cisco BroadWorks oder BroadCloud möglicherweise fehlen. Diese Datei kann leer bleiben, wenn alle erforderlichen Informationen bereits vorliegen. Sie müssen nicht alle Spalten ausfüllen, nur die fehlenden Angaben sind Pflicht.

Anweisungen zum Ausführen

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 unter Windows zu starten:

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

macOS

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

1. Erstellen Sie eine virtuelle Umgebung und installieren Sie die 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
   python3 -m pip install phonenumbers
   

2. Führen Sie das Transformationswerkzeug aus:

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

Customer/user Vorabprüfung

Das Transform-Tool führt API-Aufrufe an Webex durch, um potenzielle Bereitstellungsprobleme zu erkennen. Standardmäßig werden die Adresse und die primäre E-Mail-Adresse des Kunden überprüft. Wenn der Wert für die PROVISIONING_ID in der conf/partner.cfg Es wird auch die Standortinformationen überprüfen. Die Ergebnisse der Vorprüfung sind im Ausnahmereport enthalten.

Zusätzlich können beim Ausführen des Transformationswerkzeugs die folgenden optionalen Parameter hinzugefügt werden:

Vorabprüfung

Zusätzlich zur Ausführung der Precheck-API für die Kundeninformationen führt das Transform Tool auch die Precheck-API für die Abonnenten-E-Mails aus.

Vorabprüfungsinformationen

Standardmäßig werden nur Vorabprüfungsfehler (d. h. Probleme, die die Bereitstellung blockieren) in den Ausnahmebericht aufgenommen. Durch das Hinzufügen dieses Flags werden auch erfolgreiche Vorabprüfungsergebnisse berücksichtigt (z. B. wenn bereits eine Webex-Organisation existiert, die automatisch angehängt werden kann).

Terminalprotokolle

Folgende Protokolle werden im Terminal nach erfolgreicher Transformation angezeigt:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Ausnahmebericht

Das Transformationstool generiert den Ausnahmebericht innerhalb des output/<timestamp>/exception_report.txt Verzeichnis. Mithilfe dieses Berichts können Sie die Probleme identifizieren, die die Migration beeinträchtigen werden, und diese im Cisco BroadWorks-System beheben.

Nachdem Sie die Benutzerdaten so angepasst haben, dass die Ausnahme behoben wird, führen Sie die Extraktions- und Transformationswerkzeuge mit den neuen Daten erneut aus. Die Beispiel-Ausnahmeberichtdatei sieht wie folgt aus:

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

Ausgabe

Eine JSON-Ausgabedatei (customer.json) wird im Verzeichnis output/<timestamp>verfügbar sein. /<groupid> Verzeichnis. Die Beispiel - Customer.json - Datei sieht wie folgt aus:

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

Das Provisionierungstool kann auf jedem beliebigen Rechner ausgeführt werden, üblicherweise auf dem Laptop des Partneradministrators, und verwendet die öffentlichen Webex-APIs. Es liest die JSON-Ausgabedatei des Transformationstools (customer.json) 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, 17 oder 21 auf dem Computer. Java ist aus vielen Quellen erhältlich, darunter:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Nach dem Herunterladen und Entpacken der Binärdateien der Migrationstools muss die Umgebungsvariable JAVA_HOME in der provisioning_tool.sh-Datei für MAC und der provisioning_tool.bat-Datei für Windows gesetzt werden.
3. Die partner.cfg-Datei:
   • Legen Sie die WHOLESALE_PROVISIONING_ID und das REFRESH_TOKEN fest (Token aus dem Token Generator Tool kopiert). Die Partneradministratoren müssen sich an ihr Account-Team wenden, um die PROVISIONING_ID zu erhalten:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Setzen Sie ALLOW_ADMIN_INVITE_EMAILS auf false, wenn Partner keine Willkommens-E-Mail an die Benutzer senden möchten. Der Standardwert ist „true“.

     Webex versendet Willkommens-E-Mails nur an Endbenutzer. Kundenadministratoren erhalten keine Willkommens-E-Mails.

     Benutzer und Kundenadministratoren mit Sitz in den USA und Kanada erhalten eine separate E-Mail-Benachrichtigung von RedSky. Die RedSky E911-Plattform versendet diese E-Mail zur Bestätigung der Erstellung des Kundenkontos für Notrufdienste. Diese RedSky-E-Mail ist von den Webex-Willkommens-E-Mails getrennt und wird nicht durch die Webex-E-Mail-Einstellungen gesteuert. Für Großhandelsorganisationen in den USA und Kanada ist RedSky automatisch als Notfalldienstleister aktiviert.

4. Verwenden Sie die Eigenschaft WEBEX4BWKS_EMAIL_SUBJECT für Webex for BroadWorks-Migrationen, um den Betreff der E-Mail-Anfrage zur Passwortänderung für Webex for BroadWorks-Abonnenten festzulegen.
5. Verwenden Sie die Eigenschaft WEBEX4BWKS_EMAIL_BODY für Webex for BroadWorks-Migrationen, um den E-Mail-Text der Passwortänderungsanforderung für Webex for BroadWorks-Abonnenten zu senden.
6. Verwenden Sie die CUSTOM_TAGS -Eigenschaft, um Tags nach der Kundenerstellung hinzuzufügen.

Anweisungen zum Ausführen

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 Windows auszuführen:

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

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

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

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

Partneradministratoren müssen ihre BroadWorks-Onboarding-Vorlage für Webex aktualisieren, damit die BroadWorks-Koexistenzfunktionen funktionieren. Siehe folgendes Bild:

Sobald die Webex for BroadWorks Onboarding-Vorlage aktualisiert ist, um die Migration zu unterstützen, bitten Sie das Cisco Account Team, die Funktion "wholesale-partner-blending-enabled" auf Partnerebene zu aktivieren. Dadurch können Wholesale-Pakete während der Bereitstellung zu bestehenden Webex for BroadWorks-Kundenorganisationen hinzugefügt werden.

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

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

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

Phase nach der Migration: Dies ist die letzte Phase, in der Administratoren BroadWorks vollständig auf Wholesale umstellen können. Sie müssen das Provisionierungstool mit dem Argument postmigrationausführen.

Terminalprotokolle

Nachfolgend die Protokolle im Terminal nach erfolgreicher Bereitstellung:

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

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

Ausgabe

Das Provisionierungstool generiert Erfolgs- und Fehlerberichte innerhalb des output/<external_id>/*.success/error Dateien. Überprüfen Sie die Erfolgs- und Fehlerprotokolle, um die erfolgreiche Bereitstellung zu bestätigen.

Das System erzeugt eine Provisioning_Report_*.csv Datei im Verzeichnis output/consolidated_reports/. Diese Datei enthält sowohl Erfolgs- als auch Fehlerdetails für jede Entität und ihre Einstellungen und bietet somit einen umfassenden Bereitstellungsbericht.

Partneradministratoren können die Kundenbereitstellung im Partner Hub und Control Hub Portal überprüfen. Siehe die folgenden Abbildungen aus dem Partner Hub und Control Hub Portal:

Abbildung 8: Partner Hub

Abbildung 9: Control Hub

Abbildung 10: Geräte

Abbildung 11: Anrufe

Nachbereitungsbeschränkungen

Sobald die Bereitstellung für eine BroadCloud-Migration abgeschlossen ist, werden die folgenden Aktionen blockiert. :

• CAP-Portal – Hinzufügen von Benutzern oder portierten Geräten.
• SP Portal – Erstellen von ADD-Bestellungen mit Geräten oder Nummern.
• RSB API – Erstellen von ADD-Bestellungen mit Geräten oder Nummern und Erstellen von Benutzern. RSB ADD-Bestellungen mit Geräte- oder Zahlenangaben werden abgelehnt.

Für BroadCloud

BroadCloud-Partner können über das Service Provider Portal eine Migrationsanfrage für Nummern, Geräte und Shared Call Appearances (SCA)-Migrationen einreichen.

Im Service Provider Portal kann eine Migrationsanfrage bis zu 50 Kunden umfassen. Pro Tag können maximal 10 Anfragen gestellt werden.

Administratoren können die automatische Rücksetzung aktivieren, indem sie ROLLBACK_TO_BROADCLOUD=true in der conf/partner.cfg -Datei einstellen. Dadurch werden Geräte nach der Migration wieder zu BroadCloud zurückversetzt. Es unterstützt sowohl Migrationen innerhalb derselben Region als auch in verschiedene Regionen mit NS Sync, jedoch nur bei erfolgreichen Migrationen. Bei fehlgeschlagenen Rollbacks müssen Administratoren ein Cisco TAC-Ticket eröffnen, bevor sie einen Rollback anfordern können.

Im Portal stehen zwei Optionen zur Auswahl des Migrationstyps zur Verfügung:

• Migration – Wählen Sie diese Option, um eine Anfrage zur Migration von Nummern, Geräten und Shared Call Appearances (SCA) zu initiieren.
• Gerätestatus – Wählen Sie diese Option, um den aktuellen Status eines Geräts auf BroadCloud and Calling anzuzeigen.

Die folgenden Abbildungen zeigen das Dienstanbieterportal.

Abbildung 12: Dienstanbieterportal

Abbildung 13: Dienstanbieterportal

Ausgewählte Standorte migrieren (optional)

Um die Migration für eine bestimmte Teilmenge der in der customer.json -Datei aufgeführten Standorte zu starten, fügen Sie Ihrer Anfrage eine locations.csv -Datei bei. Diese CSV-Datei sollte nur die Standorte auflisten, die Sie migrieren möchten.

Um die Liste der verfügbaren aktiven Standorte herunterzuladen, navigieren Sie zu Kunden anzeigen → Kunde auswählen → Standorte als CSV exportieren.

Abbildung 14: Standorte als CSV exportieren

Aktivieren Sie die Option „Verbindungsnummern“.

Wenn Sie denselben SIP-Trunk für Webex Calling und BroadCloud Carrier verwenden, sollten Administratoren die Option Disconnect Numbers verwenden. Dadurch werden Telefonnummern nach der Migration in BroadCloud für eingehende Anrufe gesperrt.

Um diese Option zu aktivieren,

1. In der Datei partner.cfg setzen Sie_DISCONNECT NUMBERS_FROM_RIALTO = Ja.
2. Führen Sie das Migrationstool erneut aus, indem Sie dieselbe customer.json Datei und die aktualisierte partner.cfgverwenden.

Falls die Verbindung nicht hergestellt werden kann, stellen Sie eine Cisco TAC - Anfrage.

Für Cisco BroadWorks und Webex für BroadWorks

Bei Migrationen von Cisco BroadWorks und Webex für BroadWorks läuft das Tool auf dem sekundären Cisco BroadWorks Application Server innerhalb des Partnernetzwerks und stellt die Verbindung zum AS über OCI-P her. Es verwendet die JSON-Ausgabedatei des Transform Tools (customer.json) als Eingabe und führt die OCI-P-Befehle aus, um Geräte und Softclients zu migrieren.

Bei erfolgreicher Ausführung wird das Werkzeug zum Verschieben des Geräts Folgendes tun:

1. Geräte von Cisco BroadWorks abmelden und bei Wholesale anmelden.
2. Benutzer, die den UC-One-Client verwenden, werden beim ersten Anmelden zur Webex-App weitergeleitet.
3. Deaktivieren Sie die Telefonnummern in Cisco BroadWorks oder entfernen Sie die Telefonnummern aus BroadCloud.
4. Nummern im Großhandel aktivieren.
5. Erstellen Sie gemeinsame Anrufdarstellungen in Wholesale für BroadCloud-Migrationen. [This Dieser Schritt gilt nur für BroadCloud. migrations].

SCP und SSH

1. Führen Sie SCP mit dem Device Move Tool auf dem sekundären Cisco BroadWorks Application Server durch.
2. Stellen Sie eine SSH-Verbindung zum sekundären Cisco BroadWorks Application Server her, um die Voraussetzungen zu konfigurieren und das Geräteverschiebungstool auszuführen.

Voraussetzungen

1. Setzen Sie das REFRESH_TOKEN (Token, das vom Token-Generator-Tool kopiert wurde) in der conf/partner.cfg Datei:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Stellen Sie sicher, dass die sekundäre Cisco BroadWorks Application Server-Benutzer-ID, das Passwort und der Hostname korrekt sind. conf/deviceMoveTool.conf Datei:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Um Aktivierungs-E-Mails erneut zu senden, müssen Sie RESEND_INVITATION_einstellen. EMAILS=true im conf/partner.cfg Datei.

   Wenn Administratoren während der Migration Einladungs-E-Mails an ihre Benutzer senden möchten, sollten sie die Zeile "RESEND_INVITATION_" einkommentieren. EMAILS=true" Eigentum in der conf/partner.cfg Datei. Ansonsten sollte die Immobilie unverändert bleiben.

4. Überprüfen Sie die JDK/JRE Der Umgebungspfad in devicemove.sh ist korrekt.

   JAVA_HOME=/usr/local/java/java_base

5. Administratoren können die Datei locations.csv aus dem Eingabeverzeichnis verwenden, um anstelle aller Gruppen innerhalb eines Unternehmens nur bestimmte Gruppen zu migrieren.

Polycom-Telefone

Um Polycom-Telefone von Cisco BroadWorks zu Wholesale Calling zu migrieren, muss ein Partneradministrator ein neues Konto erstellen. Identity/Device Profiltypdatei auf Systemebene in Cisco BroadWorks jede Polycom-Gerätevorlage. Siehe Abbildung 14 und lade die benutzerdefinierte Datei hoch. device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Nach dem Hochladen der neuen Gerätedatei muss sichergestellt werden, dass die neu erstellte Datei auf Gruppenebene vorhanden ist. Stellen Sie außerdem sicher, dass die Datei migration_%BWMAC ADDRESS%.cfg nicht mit einer bereits vorhandenen Datei auf Ihrem System in Konflikt steht.

Es 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 verweist auf migration_%BWMACADDRESS%.cfg.
2. Erstellen Sie die Geräteprofile auf Gruppenebene oder Geräteebene neu.
   Ob auf Gruppen- oder Geräteebene gehandelt wird, hängt von der Konfiguration des Parameters deviceLevelRebuild in der Datei ab. device-move-tool/conf/partner.cfg.
3. Das Tool zum Verschieben von Geräten fordert den Cisco BroadWorks Application Server auf, Telefone auf Gruppenebene oder Geräteebene neu zu starten.
4. Nach der Neustartanforderung laden und verarbeiten Polycom-Telefone die Datei% BWMACADDRESS%.cfg, welche die Polycom-Telefone auffordert, die Datei migration_%BWMACADDRESS%.cfg herunterzuladen und zu verarbeiten, welche den Wert device.prov.serverName auf https://plcm.sipflash.com.setzt.
   https://plcm.sipflash.com Für die USA gilt die URL; andere Regionen haben unterschiedliche URLs.
5. Das Polycom-Telefon lädt die Datei %BWMACADDRESS%.cfg von https://plcm.sipflash.com herunter und wird vom Webex Calling DMS verwaltet.

Abbildung 14: Identity/device Profildatei hinzufügen

Anweisungen zum Ausführen

Es gibt zwei Methoden, um das DMT aufzurufen: die erste Methode kann für jeden Kunden einzeln aufgerufen werden, die zweite Methode kann für mehrere Kunden gleichzeitig ausgeführt werden.

Das Tool zum Verschieben von Geräten wird vom sekundären Cisco BroadWorks Application Server innerhalb des Verzeichnisses des Tools zum Verschieben von Geräten ausgeführt:

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

Terminalprotokolle

Nachfolgend die Protokolle im Terminal nach erfolgreicher Ausführung des Tools zum Verschieben von Geräten für die Gerätemigration:

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

Ausgabe

Nach der Gerätemigration sind die Geräte online und betriebsbereit. make/receive Anrufe. Ein Beispiel für den Gerätestatus finden Sie in Abbildung 15:

Abbildung 15: Gerätestatus

Nach der Geräteumstellung sind die Nummern wieder aktiv. In Abbildung 16 ist ein Beispiel dafür zu sehen, welche Zahlen aktiv sind:

Abbildung 16: Aktive Zahlen

Der Rücksetzungsvorgang muss für jeweils ein Unternehmen durchgeführt werden.

Für BroadCloud Carrier

Administratoren können ROLLBACK_TO_BROADCLOUD=true in conf/partner.cfg setzen, um ein automatisches Rollback zu aktivieren. Dadurch werden die Geräte nach erfolgreicher Migration innerhalb derselben oder einer anderen Region mit NS Sync wieder an BroadCloud zurückgesendet. Bei fehlgeschlagenen Migrationen wenden Sie sich bitte an den Cisco TAC, bevor Sie einen Rollback anfordern.

Für Cisco BroadWorks und Webex für BroadWorks

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

1. Eröffnen Sie ein Ticket beim Cisco TAC, um eine Gerätewiederherstellung anzufordern.
2. Führen Sie das Geräteverschiebungstool im Rückgängig-Modus auf dem sekundären BroadWorks Application Server aus, um die Gerätemigrationen rückgängig zu machen. Dadurch wird die DMS-URL für Geräteprofile in Cisco BroadWorks wieder auf die DMS-URL des Dienstanbieters zurückgesetzt und Telefonnummern reaktiviert.
3. Das Webex Calling Team setzt die DMS-URL in den Geräteprofilen von Webex Calling wieder auf die DMS-URL des Dienstanbieters 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 wieder zu Cisco BroadWorks übertragen.

Anleitung zum Ausführen des Geräteverschiebungstools im Rückwärtsmodus

Führen Sie die folgenden Schritte aus, um das Tool zum Verschieben des Geräts im Rückgängig-Modus auszuführen:

Führen Sie den folgenden Befehl im sekundären Cisco BroadWorks Application Server im Verzeichnis des Geräteverschiebungstools aus:

Profile zurücksetzen

./devicemove.sh -input=  -revertProfiles

Zahlen umkehren

./devicemove.sh -input=  -revertNumbers

Terminalprotokolle

Nach erfolgreichem Ausführen des Tools zum Verschieben des Geräts für den Rückgängigmachungsvorgang erhalten wir die folgenden Protokolle im Terminal:

Profile zurücksetzen

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

Zahlen umkehren

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