- Startseite
- /
- Artikel
Migrationstools für den Übergang zu Wholesale-RTM-Lösungen
Führen Sie die Migration mit minimaler Vorkonfiguration aus. Erleichtert die Ausführung von Befehlen. Administratoren können ihre Daten nach der Bereitstellung überprüfen und unmittelbar nach der Migration Anrufe tätigen und empfangen. Es unterstützt ein automatisches Upgrade auf die Webex-App für UC-One-Clients.
Übersicht
Der Zweck dieses Dokuments besteht darin, detaillierte Anweisungen zur Verwendung von Tools für die Migration von Cisco BroadWorks, Webex für BroadWorks und BroadCloud zu Wholesale und Webex Calling bereitzustellen. Dieses Dokument behandelt eine Reihe von Migrationstools, die bei der Migration bestehender Cisco BroadWorks-, Webex for BroadWorks- und BroadCloud-Kunden zur Wholesale Route-to-Market-Lösung helfen sollen.
Die Migrationstools sollen einen vollständigen Übergang von BroadWorks zu Großhandelsdiensten erleichtern. Sie sind nicht für die langfristige Koexistenz beider Dienste innerhalb derselben Kundenorganisation ausgelegt.
Auswirkungen der Migration
Die Auswirkungen der Migration sind wie folgt:
Administratoren
Nach der Migration müssen Administratoren:
- Beginnen Sie, zum Konfigurieren von Funktionen Partner Hub und Control Hub anstelle von CommPilot zu verwenden.
- Konfigurieren Sie alle Funktionen neu, die nicht Teil der Migration sind.
Sie müssen die Funktionen, die nach Abschluss der Migrationstools nicht automatisch migriert werden, manuell migrieren.
Benutzer
Unterstützte Funktionen sollten nach der Migration genauso funktionieren wie vor der Migration. Von der Migration nicht unterstützte Webex Calling-Funktionen müssen nach der Migration auf Webex neu konfiguriert werden:
- Benutzer verlieren ihren Anruf- und Nachrichtenverlauf.
- Benutzer verlieren alle persönlichen Tastenzeileneinstellungen und Anpassungen und müssen diese Einstellungen nach der Migration neu konfigurieren. Beispiele hierfür sind Kurzwahlen.
- Benutzer müssen ihre Zugangscodes und Passwörter bei der ersten Anmeldung zurücksetzen.
- Benutzer, die den UC-One-Client verwenden, müssen bei der ersten Anmeldung ein Upgrade auf die Webex-App durchführen.
Architektur der Migrationstools
Die Architektur der Migrationstools besteht aus vier verschiedenen Tools:
- Extrahierungstool– Extrahiert Unternehmen, Gruppen, Nummern, Benutzer, Dienste, Telefone und Softclients aus Cisco BroadWorks. BroadCloud-Partner müssen im Service Provider Portal eine Auszugsanforderung einreichen.
- Transformieren-Tool– Transformiert die vom Extraktions-Tool extrahierten Informationen in eine bearbeitbare JSON-Datei.
- Bereitstellungstool– Verwendet die JSON-Ausgabedatei des Transform-Tools, um Kunden, Standorte, Nummern, Benutzer, Dienste und Telefone mithilfe von öffentlichen Webex-APIsbereitzustellen.
- Tool zum Verschieben von Geräten– Verwendet die JSON-Ausgabedatei des Transform Tools, um die Profile neu zu erstellen und Telefone neu zu starten, Nummern in der Wholesale RTM-Lösung zu aktivieren und Telefonnummern in Cisco BroadWorks zu deaktivieren.
- Dieses Tool unterstützt das Zurücksetzen von Telefon- und Soft-Client-Profilen sowie die Nummernaktivierung in Cisco BroadWorks.
- BroadCloud-Partner müssen im Service Provider Portal eine Migrationsanfrage einreichen.
Die folgende Abbildung zeigt, wie die vier Tools nacheinander funktionieren, indem sie mit Cisco BroadWorks und öffentlichen APIs kommunizieren und Metriken für zukünftige Analysen in die Webex-Dienste hochladen, nachdem der Administrator die Migrationsaufgaben gestartet hat.

