Übersicht

In diesem Dokument werden detaillierte Anweisungen zur Verwendung der Tools für die Migration von Cisco BroadWorks, Webex für BroadWorks und BroadCloud zu Wholesale und Webex Calling bereitgestellt. Dieses Dokument behandelt eine Reihe von Migrationstools, die bei der Migration bestehender Kunden von Cisco BroadWorks, Webex für BroadWorks und BroadCloud zur Wholesale Route-to-Market-Lösung konzipiert wurden.

Die Migrationstools sollen einen vollständigen Übergang von BroadWorks zu Wholesale-Diensten ermöglichen. Sie sind nicht für die langfristige Koexistenz beider Dienstleistungen innerhalb derselben Kundenorganisation ausgelegt.

Migrationsauswirkung

Die Auswirkungen nach der Migration sind wie folgt:

Administratoren

Nach der Migration müssen Administratoren:

  • Verwenden Sie zunächst Partner Hub und Control Hub, um Funktionen anstatt CommPilot zu konfigurieren.
  • Konfigurieren Sie alle Funktionen, die nicht Teil der Migration sind, neu.

    Sie müssen die Funktionen, die nach Abschluss der Migrations-Tools nicht automatisch migriert werden, manuell migrieren.

Benutzer

Unterstützte Funktionen sollten nach der Migration genauso funktionieren wie vor der Migration. Webex Calling-Funktionen, die von der Migration nicht unterstützt werden, müssen nach der Migration in Webex neu konfiguriert werden:

  • Die Benutzer verlieren ihr Anrufprotokoll und ihren Nachrichtenverlauf.
  • Die Benutzer verlieren alle Einstellungen und Anpassungen für persönliche Schlüsselleitungen und müssen diese Einstellungen nach der Migration neu konfigurieren. Beispiele hierfür sind Kurzwahlen.
  • Die Benutzer müssen ihre Zugriffscodes und Kennwörter bei der ersten Anmeldung zurücksetzen.
  • Benutzer, die den UC-One-Client verwenden, müssen bei der ersten Anmeldung auf die Webex-App aktualisieren.

Architektur der Migrationstools

Die Architektur der Migrationstools besteht aus vier verschiedenen Tools:

  1. Extraktionstool: Extrahiert Unternehmen, Gruppen, Nummern, Benutzer, Dienste, Telefone und Soft-Clients aus Cisco BroadWorks. BroadCloud-Partner müssen eine Extract-Anforderung im Service Provider-Portal einreichen.
  2. Transformationstool – Wandelt die vom Extraktionstool extrahierten Informationen in eine JSON-Datei um, die bearbeitet werden kann.
  3. Bereitstellungstool: Verwendet die JSON-Ausgabedatei des Transformationstools, um Kunden, Standorte, Nummern, Benutzer, Dienste und Telefone mithilfe der öffentlichen Webex-APIs bereitzustellen.
  4. Tool zum Verschieben von Geräten: Verwendet die JSON-Ausgabedatei des Transformationstools, um die Profile neu zu erstellen, 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 und die Nummernaktivierung in Cisco BroadWorks.
    • BroadCloud-Partner müssen eine Migrationsanfrage im Service Provider Portal einreichen.

Die folgende Abbildung zeigt, wie die vier Tools nacheinander funktionieren, indem sie mit Cisco BroadWorks, öffentlichen APIs kommunizieren und Metriken in die Webex-Dienste für zukünftige Analysen hochladen, nachdem der Administrator die Migrationsaufgaben gestartet hat.

Architekturdiagramm der Migrationswerkzeuge

Abbildung 1. Migrations-Tools

Anforderungen

Bevor der Partner die Migrationstools ausführen kann, muss er die folgenden Anforderungen erfüllen:

  1. Das Partner- und Partneradministratorkonto muss in der Wholesale RTM-Lösung integriert sein. Während der Pre-Sale-Phase müssen Partner nicht in die Wholesale RTM-Lösung integriert werden, um das Extract-Tool ausführen zu können.
  2. Der Partner muss die Checkliste vor der Migration durchgehen, um sicherzustellen, dass alle Anforderungen erfüllt werden.
  3. Cisco BroadWorks-Systemadministrator-Anmeldeinformationen sind erforderlich, um die Tools zum Extrahieren und Verschieben des Geräts auszuführen. Dies gilt nicht für BroadCloud-Partner.
  4. Die Tools zum Extrahieren und Verschieben des Geräts müssen während eines Wartungsfensters auf dem sekundären Cisco BroadWorks-Anwendungsserver ausgeführt werden, um das Risiko zu minimieren. BroadCloud-Partner führen das Tool zum Verschieben von Geräten im Service Provider-Portal aus aus.
  5. Überprüfen Sie die Liste der unterstützten Webex Calling-Geräte.
  6. Überprüfen Sie die Liste der nicht unterstützten Webex Calling-Geräte.
  7. Partner müssen ihr Account-Team bei Cisco um die unterstützte Firmware-Version für Telefone und Geräte bitten.
  8. UC-One-Clients müssen auf die folgenden Versionen aktualisieren:
    • Desktop Communicator-Clients müssen Version 22.9.12 oder höher aufweisen.
    • Mobile Connect-Clients müssen Version 3.9.14 oder höher aufweisen.
  9. Die Maschine des Administrators muss Folgendes aufweisen:
    • JDK/JRE 1.8 ist für das Bereitstellungstool erforderlich.
    • MAC- und Linux-Maschinen benötigen Python 3.10.5 oder höher für das Transform-Tool.
  10. Kunden benötigen eine gültige Rechnungsadresse und Endbenutzer benötigen eine in Cisco BroadWorks konfigurierte geschäftliche E-Mail-Adresse. Wenn keine Werte festgelegt sind, müssen sich 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. Beispiel-CSV-Dateien werden mit dem Transformationstool bereitgestellt.

