Danke für Ihr Feedback.

Unterstützte Telefone werden Webex Calling vom Provisioning-Tool automatisch erstellt und Benutzern zugewiesen. Die Telefone, die in der Spalte „Im Device Move Tool unterstützt“ mit „Ja“ markiert sind, werden ebenfalls automatisch von Cisco BroadWorks oder BroadCloud dorthin verschoben, Webex Calling wenn das Device Move Tool ausgeführt wird. Telefone, die in dieser Spalte mit „Nein“ markiert 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 enthält die Zuordnung von Telefonmodellen zur Spalte „Gerätetyp“ der Datei transform-tool/input/newphones.csv. (Weitere Informationen zu newphones.csv finden Sie im Abschnitt Transform-Tool in diesem Artikel ).

Partneradministratoren führen dieses Tool zur Token-Generierung mindestens einmal aus, bevor sie mit der Ausführung der Migrationstools beginnen. Das Ausführen dieses Tools ist eine einmalige Aktivität, nachdem das Partnerkonto in die Wholesale RTM-Lösung integriert wurde. Mit diesem Tool können sich Partneradministratoren über einen Webbrowser anmelden, 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 verfügbar, darunter:

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

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

Anweisungen zum Laufen

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

Fenster:

token_generator.bat

macOS:

./token_generator.sh

Ausgang:

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 Anmeldedaten des Partneradministrators an, um das TOKEN zu erhalten, und kopieren Sie es für die weitere Verwendung.

Die Abbildungen der Benutzeroberfläche sind unten als Referenz aufgeführt:

Abbildung 3: Einloggen mit Cisco Webex

Abbildung 4: Fenster „Anmeldeinformationen“

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 mit BroadWorks über OCI-P-Befehle. Gehen Sie wie folgt vor, um die OCI-P-Konnektivität zu aktivieren:

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Führen Sie den folgenden Befehl in der 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 auf 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 OCI Provisioning zu konfigurieren.

Wechseln Sie in das Provisioning-Verzeichnis:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

Schritt 4: Führen Sie den folgenden Befehl in der CLI 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.

Stellen Sie sicher, dass Open 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 nicht bereitgestellt ist oder noch nicht gestartet wurde .

Schritt 1: Stellen Sie den Server mit dem folgenden 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

Aktivieren Sie die Aktivierung von Nummern

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

Schritt 2: Führen Sie den Befehl Activation enabled aus:

AS_CLI> set dnMode groupAndUserActivationEnabled

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

Für BroadCloud

Das Extraktionstool ist in das BroadCloud Service Provider-Portal integriert. Ein Dienstanbieter-Admin kann:

1. Reichen Sie Extraktanfragen für bis zu 50 Kunden pro Anfrage ein.
   Eine Extraktanfrage kann für denselben Kunden nicht öfter als 10 Mal an einem Tag eingereicht werden.
2. Laden Sie die entpackte Datendatei im ZIP-Format für bis zu 28 Tage ab dem Datum der Einreichung der Anfrage herunter.

Die folgenden Abbildungen zeigen das Service Provider-Portal.

Abbildung 6: Service Provider-Portal

Abbildung 7: Service Provider-Portal

CSV-Extrakt-Anfrage

CSV-Extraktanfrage einleiten

1. Laden Sie die Kunden-CSV herunter

   Klicken Sie oben rechts im Abschnitt CSV-Extraktanfrage einleiten auf den Link Kunden-CSV herunterladen.

2. Bearbeiten Sie die Kundenliste

   Der Administrator kann diese CSV-Datei bearbeiten, um nur die Kunden einzubeziehen, für die der Extrakt durchgeführt werden muss.

3. Hochladen und Absenden

   Laden Sie nach der Bearbeitung die geänderte CSV-Datei hoch.

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

Initiieren Sie eine Extraktanfrage für einen Kunden mit Standort-CSV

1. Wählen Sie Kunden aus und laden Sie Standorte herunter

   Wählen Sie einen Kunden aus dem Drop-down-Menü aus.

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

2. Bearbeiten Sie die Locations-Datei

   Der Administrator kann die CSV-Datei so bearbeiten, dass sie nur die Standorte enthält, die er extrahieren möchte.

3. Hochladen und Absenden

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

   Nur die angegebenen Standorte für den ausgewählten Kunden werden in der Extraktanforderung enthalten sein.

Extraktanfrage für alle Kunden einleiten

1. Klicken Sie auf Senden, um eine Extraktanforderung für alle Kunden und alle ihre Standorte unter dem aktuellen Dienstanbieter zu starten.

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 eine Verbindung über OCI-P her.
2. Das Tool ruft Rohdaten von Unternehmen, Gruppen, Nummern, Benutzern, Diensten, Geräten und Soft-Clients von der Cisco BroadWorks- oder BroadCloud-Plattform ab und gibt diese Daten in XML-Dateien aus, die die Eingaben für das Transformationstool bereitstellen.

