Obsługiwane telefony będą automatycznie tworzone i przypisywane do użytkowników w Webex Calling za pomocą narzędzia obsługi administracyjnej. Telefony oznaczone jako „tak” w kolumnie „Obsługiwane w narzędziu do przenoszenia urządzeń” zostaną również automatycznie przeniesione z usługi Cisco BroadWorks lub BroadCloud do Webex Calling po uruchomieniu narzędzia do przenoszenia urządzeń. Telefony oznaczone w tej kolumnie „Nie” wymagają ręcznej interwencji, aby zmienić adres 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. (Zobacz sekcję Narzędzie przekształcania w tym artykule, aby uzyskać więcej informacji na temat pliku newphones.csv).

Administratorzy partnerów uruchamiają to narzędzie generatora tokenów co najmniej raz przed rozpoczęciem uruchamiania narzędzi migracji. Uruchomienie tego narzędzia jest działaniem jednorazowym po włączeniu konta partnera do rozwiązania Wholesale RTM. To narzędzie umożliwia administratorom partnerów logowanie się za pośrednictwem przeglądarki internetowej w celu uzyskania unikatowego TOKENA, który jest wymagany do aktualizacji 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 polach token_generator.sh dla MAC i token_generator.bat dla Windows. Jeśli ścieżka JAVA_HOME już istnieje, zostanie użyta ponownie przez narzędzie.

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

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

Instrukcje uruchamiania

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

Windows:

token_generator.nietoperz

System 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, a następnie skopiuj go do dalszego użycia.

Poniżej przedstawiono ilustracje interfejsu użytkownika:

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

Ryc. 4: Okno poświadczeń

Ryc. 5: Generowanie tokenu

Przed uruchomieniem narzędzia wyodrębniania i przenoszenia urządzeń na pomocniczym serwerze BroadWorks skonfiguruj następujące czynności.

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, wykonaj poniższe czynności:

Krok 1: Użyj interfejsu wiersza polecenia, aby skonfigurować ustawienia ogólne.

Uruchom następujące polecenie w interfejsie wiersza polecenia, aby zmienić katalog GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Aby uzyskać bieżące ustawienia GeneralSettings, uruchom następujące polecenie w CLI:

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

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

Krok 2: Użyj interfejsu wiersza polecenia, aby skonfigurować serwer proxy OCI.

Zmień katalog na Proxy OCI:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Aby pobrać bieżące ustawienia, uruchom następujący interfejs wiersza polecenia. Powinny być widoczne następujące elementy:

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enableResponseBuforowanie = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 wiadomościKolejkaPojemność = 50 wiadomościKolejkaTimeoutS = 1800 

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

Krok 3: Użyj interfejsu wiersza polecenia, aby skonfigurować obsługę OCI.

Zmiana w katalogu obsługi administracyjnej:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Aby uzyskać aktualne ustawienia obsługi OCI, uruchom następujące polecenie:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> uzyskaj opis adresu 127.0.0======================== .1 lokalnie jako 

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

 AS_CLI/Maintenance/ManagedObjects> pobierz BroadWorks i sprawdź, czy wyjście wygląda poprawnie. Poniżej znajdują się przykładowe dane wyjściowe: AS_CLI/Maintenance/ManagedObjects> pobierz obiekty zarządzane BroadWorks ========================== * Serwer: Tożsamość..............: Wersja JAKO...............: Rel_21.sp1_1.551 Stan administracyjny..: Odblokowane * aplikacje: Nazwa Wersja Wdrożony stan administracyjny Skuteczny stan ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked FlashPolicy 21.sp1_1.551 false Unlocked Zatrzymano OpenClientServer 21.sp1_1.551 true Unlocked Unlocked WebContainer 21.sp1_1.551 true Unlocked Unlocked Znaleziono 4 wpisy. * Obsługiwane aplikacje: Nazwa Wersja Ścieżka kontekstowa Wdrożona ================================================================== 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 klienta został wdrożony i aktywny

Użyj poniższych poleceń, aby wdrożyć i uruchomić serwer klienta na pomocniczym serwerze aplikacji, jeśli nie został on wdrożony lub jeszcze się nie uruchomił.

Krok 1: Wdróż serwer za pomocą następującego polecenia CLI:

AS_CLI/Maintenance/ManagedObjects> wdróż aplikację OpenClientServer

Krok 2: Uruchom serwer za pomocą następującego polecenia:

AS_CLI/Maintenance/ManagedObjects> uruchom aplikację OpenClientServer

Włącz aktywację numerów

Aby włączyć aktywację numerów, wykonaj następujące polecenia w interfejsie wiersza polecenia:

Krok 1: Uruchom polecenie aktywacji numeru:

AS_CLI> cd SubscriberMgmt/NumberActivation

Krok 2: Uruchom polecenie z włączoną aktywacją:

AS_CLI> ustaw dnMode groupAndUserActivationEnabled

Krok 3: Po wyświetleniu monitu potwierdzającego wprowadź literę Y.

Dla usługi BroadCloud

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

1. Prześlij żądania wyodrębnienia do 50 klientów na zgłoszenie.
   Żądania wyodrębnienia nie można przesłać 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 przesłania żądania.

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

Rysunek 6: Portal dostawcy usług

Rysunek 7: Portal dostawcy usług

Dla Cisco BroadWorks i Webex dla BroadWorks

1. Narzędzie wyodrębniania jest uruchamiane na pomocniczym serwerze aplikacji Cisco BroadWorks w sieci partnerskiej i łączy się przez OCI-P.
2. Narzędzie pobiera surowe dane przedsiębiorstwa, grupy, numerów, użytkowników, usług, urządzeń i klienta programowego z platformy Cisco BroadWorks lub BroadCloud i wysyła te dane do plików XML, które dostarczają dane wejściowe narzędzia przekształcenia.

W kolejnych sekcjach wyjaśniono, jak zainstalować i skonfigurować narzędzie wyodrębniania.

Wymagania wstępne

1. SCP narzędzia wyodrębniania binariów na pomocniczy serwer aplikacji Cisco BroadWorks.
2. Aby skonfigurować wymagania wstępne i uruchomić narzędzie wyodrębniania, należy przesłać żądanie SSH do pomocniczego serwera aplikacji Cisco BroadWorks.
3. Skonfiguruj dostawcę usług i identyfikator grupy, które mają być wyodrębnione z usługi Cisco BroadWorks w pliku conf/exportTool.yml. Zapoznaj się z poniższym przykładowym fragmentem YAML:

   Identyfikator dostawcy usług:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - wszystkie 

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = token odświeżania administratora partnera skopiowany z narzędzia Generator tokenów. MIGRATION_TRYB = 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 usługi Webex dla BroadWorks. 

   Właściwość ODŚWIEŻ_TOKEN jest obowiązkowa w przypadku migracji Webex dla BroadWorks.

5. Zmodyfikuj ścieżkę środowiska JDK/JRE w pliku export.sh, jeśli pomocnicza ścieżka środowiska JDK/JRE serwera aplikacji Cisco BroadWorks jest inna niż w pliku:

   JAVA_HOME=/usr/local/java/java_base

Instrukcje uruchamiania

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

./export.sh

Dzienniki terminalu

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

 Uruchamianie narzędzia eksportu danych BroadSoft ************************************************ Rozpoczynanie narzędzia eksportu v: 1.15.0 Rozpoczęto eksportowanie dla SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksportowanie użytkowników dla SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksportowanie użytkowników ukończone dla SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport ukończony dla SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Eksport ukończony Katalog Zip Zrzut eksportu: output/20221017223452_ExportTool Nazwa pliku zip zrzutu eksportu:extracted_data_1666060500618.zip Plik zip o nazwie extracted_data_1666060500618.zip został utworzony proces tworzenia pliku ZIP zakończony. Wyeksportowane pliki przekonwertowane jako plik ZIP ************************************************** 

Wyjście

Wyjściowy plik ZIP (extracted_data_.zip) będzie dostępny w tym samym katalogu narzędzia wyodrębniania. Użyj poniższego polecenia, aby wyświetlić i użyć pliku ZIP do wejścia narzędzia przekształcenia:

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 dzienniki/ -rw-rw-r-- 1 bwadmin bwadmin 46341 paź 17 22:35 extracted_data_1666060500618.zip 

To narzędzie transformacji jest uruchamiane dla wszystkich migracji. Narzędzie przekształcenia działa na dowolnym komputerze, w tym na laptopie administratora partnera, i korzysta z publicznych interfejsów API Webex. Odczytuje plik ZIP wyjściowego narzędzia wyodrębniania (extracted_data_.zip) jako dane wejściowe i przekształca surowy kod XML na format JSON 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 wymagania wstępne:

1. Ustaw_TOKEN ODŚWIEŻANIA (token skopiowany z narzędzia generatora tokenów) i NAZWĘ_GŁÓWNEJ__LOKALIZACJI w pliku conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main 

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Aby uzyskać bardziej kompletną weryfikację adresu e-mail klienta, można opcjonalnie ustawić identyfikator INICJOWANIA_ obsługi.
3. W przypadku ich braku skonfiguruj brakujące informacje w pliku input/customers.csv (patrz następna sekcja).
4. Dodaj adres e-mail użytkownika końcowego w pliku input/users.csv.
5. Aby zainicjować obsługę administracyjną nowych telefonów, 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ą skonfigurować nowe telefony w usłudze Wholesale.
6. Przekonwertuj centra połączeń BroadWorks na CxEssentials za pomocą pliku input/cxessentials.csv.
7. Opcjonalnie włącz właściwość UAKTUALNIJ_WSZYSTKIE_CENTRA_POŁĄCZEŃ_DO_CX_ESSENTIALS, aby przekonwertować wszystkie centra połączeń na CxEssentials.
8. Użyj pliku input/locations.csv do obsługi migracji dużych przedsiębiorstw, która umożliwia administratorom migrację lokalizacji klientów według lokalizacji
9. Opcjonalnie włącz korzystanie z 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. Usuń komentarz do wiersza „UŻYJ ADRESU_MAC_Z__SIP_REGISTER=yes” w pliku conf/partner.cfg

Wypełnianie danych wejściowych/customers.csv

Plik input/customers.csv zawiera dane, których być może brakuje w usłudze 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 są tylko brakujące informacje.

W poniższej tabeli wyjaśniono najważniejsze kolumny w pliku input/customers.csv.

Instrukcje uruchamiania

Uruchom narzędzie przekształcania 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 przekształcenia w systemie Windows:

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

macOS

Aby uruchomić narzędzie przekształcenia w systemie macOS, wykonaj następujące czynności:

1. Tworzenie środowiska wirtualnego i instalowanie jego zależności w języku Python:

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

2. Uruchom narzędzie przekształcenia:

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

Sprawdzenie wstępne klienta/użytkownika

Narzędzie Transform nawiązuje połączenia interfejsu API z usługą Webex, aby wychwycić potencjalne problemy z aprowizacją. Domyślnie sprawdzi to adres i podstawowy adres e-mail klienta. Jeśli w pliku conf/partner.cfg podano wartość identyfikatora_obsługi administracyjnej, zweryfikuje on również informacje o lokalizacji. Wyniki sprawdzenia wstępnego są uwzględniane w raporcie wyjątku.

Dodatkowo podczas uruchamiania narzędzia przekształcenia można dodać następujące opcjonalne parametry:

sprawdzenie wstępne

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

wstępne checkinfo

Domyślnie w raporcie wyjątku są uwzględniane tylko błędy sprawdzenia wstępnego (tj. problemy, które zablokują obsługę administracyjną). Dodanie tej flagi spowoduje również pomyślne wyniki wstępnego sprawdzania (np. jeśli istnieje już organizacja Webex, którą można dołączyć automatycznie).

Dzienniki terminalu

Następujące dzienniki w terminalu po pomyślnym przekształceniu:

Raport podsumowujący przedsiębiorstwa BroadWorks, które z powodzeniem można migrować: 1 przedsiębiorstwa BroadWorks, których nie można migrować: 0 użytkowników BroadWorks, których można pomyślnie zmigrować: 4 użytkowników BroadWorks, których nie można migrować: 0 telefonów, które można pomyślnie zmigrować: 3 telefony, które nie są zgodne z Webex Calling: 0 

Raport wyjątku

Narzędzie Transform generuje raport wyjątku w katalogu output//exception_report.txt . Za pomocą tego raportu można zidentyfikować problemy, które będą miały wpływ na migrację, oraz naprawić je w systemie Cisco BroadWorks.

Po zmodyfikowaniu danych użytkownika w celu rozwiązania wyjątku uruchom ponownie narzędzia wyodrębniania i przekształcania z nowymi danymi. Przykładowy plik raportu o wyjątku jest następujący:

Raport wyjątku 18 października 08:12:09 2022 Przedsiębiorstwa z rekomendacją funkcji blokady komunikacji: ręcznie skonfiguruj plan połączeń wychodzących w Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Wyjście