Migrationsplan

Der Migrationsplan umfasst 3 Stufen:

  1. Vorbereitung
    • Holen Sie sich eine Kopie der Benutzerdaten mit dem Extract Tool
    • Erzeuge einen Token mit dem Token-Generator-Tool
    • Verwenden Sie das Transformationstool, um Benutzerdaten zu formatieren
  2. Bereitstellung
    • Holen Sie sich die neuesten Benutzerdaten mit dem Extract Tool
    • Verwenden Sie das Transformationstool, um Benutzerdaten zu formatieren
    • Benutzer mit dem Bereitstellungstool bereitstellen
  3. Migration
    • Geräte mit dem Tool zum Verschieben von Geräten migrieren
    • Migrationen ohne Geräte [ Aktivierung von Telefonnummern über Control Hub ]

    Wenn die Partneradministratoren keine Geräte für den Wechsel von Cisco BroadWorks zu Wholesale haben, ist es nicht erforderlich, das Tool zum Verschieben von Geräten auszuführen. Partneradministratoren können den nachstehenden ö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, personalisiertes Namensaudio und Benutzer-PIN werden nicht migriert)
  • Alternative Nummern
  • BroadWorks Anywhere
  • Besetztlampenfeld
  • Anrufer-ID (benutzerdefinierter Name und Telefonnummer)
  • Wartender Anruf
  • Einstellungen für Rufumleitung (Rufumleitung immer/besetzt/keine Antwort/nicht erreichbar)
  • Anrufübernahme
  • Bitte nicht stören
  • Faxeinstellungen
  • Remote-Büro
  • Gemeinsame Leitung
  • Persönliches Klingeln gleichzeitig (einschließlich Zeitplan und selektive Kriterien)
  • Anrufbenachrichtigung (einschließlich Zeitplan und selektive Kriterien)
  • Anonyme Anrufablehnung
  • Selektive Anrufablehnung
  • Selektive Anrufweiterleitung
  • Gezielte Anrufübernahme und Aufschaltung
  • Aufschaltbefreiung
  • Push-to-Talk
  • Datenschutz

Diese Gruppenfunktionen werden von den Migrationstools automatisch migriert:

  • Automatische Anrufverteilung
    • Nur eine Ebene
    • Benutzerdefinierte Begrüßungen
    • Einstellungen für Rufumleitung (immer, besetzt, selektiv)
    • Alternative Nummern
    • Das Urlaubsmenü ist in Webex nicht verfügbar
    • Selektive Anrufablehnung
  • Cisco BroadWorks Call Center Standard und BroadCloud-Anrufwarteschlange:
    • Grundkonfiguration
    • Benutzerdefinierte Begrüßungen
    • Agenten und Supervisoren
    • Einstellungen für Rufumleitung (immer, besetzt, selektiv)
    • Alternative Nummern
    • Warteschleifenmusik
  • Anruf parken
  • Anrufannahme
  • Sammelanschluss
    • Einstellungen für die Rufumleitung (immer, besetzt, selektiv, nicht erreichbar)
    • Alternative Nummern
  • Standortcode (einer pro Standort oder Gruppe)
  • Paging-Gruppe
  • Zeitpläne (nur Gruppenebene, Unternehmenspläne werden nicht migriert)
  • Sprachportal
  • Warteschleifenmusik
  • Allgemeine Telefonliste

Unterstützte Geräte

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

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

Telefonmodell

Im Tool zum Verschieben von Geräten unterstützt

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

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

Jealink T33G

Ja

DMS Yealink T33G

Jealink T41S

Ja

DMS Yealink T41S

Jealink T42S

Ja

DMS Yealink T42S

Jealink T43U

Ja

DMS Yealink T43U

Jahr T46U

Ja

DMS Yealink T46U

Jahr T46S

Ja

DMS Yealink T46S

Jealink T48S

Ja

DMS Yealink T48S

Jealink T48U

Ja

DMS Yealink T48U

Jealink T53W

Ja

DMS Yealink T53W

Jealink T54W

Ja

DMS Yealink T54W

Jealink T57W

Ja

DMS Yealink T57W

JahrLink T58V

Ja

DMS Jahresinks T58V

Yealink CP920

Ja

DMS Yealink CP920

Yealink CP960

Ja

DMS Yealink CP960

Yealink W52B

Ja

DMS Yealink W52P

Jealink W56B

Ja

DMS Yealink W56P

Jealink W60B

Ja

DMS Yealink W60P

Jealink 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 die nicht unterstützten Geräte von der Wholesale RTM-Lösung verwendet, sind diese Geräte nicht zur Migration berechtigt. In diesem Fall haben Sie folgende Möglichkeiten:

  1. Stellen Sie neue Telefone in Cisco BroadWorks bereit, bevor Sie die Migration durchführen.
  2. Lassen Sie die alten Telefone in Cisco BroadWorks. Benutzer müssen die Webex-App installieren, um Anrufe zu tätigen und zu empfangen.

