- Strona główna
- /
- Artykuł
Narzędzia migracyjne do przejścia na rozwiązania RTM hurtowe
Przeprowadź migrację przy minimalnej konfiguracji wstępnej. Ułatwia uruchamianie poleceń. Administratorzy mogą przeglądać swoje dane po ich udostępnieniu oraz wykonywać i odbierać połączenia bezpośrednio po migracji. Obsługuje automatyczną aktualizację do aplikacji Webex dla klientów UC-One.
Omówienie
Celem tego dokumentu jest dostarczenie szczegółowych instrukcji dotyczących korzystania z narzędzi umożliwiających migrację z rozwiązań Cisco BroadWorks, Webex for BroadWorks i BroadCloud do rozwiązań Wholesale i Webex Calling. W tym dokumencie opisano zestaw narzędzi migracyjnych, które mają pomóc w migracji obecnych klientów rozwiązań Cisco BroadWorks, Webex for BroadWorks i BroadCloud do rozwiązania Wholesale Route-to-Market.
Narzędzia migracyjne mają na celu ułatwienie całkowitego przejścia z usług BroadWorks do usług hurtowych. Nie są one przeznaczone do długoterminowego współistnienia obu usług w ramach tej samej organizacji klienta.
Wpływ migracji
Skutki migracji są następujące:
Administratorzy
Po migracji administratorzy muszą:
- Zacznij konfigurować funkcje za pomocą Partner Hub i Control Hub zamiast CommPilot.
- Skonfiguruj ponownie wszystkie funkcje, które nie są częścią migracji.
Należy ręcznie przenieść funkcje, które nie zostaną przeniesione automatycznie po zakończeniu działania narzędzi migracji.
Użytkownicy
Obsługiwane funkcje powinny działać tak samo po migracji, jak działały przed nią. Funkcje usługi Webex Calling, które nie są obsługiwane przez migrację, muszą zostać ponownie skonfigurowane w usłudze Webex po migracji:
- Użytkownicy utracą historię połączeń i wiadomości.
- Użytkownicy utracą wszystkie osobiste ustawienia klawiszy i personalizacje i będą musieli ponownie skonfigurować te ustawienia po migracji. Przykładami są szybkie wybieranie.
- Przy pierwszym logowaniu użytkownicy muszą zresetować swoje kody dostępu i hasła.
- Użytkownicy korzystający z klienta UC-One muszą przy pierwszym logowaniu dokonać aktualizacji do aplikacji Webex.
Architektura narzędzi migracyjnych
Architektura narzędzi migracyjnych składa się z czterech różnych narzędzi:
- Narzędzie do ekstrakcji— wyodrębnia przedsiębiorstwa, grupy, numery, użytkowników, usługi, telefony i klientów programowych z Cisco BroadWorks. Partnerzy BroadCloud muszą złożyć wniosek o wyciąg w Portalu Dostawców Usług.
- Narzędzie transformacji— transformuje informacje wyodrębnione przez narzędzie ekstrakcji do pliku JSON, który można edytować.
- Narzędzie do obsługi klienta— używa pliku wyjściowego JSON z narzędzia Transform Tool do obsługi klienta, lokalizacji, numerów, użytkowników, usług i telefonów przy użyciu publicznych interfejsów API Webex.
- Narzędzie do przenoszenia urządzeń— używa pliku wyjściowego JSON narzędzia Transform Tool do ponownego tworzenia profili i ponownego uruchamiania telefonów, aktywowania numerów w rozwiązaniu Wholesale RTM i dezaktywowania numerów telefonów w programie Cisco BroadWorks.
- To narzędzie umożliwia przywracanie profili klientów telefonicznych i programowych oraz aktywację numerów w Cisco BroadWorks.
- Partnerzy BroadCloud muszą złożyć wniosek o migrację w Portalu Dostawców Usług.
Poniższa ilustracja ilustruje sposób działania czterech narzędzi sekwencyjnie, komunikując się z Cisco BroadWorks, publicznymi interfejsami API i przesyłając metryki do usług Webex w celu przeprowadzenia przyszłej analizy po uruchomieniu zadań migracji przez administratora.