In den nächsten Abschnitten wird erklärt, wie das Extraktionstool installiert und konfiguriert wird.

Voraussetzungen

1. SCP die Binärdateien des Extraktionstools auf den sekundären Cisco BroadWorks Application Server.
2. SSH mit dem sekundären Cisco BroadWorks Application Server verbinden, um die Voraussetzungen zu konfigurieren und das Extraktionstool auszuführen.
3. Konfigurieren Sie den Dienstanbieter und die Gruppen-ID zum Extrahieren aus Cisco BroadWorks in der Datei conf/ExportTool.yml. Sehen Sie sich den folgenden Beispiel-YAML-Schnipsel an:

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

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

   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 Eigenschaft REFRESH_TOKEN ist für eine Webex for BroadWorks-Migration erforderlich.

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

   JAVA_HOME=/usr/local/java/java_base

Anweisungen zum Laufen

Führen Sie den folgenden Befehl im sekundären Cisco BroadWorks Application Server aus dem Extrakt-Tool-Verzeichnis aus:

./export.sh

Terminalprotokolle

Die folgenden Protokolle sind bei erfolgreichem Export im Terminal verfügbar: BroadSoft Data Export Tool ausführen:

 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 <timestamp>ZIP-Ausgabedatei (extracted_data_ .zip) ist im gleichen Extrakt-Tool-Verzeichnis verfügbar. Verwenden Sie den folgenden Befehl, um die ZIP-Datei für die Transform Tool-Eingabe anzuzeigen und zu verwenden:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 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

Wenn der Administrator das Tool hinter einem Unternehmens-Proxy bedient, folgen Sie den folgenden Schritten, um das Exportskript zu konfigurieren und auszuführen.

Schritte zur Konfiguration und Ausführung des Export-Skripts