Wholesale Calling-Pakete

Die Migrationstools haben eine Reihe von Standardwerten für die Auswahl von Wholesale Calling-Paketen für Abonnenten. Wenn später ein anderes Paket gewünscht wird, können diese von einem Partneradministrator in Control Hub geändert werden.

Konfiguration des Cisco BroadWorks-Migrationspakets

Alle Subscriber von der Migration von Cisco BroadWorks werden standardmäßig auf das Webex Calling-Paket eingestellt. Wenn das Webex-Sprachpaket für Abonnenten gewünscht wird, die keine Anklopffunktion oder Voicemail zugewiesen haben, kann dies in der Datei partner.cfg des Transformationstools aktiviert werden, indem das _WEBEX_VOICE_PACKAGE für die Leitung aufgehoben wird.

Zuordnung des Webex für BroadWorks-Migrationspakets

Webex für BroadWorks-Pakete werden automatisch Wholesale Calling-Paketen zugeordnet. Dies ist nicht konfigurierbar.

Webex für BroadWorks-Paket

Wholesale Calling-Paket

Softphone

Webex Voice

Standard

Webex Anrufe

Standard

Webex Suite

Premium

Webex Suite

BroadCloud-Migrationspaket-Zuordnung

Migrationen von BroadCloud Carrier-Kartenpaketen basierend auf dem Stationstyp. Die Standardzuordnung kann in der Konfigurationsdatei conf/rialto_station_type_to_wholesale_package.csv des Transformationstools konfiguriert werden.

Typ der BroadCloud Carrier-Station

Wholesale Calling-Paket

Standard

Webex Voice

Konferenzraum

Webex Voice

Messaging

Webex Voice

Standard

Webex Voice

Führungskraft

Webex Suite

Alle anderen Stationsarten

Webex Voice

Transformieren eines BroadWorks- oder BroadCloud-Benutzerkontos in einen Webex Calling-Arbeitsbereich

Ein Webex-Arbeitsbereich ist ein Telefon, das von vielen Personen gemeinsam genutzt wird. Beispiel: Beispiel: Telefone in einem Konferenzraum, einem Lager oder einer Lobby. Solche Telefone können in Webex Calling als Webex-Arbeitsbereiche anstelle von Webex-Benutzern konfiguriert werden. Es ist eine Option verfügbar, um Benutzerkonten von Cisco BroadWorks oder BroadCloud Carrier während des Migrationsprozesses automatisch in Arbeitsbereiche umzuwandeln.

Schritte:

  1. Weisen Sie in der Datei transform_tool/input/users.csv das Paket „common_area“ den Benutzern zu, die in einen Arbeitsbereich umgewandelt werden sollen.
    • Beispiel: bwuser@domäne,,,common_area
  2. (Nur BroadCloud) Um alle Benutzerkonten eines bestimmten Stationstyps in Arbeitsbereiche zu konvertieren, fügen Sie einen Eintrag für transform-tool/conf/rialto_station_type_to_wholesale_package.csv hinzu und legen Sie das Wholesale-Paket auf „common_area_calling“ fest.
    • Beispiel: conference_room_v2,common_area_calling
  3. Führen Sie das Transformationstool aus.
  4. Führen Sie das Bereitstellungstool aus.
  5. Ö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).
  6. Führen Sie das Bereitstellungstool erneut aus. Dadurch werden die Arbeitsbereiche erstellt und Telefone zugewiesen.

Beschränkungen:

Die Konfiguration von Benutzerfunktionen (z. B. Anrufweiterleitung, Bitte nicht stören) wird nicht automatisch zum Arbeitsbereich migriert.

Control Hub-Fenster in den Organisationseinstellungen, in dem die SIP-Adresse für Cisco Webex Calling hervorgehoben wird.

Abbildung 2: Konfigurieren einer SIP-Domäne in Control Hub

Token-Generator-Tool

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

Voraussetzungen

Installieren Sie Java 8, 11, 17 oder 21 auf dem Computer. Java ist aus vielen Quellen verfügbar, darunter:

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

Dieser Schritt ist optional.

Anweisungen für die Ausführung

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

  • Die folgenden Ports müssen zum Ausführen des Token-Generator-Tools verfügbar sein. Ports: 8080, 50009, 50010, 50011, 50012 und 50013

  • Mindestens einer dieser genannten Ports muss für die Verbindung auf dem Computer des Benutzers 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 abzurufen und dieses zur weiteren Verwendung zu kopieren.

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

Anmeldung mit Cisco Webex-Bildschirm

Abbildung 3: Anmeldung mit Cisco Webex

Anmeldebildschirm des Fensters „Anmeldeinformationen“

Abbildung 4: Anmeldeinformationen-Fenster

Bildschirm „Tokengenerierung“

Abbildung 5: Token-Generierung

BroadWorks-Einrichtungsaufgaben

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

Dies gilt für Cisco BroadWorks und Webex für BroadWorks. Diese Schritte gelten nicht für BroadCloud.

OCI-P-Konnektivität aktivieren

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

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