Abbildung 1. Migrationstools
Anforderungen
Vor dem Ausführen von Migrationstools muss der Partner die folgenden Anforderungen erfüllen:
- Das Partner- und Partneradministratorkonto muss in der Wholesale RTM-Lösung integriert sein. Während der Vorverkaufsphase ist für die Ausführung des Extraktionstools kein Onboarding der Partner in die Wholesale RTM-Lösung erforderlich.
- Der Partner muss die Checkliste vor der Migration durchgehen, um sicherzustellen, dass alle Anforderungen erfüllt sind.
- Zum Ausführen der Extrahierungs- und Geräteverschiebungstools sind die Anmeldeinformationen eines Cisco BroadWorks-Systemadministrators erforderlich. Dies gilt nicht für BroadCloud-Partner.
- Um das Risiko zu minimieren, müssen die Tools zum Extrahieren und Verschieben von Geräten während eines Wartungsfensters vom sekundären Cisco BroadWorks-Anwendungsserver ausgeführt werden. BroadCloud-Partner führen das Device Move Tool über das Service Provider-Portal aus.
- Sehen Sie sich die Liste der unterstützten Webex Calling-Gerätean.
- Überprüfen Sie die Liste der nicht unterstützten Webex Calling-Geräte.
- Partner müssen ihr Account-Team bei Cisco fragen, um die unterstützte Firmware-Version für Telefone und Geräte zu erhalten.
- UC-One-Clients müssen auf die folgenden Versionen aktualisieren:
- Desktop Communicator-Clients müssen Version 22.9.12 oder höher sein.
- Mobile Connect-Clients müssen Version 3.9.14 oder höher sein.
- Der Computer des Administrators muss über Folgendes verfügen:
- JDK/JRE Für das Provisioning Tool wird Version 1.8 benötigt.
- MAC- und Linux-Computer erfordern für das Transform Tool Python 3.10.5 oder höher.
- Kunden müssen über eine gültige Rechnungsadresse verfügen und Endbenutzer müssen über eine in Cisco BroadWorks konfigurierte geschäftliche E-Mail-Adresse verfügen. Wenn die Werte nicht festgelegt sind, müssen sich die Partneradministratoren an ihre Kunden wenden, um sie zu erhalten. Diese Details müssen den CSV-Dateien (durch Kommas getrennte Werte) hinzugefügt werden, bevor das Transformationstool ausgeführt wird. Mit dem Transformationstool werden Beispiel-CSV-Dateien bereitgestellt.
Migrationsplan
Der Migrationsplan umfasst drei Phasen:
- Vorbereitung
- Holen Sie sich eine Kopie der Benutzerdaten mit dem Extract Tool
- Generieren Sie ein Token mit dem Token Generator Tool
- Verwenden Sie das Transformationstool, um Benutzerdaten zu formatieren
- Bereitstellung
- Holen Sie sich die neuesten Benutzerdaten mit dem Extract Tool
- Verwenden Sie das Transformationstool, um Benutzerdaten zu formatieren
- Bereitstellen von Benutzern mit dem Bereitstellungstool
- Migration
- Migrieren Sie Geräte mit dem Device Move Tool
- Migrationen ohne Geräte [ Aktivieren von Telefonnummern über Control Hub ]
Wenn die Partneradministratoren keine Geräte haben, die von Cisco BroadWorks zu Wholesale verschoben werden müssen, ist die Ausführung des Tools zum Verschieben von Geräten nicht erforderlich. Partneradministratoren können den unten stehenden öffentlichen Link verwenden, um die Telefonnummern direkt über das Control Hub-Portal zu aktivieren. Weitere Informationen finden Sie unter Verwalten von Telefonnummern in Control Hub.
Das Deaktivieren der Telefonnummern in Cisco BroadWorks ist optional, wenn die Partneradministratoren ihre Telefonnummern über Control Hub aktivieren.
Funktionen wurden automatisch zu Wholesale Calling migriert
Diese Benutzerfunktionen werden von den Migrationstools automatisch migriert:
- Einstellungen für Sprachnachrichten und benutzerdefinierte Begrüßungen (Sprachnachrichten, personalisierte Namensansagen und Benutzer-PIN werden nicht migriert)
- Alternative Nummern
- BroadWorks Anywhere
- Besetztlampenfeld
- Anrufer-ID (benutzerdefinierter Name und Telefonnummer)
- Wartender Anruf
- Einstellungen für die Anrufweiterleitung (Anrufweiterleitung always/busy/no answer/not erreichbar)
- Anrufübernahme
- Bitte nicht stören
- Faxeinstellungen
- Remote-Büro
- Gemeinsame Leitung
- Gleichzeitiger Klingelton persönlich (inkl. Zeitplan und Auswahlkriterien)
- Anrufbenachrichtigung (inkl. Zeitplan und Auswahlkriterien)
- Anonyme Anrufablehnung
- Selektive Anrufabweisung
- Selektive Anrufweiterleitung
- Gezielte Anrufübernahme und Aufschaltung
- Barge-in-Ausnahme
- Drücken zum Sprechen
- Privatsphäre
- Warteschleifenmusik
- Urlaubsdienst
- Nachtdienst
Diese Gruppenfunktionen werden von den Migrationstools automatisch migriert:
- Automatische Anrufverteilung
- Nur eine Ebene
- Benutzerdefinierte Grüße
- Einstellungen für die Rufumleitung (immer, besetzt, selektiv)
- Alternative Nummern
- Das Feiertagsmenü ist in Webex nicht verfügbar
- Selektive Anrufabweisung
- Cisco BroadWorks Call Center Standard und BroadCloud Call Queue:
- Grundkonfiguration
- Benutzerdefinierte Grüße
- Agenten und Vorgesetzte
- Einstellungen für die Rufumleitung (immer, besetzt, selektiv)
- Alternative Nummern
- Wartemusik
- Anruf parken
- Anrufannahme
- Sammelanschluss
- Rufumleitungseinstellungen (immer, besetzt, selektiv, nicht erreichbar)
- Alternative Nummern
- Standortcode (einer pro Standort oder Gruppe)
- Paging-Gruppe
- Zeitpläne (nur auf Gruppenebene, Unternehmenszeitpläne werden nicht migriert)
- Sprachportal
- Wartemusik
- Gemeinsame Telefonliste
Unterstützte Geräte
Unterstützte Telefone werden vom Bereitstellungstool automatisch erstellt und Benutzern in Webex Calling zugewiesen. Die in der Spalte „Im Tool zum Verschieben von Geräten unterstützt“ mit „Ja“ markierten Telefone werden beim Ausführen des Tools zum Verschieben von Geräten auch automatisch von Cisco BroadWorks oder BroadCloud zu Webex Calling verschoben. 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 Transformationstool dieses Artikels.)
Telefonmodell |
Unterstützt im Tool zum Verschieben von Geräten |
Gerätetyp in newphones.csv |
---|---|---|
Cisco MPP 6821 |
Ja |
DMS Cisco 6821 |
Cisco MPP 6841 |
Ja |
DMS Cisco 6841 |
Cisco MPP 6851 |
Ja |
DMS Cisco 6851 |
Cisco MPP 6861 |
Ja |
DMS Cisco 6861 |
Cisco MPP 6871 |
Ja |
DMS Cisco 6871 |
Cisco MPP 7811 |
Ja |
DMS Cisco 7811 |
Cisco MPP 7821 |
Ja |
DMS Cisco 7821 |
Cisco MPP 7832 |
Ja |
DMS Cisco 7832 |
Cisco MPP 7841 |
Ja |
DMS Cisco 7841 |
Cisco MPP 7861 |
Ja |
DMS Cisco 7861 |
Cisco MPP 8811 |
Ja |
DMS Cisco 8811 |
Cisco MPP 8832 |
Ja |
DMS Cisco 8832 |
Cisco MPP 8841 |
Ja |
DMS Cisco 8841 |
Cisco MPP 8845 |
Ja |
DMS Cisco 8845 |
Cisco MPP 8851 |
Ja |
DMS Cisco 8851 |
Cisco MPP 8861 |
Ja |
DMS Cisco 8861 |
Cisco MPP 8865 |
Ja |
DMS Cisco 8865 |
Cisco MPP 8875 |
Ja |
DMS Cisco 8875 |
Cisco ATA191 |
Ja |
DMS Cisco 191 |
Cisco ATA192 |
Ja |
DMS Cisco 192 |
Cisco DBS 110 |
Ja |
DMS Cisco DBS110 |
Polycom VVX101 |
Ja |
DMS Polycom VVX101 |
Polycom VVX150 |
Ja |
DMS Polycom VVX150 |
Polycom VVX201 |
Ja |
DMS Polycom VVX201 |
Polycom VVX250 |
Ja |
DMS Polycom VVX250 |
Polycom VVX301 |
Ja |
DMS Polycom VVX301 |
Polycom VVX311 |
Ja |
DMS Polycom VVX311 |
Polycom VVX350 |
Ja |
DMS Polycom VVX350 |
Polycom VVX401 |
Ja |
DMS Polycom VVX401 |
Polycom VVX411 |
Ja |
DMS Polycom VVX411 |
Polycom VVX450 |
Ja |
DMS Polycom VVX450 |
Polycom VVX501 |
Ja |
DMS Polycom VVX501 |
Polycom VVX601 |
Ja |
DMS Polycom VVX601 |
Polycom Trio 8300 |
Ja |
DMS Polycom Trio8300 |
Polycom Trio 8500 |
Ja |
DMS Polycom Trio8500 |
Polycom Trio 8800 |
Ja |
DMS Polycom Trio8800 |
Polycom SoundStation 5000 |
Ja |
DMS Polycom SSIP5000 |
Polycom SoundStation 6000 |
Ja |
DMS Polycom SSIP6000 |
Yealink T33G |
Ja |
DMS Yealink T33G |
Yealink T41S |
Ja |
DMS Yealink T41S |
Yealink T42S |
Ja |
DMS Yealink T42S |
Yealink T43U |
Ja |
DMS Yealink T43U |
Yealink T46U |
Ja |
DMS Yealink T46U |
Yealink T46S |
Ja |
DMS Yealink T46S |
Yealink T48S |
Ja |
DMS Yealink T48S |
Yealink T48U |
Ja |
DMS Yealink T48U |
Yealink T53W |
Ja |
DMS Yealink T53W |
Yealink T54W |
Ja |
DMS Yealink T54W |
Yealink T57W |
Ja |
DMS Yealink T57W |
Yealink T58V |
Ja |
DMS Yealink T58V |
Yealink CP920 |
Ja |
DMS Yealink CP920 |
Yealink CP960 |
Ja |
DMS Yealink CP960 |
Yealink W52B |
Ja |
DMS Yealink W52P |
Yealink W56B |
Ja |
DMS Yealink W56P |
Yealink W60B |
Ja |
DMS Yealink W60P |
Yealink W70B |
Ja |
DMS Yealink W70P |
Yealink CP925 |
Ja |
DMS Yealink CP925 |
Yealink CP965 |
Ja |
DMS Yealink CP965 |
Nicht unterstützte Geräte
Wenn der Kunde von der Wholesale RTM-Lösung nicht unterstützte Geräte verwendet, sind diese Geräte nicht für die Migration berechtigt. In diesem Fall haben Sie folgende Möglichkeiten:
- Stellen Sie vor der Migration neue Telefone auf Cisco BroadWorks bereit.
- Belassen Sie die alten Telefone in Cisco BroadWorks. Benutzer müssen die Webex-App installieren, um Anrufe zu tätigen und zu empfangen.
Großhandels-Telefonpakete
Die Migrationstools verfügen über eine Reihe von Standardeinstellungen zum Auswählen von Wholesale-Calling-Paketen für Abonnenten. Sollte später ein anderes Paket gewünscht sein, kann dieses im Control Hub durch einen Partner-Admin geändert werden.
Konfiguration des Cisco BroadWorks-Migrationspakets
Alle Abonnenten, die von Cisco BroadWorks migrieren, erhalten standardmäßig das Webex Calling-Paket. Wenn das Webex Voice-Paket für Abonnenten gewünscht wird, denen weder Anklopfen noch Voicemail zugewiesen ist, kann dies in der Datei partner.cfg des Transform-Tools aktiviert werden, indem die Zeile USE_WEBEX_VOICE_PACKAGE auskommentiert wird.
Webex für BroadWorks-Migrationspaketzuordnung
Webex für BroadWorks-Pakete werden automatisch Wholesale Calling-Paketen zugeordnet. Dies ist nicht konfigurierbar.
Webex für BroadWorks-Paket |
Großhandels-Telefonpaket |
---|---|
Softphone |
Webex-Sprachassistent |
Standard |
Webex Calling |
Standard |
Webex Suite |
Premium |
Webex Suite |
BroadCloud-Migrationspaketzuordnung
Migrationen von BroadCloud Carrier-Kartenpaketen basierend auf dem Stationstyp. Die Standardzuordnung kann in der Konfigurationsdatei conf/rialto_station_type_to_wholesale_package.csv des Transform-Tools konfiguriert werden.
BroadCloud Carrier-Stationstyp |
Großhandels-Telefonpaket |
---|---|
Standard |
Webex-Sprachassistent |
Konferenzraum |
Webex-Sprachassistent |
Nachrichten |
Webex-Sprachassistent |
Standard |
Webex-Sprachassistent |
Führungskraft |
Webex Suite |
Alle anderen Stationstypen |
Webex-Sprachassistent |
Verwandeln Sie ein BroadWorks- oder BroadCloud-Benutzerkonto in einen Webex Calling-Arbeitsbereich
Ein Webex Workspace ist ein Telefon, das von vielen Personen gemeinsam genutzt wird, zum Beispiel: Zum Beispiel: Telefone in einem Konferenzraum, Lager oder einer Lobby. Solche Telefone können in Webex Calling als Webex-Arbeitsbereiche statt als Webex-Benutzer konfiguriert werden. Es besteht die Möglichkeit, Benutzerkonten von Cisco BroadWorks oder BroadCloud Carrier während des Migrationsprozesses automatisch in Arbeitsbereiche umzuwandeln.
Schritte:
- In der Datei transform_tool/input/users.csv, Weisen Sie den Benutzern das Paket „common_area“ zu, das in einen Arbeitsbereich umgewandelt werden soll.
- Beispiel: bwuser@domain,,,common_area
- (Nur BroadCloud) Um alle Benutzerkonten eines bestimmten Stationstyps in Arbeitsbereiche umzuwandeln, fügen Sie einen Eintrag hinzu zu transform-tool/conf/rialto_station_type_to_wholesale_package.csv und legen Sie das Großhandelspaket auf „common_area_calling“ fest.
- Beispiel: conference_room_v2,common_area_calling
- Führen Sie das Transformationstool aus.
- Führen Sie das Bereitstellungstool aus.
- Öffnen Sie Control Hub der neu erstellten Kundenorganisation und legen Sie eine SIP-Domäne fest (siehe Abbildung 2, Konfigurieren einer SIP-Domäne in Control Hub).
- Führen Sie das Bereitstellungstool erneut aus. Dadurch werden die Arbeitsbereiche erstellt und ihnen Telefone zugewiesen.
Beschränkungen:
Die Konfiguration von Benutzerfunktionen (z. B. Anrufweiterleitung, Nicht stören) wird nicht automatisch in den Arbeitsbereich migriert.