Ryc. 1: Narzędzia migracyjne
Wymagania
Przed uruchomieniem narzędzi migracji partner musi spełnić następujące wymagania:
- Konto partnera i administratora partnera musi być zintegrowane z rozwiązaniem Wholesale RTM. Na etapie przedsprzedaży partnerzy nie muszą być przyłączeni do rozwiązania Wholesale RTM w celu uruchomienia narzędzia do ekstrakcji.
- Partner musi zapoznać się z listą kontrolną przed migracją, aby upewnić się, że wszystkie wymagania zostały spełnione.
- Do uruchomienia narzędzi do wyodrębniania i przenoszenia urządzeń wymagane są uprawnienia administratora systemu Cisco BroadWorks. Nie dotyczy to partnerów BroadCloud.
- Narzędzia do wyodrębniania i przenoszenia urządzeń muszą być uruchamiane z zapasowego serwera aplikacji Cisco BroadWorks podczas okna konserwacyjnego, aby zminimalizować ryzyko. Partnerzy BroadCloud będą uruchamiać narzędzie Device Move Tool z poziomu Portalu Dostawcy Usług.
- Przejrzyj listę obsługiwanych urządzeń Webex Calling.
- Przejrzyj listę nieobsługiwanych urządzeń do połączeń Webex.
- Partnerzy muszą zwrócić się do swojego zespołu ds. obsługi kont w Cisco, aby uzyskać informacje na temat obsługiwanej wersji oprogramowania sprzętowego dla telefonów i urządzeń.
- Klienci UC-One muszą dokonać aktualizacji do następujących wersji:
- Klienci Desktop Communicator muszą mieć wersję 22.9.12 lub nowszą
- Klienci Mobile Connect muszą mieć wersję 3.9.14 lub nowszą.
- Komputer administratora musi posiadać:
- JDK/JRE Do działania narzędzia do obsługi administracyjnej wymagana jest wersja 1.8.
- Na komputerach MAC i Linux wymagany jest Python 3.10.5 lub nowszy do działania narzędzia Transform Tool.
- Klienci muszą posiadać ważny adres rozliczeniowy, a użytkownicy końcowi muszą mieć firmowy adres e-mail skonfigurowany w Cisco BroadWorks. Jeśli wartości nie zostaną ustawione, administratorzy partnerów muszą skontaktować się ze swoimi klientami, aby je uzyskać. Dane te muszą zostać dodane do plików CSV (wartości rozdzielone przecinkami) przed uruchomieniem narzędzia transformacji. Przykładowe pliki CSV są dostępne w narzędziu do transformacji.
Plan migracji
Plan migracji składa się z 3 etapów:
- Przygotowanie
- Uzyskaj kopię danych użytkownika za pomocą narzędzia Extract Tool
- Wygeneruj token za pomocą narzędzia Token Generator Tool
- Użyj narzędzia Transform, aby sformatować dane użytkownika
- Obsługa administracyjna
- Pobierz najnowsze dane użytkownika za pomocą narzędzia Extract Tool
- Użyj narzędzia Transform, aby sformatować dane użytkownika
- Zaopatrz użytkowników w narzędzie do obsługi administracyjnej
- Migracja
- Migruj urządzenia za pomocą narzędzia Device Move Tool
- Migracje bez urządzeń [ Aktywacja numerów telefonów za pomocą Control Hub ]
Jeśli administratorzy partnerów nie mają urządzeń do przeniesienia z Cisco BroadWorks do Wholesale, uruchomienie narzędzia do przenoszenia urządzeń nie jest konieczne. Administratorzy partnerów mogą użyć publicznego łącza poniżej, aby aktywować numery telefonów bezpośrednio w portalu Control Hub. Aby uzyskać więcej informacji, zobacz Zarządzaj numerami telefonów w Control Hub .
Dezaktywacja numerów telefonów w Cisco BroadWorks jest opcjonalna, jeśli administratorzy partnerów aktywują swoje numery telefonów za pośrednictwem Control Hub.
Funkcje automatycznie migrowane do połączeń hurtowych
Następujące funkcje użytkownika są automatycznie migrowane przez narzędzia migracji:
- Ustawienia wiadomości głosowych i niestandardowych powitań (wiadomości głosowe, spersonalizowane nazwy dźwiękowe i kody PIN użytkowników nie są migrowane)
- Numery dodatkowe
- BroadWorks Anywhere
- Zajęte pole lamp
- Identyfikator dzwoniącego (niestandardowa nazwa i numer telefonu)
- Połączenie oczekujące
- Ustawienia przekierowania połączeń (przekierowanie połączeń) always/busy/no answer/not osiągalny)
- Przechwytywanie połączeń
- Nie przeszkadzać
- Ustawienia faksu
- Biuro zdalne
- Udostępnij prezentację połączenia
- Jednoczesny dzwonek osobisty (w tym harmonogram i kryteria selektywne)
- Powiadomienie o połączeniu (w tym harmonogram i kryteria wyboru)
- Odrzucanie połączeń anonimowych
- Selektywne odrzucanie połączeń
- Selektywne przekierowywanie połączeń
- Kierowane odbieranie połączeń i wtrącanie się
- Zwolnienie z obowiązku wtargnięcia
- Naciśnij, aby mówić
- Prywatność
- Muzyka podczas wstrzymania
- Obsługa dni wolnych
- Obsługa nocna
Następujące funkcje grupy są automatycznie migrowane przez narzędzia migracji:
- Automatyczny operator
- Tylko jeden poziom
- Spersonalizowane pozdrowienia
- Ustawienia przekierowania połączeń (zawsze, zajęte, selektywne)
- Numery dodatkowe
- Menu świąteczne nie jest dostępne w Webex
- Selektywne odrzucanie połączeń
- Kolejka połączeń Cisco BroadWorks Call Center Standard i BroadCloud:
- Podstawowa konfiguracja
- Spersonalizowane pozdrowienia
- Agenci i kierownicy
- Ustawienia przekierowania połączeń (zawsze, zajęte, selektywne)
- Numery dodatkowe
- Muzyka w oczekiwaniu
- Parkowanie połączeń
- Odbiór połączenia
- Grupa poszukiwania
- Ustawienia przekierowywania połączeń (zawsze, zajęty, selektywny, niedostępny)
- Numery dodatkowe
- Kod lokalizacji (jeden na lokalizację lub grupę)
- Grupa przywoławcza
- Harmonogramy (tylko na poziomie grupy, harmonogramy przedsiębiorstw nie są migrowane)
- Portal głosowy
- Muzyka w oczekiwaniu
- Wspólna lista telefonów
Obsługiwane urządzenia
Obsługiwane telefony zostaną automatycznie utworzone i przypisane użytkownikom w usłudze Webex Calling przez narzędzie provisioningowe. Telefony oznaczone jako „tak” w kolumnie „Obsługiwane w narzędziu do przenoszenia urządzeń” zostaną również automatycznie przeniesione z Cisco BroadWorks lub BroadCloud do Webex Calling po uruchomieniu narzędzia do przenoszenia urządzeń. W przypadku telefonów oznaczonych w tej kolumnie słowem „Nie” konieczna jest ręczna interwencja w celu zmiany adresu URL DMS w szablonie urządzenia Cisco BroadWorks lub w samym telefonie.
Ostatnia kolumna zawiera mapowanie modeli telefonów do kolumny „Typ urządzenia” w pliku transform-tool/input/newphones.csv. (Więcej informacji na temat pliku newphones.csv można znaleźć w sekcji Narzędzie transformacji tego artykułu).
Model telefonu |
Obsługiwane w narzędziu do przenoszenia urządzenia |
Typ urządzenia w pliku newphones.csv |
---|---|---|
Cisco MPP 6821 |
Tak |
System zarządzania Cisco 6821 |
Cisco MPP 6841 |
Tak |
System zarządzania Cisco 6841 |
Cisco MPP 6851 |
Tak |
System zarządzania Cisco 6851 |
Cisco MPP 6861 |
Tak |
System zarządzania Cisco 6861 |
Cisco MPP 6871 |
Tak |
System zarządzania Cisco 6871 |
Cisco MPP 7811 |
Tak |
System zarządzania Cisco 7811 |
Cisco MPP 7821 |
Tak |
System zarządzania Cisco 7821 |
Cisco MPP 7832 |
Tak |
System zarządzania Cisco 7832 |
Cisco MPP 7841 |
Tak |
System zarządzania Cisco 7841 |
Cisco MPP 7861 |
Tak |
System zarządzania Cisco 7861 |
Cisco MPP 8811 |
Tak |
System zarządzania Cisco 8811 |
Cisco MPP 8832 |
Tak |
System zarządzania Cisco 8832 |
Cisco MPP 8841 |
Tak |
System zarządzania Cisco 8841 |
Cisco MPP 8845 |
Tak |
System zarządzania Cisco 8845 |
Cisco MPP 8851 |
Tak |
System zarządzania Cisco 8851 |
Cisco MPP 8861 |
Tak |
System zarządzania Cisco 8861 |
Cisco MPP 8865 |
Tak |
System zarządzania Cisco 8865 |
Cisco MPP 8875 |
Tak |
System zarządzania Cisco 8875 |
Cisco ATA191 |
Tak |
System zarządzania Cisco 191 |
Cisco ATA192 |
Tak |
System zarządzania Cisco 192 |
Cisco DBS 110 |
Tak |
System zarządzania zasobami ludzkimi Cisco DBS110 |
Policom VVX101 |
Tak |
DMS-Polycom VVX101 |
Policom VVX150 |
Tak |
DMS-Polycom VVX150 |
Policom VVX201 |
Tak |
DMS-Polycom VVX201 |
Policom VVX250 |
Tak |
DMS-Polycom VVX250 |
Policom VVX301 |
Tak |
DMS-Polycom VVX301 |
Policom VVX311 |
Tak |
DMS-Polycom VVX311 |
Policom VVX350 |
Tak |
DMS-Polycom VVX350 |
Policom VVX401 |
Tak |
DMS-Polycom VVX401 |
Policom VVX411 |
Tak |
DMS-Polycom VVX411 |
Policom VVX450 |
Tak |
DMS-Polycom VVX450 |
Policom VVX501 |
Tak |
DMS-Polycom VVX501 |
Policom VVX601 |
Tak |
DMS-Polycom VVX601 |
Polycom Trio 8300 |
Tak |
DMS-Polycom Trio8300 |
Polycom Trio 8500 |
Tak |
System zarządzania danymi Polycom Trio8500 |
Polycom Trio 8800 |
Tak |
DMS-Polycom Trio8800 |
Stacja dźwiękowa Polycom 5000 |
Tak |
System zarządzania danymi Polycom SSIP5000 |
Stacja dźwiękowa Polycom 6000 |
Tak |
System zarządzania danymi Polycom SSIP6000 |
Yealink T33G |
Tak |
DMS Yealink T33G |
Yealink T41S |
Tak |
DMS Yealink T41S |
Yealink T42S |
Tak |
DMS Yealink T42S |
Yealink T43U |
Tak |
DMS Yealink T43U |
Yealink T46U |
Tak |
DMS Yealink T46U |
Yealink T46S |
Tak |
DMS Yealink T46S |
Yealink T48S |
Tak |
DMS Yealink T48S |
Yealink T48U |
Tak |
DMS Yealink T48U |
Yealink T53W |
Tak |
DMS Yealink T53W |
Yealink T54W |
Tak |
DMS Yealink T54W |
Yealink T57W |
Tak |
DMS Yealink T57W |
Yealink T58V |
Tak |
DMS Yealink T58V |
Yealink CP920 |
Tak |
DMS Yealink CP920 |
Yealink CP960 |
Tak |
DMS Yealink CP960 |
Yealink W52B |
Tak |
DMS Yealink W52P |
Yealink W56B |
Tak |
DMS Yealink W56P |
Yealink W60B |
Tak |
DMS Yealink W60P |
Yealink W70B |
Tak |
DMS Yealink W70P |
Yealink CP925 |
Tak |
DMS Yealink CP925 |
Yealink CP965 |
Tak |
DMS Yealink CP965 |
Urządzenia nieobsługiwane
Jeśli klient korzysta z urządzeń nieobsługiwanych przez rozwiązanie Wholesale RTM, to urządzenia te nie kwalifikują się do migracji. W tym przypadku masz następujące możliwości:
- Przed migracją zainstaluj nowe telefony w systemie Cisco BroadWorks.
- Pozostaw stare telefony w Cisco BroadWorks, a użytkownicy będą musieli zainstalować aplikację Webex, aby wykonywać i odbierać połączenia.
Pakiety połączeń hurtowych
Narzędzia migracji oferują zestaw domyślnych ustawień umożliwiających wybór pakietów połączeń hurtowych dla abonentów. Jeśli później zajdzie potrzeba użycia innego pakietu, administrator partnera może dokonać zmiany w Control Hub.
Konfiguracja pakietu migracji Cisco BroadWorks
Wszyscy abonenci, którzy dokonają migracji z Cisco BroadWorks, domyślnie będą korzystać z pakietu Webex Calling. Jeśli pakiet Webex Voice jest potrzebny abonentom, którzy nie mają przypisanej funkcji połączeń oczekujących lub poczty głosowej, można włączyć tę opcję w pliku partner.cfg narzędzia Transform Tool, usuwając komentarz z wiersza USE_WEBEX_VOICE_PACKAGE.
Mapowanie pakietu migracji Webex dla BroadWorks
Pakiety Webex for BroadWorks są automatycznie mapowane na pakiety połączeń hurtowych. Tego nie można konfigurować.
Pakiet Webex dla BroadWorks |
Pakiet połączeń hurtowych |
---|---|
Program telefoniczny |
Webex Voice |
Podstawowa |
Webex Calling |
Standardowy |
Webex Suite |
Premium |
Webex Suite |
Mapowanie pakietów migracji BroadCloud
Migracje z pakietów map BroadCloud Carrier na podstawie typu stacji. Domyślne mapowanie można skonfigurować w pliku konfiguracyjnym narzędzia Transform Tool: conf/rialto_station_type_to_wholesale_package.csv.
Typ stacji BroadCloud Carrier |
Pakiet połączeń hurtowych |
---|---|
Podstawowa |
Webex Voice |
Sala konferencyjna |
Webex Voice |
Wiadomości |
Webex Voice |
Standardowy |
Webex Voice |
Dyrektor wykonawczy |
Webex Suite |
Wszystkie inne typy stacji |
Webex Voice |
Przekształć konto użytkownika BroadWorks lub BroadCloud w obszar roboczy usługi Webex Calling
Przestrzeń robocza Webex to telefon, z którego korzysta wiele osób, na przykład: Na przykład: telefony w sali konferencyjnej, magazynie lub holu. Takie telefony można skonfigurować w usłudze Webex Calling jako obszary robocze Webex, a nie jako użytkowników Webex. Dostępna jest opcja umożliwiająca automatyczną transformację kont użytkowników z Cisco BroadWorks lub BroadCloud Carrier w obszary robocze podczas procesu migracji.
Kroki:
- W pliku transform_tool/input/users.csv, przypisz pakiet „common_area” użytkownikom, którzy mają zostać przekształceni w Obszar roboczy.
- Przykład: bwuser@domain,,,common_area
- (Tylko BroadCloud) Aby przekonwertować wszystkie konta użytkowników określonego typu stacji na obszary robocze, dodaj wpis do transform-tool/conf/rialto_station_type_to_wholesale_package.csv i ustaw pakiet hurtowy na „common_area_calling”.
- Przykład: conference_room_v2,common_area_calling
- Uruchom narzędzie transformacji.
- Uruchom narzędzie do obsługi administracyjnej.
- Otwórz Control Hub nowo utworzonej organizacji klienta i ustaw domenę SIP (patrz rysunek 2, Konfigurowanie domeny SIP w Control Hub).
- Uruchom ponownie narzędzie do obsługi administracyjnej. Tworzy obszary robocze i przypisuje do nich telefony.
Ograniczenia:
Konfiguracja funkcji użytkownika (na przykład przekierowywanie połączeń, funkcja „nie przeszkadzać”) nie jest automatycznie przenoszona do obszaru roboczego.