Ändern Sie das Verzeichnis in OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Führen Sie die folgende CLI aus, um die aktuellen Einstellungen abzurufen. Sie sollten Folgendes sehen:

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

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

Schritt 3: Verwenden Sie die CLI, um die OCI-Bereitstellung zu konfigurieren.

Änderung im Bereitstellungsverzeichnis:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

Schritt 4: Führen Sie den Befehl unten in 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 dieser nicht bereitgestellt wurde oder noch nicht begonnen hat.

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

AS_CLI/Maintenance/ManagedObjects> 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 CLI aus, um die Aktivierung der Nummern zu aktivieren:

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 in der Bestätigungsaufforderung J ein.

Extraktionstool

Für BroadCloud

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

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

Die folgenden Zahlen zeigen das Dienstleister-Portal.

Auf dem Bildschirm „Serviceanbieterportal“ wird die Extraktionsanfrage zum Initiieren der Wholesale-Migration angezeigt.

Abbildung 6: Dienstleister-Portal

Bildschirm des Service-Provider-Portals mit Anfragen zum Wholesale-Migrationsextrakt

Abbildung 7: Dienstleister-Portal

Für Cisco BroadWorks und Webex für BroadWorks

  1. Das Extract-Tool wird auf dem sekundären Cisco BroadWorks-Anwendungsserver im Partnernetzwerk ausgeführt und über OCI-P verbunden.
  2. Das Tool ruft rohe Unternehmens-, Gruppen-, Nummern-, Benutzer-, Services-, Geräte- und Soft-Client-Daten von der Cisco BroadWorks- oder BroadCloud-Plattform ab und gibt diese Daten in XML-Dateien aus, die die Eingaben für das Transformationstool bereitstellen.

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

Voraussetzungen

  1. SCP die Binärdateien des Extraktionstools zum sekundären Cisco BroadWorks-Anwendungsserver.
  2. SSH zum sekundären Cisco BroadWorks-Anwendungsserver, um die Voraussetzungen zu konfigurieren und das Extraktionstool auszuführen.
  3. Konfigurieren Sie den Serviceanbieter und die Gruppen-ID, um aus Cisco BroadWorks in conf/exportTool.yml zu extrahieren. Siehe den folgenden Beispiel-YAML-Ausschnitt:
    ServiceProviderID-A:
         - GroupID-A1
         - GroupID-A2
         - GroupID-A3
    ServiceProviderID-B:
                           - ALL
    
  4. Stellen Sie sicher, dass die Benutzer-ID, das Kennwort und der Hostname des sekundären Cisco BroadWorks-Anwendungsservers in der Datei conf/partner.cfg richtig sind:
    BROADWORKS_USER_ID = admin
    BROADWORKS_PASSWORD = admin
    BROADWORKS_HOST_NAME = localhost
    REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
    MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
    

    Die REFRESH_TOKEN Eigenschaft ist für eine Migration von Webex für BroadWorks erforderlich.

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

Anweisungen für die Ausführung

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

./export.sh

Terminal-Protokolle

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

 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 Transformationstool-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

Transformationswerkzeug

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

Voraussetzungen

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

  1. Legen Sie den AKTUALISIERUNGS_TOKEN (der aus dem Token-Generator-Tool kopierte Token) und den NAMEN_DES_HAUPTSTANDORTS_ in der Datei conf/partner.cfg fest:
    REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
    NAME_OF_MAIN_LOCATION=Main
    
  2. Legen Sie optional die Bereitstellungs-_ID (kopiert aus der Vorlage in Partner Hub) in der Datei conf/partner.cfg fest:
    PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1
    Um eine vollständigere Verifizierung der E-Mail-Adresse des Kunden zu erhalten, können Sie optional die BEREITSTELLUNGS-ID_festlegen.
  3. Konfigurieren Sie fehlende Informationen in der Datei input/customers.csv (siehe nächster Abschnitt), wenn sie fehlen.
  4. Fügen Sie die E-Mail-Adresse des Endbenutzers in der Datei „input/users.csv“ hinzu.
  5. Wenn neue Telefone bereitgestellt werden sollen, fügen Sie die MAC-Adresse und die E-Mail-Adresse des neuen Telefons des Benutzers zur Datei input/newphones.csv hinzu. Dies ist nur erforderlich, wenn die Partneradministratoren neue Telefone in Wholesale-Anrufen bereitstellen möchten.
  6. Konvertieren Sie die BroadWorks-Callcenter mithilfe der Datei input/cxessentials.csv in CxEssentials.
  7. Aktivieren Sie optional die Eigenschaft „UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS“, um alle Call Center in CxEssentials zu konvertieren.
  8. Verwenden Sie die Datei input/locations.csv, um die Migration großer Unternehmen zu unterstützen, mit der Administratoren die Standorte ihrer Kunden nach Standorten migrieren können.
  9. Aktivieren Sie optional die Verwendung von MAC-Adressen über den User-Agent-Header der SIP REGISTER-Nachricht, wenn die MAC-Adresse im Cisco BroadWorks-Geräteprofil nicht verfügbar ist. Kommentieren der Zeile „_MAC_ADDRESS_FROM_SIP_REGISTER=yes“ in der Datei „conf/partner.cfg“ aufheben
  10. Mit der Funktion zur Synchronisierung des Netzwerkservers können Administratoren Telefonnummern, MAC-Adressen und E-Mail-Adressen der Benutzer während der Bereitstellung in derselben Region bereitstellen. Um sie zu aktivieren, legen Sie USE_NS_SYNC=yes in conf/partner.cfg fest.

    Wenn die NS-Synchronisierung deaktiviert ist, wird die Telefonnummern- und Gerätebereitstellung übersprungen und die Benutzer erhalten temporäre E-Mail-Adressen.

