Narzędzia migracji do przejścia z BroadWorks, Webex dla BroadWorks i BroadCloud do hurtowych rozwiązań RTM

Obsługiwane telefony zostaną automatycznie utworzone i przypisane do użytkowników Webex Calling za pomocą narzędzia do obsługi administracyjnej. Telefony oznaczone „tak” w kolumnie „Obsługiwane w narzędziu do przenoszenia urządzenia” zostaną automatycznie przeniesione z Cisco BroadWorks lub BroadCloud do Webex Calling po uruchomieniu narzędzia do przenoszenia urządzenia. Telefony oznaczone w tej kolumnie „Nie” wymagają ręcznej interwencji 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” pliku transform-tool/input/newphones.csv. (Więcej informacji na temat newphones.csv można znaleźć w sekcji Narzędzie Transform tego artykułu).

Administratorzy partnerów uruchamiają to narzędzie narzędziowe generatora tokenów co najmniej jeden raz przed uruchomieniem narzędzi migracji. Uruchamianie tego narzędzia to jednorazowa czynność po dołączeniu konta partnera do rozwiązania Wholesale RTM. To narzędzie umożliwia administratorom partnerów zalogowanie się za pośrednictwem przeglądarki internetowej, aby uzyskać unikalny TOKEN, który jest potrzebny do aktualizacji do plików konfiguracyjnych partnera dla narzędzi migracji.

Wymagania wstępne

Po pobraniu wyodrębnij pliki binarne narzędzia migracji.

Ustaw ścieżkę środowiska JRE/JDK w token_generator.sh dla MAC i token_generator.bat dla Windows. Jeśli ścieżka JAVA_HOME już istnieje, narzędzie ponownie z niej skorzysta.

• MAC: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Instrukcje dotyczące uruchomienia

Uruchom następujące polecenie w terminalu wewnątrz katalogu generatora tokenów:

Windows:

token_generator.nietoperz

MacOS:

./token_generator.sh

Wyjście:

Nazwa narzędzia: Wersja narzędzia generatora tokenu: 1.13.0 Załaduj adres URL w przeglądarce internetowej: http://localhost:8080 

Otwórz adres URL w przeglądarce internetowej na terminalu, zaloguj się przy użyciu poświadczeń administratora partnera, aby uzyskać TOKEN i skopiować to samo w celu dalszego użycia.

Ilustracje interfejsu użytkownika są przedstawione poniżej w celach informacyjnych:

Ryc. 3: Logowanie do Cisco Webex

Ryc. 4: Okno Poświadczenia

Ryc. 5: Generowanie tokenów

Skonfiguruj następujące kroki przed uruchomieniem narzędzi do przenoszenia wyciągu i urządzenia na wtórnym serwerze BroadWorks.

Włącz łączność OCI-P

Narzędzie do przenoszenia urządzenia komunikuje się z BroadWorks za pomocą poleceń OCI-P, aby włączyć łączność OCI-P, należy wykonać poniższe czynności:

Krok 1: Użyj CLI, aby skonfigurować ustawienia ogólne.

Aby zmienić katalog ustawień ogólnych, uruchom następujące polecenie w CLI:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Uruchom następujące polecenie w CLI, aby uzyskać bieżące ustawienia ogólne:

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

Jeśli ustawienia nie są zgodne z powyższymi, użyj polecenia set , aby ponownie skonfigurować ustawienia.

Krok 2: Użyj CLI, aby skonfigurować serwer proxy OCI.

Zmień katalog na serwer proxy OCI:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Uruchom następujące CLI, aby uzyskać bieżące ustawienia. Powinieneś zobaczyć następujące elementy:

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

Jeśli ustawienia nie są zgodne z powyższymi, użyj polecenia set , aby ponownie skonfigurować ustawienia.

Krok 3: Użyj CLI, aby skonfigurować obsługę administracyjną OCI.

Zmiana katalogu obsługi administracyjnej:

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> Uzyskaj opis adresu ======================== 127.0.0.1 lokalny jako 