1. Öffnen Sie die Datei export.sh.
2. Suchen Sie die HTTPS_PROXY_HOST-Variable und kommentieren Sie sie aus (entfernen Sie das führende #).

3. Stellen Sie den HTTPS_PROXY_HOST-Wert ein als:

   HTTPS_PROXY_HOST=<proxy-host>

4. Suchen Sie die HTTPS_PROXY_PORT-Variable und kommentieren Sie sie aus (entfernen Sie das führende #).
5. Stellen Sie den HTTPS_PROXY_PORT-Wert ein als:

   HTTPS_PROXY_PORT=<proxy-port>

6. Speichern und schließen Sie die Datei export.sh.
7. Öffnen Sie die Datei partner.cfg und fügen Sie das erforderliche refresh_token hinzu.
8. Stellen Sie sicher, dass der BroadWorks-Host, der Benutzername und das Passwort in partner.cfg korrekt konfiguriert sind.
9. Führen Sie das Skript aus:

   ./export.sh

Verlobungsformular:

Das Extract Tool (BroadCloud und BroadWorks) generiert jetzt während der Ausführung automatisch eine konsolidierte XLSX-Datei mit dem Titel Engagement Form SUA.xlsx. Die Datei ist vorab mit allen verfügbaren Daten aus den relevanten Arbeitsblättern gefüllt, was dazu beiträgt, die Bearbeitung durch den Partner zu optimieren und zu beschleunigen .

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

Voraussetzungen

Nachdem Sie die Binärdateien der Migrationstools heruntergeladen und extrahiert haben, konfigurieren Sie die folgenden Voraussetzungen:

1. Stellen Sie REFRESH_TOKEN (aus dem Token-Generator-Tool kopiertes Token) und NAME_OF_MAIN_LOCATION in der Datei conf/partner.cfg ein:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   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. Konfigurieren Sie fehlende Informationen in der Datei input/customers.csv (siehe nächsten Abschnitt), falls sie fehlen.
4. Fügen Sie die E-Mail-Adresse des Endbenutzers in die Datei input/users.csv ein.
5. Wenn neue Telefone bereitgestellt werden sollen, fügen Sie die Mac-Adresse und die E-Mail-Adresse des neuen Telefons des Benutzers zur Datei input/newphones.csv hinzu. Dies ist nur erforderlich, wenn die Partneradministratoren neue Telefone in Wholesale Calling bereitstellen möchten.
6. Konvertieren Sie die BroadWorks Call Center 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 umzuwandeln.
8. Verwenden Sie die Datei input/locations.csv, um die Migration großer Unternehmen zu unterstützen, die es Administratoren ermöglicht, die Standorte ihrer Kunden nach Standort zu migrieren
9. Aktivieren Sie optional die Verwendung von MAC-Adressen aus dem User-Agent-Header der SIP REGISTER-Nachricht, wenn die MAC-Adresse im Cisco BroadWorks-Geräteprofil nicht verfügbar ist. Entkommentieren Sie die Zeile USE_MAC_ADDRESS_FROM_SIP_REGISTER=YES in der Datei conf/partner.cfg
10. Aktivieren Sie optional die Eigenschaften ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD und ANALOG_USER_TYPE_DISABLE_T38, um die Anrufwartezeit und Wartemusik zu konfigurieren und die T38-Einstellungen für alle analogen Benutzer zu deaktivieren.

11. Wenn Sie generische Gateway-Geräte einrichten möchten, fügen Sie die MAC-Adresse und Benutzer-ID des Geräts zur Datei input/genericgateways.csv hinzu. Geben Sie auch an, ob der Benutzer der PRIMÄRE Eigentümer oder ein SHARED-Benutzer ist (für Auftritte mit geteilten Anrufen). Dies ist nur erforderlich, wenn Partneradministratoren planen, generische Gateway-Geräte in Wholesale Calling zu verwenden.

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

12. Um für BroadCloud-Migrationen alle Benutzer mit dem Nachrichtensendertyp in voice_mail_group umzuwandeln, aktualisieren Sie die Datei conf/rialto_station_type_to_wholesale_package.csv, indem Sie den Wert Wholesale Package durch voice_mail_group für die Zeile ersetzen, in der der Rialto-Stationstyp Messaging ist.

    Aktivieren Sie optional die COMMON_VOICE_MAIL_GROUP_PASSCODE-Eigenschaft in partner.cfg, um die Standard-PIN für Voicemailgruppen zu konfigurieren.

    Wenn diese Eigenschaft nicht in partner.cfg angegeben ist, muss sie pro Kunde in der Datei customers.csv in der Spalte commonVoicemailGroupPasscode angegeben werden.

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

    Es ist die Erweiterung für die Verwaltung gemeinsamer Kontakte auf Unternehmens- und Standortebene. Diese Kontakte können jetzt entweder als Organisationskontakte (Org Contacts) oder als virtuelle Erweiterungen migriert werden, basierend auf den Konfigurationseinstellungen. Im Folgenden finden Sie die Details, die Sie durch diesen Migrationsprozess führen sollen.

    Tastenkonfiguration:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Eine neue Eigenschaft, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, wird in der Datei partner.cfg eingeführt. Diese Eigenschaft bestimmt, wie gemeinsame Kontakte von Rialto nach migriert werden. Webex Calling

    • Ohne COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE konfiguriert

      Allgemeine Kontakte werden als Organisationskontakte (Org Contacts) migriert.

      Es ist keine zusätzliche Konfiguration erforderlich.

      Kontakte bleiben auf Organisationsebene zugänglich.

    • Mit konfiguriertem COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Allgemeine Kontakte werden als virtuelle Erweiterungen migriert.

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

      Virtuelle Erweiterungen werden sowohl auf Organisations- als auch auf Standortebene unterstützt, je nach Umfang des Kontakts.

14. Webex als Standardanbieter für Anrufaufzeichnungen aktivieren.

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

    Um diese Option zu aktivieren:

    • Stellen Sie in der Datei partner.cfg die folgende Eigenschaft ein: default_call_recording_vendor=WebEx.
    • Verwenden Sie zusätzlich die Eigenschaft WEBEX_CALL_RECORDING_STORAGE_REGION, um die Speicherregion zu konfigurieren.

      Die On-Demand-Aufnahmeoption von BroadCloud wird in Webex Calling nicht unterstützt. Diese Einstellungen für die Anrufaufzeichnung werden nicht migriert und erscheinen im Ausnahmebericht.

15. Ausschluss ausgewählter Telefonnummern von der Migration:

    Um bestimmte Telefonnummern vom Migrationsprozess auszuschließen, muss das folgende zweistufige Verfahren mit dem Transformationstool befolgt werden:

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

      . /transform.sh -extract=Eingabe/Extrahierte_Daten_1747640608219.zip -decommissionnumbers= {filepath/telephone_numbers_inventory.csv}

16. Setzen Sie optional die Eigenschaft ALLOW_RESTRICT_BY_PARTNER_MODE auf OFF, damit Kundenadministratoren von Partnern definierte Einstellungen in Control Hub ändern können.
17. Für die Migration von Handynummern (BroadWorks Mobility) von BroadCloud zu Webex Calling

    In diesem Abschnitt wird die Migration der BroadWorks Mobility-Funktion (Kunden-Handynummern) von BroadCloud (Mobile Network Integration) zu Wholesale Webex Calling (Webex Go Mobile Network Operator) beschrieben.

    Voraussetzungen — Bevor mit dem Migrationsprozess begonnen wird, müssen sich die Partneradministratoren an das Cisco Account-Team wenden, um die Konfiguration des Cloud Connected PSTN (CCP) -Anbieters und der Custom Carrier List (CCL) vorzunehmen.

    Eine neue Eigenschaft, ASSIGN_MOBILE_NUMBERS_TO_USERS, wird zur Datei partner.cfg hinzugefügt. Aktivieren Sie diese Eigenschaft, damit Handynummern Benutzern zugewiesen und migriert werden können.

    • Diese Funktion wird nur für Migrationen von Broadcloud zu Wholesale unterstützt.
    • In Wholesale Webex können Endbenutzer entweder eine Handynummer oder eine PSTN-Nummer haben (nicht beide), anders als in BroadCloud.
    • Wenn einem Benutzer eine Handynummer zugewiesen wird, wird seine primäre PSTN-Nummer zu seiner sekundären (alternativen) Nummer.
    • Handynummern für Benutzer, die in Workspaces oder Virtual Lines umgewandelt werden, können nicht migriert werden.
    • Nachdem eine Handynummer in Wholesale Webex zugewiesen wurde, wird sie in Control Hub als Aktiv angezeigt. Dieser Status bedeutet nicht, dass die Nummer sofort für Anrufe bereit ist. Die Anruffunktion wird erst verfügbar sein, wenn die Migration vollständig abgeschlossen ist.
    • Die Einstellungen für die Mobiltelefonintegration, die von Endbenutzern im Calling User Portal (CUP) konfiguriert wurden, werden nicht migriert. Nach der Migration, wenn eine Telefonnummer, Handynummer oder Durchwahl angerufen wird, klingeln alle Geräte des Benutzers.

18. Um während der Kundenmigration optional Mengenbeschränkungen für Pakete zu konfigurieren, geben Sie die Menge für jedes Paket in der Datei input/package_quantity.csv an. Die konfigurierte Paketmenge muss größer oder gleich der Anzahl der vom Benutzer/Workspace zugewiesenen Pakete sein.

    Paketmengenbeschränkungen werden derzeit für Migrationen von Webex for BroadWorks nach Wholesale nicht unterstützt.

    Wenn Sie das Transformationstool ausführen, geben Sie die aktualisierte Datei als Eingabeparameter an:. <extract_zip_file>/transform.sh -extract= -packagelimits=Eingabe/Paketmenge.csv.

19. Migrieren Sie Websites mehrerer Kunden von Broadworks/Broadcloud auf einen einzelnen Kunden im Großhandel Webex Calling
    • Ein neuer Laufzeitmodus, -ConsolidatedMigration, wurde im Transform-Tool eingeführt, um die Migration mehrerer Kundenseiten von Broadcloud/Broadworks zur Webex Wholesale Platform unter einer einzigen Wholesale Customer Organization zu unterstützen. Wenn dieser Modus aktiviert ist, konsolidiert das Tool mehrere Kundenseiten zu einer Großhandelskundenorganisation

      -consolidatedMigration

    • Es gibt andere optionale Argumente, die zusammen mit -ConsolidatedMigration angegeben werden können, wie

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • Wenn -TargetEnterpriseId angegeben ist und die ID in der Ausgabedatei des Tools „Extrahieren“ vorhanden ist, wird sie verwendet, um die Organisation des Großhandelskunden zu erstellen. Wenn die ID nicht gefunden wird, greift das Tool zurück, um alle verfügbaren Kundendaten aus der Ausgabedatei des Tools „Extrahieren“ zu verwenden.
    • Wenn -ConsolidatedExternalId angegeben ist, wird die ExternalId für den Kunden festgelegt, und wenn sie nicht angegeben wird, greift das Tool zurück, um den vorhandenen Flow für die externe ID zu verwenden.
    • <timestamp>Eine konsolidierte JSON-Datei (customer.json) wird im Verzeichnis output/ /consolidated verfügbar sein.

Die Datei input/customers.csv wird aufgefüllt

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

Die folgende Tabelle erklärt die wichtigsten Spalten in input/customers.csv.

Die Datei input/users.csv wird aufgefüllt

Die Datei input/users.csv enthält Daten, die möglicherweise in Cisco BroadWorks oder BroadCloud fehlen. Diese Datei kann leer gelassen werden, wenn alle Pflichtinformationen bereits verfügbar sind. Sie müssen nicht alle Spalten ausfüllen, nur die fehlenden Informationen sind Pflichtfelder.

Anweisungen zum Laufen

Führen Sie das Transform-Tool in einem beliebigen Betriebssystem aus. Gehen Sie wie folgt vor, um das Tool unter Windows und macOS auszuführen:

Windows

Führen Sie den folgenden Befehl aus, um das Transformations-Tool in Windows auszuführen:

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

macOS

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

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

   ./transform.sh -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Vorabprüfung von Kunden/Benutzern

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 bestätigt. Wenn der Wert PROVISIONING_ID in der Datei conf/partner.cfg angegeben ist, werden auch die Standortinformationen überprüft. Die Ergebnisse der Vorabprüfung sind im Ausnahmebericht enthalten.

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

Vorabkontrolle

Zusätzlich zur Ausführung der Precheck-API für die Kundeninformationen wird das Transform Tool auch die Prececk-API für die Abonnenten-E-Mails ausführen.

Vorab-Check-Info

Standardmäßig sind nur Vorabprüfungsfehler (d. h. Probleme, die die Bereitstellung blockieren) im Ausnahmebericht enthalten. Wenn Sie diese Flagge hinzufügen, werden auch erfolgreiche Vorabprüfungsergebnisse berücksichtigt (z. B. wenn bereits eine Webex-Organisation existiert, die automatisch angehängt werden kann).

Terminalprotokolle

Die folgenden Logs melden sich bei erfolgreicher Transformation im Terminal an:

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

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

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

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

<timestamp><groupid>Eine JSON-Ausgabedatei (customer.json) wird im Verzeichnis output//verfügbar sein. Die customer.json-Beispieldatei lautet wie folgt:

{
    "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 Provisioning-Tool kann auf jedem Computer ausgeführt werden, normalerweise auf dem (Administrator-Laptop des Partners) 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 Provisioning-Tool-Verzeichnis:

1. Installieren Sie Java 8, 11, 17 oder 21 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://www.oracle.com/java/technologies/downloads/#java21
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:
   • Stellen Sie WHOLESALE_PROVISIONING_ID und REFRESH_TOKEN ein (Token, das aus dem Token-Generator-Tool kopiert wurde). Die Partneradministratoren müssen ihr Account-Team kontaktieren, um die PROVISIONING_ID zu erhalten:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

     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 von den Webex-E-Mail-Einstellungen gesteuert. Für Großhandelsorganisationen in den USA und Kanada ist RedSky automatisch als Notfalldienstleister aktiviert.

4. Verwenden Sie die WEBEX4BWKS_EMAIL_SUBJECT-Eigenschaft für Webex for BroadWorks-Migrationen, um den E-Mail-Betreff zur Passwortänderung für Webex for BroadWorks-Abonnenten zu senden.
5. Verwenden Sie die WEBEX4BWKS_EMAIL_BODY-Eigenschaft für Webex for BroadWorks-Migrationen, um den E-Mail-Text zur Passwortänderung für Webex for BroadWorks-Abonnenten zu senden.
6. Verwenden Sie die Eigenschaft CUSTOM_TAGS, um Tags nach der Kundenerstellung hinzuzufügen.
7. Um Großhandelsrabatte in Anspruch zu nehmen, müssen sich die Partneradministratoren an das Cisco Account-Team wenden, bevor Sie mit der Migration beginnen.

   Eine neue Eigenschaft, APPLY_WHOLESALE_DISCOUNTS, wurde zu partner.cfg hinzugefügt. Aktivieren Sie diese Eigenschaft, um Rabatte auf Benutzer und Arbeitsbereiche anzuwenden.

8. (Optional) Konfigurieren Sie die PSTN-Verbindung explizit

   Um die PSTN-Verbindung für alle während der Migration bereitgestellten Standorte anzugeben, einschließlich des Hauptstandorts, fügen Sie der Datei partner.cfg die folgende Eigenschaft hinzu:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Wenn die Eigenschaft nicht konfiguriert oder auskommentiert ist, verwendet das Provisioning-Tool den standardmäßigen PSTN-Verbindungsauswahlprozess.

Anweisungen zum Laufen

Gehen Sie wie folgt vor , um das Tool unter Windows und macOS auszuführen:

Windows

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

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

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

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Voraussetzungen für die Migration von Webex for BroadWorks

Partneradministratoren müssen ihre BroadWorks-Onboarding-Vorlage für die Koexistenzfunktionen von Webex for BroadWorks aktualisieren. Verweisen Sie auf das folgende Bild:

Sobald die Webex for BroadWorks Onboarding-Vorlage aktualisiert wurde, um die Migration zu unterstützen, bitten Sie das Cisco Account Team, die Funktion „Wholesale-Partner-Blending-enabled“ auf Partnerebene zu aktivieren. Mit dieser Einstellung kann das Provisioning-Tool bestehenden Webex for BroadWorks-Kunden während der Bereitstellung automatisch Großhandelspakete hinzufügen.

Führen Sie das Provisioning-Tool mit einem zusätzlichen Argument aus.

Vorbereitungsphase: ist die Standardphase, in der Administratoren die BroadWorks-Benutzer als Wholesale-Abonnenten bereitstellen 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 Provisioning-Tool mit einer Argumentwartung ausführen.

Phase nach der Migration: Ist die letzte Phase, in der Administratoren BroadWorks vollständig auf Wholesale umstellen können. Sie müssen das Provisioning-Tool mit einem Argument postmigration ausführen.

Terminalprotokolle

Im Folgenden finden Sie die Protokolle im Terminal über eine erfolgreiche 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 Standorte gedruckt, die für jeden Lauf erstellt wurden:

Ausgabe

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

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

Das Provisioning-Tool generiert auch eine Provisioning_Statistics_*.csv-Datei im Verzeichnis output/consolidated_reports/. Dieser Bericht enthält die Anzahl der erfolgreich und erfolglos bereitgestellten Kunden, Standorte, Benutzer, Geräte und Gruppenfunktionen.

Partneradministratoren können die Kundenbereitstellung im Partner Hub- und Control Hub-Portal überprüfen. Sehen Sie sich die folgenden Abbildungen aus dem Partner Hub- und Control Hub-Portal an:

Abbildung 8: Partner Hub

Abbildung 9: Control Hub

Abbildung 10: Geräte

Abbildung 11: Anrufen

Einschränkungen nach der Bereitstellung

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 — ADD-Bestellungen mit Geräten oder Nummern erstellen.
• RSB-API — ADD-Bestellungen mit Geräten oder Nummern erstellen und Benutzer erstellen. RSB ADD-Bestellungen, die mit Geräten oder Nummern getätigt wurden, werden abgelehnt.

Migration von BroadCloud zu Wholesale — Beschränkung der Geräteregistrierung

Für Partneradministratoren, die Kunden innerhalb derselben Region von BroadCloud zu Wholesale migrieren, können Geräte in Wholesale hinzugefügt werden, nachdem das Provisioning-Tool ausgeführt wurde. Diese Geräte können sich jedoch erst dann auf der Webex-Plattform registrieren, wenn die Migration (Geräteumzug) für den entsprechenden Standort abgeschlossen ist.

Diese Einschränkung gilt nicht für:

• Kunden, die von Broadworks/W4B zu Wholesale migrieren.
• Migrationen von BroadCloud zu Wholesale in verschiedenen Regionen.

Empfohlene Anleitung

Um Probleme bei der Geräteregistrierung zu vermeiden, schließen Sie die Migration des Geräts auf Standortebene ab, bevor Sie versuchen, Geräte auf der Webex-Plattform für BroadCloud-to-Wholesale-Migrationen derselben Region zu registrieren.

Für BroadCloud

BroadCloud-Partner: Verwenden Sie das Service Provider-Portal, um eine Migrationsanfrage für Nummern, Geräte und Shared Call Appearances (SCA) -Migrationen einzureichen.

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

Administratoren können automatisches Rollback aktivieren, indem sie rollback_to_broadcloud=TRUE in der Datei conf/partner.cfg setzen, wodurch Geräte nach der Migration zurück zu BroadCloud verschoben werden. Es unterstützt sowohl Migrationen derselben als auch verschiedener Regionen mit NS Sync, aber nur für erfolgreiche Migrationen. Bei fehlgeschlagenen Vorgängen müssen Administratoren eine Anfrage stellen, Cisco TAC bevor sie ein Rollback beantragen.

Es gibt zwei Optionen für die Auswahl des Migrationstyps im Portal:

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

Die folgenden Abbildungen zeigen das Service Provider-Portal.

Abbildung 12: Service Provider-Portal

Abbildung 13: Service Provider-Portal

Ausgewählte Standorte migrieren (optional)

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

Um die Liste der verfügbaren aktiven Websites herunterzuladen, navigieren Sie zu Kunden anzeigen → Wählen Sie einen Kunden aus → Standorte als CSV exportieren.

Abbildung 14: Standorte als CSV exportieren

Aktivieren Sie die Option Nummern trennen

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 aus dem Empfang eingehender Anrufe entfernt.

Um diese Option zu aktivieren,

1. Stellen Sie in der Datei partner.cfg DISCONNECT_NUMBERS_FROM_RIALTO = yes ein.
2. Führen Sie das Migrationstool erneut mit derselben customer.json-Datei und der aktualisierten Datei partner.cfg aus.

Wenn Nummern nicht getrennt werden können, stellen Sie eine Cisco TAC-Anfrage.

Für Cisco BroadWorks und Webex für BroadWorks

Für Cisco BroadWorks- und Webex for BroadWorks-Migrationen läuft das Tool auf dem sekundären Cisco BroadWorks Application Server innerhalb des Partnernetzwerks und stellt über OCI-P eine Verbindung zum AS her. Es verwendet die JSON-Ausgabedatei des Transform-Tools (customer.json) als Eingabe und führt die OCI-P-Befehle zur Migration von Geräten und Soft-Clients aus.

Bei erfolgreichem Betrieb wird das Tool zum Verschieben des Geräts:

1. Melden Sie Geräte von Cisco BroadWorks ab und registrieren Sie sie bei Wholesale.
2. Benutzer, die den UC-One Client verwenden, werden bei der ersten Anmeldung zur Webex-App weitergeleitet.
3. Deaktivieren Sie die Telefonnummern von Cisco BroadWorks oder entfernen Sie die Telefonnummern aus BroadCloud.
4. Aktivieren Sie Nummern im Großhandel.
5. Erstellen Sie Auftritte für gemeinsame Anrufe in Wholesale für BroadCloud-Migrationen. [Dieser Schritt gilt nur für BroadCloud-Migrationen].

6. Wenn der Administrator das Tool hinter einem Unternehmens-Proxy bedient, folgen Sie den nachstehenden Schritten, um das Bereitstellungsskript zu konfigurieren und auszuführen.

   Konfigurationsverfahren

   1. Öffnen Sie die Datei devicemove.sh.
   2. Suchen Sie die PROXY_HOST-Variable und kommentieren Sie sie aus (entfernen Sie die führende # für devicemove.sh).

   3. Stellen Sie den PROXY_HOST-Wert ein als:

      PROXY_HOST=<proxy-host>

   4. Suchen Sie die PROXY_PORT-Variable und kommentieren Sie sie aus (entfernen Sie die führende # für devicemove.sh).

   5. Stellen Sie den PROXY_PORT-Wert ein als:

      PROXY_PORT=<proxy-port>

   6. Bitte suchen Sie die PROXY_SCHEME-Variable und kommentieren Sie sie aus (entfernen Sie die führende # für devicemove.sh). Dieser Schritt ist optional; wenn er kommentiert bleibt, ist der Standardwert für PROXY_SCHEME HTTP.

   7. Stellen Sie den PROXY_SCHEME-Wert ein als:

      PROXY_SCHEME=<proxy-scheme>

   8. Speichern und schließen Sie die Datei devicemove.sh.
   9. Öffnen Sie die Datei partner.cfg und fügen Sie das erforderliche refresh_token hinzu.
   10. Stellen Sie sicher, dass der BroadWorks-Host, der Benutzername und das Passwort in partner.cfg korrekt konfiguriert sind

   11. Führen Sie das Skript aus:

       ./devicemove.sh

SCP und SSH

1. SCP, das Tool zum Verschieben von Geräten, auf den sekundären Cisco BroadWorks Application Server.
2. SSH mit dem sekundären Cisco BroadWorks Application Server verbinden, um die Voraussetzungen zu konfigurieren und das Device Move Tool auszuführen.

Voraussetzungen

1. Stellen Sie das REFRESH_TOKEN (vom Token-Generator-Tool kopiertes Token) in der Datei conf/partner.cfg ein:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Um Aktivierungs-E-Mails erneut zu senden, müssen Sie send_subscribers_welcome_email=TRUE in der Datei conf/partner.cfg setzen.

   Wenn Administratoren während der Migration Einladungs-E-Mails an ihre Benutzer senden möchten, sollten sie die Eigenschaft „send_subscribers_welcome_email=True“ in der Datei conf/partner.cfg auskommentieren. Andernfalls sollte das Eigentum unverändert bleiben.

4. Stellen Sie sicher, dass der JDK/JRE-Umgebungspfad in devicemove.sh korrekt ist

   JAVA_HOME=/usr/local/java/java_base

5. Administratoren können die Datei locations.csv aus dem Eingabeverzeichnis verwenden, um die spezifischen Gruppen statt aller Gruppen unter einem Unternehmen zu migrieren.

Polycom-Telefone

Um Polycom-Telefone von Cisco BroadWorks auf Wholesale Calling umzustellen, muss ein Partneradministrator in jeder Polycom-Gerätevorlage eine neue Identitäts-/Geräteprofiltypdatei auf Systemebene in Cisco BroadWorks erstellen. Sehen Sie sich Abbildung 14 an 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 existiert. Stellen Sie außerdem sicher, dass die Dateimigration_%BWMAC-Adresse%.cfg nicht mit einer vorhandenen Datei in Ihrem System in Konflikt steht).

Es wird intern vom Device Move Tool 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 Application Server auf, Telefone auf Gruppen- oder Geräteebene neu zu starten.
4. Nach der Neustartanfrage laden Polycom-Telefone% bwMACAddress%.cfg herunter und verarbeiten sie, wodurch die Polycom-Telefone aufgefordert werden, migration_%BWMACAddress%.cfg herunterzuladen und zu verarbeiten, wodurch device.prov.serverName auf https://plcm.sipflash.com gesetzt wird.
   https://plcm.sipflash.com für die US-Region, andere Regionen haben andere URLs.
5. Das Polycom-Telefon lädt %BWMACAddress%.cfg von https://plcm.sipflash.com herunter und wird vom DMS verwaltet. Webex Calling

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

Anweisungen zum Laufen

Es gibt zwei Methoden, um das DMT aufzurufen. Die erste besteht darin, es durch einen einzelnen Kunden gleichzeitig aufzurufen, und die andere besteht darin, mehrere Kunden gleichzeitig auszuführen.

Das Tool zum Verschieben von Geräten wird vom sekundären Cisco BroadWorks Application Server im Verzeichnis des Device Move Tools ausgeführt:

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Terminalprotokolle

Im Folgenden finden Sie die Protokolle im Terminal nach erfolgreicher Ausführung des Device Move-Tools 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 bereit, Anrufe zu tätigen/entgegenzunehmen. Sehen Sie sich Abbildung 15 an, um ein Beispiel für den Gerätestatus zu sehen:

Abbildung 15: Gerätestatus

Nach der Gerätemigration sind die Nummern aktiv geworden. Sehen Sie sich Abbildung 16 an, um ein Beispiel dafür zu sehen, welche Zahlen aktiv sind:

Abbildung 16: Aktive Zahlen

Wenn der Administrator das Tool hinter einem Unternehmens-Proxy bedient, folgen Sie den folgenden Schritten, um das Devicemove-Skript zu konfigurieren und auszuführen.

Schritte zur Konfiguration und Ausführung des Devicemove-Skripts

1. Öffnen Sie die Datei devicemove.sh.
2. Suchen Sie die HTTPS_PROXY_HOST-Variable und kommentieren Sie sie aus (entfernen Sie das führende #).

3. Stellen Sie den HTTPS_PROXY_HOST-Wert ein als:

   HTTPS_PROXY_HOST=<proxy-host>

4. Suchen Sie die HTTPS_PROXY_PORT-Variable und kommentieren Sie sie aus (entfernen Sie das führende #).
5. Stellen Sie den HTTPS_PROXY_PORT-Wert ein als:

   HTTPS_PROXY_PORT=<proxy-port>

6. Speichern und schließen Sie die Datei devicemove.sh.
7. Öffnen Sie die Datei partner.cfg und fügen Sie das erforderliche refresh_token hinzu.
8. Stellen Sie sicher, dass der BroadWorks-Host, der Benutzername und das Passwort in partner.cfg korrekt konfiguriert sind.
9. Führen Sie das Skript aus:

   ./devicemove.sh

Der Vorgang zum Wiederherstellen muss jeweils für ein Unternehmen ausgeführt werden.

Für BroadCloud Carrier

Administratoren können rollback_to_broadcloud=TRUE in conf/partner.cfg setzen, um automatisches Rollback zu aktivieren. Dadurch werden Geräte nach erfolgreicher Migration in derselben Region oder regionsübergreifend mit NS Sync an BroadCloud zurückgegeben. Bei fehlgeschlagenen Migrationen wenden Sie sich an, Cisco TAC bevor Sie ein Rollback beantragen.

Für Cisco BroadWorks und Webex für BroadWorks

Der Wiederherstellungsprozess für Cisco BroadWorks und Webex for BroadWorks läuft wie folgt ab:

1. Öffnen Sie ein Ticket mitCisco TAC, um eine Geräterückgabe zu beantragen.
2. Führen Sie das Device Move Tool im Rückkehrmodus auf dem sekundären BroadWorks Application Server aus, um die Gerätemigrationen rückgängig zu machen. Dadurch wird die DMS-URL auf die DMS-URL des Dienstanbieters für Geräteprofile in Cisco BroadWorks zurückgesetzt und Telefonnummern reaktiviert.
3. Das Webex Calling Team setzt die DMS-URL zurück auf die DMS-URL des Dienstanbieters in den Geräteprofilen in. Webex Calling
4. Partneradministratoren müssen die Telefonnummern im Webex Calling Control Hub-Portal deaktivieren oder löschen.
5. Partneradministratoren müssen PSTN-Telefonnummern zurück zu Cisco BroadWorks verschieben.

Anweisungen, um das Tool zum Verschieben von Geräten im Rückkehrmodus auszuführen

Gehen Sie wie folgt vor, um das Tool zum Verschieben von Geräten im Rückkehrmodus auszuführen:

Führen Sie den folgenden Befehl auf dem sekundären Cisco BroadWorks Application Server im Device Move Tool-Verzeichnis aus:

Profile rückgängig machen

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

Zahlen rückgängig machen

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

Terminalprotokolle

Wir erhalten die folgenden Protokolle im Terminal, wenn das Tool zum Verschieben von Geräten erfolgreich ausgeführt wurde, um den Vorgang rückgängig zu machen:

Profile rückgängig machen

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 rückgängig machen

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