Eingabe/customers.csv ausfüllen

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

Alle diese Felder sind optional.

In der folgenden Tabelle werden die wichtigsten Spalten in input/customers.csv erklärt.

Spaltenname

Regeln

ID

Im Cisco BroadWorks-Enterprise-Modus:

  • Dies ist die Cisco BroadWorks ServiceProviderId für das Unternehmen.
  • Außerdem wird für jede Gruppe im Unternehmen eine separate Leitung benötigt. Die ID ist die Cisco BroadWorks-Gruppen-ID.

Im BroadWorks-Serviceanbietermodus 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 Webex-Kundennamensfeld 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-Adresse

Diese wird als E-Mail-Adresse des Webex-Kundenadministrators verwendet.

Diese Spalte ist optional für Gruppen innerhalb eines Unternehmens.

Adressspalten

Bei einem Unternehmen wird die Adresse als Rechnungsadresse und als erste Standortadresse verwendet.

Für eine Gruppe innerhalb eines Unternehmens wird die Adresse als Standortadresse verwendet.

timezone

Weitere Informationen finden Sie im Abschnitt zur Zeitzone in diesem Artikel.

Sprache

Siehe Von Webex unterstützte Sprachen.

standardmäßigeVoicemailpin

Siehe Festlegen einer Voicemail-PIN.

Anweisungen für die Ausführung

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

Windows

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

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

macOS

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

  1. Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten, um das Transformationstool mit Python auszuführen:
    python3 -m venv venv
    source venv/bin/activate
    python3 -m pip install requests
    python3 -m pip install requests-oauthlib
    python3 -m pip install phonenumbers
    
  2. Führen Sie das Transformationstool aus:
    ./transform.sh -extract= -customers= -users= -newphones=

Kunden-/Benutzervorabüberprüfung

Das Transformationstool führt API-Anrufe an Webex durch, um mögliche Bereitstellungsprobleme zu beheben. Standardmäßig werden die Adresse und die primäre E-Mail-Adresse des Kunden validiert. Wenn die BEREITSTELLUNG_Der ID-Wert wird in der Datei conf/partner.cfg angegeben. Außerdem werden die Standortinformationen validiert. Die Ergebnisse der Vorabüberprüfung sind im Ausnahmebericht enthalten.

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

Vorabüberprüfung

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

VorschauInfo

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

Die Ausführung von precheckinfo erfordert zusätzliche Zeit.

Terminal-Protokolle

Die folgenden Protokolle im Terminal bei erfolgreicher Transformation:

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

Ausnahmebericht

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

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

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) steht im Verzeichnis output/<timestamp>/<groupid> zur Verfügung. Die Beispieldatei customer.json 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"
    }
}

Die JSON-Eigenschaft `webex_for_broadworks_info` ist nur für Webex für BroadWorks-Migrationen vorhanden. Die JSON-Eigenschaft `broadcloud_info` ist nur für BroadCloud-Migrationen vorhanden.

Bereitstellungstool

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

Voraussetzungen

Konfigurieren Sie die folgenden Voraussetzungen im Verzeichnis des Bereitstellungstools:

  1. Installieren Sie Java 8, 11, 17 oder 21 auf dem Computer. Java ist aus vielen Quellen verfügbar, darunter:
  2. Nachdem Sie die Binärdateien der Migrationstools heruntergeladen und extrahiert haben, legen Sie die Umgebungsvariable JAVA_HOME in provisioning_tool.sh für MAC und provisioning_tool.bat für Windows fest.
  3. Die Datei partner.cfg:
    • Legen Sie die WHOLESALE_BEREITSTELLUNGS_ID und das AKTUALISIERUNGS_TOKEN fest (der aus dem Token-Generator-Tool kopierte Token). Die Partneradministratoren müssen sich an ihr Account-Team wenden, um die Bereitstellungs-ID_zu erhalten:
      WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
      REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
      
    • Legen Sie ALLOW_ADMIN_INVITE_E-MAILS auf „false“ fest, wenn der Partner keine Willkommens-E-Mail an die Benutzer senden möchte. Der Standardwert ist „true“.

  4. Verwenden Sie die Eigenschaft WEBEX4BWKS_E-MAIL_SUBJECT für Webex für BroadWorks-Migrationen, um den Betreff für die Anforderung zum Ändern des Passworts für Webex für BroadWorks-Abonnenten zu senden.
  5. Verwenden Sie die WEBEX4BWKS_EMAIL_BODY-Eigenschaft für Webex für BroadWorks-Migrationen, um den E-Mail-Text für Anfragen zur Änderung des Passworts für Webex für BroadWorks-Abonnenten zu senden.
  6. Mit der Funktion zur Synchronisierung des Netzwerkservers können Administratoren Telefonnummern, MAC-Adressen und E-Mail-Adressen der Benutzer während der Bereitstellung in derselben Region bereitstellen. Um sie zu aktivieren, legen Sie USE_NS_SYNC=yes in conf/partner.cfg fest.

    Wenn die NS-Synchronisierung deaktiviert ist, wird die Telefonnummern- und Gerätebereitstellung übersprungen und die Benutzer erhalten temporäre E-Mail-Adressen.