Krok 4: Uruchom poniższe polecenie w CLI, aby sprawdzić, czy konfiguracja jest poprawna.

 AS_CLI/Maintenance/ManagedObjects> uzyskać broadworks i sprawdzić, czy wyjście wygląda OK. Poniżej przedstawiono dane wyjściowe próbki: AS_CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== * Serwer: Tożsamość..............: Wersja AS...............: Rel_21.sp1_1.551 Państwo administracyjne..: Odblokowane * Aplikacje: Nazwa Wersja Wdrożony Administracyjny Stan Skuteczny Stan WykonanieAndProvisioning 21.sp1_1.551 prawda odblokowany odblokowany błysk Polityka 21.sp1_1.551 fałszywy odblokowany odblokowany OpenClientServer 21.sp1_1.551 prawda odblokowany odblokowany WebContainer 21.sp1_1.551 prawda odblokowany odblokowany 4 wpisy znaleziono. * Hosted Aplikacje: Nazwa 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 znalezionych wpisów. 

Zweryfikuj wdrożony i aktywny otwarty serwer klienta

Użyj poniższych poleceń, aby wdrożyć i uruchomić Open Client Server na wtórnym serwerze aplikacji, jeśli nie został on wdrożony lub nie został już uruchomiony.

Krok 1: Wdrożenie serwera za pomocą następującego polecenia CLI:

AS_CLI/Maintenance/ManagedObjects> wdrożenie aplikacji OpenClientServer

Krok 2: Uruchom serwer za pomocą tego polecenia:

AS_CLI/Maintenance/ManagedObjects> uruchom aplikację OpenClientServer

Włącz aktywację numerów

Wykonaj następujące polecenia w CLI, aby włączyć aktywację numerów:

Krok 1: Uruchom polecenie zmiany numeru:

AS_CLI> cd SubscriberMgmt/NumberActivation

Krok 2: Uruchom polecenie włączonej aktywacji:

AS_CLI> set dnMode groupAndUserActivationWłączone

Krok 3: Po wyświetleniu monitu z potwierdzeniem wprowadź Y.

Dla BroadCloud

Narzędzie do wyodrębniania jest zintegrowane z portalem dostawcy usług BroadCloud. Administrator dostawcy usług może:

1. Prześlij wnioski o wyodrębnienie dla maksymalnie 50 klientów na żądanie.
   Żądanie wyodrębnienia nie może być złożone dla tego samego klienta więcej niż 10 razy dziennie.
2. Pobierz wyodrębniony plik danych w formacie ZIP, przez maksymalnie 28 dni od daty złożenia wniosku.

Poniższe dane przedstawiają portal dostawcy usług.

Rysunek 6: Portal dostawców usług

Rysunek 7: Portal dostawców usług

Dla Cisco BroadWorks i Webex dla BroadWorks

1. Narzędzie do wyodrębniania działa na pomocniczym serwerze aplikacji Cisco BroadWorks w sieci partnerskiej i łączy się za pośrednictwem OCI-P.
2. Narzędzie pobiera surowe dane korporacyjne, grupowe, numeryczne, użytkowników, usługi, urządzenia i klientów miękkich z platformy Cisco BroadWorks lub BroadCloud i wysyła te dane do plików XML, które dostarczają dane wejściowe do narzędzia transformacji.

W następnych sekcjach wyjaśniono, jak zainstalować i skonfigurować narzędzie ekstrakcji.

Wymagania wstępne

1. SCP wyodrębnij pliki binarne narzędzia do pomocniczego serwera aplikacji Cisco BroadWorks.
2. SSH do wtórnego serwera aplikacji Cisco BroadWorks w celu skonfigurowania wymagań wstępnych i uruchomienia narzędzia ekstrakcji.
3. Skonfiguruj identyfikator dostawcy usług i grupy, aby wyodrębnić go z Cisco BroadWorks w conf/exportTool.yml. Patrz poniższy fragment YAML próbki:

   ServiceProviderID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - WSZYSTKO 

4. Upewnij się, że w pliku conf/partner.cfg pomocniczy identyfikator użytkownika serwera aplikacji Cisco BroadWorks, hasło i nazwa hosta są prawidłowe:

   BROADWORKS_USER_ID = admin BROADWORKS_HASŁO = admin BROADWORKS_HOST_NAZWA = localhost REFRESH_TOKEN = token odświeżania administratora partnera skopiowany z narzędzia Token Generator. TRYB _MIGRACJI = Obsługiwane wartości to webex_for_broadworks_to_wholesale. Wartość domyślna to broadworks_to_wholesale. Użyj webex_for_broadworks_to_wholesale do migracji Webex dla BroadWorks. 

   Właściwość REFRESH_TOKEN jest obowiązkowa w przypadku migracji Webex for BroadWorks.