Ryc. 2: Konfigurowanie domeny SIP w Control Hub
Narzędzie do generowania tokenów
Administratorzy partnerów uruchamiają to narzędzie do generowania tokenów co najmniej raz przed rozpoczęciem uruchamiania narzędzi migracyjnych. Uruchomienie tego narzędzia jest czynnością jednorazową po dołączeniu konta partnera do rozwiązania Wholesale RTM. To narzędzie umożliwia administratorom partnerów logowanie się za pośrednictwem przeglądarki internetowej w celu uzyskania unikalnego TOKENU niezbędnego do aktualizacji plików konfiguracyjnych partnerów dla narzędzi migracji.
Wymagania wstępne
Zainstaluj Javę 8, 11, 17 lub 21 na komputerze. Java jest dostępna z wielu źródeł, w tym:
- https://learn.microsoft.com/en-us/java/openjdk/download
- https://aws.amazon.com/corretto/
- https://www.oracle.com/java/technologies/downloads/#java21
Po pobraniu rozpakuj pliki binarne narzędzia migracji.
Ten krok jest opcjonalny
Instrukcje uruchomienia
Uruchom następujące polecenie w terminalu w katalogu generatora tokenów:
-
Aby uruchomić narzędzie do generowania tokenów, muszą być dostępne następujące porty. Porty: 8080, 50009, 50010, 50011, 50012 i 50013
-
Przynajmniej jeden z wymienionych portów musi być otwarty na komputerze użytkownika, aby umożliwić nawiązanie połączenia.
Windows:
token_generator.bat
MacOS:
./token_generator.sh
Wyjście:
Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080
Otwórz adres URL w przeglądarce internetowej w terminalu, zaloguj się przy użyciu danych logowania administratora partnera, aby uzyskać TOKEN, i skopiuj go w celu dalszego wykorzystania.
Poniżej podano ilustracje interfejsu użytkownika, w celach informacyjnych:
Ryc. 3: Zaloguj się za pomocą Cisco Webex
Ryc. 4: Okno poświadczeń
Ryc. 5: Generowanie tokenów
Zadania konfiguracji programu BroadWorks
Przed uruchomieniem narzędzi do wyodrębniania i przenoszenia urządzeń na serwerze pomocniczym BroadWorks należy skonfigurować następujące kroki.
Włącz łączność OCI-P
Narzędzie do przenoszenia urządzeń komunikuje się z systemem BroadWorks za pomocą poleceń OCI-P. Aby włączyć łączność OCI-P, należy wykonać poniższe kroki:
Krok 1: Użyj interfejsu CLI do skonfigurowania ustawień ogólnych.
Uruchom następujące polecenie w CLI, aby przejść do katalogu GeneralSettings:
AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.
Uruchom następujące polecenie w CLI, aby uzyskać bieżące ustawienia ogólne (GeneralSettings):
AS_CLI/Applications/OpenClientServer/GeneralSettings> get
clientPort = 2208
clientPortEnabled = true
secureClientPort = 2209
secureClientPortEnabled = true
systemDomain = <>
Jeżeli Twoje ustawienia nie zgadzają się z powyższymi, użyj polecenia set w celu ponownego skonfigurowania ustawień.
Krok 2: Użyj interfejsu CLI do skonfigurowania serwera proxy OCI.
Zmień katalog na OCI Proxy:
AS_CLI> cd /Applications/OpenClientServer/OCIProxy
Uruchom następujący interfejs CLI, aby uzyskać bieżące ustawienia. Powinieneś zobaczyć następujące informacje:
AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800
Jeżeli Twoje ustawienia nie zgadzają się z powyższymi, użyj polecenia set w celu ponownego skonfigurowania ustawień.
Krok 3: Użyj interfejsu CLI do skonfigurowania obsługi OCI.
Przejdź do katalogu Provisioning:
AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning
Uruchom następujące polecenie, aby uzyskać bieżące ustawienia OCI Provisioning:
AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as
Krok 4: Uruchom poniższe polecenie w interfejsie CLI, aby sprawdzić, czy konfiguracja jest prawidłowa.
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.
Sprawdź, czy otwarty serwer kliencki jest wdrożony i aktywny
Użyj poniższych poleceń, aby wdrożyć i uruchomić serwer Open Client Server na dodatkowym serwerze aplikacji, jeśli nie został on wdrożony lub nie został jeszcze uruchomiony.
Krok 1: Wdróż serwer za pomocą następującego polecenia CLI:
AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer
Krok 2: Uruchom serwer za pomocą tego polecenia:
AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer
Włącz aktywację numerów
Aby umożliwić aktywację numerów, wykonaj następujące polecenia w CLI:
Krok 1: Uruchom polecenie aktywacji numeru:
AS_CLI> cd SubscriberMgmt/NumberActivation
Krok 2: Uruchom polecenie aktywacji włączonej:
AS_CLI> set dnMode groupAndUserActivationEnabled
Krok 3: W monicie potwierdzającym wpisz Y.
Narzędzie do ekstrakcji
Dla BroadCloud
Narzędzie do wyodrębniania danych jest zintegrowane z portalem dostawcy usług BroadCloud. Administrator dostawcy usług może:
- Możesz wysłać żądanie wyciągu dla maksymalnie 50 klientów na jedno żądanie.Żądania wyciągu nie można wysłać dla tego samego klienta więcej niż 10 razy dziennie.
- Możesz pobrać wyodrębniony plik danych w formacie ZIP i przechowywać go do 28 dni od daty złożenia wniosku.
Poniższe rysunki przedstawiają portal Dostawcy Usług.

