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:

  1. 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.
  2. Narzędzie transformacji— transformuje informacje wyodrębnione przez narzędzie ekstrakcji do pliku JSON, który można edytować.
  3. 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.
  4. 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.

Schemat architektury narzędzi migracji

Ryc. 1: Narzędzia migracyjne

Wymagania

Przed uruchomieniem narzędzi migracji partner musi spełnić następujące wymagania:

  1. 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.
  2. Partner musi zapoznać się z listą kontrolną przed migracją, aby upewnić się, że wszystkie wymagania zostały spełnione.
  3. Do uruchomienia narzędzi do wyodrębniania i przenoszenia urządzeń wymagane są uprawnienia administratora systemu Cisco BroadWorks. Nie dotyczy to partnerów BroadCloud.
  4. 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.
  5. Przejrzyj listę obsługiwanych urządzeń Webex Calling.
  6. Przejrzyj listę nieobsługiwanych urządzeń do połączeń Webex.
  7. 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ń.
  8. 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ą.
  9. 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.
  10. 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:

  1. 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
  2. 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
  3. 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:

  1. Przed migracją zainstaluj nowe telefony w systemie Cisco BroadWorks.
  2. 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:

  1. 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
  2. (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
  3. Uruchom narzędzie transformacji.
  4. Uruchom narzędzie do obsługi administracyjnej.
  5. Otwórz Control Hub nowo utworzonej organizacji klienta i ustaw domenę SIP (patrz rysunek 2, Konfigurowanie domeny SIP w Control Hub).
  6. 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.

Okno Control Hub w Ustawieniach organizacji podświetlające sekcję Adres SIP dla połączeń Cisco Webex.

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:

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:

Zaloguj się za pomocą ekranu Cisco Webex

Ryc. 3: Zaloguj się za pomocą Cisco Webex

Ekran logowania do okna poświadczeń

Ryc. 4: Okno poświadczeń

Ekran generowania tokenów

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.

Dotyczy to Cisco BroadWorks i Webex for BroadWorks. Te kroki nie mają zastosowania w przypadku BroadCloud.

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:

  1. 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.
  2. 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.

Ekran portalu dostawcy usług przedstawiający żądanie zainicjowania ekstraktu migracji hurtowej.

Rysunek 6: Portal Dostawcy Usług

Ekran portalu dostawcy usług pokazujący żądania ekstrakcji migracji hurtowej

Rysunek 7: Portal Dostawcy Usług

Żądanie ekstraktu CSV

Zainicjuj żądanie wyodrębnienia pliku CSV

  1. Pobierz plik CSV klienta

    Kliknij łącze Pobierz plik CSV klienta w prawym górnym rogu sekcji Rozpocznij żądanie wyodrębnienia pliku CSV.

  2. Edytuj listę klientów

    Administrator może edytować plik CSV, aby uwzględnić tylko tych klientów, dla których ma zostać przeprowadzona ekstrakcja.

  3. 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

  1. Wybierz lokalizację klienta i pobierania

    Wybierz klienta z listy rozwijanej.

    Pobierz odpowiedni plik locations.csv z Wyświetl klientówzakładka Lokalizacje Eksportuj lokalizacje jako plik CSV.

  2. Edytuj plik lokalizacji

    Administrator może edytować plik CSV, aby uwzględnić tylko te lokalizacje, które chce wyodrębnić.

  3. 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

  1. Kliknij Prześlij, aby zainicjować żądanie wyciągu dla wszystkich klientów i wszystkich ich lokalizacji w ramach bieżącego dostawcy usług.

Sekcje w żądaniu wyciągu.

Dla Cisco BroadWorks i Webex dla BroadWorks

  1. 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.
  2. 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

  1. Prześlij pliki binarne narzędzia do wyodrębniania za pomocą protokołu SCP na pomocniczy serwer aplikacji Cisco BroadWorks.
  2. Nawiąż połączenie SSH z pomocniczym serwerem aplikacji Cisco BroadWorks, aby skonfigurować wymagania wstępne i uruchomić narzędzie do wyodrębniania.
  3. 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
    
  4. 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.

  5. 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:

  1. 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
    
  2. 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_.
  3. Skonfiguruj brakujące informacje w input/customers.csv plik (patrz następna sekcja), jeśli go brakuje.
  4. Dodaj adres e-mail użytkownika końcowego w polu input/users.csv plik.
  5. 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.
  6. Przekształć centra telefoniczne BroadWorks w CxEssentials przy użyciu input/cxessentials.csv plik.
  7. Opcjonalnie włącz właściwość UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, aby przekonwertować wszystkie centra telefoniczne na CxEssentials.
  8. 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
  9. 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
  10. 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 w conf/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.

  11. 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.

Wszystkie te pola są opcjonalne.

Poniższa tabela wyjaśnia najważniejsze kolumny w input/customers.csv.

Nazwa kolumny

Reguły

Identyfikator

W trybie korporacyjnym Cisco BroadWorks:

  • To jest identyfikator dostawcy usługi Cisco BroadWorks dla przedsiębiorstwa.
  • Ponadto dla każdej grupy w przedsiębiorstwie potrzebny jest oddzielny wiersz. Identyfikatorem jest identyfikator grupy 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.

e-mail

(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:

  • Podobnie jak opcja T38, to ustawienie wyłącza również funkcje połączeń oczekujących i muzyki w trakcie oczekiwania oraz włącza opcję T38 dla urządzeń ATA.
  • Główną zaletą opcji Analog jest to, że tymi funkcjami można sterować za pośrednictwem plików partner.cfg, co zapewnia większą elastyczność konfiguracji.

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:

  1. 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
    
  2. 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:

  1. Zainstaluj Javę 8, 11, 17 lub 21 na komputerze. Java jest dostępna z wielu źródeł, w tym:
  2. 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.
  3. 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.

  4. 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.
  5. 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.
  6. 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 w conf/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:

  1. Narzędzie pomija kwestie związane z numerami, urządzeniami i udostępnianiem połączeń.
  2. Narzędzie tworzy użytkowników, użytkowników wirtualnych z rozszerzeniem i rozszerzeniem tymczasowym.

W przypadku migracji BroadCloud inny region:

  1. Narzędzie będzie dostarczać numery, urządzenia i współdzielone wyglądy połączeń.
  2. 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:

Tabela z 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.

Po pomyślnym skonfigurowaniu rozwiązania administratorzy klientów i użytkownicy końcowi otrzymają wiadomość e-mail od dostawcy rozwiązania Wholesale RTM.

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:

Zrzut ekranu Partner Hub przedstawiający wyszukiwanie klienta hurtowego w polu rozwijanym Wybierz klienta.

Rysunek 8: Partner Hub,

Zrzut ekranu Control Hub przedstawiający kartę Użytkownicy i listę użytkowników.

Rysunek 9: Control Hub

Zrzut ekranu Control Hub przedstawiający ekran Urządzenia i listę urządzeń.

Rysunek 10: Urządzenia

Zrzut ekranu Control Hub przedstawiający ekran Numery i listę numerów telefonów.

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.

Portal Dostawcy Usług

Rysunek 12: Portal Dostawcy Usług

Portal dostawcy usług wyświetlający żądanie migracji.

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.

Tabela 1. Legendy Locations.csv
TerminDefinicja

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.

Eksportuj lokalizacje jako 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:

  1. Wyrejestruj urządzenia z Cisco BroadWorks i zarejestruj je w hurtowni.
  2. Użytkownicy klienta UC-One zostaną przekierowani do aplikacji Webex przy pierwszym logowaniu.
  3. Dezaktywuj numery telefonów z Cisco BroadWorks lub usuń numery telefonów z BroadCloud.
  4. Aktywuj numery hurtowo.
  5. Utwórz współdzielone wyglądy połączeń hurtowo na potrzeby migracji BroadCloud. [This ten krok dotyczy tylko BroadCloud migrations].
Jeśli w Cisco BroadWorks lub BroadCloud nie ma urządzeń zarejestrowanych, które wymagają migracji, nie ma potrzeby uruchamiania narzędzia do przenoszenia urządzeń.

SCP i SSH

  1. SCP umożliwia narzędzie do przenoszenia urządzeń na zapasowy serwer aplikacji Cisco BroadWorks.
  2. 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

  1. Ustaw REFRESH_TOKEN (Token skopiowany z narzędzia Token Generator) w conf/partner.cfg plik:
    REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
  2. 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
    
  3. 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.

  4. Zweryfikuj JDK/JRE ścieżka środowiska w devicemove.sh jest poprawna
    JAVA_HOME=/usr/local/java/java_base
  5. 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).

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

Jest on używany wewnętrznie przez narzędzie do przenoszenia urządzenia.

Proces migracji telefonów Polycom:

  1. 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.
  2. 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.
  3. Narzędzie do przenoszenia urządzeń prosi serwer aplikacji Cisco BroadWorks o ponowne uruchomienie telefonów na poziomie grupy lub urządzenia.
  4. 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.
  5. Telefon Polycom pobiera plik %BWMACADDRESS%.cfg z https://plcm.sipflash.com i będzie zarządzany przez system Webex Calling DMS.
Identity/device typ profilu plik dodaj zrzut ekranu

Rysunek 14: Identity/device dodaj plik typu profilu

Pole „Adres MAC” in:", użyj tych samych wartości, co w innych plikach szablonu Polycom. (Na rysunku 14 należy użyć identyfikatora URI żądania HTTP, ale może to nie być właściwe w przypadku wdrożenia serwera aplikacji Cisco BroadWorks u partnera).

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:

Zrzut ekranu strony urządzeń Control Hub pokazujący stan urządzenia.

Rysunek 15: Stan urządzenia

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

Zrzut ekranu ekranu Control Hub Numbers pokazujący aktywne numery.

Rysunek 16: Liczby aktywne

Przywróć migrację

Operację przywracania należy wykonywać dla jednego przedsiębiorstwa na raz.

Narzędzie do przenoszenia urządzeń nie dezaktywuje numerów w usłudze połączeń hurtowych z powodu ograniczeń technicznych występujących podczas operacji przywracania.

Dla operatora BroadCloud

Proces przywracania dla partnerów BroadCloud wygląda następująco:

  1. Aby poprosić o przywrócenie urządzenia, zgłoś się do centrum Cisco TAC.
  2. 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.
  3. 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:

  1. Aby poprosić o przywrócenie urządzenia, zgłoś się do centrum Cisco TAC.
  2. 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.
  3. Zespół Webex Calling ustawia adres URL DMS z powrotem na adres URL DMS dostawcy usługi w profilach urządzeń w Webex Calling.
  4. Administratorzy partnerów muszą dezaktywować lub usunąć numery telefonów w usłudze Webex Calling za pośrednictwem portalu Control Hub.
  5. 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:

  1. Wyodrębnij dane przedsiębiorstwa z BroadWorks lub BroadCloud.
  2. Uruchom narzędzie Transform bez opcji lokalizacji na wyodrębnionych danych.
  3. 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).
  4. Wygeneruj plik input/locations.csv, modyfikując locations_to_be_edited.csv.
  5. Uruchom ponownie narzędzie Transform z opcją lokalizacji.
  6. Przejrzyj plik exception_report.txt, aby zidentyfikować wszelkie problemy związane z zależnościami lokalizacji dla bieżącej fazy.
  7. W razie potrzeby napraw problemy z zależnościami lokalizacji (poprzez modyfikację pliku locations.csv).
  8. Uruchom ponownie narzędzie Transform, aby wygenerować plik customers.json dla bieżącej fazy.
  9. Uruchom narzędzie do obsługi administracyjnej dla każdego pliku customer.json.
  10. W trakcie trwania okna konserwacyjnego uruchom narzędzie do przenoszenia urządzeń.
  11. 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"]