W katalogu output// będzie dostępny wyjściowy plik JSON (customer.json). Przykładowy plik customer.json wygląda następująco:

{ „klient”: { „provisioningId”: "!!!!!!!!!!ZAMIEŃ_z_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": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "location": { "name": "Main", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "Ameryka/New_York", "język": "en_us", "numery": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } }, "broadworks_info„: {”service_provider_id": "collabmigrationtestSP_engg„, ”group_id": "collabmigrationtestGRP_engg" }, "subskrybentów": [ { "amareswaranvel+benjaminjack@gmail.com": { "subskrybent": { "customerId": "!!!!!!!!!!ZAMIEŃ_z_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "pakiet": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "funkcje": [{"/v1/people/{personId}/features/voicemail": { "włączone": true, „sendBusyCalls”: { „enabled”: true, "powitanie": "DOMYŚLNE" }, "sendUnansweredCalls": { "enabled": true, "powitanie": "DOMYŚLNE", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_Z_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_Z_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "pakiet": "webex_calling", "provisioningParameters": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [{ "/v1/people/{personId}/features/voicemail": { "enabled": true, „sendBusyCalls”: { „enabled”: true, "powitanie": "DOMYŚLNE" }, "sendUnansweredCalls": { "enabled": true, "powitanie": "DOMYŚLNE", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_Z_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_Z_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "pakiet": "webex_calling", "provisioningParameters": { "firstName": "Leo", "lastName": "Jackson", "primaryPhoneNumber": "+15205551104", "extension": "1104" } }, "funkcje": [{ "/v1/people/{personId}/features/voicemail": { "enabled": true, „sendBusyCalls”: { „enabled”: true, "powitanie": "DOMYŚLNE" }, "sendUnansweredCalls": { "enabled": true, "powitanie": "DOMYŚLNE", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_Z_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "pakiet": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "features": [{ "/v1/people/{personId}/features/voicemail": { "enabled": true, „sendBusyCalls”: { „enabled”: true, "powitanie": "DOMYŚLNE" }, "sendUnansweredCalls": { "enabled": true, "powitanie": "DOMYŚLNE", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_z_PERSONID!!!!!!!!!!", „produkt”: „DMS Cisco 8811”, „mac”: „F87B204E4066” } ] } } ], „auto_attendants": [], "call_queues": [], "hunt_groups": [], "harmonogramy": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals„: [{ „nazwa”: „Zautomatyzowany portal głosowy”, „imię”: „Zautomatyzowany”, „nazwisko”: „Portal głosowy”, „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": [], "lokalizacje": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgIdentyfikator": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Narzędzie obsługi administracyjnej może być uruchomione na dowolnym komputerze, zwykle na którym jest komputer (laptop administratora partnera) i korzysta z publicznych interfejsów API Webex. Odczytuje on plik JSON narzędzia przekształcenia (customer.json) jako dane wejściowe i dostarczanie klientów, lokalizacji, numerów, użytkowników, usług i urządzeń w rozwiązaniu Webex Wholesale RTM.

Wymagania wstępne

Skonfiguruj następujące wymagania wstępne w katalogu narzędzia obsługi administracyjnej:

1. Zainstaluj oprogramowanie 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 wyodrębnieniu binariów narzędzi migracji ustaw zmienną środowiska JAVA_HOME w polach provisioning_tool.sh dla MAC i provisioning_tool.bat dla Windows.
3. Plik partner.cfg:
   • Ustaw identyfikator WHOLESALE_PROVISIONING_ i ODŚWIEŻ TOKEN_ (token skopiowany z narzędzia generatora tokenów). Administratorzy partnerów muszą skontaktować się z zespołem swojego konta, aby uzyskać identyfikator INICJOWANIA_obsługi administracyjnej:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Ustaw wartość ZEZWALAJ NA WIADOMOŚCI E-MAIL Z ZAPROSZENIEM_ADMINISTRATORA_NA_fałsz, jeśli partner nie chce wysyłać powitalnej wiadomości e-mail do użytkowników. Wartość domyślna to prawda.

4. Użyj właściwości TEMAT WEBEX4BWKS_EMAIL_dla migracji Webex for BroadWorks, aby wysłać temat wiadomości e-mail żądania zmiany hasła dla subskrybentów Webex for BroadWorks.
5. Użyj właściwości TREŚCI WIADOMOŚCI E-MAIL WEBEX4BWKS_EMAIL_dla migracji Webex for BroadWorks, aby wysłać treść wiadomości e-mail żądania zmiany hasła dla subskrybentów Webex for BroadWorks.