Rysunek 6: Portal Dostawcy Usług

Rysunek 7: Portal Dostawcy Usług
Żądanie ekstraktu CSV
Zainicjuj żądanie wyodrębnienia pliku CSV
-
Pobierz plik CSV klienta
Kliknij łącze Pobierz plik CSV klienta w prawym górnym rogu sekcji Rozpocznij żądanie wyodrębnienia pliku CSV.
-
Edytuj listę klientów
Administrator może edytować plik CSV, aby uwzględnić tylko tych klientów, dla których ma zostać przeprowadzona ekstrakcja.
-
Prześlij i wyślij
Po zakończeniu edycji prześlij zmodyfikowany plik CSV.
Kliknij Prześlij, aby zainicjować żądanie utworzenia wyciągu dla wymienionych klientów i ich powiązanych lokalizacji.
Zainicjuj żądanie ekstraktu dla klienta z lokalizacjami w pliku CSV
-
Wybierz lokalizację klienta i pobierania
Wybierz klienta z listy rozwijanej.
Pobierz odpowiedni plik locations.csv z Wyświetl klientów→ zakładka Lokalizacje → Eksportuj lokalizacje jako plik CSV.
-
Edytuj plik lokalizacji
Administrator może edytować plik CSV, aby uwzględnić tylko te lokalizacje, które chce wyodrębnić.
-
Prześlij i wyślij
Prześlij edytowany plik locations.csv i kliknij Prześlij.
We wniosku o wyciąg zostaną uwzględnione tylko wskazane lokalizacje dla wybranego klienta.
Zainicjuj żądanie wyciągu dla wszystkich klientów
- Kliknij Prześlij, aby zainicjować żądanie wyciągu dla wszystkich klientów i wszystkich ich lokalizacji w ramach bieżącego dostawcy usług.