Abbildung 2: Konfigurieren einer SIP-Domäne im Control Hub
Token-Generator-Tool
Partneradministratoren führen dieses Dienstprogramm zum Token-Generator 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 zum Aktualisieren der Partnerkonfigurationsdateien für die Migrationstools erforderlich ist.
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.
Dieser Schritt ist optional
Anweisungen zum Ausführen
Führen Sie den folgenden Befehl im Terminal im Token-Generator-Verzeichnis aus:
-
Zum Ausführen des Token-Generator-Tools müssen die folgenden Ports verfügbar sein. Häfen: 8080, 50009, 50010, 50011, 50012 und 50013
-
Mindestens einer dieser genannten Ports muss im Computer des Benutzers für die Verbindung geöffnet sein.
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 Anmeldeinformationen des Partneradministrators an, um das TOKEN zu erhalten, und kopieren Sie es zur weiteren Verwendung.
Die Abbildungen der Benutzeroberfläche dienen als Referenz:
Abbildung 3: Mit Cisco Webex anmelden
Abbildung 4: Fenster „Anmeldeinformationen“
Abbildung 5: Token-Generierung
BroadWorks-Setup-Aufgaben
Konfigurieren Sie die folgenden Schritte, bevor Sie die Tools zum Extrahieren und Verschieben von Geräten auf dem sekundären BroadWorks-Server ausführen.
OCI-P-Konnektivität aktivieren
Das Tool zum Verschieben von Geräten kommuniziert über OCI-P-Befehle mit BroadWorks. Um die OCI-P-Konnektivität zu aktivieren, führen Sie die folgenden Schritte aus:
Schritt 1: Verwenden Sie die CLI, um allgemeine Einstellungen zu konfigurieren.
Führen Sie den folgenden Befehl in der CLI aus, um in das Verzeichnis „GeneralSettings“ zu wechseln:
AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.
Führen Sie den folgenden Befehl in der CLI aus, um die aktuellen allgemeinen Einstellungen 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 zu OCI Proxy:
AS_CLI> cd /Applications/OpenClientServer/OCIProxy
Führen Sie die folgende CLI 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
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.
Überprüfen Sie, ob der offene Client-Server bereitgestellt und aktiv ist
Verwenden Sie die folgenden Befehle, um den Open Client Server auf dem sekundären Anwendungsserver bereitzustellen und zu starten, falls er nicht bereitgestellt wurde 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
Nummernaktivierung aktivieren
Führen Sie die folgenden Befehle in der CLI aus, um die Aktivierung der Nummern zu ermöglichen:
Schritt 1: Führen Sie den Nummernaktivierungsbefehl aus:
AS_CLI> cd SubscriberMgmt/NumberActivation
Schritt 2: Führen Sie den Befehl „Aktivierung aktiviert“ aus:
AS_CLI> set dnMode groupAndUserActivationEnabled
Schritt 3: Geben Sie bei der Bestätigungsaufforderung Y ein.
Extraktionswerkzeug
Für BroadCloud
Das Extraktionstool ist in das BroadCloud Service Provider-Portal integriert. Ein Dienstanbieteradministrator kann:
- Senden Sie Auszugsanfragen für bis zu 50 Kunden pro Anfrage.Für denselben Kunden können Auszugsanfragen nicht mehr als zehnmal am Tag übermittelt werden.
- Laden Sie die extrahierte Datendatei bis zu 28 Tage nach dem Datum der Anfrage im ZIP-Format herunter.
Die folgenden Abbildungen zeigen das Service Provider-Portal.

Abbildung 6: Service Provider-Portal