Bei BroadCloud-Migrationen dieselbe Region:

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

Für BroadCloud-Migrationen eine andere Region:

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

Anweisungen für die Ausführung

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

Windows

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

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

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

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

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

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

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

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

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

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

Terminal-Protokolle

Bei erfolgreicher Bereitstellung finden Sie die Protokolle im Terminal:

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 Durchgang erstellten Standorte gedruckt:

Tabelle mit der Anzahl der für jede Ausführung erstellten Standorte.

Ausgabe

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

Nach der erfolgreichen Bereitstellung erhalten Kundenadministratoren und Endbenutzer eine E-Mail von der Wholesale RTM-Lösung.

Partneradministratoren können die Kundenbereitstellung im Partner Hub- und Control Hub-Portal überprüfen. Weitere Informationen finden Sie in den folgenden Abbildungen im Partner Hub- und Control Hub-Portal:

Screenshot von Partner Hub, der eine Suche nach einem Wholesale-Kunden im Dropdown-Feld „Kunde auswählen“ zeigt.

Abbildung 8: Partner Hub

Screenshot von Control Hub mit der Registerkarte „Benutzer“ und einer Liste der Benutzer.

Abbildung 9: Control Hub

Screenshot von Control Hub mit dem Gerätebildschirm und einer Liste der Geräte.

Abbildung 10: Geräte

Screenshot von Control Hub mit dem Nummernbildschirm und einer Liste der Telefonnummern.

Abbildung 11: Anrufe

Geräteverschiebungswerkzeug

Für BroadCloud

Für BroadCloud-Partner verwenden Sie das Service-Provider-Portal, um eine Migrationsanfrage für Nummern, Geräte und SCA-Migrationen zu senden.

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

Die Funktion „Netzwerkserver-Synchronisierung“ ermöglicht es Administratoren, den broadCloud-Standort zu deaktivieren und den Webex Calling-Standort zu aktivieren, wenn Sie USE_NS_SYNC=yes in conf/partner.cfg festlegen. 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 conf/partner.cfg -Datei festlegen, die Geräte nach der Migration zurück in BroadCloud verschiebt. Mit NS Sync werden sowohl Migrationen derselben als auch von verschiedenen Regionen unterstützt, jedoch nur für erfolgreiche Migrationen. Bei fehlgeschlagenen müssen Administratoren einen Cisco TAC anfordern, bevor sie ein Rollback anfordern.

Die folgenden Zahlen zeigen das Dienstleister-Portal.

Dienstanbieter-Portal, in dem die Anfrage zum Initiieren der Migration angezeigt wird.

Abbildung 12: Dienstleister-Portal

Dienstleister-Portal zeigt Migrationsanfrage anzeigen an.

Abbildung 13: Dienstleister-Portal

Für Cisco BroadWorks und Webex für BroadWorks

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

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

  1. Heben Sie die Registrierung von Geräten bei Cisco BroadWorks auf und registrieren Sie sie in Wholesale.
  2. Benutzer, die den UC-One-Client verwenden, werden bei der erstmaligen Anmeldung zur Webex-App umgeleitet.
  3. Deaktivieren Sie die Telefonnummern von Cisco BroadWorks oder entfernen Sie die Telefonnummern von BroadCloud.
  4. Aktivieren Sie Nummern in Wholesale.
  5. Erstellen Sie gemeinsam genutzte Anrufnutzungen in Wholesale für BroadCloud-Migrationen. [Dieser Schritt gilt nur für BroadCloud-Migrationen].
Wenn keine bei Cisco BroadWorks oder BroadCloud registrierten Geräte vorhanden sind, die migriert werden müssen, müssen Sie das Tool zum Verschieben von Geräten nicht ausführen.

SCP und SSH

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

Voraussetzungen

  1. Legen Sie den AKTUALISIERUNGS_TOKEN (der aus dem Token-Generator-Tool kopierte Token) in der Datei conf/partner.cfg fest:
    REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
  2. Stellen Sie sicher, dass die Benutzer-ID, das Kennwort und der Hostname des sekundären Cisco BroadWorks-Anwendungsservers in der Datei conf/deviceMoveTool.conf richtig sind:
    BROADWORKS_USER_ID = admin
    BROADWORKS_PASSWORD = admin
    BROADWORKS_HOST_NAME = localhost
    
  3. Um Aktivierungs-E-Mails erneut zu senden, müssen Sie RESEND_INVITATION_EMAILS=true in der Datei conf/partner.cfg festlegen.

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

  4. Überprüfen Sie, ob 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 bestimmten Gruppen anstelle aller Gruppen unter einem Unternehmen zu migrieren.

Polycom-Telefone

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

device-move-tool/conf/deviceProfile/{region}/polycom_vvx2.cfg

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

Der Migrationsprozess für Polycom-Telefone:

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

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

