- Strona główna
- /
- Artykuł
Narzędzia migracyjne do przejścia na rozwiązania RTM hurtowe
Przeprowadź migrację z minimalną konfiguracją wstępną. 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.
Przegląd
Celem tego dokumentu jest dostarczenie szczegółowych instrukcji dotyczących korzystania z narzędzi do migracji z Cisco BroadWorks, Webex for BroadWorks i BroadCloud do Wholesale i Webex Calling. W tym dokumencie opisano zestaw narzędzi migracyjnych, które mają pomóc w migracji obecnych klientów korzystających z 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ć po migracji tak samo, jak działały przed migracją. 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 dostosowania i będą musieli ponownie skonfigurować te ustawienia po migracji. Przykładami są szybkie wybieranie.
- Użytkownicy muszą zresetować swoje kody dostępu i hasła przy pierwszym logowaniu.
- 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 administracyjnej— używa pliku wyjściowego JSON z narzędzia Transform Tool do obsługi administracyjnej klientów, 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łych analiz po uruchomieniu zadań migracji przez administratora.

Ryc. 1: Narzędzia migracji
Wymagania
Przed uruchomieniem narzędzi migracyjnych 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 przejrzeć 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ń Webex Calling.
- Aby uzyskać informacje na temat obsługiwanej wersji oprogramowania sprzętowego dla telefonów i urządzeń, partnerzy muszą zwrócić się do swojego działu obsługi kont w firmie Cisco.
- 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 korzystania z narzędzia Transform Tool.
- Klienci muszą posiadać ważny adres rozliczeniowy, a użytkownicy końcowi muszą mieć skonfigurowany w Cisco BroadWorks służbowy adres e-mail. 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
- Migracja urządzeń za pomocą narzędzia do przenoszenia urządzeń
- Migracje bez urządzeń [ Aktywacja numerów telefonów za pomocą Control Hub ]
Jeśli administratorzy partnerów nie mają urządzeń, które należy przenieść z Cisco BroadWorks do Wholesale, uruchomienie narzędzia do przenoszenia urządzeń nie jest konieczne. Administratorzy partnerów mogą skorzystać z 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 przeniesione do funkcji 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 audio 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 kontakt osobisty (z uwzględnieniem harmonogramu i kryteriów selekcji)
- Powiadomienie o połączeniu (w tym harmonogram i kryteria wyboru)
- Odrzucanie połączeń anonimowych
- Selektywne odrzucanie połączeń
- Selektywne przekierowywanie połączeń
- Odbieranie połączeń kierowanych i wtrącanie się
- Zwolnienie z opłat za wjazd
- Naciśnij i mów
- 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 przekierowywania połączeń (zawsze, zajęte, selektywne)
- Numery dodatkowe
- Menu świąteczne nie jest dostępne w Webex
- Selektywne odrzucanie połączeń
- Cisco BroadWorks Call Center Standard i BroadCloud Call Queue:
- Podstawowa konfiguracja
- Spersonalizowane pozdrowienia
- Agenci i kierownicy
- Ustawienia przekierowywania połączeń (zawsze, zajęte, selektywne)
- Numery dodatkowe
- Muzyka w oczekiwaniu
- Wymuszone przekierowanie
- Ominięcie komunikatu o komforcie
- Zaparkowanie połączenia
- 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 stronicowania
- 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 |
DMS Cisco 6821 |
Cisco MPP 6841 |
Tak |
DMS Cisco 6841 |
Cisco MPP 6851 |
Tak |
DMS Cisco 6851 |
Cisco MPP 6861 |
Tak |
DMS Cisco 6861 |
Cisco MPP 6871 |
Tak |
DMS Cisco 6871 |
Cisco MPP 7811 |
Tak |
DMS Cisco 7811 |
Cisco MPP 7821 |
Tak |
DMS Cisco 7821 |
Cisco MPP 7832 |
Tak |
DMS Cisco 7832 |
Cisco MPP 7841 |
Tak |
DMS Cisco 7841 |
Cisco MPP 7861 |
Tak |
DMS Cisco 7861 |
Cisco MPP 8811 |
Tak |
DMS Cisco 8811 |
Cisco MPP 8832 |
Tak |
DMS Cisco 8832 |
Cisco MPP 8841 |
Tak |
DMS Cisco 8841 |
Cisco MPP 8845 |
Tak |
DMS Cisco 8845 |
Cisco MPP 8851 |
Tak |
DMS Cisco 8851 |
Cisco MPP 8861 |
Tak |
DMS Cisco 8861 |
Cisco MPP 8865 |
Tak |
DMS Cisco 8865 |
Cisco MPP 8875 |
Tak |
DMS Cisco 8875 |
Cisco ATA191 |
Tak |
DMS Cisco 191 |
Cisco ATA192 |
Tak |
DMS Cisco 192 |
Cisco DBS 110 |
Tak |
DMS Cisco DBS110 |
Polycom VVX101 |
Tak |
DMS Polycom VVX101 |
Polycom VVX150 |
Tak |
DMS Polycom VVX150 |
Polycom VVX201 |
Tak |
DMS Polycom VVX201 |
Polycom VVX250 |
Tak |
DMS Polycom VVX250 |
Polycom VVX301 |
Tak |
DMS Polycom VVX301 |
Polycom VVX311 |
Tak |
DMS Polycom VVX311 |
Polycom VVX350 |
Tak |
DMS Polycom VVX350 |
Polycom VVX401 |
Tak |
DMS Polycom VVX401 |
Polycom VVX411 |
Tak |
DMS Polycom VVX411 |
Polycom VVX450 |
Tak |
DMS Polycom VVX450 |
Polycom VVX501 |
Tak |
DMS Polycom VVX501 |
Polycom VVX601 |
Tak |
DMS Polycom VVX601 |
Polycom Trio 8300 |
Tak |
DMS Polycom Trio8300 |
Polycom Trio 8500 |
Tak |
DMS Polycom Trio8500 |
Polycom Trio 8800 |
Tak |
DMS Polycom Trio8800 |
Polycom SoundStation 5000 |
Tak |
DMS Polycom SSIP5000 |
Polycom SoundStation 6000 |
Tak |
DMS 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żeli klient korzysta z urządzeń nieobsługiwanych przez rozwiązanie Wholesale RTM, wówczas 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.
- Stare telefony należy pozostawić w Cisco BroadWorks, a użytkownicy muszą zainstalować aplikację Webex, aby wykonywać i odbierać połączenia.
Pakiety połączeń hurtowych
Narzędzia migracji zawierają zestaw domyślnych ustawień umożliwiających wybór pakietów połączeń hurtowych dla abonentów. Jeśli później będziesz potrzebować innego pakietu, administrator partnera może dokonać zmian w Control Hub.
Konfiguracja pakietu migracji Cisco BroadWorks
Wszyscy abonenci, którzy dokonali 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 ani poczty głosowej, można włączyć tę funkcję 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 dla 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: conf/rialto_station_type_to_wholesale_package.csv.
Typ stacji nośnej BroadCloud |
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 współdzielony przez 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 automatyczne przekształcanie 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 provisioningowe. 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 migracji. Uruchomienie tego narzędzia jest czynnością jednorazową, wykonywaną po włą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 potrzebnego do aktualizacji plików konfiguracyjnych partnerów na potrzeby 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 w 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, a następnie skopiuj go w celu dalszego wykorzystania.
Ilustracje interfejsu użytkownika podano poniżej, w celach informacyjnych:
Ryc. 3: Zaloguj się za pomocą Cisco Webex
Ryc. 4: Okno poświadczeń
Ryc. 5: Generowanie tokenów
Zadania konfiguracji programu RoadWorks
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 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 konfiguracji Ustawień ogólnych.
Uruchom następujące polecenie w interfejsie CLI, aby przejść do katalogu GeneralSettings:
AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.
Uruchom następujące polecenie w interfejsie 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śli Twoje ustawienia nie są zgodne z powyższymi, użyj polecenia set, aby zmienić konfigurację 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śli Twoje ustawienia nie są zgodne z powyższymi, użyj polecenia set, aby zmienić konfigurację ustawień.
Krok 3: Użyj interfejsu CLI do skonfigurowania usługi OCI Provisioning.
Przejdź do katalogu Provisioning:
AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning
Uruchom następujące polecenie, aby uzyskać aktualne 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 poprawna.
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 interfejsie 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 potwierdzenia wpisz Y.
Narzędzie do ekstrakcji
Dla BroadCloud
Narzędzie do ekstrakcji 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 przesłać dla tego samego klienta więcej niż 10 razy dziennie.
- Możesz pobrać wyodrębniony plik danych w formacie ZIP i korzystać z niego 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 ekstraktu 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 należy wykonać ekstrakcję.
-
Prześlij i prześlij
Po zakończeniu edycji prześlij zmodyfikowany plik CSV.
Kliknij Prześlij, aby zainicjować żądanie wyciągu dla wymienionych klientów i powiązanych z nimi 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 prześlij
Prześlij edytowany plik locations.csv i kliknij Prześlij.
W prośbie o wyciąg zostaną uwzględnione tylko wskazane lokalizacje dla wybranego klienta.
Rozpocznij żą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 eksportuje te dane do plików XML, które stanowią dane wejściowe dla narzędzia transformacji.
W kolejnych sekcjach wyjaśniono, jak zainstalować i skonfigurować narzędzie do wyodrębniania.
Wymagania wstępne
- Przenieś 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 do wyodrębnienia 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 w polu Nazwa hosta, hasło i identyfikator użytkownika dodatkowego 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 serwer aplikacji Cisco BroadWorks jest serwerem pomocniczym 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. Aby wyświetlić i wykorzystać plik ZIP dla danych wejściowych narzędzia Transform, użyj następującego polecenia:
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 wyodrębnieniu 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 Centrum partnerskim) 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 input/users.csv plik.
- Jeśli mają zostać dostarczone nowe telefony, dodaj 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, korzystając z input/cxessentials.csv plik.
- Opcjonalnie włącz właściwość UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, aby przekonwertować wszystkie centra obsługi telefonicznej na CxEssentials.
- Użyj input/locations.csv plik do obsługi migracji dużych 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. Odkomentuj linię USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes w pliku 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ę funkcję, 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.
-
Jeśli chcesz skonfigurować urządzenia bramowe, dodaj adres MAC urządzenia i identyfikator użytkownika do input/genericgateways.csv plik. Należy również zaznaczyć, czy użytkownik jest GŁÓWNYM właścicielem, czy użytkownikiem WSPÓŁDZIELONYM (w przypadku współdzielonych wystąpień w rozmowach). Jest to konieczne tylko wtedy, gdy administratorzy partnerów planują używać uniwersalnych urządzeń bramowych w połączeniach hurtowych.
Ta funkcja nie jest dostępna w przypadku migracji z BroadCloud do Wholesale.
-
W przypadku migracji BroadCloud, aby przekonwertować wszystkich użytkowników z typem stacji obsługi wiadomości na voice_mail_group, zaktualizuj plik conf/rialto_station_type_to_wholesale_package.csv, zastępując wartość Wholesale Package wartością voice_mail_group dla wiersza, w którym Rialto Station Type to obsługa wiadomości.
Opcjonalnie włącz właściwość COMMON_VOICE_MAIL_GROUP_PASSCODE w pliku partner.cfg, aby skonfigurować domyślny kod PIN dla grup poczty głosowej.
Jeżeli ta właściwość nie jest określona w pliku partner.cfg, należy ją podać dla każdego klienta w pliku customers.csv w kolumnie commonVoicemailGroupPassCode.
-
Do migracji wspólnych kontaktów do usługi Webex Calling
Jest to udoskonalenie umożliwiające zarządzanie wspólnymi kontaktami na poziomie przedsiębiorstwa i placówek. Te kontakty można teraz migrować albo jako kontakty organizacyjne (Kontakty organizacji), albo jako rozszerzenia wirtualne, w zależności od ustawień konfiguracji. Poniżej znajdziesz szczegółowe informacje, które przeprowadzą Cię przez proces migracji.
Konfiguracja kluczy:
- WSPÓLNY_TELEFON_LISTA_DO_WIRTUALNY_NUMER WEWNĘTRZNY_START_ZAKRES
W pliku partner.cfg wprowadzono nową właściwość COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION__START [] RANGE. Ta właściwość określa sposób migracji wspólnych kontaktów z Rialto do Webex Calling.
- Bez WSPÓLNEGO_TELEFON_LISTA_DO_WIRTUALNY_ROZSZERZENIE_START_ZAKRES Skonfigurowano
Wspólne kontakty zostaną przeniesione jako kontakty organizacyjne (Org Contacts).
Nie jest wymagana żadna dodatkowa konfiguracja.
Kontakty pozostają dostępne na poziomie organizacji.
- Z skonfigurowanym zakresem WSPÓLNYM_TELEFON_LISTA_DO_WIRTUALNEGO__ROZSZERZENIA_START []
Wspólne kontakty zostaną przeniesione jako rozszerzenia wirtualne.
Do każdego kontaktu zostanie dołączony numer wewnętrzny, a zakres początkowy numeru wewnętrznego jest zdefiniowany we właściwości WSPÓLNY_TELEFON_LISTA_DO_WIRTUALNY_NUMER WEWNĘTRZNY_STARTOWY_ZAKRES w pliku partner.cfg.
Rozszerzenia wirtualne są obsługiwane zarówno na poziomie organizacji, jak i lokalizacji, w zależności od zakresu kontaktu.
- WSPÓLNY_TELEFON_LISTA_DO_WIRTUALNY_NUMER WEWNĘTRZNY_START_ZAKRES
-
Wykluczenie wybranych numerów telefonów z migracji:
Aby wykluczyć określone numery telefonów z procesu migracji, należy wykonać następującą dwuetapową procedurę z wykorzystaniem narzędzia transformacji:
- Najpierw wykonaj narzędzie transformacji. Po zakończeniu narzędzie wygeneruje plik o nazwie telephone_numbers_inventory.csv, znajdujący się w output/timestamp/ informator. Klient jest zobowiązany przejrzeć ten plik i zaznaczyć „Tak” w kolumnie „Usuń numery telefonów” dla każdego numeru telefonu, który ma zostać wykluczony z nadchodzącej migracji.
- Po zaktualizowaniu pliku telephone_numbers_inventory.csv o odpowiednie flagi wykluczeń narzędzie transformacji zostanie uruchomione po raz drugi. Zaktualizowany plik należy przekazać jako argument w następującym formacie.
./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}
Napeł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ług 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. |
Nazwa klienta |
W przypadku przedsiębiorstw ta kolumna 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 to 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ą strefy czasowej. |
język | Zobacz Języki obsługiwane przez Webex. |
domyślny kod PIN poczty głosowej |
Zobacz Ustaw kod PIN poczty głosowej. |
wspólnyKod dostępu grupy poczty głosowej | Użyj tej kolumny, aby określić domyślny kod PIN, który będzie stosowany do wszystkich grup poczty głosowej danego klienta. Po migracji administratorzy muszą zaktualizować kod PIN dla każdej grupy poczty głosowej. Podczas procesu transformacji wspólny kod PIN określony przez administratora zostaje przypisany do wszystkich grup poczty głosowej. |
Napeł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 zostaną podane, zostaną wykorzystane 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, wołanie, apartament, common_area, virtual_line, dont_migrate, call_park_ext lub voice_mail_group. 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 provisionowania, jak i migracji. Ta funkcja jest obsługiwana zarówno przez BroadWorks, jak i BroadCloud. Po zastosowaniu tej opcji wybrani użytkownicy i powiązane z nimi zasoby nie zostaną przeniesieni ani udostępnieni. 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: Ta opcja wyłącza oczekiwanie na połączenie i muzykę w oczekiwaniu na połączenie 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 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 wstępne sprawdzenie
Narzędzie Transform Tool wywołuje interfejs API w usłudze Webex, aby wykryć potencjalne problemy z obsługą. 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, zweryfikuje również 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:
wstępne sprawdzenie
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 sprawdzenia (tj. 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 następujący komunikat:
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ątków
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 ekstrakcji i transformacji, używając nowych danych. 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 katalogu 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 aprowizacji
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 wyodrębnieniu plików binarnych narzędzi migracji ustaw zmienną środowiskową JAVA_HOME w pliku provisioning_tool.sh dla komputerów MAC i provisioning_tool.bat dla systemu Windows.
- Plik partner.cfg:
- Ustaw identyfikator WHOLESALE_PROVISIONING_i REFRESH_TOKEN (token skopiowany z narzędzia do generowania tokenów). 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 REFRESH_TOKEN (token skopiowany z narzędzia do generowania tokenów). 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ę funkcję, 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 wyglądu połączeń.
- Narzędzie tworzy użytkowników, użytkowników wirtualnych z rozszerzeniem i rozszerzeniem tymczasowym.
W przypadku migracji do BroadCloud inny region:
- Narzędzie będzie dostarczać numery, urządzenia i udostępniać 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 uruchomienia
Aby uruchomić narzędzie w systemie Windows i macOS, wykonaj następujące czynności:
Windows
Aby uruchomić narzędzie w systemie operacyjnym 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 kroki:
To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=
Wymagania wstępne dotyczące migracji Webex do BroadWorks
Administratorzy partnerów muszą zaktualizować swój szablon wprowadzający BroadWorks, aby umożliwić korzystanie z funkcji współistnienia Webex dla BroadWorks. Zobacz poniższy obrazek:

Po zaktualizowaniu szablonu Webex for BroadWorks Onboarding w celu umożliwienia migracji należy zwrócić się do zespołu ds. obsługi kont Cisco 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 wdrażania.
Uruchom narzędzie provisioningowe z dodatkowym argumentem.
Faza przygotowawcza: jest to faza domyślna, w której administratorzy mogą udostępniać użytkownikom BroadWorks konta hurtowe 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. Należy uruchomić narzędzie provisioningowe z argumentem maintenance.
Faza po migracji: To ostatnia faza, w której administratorzy mogą całkowicie przekształcić BroadWorks w wersję hurtową. Należy uruchomić narzędzie provisioningowe z argumentem postmigration.
Dzienniki terminala
Poniżej przedstawiono logi terminala 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 pliki. Przejrzyj dzienniki powodzenia i błędów wyjściowych, aby zweryfikować, czy konfiguracja przebiegła pomyślnie.
Administratorzy partnerów mogą weryfikować konfigurację klientów w portalach 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
Ograniczenia po zaopatrzeniu
Po zakończeniu przygotowywania migracji do BroadCloud następujące działania zostaną zablokowane:
- Portal CAP – Dodawanie użytkowników lub przeniesionych urządzeń.
- Portal SP – Tworzenie zamówień ADD z urządzeniami lub numerami.
- RSB API – Tworzenie zamówień ADD z urządzeniami lub numerami i tworzenie użytkowników. Zamówienia RSB ADD złożone przy użyciu urządzeń lub numerów zostaną odrzucone.
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 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 zmian, 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 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 połączeń.
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 konkretnego 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 przenieść.
Jeśli plik locations.csv nie zostanie podany, przeniesione zostaną wszystkie lokalizacje z pliku customer.json.
Termin | Definicja |
---|---|
Identyfikator witryny |
Identyfikator witryny, która ma zostać przeniesiona. |
Nazwa lokacji |
Nazwa lokalizacji, która ma zostać zmigrowana. |
Aby pobrać listę dostępnych aktywnych witryn, 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 sklepie hurtowym.
- Użytkownicy korzystający z 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ń hurtowych na potrzeby migracji do BroadCloud. [This ten krok dotyczy tylko BroadCloud migrations].
SCP i SSH
- SCP umożliwia narzędzie do przenoszenia urządzeń 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 przenoszenia urządzeń.
Wymagania wstępne
- Ustaw REFRESH_TOKEN (Token skopiowany z narzędzia do generowania tokenów) w conf/partner.cfg plik:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
- Upewnij się, że w polu Nazwa hosta, hasło i identyfikator użytkownika dodatkowego 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ę WYŚLIJ PONOWNIE_ZAPROSZENIE_EMAILS=true w conf/partner.cfg plik.
Jeśli administratorzy chcą wysyłać użytkownikom e-maile z zaproszeniami podczas migracji, powinni usunąć komentarz z polecenia „WYŚLIJ PONOWNIE_ZAPROSZENIE_EMAILS=true" nieruchomość w conf/partner.cfg plik. W przeciwnym wypadku nieruchomość 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 konkretnych grup, a nie 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. Odnieś się do rysunku 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 koliduje z żadnym istniejącym plikiem 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 prośbie o ponowne uruchomienie 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 pozostałe regiony mają inne adresy URL.
- Telefon Polycom pobiera plik %BWMACADDRESS%.cfg z https://plcm.sipflash.com i będzie zarządzany przez usługę Webex Calling DMS.

Rysunek 14: Identity/device dodaj plik typu profilu
Instrukcje uruchomienia
Istnieją dwie metody wywoływania DMT. Pierwsza polega na wywołaniu jednego klienta na raz, druga zaś na wywołaniu wielu klientów jednocześnie.
Narzędzie do przenoszenia urządzeń uruchamia się 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ś problem 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żytkownikom i usługom pozostaną jedynie numery wewnętrzne.
- 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 wersji dla Cisco BroadWorks i Webex for BroadWorks wygląda następująco:
- Aby poprosić o przywrócenie urządzenia, zgłoś problem 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ądzenia 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
Migracja dużych 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 naraz.
Kroki
Aby zaplanować migracje etapowe 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.
- Aby zaplanować fazy migracji i uzyskać więcej informacji na temat zależności lokalizacji, należy zapoznać się z sekcją Zalecana lokalizacja do jednoczesnego przeniesienia w pliku exception_report.txt, a następnie przejrzeć 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 dane dotyczące przedsiębiorstwa i lokalizacji.
W poniższej tabeli wymieniono szczegóły pliku locations.csv:
Opis |
Wartości |
Wartość domyślna |
Wymagane |
Mapy w BroadWorks |
Mapy w BroadCloud | |
---|---|---|---|---|---|---|
EnterpriseId |
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 poprzednio, 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 jest wstępnie wypełniony informacjami 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ć przeniesione w ramach konkretnej fazy (i w razie potrzeby aktualizować informacje o lokalizacjach).
Przykład: locations.csv wygenerowany 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: wygenerować 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 pliku 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 etapowych.
Nowe sekcje w exception_report
Podczas przeprowadzania 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 Transform 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 aprowizacji
W przypadku dużych przedsiębiorstw narzędzie provisioningowe 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ść identyfikatora zewnętrznego |
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 odpowiednie identyfikatory external_, migrowane zostaną tylko te lokalizacje.
Polecenie jest następujące:
./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"]