Abbildung 7: Service Provider-Portal
CSV-Extraktanforderung
CSV-Extraktanforderung starten
-
Laden Sie die Kunden-CSV herunter
Klicken Sie oben rechts im Abschnitt CSV-Extraktanforderung starten [] auf den LinkKunden -CSV herunterladen.
-
Bearbeiten der Kundenliste
Der Administrator kann diese CSV-Datei bearbeiten, um nur die Kunden einzuschließen, für die der Extrahierung durchgeführt werden muss.
-
Hochladen und Senden
Laden Sie nach der Bearbeitung die geänderte CSV hoch.
Klicken Sie auf Senden, um eine Auszugsanforderung für die aufgelisteten Kunden und ihre zugehörigen Standorte zu starten.
Extraktionsanforderung für einen Kunden mit Standort-CSV initiieren
-
Kunden- und Download-Standorte auswählen
Wählen Sie einen Kunden aus der Dropdown-Liste aus.
Laden Sie die entsprechende locations.csv von Kunden anzeigen→ Registerkarte Standorte → Standorte als CSV exportierenherunter.
-
Bearbeiten der Standortdatei
Der Administrator kann die CSV-Datei so bearbeiten, dass nur die Standorte enthalten sind, die er extrahieren möchte.
-
Hochladen und Senden
Laden Sie die bearbeitete Datei locations.csv hoch und klicken Sie auf Senden.
In die Auszugsanfrage werden nur die angegebenen Standorte des ausgewählten Kunden aufgenommen.
Auszugsanforderung für alle Kunden einleiten
- Klicken Sie auf Senden, um eine Auszugsanforderung für alle Kunden und alle ihre Standorte unter dem aktuellen Dienstanbieter zu starten.