W przypadku migracji BroadCloud ten sam region:

1. Narzędzie pomija numery, urządzenia i obsługę administracyjną udostępnianych wystąpień połączeń.
2. Narzędzie tworzy użytkowników i użytkowników wirtualnych z numerem wewnętrznym i tymczasowym numerem wewnętrznym.

W przypadku migracji BroadCloud inny region:

1. Narzędzie umożliwia udostępnianie numerów, urządzeń i prezentacji połączeń współdzielonych.
2. Narzędzie tworzy użytkowników i użytkowników wirtualnych z rzeczywistymi numerami telefonów i numerem wewnętrznym.
   Wszystkie migracje BroadCloud w Europie odbywają się do innego regionu.

Instrukcje uruchamiania

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:

Inicjowanie obsługi administracyjnej pojedynczego klienta: provision.bat -input= Aby skonfigurować wielu klientów: provision.bat -input= 

macOS

Aby uruchomić narzędzie w systemie macOS, wykonaj następujące czynności:

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

Wymagania wstępne dla Webex dla migracji BroadWorks

Administratorzy partnerów muszą zaktualizować swój szablon wdrażania BroadWorks dla funkcji współistnienia Webex dla BroadWorks. Zapoznaj się z następującym obrazem:

Po zaktualizowaniu szablonu Webex dla BroadWorks Onboarding w celu obsługi migracji poproś zespół ds. kont Cisco o włączenie przełącznika funkcji „wholesale-partner-blending-enabled” na poziomie partnera. Umożliwi to dodawanie pakietów Wholesale do istniejących organizacji klientów Webex dla BroadWorks podczas aprowizacji.

Uruchom narzędzie obsługi administracyjnej z dodatkowym argumentem.

Faza przygotowania: jest domyślną fazą, w której administratorzy mogą aprowizować użytkowników BroadWorks jako subskrybenta Wholesale i kontynuować korzystanie z Webex dla użytkowników BroadWorks.

Faza leczenia podtrzymującego: jest drugą fazą, w której administratorzy mogą przypisywać licencję Wholesale istniejącym użytkownikom Webex dla BroadWorks. Narzędzie obsługi administracyjnej należy uruchomić z użyciem funkcji konserwacji argumentów.

Faza po migracji: Jest ostatnim etapem, w którym administratorzy mogą całkowicie przekonwertować BroadWorks na Wholesale. Narzędzie obsługi administracyjnej należy uruchomić z argumentem po migracji.

Dzienniki terminalu

Poniżej przedstawiono dzienniki w terminalu po pomyślnym zainicjowaniu obsługi administracyjnej:

Nazwa narzędzia: Wersja narzędzia obsługi administracyjnej: 1.15.0 ********** Rozpoczęto przetwarzanie pliku: input/customer.json **************** Inicjowanie obsługi Klient Oczekuje na zakończenie inicjowania obsługi przez klienta external_id_engg_grp1... Oczekiwanie na zakończenie konfigurowania przez klienta external_id_engg_grp1...   Stan klienta external_id_engg_grp1: Skonfigurowane numery obsługi administracyjnej Obsługa użytkowników Funkcje użytkowników Powitania obsługi administracyjnej Harmonogramy obsługi administracyjnej Obsługa urządzeń Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Kolejki połączeń Obsługa administracyjna Obsługa administracyjna Grupy poszukiwania Obsługa administracyjna Obsługa administracyjna Parkowanie połączeń Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Parkowanie połączeń Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Parkowanie połączeń Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Obsługa administracyjna Parkowanie połączeń Obsługa administracyjna Obsługa administracyjna Przejmowanie połączeń Obsługa administracyjna Portal głosowy ********** Ukończony plik: dane wejściowe/klient.json **************** 

Zostanie wydrukowana tabela z liczbą lokalizacji utworzonych dla każdego przebiegu:

Wyjście

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

Administratorzy partnerów mogą zweryfikować inicjowanie obsługi klienta w portalu Partner Hub i Control Hub. Zapoznaj się z poniższymi 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 usługi BroadCloud

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

W portalu dostawcy usług żądanie migracji może zawierać do 50 klientów. Można przesłać maksymalnie 10 zgłoszeń w ciągu jednego dnia.

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

Rysunek 12: Portal dostawcy usług