5. Zmodyfikuj ścieżkę środowiskową JDK/JRE w pliku export.sh, jeśli ścieżka środowiskowa pomocniczego serwera aplikacji Cisco BroadWorks JDK/JRE jest inna niż plik:

   JAVA_HOME=/usr/local/java/java_base

Instrukcje dotyczące uruchomienia

Uruchom poniższe polecenie na pomocniczym serwerze aplikacji Cisco BroadWorks z katalogu narzędzi wyodrębnionych:

./export.sh

Dzienniki terminalu

Następujące dzienniki są dostępne w terminalu po pomyślnym eksporcie: Uruchamiane narzędzie eksportowania danych BroadSoft:

 Uruchamianie narzędzia eksportu danych ************************************************ BroadSoft Rozpoczynanie narzędzia eksportu v: 1.15.0 Eksport rozpoczęty dla SP=collabmigrationtestSP_engg, Grupa=collabmigrationtestGRP_engg Eksportowanie użytkowników dla SP=collabmigrationtestSP_engg, Grupa=collabmigrationtestGRP_engg Eksportowanie użytkowników zakończonych dla SP=collabmigrationtestSP_engg, Grupa=collabmigrationtestGRP_engg Eksport zakończony dla SP=collabmigrationtestSP_engg, Grupa=collabmigrationtestGRP_engg Eksport zakończony Eksport Dump Zip Directory: output/20221017223452_ExportTool Export Dump Zip Nazwa pliku:extracted_data_1666060500618.zip Plik Zip o nazwie extracted_data_1666060500618.zip został utworzony proces tworzenia pliku ZIP zakończony Eksportowane pliki konwertowane jako plik ZIP ************************************************** 

Wyjście

Plik wyjściowy ZIP (extracted_data_.zip) będzie dostępny w tym samym katalogu narzędzi ekstraktu. Użyj poniższego polecenia, aby wyświetlić i użyć pliku ZIP dla wejścia narzędzia Transform:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 paź  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 paź  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 paź  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 paź  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 paź 17 22:34 wyjście/ drwxrwxr-x 2 bwadmin bwadmin 4096 paź 17 22:34 log/ -rw-rw-r-- 1 bwadmin 46341 paź 17 22:35 extracted_data_1666060500618.zip 

To narzędzie przekształcenia jest używane dla wszystkich migracji. Narzędzie transformacji działa na dowolnym komputerze, w tym na laptopie administratora partnera, i korzysta z publicznych interfejsów API Webex. Odczytuje plik wyjściowy narzędzia ekstraktu ZIP (extracted_data_.zip) jako wejście i przekształca surowy XML w format JSON, który jest używany przez narzędzie obsługi administracyjnej.

Wymagania wstępne

Po pobraniu i wyodrębnieniu binariów narzędzi migracji skonfiguruj następujące warunki wstępne:

1. Ustaw REFRESH_TOKEN (Token skopiowany z narzędzia Token Generator) i NAZWĘ__GŁÓWNEJ_LOKALIZACJI w pliku conf/partner.cfg:

   ODŚWIEŻANIE_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAZWA__GŁÓWNEJ_LOKALIZACJI=Główna 

2. Opcjonalnie ustaw identyfikator PROVISIONING_ (skopiowany z szablonu w Partner Hub) w pliku conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Aby uzyskać pełniejszą weryfikację adresu e-mail klienta, można opcjonalnie ustawić identyfikator PROVISIONING_.
3. Skonfiguruj brakujące informacje w pliku input/customers.csv (patrz następna sekcja), jeśli brakuje.
4. Dodaj adres e-mail użytkownika końcowego w pliku input/users.csv.
5. Jeśli mają zostać skonfigurowane nowe telefony, dodaj adres MAC i adres e-mail nowego telefonu użytkownika do pliku input/newphones.csv. Jest to wymagane tylko wtedy, gdy administratorzy partnerów chcą dostarczać nowe telefony w połączeniach hurtowych.
6. Przekształć centra połączeń BroadWorks w CxEssentials, korzystając z pliku input/cxessentials.csv.
7. Opcjonalnie włącz UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, aby przekonwertować wszystkie Centra połączeń na CxEssentials.
8. Użyj pliku input/locations.csv, aby obsługiwać migrację dużych przedsiębiorstw, która umożliwia administratorom migrację lokalizacji klientów według lokalizacji
9. Opcjonalnie włącz użycie adresów MAC z nagłówka User-Agent w komunikacie SIP REGISTER, gdy adres MAC nie jest dostępny w profilu urządzenia Cisco BroadWorks. Odkomentuj wiersz „UŻYJ_ADRESU MAC__Z_SIP_REGISTER=yes” w pliku conf/partner.cfg