Für Cisco BroadWorks und Webex für BroadWorks
- Das Extraktionstool wird auf dem sekundären Cisco BroadWorks-Anwendungsserver innerhalb des Partnernetzwerks ausgeführt und stellt eine Verbindung über OCI-P her.
- 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 die Eingaben für das Transformationstool bereitstellen.
In den nächsten Abschnitten wird erläutert, wie Sie das Extraktionstool installieren und konfigurieren.
Voraussetzungen
- Übertragen Sie die Binärdateien des Extraktionstools per SCP auf den sekundären Cisco BroadWorks-Anwendungsserver.
- Stellen Sie per SSH eine Verbindung zum sekundären Cisco BroadWorks-Anwendungsserver her, um die Voraussetzungen zu konfigurieren und das Extraktionstool auszuführen.
- Konfigurieren Sie den Service Provider und die Gruppen-ID, die aus Cisco BroadWorks extrahiert werden sollen, im conf/exportTool.yml. Siehe das folgende Beispiel eines YAML-Snippets:
ServiceProviderID-A: - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B: - ALL
- Stellen Sie sicher, dass die sekundäre Cisco BroadWorks Application Server-Benutzer-ID, das Passwort und der Hostname im 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 Eigenschaft
REFRESH_TOKEN
ist für eine Migration von Webex zu BroadWorks obligatorisch. - Ändern Sie die JDK/JRE Umgebungspfad in der Datei export.sh, wenn der sekundäre Cisco BroadWorks Application Server JDK/JRE Der Umgebungspfad unterscheidet sich von der Datei:
JAVA_HOME=/usr/local/java/java_base
Anweisungen zum Ausführen
Führen Sie den folgenden Befehl im sekundären Cisco BroadWorks-Anwendungsserver aus dem Extraktionstoolverzeichnis aus:
./export.sh
Terminalprotokolle
Nach erfolgreichem Export stehen folgende Logs im Terminal zur Verfügung: 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 ZIP-Ausgabedatei (extracted_data_<timestamp>.zip) ist im selben Verzeichnis des Extraktionstools 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
Transformieren-Werkzeug
Dieses Transformationstool wird für alle Migrationen ausgeführt. Das Transformationstool läuft auf jedem Computer, einschließlich dem Administrator-Laptop eines Partners, und verwendet die öffentlichen APIs von Webex. Es liest die ZIP-Ausgabedatei (extracted_data_<timestamp>.zip) des Extraktionstools als Eingabe und wandelt das Roh-XML in ein JSON-Format um, das vom Bereitstellungstool verwendet wird.
Voraussetzungen
Konfigurieren Sie nach dem Herunterladen und Extrahieren der Binärdateien der Migrationstools die folgenden Voraussetzungen:
- Setzen Sie den REFRESH_TOKEN (Token kopiert vom Token Generator Tool) und NAME_OF_MAIN_LOCATION in der conf/partner.cfg Datei:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main
- Optional können Sie die PROVISIONING_ID (aus der Vorlage im Partner Hub kopiert) in der conf/partner.cfg Datei:
PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1
Um eine umfassendere Überprüfung der E-Mail-Adresse des Kunden zu erhalten, können Sie optional die PROVISIONING_ID festlegen. - Konfigurieren Sie fehlende Informationen in der input/customers.csv Datei (siehe nächsten Abschnitt), falls sie fehlt.
- Fügen Sie die E-Mail-Adresse des Endbenutzers in das input/users.csv Datei.
- Wenn neue Telefone bereitgestellt werden sollen, fügen Sie die MAC-Adresse und E-Mail-Adresse des neuen Telefons des Benutzers hinzu input/newphones.csv Datei. Dies ist nur erforderlich, wenn die Partneradministratoren neue Telefone im Wholesale-Calling bereitstellen möchten.
- Konvertieren Sie die BroadWorks Call Center in die CxEssentials mithilfe der input/cxessentials.csv Datei.
- Aktivieren Sie optional die Eigenschaft UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, um alle Call Center in CxEssentials zu konvertieren.
- Verwenden Sie die input/locations.csv Datei zur Unterstützung der Migration großer Unternehmen, die es Administratoren ermöglicht, die Standorte ihrer Kunden nach Standort zu migrieren
- 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. Entfernen Sie das Kommentarzeichen aus der Zeile „USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" in Datei conf/partner.cfg
- Mit der Netzwerkserver-Synchronisierungsfunktion können Administratoren während der Bereitstellung in derselben Regionsmigration Telefonnummern, MAC-Adressen und E-Mail-Adressen von Benutzern bereitstellen. Um es zu aktivieren, setzen Sie
USE_NS_SYNC=yes
inconf/partner.cfg
.Wenn die NS-Synchronisierung deaktiviert ist, wird die Bereitstellung von Telefonnummern und Geräten übersprungen und die Benutzer erhalten temporäre E-Mail-Adressen.
- 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 Anklopffunktion, die Wartemusik und die T38-Deaktivierungseinstellungen für alle Analogbenutzer zu konfigurieren.
Auffüllen der input/customers.csv
Die Datei input/customers.csv stellt Daten bereit, die in Cisco BroadWorks oder BroadCloud möglicherweise fehlen. Diese Datei kann leer gelassen werden, wenn alle Pflichtangaben bereits vorhanden sind. Sie müssen nicht alle Spalten ausfüllen, lediglich die fehlenden Angaben sind Pflichtangaben.
Die folgende Tabelle erläutert die wichtigsten Spalten in input/customers.csv.
Spaltenname |
Regeln |
---|---|
ID |
Im Cisco BroadWorks-Unternehmensmodus:
Im BroadWorks-Dienstanbietermodus ist dies die Cisco BroadWorks-Gruppen-ID. In BroadCloud ist dies die Rialto-Kunden-ID. |
externe ID |
Dies ist eine Kennung, die mit der internen Kennung des Partners für diesen Kunden übereinstimmt. Diese Spalte muss innerhalb einer Webex-Partnerorganisation eindeutig sein. Diese Spalte ist optional. Eine eindeutige Kennung wird automatisch vom Transformationstool generiert. Diese Spalte wird nicht für Gruppen innerhalb eines Unternehmens verwendet. |
Kundenname |
Für das Unternehmen wird diese Spalte als Feld für den Webex-Kundennamen verwendet. Für eine Gruppe innerhalb eines Unternehmens wird diese Spalte als Standortname verwendet. Standortnamen müssen innerhalb eines Unternehmens eindeutig sein. |
primäre E-Mail |
Dies wird als E-Mail-Adresse des Webex-Kundenadministrators verwendet. Diese Spalte ist für Gruppen innerhalb eines Unternehmens optional. |
Adressspalten |
Bei einem Unternehmen dient die Adresse als Rechnungsadresse und erste Standortadresse. Für eine Gruppe innerhalb eines Unternehmens wird die Adresse als Standortadresse verwendet. |
timezone |
Weitere Informationen finden Sie im Abschnitt „Zeitzone“ dieses Artikels. |
Sprache | Siehe Von Webex unterstützte Sprachen. |
Standard-Voicemail-PIN |
Siehe Voicemail-PIN festlegen. |
Auffüllen der input/users.csv
Die Datei input/users.csv stellt Daten bereit, die in Cisco BroadWorks oder BroadCloud möglicherweise fehlen. Diese Datei kann leer gelassen werden, wenn alle Pflichtangaben bereits vorhanden sind. Sie müssen nicht alle Spalten ausfüllen, lediglich die fehlenden Angaben sind Pflichtangaben.
Alle diese Felder sind optional.
Spaltenname |
Regeln |
---|---|
Benutzer-ID |
Eine eindeutige Kennung für den Benutzer. Dies kann eine BroadWorks- oder BroadCloud-Benutzer-ID sein. |
| (Optional) Die E-Mail-Adresse des Benutzers. Sofern angegeben, werden diese Daten für Bereitstellungszwecke verwendet. |
Telefonnummer |
(Optional) Die bereitzustellende Telefonnummer des Benutzers. |
Paket |
(Optional) Benutzerpakettyp. Zulässige Werte: Sprache, Anruf, Suite, common_area, virtual_line, dont_migrateoder call_park_ext. Der Wert dont_migrate wird verwendet, wenn Partner bestimmte Benutzer – zusammen mit ihren Geräten und Telefonnummern – sowohl von der Bereitstellung als auch von der Migration ausschließen möchten. Dies wird sowohl für BroadWorks als auch für BroadCloudunterstützt. Bei der Anwendung werden die ausgewählten Benutzer und ihre zugehörigen Ressourcen nicht migriert oder bereitgestellt. Um dies zu verwenden, sollten Administratoren dont_migrate in die Paketspalte der Datei users.csv eingeben. |
Anschluss |
(Optional) Die dem Benutzer zuzuweisende Telefondurchwahl. |
Name |
(Optional) Der vollständige Name des Benutzers. |
ata_settings |
(Optional) Zulässige Werte: t38, analog Zu enable/disable Anklopfen, Wartemusik und T38-Einstellungen T38: Diese Option deaktiviert die Anklopffunktion und Wartemusik und aktiviert die T38-Einstellungen für ATA-Geräte. Analog:
|
do_not_move_phone |
Nur BroadWorks. Optionales Flag, um die Gerätemigration zu Webex Calling zu verhindern. Mit dieser Option können Partner Benutzer zusammen mit ihren Anrufeinstellungen, Geräten und Telefonnummern bereitstellen, ohne die Geräte zu Webex zu migrieren oder Telefonnummern in Webex Calling zu aktivieren. Diese Einstellung ist nur für BroadWorksverfügbar, nicht für BroadCloud. Um es zu verwenden, sollten Administratoren do_not_move_phone in der Spalte do_not_move_phone (nur BroadWorks) der Datei users.csv angeben. Dadurch wird sichergestellt, dass die Benutzer bereitgestellt werden, ohne Nummern aktivieren oder ihre Telefone verschieben zu müssen, sodass sie weiterhin über BroadCloud arbeiten können. |
Anweisungen zum Ausführen
Führen Sie das Transform Tool auf jedem 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 Transform Tool in Windows auszuführen:
transform.bat -extract= -customers= -users= -newphones=
macOS
Führen Sie die folgenden Schritte aus, um das Transformationstool unter macOS auszuführen:
- Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten, um das Transformationstool mit Python auszuführen:
python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib python3 -m pip install phonenumbers
- Führen Sie das Transformationstool aus:
./transform.sh -extract= -customers= -users= -newphones=
Customer/user Vorprü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 validiert. Wenn der Wert PROVISIONING_ID in der conf/partner.cfg Datei, es werden auch Standortinformationen validiert. Die Ergebnisse der Vorprüfung sind im Ausnahmebericht enthalten.
Darüber hinaus können beim Ausführen des Transformationstools die folgenden optionalen Parameter hinzugefügt werden:
Vorprü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 Vorprüfungsfehler (d. h. Probleme, die die Bereitstellung blockieren) in den Ausnahmebericht aufgenommen. Durch das Hinzufügen dieses Flags werden auch erfolgreiche Vorprüfungsergebnisse berücksichtigt (z. B. wenn bereits eine Webex-Organisation vorhanden ist, die automatisch angehängt werden kann).
precheckinfo benötigt zusätzliche Zeit zum Ausführen.
Terminalprotokolle
Bei erfolgreicher Transformation werden im Terminal folgende Protokolle 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
Transform Tool generiert den Ausnahmebericht innerhalb der Ausgabe/<timestamp>/exception_report.txt Verzeichnis. Mithilfe dieses Berichts können Sie die Probleme identifizieren, die die Migration beeinträchtigen, und sie im Cisco BroadWorks-System beheben.
Nachdem Sie die Benutzerdaten geändert haben, um die Ausnahme zu beheben, führen Sie die Extrahierungs- und Transformationstools mit den neuen Daten erneut aus. Die Beispieldatei mit Ausnahmebericht 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 Beispieldatei customer.json 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"
}
}
Der `webex_for_broadworks_info` Die JSON-Eigenschaft ist für Webex nur für BroadWorks-Migrationen vorhanden. Der `broadcloud_info` Die JSON-Eigenschaft ist nur für BroadCloud-Migrationen vorhanden.
Bereitstellungstool
Das Bereitstellungstool 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 (customer.json) des Transformationstools als Eingabe und stellt die Kunden, Standorte, Nummern, Benutzer, Dienste und Geräte in der Webex Wholesale RTM-Lösung bereit.
Voraussetzungen
Konfigurieren Sie die folgenden Voraussetzungen im Bereitstellungstoolverzeichnis:
- Installieren Sie Java 8, 11, 17 oder 21 auf dem Computer. Java ist aus vielen Quellen verfügbar, darunter:
- Nachdem Sie die Binärdateien der Migrationstools heruntergeladen und extrahiert haben, legen Sie die JAVA-Umgebungsvariable_HOME in der provisioning_tool.sh-Datei für MAC und in provisioning_toolder .bat-Datei für Windows fest.
- Die Datei partner.cfg:
- Legen Sie die WHOLESALE_PROVISIONING_ID und den 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 der Partner keine Willkommens-E-Mail an die Benutzer senden möchte. Der Standardwert ist „true“.
- Legen Sie die WHOLESALE_PROVISIONING_ID und den 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:
- Verwenden Sie die Eigenschaft WEBEX4BWKS_EMAIL_SUBJECT für Webex für BroadWorks-Migrationen, um den E-Mail-Betreff der Kennwortänderungsanforderung für Webex für BroadWorks-Abonnenten zu senden.
- Verwenden Sie die Eigenschaft WEBEX4BWKS_EMAIL_BODY für Webex für BroadWorks-Migrationen, um den E-Mail-Text mit der Anforderung zur Kennwortänderung für Webex für BroadWorks-Abonnenten zu senden.
- Mit der Netzwerkserver-Synchronisierungsfunktion können Administratoren während der Bereitstellung in derselben Regionsmigration Telefonnummern, MAC-Adressen und E-Mail-Adressen von Benutzern bereitstellen. Um es zu aktivieren, setzen Sie
USE_NS_SYNC=yes
inconf/partner.cfg
.Wenn die NS-Synchronisierung deaktiviert ist, wird die Bereitstellung von Telefonnummern und Geräten übersprungen und die Benutzer erhalten temporäre E-Mail-Adressen.
Für BroadCloud-Migrationen in derselben Region:
- Das Tool überspringt die Bereitstellung von Nummern, Geräten und Shared Call Appearances.
- Das Tool erstellt Benutzer und virtuelle Benutzer mit Erweiterung und temporärer Erweiterung.
Für BroadCloud-Migrationen eine andere Region:
- Das Tool stellt Nummern, Geräte und gemeinsame Anrufanzeigen bereit.
- Das Tool erstellt Benutzer und virtuelle Benutzer mit tatsächlichen Telefonnummern und Durchwahlen.Alle BroadCloud-Migrationen in Europa erfolgen in eine andere Region.
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 Migration von Webex zu BroadWorks
Partneradministratoren müssen ihre BroadWorks-Onboarding-Vorlage für Webex für BroadWorks-Koexistenzfunktionen aktualisieren. Siehe folgendes Bild:

Sobald die Onboarding-Vorlage für Webex für BroadWorks aktualisiert wurde, um die Migration zu unterstützen, bitten Sie das Cisco Account Team, den Funktionsschalter „Wholesale-Partner-Blending aktiviert“ auf Partnerebene zu aktivieren. Dadurch können Großhandelspakete während der Bereitstellung zu bestehenden Webex für BroadWorks-Kundenorganisationen hinzugefügt werden.
Führen Sie das Bereitstellungstool mit einem zusätzlichen Argument aus.
Vorbereitungsphase: ist die Standardphase, in der Administratoren die BroadWorks-Benutzer als Großhandelsabonnenten bereitstellen und mit Webex für BroadWorks-Benutzer fortfahren können.
Erhaltungsphase: ist die zweite Phase, in der Administratoren die Großhandelslizenz den vorhandenen Webex-Benutzern für BroadWorks zuweisen können. Sie müssen das Bereitstellungstool mit dem Argument maintenanceausführen.
Phase nach der Migration: Dies ist die letzte Phase, in der Administratoren BroadWorks vollständig auf Großhandel umstellen können. Sie müssen das Bereitstellungstool mit dem Argument postmigrationausführen.
Terminalprotokolle
Nachfolgend sind die Protokolle im Terminal bei erfolgreicher Bereitstellung aufgeführt:
Tool Name: Provisioning Tool
Version: 1.15.0
********** Started Processing File : input/customer.json ****************
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
********** Completed File : input/customer.json ****************
Es wird eine Tabelle mit der Anzahl der für jeden Lauf erstellten Standorte ausgedruckt:

Ausgabe
Das Bereitstellungstool generiert Erfolgs- und Fehlerberichte innerhalb der Ausgabe/<external_id>/*.success/error Dateien. Überprüfen Sie die Erfolgs- und Fehlerprotokolle der Ausgabe, um die erfolgreiche Bereitstellung sicherzustellen.
Partneradministratoren können die Kundenbereitstellung im Partner Hub- und Control Hub-Portal überprüfen. Beachten Sie 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
Tool zum Verschieben von Geräten
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.
Innerhalb des Service Provider-Portals kann eine Migrationsanfrage bis zu 50 Kunden umfassen. Pro Tag können maximal 10 Anfragen gestellt werden.
Mit der Funktion „Netzwerkserver-Synchronisierung“ können Administratoren den broadCloud-Standort deaktivieren und den Webex Calling-Standort aktivieren, indem sie das USE_NS_SYNC=yes
in das conf/partner.cfg
setzen. Nach der Migration werden Geräte und Telefonnummern am Webex Calling-Standort aktiviert.
Administratoren können das automatische Rollback aktivieren, indem sie ROLLBACK_TO_BROADCLOUD=true
in der Datei conf/partner.cfg
festlegen, wodurch Geräte nach der Migration zurück zu BroadCloud verschoben werden. Es unterstützt sowohl Migrationen in dieselbe als auch in eine andere Region mit NS Sync, jedoch nur für erfolgreiche Migrationen. Bei fehlgeschlagenen Versuchen müssen Administratoren ein Cisco TAC erstellen, bevor sie ein Rollback anfordern.
Zur Auswahl des Migrationstyps stehen Ihnen im Portal zwei Möglichkeiten 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 in BroadCloud und beim Anrufen 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 der in der Datei customer.json
aufgeführten Standorte zu starten, fügen Sie Ihrer Anforderung eine Datei locations.csv
bei. In dieser CSV-Datei sollten nur die Standorte aufgeführt sein, die Sie migrieren möchten.
Wenn locations.csv nicht bereitgestellt wird, werden alle Standorte in customer.json migriert.
Begriff | Definition |
---|---|
Site-ID |
Die Site-ID des zu migrierenden Standorts. |
Site-Name |
Der Name des zu migrierenden Standorts. |
Um die Liste der verfügbaren aktiven Standorte herunterzuladen, navigieren Sie zu Kunden anzeigen → Kunden auswählen → Standorte als CSV exportieren.

Abbildung 14: Standorte als CSV exportieren
Für Cisco BroadWorks und Webex für BroadWorks
Bei Cisco BroadWorks- und Webex für BroadWorks-Migrationen wird das Tool auf dem sekundären Cisco BroadWorks-Anwendungsserver innerhalb des Partnernetzwerks ausgeführt und stellt über OCI-P eine Verbindung zum AS her. Es verwendet die JSON-Ausgabedatei (customer.json) des Transform Tools als Eingabe und führt die OCI-P-Befehle aus, um Geräte und Softclients zu migrieren.
Bei erfolgreichem Vorgang führt das Tool zum Verschieben von Geräten Folgendes aus:
- Melden Sie Geräte von Cisco BroadWorks ab und registrieren Sie sie im Großhandel.
- Benutzer, die den UC-One-Client verwenden, werden bei der ersten Anmeldung zur Webex-App weitergeleitet.
- Deaktivieren Sie die Telefonnummern von Cisco BroadWorks oder entfernen Sie die Telefonnummern aus BroadCloud.
- Nummern im Großhandel aktivieren.
- Erstellen Sie gemeinsame Anrufdarstellungen im Großhandel für BroadCloud-Migrationen. [This Schritt gilt nur für BroadCloud migrations].
SCP und SSH
- SCP: Das Tool zum Verschieben von Geräten zum sekundären Cisco BroadWorks-Anwendungsserver.
- Stellen Sie per SSH eine Verbindung zum sekundären Cisco BroadWorks-Anwendungsserver her, um die Voraussetzungen zu konfigurieren und das Tool zum Verschieben des Geräts auszuführen.
Voraussetzungen
- Setzen Sie den REFRESH_TOKEN (Token kopiert vom Token Generator Tool) in der conf/partner.cfg Datei:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
- Stellen Sie sicher, dass die sekundäre Cisco BroadWorks Application Server-Benutzer-ID, das Passwort und der Hostname im conf/deviceMoveTool.conf Datei:
BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost
- Um Aktivierungs-E-Mails erneut zu senden, müssen Sie RESEND_INVITATION_festlegen. EMAILS=true im conf/partner.cfg Datei.
Wenn Administratoren ihren Benutzern während der Migration Einladungs-E-Mails senden möchten, sollten sie die Auskommentierung der Zeile "RESEND_INVITATION_" entfernen. EMAILS=true" Eigentum in der conf/partner.cfg Datei. Ansonsten soll die Immobilie unverändert bleiben.
- Überprüfen Sie die JDK/JRE Der Umgebungspfad ist in devicemove.sh korrekt
JAVA_HOME=/usr/local/java/java_base
- Administratoren können die Datei „locations.csv“ aus dem Eingabeverzeichnis verwenden, um bestimmte Gruppen statt aller Gruppen eines Unternehmens zu migrieren.
Polycom-Telefone
Um Polycom-Telefone von Cisco BroadWorks auf Wholesale Calling umzustellen, muss ein Partneradministrator eine neue Identity/Device Profiltypdatei auf Systemebene in Cisco BroadWorks jede Polycom-Gerätevorlage. Siehe Abbildung 14 und laden Sie die benutzerdefinierte Datei hoch device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Stellen Sie nach dem Hochladen der neuen Gerätedatei sicher, dass die neu erstellte Datei auf Gruppenebene vorhanden ist. Stellen Sie außerdem sicher, dass die Datei migration_%BWMAC ADDRESS%.cfg nicht mit einer vorhandenen Datei in Ihrem System in Konflikt steht.
Es wird intern vom Tool zum Verschieben des Geräts verwendet.
Der Migrationsprozess für Polycom-Telefone:
- 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.
- Erstellen Sie die Geräteprofile auf Gruppen- oder Geräteebene neu.Das Handeln auf Gruppenebene oder Geräteebene hängt von der Konfiguration des Parameters deviceLevelRebuild in der Datei ab device-move-tool/conf/partner.cfg.
- Das Tool zum Verschieben von Geräten fordert den Cisco BroadWorks-Anwendungsserver auf, Telefone auf Gruppen- oder Geräteebene neu zu starten.
- Nach der Neustartanforderung laden Polycom-Telefone% BWMACADDRESS%.cfg herunter und verarbeiten sie. Dadurch werden die Polycom-Telefone aufgefordert, migration_%BWMACADDRESS%.cfg herunterzuladen und zu verarbeiten. Dadurch wird der device.prov.serverName auf https://plcm.sipflash.com.gesetzt.https://plcm.sipflash.com für die Region USA, andere Regionen haben andere URLs.
- Das Polycom-Telefon lädt %BWMACADDRESS%.cfg von https://plcm.sipflash.com herunter und wird vom Webex Calling DMS verwaltet.

Abbildung 14: Identity/device Profiltypdatei hinzufügen
Anweisungen zum Ausführen
Es gibt zwei Methoden, um das DMT aufzurufen: Die erste besteht darin, es jeweils nur über einen Kunden aufzurufen, die andere darin, es gleichzeitig über mehrere Kunden auszuführen.
Das Tool zum Verschieben von Geräten wird vom sekundären Cisco BroadWorks-Anwendungsserver im Verzeichnis 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 sind die Protokolle im Terminal aufgeführt, wenn das Device Move-Tool für die Gerätemigration erfolgreich ausgeführt wurde:
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 für make/receive Anrufe. In Abbildung 15 finden Sie ein Beispiel für den Gerätestatus:

Abbildung 15: Gerätestatus
Nach der Gerätemigration sind die Nummern aktiv geworden. In Abbildung 16 sehen Sie ein Beispiel der aktiven Nummern:

Abbildung 16: Nummern aktiv
Migration rückgängig machen
Der Rückgängig-Vorgang muss jeweils für ein Unternehmen ausgeführt werden.
Für BroadCloud Carrier
Der Rückgängigmachungsprozess für BroadCloud-Partner läuft wie folgt ab:
- Öffnen Sie ein Ticket beim Cisco TAC, um eine Geräterücksetzung anzufordern.
- Führen Sie das Tool zum Verschieben von Geräten im Rückgängig-Modus aus:
- Die Zuweisung von Telefonnummern zu Webex Calling wird aufgehoben, sodass Benutzern und Diensten nur Nebenstellen verbleiben.
- E-Mail-Adressen in Webex Calling werden auf temporäre E-Mail-Adressen zurückgesetzt.
- Telefone werden aus Webex Calling gelöscht.
- Telefonnummern, als alternative IDs verwendete E-Mail-Adressen und Telefone werden in BroadCloud neu erstellt.
- Die Telefone werden neu gestartet.
- Partneradministratoren müssen PSTN-Telefonnummern zurück zu BroadCloud Carrier verschieben.
Für Cisco BroadWorks und Webex für BroadWorks
Der Wiederherstellungsprozess für Cisco BroadWorks und Webex für BroadWorks läuft wie folgt ab:
- Öffnen Sie ein Ticket beim Cisco TAC, um eine Geräterücksetzung anzufordern.
- Führen Sie das Tool zum Verschieben von Geräten im Rückgängig-Modus auf dem sekundären BroadWorks-Anwendungsserver 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 erneut aktiviert.
- Das Webex Calling-Team setzt die DMS-URL in Geräteprofilen in Webex Calling wieder auf die DMS-URL des Dienstanbieters.
- Partneradministratoren müssen die Telefonnummern im Webex Calling über das Control Hub-Portal deaktivieren oder löschen.
- Partneradministratoren müssen PSTN-Telefonnummern zurück zu Cisco BroadWorks verschieben.
Anweisungen zum Ausführen des Geräteverschiebungstools im Rückgängig-Modus
Führen Sie die folgenden Schritte aus, um das Tool zum Verschieben von Geräten im Rückgängig-Modus auszuführen:
Führen Sie den folgenden Befehl im sekundären Cisco BroadWorks-Anwendungsserver im Verzeichnis des Geräteverschiebungstools aus:
Profile zurücksetzen
./devicemove.sh -input= -revertProfiles
Nummern zurücksetzen
./devicemove.sh -input= -revertNumbers
Terminalprotokolle
Wenn wir das Tool zum Verschieben des Geräts für den Rückgängig-Vorgang erfolgreich ausführen, erhalten wir im Terminal die folgenden Protokolle:
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
Nummern zurücksetzen
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
Anhang
Migration großer Unternehmen
Große Unternehmen mit vielen Standorten können nicht alle Standorte innerhalb eines einzigen Wartungsfensters migrieren. Die in diesem Abschnitt beschriebene Funktionalität ermöglicht es Partnern, jeweils mehrere Standorte zu migrieren.
Schritte
Gehen Sie wie folgt vor, um die schrittweise Migration für ein großes Unternehmen zu planen:
- Extrahieren Sie die Unternehmensdaten aus BroadWorks oder BroadCloud.
- Führen Sie das Transformationstool ohne Standortoption für die extrahierten Daten aus.
- Suchen Sie in exception_report.txt nach dem Abschnitt „Empfohlener Standort für gleichzeitiges Verschieben“, um die Migrationsphasen zu planen und weitere Informationen zu Standortabhängigkeiten zu erhalten. Untersuchen Sie die Funktionsagentenlistendateien (siehe Transform-Tool unten).
- Generieren Sie die Datei input/locations.csv, indem Sie locations_to_be_edited.csv ändern.
- Führen Sie das Transformationstool erneut mit der Standortoption aus.
- Untersuchen Sie exception_report.txt, um etwaige Probleme mit der Standortabhängigkeit für die aktuelle Phase zu identifizieren.
- Beheben Sie die Probleme mit der Standortabhängigkeit nach Bedarf (durch Ändern von locations.csv).
- Führen Sie das Transform-Tool erneut aus, um customers.json für die aktuelle Phase zu generieren.
- Führen Sie das Bereitstellungstool für jede customer.json aus.
- Führen Sie während des Wartungsfensters das Device Move Tool aus.
- Wiederholen Sie die Schritte 4 bis 10 für die nächste Phase.
Transformieren-Werkzeug
Um das Ziel zu erreichen, die Standorte in einem großen Unternehmen schrittweise zu migrieren, wird, wie oben erwähnt, eine neue Datei locations.csv als optionale Eingabe hinzugefügt (-locations=input/locations.csv) beim Ausführen des Transformationstools.
Die Datei locations.csv enthält standortspezifische Daten. Es überschreibt die Daten in input/customers.csv, das derzeit sowohl Unternehmens- als auch Standortdaten enthält.
Die folgende Tabelle listet die Details der locations.csvauf. :
Beschreibung |
Werte |
Standardwert |
Obligatorisch |
Karten in BroadWorks |
Karten in BroadCloud | |
---|---|---|---|---|---|---|
Unternehmens-ID |
Eindeutige Unternehmens-ID |
J |
Dienstanbieter-ID |
Rialto-Kundennummer | ||
Standort-ID |
Standort-ID, eindeutig innerhalb des Unternehmens |
J |
Gruppen-ID |
Rialto SiteId | ||
Migrationsstatus |
Wird dieser Standort migriert? |
migriert, dont_migrate, Migration |
Migration |
N | ||
Name |
Name dieses Standorts. Lassen Sie es leer, um die Standort-ID zu verwenden. |
N | ||||
timezone |
N | |||||
Sprache |
N | |||||
address1 |
N | |||||
address2 |
N | |||||
Stadt |
N | |||||
Stand |
N | |||||
Postleitzahl |
Postleitzahl |
N | ||||
Land |
2-Buchstaben-Code |
N |
Die Datei „locations.csv“ kann aus der vorab ausgefüllten locations_to_be_edited.csv-Datei zusammengestellt werden, wenn das Transform-Tool in einem großen Unternehmen ausgeführt wird. Lesen Sie weiter, um Beispiele zu sehen.
Die Datei locations.csv ist eine optionale Eingabe beim Ausführen des Transformationstools. Daher verhält sich das Transformationstool genauso wie zuvor, wenn die Option -locations=input/locations.csv ist nicht vorhanden.
Neue Ausgabedateien
Es gibt 5 neue Ausgabedateien vom Transformationstool:
- locations_to_be_edited.csv – diese ist bereits mit allen Standortinformationen für das zu migrierende Großunternehmen ausgefüllt.
Beispiel:
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US
Der partners/customers können damit locations.csv generieren, um die für eine bestimmte Phase zu migrierenden Standorte zu steuern (und die Standortinformationen nach Bedarf zu aktualisieren).
Beispiel: locations.csv generiert aus dem obigen locations_to_be_edited.csv
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,migrated,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,migrating,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,dont_migrate,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US
Dies locations.csvbedeutet: Für diese Phasewurde Standort auto_mig_ent_grp1 migriert, Standort auto_mig_ent_grp2 wird migriert und Standort auto_mig_ent_grp3 wird nicht migriert.
- hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4 Dateien haben den gleichen Zweck: Generieren Sie die vollständigen Listen der entsprechenden Funktionen agents/supervisors/originators/targets/monitored_elements an den Migrationsstandorten, wenn die Migrationsstandorte von anderen Standorten abhängig sind.
Sie haben fast das gleiche Format (der Name der 3. Spalte variiert je nach Funktion), wie unten (auto_mig_ent_grp2 Agentenliste der Hunt-Gruppe für die obige Phase):
Beispiel: das folgende ist aus hunt_group_agents.csv
feature name,feature location,agent,location
Sarah Rodriguez,auto_mig_ent_grp2,agent_michael@domain.com,auto_mig_ent_grp1
Sarah Rodriguez,auto_mig_ent_grp2,agent_sally@domain.com,auto_mig_ent_grp1
Wenn die Option „Standorte“ beim Ausführen des Transform-Tools nicht vorhanden ist, generieren die oben genannten 4 Dateien die vollständigen Listen der hunt-group/call-center/paging-group/busy-lamp-field’s agents/supervisors/originators/targets/monitored_elements für das gesamte Unternehmen, mit dem die schrittweisen Migrationen geplant werden können.
Neue Abschnitte in exception_report
Bei der schrittweisen Migration für große Unternehmen werden einige neue Abschnitte in exception_report.txt eingefügt, wenn Standortabhängigkeiten nicht erfüllt werden.
Beispiel: Der folgende neue Abschnitt ist für die Sammelanschlussgruppe „Sarah Rodriguez‘ Agenten“ am Standort auto_mig_ent_grp2 am Standort auto_mig_ent_grp3 bestimmt, die nicht migriert wurde und in dieser Phase auch nicht migriert wird.
Dependencies between locations - Hunt groups
Name Location Agent Agent's Location Comment
________________________________________________________________________________________________________________
Sarah Rodriguez auto_mig_ent_grp2 agent_william@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet
Sarah Rodriguez auto_mig_ent_grp2 agent_melody@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet
Der folgende neue Abschnitt enthält Empfehlungen zur Gruppierung der Standorte in den Migrationsphasen.
Empfohlene Standorte für gleichzeitige Bewegungen:
Location auto_mig_ent_grp1 has dependency on location(s) auto_mig_ent_grp2, auto_mig_ent_grp3
Location auto_mig_ent_grp2 has dependency on location(s) auto_mig_ent_grp3
Wenn die Standortoption beim Ausführen des Transformationstools nicht vorhanden ist, werden im Abschnitt „Empfohlene Standorte zum gleichzeitigen Verschieben“ alle Standortabhängigkeiten aufgelistet, um die Planung zu vereinfachen.
Während Sie das Transform-Tool mit der Standortoption ausführen (d. h. für eine Migrationsphase), werden im Abschnitt „Empfohlene Standorte zum gleichzeitigen Verschieben“ nur die Standortabhängigkeiten für die aktuelle Phase aufgelistet.
Bereitstellungstool
Für große Unternehmen kann das Bereitstellungstool wie gewohnt ausgeführt werden.
Tool zum Verschieben von Geräten
Das Tool zum Verschieben von Geräten kann für eine Teilmenge der Standorte aus der Datei customer.json ausgeführt werden. Um dies zu erreichen, fügen Sie eine neue optionale Datei locations.csv mit zwei Spalten hinzu.
External_id |
Standortnamen |
---|---|
Externer ID-Wert |
Namen der locations/group Namen |
- Dies ist eine optionale Datei. Wenn sie nicht angegeben wird oder leere Werte enthält, werden alle Standorte migriert.
- Wenn die Standortnamen und ihre jeweiligen external_-IDs angegeben werden, werden nur diese Standorte migriert.
Der Befehl lautet wie folgt:
./devicemove.sh -input=/customer.json -locations=/Location_names.csv
Zeitzonen
USA:
"timeZones":["America/Adak","America/Anchorage","America/Chicago","America/Denver","America/Los_Angeles","America/New_York","America/Phoenix","Pacific/Honolulu"]
Kanada:
"timeZones":["America/Dawson_Creek","America/Edmonton","America/Halifax","America/Montreal","America/Regina","America/St_Johns","America/Vancouver","America/Winnipeg"]
Australien:
"timeZones":["Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Hobart","Australia/Lord_Howe","Australia/Perth","Australia/Sydney"]
Frankreich:
"timeZones":["Europe/Paris"]
Portugal:
"timeZones":["Atlantic/Azores","Europe/Lisbon"]}
Vereinigtes Königreich:
"timeZones":["Europe/London"]
Italien:
"timeZones":["Europe/Rome"]
Deuschland:
"timeZones":["Europe/Berlin"]