Verwenden Sie im Feld "MAC-Adresse in:" die gleichen Werte wie die anderen Dateien in der Polycom-Vorlage. (Verwenden Sie in Abbildung 14 den HTTP-Anforderungs-URI, aber dies ist möglicherweise nicht für die Cisco BroadWorks-Anwendungsserver-Bereitstellung des Partners geeignet).

Anweisungen für die Ausführung

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

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

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

Terminal-Protokolle

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

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 können Anrufe tätigen/empfangen. Ein Beispiel für den Gerätestatus finden Sie in Abbildung 15:

Screenshot der Seite „Control Hub-Geräte“ mit dem Gerätestatus.

Abbildung 15: Gerätestatus

Nach der Gerätemigration sind die Nummern aktiviert. Abbildung 16 zeigt, welche Nummern aktiv sind:

Screenshot des Bildschirms „Control Hub-Nummern“ mit aktiven Nummern.

Abbildung 16: Aktive Nummern

Migration zurücksetzen

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

Das Tool zum Verschieben von Geräten deaktiviert die Nummern in Wholesale Calling aufgrund technischer Einschränkungen beim Zurücksetzen nicht.

Für BroadCloud-Anbieter

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

  1. Öffnen Sie ein Ticket mit Cisco TAC, um die Wiederherstellung eines Geräts anzufordern.
  2. Führen Sie das Tool für die Geräteverschiebung im Revert-Modus aus:
    • Die Zuweisung von Telefonnummern zu Webex Calling wird aufgehoben, sodass Benutzer und Dienste nur mit Durchwahlen übrig bleiben.
    • E-Mail-Adressen in Webex Calling werden auf temporäre E-Mail-Adressen zurückgesetzt.
    • Telefone werden aus Webex Calling gelöscht.
    • Telefonnummern, E-Mail-Adressen, die als alternative IDs verwendet werden, und Telefone werden in BroadCloud neu erstellt.
    • Die Telefone werden neu gestartet.
  3. Partneradministratoren müssen PSTN-Telefonnummern zurück in BroadCloud Carrier verschieben.

Für Cisco BroadWorks und Webex für BroadWorks

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

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

Anweisungen zum Ausführen des Geräteverschiebungswerkzeugs im Reversemodus

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

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

Profile zurücksetzen

./devicemove.sh -input=  -revertProfiles

Nummern zurücksetzen

./devicemove.sh -input=  -revertNumbers

Terminal-Protokolle

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

Profile zurücksetzen

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 in einem einzigen Wartungsfenster migrieren. Die in diesem Abschnitt beschriebene Funktionalität ermöglicht es Partnern, einige Standorte gleichzeitig zu migrieren.

Schritte

Führen Sie die folgenden Schritte aus, um die phasenweise Migration für ein großes Unternehmen zu planen:

  1. Extrahieren Sie die Unternehmensdaten aus BroadWorks oder BroadCloud.
  2. Führen Sie das Transformationstool ohne die Standortoption auf den extrahierten Daten aus.
  3. Suchen Sie den Abschnitt „Empfohlener Standort zum gleichzeitigen Verschieben“ in exception_report.txt, um die Migrationsphasen zu planen und weitere Informationen zu Standortabhängigkeiten zu erhalten. Prüfen Sie die Dateien der Funktionsliste der Agenten (siehe Transformationstool unten).
  4. Generieren Sie die Datei input/locations.csv, indem Sie die Datei locations_to_be_edited.csv ändern.
  5. Führen Sie das Transformationstool mit der Standortoption erneut aus.
  6. Untersuchen Sie exception_report.txt, um Standortabhängigkeitsprobleme für die aktuelle Phase zu identifizieren.
  7. Beheben Sie bei Bedarf die Probleme mit der Standortabhängigkeit (durch Ändern von locations.csv).
  8. Führen Sie das Transform-Tool erneut aus, um customers.json für die aktuelle Phase zu generieren.
  9. Führen Sie das Bereitstellungstool für jede „customer.json“-Datei aus.
  10. Führen Sie im Wartungszeitfenster das Tool zum Verschieben von Geräten aus.
  11. Wiederholen Sie die Schritte 4 bis 10 für die nächste Phase.

Transformationswerkzeug

Um das oben erwähnte Ziel zu erreichen, die Standorte in einem großen Unternehmen schrittweise zu migrieren, wird beim Ausführen des Transformationstools eine neue Datei locations.csv als optionale Eingabe (-locations=input/locations.csv) hinzugefügt.

Die locations.csv enthält standortspezifische Daten. Es überschreibt die in input/customers.csv gefundenen Daten, die derzeit sowohl Unternehmens- als auch Standortdaten enthalten.

In der folgenden Tabelle sind die Details der locations.csv aufgeführt:

Beschreibung

Werte

Standardwert

Obligatorisch

Karten in BroadWorks

Karten in BroadCloud

Unternehmens-ID

Eindeutige Unternehmens-ID

J

Dienstanbieter-ID

Rialto-Kunden-ID

Standort-ID

Standort-ID, innerhalb des Unternehmens eindeutig

J

Gruppen-ID

Rialto-Site-ID

Migrationsstatus

Wird dieser Standort migriert?

migriert, dont_migrate, migrieren

migrieren

N

Name

Name dieses Standorts.

Lassen Sie sie leer, um die locationID zu verwenden.

N

timezone

N

Sprache

N

address1

N

address2

N

Stadt