Napełnianie wejścia/customers.csv

Plik input/customers.csv zawiera dane, których być może brakuje w Cisco BroadWorks lub BroadCloud. Ten plik może być pusty, jeśli wszystkie obowiązkowe informacje są już dostępne. Nie musisz wpisywać wszystkich kolumn, tylko brakujące informacje są obowiązkowe.

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

Instrukcje dotyczące uruchomienia

Uruchomić narzędzie Transform w dowolnym systemie operacyjnym. Aby uruchomić narzędzie w systemie Windows i macOS, wykonaj poniższe czynności:

Windows

Wykonaj poniższe polecenie, aby uruchomić narzędzie Transform w systemie Windows:

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

macOS

Wykonaj następujące kroki, aby uruchomić narzędzie transformacji w systemie macOS:

1. Tworzenie wirtualnego środowiska i zależności od instalacji, aby uruchomić narzędzie transformacji przy użyciu Pythona:

   python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. Uruchom narzędzie transformacji:

   ./transform.sh -extract= -customers= -users= -newphones=

Wstępna kontrola klienta/użytkownika

Narzędzie Transform powoduje, że API dzwoni do Webex w celu wykrycia potencjalnych problemów z obsługą administracyjną. Domyślnie zweryfikuje on adres klienta i główny adres e-mail. Jeśli wartość identyfikatora PROVISIONING_ID jest określona w pliku conf/partner.cfg, zweryfikuje również informacje o lokalizacji. Wyniki kontroli wstępnej znajdują się w raporcie dotyczącym wyjątków.

Dodatkowo przy uruchamianiu narzędzia transformacji można dodać następujące opcjonalne parametry:

wstępne sprawdzenie

Oprócz uruchomienia interfejsu API wstępnego sprawdzenia informacji o kliencie, narzędzie Transform uruchomi również interfejs API wstępnego sprawdzenia wiadomości e-mail subskrybenta.

informacje wstępne

Domyślnie w raporcie o wyjątkach znajdują się tylko błędy sprawdzania wstępnego (tj. problemy, które zablokują inicjowanie obsługi). Dodanie tej flagi będzie również zawierało pomyślne wyniki sprawdzenia wstępnego (np. jeśli istnieje już organizacja Webex, którą można automatycznie załączyć).

Dzienniki terminalu

Następujące dzienniki w terminalu podczas pomyślnej transformacji:

Raport podsumowujący przedsiębiorstwa BroadWorks, które mogą zostać pomyślnie zmigrowane: 1 Przedsiębiorstwa BroadWorks, które nie mogą zostać przeniesione: 0 użytkowników BroadWorks, którzy mogą zostać pomyślnie migrowani: 4 użytkowników BroadWorks, których nie można migrować: 0 Telefonów, które można pomyślnie migrować: 3 telefony niezgodne z usługą Webex Calling: 0 

Raport o wyjątkach

Narzędzie Transform generuje raport o wyjątkach wewnątrz katalogu output//exception_report.txt . Ten raport można wykorzystać do zidentyfikowania problemów, które wpłyną na migrację, i naprawić je w systemie Cisco BroadWorks.

Po zmodyfikowaniu danych użytkownika w celu rozwiązania wyjątku ponownie uruchom narzędzia Extract and Transform z nowymi danymi. Przykładowy plik raportu z wyjątkiem:

Raport o wyjątkach październik 18 08:12:09 2022 Przedsiębiorstwa z zaleceniem funkcji zakazu komunikacji: ręcznie skonfiguruj plan połączeń wychodzących w programie Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Wyjście

Plik wyjściowy JSON (customer.json) będzie dostępny w katalogu output// . Przykładowy plik customer.json jest następujący:

{"klient": {"provisioningId": "!!!!!!!!!!ZAMIEŃ_DZIĘKI_PROVISIONINGID!!!!!!!!!!", "pakiety": [ "webex_calling", "common_area_calling" ], "externalId":external_id_engg_grp1", "adres": {"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/N"ew_York", "język": "en_us", "numery": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "numer główny": "+15205551101" } } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "abonenci": [ { "amareswaranvel+benjaminjack@gmail.com": {"abonent": {"customerId": "!!!!!!!!!!ZAMIEŃ_DZIĘKI_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "pakiet": "webex_calling", "provisioningParameters": {"firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": {"enabled": true, "sendBusyCalls": {"włączony": true, "greeting": "DEFAULT" }, "sendUnanswer edCall": {"enabled": prawda, "powitanie": "DOMYŚLNIE", "numberOfRings": 3 }, „messageStorage”: {„mwiEnabled” (Włączone): 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": {"włączony": true, "greeting": "DEFAULT" }, "sendUnanswer edCall": {"enabled": prawda, "powitanie": "DOMYŚLNIE", "numberOfRings": 3 }, „messageStorage”: {„mwiEnabled” (Włączone): 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": {"włączony": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": {"enabled": prawda, "powitanie": "DOMYŚLNIE", "numberOfRings": 3 }, „messageStorage”: {„mwiEnabled” (Włączone): 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": {"włączony": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": {"enabled": prawda, "powitanie": "DOMYŚLNIE", "numberOfRings": 3 }, „messageStorage”: {„mwiEnabled” (Włączone): true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ {"cisUuid": "!!!!!!!!!!REPLACE_DZIĘKI_PERSONID!!!!!!!!!!", "produkt": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } }], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "harmonogramy": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ {"name": "Automated Voice Portal", "firstName": "Automated", "lastName": "Voice Portal", "languageCode": "en_us", "numer telefonu": "+15205551105", "numer wewnętrzny": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "lokalizacje": [], "webex_for_broadworks_info": {"użytkownicy": [ {"id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Narzędzie obsługi administracyjnej może działać na dowolnej maszynie, zazwyczaj na laptopie administratora partnera, i korzysta z publicznych interfejsów API Webex. Odczytuje plik JSON (customer.json) jako dane wejściowe i udostępniające 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ędzi obsługi administracyjnej:

1. Zainstaluj Java 8, 11 lub 17 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://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Po pobraniu i ekstrakcji binariów narzędzi migracji ustaw zmienną środowiskową JAVA_HOME w pliku provisioning_tool.sh dla MAC i provisioning_tool.bat dla systemu Windows.
3. Plik partner.cfg:
   • Ustaw identyfikator_PROVISIONING_i ODŚWIEŻYĆ_TOKEN (Token skopiowany z narzędzia Generator tokenu). Administratorzy partnera muszą skontaktować się z zespołem ds. kont, aby uzyskać _identyfikator PROVISIONING:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Ustaw POZWÓL_ADMIN_INVITE_EMAILS na fałszywe, jeśli partner nie chce wysyłać powitalnej wiadomości e-mail do użytkowników. Wartość domyślna jest prawdziwa.

4. Użyj właściwości _E-MAIL_WEBEX4BWKS dla migracji Webex for BroadWorks, aby wysłać wiadomość e-mail z żądaniem zmiany hasła dla subskrybentów Webex for BroadWorks.
5. Użyj właściwości WEBEX4BWKS_E-MAIL_CIDY dla migracji Webex for BroadWorks, aby wysłać korpus e-mail żądania zmiany hasła dla subskrybentów Webex for BroadWorks.

W przypadku migracji BroadCloud w tym samym regionie:

1. Narzędzie pominie numery, urządzenia i inicjowanie obsługi administracyjnej połączeń wspólnych.
2. Narzędzie utworzy użytkowników i użytkowników wirtualnych z rozszerzeniem i rozszerzeniem tymczasowym.

W przypadku migracji BroadCloud inny region:

1. Narzędzie udostępnia numery, urządzenia i wyświetlanie wspólnych połączeń.
2. Narzędzie umożliwia tworzenie użytkowników i użytkowników wirtualnych z rzeczywistymi numerami telefonów i numerami wewnętrznymi.
   Wszystkie migracje do BroadCloud w Europie są do innego regionu.

Instrukcje dotyczące uruchomienia

Aby uruchomić narzędzie w systemie Windows i macOS, wykonaj poniższe czynności:

Windows

Wykonaj następujące kroki, aby uruchomić narzędzie w systemie operacyjnym Windows:

Aby zapewnić pojedynczego klienta: provision.bat -input= Aby dostarczyć wielu klientów: provision.bat -input= 

macOS

Wykonaj następujące kroki, aby uruchomić narzędzie w systemie macOS:

Aby dostarczyć jednego klienta: ./transform.sh -input= Aby dostarczyć wielu klientów: ./transform.sh -input= 

Wymagania wstępne dla Webex dla migracji BroadWorks

Administratorzy partnerów muszą zaktualizować szablon wdrażania BroadWorks dla funkcji współistnienia Webex dla BroadWorks. Patrz na poniższy obrazek:

Uruchom narzędzie obsługi administracyjnej z dodatkowym argumentem dla Webex dla BroadWorks do migracji hurtowej.

Faza przygotowania: jest fazą domyślną, w której Administratorzy mogą udostępniać użytkowników BroadWorks jako subskrybenta hurtowego i kontynuować korzystanie z Webex dla użytkowników BroadWorks.

Faza podtrzymywania: to druga faza, w której Administratorzy mogą przypisać licencję hurtową istniejącym użytkownikom Webex dla BroadWorks. Należy uruchomić narzędzie obsługi administracyjnej z argumentem konserwacja.

Faza po migracji: To ostatnia faza, w której Administratorzy mogą całkowicie przekonwertować BroadWorks na Wholesale. Należy uruchomić narzędzie obsługi administracyjnej z argumentem postmigration.

Dzienniki terminalu

Poniżej znajdują się dzienniki w terminalu podczas pomyślnej obsługi administracyjnej:

Nazwa narzędzia: Wersja narzędzia konfiguracji: 1.15.0 ********** Rozpoczęty plik przetwarzania: input/customer.json **************** Provisioning Customer Waiting for customer external_id_engg_grp1 to complete provisioning... Oczekiwanie na zakończenie inicjowania obsługi klienta external_id_engg_grp1...   Status klienta external_id_engg_grp1: Provisioned Provisioning Numbers Provisioning Users Provisioning User Features Provisioning Greetings 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 ********** Ukończony plik: input/customer.json **************** 

Tabela zostanie wydrukowana z liczbą lokalizacji utworzonych dla każdego przebiegu:

Wyjście

Narzędzie Provisioning generuje raporty o sukcesach i błędach wewnątrz plików output/<external_id>/*.success/error . Przejrzyj dzienniki wyników i błędów, aby zweryfikować pomyślną obsługę administracyjną.

Administratorzy partnerów mogą zweryfikować obsługę administracyjną klienta w portalu Partner Hub i Control Hub. Zapoznaj się z następującymi ilustracjami z portalu Partner Hub i Control Hub:

Rysunek 8: Centrum partnerów

Rysunek 9: Control Hub

Rysunek 10: Urządzenia

Rysunek 11: Dzwonienie

Dla BroadCloud

W przypadku partnerów BroadCloud skorzystaj z portalu dostawcy usług, aby przesłać żądanie migracji numerów, urządzeń i migracji SCA.

W portalu usługodawcy żądanie migracji może obejmować maksymalnie 50 klientów. W ciągu jednego dnia można złożyć maksymalnie 10 wniosków.

Poniższe dane przedstawiają portal dostawcy usług.

Rysunek 12: Portal dostawców usług

Rysunek 13: Portal dostawców usług

Dla Cisco BroadWorks i Webex dla BroadWorks

W przypadku migracji Cisco BroadWorks i Webex for BroadWorks narzędzie działa na pomocniczym serwerze aplikacji Cisco BroadWorks w sieci partnerskiej i łączy się z systemem AS za pośrednictwem OCI-P. Jako dane wejściowe wykorzystuje plik JSON (customer.json) narzędzia Transform Tool i wykonuje polecenia OCI-P w celu migracji urządzeń i klientów miękkich.

Po pomyślnym uruchomieniu narzędzie do przenoszenia urządzenia:

1. Wyrejestruj urządzenia z Cisco BroadWorks i zarejestruj je w hurtowni.
2. Użytkownicy korzystający z klienta UC-One przekierują się do aplikacji Webex po pierwszym zalogowaniu.
3. Dezaktywuj numery telefonów w usłudze Cisco BroadWorks lub usuń numery telefonów z usługi BroadCloud.
4. Aktywuj numery w sprzedaży hurtowej.
5. Utwórz udostępnione wystąpienia połączeń w sprzedaży hurtowej dla migracji BroadCloud. [Ten krok dotyczy tylko migracji BroadCloud].

SCP i SSH

1. SCP narzędzie do przenoszenia urządzenia do wtórnego serwera aplikacji Cisco BroadWorks.
2. SSH do wtórnego serwera aplikacji Cisco BroadWorks w celu skonfigurowania warunków wstępnych i uruchomienia narzędzia do przenoszenia urządzenia.

Wymagania wstępne

1. Ustaw REFRESH_TOKEN (Token skopiowany z narzędzia Generator Token) w pliku conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Upewnij się, że pomocniczy identyfikator użytkownika serwera aplikacji Cisco BroadWorks, hasło i nazwa hosta są prawidłowe w pliku conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin BROADWORKS_HASŁO = admin BROADWORKS_HOST_NAZWA = localhost 

3. Sprawdź, czy ścieżka środowiskowa JDK/JRE jest prawidłowa w devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. Administratorzy mogą używać pliku locations.csv z katalogu wejściowego do migracji określonych grup zamiast wszystkich grup w ramach przedsiębiorstwa.

Telefony Polycom

Aby przenieść telefony Polycom z Cisco BroadWorks do połączeń hurtowych, administrator partnera musi utworzyć nowy plik typu profilu tożsamości/urządzenia na poziomie systemu w każdym szablonie urządzenia Polycom Cisco BroadWorks. Zapoznaj się z rysunkiem 14 i prześlij niestandardowy plik pliku device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Po przesłaniu nowego pliku urządzenia upewnij się, że 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:

1. Narzędzie do przenoszenia urządzenia zastępuje plik %BWMACADDRESS%.cfg na poziomie urządzenia za pomocą polycom_vvx2.cfg. Należy pamiętać, że ten plik odnosi się do migration_%BWMACADDRESS%.cfg.
2. Ponownie zbuduj profile urządzenia 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ądzenia prosi serwer aplikacji Cisco BroadWorks o ponowne uruchomienie telefonów na poziomie grupy lub na poziomie urządzenia.
4. Po żądaniu ponownego uruchomienia telefony Polycom pobierają i przetwarzają% BWMACADDRESS%.cfg, który prosi telefony Polycom o pobranie i przetwarzanie migration_%BWMACADDRESS%.cfg, który ustawia nazwę urządzenia.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com dla regionu USA inne regiony mają różne adresy URL.
5. Telefon Polycom pobiera %BWMACADDRESS%.cfg z https://plcm.sipflash.com i będzie zarządzany przez Webex Calling DMS.

Rysunek 14: Dodano plik typu Tożsamość/profil urządzenia

Instrukcje dotyczące uruchomienia

Istnieją dwa sposoby wywoływania DMT, pierwszy to wywoływanie przez jednego klienta naraz, a drugi to uruchamianie przez wielu klientów jednocześnie.

Narzędzie do przenoszenia urządzenia jest uruchamiane z pomocniczego serwera aplikacji Cisco BroadWorks wewnątrz katalogu narzędzi do przenoszenia urządzenia:

Do przenoszenia urządzenia pojedynczy klient: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Do przenoszenia urządzenia wielu klientów: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Ponadto narzędzie do przenoszenia urządzenia obsługuje migrację pojedynczych/konkretnych telefonów z wersji 1.35.0. Użyj polecenia poniżej: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Dzienniki terminalu

Poniżej znajdują się dzienniki w terminalu po pomyślnym uruchomieniu narzędzia do przenoszenia urządzenia do migracji urządzenia:

Nazwa narzędzia: Wersja narzędzia do przenoszenia urządzenia: 1.15.0 Uruchamiane narzędzie urządzenia... Prawidłowe urządzenia do migracji: ------------------------------------------------------------------------------------------------------------------- | Typ urządzenia | Mac | Wersja | E-mail | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Czy chcesz dokonać migracji wszystkich tych urządzeń? ([Y]es lub [N]o) tak Przesyłanie profilów urządzeń dla DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Completed Successfully Reboot Process Startted Reboot Process Completed Successful Modifying profiles for Business Communicator under group collabmigrationGRP_engg Aktywuj proces numerów telefonów webex dla identyfikatora organizacji klienta: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktywuj proces numerów telefonów Webex zakończony dla identyfikatora organizacji klienta: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Rozpoczął się proces dezaktywacji numerów telefonów szerokopasmowych dla groupId: collabmigrationtestGRP_engg Dezaktywuj zakończony proces numerów telefonów szerokopasmowych dla funkcji groupId: collabmigrationtestGRP_engg Migracja urządzeń zakończona 

Wyjście

Po migracji urządzenia urządzenia są dostępne online i gotowe do nawiązywania/odbierania połączeń. Aby zobaczyć przykład stanu urządzenia, patrz rysunek 15:

Rysunek 15: Stan urządzenia

Po migracji urządzenia numery są aktywne. Aby zobaczyć przykład numerów aktywnych, patrz rysunek 16:

Rysunek 16: Numery aktywne

Operacja cofania musi być wykonywana dla jednego przedsiębiorstwa naraz.

Dla BroadCloud Carrier

Proces odwracania dla partnerów BroadCloud jest następujący:

1. Otwórz zgłoszenie za pomocą Cisco TAC, aby poprosić o przywrócenie urządzenia.
2. Uruchom narzędzie do przenoszenia urządzenia w trybie przywracania:
   • Numery telefonów zostaną nieprzypisane z usługi Webex Calling, pozostawiając użytkowników i usługi tylko z numerami wewnętrznymi.
   • Adresy e-mail w usłudze Webex Calling zostaną przywrócone do tymczasowych adresów e-mail.
   • Telefony zostaną usunięte z usługi Webex Calling.
   • Numery telefonów, adresy e-mail używane jako alternatedIds i telefony 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 dla BroadWorks jest następujący:

1. Otwórz zgłoszenie za pomocą Cisco TAC, aby poprosić o przywrócenie urządzenia.
2. Uruchom narzędzie do przenoszenia urządzenia w trybie przywracania na wtórnym serwerze aplikacji BroadWorks, aby przywrócić migracje urządzenia. Spowoduje to przywrócenie adresu URL DMS do adresu URL dostawcy usług DMS dla profili urządzeń w Cisco BroadWorks i ponowne aktywowanie numerów telefonów.
3. Zespół Webex Calling ustawia adres URL DMS z powrotem na adres URL dostawcy usług DMS w profilach urządzeń w Webex Calling.
4. Administratorzy partnerów muszą dezaktywować lub usunąć numery telefonów w 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ądzenia w trybie przywracania

Wykonaj poniższe czynności, aby uruchomić narzędzie do przenoszenia urządzenia w trybie przywracania:

Uruchom poniższe polecenie na pomocniczym serwerze aplikacji Cisco BroadWorks w katalogu narzędzi do przenoszenia urządzenia:

Przywróć profile

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Przywróć numery

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

Dzienniki terminalu

Po pomyślnym uruchomieniu narzędzia do przenoszenia urządzenia w celu przywrócenia pracy uzyskamy następujące dzienniki w terminalu:

Przywróć profile

Nazwa narzędzia: Wersja narzędzia do przenoszenia urządzenia: 1.15.0 Narzędzie urządzenia uruchomione dla procesu przywracania... Urządzenia, które można przenieść z usługi Webex Calling do BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Typ urządzenia | Mac | Wersja | e-mail | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Czy chcesz przenieść te urządzenia z usługi Webex Calling do BroadWorks? (Tak, Y, Nie, N):  tak Przesyłanie profili urządzeń dla DMS Cisco MPP LC Przebudowa procesu urządzenia Rozpoczęta przebudowa procesu urządzenia zakończona pomyślnie Ponowne uruchomienie procesu rozpoczętego Ponowne uruchomienie procesu zakończona pomyślnie migracja urządzenia zakończona w procesie rozrachunku 

Przywróć numery

Nazwa narzędzia: Wersja narzędzia do przenoszenia urządzenia: 1.15.0 Czy chcesz kontynuować przywracanie numerów do Broadworks?  ([Y]es lub [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Rozpoczęcie przywracania Aktywacja numerów telefonów szerokopasmowych rozpoczęto proces dla groupId: collabmigrationGRP_engg Aktywuj rozszerzone numery telefonów ukończone dla groupId: collabmigrationtestProces przywracania migracji_engg urządzenia GRP zakończony pomyślnie