Rysunek 13: Portal dostawcy usług

Dla Cisco BroadWorks i Webex dla BroadWorks

W przypadku migracji Cisco BroadWorks i Webex for BroadWorks to 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 narzędzia transformacji (customer.json) i uruchamia polecenia OCI-P w celu migracji urządzeń i klientów programowych.

Po udanym działaniu narzędzie do przenoszenia urządzenia:

1. Wyrejestruj urządzenia z usługi Cisco BroadWorks i zarejestruj je w systemie Wholesale.
2. Użytkownicy korzystający z 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. Włącz numery w usłudze Wholesale.
5. Tworzenie prezentacji połączeń wspólnych w Wholesale na potrzeby migracji usługi BroadCloud. [Ten krok dotyczy tylko migracji BroadCloud.]

SCP i SSH

1. SCP narzędzie do przenoszenia urządzenia do pomocniczego serwera aplikacji Cisco BroadWorks.
2. Aby skonfigurować wymagania wstępne i uruchomić narzędzie do przenoszenia urządzenia, należy przesłać żądanie SSH do pomocniczego serwera aplikacji Cisco BroadWorks.

Wymagania wstępne

1. Ustaw_TOKEN ODŚWIEŻANIA (token skopiowany z narzędzia generatora tokenu) w pliku conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Upewnij się, że w pliku conf/deviceMoveTool.conf dodatkowy identyfikator użytkownika, hasło i nazwa hosta Cisco BroadWorks Application Server są poprawne:

   BROADWORKS_USER_ID = admin BROADWORKS_HASŁO = admin BROADWORKS_HOST_NAME = localhost 

3. Aby ponownie wysłać aktywacyjne wiadomości e-mail, należy w pliku conf/partner.cfg ustawić wartość RESEND_INVITATION_EMAILS=true.

   Jeśli administratorzy chcą wysłać zaproszenia e-mail do swoich użytkowników podczas migracji, powinni usunąć komentarz do właściwości „RESEND_INVITATION_EMAILS=true” w pliku conf/partner.cfg. W przeciwnym razie nieruchomość powinna pozostać niezmieniona.

4. Sprawdź, czy ścieżka środowiska JDK/JRE jest poprawna w devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratorzy mogą użyć pliku locations.csv z katalogu wejściowego do migracji określonych grup, a nie wszystkich grup w przedsiębiorstwie.

Telefony Polycom

Aby przenieść telefony Polycom z Cisco BroadWorks do Wholesale Calling, administrator partnera musi utworzyć nowy plik typu profilu tożsamości/urządzenia na poziomie systemu w każdym szablonie urządzenia Polycom w Cisco BroadWorks. Zobacz rys. 14 i prześlij plik niestandardowy 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 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 polycom_vvx2.cfg. Ten plik odnosi się do pliku migration_%BWMACADDRESS%.cfg.
2. Odbuduj profile urządzeń na poziomie grupy lub na poziomie 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 process% BWMACADDRESS%.cfg, który prosi telefony Polycom o pobranie i process migration_%BWMACADDRESS%.cfg, który ustawia device.prov.serverName na https://plcm.sipflash.com.
   https://plcm.sipflash.com w przypadku regionu Stanów Zjednoczonych inne regiony mają różne adresy URL.
5. Telefon Polycom pobiera %BWMACADDRESS%.cfg z https://plcm.sipflash.com i będzie zarządzany przez program Webex Calling DMS.

Rysunek 14: Dodaj plik typu profilu tożsamości/urządzenia

Instrukcje uruchamiania

Istnieją dwie metody wywoływania DMT: pierwsza to wywoływanie przez jednego klienta naraz, a druga to uruchamianie wielu klientów jednocześnie.

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

Pojedynczy klient w przypadku przenoszenia urządzenia: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json W przypadku przenoszenia urządzenia wielu klientów: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/customer1.json customer2.json customer3.json Dodatkowo narzędzie do przenoszenia urządzeń obsługuje migrację pojedynczych/określonych telefonów z wersji 1.35.0. Użyj poniższego polecenia: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Dzienniki terminalu

Poniżej przedstawiono dzienniki w terminalu po pomyślnym uruchomieniu narzędzia do przenoszenia urządzeń do migracji urządzeń:

Nazwa narzędzia: Wersja narzędzia do przenoszenia urządzenia: 1.15.0 Uruchomiono 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 przeprowadzić migrację wszystkich tych urządzeń? ([Y]es lub [N]o) tak Przesyłanie profili urządzeń dla systemu DMS Cisco MPP LC Odbudowa urządzenia Rozpoczęto odbudowę procesu urządzenia Zakończono pomyślnie Rozpoczęto proces ponownego uruchamiania Rozpoczęto proces ponownego uruchamiania Zakończono pomyślnie Modyfikowanie profili dla Business Communicator w ramach grupy collabmigrationtestGRP_engg Aktywuj proces uruchamiania numerów telefonów webex dla organizacji klienta Identyfikator: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Aktywuj proces numerów telefonów Webex dla identyfikatora organizacji klienta: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Rozpoczął się proces dezaktywacji numerów telefonów BroadWorks dla groupId: collabmigrationtestGRP_engg Dezaktywuj ukończony proces numerów telefonów BroadWorks dla groupId: collabmigrationtestGRP_engg Ukończono migrację urządzenia 

Wyjście

Po migracji urządzeń urządzenia są online i gotowe do nawiązywania/odbierania połączeń. Na rysunku 15 przedstawiono przykładowy stan urządzenia:

Rysunek 15: Stan urządzenia

Po migracji urządzenia numery stały się aktywne. Na rysunku 16 przedstawiono przykład aktywnych numerów:

Rysunek 16: Aktywne numery

Operacja przywracania musi być wykonywana jednocześnie dla jednego przedsiębiorstwa.

Dla operatora BroadCloud

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

1. Otwórz zgłoszenie w Cisco TAC, aby poprosić o przywrócenie urządzenia.
2. Uruchom narzędzie do przenoszenia urządzenia w trybie cofania:
   • Spowoduje to usunięcie przypisania numerów telefonów do połączeń Webex, pozostawiając użytkowników i usługi tylko z numerami wewnętrznymi.
   • Adresy e-mail w usłudze Webex Calling zostaną przywrócone na tymczasowe adresy e-mail.
   • Telefony zostaną usunięte z usługi Webex Calling.
   • Numery telefonów, adresy e-mail używane jako alternatywaId i telefony zostaną odtworzone w usłudze BroadCloud.
   • Telefony zostaną ponownie uruchomione.
3. Administratorzy partnerów muszą przenieść numery telefonów PSTN z powrotem do operatora BroadCloud.

Dla Cisco BroadWorks i Webex dla BroadWorks

Proces cofania dla Cisco BroadWorks i Webex for BroadWorks wygląda następująco:

1. Otwórz zgłoszenie w Cisco TAC, aby poprosić o przywrócenie urządzenia.
2. Aby cofnąć migracje urządzeń, uruchom narzędzie przenoszenia urządzenia w trybie przywracania na pomocniczym serwerze aplikacji BroadWorks. Spowoduje to powrót adresu URL DMS dostawcy usług 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ług w profilach urządzeń w usłudze 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 uruchomienia narzędzia przenoszenia urządzenia w trybie cofania

Aby uruchomić narzędzie przenoszenia urządzenia w trybie cofania, wykonaj poniższe czynności:

Uruchom poniższe polecenie na pomocniczym serwerze aplikacji Cisco BroadWorks wewnątrz katalogu narzędzi do przenoszenia urządzeń:

Przywróć profile

./devicemove.sh -input=  -revertProfiles

Przywróć numery

./devicemove.sh -input=  -revertNumbers

Dzienniki terminalu

W terminalu uzyskamy następujące dzienniki po pomyślnym uruchomieniu narzędzia przenoszenia urządzenia w celu cofnięcia operacji:

Przywróć profile

Nazwa narzędzia: Wersja narzędzia do przenoszenia urządzenia: Uruchomiono narzędzie urządzenia 1.15.0 dla procesu cofania... Urządzenia, które można przenieść z powrotem z 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 systemu DMS Cisco MPP LC Odbudowa Rozpoczęto proces Odbudowa Proces urządzenia Zakończono pomyślnie Proces ponownego uruchamiania Rozpoczęto proces ponownego uruchamiania Pomyślnie ukończono migrację urządzenia do procesu deaprowizacji 

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 Aktywuj proces numerów telefonów BroadWorks rozpoczął się dla identyfikatora groupId: collabmigrationtestGRP_engg Aktywuj ukończony proces numerów telefonów BroadWorks dla groupId: collabmigrationtestGRP_engg Ukończono proces przywracania migracji urządzenia