N

Stand

N

Postleitzahl

Postleitzahl

N

Land

2-Buchstaben-Code

N

Die CSV-Datei „locations.csv“ kann aus der vorab ausgefüllten locations_to_be_edited.csv-Datei zusammengesetzt werden, wenn das Transformationstool in großen Unternehmen ausgeführt wird. Lesen Sie weiter, um Beispiele zu sehen.

locations.csv ist eine optionale Eingabe, wenn das Transformationstool ausgeführt wird. Daher verhält sich das Transformationstool wie zuvor, wenn die Option -locations=input/locations.csv nicht vorhanden ist.

Neue Ausgabedateien

Es gibt 5 neue Ausgabedateien vom Transformationstool:

  • locations_to_be_edited.csv – Diese Datei ist mit allen Standortinformationen für das zu migrierende Großunternehmen vorab 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 

Die Partner/Kunden können damit location.csv generieren, um die Standorte zu steuern, die für eine bestimmte Phase migriert werden sollen (und ggf. die Standortinformationen aktualisieren).

Beispiel: locations.csv aus der obigen locations_to_be_edited.csv generiert

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.csv bedeutet: In dieser Phase wurde Standort auto_mig_ent_grp1 migriert, Standort auto_mig_ent_grp2 wird migriert und nicht migrieren Sie Standort auto_mig_ent_grp3.

  • hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4 Dateien haben denselben Zweck: die vollständigen Listen der entsprechenden Funktionen Agenten/Supervisoren/Ersteller/Ziele/monitored_elements an den migrierenden Standorten generieren, wenn die migrierenden Standorte Abhängigkeiten zu anderen Standorten haben.

Sie haben fast das gleiche Format (der Name der 3. Spalte variiert je nach Funktion), wie unten beschrieben (die Agentenliste des auto_mig_ent_grpSammelanschlusses 2 für die obige Phase):

Beispiel: Folgendes stammt von 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 Standortoption beim Ausführen des Transformationstools nicht vorhanden ist, werden mit den oben genannten 4 Dateien die vollständigen Listen der Agenten/Supervisoren/Ersteller/Ziele/monitored_elements der Sammelanschlussgruppe/Callcenter/Paging-Gruppe/Besetztlampenfeld für das gesamte Unternehmen generiert, die zur Planung der schrittweisen Migrationen verwendet werden können.

Neue Abschnitte in exception_report

Während der schrittweisen Migration für große Unternehmen wird es einige neue Abschnitte in exception_report.txt geben, wenn Standortabhängigkeiten nicht erfüllt werden.

Beispiel: Der folgende neue Abschnitt ist für die Agenten der Sammelanschlussgruppe auto_mig_ent_grp2 von Sarah Rodriguez an Standort auto_mig_ent_grp3 vorgesehen, die in dieser Phase nicht migriert und nicht migriert werden.

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 

Im folgenden neuen Abschnitt wird empfohlen, wie die Standorte in den Migrationsphasen gruppiert werden.

Empfohlene Standorte zum gleichzeitigen Verschieben:

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 Option „Standorte“ beim Ausführen des Transformationstools nicht vorhanden ist, enthält der Abschnitt „Empfohlene Standorte“ zum gleichzeitigen Verschieben alle Standortabhängigkeiten, um die Planung zu erleichtern.

Wenn Sie das Transformationstool mit der Standortoption ausführen (d. h. für eine Migrationsphase), werden im Abschnitt „Empfohlene Standorte“ zum gleichzeitigen Verschieben nur die Abhängigkeiten der Standorte für die aktuelle Phase aufgeführt.

Bereitstellungstool

In großen Unternehmen kann das Bereitstellungstool wie üblich ausgeführt werden.

Geräteverschiebungswerkzeug

Das Tool zum Verschieben von Geräten kann für eine Teilmenge von Standorten von customer.json.ausgeführt werden, um eine neue optionale Datei locations.csv mit zwei Spalten hinzuzufügen.

External_id

Standortnamen

Externer ID-Wert

Namen der Standorte/Gruppennamen

  • Dies ist eine optionale Datei. Wenn sie nicht angegeben oder mit leeren Werten versehen wird, werden alle Standorte migriert.
  • Wenn die Standortnamen und die entsprechenden 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:

„Zeitzonen“:["Amerika/Adak","Amerika/Anchorage","Amerika/Chicago","Amerika/Denver","Amerika/Los_Angeles","Amerika/New_York","Amerika/Phoenix","Pazifik/Honolulu"]

Kanada:

„Zeitzonen“:["Amerika/Dawson_Creek","Amerika/Edmonton","Amerika/Halifax","Amerika/Montreal","Amerika/Regina","Amerika/St_Johns","Amerika/Vancouver","Amerika/Winnipeg"]

Australien:

„Zeitzonen“:["Australien/Adelaide","Australien/Brisbane","Australien/Broken_Hill","Australien/Darwin","Australien/Hobart","Australien/Lord_Howe","Australien/Perth","Australien/Australien/Sydney"]

Frankreich:

"Zeitzonen":["Europa/Paris"]

Portugal:

"Zeitzonen":["Atlantik/Azoren","Europa/Lissabon"]}

GB:

"Zeitzonen":["Europa/London"]

Italien:

"Zeitzonen":["Europa/Rom"]