Dla Cisco BroadWorks i Webex dla BroadWorks
- Narzędzie do wyodrębniania danych działa na dodatkowym serwerze aplikacji Cisco BroadWorks w sieci partnerskiej i łączy się za pomocą protokołu OCI-P.
- Narzędzie pobiera surowe dane dotyczące przedsiębiorstwa, grup, numerów, użytkowników, usług, urządzeń i klientów programowych z platformy Cisco BroadWorks lub BroadCloud i zapisuje te dane w plikach XML, które stanowią dane wejściowe dla narzędzia transformacji.
W poniższych sekcjach wyjaśniono, jak zainstalować i skonfigurować narzędzie do wyodrębniania.
Wymagania wstępne
- Prześlij pliki binarne narzędzia do wyodrębniania za pomocą protokołu SCP na pomocniczy serwer aplikacji Cisco BroadWorks.
- Nawiąż połączenie SSH z pomocniczym serwerem aplikacji Cisco BroadWorks, aby skonfigurować wymagania wstępne i uruchomić narzędzie do wyodrębniania.
- Skonfiguruj dostawcę usług i identyfikator grupy, aby wyodrębnić je z Cisco BroadWorks w conf/exportTool.yml. Zobacz poniższy przykładowy fragment kodu YAML:
ServiceProviderID-A: - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B: - ALL
- Upewnij się, że dodatkowy identyfikator użytkownika, hasło i nazwa hosta serwera aplikacji Cisco BroadWorks są poprawne. conf/partner.cfg plik:
BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
Właściwość
REFRESH_TOKEN
jest obowiązkowa w przypadku migracji Webex for BroadWorks. - Modyfikuj JDK/JRE ścieżka środowiska w pliku export.sh, jeśli pomocniczy serwer aplikacji Cisco BroadWorks JDK/JRE ścieżka środowiska jest inna niż ścieżka pliku:
JAVA_HOME=/usr/local/java/java_base
Instrukcje uruchomienia
Uruchom następujące polecenie na serwerze aplikacji Cisco BroadWorks z katalogu narzędzia do wyodrębniania:
./export.sh
Dzienniki terminala
Po pomyślnym eksporcie w terminalu dostępne są następujące logi: Uruchamianie narzędzia BroadSoft Data Export Tool:
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
**************************************************
Wyjście
Plik wyjściowy ZIP (extracted_data_<timestamp>.zip) jest dostępny w tym samym katalogu narzędzia do rozpakowywania. Użyj następującego polecenia, aby wyświetlić i wykorzystać plik ZIP dla danych wejściowych narzędzia Transform Tool:
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
Narzędzie transformacji
To narzędzie transformacyjne działa dla wszystkich migracji. Narzędzie transformacyjne działa na dowolnym komputerze, w tym na laptopie administratora partnera, i wykorzystuje publiczne interfejsy API Webex. Odczytuje plik wyjściowy ZIP (extracted_data_<timestamp>.zip) narzędzia do ekstrakcji jako dane wejściowe i przekształca surowy plik XML do formatu JSON, który jest używany przez narzędzie do obsługi administracyjnej.
Wymagania wstępne
Po pobraniu i rozpakowaniu plików binarnych narzędzi migracji skonfiguruj następujące wymagania wstępne:
- Ustaw REFRESH_TOKEN (Token skopiowany z narzędzia do generowania tokenów) i NAZWĘ__LOKALIZACJI GŁÓWNEJ_w conf/partner.cfg plik:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main
- Opcjonalnie ustaw identyfikator PROVISIONING_(skopiowany z szablonu w Partner Hub) w conf/partner.cfg plik:
PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1
Aby uzyskać pełniejszą weryfikację adresu e-mail klienta, możesz opcjonalnie ustawić IDENTYFIKATOR PROVISIONING_. - Skonfiguruj brakujące informacje w input/customers.csv plik (patrz następna sekcja), jeśli go brakuje.
- Dodaj adres e-mail użytkownika końcowego w polu input/users.csv plik.
- Jeśli mają zostać dostarczone nowe telefony, należy dodać adres MAC i adres e-mail nowego telefonu użytkownika. input/newphones.csv plik. Jest to wymagane tylko w przypadku, gdy administratorzy partnerów chcą udostępnić nowe telefony w ramach połączeń hurtowych.
- Przekształć centra telefoniczne BroadWorks w CxEssentials przy użyciu input/cxessentials.csv plik.
- Opcjonalnie włącz właściwość UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, aby przekonwertować wszystkie centra telefoniczne na CxEssentials.
- Użyj input/locations.csv plik do obsługi dużych migracji przedsiębiorstw, który umożliwia administratorom migrację lokalizacji klientów według lokalizacji
- Opcjonalnie włącz używanie adresów MAC z nagłówka User-Agent komunikatu SIP REGISTER, gdy adres MAC nie jest dostępny w profilu urządzenia Cisco BroadWorks. Usuń komentarz z wiersza „USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" gęsiego conf/partner.cfg
- Funkcja synchronizacji serwera sieciowego umożliwia administratorom dostarczanie numerów telefonów, adresów MAC i adresów e-mail użytkowników podczas migracji w ramach tego samego regionu. Aby włączyć tę opcję, należy ustawić
USE_NS_SYNC=yes
wconf/partner.cfg
.Jeśli synchronizacja NS jest wyłączona, podawanie numerów telefonów i urządzeń zostanie pominięte, a użytkownicy otrzymają tymczasowe adresy e-mail.
- Opcjonalnie włącz właściwości ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD i ANALOG_USER_TYPE_DISABLE_T38, aby skonfigurować oczekiwanie na połączenie, muzykę podczas oczekiwania i wyłączyć ustawienia T38 dla wszystkich użytkowników typu analogowego.
Uzupełnianie input/customers.csv
Plik input/customers.csv udostępnia dane, których może brakować w Cisco BroadWorks lub BroadCloud. Ten plik może pozostać pusty, jeśli wszystkie obowiązkowe informacje są już dostępne. Nie musisz wypełniać wszystkich kolumn, obowiązkowe jest podanie tylko brakujących informacji.
Poniższa tabela wyjaśnia najważniejsze kolumny w input/customers.csv.
Nazwa kolumny |
Reguły |
---|---|
Identyfikator |
W trybie korporacyjnym Cisco BroadWorks:
W trybie dostawcy usługi BroadWorks jest to identyfikator grupy Cisco BroadWorks. W BroadCloud jest to Rialto customerId. |
externalId |
Jest to identyfikator odpowiadający wewnętrznemu identyfikatorowi partnera dla tego klienta. Ta kolumna musi być unikatowa w ramach organizacji partnerskiej Webex. Ta kolumna jest opcjonalna, narzędzie transformacji automatycznie wygeneruje unikalny identyfikator. Kolumna ta nie jest używana w przypadku grup w ramach przedsiębiorstwa. |
NazwaKlienta |
W przypadku przedsiębiorstw kolumna ta jest używana jako pole nazwy klienta Webex. W przypadku grupy w ramach przedsiębiorstwa kolumna ta jest używana jako nazwa lokalizacji. Nazwy lokalizacji muszą być unikalne w obrębie przedsiębiorstwa. |
podstawowyE-mail |
Jest on używany jako adres e-mail administratora klienta Webex. Ta kolumna jest opcjonalna dla grup w ramach przedsiębiorstwa. |
Kolumny adresowe |
W przypadku przedsiębiorstwa adres ten jest używany jako adres rozliczeniowy i adres pierwszej lokalizacji. W przypadku grupy w ramach przedsiębiorstwa adres ten jest używany jako adres lokalizacji. |
strefa czasowa |
Zapoznaj się z sekcją tego artykułu dotyczącą stref czasowych. |
język | Zobacz Języki obsługiwane przez Webex. |
domyślna poczta głosowapin |
Zobacz Ustaw kod PIN poczty głosowej. |
Uzupełnianie input/users.csv
Plik input/users.csv udostępnia dane, których może brakować w Cisco BroadWorks lub BroadCloud. Ten plik może pozostać pusty, jeśli wszystkie obowiązkowe informacje są już dostępne. Nie musisz wypełniać wszystkich kolumn, obowiązkowe jest podanie tylko brakujących informacji.
Wszystkie te pola są opcjonalne.
Nazwa kolumny |
Reguły |
---|---|
identyfikator użytkownika |
Unikalny identyfikator użytkownika. Może to być identyfikator użytkownika BroadWorks lub BroadCloud. |
| (Opcjonalnie) Adres e-mail użytkownika. Jeśli zostanie podany, zostanie wykorzystany w celach aprowizacyjnych. |
numer telefonu |
(Opcjonalnie) Numer telefonu użytkownika, który ma zostać udostępniony. |
pakiet |
(Opcjonalnie) Typ pakietu użytkownika. Dozwolone wartości: głos, powołanie, apartament, common_area, virtual_line, dont_migrate, lub call_park_ext. Wartość dont_migrate jest używana, gdy partnerzy chcą wykluczyć określonych użytkowników (wraz z ich urządzeniami i numerami telefonów) zarówno z procesu provisioningu, jak i migracji. Jest to obsługiwane zarówno przez BroadWorks, jak i BroadCloud. Po zastosowaniu tej opcji wybrani użytkownicy i powiązane z nimi zasoby nie zostaną przeniesione ani udostępnione. Aby z tego skorzystać, administratorzy powinni wpisać dont_migrate w kolumnie pakietu w pliku users.csv. |
Numer wewnętrzny |
(Opcjonalnie) Numer wewnętrzny telefonu, który ma zostać przypisany użytkownikowi. |
nazwa |
(Opcjonalnie) Pełna nazwa użytkownika. |
ata_settings |
(Opcjonalnie) Dozwolone wartości: t38, analog Do enable/disable połączenia oczekujące, muzyka w oczekiwaniu na połączenie i ustawienia T38 T38: Opcja ta wyłącza oczekiwanie na połączenie i muzykę podczas oczekiwania oraz włącza ustawienia T38 dla urządzeń ATA. Analog:
|
do_not_move_phone |
Tylko BroadWorks. Opcjonalna flaga zapobiegająca migracji urządzenia do usługi Webex Calling. Ta opcja umożliwia partnerom dostarczanie użytkownikom ustawień połączeń, urządzeń i numerów telefonów bez migracji urządzeń do Webex lub aktywowania numerów telefonów w usłudze Webex Calling. To ustawienie jest dostępne tylko dla BroadWorks, nie BroadCloud. Aby z niego skorzystać, administratorzy powinni określić do_not_move_phone w kolumnie do_not_move_phone (tylko BroadWorks) pliku users.csv. Dzięki temu użytkownicy mogą korzystać z usług bez konieczności aktywowania numerów lub przenoszenia telefonów, co pozwala im kontynuować pracę za pośrednictwem BroadCloud. |
Instrukcje uruchomienia
Uruchom narzędzie Transform Tool w dowolnym systemie operacyjnym. Aby uruchomić narzędzie w systemie Windows i macOS, wykonaj poniższe czynności:
Windows
Aby uruchomić narzędzie Transform Tool w systemie Windows, wykonaj poniższe polecenie:
transform.bat -extract= -customers= -users= -newphones=
macOS
Aby uruchomić narzędzie transformacji w systemie macOS, wykonaj następujące kroki:
- Utwórz środowisko wirtualne i zainstaluj zależności, aby uruchomić narzędzie transformacji za pomocą języka Python:
python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib python3 -m pip install phonenumbers
- Uruchom narzędzie transformacji:
./transform.sh -extract= -customers= -users= -newphones=
Customer/user sprawdzić wstępnie
Narzędzie Transform Tool wywołuje interfejs API w usłudze Webex, aby wykryć potencjalne problemy z obsługą administracyjną. Domyślnie weryfikowany będzie adres klienta i główny adres e-mail. Jeżeli wartość ID PROVISIONING_jest określona w conf/partner.cfg plik, będzie on również sprawdzał informacje o lokalizacji. Wyniki wstępnej kontroli są uwzględniane w raporcie wyjątków.
Dodatkowo podczas uruchamiania narzędzia transformacji można dodać następujące parametry opcjonalne:
sprawdzić wstępnie
Oprócz uruchomienia interfejsu API wstępnej kontroli informacji o klientach, narzędzie Transform Tool uruchomi również interfejs API wstępnej kontroli wiadomości e-mail subskrybentów.
informacje wstępne
Domyślnie w raporcie wyjątków uwzględniane są tylko błędy wstępnego sprawdzania (czyli problemy, które blokują provisionowanie). Dodanie tej flagi będzie obejmować również pomyślne wyniki wstępnej kontroli (np. jeśli organizacja Webex już istnieje i można ją automatycznie dołączyć).
Uruchomienieprecheckinfo zajmuje dodatkowy czas.
Dzienniki terminala
Po pomyślnej transformacji w terminalu następuje logowanie:
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
Raport wyjątku
Narzędzie Transform generuje raport wyjątku w pliku wyjściowym /<timestamp>/exception_report.txt katalog. Za pomocą tego raportu możesz zidentyfikować problemy, które będą miały wpływ na migrację, i rozwiązać je w systemie Cisco BroadWorks.
Po zmodyfikowaniu danych użytkownika w celu rozwiązania wyjątku należy ponownie uruchomić narzędzia wyodrębniania i przekształcania z nowymi danymi. Przykładowy plik raportu wyjątku wygląda następująco:
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
Wyjście
Plik wyjściowy JSON (customer.json) będzie dostępny w output/<timestamp>/<groupid> katalog. Przykładowy plik customer.json wygląda następująco:
{
"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"
}
}
Ten `webex_for_broadworks_info` Właściwość JSON jest obecna wyłącznie w przypadku migracji Webex for BroadWorks. Ten `broadcloud_info` Właściwość JSON jest obecna wyłącznie w przypadku migracji BroadCloud.
Narzędzie do obsługi administracyjnej
Narzędzie do obsługi administracyjnej może działać na dowolnym komputerze (zwykle laptopie administratora partnera) i wykorzystuje publiczne interfejsy API Webex. Odczytuje plik JSON (customer.json) z wyjścia narzędzia transformacji jako dane wejściowe i dostarcza klientów, lokalizacje, numery, użytkowników, usługi i urządzenia w rozwiązaniu Webex Wholesale RTM.
Wymagania wstępne
Skonfiguruj następujące wymagania wstępne w katalogu narzędzia do obsługi administracyjnej:
- Zainstaluj Javę 8, 11, 17 lub 21 na komputerze. Java jest dostępna z wielu źródeł, w tym:
- Po pobraniu i rozpakowaniu plików binarnych narzędzi migracji ustaw zmienną środowiskową JAVA_HOME w pliku provisioning_tool.sh dla systemu MAC i provisioning_tool.bat dla systemu Windows.
- Plik partner.cfg:
- Ustaw identyfikator WHOLESALE_PROVISIONING_i TOKEN REFRESH_(Token skopiowany z narzędzia Token Generator). Administratorzy partnerów muszą skontaktować się ze swoim zespołem ds. kont, aby uzyskać identyfikator PROVISIONING_:
WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
-
Ustaw opcję ALLOW_ADMIN_INVITE_EMAILS na false, jeśli partner nie chce wysyłać użytkownikom wiadomości powitalnych. Wartością domyślną jest prawda.
- Ustaw identyfikator WHOLESALE_PROVISIONING_i TOKEN REFRESH_(Token skopiowany z narzędzia Token Generator). Administratorzy partnerów muszą skontaktować się ze swoim zespołem ds. kont, aby uzyskać identyfikator PROVISIONING_:
- Użyj właściwości WEBEX4BWKS_EMAIL_SUBJECT w przypadku migracji Webex for BroadWorks, aby wysłać subskrybentom Webex for BroadWorks temat wiadomości e-mail z prośbą o zmianę hasła.
- Użyj właściwości WEBEX4BWKS_EMAIL_BODY w przypadku migracji Webex for BroadWorks, aby wysłać treść wiadomości e-mail z prośbą o zmianę hasła subskrybentom Webex for BroadWorks.
- Funkcja synchronizacji serwera sieciowego umożliwia administratorom dostarczanie numerów telefonów, adresów MAC i adresów e-mail użytkowników podczas migracji w ramach tego samego regionu. Aby włączyć tę opcję, należy ustawić
USE_NS_SYNC=yes
wconf/partner.cfg
.Jeśli synchronizacja NS jest wyłączona, podawanie numerów telefonów i urządzeń zostanie pominięte, a użytkownicy otrzymają tymczasowe adresy e-mail.
W przypadku migracji BroadCloud w tym samym regionie:
- Narzędzie pomija kwestie związane z numerami, urządzeniami i udostępnianiem połączeń.
- Narzędzie tworzy użytkowników, użytkowników wirtualnych z rozszerzeniem i rozszerzeniem tymczasowym.
W przypadku migracji BroadCloud inny region:
- Narzędzie będzie dostarczać numery, urządzenia i współdzielone wyglądy połączeń.
- Narzędzie tworzy użytkowników i użytkowników wirtualnych przy użyciu rzeczywistych numerów telefonów i numerów wewnętrznych.Wszystkie migracje Europe BroadCloud odbywają się do innego regionu.
Instrukcje dotyczące uruchomienia
Aby uruchomić narzędzie w systemie Windows i macOS, wykonaj następujące czynności:
Windows
Aby uruchomić narzędzie w systemie Windows, wykonaj następujące czynności:
To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input=
macOS
Aby uruchomić narzędzie w systemie macOS, wykonaj następujące czynności:
To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=
Wymagania wstępne dla migracji Webex do BroadWorks
Administratorzy partnerów muszą zaktualizować swój szablon wprowadzający BroadWorks, aby umożliwić korzystanie z funkcji współistnienia Webex for BroadWorks. Zobacz poniższy obraz:

Po zaktualizowaniu szablonu Webex for BroadWorks Onboarding w celu obsługi migracji należy zwrócić się do zespołu Cisco Account Team z prośbą o włączenie przełącznika funkcji „wholesale-partner-blending-enabled” na poziomie partnera. Umożliwi to dodanie pakietów hurtowych do istniejących organizacji klientów Webex for BroadWorks podczas ich udostępniania.
Uruchom narzędzie do obsługi administracyjnej z dodatkowym argumentem.
Faza przygotowawcza: jest to faza domyślna, w której administratorzy mogą zapewnić użytkownikom BroadWorks status subskrybentów hurtowych i kontynuować korzystanie z usługi Webex dla użytkowników BroadWorks.
Faza konserwacji: to druga faza, w której administratorzy mogą przypisać licencję hurtową istniejącym użytkownikom Webex for BroadWorks. Narzędzie provisioningu należy uruchomić z argumentem maintenance.
Faza po migracji: Jest to ostatnia faza, w której administratorzy mogą całkowicie przekształcić BroadWorks w wersję hurtową. Narzędzie provisioningu należy uruchomić z argumentem postmigration.
Dzienniki terminala
Poniżej przedstawiono logi w terminalu po pomyślnym zainicjowaniu:
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 ****************
Zostanie wydrukowana tabela zawierająca liczbę lokalizacji utworzonych dla każdego przebiegu:

Wyjście
Narzędzie do obsługi administracyjnej generuje raporty o powodzeniu i błędach w pliku wyjściowym /<external_id>/*.success/error plików. Przejrzyj dzienniki powodzenia i błędów wyjściowych, aby zweryfikować, czy konfiguracja przebiegła pomyślnie.
Administratorzy partnerów mogą weryfikować konfigurację klienta w portalu Partner Hub i Control Hub. Zobacz poniższe ilustracje z portalu Partner Hub i Control Hub:

Rysunek 8: Partner Hub,

Rysunek 9: Control Hub

Rysunek 10: Urządzenia

Rysunek 11: Dzwonienie
Narzędzie do przenoszenia urządzenia
Dla BroadCloud
Partnerzy BroadCloud mogą skorzystać z portalu dostawcy usług, aby przesłać żądanie migracji numerów, urządzeń i migracji funkcji Shared Call Appearances (SCA).
W ramach portalu Dostawcy Usług prośba o migrację może obejmować maksymalnie 50 klientów. Maksymalnie 10 wniosków można złożyć w ciągu jednego dnia.
Funkcja synchronizacji serwera sieciowego umożliwia administratorom dezaktywację lokalizacji broadCloud i aktywację lokalizacji Webex Calling po ustawieniu USE_NS_SYNC=yes
w conf/partner.cfg
. Po migracji urządzenia i numery telefonów zostaną aktywowane w lokalizacji Webex Calling.
Administratorzy mogą włączyć automatyczne wycofywanie, ustawiając ROLLBACK_TO_BROADCLOUD=true
w pliku conf/partner.cfg
, co spowoduje przeniesienie urządzeń z powrotem do BroadCloud po migracji. Obsługuje migracje w obrębie tego samego regionu, jak i między różnymi regionami za pomocą NS Sync, ale tylko w przypadku udanych migracji. W przypadku awarii administratorzy muszą zgłosić problem Cisco TAC przed złożeniem wniosku o wycofanie zmian.
W portalu dostępne są dwie opcje wyboru typu migracji:
- Migracja – Wybierz tę opcję, aby zainicjować żądanie migracji numerów, urządzeń i współdzielonych wyglądów połączeń (SCA).
- Stan urządzenia – Wybierz tę opcję, aby wyświetlić aktualny stan urządzenia w usłudze BroadCloud i funkcji Calling.
Poniższe rysunki przedstawiają portal Dostawcy Usług.
Rysunek 12: Portal Dostawcy Usług
Rysunek 13: Portal Dostawcy Usług
Migruj wybrane lokalizacje (opcjonalnie)
Aby rozpocząć migrację dla określonego podzbioru lokalizacji wymienionych w pliku customer.json
, dołącz plik locations.csv
do swojego żądania. W pliku CSV powinny być wymienione tylko lokalizacje, które zamierzasz migrować.
Jeśli plik locations.csv nie zostanie podany, migrowane zostaną wszystkie lokalizacje z pliku customer.json.
Termin | Definicja |
---|---|
Identyfikator witryny |
Identyfikator witryny, która ma zostać zmigrowana. |
Nazwa lokacji |
Nazwa lokalizacji, która ma zostać zmigrowana. |
Aby pobrać listę dostępnych aktywnych lokalizacji, przejdź do Wyświetl klientów → Wybierz klienta → Eksportuj lokalizacje jako plik CSV.

Rysunek 14: Eksportuj lokalizacje jako CSV
Dla Cisco BroadWorks i Webex dla BroadWorks
W przypadku migracji Cisco BroadWorks i Webex for BroadWorks narzędzie działa na dodatkowym serwerze aplikacji Cisco BroadWorks w sieci partnerskiej i łączy się z systemem autonomicznym (SA) za pośrednictwem protokołu OCI-P. Używa pliku wyjściowego JSON (customer.json) narzędzia Transform Tool jako danych wejściowych i uruchamia polecenia OCI-P w celu migracji urządzeń i klientów programowych.
Po pomyślnym wykonaniu operacji narzędzie do przesuwania urządzenia:
- Wyrejestruj urządzenia z Cisco BroadWorks i zarejestruj je w hurtowni.
- Użytkownicy klienta UC-One zostaną przekierowani do aplikacji Webex przy pierwszym logowaniu.
- Dezaktywuj numery telefonów z Cisco BroadWorks lub usuń numery telefonów z BroadCloud.
- Aktywuj numery hurtowo.
- Utwórz współdzielone wyglądy połączeń hurtowo na potrzeby migracji BroadCloud. [This ten krok dotyczy tylko BroadCloud migrations].
SCP i SSH
- SCP umożliwia narzędzie do przenoszenia urządzeń na zapasowy serwer aplikacji Cisco BroadWorks.
- Nawiąż połączenie SSH z pomocniczym serwerem aplikacji Cisco BroadWorks, aby skonfigurować wymagania wstępne i uruchomić narzędzie do przenoszenia urządzeń.
Wymagania wstępne
- Ustaw REFRESH_TOKEN (Token skopiowany z narzędzia Token Generator) w conf/partner.cfg plik:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
- Upewnij się, że dodatkowy identyfikator użytkownika, hasło i nazwa hosta serwera aplikacji Cisco BroadWorks są poprawne. conf/deviceMoveTool.conf plik:
BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost
- Aby ponownie wysłać e-maile z aktywacją, należy ustawić opcję RESEND_INVITATION_EMAILS=true w conf/partner.cfg plik.
Jeśli administratorzy chcą wysłać użytkownikom e-maile z zaproszeniami podczas migracji, powinni usunąć komentarz z polecenia „RESEND_INVITATION_EMAILS=true" nieruchomość w conf/partner.cfg plik. W przeciwnym razie właściwość powinna pozostać niezmieniona.
- Zweryfikuj JDK/JRE ścieżka środowiska w devicemove.sh jest poprawna
JAVA_HOME=/usr/local/java/java_base
- Administratorzy mogą wykorzystać plik locations.csv z katalogu wejściowego do migracji określonych grup, zamiast wszystkich grup w przedsiębiorstwie.
Telefony Polycom
Aby przenieść telefony Polycom z Cisco BroadWorks do Wholesale Calling, administrator partnera musi utworzyć nowy Identity/Device Plik typu profilu na poziomie systemu w Cisco BroadWorks każdy szablon urządzenia Polycom. Zobacz rysunek 14 i prześlij plik niestandardowy device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Po przesłaniu nowego pliku urządzenia sprawdź, czy nowo utworzony plik istnieje na poziomie grupy. Upewnij się również, że plik migration_%BWMAC ADDRESS%.cfg nie powoduje konfliktu z żadnym plikiem istniejącym w systemie).
Jest on używany wewnętrznie przez narzędzie do przenoszenia urządzenia.
Proces migracji telefonów Polycom:
- Narzędzie do przenoszenia urządzeń zastępuje plik %BWMACADDRESS%.cfg na poziomie urządzenia plikiem polycom_vvx2.cfg. Ten plik odnosi się do migration_%BWMACADDRESS%.cfg.
- Utwórz ponownie profile urządzeń na poziomie grupy lub urządzenia.Działanie na poziomie grupy lub urządzenia zależy od konfiguracji parametru deviceLevelRebuild w pliku device-move-tool/conf/partner.cfg.
- Narzędzie do przenoszenia urządzeń prosi serwer aplikacji Cisco BroadWorks o ponowne uruchomienie telefonów na poziomie grupy lub urządzenia.
- Po żądaniu ponownego uruchomienia telefony Polycom pobierają i przetwarzają plik% BWMACADDRESS%.cfg, który prosi telefony Polycom o pobranie i przetworzenie pliku migration_%BWMACADDRESS%.cfg, który ustawia parametr device.prov.serverName na https://plcm.sipflash.com.https://plcm.sipflash.com w przypadku regionu USA, inne regiony mają inne adresy URL.
- Telefon Polycom pobiera plik %BWMACADDRESS%.cfg z https://plcm.sipflash.com i będzie zarządzany przez system Webex Calling DMS.

Rysunek 14: Identity/device dodaj plik typu profilu
Instrukcje uruchomienia
Istnieją dwie metody wywoływania DMT. Pierwsza polega na wywołaniu pojedynczego klienta na raz, druga zaś na wywołaniu wielu klientów jednocześnie.
Narzędzie do przenoszenia urządzeń uruchamiane jest z pomocniczego serwera aplikacji Cisco BroadWorks w katalogu narzędzi do przenoszenia urządzeń:
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
Dzienniki terminala
Poniżej przedstawiono logi w terminalu po pomyślnym uruchomieniu narzędzia do przenoszenia urządzeń w celu ich migracji:
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
Wyjście
Po migracji urządzeń, urządzenia są podłączone do sieci i gotowe do pracy. make/receive połączenia. Przykład statusu urządzenia przedstawiono na rysunku 15:

Rysunek 15: Stan urządzenia
Po migracji urządzeń numery stały się aktywne. Przykład aktywnych liczb można zobaczyć na rysunku 16:

Rysunek 16: Liczby aktywne
Przywróć migrację
Operację przywracania należy wykonywać dla jednego przedsiębiorstwa na raz.
Dla operatora BroadCloud
Proces przywracania dla partnerów BroadCloud wygląda następująco:
- Aby poprosić o przywrócenie urządzenia, zgłoś się do centrum Cisco TAC.
- Uruchom narzędzie do przenoszenia urządzenia w trybie przywracania:
- Numery telefonów nie będą już przypisane do usługi Webex Calling, a użytkownicy i usługi będą mogli korzystać jedynie z numerów wewnętrznych.
- Adresy e-mail w usłudze Webex Calling zostaną zmienione na tymczasowe adresy e-mail.
- Telefony zostaną usunięte z usługi Webex Calling.
- Numery telefonów, adresy e-mail używane jako alternatywne identyfikatory oraz numery telefonów zostaną odtworzone w BroadCloud.
- Telefony zostaną ponownie uruchomione.
- Administratorzy partnerów muszą przenieść numery telefonów PSTN z powrotem do BroadCloud Carrier.
Dla Cisco BroadWorks i Webex dla BroadWorks
Proces przywracania dla Cisco BroadWorks i Webex for BroadWorks wygląda następująco:
- Aby poprosić o przywrócenie urządzenia, zgłoś się do centrum Cisco TAC.
- Uruchom narzędzie do przenoszenia urządzeń w trybie przywracania na dodatkowym serwerze aplikacji BroadWorks, aby cofnąć migracje urządzeń. Spowoduje to przywrócenie adresu URL DMS do adresu URL DMS dostawcy usługi dla profili urządzeń w Cisco BroadWorks i ponowną aktywację numerów telefonów.
- Zespół Webex Calling ustawia adres URL DMS z powrotem na adres URL DMS dostawcy usługi w profilach urządzeń w Webex Calling.
- Administratorzy partnerów muszą dezaktywować lub usunąć numery telefonów w usłudze Webex Calling za pośrednictwem portalu Control Hub.
- Administratorzy partnerów muszą przenieść numery telefonów PSTN z powrotem do Cisco BroadWorks.
Instrukcje dotyczące uruchamiania narzędzia do przenoszenia urządzeń w trybie przywracania
Aby uruchomić narzędzie do przenoszenia urządzenia w trybie przywracania, wykonaj poniższe czynności:
Uruchom poniższe polecenie na serwerze aplikacji Cisco BroadWorks w katalogu narzędzia do przenoszenia urządzeń:
Przywróć profile
./devicemove.sh -input= -revertProfiles
Przywróć liczby
./devicemove.sh -input= -revertNumbers
Dzienniki terminala
Po pomyślnym uruchomieniu narzędzia do przenoszenia urządzeń w celu ich przywrócenia w terminalu pojawią się następujące logi:
Przywróć profile
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
Przywróć liczby
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
Wyrostek robaczkowy
Duża migracja przedsiębiorstw
Duże przedsiębiorstwa posiadające wiele lokalizacji nie mogą dokonać migracji wszystkich lokalizacji w ramach jednego okna konserwacyjnego. Funkcjonalność opisana w tej sekcji umożliwia partnerom migrację kilku lokalizacji jednocześnie.
Kroki
Aby zaplanować migracje fazowe dla dużego przedsiębiorstwa, wykonaj następujące kroki:
- Wyodrębnij dane przedsiębiorstwa z BroadWorks lub BroadCloud.
- Uruchom narzędzie Transform bez opcji lokalizacji na wyodrębnionych danych.
- Poszukaj sekcji Zalecana lokalizacja do jednoczesnego przeniesienia w pliku exception_report.txt, aby zaplanować fazy migracji i uzyskać więcej informacji na temat zależności lokalizacji. Przeanalizuj pliki listy agentów funkcji (patrz narzędzie Transform poniżej).
- Wygeneruj plik input/locations.csv, modyfikując locations_to_be_edited.csv.
- Uruchom ponownie narzędzie Transform z opcją lokalizacji.
- Przejrzyj plik exception_report.txt, aby zidentyfikować wszelkie problemy związane z zależnościami lokalizacji dla bieżącej fazy.
- W razie potrzeby napraw problemy z zależnościami lokalizacji (poprzez modyfikację pliku locations.csv).
- Uruchom ponownie narzędzie Transform, aby wygenerować plik customers.json dla bieżącej fazy.
- Uruchom narzędzie do obsługi administracyjnej dla każdego pliku customer.json.
- W trakcie trwania okna konserwacyjnego uruchom narzędzie do przenoszenia urządzeń.
- Powtórz kroki 4-10 dla następnej fazy.
Narzędzie transformacji
Aby osiągnąć cel migracji lokalizacji w dużym przedsiębiorstwie faza po fazie, jak wspomniano powyżej, dodano nowy plik locations.csv jako opcjonalne dane wejściowe (-locations=input/locations.csv) podczas uruchamiania narzędzia transformacji.
Plik locations.csv zawiera dane specyficzne dla lokalizacji. Nadpisuje dane znalezione w input/customers.csv, który obecnie zawiera zarówno dane przedsiębiorstwa, jak i dane dotyczące lokalizacji.
W poniższej tabeli wymieniono szczegóły pliku locations.csv:
Opis |
Wartości |
Wartość domyślna |
Wymagane |
Mapy w BroadWorks |
Mapy w BroadCloud | |
---|---|---|---|---|---|---|
Identyfikator przedsiębiorstwa |
Unikalny identyfikator przedsiębiorstwa |
T |
Identyfikator dostawcy usługi |
Identyfikator klienta Rialto | ||
Identyfikator lokalizacji |
Identyfikator lokalizacji, unikalny w obrębie przedsiębiorstwa |
T |
identyfikator grupy |
Identyfikator witryny Rialto | ||
status migracji |
Czy ta lokalizacja została przeniesiona? |
migrował, dont_migrate, migrujący |
migrowanie |
N | ||
nazwa |
Nazwa tej lokalizacji. Pozostaw puste, aby użyć locationId. |
N | ||||
strefa czasowa |
N | |||||
język |
N | |||||
address1 |
N | |||||
address2 |
N | |||||
miasto |
N | |||||
stan |
N | |||||
kod pocztowy |
Kod pocztowy |
N | ||||
kraj |
Kod 2-literowy |
N |
Plik locations.csv można utworzyć z wstępnie wypełnionego pliku locations_to_be_edited.csv podczas uruchamiania narzędzia Transform w dużym przedsiębiorstwie. Czytaj dalej, aby zobaczyć przykłady.
Plik locations.csv jest opcjonalnym wejściem podczas uruchamiania narzędzia transformacji, dlatego narzędzie transformacji będzie zachowywać się tak samo jak wcześniej, jeśli opcja -locations=input/locations.csv nie jest obecny.
Nowe pliki wyjściowe
Narzędzie transformacji zawiera 5 nowych plików wyjściowych:
- locations_to_be_edited.csv – plik ten zawiera wstępnie wypełnione informacje o wszystkich lokalizacjach dużego przedsiębiorstwa, które ma zostać zmigrowane.
Przykład:
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
Ten partners/customers Można go użyć do wygenerowania pliku locations.csv, aby kontrolować lokalizacje, które mają zostać zmigrowane w ramach konkretnej fazy (i w razie potrzeby aktualizować informacje o lokalizacjach).
Przykład: locations.csv wygenerowano z powyższego 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
Ten locations.csvoznacza: w tej fazielokalizacja auto_mig_ent_grp1 została zmigrowana, lokalizacja auto_mig_ent_grp2 jest migrowana, a lokalizacja auto_mig_ent_grp3 nie jest migrowana.
- hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4 pliki mają ten sam cel: wygeneruj kompletne listy odpowiednich funkcji agents/supervisors/originators/targets/monitored_elements w migrujących lokalizacjach, jeśli migrujące lokalizacje są zależne od innych lokalizacji.
Mają one niemal ten sam format (nazwa trzeciej kolumny różni się w zależności od funkcji), jak poniżej (auto_mig_ent_grplista agentów grupy łowieckiej 2 dla powyższej fazy):
Przykład: poniższe pochodzi z 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
Jeżeli opcja lokalizacji nie jest dostępna podczas uruchamiania narzędzia Transform, powyższe 4 pliki wygenerują kompletne listy hunt-group/call-center/paging-group/busy-lamp-field’s agents/supervisors/originators/targets/monitored_elements dla całego przedsiębiorstwa, co umożliwia zaplanowanie migracji fazowych.
Nowe sekcje w exception_report
Podczas wykonywania migracji fazowej dla dużych przedsiębiorstw w pliku exception_report.txt pojawią się nowe sekcje, jeśli nie zostaną spełnione zależności lokalizacji.
Przykład: Poniższa nowa sekcja dotyczy agentów grupy łowieckiej Sarah Rodriguez z lokalizacji auto_mig_ent_grp2 w lokalizacji auto_mig_ent_grp3, która nie została przeniesiona i nie migruje w tej fazie.
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
W poniższej nowej sekcji przedstawiono zalecenia dotyczące grupowania lokalizacji w fazach migracji.
Zalecane lokalizacje do jednoczesnego przemieszczania się:
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
Jeśli opcja lokalizacji nie jest dostępna podczas uruchamiania narzędzia Przekształć, sekcja zalecanych lokalizacji do jednoczesnego przeniesienia zawiera listę wszystkich zależności lokalizacji, aby zapewnić wygodę planowania.
Podczas uruchamiania narzędzia Przekształć z opcją lokalizacji (np. na potrzeby fazy migracji) w sekcji Zalecane lokalizacje do jednoczesnego przeniesienia znajdują się jedynie zależności lokalizacji dla bieżącej fazy.
Narzędzie do obsługi administracyjnej
W przypadku dużych przedsiębiorstw narzędzie do obsługi administracyjnej można uruchomić w zwykły sposób.
Narzędzie do przenoszenia urządzenia
Narzędzie do przenoszenia urządzeń można uruchomić dla podzbioru lokalizacji z pliku customer.json. Aby to osiągnąć, należy dodać nowy opcjonalny plik locations.csv zawierający dwie kolumny.
External_id |
Nazwy lokalizacji |
---|---|
Wartość zewnętrznego identyfikatora |
Nazwy locations/group imiona |
- Jest to plik opcjonalny. Jeśli nie zostanie podany lub zostanie podany z pustymi wartościami, nastąpi migracja wszystkich lokalizacji.
- Jeśli podano nazwy lokalizacji i ich odpowiednie identyfikatory external_, wówczas migrowane zostaną tylko te lokalizacje.
Polecenie brzmi następująco:
./devicemove.sh -input=/customer.json -locations=/Location_names.csv
Strefy czasowe
Stany Zjednoczone:
"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"]
Australia:
"timeZones":["Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Hobart","Australia/Lord_Howe","Australia/Perth","Australia/Sydney"]
Francja:
"timeZones":["Europe/Paris"]
Portugalia:
"timeZones":["Atlantic/Azores","Europe/Lisbon"]}
Wielka Brytania:
"timeZones":["Europe/London"]
Włochy:
"timeZones":["Europe/Rome"]
Niemcy:
"timeZones":["Europe/Berlin"]