Dziękujemy za opinię.

Obsługiwane telefony będą automatycznie tworzone i przypisywane użytkownikom Webex Calling przez narzędzie do udostępniania. Telefony oznaczone „tak” w kolumnie „Obsługiwane w narzędziu do przenoszenia urządzenia” zostaną również automatycznie przeniesione z Cisco BroadWorks lub BroadCloud do momentu Webex Calling uruchomienia narzędzia do przenoszenia urządzenia. Telefony oznaczone „Nie” w tej kolumnie wymagają ręcznej interwencji, aby zmienić adres URL DMS w szablonie urządzenia Cisco BroadWorks lub w samym telefon ie.

Ostatnia kolumna zawiera mapowanie modeli telefonów do kolumny „Typ urządzenia” pliku transform-tool/input/newphones.csv. (Zobacz sek cję Narzędzia przekształ cania w tym artykule, aby uzyskać więcej informacji na temat newphones.csv).

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 jednorazowym działaniem po włącz eniu konta partnera do rozwiązania Wholesale RTM. To narzędzie umożliwia administratorom partnerów logowanie się za pośrednictwem przeglądarki internetowej, aby uzyskać unikalny TOKEN potrzebny do aktualizacji do plików konfiguracyjnych partnerów dla narzędzi migracji.

Wymagania wstępne

Zainstaluj Java 8, 11, 17 lub 21 na komputerze. Java jest dostępna z wielu źródeł, w tym:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

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

Instrukcje do uruchomienia

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

Okna:

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 na terminalu, zaloguj się za pomocą danych uwierzytelniających administratora partnera, aby uzyskać TOKEN i skopiuj go do dalszego wykorzystania.

Ilustracje interfejsu użytkownika podano poniżej w celach informacyjnych:

Rysunek 3: Zaloguj się za pomocą Cisco Webex

Rysunek 4: Okno poświadczeń

Rysunek 5: Generowanie tokenów

Przed uruchomieniem narzędzi wyodrębniania i przenoszenia urządzenia na dodatkowym serwerze BroadWorks skonfiguruj następujące kroki.

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 przejść do katalogu GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Uruchom następujące polecenie w interfejsie wiersza polecenia, aby uzyskać bieżące Ustawienia ogólne:

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

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

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

Zmień katalog na OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Uruchom następujący interfejs wiersza polecenia, aby uzyskać aktualne ustawienia. Powinieneś zobaczyć, co następuje:

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 ustawieniami, użyj polecenia set, aby ponownie skonfigurować ustawienia.

Krok 3: Użyj interfejsu wiersza polecenia, aby skonfigurować Provisioning OCI.

Zmień do katalogu Provisioning:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Uruchom następujące polecenie, aby uzyskać aktualne ustawienia Provisioning OCI:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Sprawdź wdrożony i aktywny otwarty serwer klienta

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

Krok 1: Wdrożyć 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

Wykonaj następujące polecenia w interfejsie wiersza polecenia, aby włączyć aktywację liczb:

Krok 1: Uruchom polecenie aktywacji liczb:

AS_CLI> cd SubscriberMgmt/NumberActivation

Krok 2: Uruchom polecenie aktywacji:

AS_CLI> set dnMode groupAndUserActivationEnabled

Krok 3: W moncie potwierdzenia wprowadź Y.

Dla BroadCloud

Narzędzie do wyodrębniania jest zintegrow ane z portalem BroadCloud Service Provider. Administrator usługodawcy może:

1. Przesyłaj wnioski o wyciąg dla maksymalnie 50 klientów na żądanie.
   Wniosek o wyciąg nie może być złożony dla tego samego klienta więcej niż 10 razy dziennie.
2. Pobierz wyodrębniony plik danych w formacie ZIP przez okres do 28 dni od daty złożenia wniosku.

Poniższe dane przedstawiają portal Usługodawcy.

Rysunek 6: Portal usługodawcy

Rysunek 7: Portal usługodawcy

Żądanie wyodrębnienia CSV

Zainicjowanie żądania wyciągu CSV

1. Pobierz plik CSV klienta

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

2. Edytuj listę klientów

   Administrator może edytować ten plik CSV, aby uwzględnić tylko klientów, dla których należy wykonać wyodrębnienie.

3. Prześlij i prześlij

   Po edycji prześlij zmodyfikowany plik CSV.

   Kliknij przycisk Prześlij, aby zainicjować żądanie wyodrębnienia dla wymienionych klientów i powią zanych z nimi lokalizacji.

Zainicjowanie żądania wyodrębnienia dla klienta z lokalizacjami CSV

1. Wybierz lokalizację klienta i pobieranie

   Wybierz klienta z menu rozwijanego.

   Pobierz odpowiedni plik locations.csv z zakładki Wyświetl klientów → Witryny → Ekspor tuj lokalizacje jako CSV.

2. Edycja pliku lokalizacji

   Administrator może edytować plik CSV, aby zawierał tylko lokalizacje, które chcą wyodrębnić.

3. Prześlij i prześlij

   Prześlij edytowany plik locations.csv i kliknij Prze ślij.

   Tylko określone lokalizacje dla wybranego klienta zostaną uwzględnione w żądaniu wyciągu.

Zainicjuj wniosek o wyciąg dla wszystkich klientów

1. Kliknij Prze ślij, aby zainicjować żądanie wyodrębnienia dla wszystkich klientów i wszystkich ich lokalizacji pod bieżącym usługodawcą.

Dla Cisco BroadWorks i Webex dla BroadWorks

1. Narzędzie do wyodrębniania działa na dodatkowym serwerze aplikacji Cisco BroadWorks w sieci partnerskiej i łączy się przez OCI-P.
2. Narzędzie pobiera surowe dane korporacyjne, grupy, liczby, użytkowników, usług, urządzeń i miękkich klientów z platformy Cisco BroadWorks lub BroadCloud i wysyła te dane do plików XML, które dostarczają danych wejściowych dla narzędzia do przekształcania.

Kolejne sekcje wyjaśniają, jak zainstalować i skonfigurować narzędzie do wyodrębniania.

Wymagania wstępne

1. SCP pliki binarne narzędzia wyodrębniania do dodatkowego serwera aplikacji Cisco BroadWorks.
2. SSH do dodatkowego serwera aplikacji Cisco BroadWorks w celu skonfigurowania wymagań wstępnych i uruchomienia narzędzia wyodrębniania.
3. Skonfiguruj dostawcę usług i identyfikator grupy w celu wyodrębnienia z programu Cisco BroadWorks w Conf/ExportTool.ym l. Zapoznaj się z następującym przykładowym fragmentem YAML:

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

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

   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 dla migracji Webex for BroadWorks.

5. Zmodyfikuj ścieżkę środowiska JDK/JRE w pliku export.sh, jeśli drugorzędna ścieżka środowiska JDK/JRE Cisco BroadWorks Application Server jest inna niż plik:

   JAVA_HOME=/usr/local/java/java_base

Instrukcje do uruchomienia

Uruchom następujące polecenie w dodatkowym serwerze aplikacji Cisco BroadWorks z katalogu narzędzi wyo drębniania:

./export.sh

Dzienniki terminali

Następujące dzienniki są dostępne w terminalu po pomyślnym eksporcie: 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

Wyjściowy plik ZIP (extracted_data_ .zip<timestamp>) jest dostępny w tym samym katalogu narzędzi wyodrębniania. Użyj następującego polecenia, aby wyświetlić i użyć pliku ZIP dla wejścia 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

Jeśli administrator obsługuje narzędzie znajdujące się za firmowym serwerem proxy, wykonaj poniższe czynności, aby skonfigurować i wykonać skrypt eksportu.

Kroki konfiguracji i wykonania skryptu eksportu

1. Otwórz plik export.sh.
2. Znajdź zmienną HTTPS_PROXY_HOST i usuń jej komentarz (usuń wiodącą #).

3. Ustaw wartość HTTPS_PROXY_HOST jako:

   HTTPS_PROXY_HOST=<proxy-host>

4. Znajdź zmienną HTTPS_PROXY_PORT i usuń jej komentarz (usuń wiodącą #).
5. Ustaw wartość HTTPS_PROXY_PORT jako:

   HTTPS_PROXY_PORT=<proxy-port>

6. Zapisz i zamknij plik export.sh.
7. Otwórz plik partner.cfg i dodaj wymagany refres_token.
8. Sprawdź, czy host BroadWorks, nazwa użytkownika i hasło są poprawnie skonfigurowane w partner.cfg.
9. Uruchom skrypt:

   ./export.sh

Formularz zaangażowania:

Narzędzie do wyodrębniania (BroadCloud i BroadWorks) automatycznie generuje skonsolidowany plik XLSX zatytułowany Engagement Form SUA.xlsx podczas wykonywania. Plik jest wstępnie wypełniony wszystkimi dostęp nymi danymi w odpowiednich arkuszach roboczych, co pomaga usprawnić i przyspieszyć realizację prac partnerskich.

To narzędzie przekształcania działa dla wszystkich migracji. Narzędzie przekształcania 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 wyodrębniania ZIP (extracted_data_ .zip<timestamp>) jako dane wejściowe i przekształca surowy XML w format JSON używany przez narzędzie zapewniające.

Wymagania wstępne

Po pobraniu i wyodrębnieniu plików binarnych narzędzi migracyjnych skonfiguruj następujące warunki wstępne:

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opcjonalnie należy ustawić PROVISIONING_ID (skopiowany z szablonu w Partner Hub) w pliku conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Aby uzyskać pełniejszą weryfikację adresu e-mail klienta, możesz opcjonalnie ustawić PROVISIONING_ID.
3. Skonfiguruj brakujące informacje w pliku input/customers.csv (patrz następną sekcję), jeśli ich brakuje.
4. Dodaj adres e-mail użytkownika końcowego w pliku input/users.csv.
5. Jeśli mają zostać udostępnione 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ą udostępnić nowe telefony w ramach połączeń hurtowych.
6. Konwertuj Call Centers BroadWorks na CXEssentials za pomocą pliku input/cxessentials.csv.
7. Opcjonalnie włącz właściwość UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS, aby przekonwertować wszystkie Call Centers 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 użycie 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 wiersza use_mac_address_from_sip_register=Tak w pliku conf/partner.cfg
10. 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, wstrzymanie muzyki i wyłączyć ustawienia T38 dla wszystkich użytkowników typu analogowego.

11. Jeśli chcesz skonfigurować ogólne urządzenia bramkowe, dodaj adres MAC urządzenia i identyfikator użytkownika do pliku input/genericgateways.csv. Należy również wspomnieć, czy użytkownik jest właścicielem GŁÓWNYM, czy UŻYTKOWNIKIEM UDOSTĘPNIONYM (w przypadku wystąpień połączeń współdzielonych). Jest to potrzebne tylko wtedy, gdy administratorzy partnerów planują używać ogólnych urządzeń bramkowych w połączeniach hurtowych.

    Ta funkcja nie jest dostępna w przypadku migracji BroadCloud do Wholesale.

12. W przypadku migracji BroadCloud, aby przekonwertować wszystkich użytkowników typu stacji komunikacyjnej na voice_mail_group, zaktualizuj plik conf/rialto_station_type_to_wholesale_package.csv, zastępując wartość Pakiet hur towy na voice_mail_group dla wier sza, w którym komunikuje się typ stacji Rialto.

    Opcjonalnie włącz właściwość COMMON_VOICE_MAIL_GROUP_PASSCODE w partner.cfg, aby skonfigurować domyślny kod PIN dla grup poczty głosowej.

    Jeśli ta właściwość nie jest określona w pliku partner.cfg, należy ją podać na klienta w pliku customers.csv w kolumnie CommonVoicEmailGroupPasscode.

13. W celu migracji wspólnych kontaktów do Webex Calling

    Jest to ulepszenie do zarządzania wspólnymi kontaktami na poziomie przedsiębiorstwa i witryny. Kontakty te można teraz migrować jako kontakty organizacji (kontakty organizacyjne ) lub jako rozszerzenia wirtualne, na podstawie ustawień konfiguracyjnych. Poniżej znajdują się szczegółowe informacje, które pomogą Ci przejść przez ten proces migracji.

    Konfiguracja klucza:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      W pliku partner.cfg wprowadzana jest nowa właściwość COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE. Ta właściwość określa sposób migracji wspólnych kontaktów z Rialto do. Webex Calling

    • Bez skonfigurowanego COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Wspólne kontakty zostaną migrowane jako kontakty organizacji (Org Contacts).

      Nie jest wymagana żadna dodatkowa konfiguracja.

      Kontakty pozostają dostępne na poziomie organizacji.

    • Z skonfigurowanym COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Wspólne kontakty zostaną migrowane jako rozszerzenia wirtualne.

      Każdy kontakt zostanie dołączony z numerem rozszerzenia, a zakres początkowy rozszerzenia zostanie zdefiniowany we właściwości COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START _RANGE we właściwości partner.cfg.

      Rozszerzenia wirtualne są obsługiwane zarówno na poziomie organizacji, jak i na poziomie lokalizacji, w zależności od zakresu kontaktu.

14. Włącz domyślnego dostawcę nagrywania połączeń w Webex.

    Ten krok jest wymagany tylko podczas migracji ustawień nagrywania połączeń dla użytkowników skonfigurowanych za pomocą programu Dubber do programu Cisco Native Call Recording w programie Webex.

    Aby włączyć tę opcję:

    • W pliku partner.cfg ustaw następującą właściwość defaul t_call_recording_vendor=webex.
    • Dodatkowo należy użyć właściwości WEBEX_CALL_RECORDING_STORAGE_REGION, aby skonfigu rować region pamięci masowej.

      Opcja nagrywania na żą danie z BroadCloud nie jest obsługiwana w Webex Calling programie. Te ustawienia nagrywania połączeń nie zostaną przeniesione i pojawią się w raporcie wyjątków.

15. Wykluczenie wybranych numerów telefonów z migracji:

    Aby wykluczyć określone numery telefonów z procesu migracji, należy wykonać następującą dwuetapową procedurę za pomocą narzędzia przekształcania:

    • Początkowo uruchom narzędzie przekształcania po raz pierwszy. Po zakończeniu narzędzie wygeneruje plik o nazwie telephone_numbers_inventory.csv, znajdujący się w katalogu output/timestamp/. Klient jest zobowiązany do przejrzenia tego pliku i wskazania „Tak” w kolumnie „Drop Tn's” dla każdego numeru telefonu, który powinien zostać wyłączony z nadchodzącej migracji.
    • Po zaktualizowaniu pliku telephone_numbers_inventory.csv z odpowiednimi flagami wykluczenia narzędzie przekształcania jest wykonywane po raz drugi. Zaktualizowany plik powinien zostać przekazany jako argument w następującym formacie.

      . /transform.sh -extract=dane wejściowe/wyodrębnione_1747640608219.zip -numery wycofania= {filepath/telephone_numbers_inventory.csv}

16. Opcjonalnie należy ustawić właściwość ALLOW_RESTRICT_BY_PARTNER_MODE na OFF, aby umożliwić administratorom klientów modyfikowanie ustawień zdefiniowanych przez partnera w Centrum sterowania .
17. Do migracji numerów telefonów komórkowych (BroadWorks Mobility) z BroadCloud do Webex Calling

    W tej sekcji przedstawiono migrację funkcji BroadWorks Mobility (numery telefonów komórkowych klientów) z BroadCloud (Mobile Network Integration) do W holesale Webex Calling (Webex Go Mobile Network Operator).

    Wymagania wstęp ne — Przed rozpoczęciem procesu migracji administratorzy partnerów muszą skontaktować się z zespołem Cisco Account w celu wykonania konfiguracji dostawcy usług PSTN połączonych z chmurą (CCP) i Custom Carrier List (CCL).

    Nowa właściwość, ASSIGN_MOBILE_NUMBERS_TO_USERS, jest dodawana do pliku partner.cfg. Włącz tę właściwość, aby umożliwić przypisywanie numerów telefonów komórkowych i ich migrację do użytkowników.

    • Ta funkcja jest obsługiwana tylko w przypadku migracji Broadchmury do hurtowej.
    • W Wholesale Webex użytkownicy końcowi mogą mieć numer telefonu komórkowego lub numer PSTN (nie oba), w przeciwieństwie do BroadCloud.
    • Gdy numer telefonu komórkowego jest przypisany do użytkownika, jego podstawowy numer PSTN staje się jego dodatkowym (alternatywnym) numerem.
    • Nie można migrować numerów telefonów komórkowych dla użytkowników, którzy są konwertowani na obszary robocze lub linie wirtualne.
    • Po przypisaniu numeru telefonu komórkowego w Wholesale Webex, pojawi się on jako Aktywny w Control Hub. Ten status nie oznacza, że numer jest natychmiast gotowy do odbierania połączeń. Moż liwość połączenia będzie dostępna dopiero po całkowitym zakończeniu migracji.
    • Ustawienia integracji z telefonami komórkowymi skonfigurowane przez użytkowników końcowych w portalu Calling User Portal (CUP) nie są migrowane. Po migracji, gdy zostanie wywołany numer telefonu, numer telefonu komórkowego lub rozszerzenie , wszystkie urządzenia użytkownika zadzwonią.

18. Aby opcjonalnie skonfigurować limity ilości pakietów podczas migracji klienta, określ ilość dla każdego pakietu w pliku input/package_quantity.csv. Skonfigurowana ilość pakietu musi być większa lub równa liczbie pakietów przypisanych użytkowniku/przestrzeni roboczej.

    Limity ilości pakietów nie są obecnie obsługiwane w przypadku migracji Webex dla BroadWorks do Wholesale.

    Podczas uruchamiania narzędzia przekształcania, podaj zaktualizowany plik jako parametr wejściowy:. <extract_zip_file>/transform.sh -extract= -packagelimits=wejścia/ilość_pakietu.csv .

19. Migracja witryn z wielu klientów z Broadworks/BroadCloud do jednego klienta w sprzedaży hurtowej Webex Calling
    • Nowy tryb wykonawczy, ConsolidatedMigration, został wprowadzony w narzędziu Transform, który obsługuje migrację wielu witryn klientów z Broadcloud/Broadworks do platformy hurtowej Webex w ramach jednej organizacji klienta hurtowego. Gdy ten tryb jest włączony, narzędzie konsoliduje wiele witryn klientów w jedną organizację klienta hurtowego

      -consolidatedMigration

    • Istnieją inne opcjonalne argumenty, które można podać wraz z -ConsolidatedMigration, takie jak

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • Jeśli podano -TargetEnterpriseID, a Id istnieje w pliku wyjściowym narzędzia Wyodrębnij, zostanie on wykorzystany do utworzenia organizacji klienta hurtowego, a jeśli Id nie zostanie znaleziony, narzędzie pow róci do wykorzystania wszelkich dostępnych danych klienta z pliku wyjściowego narzędzia Wyodrębnij.
    • jeśli podano -ConsolidateDexternalID, ustawi ExternalID dla klienta, a jeśli nie zostanie podany, narzędzie wróci do użycia istniejącego przepływu dla zewnętrznego Id.
    • <timestamp>Skonsolidowany plik JSON (customer.json) będzie dostępny w katalogu output/ /.

Wypełnianie pliku input/customers.csv

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

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

Wypełnianie pliku input/users.csv

Plik input/users.csv zawiera dane, których może brakować w Cisco BroadWorks lub BroadCloud. Ten plik można pozostawić pusty, jeśli wszystkie obowiązkowe informacje są już dostępne. Nie musisz wypełniać wszystkich kolumn, tylko brakujące informacje są obowiązkowe.

Instrukcje do uruchomienia

Uruchom narzędzie Transform Tool w dowolnym systemie operacyjnym. Wykonaj poniższe kroki, aby uruchomić narzędzie w systemie Windows i macOS:

Okna

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

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

macOS

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

1. Utwórz środowisko wirtualne i zainstaluj zależności, aby uruchomić narzędzie transformacji za pomocą Pythona:

   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 przekształcania:

   ./transform.sh -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Kontrola wstępna klienta/użytkownika

Narzędzie Transform wykonuje wywołania interfejsu API do Webex w celu wykrycia potencjalnych problemów z udostępnianiem. Domyślnie weryfikuje adres klienta i podstawowy adres e-mail. Jeśli wartość PROVISIONING_ID jest określona w pliku conf/partner.cfg, sprawdzi również poprawność informacji o lokalizacji. Wyniki kontroli wstępnej są zawarte w raporcie wyjątków.

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

sprawdzenie wstępne

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

Informacje o precheckinfowie

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

Dzienniki terminali

Następujące logi w terminalu po udanej transformacji:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Raport wyjątków

Transform Tool generuje raport wyjątków wewnątrz katalogu output/ /exception_report.txt<timestamp>. Za pomocą tego raportu można 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 uruchom ponownie narzędzia do wyodrębniania i przekształcania z nowymi danymi. Przykładowy plik raportu wyjątków jest następujący:

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

<timestamp><groupid>Wyjściowy plik JSON (customer.json) będzie dostępny w katalogu output//. Przykładowy plik customer.json jest następujący:

{
    "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"
    }
}

Narzędzie do udostępniania może działać na dowolnym komputerze, zwykle (laptopie administratora partnera) i korzysta z publicznych interfejsów API Webex. Odczytuje plik wyjściowy narzędzia przekształcania 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 przydzielania:

1. Zainstaluj Java 8, 11, 17 lub 21 na komputerze. Java jest dostępna z wielu źródeł, w tym:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Po pobraniu i wyodrębnieniu plików binarnych narzędzi migracji ustaw zmienną środowiskową JAVA_HOME w provisioning_tool.sh dla MAC i provisioning_tool.bat dla systemu Windows.
3. Plik partner.cfg:
   • Ustaw WHOLESALE_PROVISIONING_ID i REFRESH_TOKEN (Token skopiowany z narzędzia Generator tokenów). Administratorzy partnerów muszą skontaktować się ze swoim zespołem konta, aby uzyskać PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Jeśli partnerzy nie chcą wysyłać e-maila powitalnego do użytkowników, ustaw wartość SEND_SUBSCRIBERS_WELCOME_EMAIL na false. Wartość domyślna to true.

     Webex wysyła e-maile powitalne tylko do użytkowników końcowych. Administratorzy klientów nie otrzymują e-maili powitalnych.

     Użytkownicy i administratorzy klientów z siedzibą w Stanach Zjednoczonych i Kanadzie otrzymują osobne powiadomienie e-mail od RedSky. Platforma RedSky E911 wysyła tę wiadomość e-mail, aby potwierdzić utworzenie konta klienta dla służb ratunkowych. Ta wiadomość e-mail RedSky jest oddzielna od e-maili powit alnych Webex i nie jest kontrolowana przez ustawienia poczty e-mail Webex. W przypadku organizacji hurtowych w USA i Kanadzie RedSky jest automatycznie włączany jako dostawca usług ratunkowych.

4. Użyj właściwości WEBEX4BWKS_EMAIL_SUBJECT dla migracji Webex dla BroadWorks, aby wysłać temat wiadomości e-mail z żądaniem zmiany hasła dla Webex dla subskrybentów BroadWorks.
5. Użyj właściwości WEBEX4BWKS_EMAIL_BODY dla migracji Webex dla BroadWorks, aby wysłać treść wiadomości e-mail żądania zmiany hasła dla Webex dla subskrybentów BroadWorks.
6. Użyj właściwości CUSTOM_TAGS, aby dodać tagi po utworzeniu klienta.
7. Aby zastosować zniżki hurtowe, administratorzy partnerów muszą skontaktować się z zespo łem ds. kont Cisco przed rozpoczęciem migracji.

   Nowa właściwość, APPLY_WHOLESALE_DISCOUNTS jest dodawana do pliku partner.cfg. Włącz tę nieruchomość, aby stosować zniżki dla użytkowników i obszarów roboczych.

8. (Opcjonalnie) Wyraźnie skonfiguruj połączenie PSTN

   Aby określić połączenie PSTN dla wszystkich lokalizacji udostępnionych podczas migracji, w tym położenia głównego, dodaj następującą właściwość do pliku partner.cfg:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Jeśli właściwość nie jest skonfigurowana lub została skomentowana, narzędzie Provisioning używa domyślnego procesu wyboru połączenia PSTN.

Instrukcje do uruchomienia

Aby uruchomić narzędzie w system ach Windows i macOS, wykonaj następujące kroki:

Okna

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

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

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

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Wymagania wstępne dotyczące migracji Webex dla BroadWorks

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

Gdy szablon Webex for BroadWorks Onboarding zostanie zaktualizowany w celu obsługi migracji, poproś zespół ds. kont Cisco o włączenie przełączania funkcji „integracja z obsługą hurtowni” na poziomie partnera. To ustawienie pozwala narzę dziu Provisioning automatycznie dodawać pakiety hurtowe do istniejących klientów Webex dla Broad Works podczas udostępniania.

Uruchom narzędzie udostępniania za pomocą dodat kowego argumentu.

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

Faza konserwacji: to druga faza, w której Administratorzy mogą przypisać licencję hurtową istniejącemu Webex dla użytkowników BroadWorks. Narzędzie zaopat rzenia należy uruchomić z konserwacją argumentu.

Faza po migracji: to ostatnia faza, w której administratorzy mogą całkowicie przekonwertować BroadWorks na sprzedaż hurtową. Narzędzie udostępniania należy uruchomić z argument em po migracji.

Dzienniki terminali

Poniżej znajdują się dzienniki w terminalu dotyczące pomyślnego udostępniania:

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

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

Wyjście

<external_id>Narzędzie do udostępniania generuje raporty o powodzeniu i błędach w plikach wyjściowych/ /*. success/error. Przejrzyj wyniki wyników i dzienniki błędów, aby zweryfikować pomyślne udostępnianie.

System wygeneruje plik Provisioning_Report_*.csv w katalogu output/konsolidated_report s/. Ten plik zawiera zarówno szczegóły dotyczące sukcesu, jak i niepowodzenia dla każdego podmiotu i jego ustawień, dostarczając kompleksowy raport dotyczący udostępniania .

Narzędzie zaopatrzenia generuje również plik Provision ing_Statistics_*.csv w katalogu output/konsolidated_reports/. Ten raport zawiera liczbę pom yślnie i bezskutecznie udostępnionych klientów, lokalizacji, użytkowników, urządzeń i funkcji grupy.

Administratorzy partnerów mogą zweryfikować udostępnianie klientów w portalu Partner Hub i Control Hub. Zapoznaj się z poniższymi ilustracjami z portalu Partner Hub i Control Hub:

Rysunek 8: Partner Hub

Rysunek 9: Piasta sterowania

Rysunek 10: Urządzenia

Rysunek 11: Dzwonienie

Ograniczenia po udostępnieniu

Po zakończeniu udostępniania migracji BroadCloud następujące działania zostaną zablokowane:

• CAP Portal - Dodawanie użytkowników lub portowanych urządzeń.
• SP Portal - Tworzenie zamówień ADD za pomocą urządzeń lub numerów.
• RSB API - Tworzenie zamówień ADD z urządzeniami lub numerami i tworzenie użytkowników. Zamówienia R SB ADD złożone za pomocą urządzeń lub numerów zostaną odrzucone.

Migracja BroadCloud do hurtowego — ograniczenie rejestracji urządzenia

W przypadku administratorów partnerskich, którzy migrują klientów z BroadCloud do Wholesale w tym samym regionie, urządzenia mogą być dodawane do Wholesale po uruchomieniu narzędzia do udostępniania. Urządzenia te będą jednak uprawnione do rejestracji na platformie Webex dopiero po zakończeniu migracji (przeniesienia urządzenia) do odpowiedniej lokalizacji.

Ograniczenie to nie dotyczy:

• Klienci migrujący z Broadworks/W4b do Wholesale.
• BroadCloud do migracji hurtowych w różnych regionach.

Zalecane wskazówki

Aby uniknąć problemów z rejestracją urządzenia, zakończ migrację przenoszenia urządzenia na poziomie lokalizacji, zanim spróbujesz zarejestrować urządzenia na platformę Webex dla migracji BroadCloud do hurtowych w tym samym regionie.

Dla BroadCloud

W przypadku partnerów BroadCloud skorzyst aj z portalu Usługodawcy, aby przesłać żądanie migracji numerów, urządzeń i migracji udostępnionych połączeń (SCA).

W ramach 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.

Administratorzy mogą włączyć automatyczne wycofywanie, ustawiając rollback_to_broadcloud=true w pliku conf/partner.cfg, który przenosi urządzenia z powrotem do BroadCloud po migracji. Obsługuje zarówno migracje tego samego, jak i innego regionu za pomocą NS Sync, ale tylko w przypadku udanych migracji. W przypadku nieud anych administratorzy muszą podnieść plik Cisco TAC przed zażądaniem wy cofania.

Dostępne są dwie opcje wyboru typu migracji w portalu:

• Migracja — wybierz tę opcję, aby zainicjować żądanie migracji numerów, urządzeń i udostępnionych wyglądów połączeń (SCA).
• Status urządzenia — wybierz tę opcję, aby wyświetlić bieżący stan urządzenia w BroadCloud i Calling.

Poniższe dane przedstawiają portal Usługodawcy.

Rysunek 12: Portal usługodawcy

Rysunek 13: Portal usługodawcy

Migr acja wybranych lokalizacji (opcjonalnie)

Aby rozpocząć migrację dla określonego podzbioru lokalizacji wymienionych w pliku customer.json, dołącz do żądania plik locations.csv. Ten plik CSV powinien zawierać tylko te lokalizacje, które zamierzasz przeprowadzić migrację.

Aby pobrać listę dostępnych aktywnych witryn, przejdź do opcji Wyświet l klientów → Wybierz klienta → Eksportuj lokalizacje jako CSV.

Rysunek 14: Eksportuj lokalizacje jako CSV

W łącz opcję rozłączania numerów

W przypadku korzystania z tego samego trunku SIP dla Webex Calling operatora BroadCloud administratorzy powinni użyć opcji Roz łącz numery. Spowoduje to usunięcie numerów telefonów z odbierania połączeń przychodzących po migracji w BroadCloud.

Aby włączyć tę opcję,

1. W pliku partner.cfg ustaw DISCONNECT_NUMBERS_FROM_RIALTO = yes.
2. Ponownie uruchom narzędzie migracji przy użyciu tego samego pliku customer.json i zak tualizowanego pliku partner.cfg.

Jeśli numery nie odłączą się, zgłaszaj żądanie Cisco TAC.

Dla Cisco BroadWorks i Webex dla BroadWorks

W przypadku migracji Cisco BroadWorks i Webex dla BroadWorks narzędzie działa na dodatkowym serwerze aplikacji Cisco BroadWorks w sieci partnerskiej i łączy się z systemem AS za pośrednictwem OCI-P. Używa pliku wyjściowego narzędzia Transform Tool JSON (customer.json) jako dane wejściowe i uruchamia polecenia OCI-P do migracji urządzeń i klientów miękkich.

Po pomyśl nej operacji narzędzie do przenoszenia urządzenia będzie:

1. Wyrejestruj urządzenia z Cisco BroadWorks i zarejestruj je w Hurtowni.
2. Użytkownicy korzystający z klienta UC-One przekierują do aplikacji Webex przy pierwszym logowaniu.
3. Dezaktywuj numery telefonów z Cisco BroadWorks lub usuń numery telefonów z BroadCloud.
4. Aktywuj numery w sprzedaży hurtowej.
5. Tworzenie udostępnionych wyglądów połączeń w hurtowni dla migracji BroadCloud. [Ten krok dotyczy tylko migracji BroadCloud].

6. Jeśli administrator obsługuje narzędzie znajdujące się za firmowym serwerem proxy, wykonaj poniższe czynności, aby skonfigurować i wykonać skrypt udostępniania.

   Procedura konfiguracji

   1. Otwórz plik devicemove.sh.
   2. Znajdź zmienną PROXY_HOST i usuń jej komentarz (usuń wiodący # dla devicemove.sh).

   3. Ustaw wartość PROXY_HOST jako:

      PROXY_HOST=<proxy-host>

   4. Znajdź zmienną PROXY_PORT i usuń jej komentarz (usuń wiodący # dla devicemove.sh).

   5. Ustaw wartość PROXY_PORT jako:

      PROXY_PORT=<proxy-port>

   6. Zlokalizuj zmienną PROXY_SCHEME i usuń jej komentarz (usuń wiodący # dla devicemove.sh). Ten krok jest opcjonalny; jeśli zostanie skomentowany, domyślną wartością PROXY_SCHEME będzie HTTP.

   7. Ustaw wartość PROXY_SCHEME jako:

      PROXY_SCHEME=<proxy-scheme>

   8. Zapisz i zamknij plik devicemove.sh.
   9. Otwórz plik partner.cfg i dodaj wymagany refres_token.
   10. Sprawdź, czy host BroadWorks, nazwa użytkownika i hasło są poprawnie skonfigurowane w partner.cfg

   11. Uruchom skrypt:

       ./devicemove.sh

SCP i SSH

1. SCP narzędzie do przenoszenia urządzenia do dodatkowego serwera aplikacji Cisco BroadWorks.
2. SSH do dodatkowego serwera aplikacji Cisco BroadWorks w celu skonfigurowania wymagań 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) w pliku conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Upewnij się, że drugorzędny identyfikator użytkownika serwera aplikacji Cisco BroadWorks, hasło i nazwa hosta są poprawne w pliku CONF/ DeviceMovetool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Aby ponownie wysłać wiadomości e-mail aktywacyjne, musisz ustawić send_subscribers_welcome_email=true w pliku conf/partner.cfg.

   Jeśli administratorzy chcą wysyłać wiadomości e-mail z zaproszeniami do swoich użytkowników podczas migracji, powinni odkomentować właściwość „send_subscribers_welcome_email=true” w pliku conf/partner.cfg. W przeciwnym razie nieruchomość powinna pozostać niezmieniona.

4. Sprawdź poprawność ścieżki środowiska JDK/JRE w devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratorzy mogą używać pliku 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 połączeń hurtowych, administrator partnera musi utworzyć nowy plik typu tożsamości/profilu urządzenia na poziomie systemu w programie Cisco BroadWorks dla każdego szablonu urządzenia Polycom. Zapoznaj się z rysun kiem 14 i prześlij niestandardowy plik 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 migracja pliku_%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 dla telefonów Polycom:

1. Narzędzie przenoszenia urządzenia zastępuje plik %BWMAadress%.cfg na poziomie urządzenia za pomocą polycom_vvx2.cfg. Ten plik odnosi się do migration_%BWMAadress%.cfg.
2. Odbuduj profile urządzeń na poziomie grupy lub na poziomie urządzenia.
   Działanie na poziomie grupy lub na poziomie urządzenia zależy od konfiguracji parametru DeviceLevelRebuild w pliku device-move-tool/conf/partner.cfg.
3. Narzędzie przenoszenia urządzenia prosi serwer aplikacji Cisco BroadWorks o ponowne uruchomi enie telefonów na poziomie grupy lub urządzenia.
4. Po żądaniu ponownego uruchomienia telefony Polycom pobierają i przetwarzają% BWMAadress%.cfg, który prosi telefony Polycom o pobranie i przetworzenie Migration_%BWMAadress%.cfg, który ustawia Device.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 %BWMAadress%.cfg ze strony https://plcm.sipflash.com i będzie zarządzany przez DMS. Webex Calling

Rysunek 14: Dodawanie pliku typu tożsamości/profilu urządzenia

Instrukcje do uruchomienia

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

Narzędzie przenoszenia urządzenia jest uruchamiane z dodatkowego serwera aplikacji Cisco BroadWorks w katalogu narzędzi do przenoszenia urządzenia:

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Dzienniki terminali

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

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ądzenia urządzenia są dostępne online i są gotowe do wykonywania/odbierania połączeń. Patrz rysunek 15, aby zobaczyć przykład stanu urządzenia:

Rysunek 15: Stan urządzenia

Po migracji urządzenia numery są aktywne. Zapoznaj się z rysunkiem 16, aby zobaczyć przykład aktywnych liczb:

Rysunek 16: Aktywne liczby

Jeśli administrator obsługuje narzędzie znajdujące się za firmowym serwerem proxy, wykonaj poniższe czynności, aby skonfigurować i wykonać skry pt devicemove.

Kroki konfiguracji i wykonania skryptu devicemove

1. Otwórz plik devicemove.sh.
2. Znajdź zmienną HTTPS_PROXY_HOST i usuń jej komentarz (usuń wiodącą #).

3. Ustaw wartość HTTPS_PROXY_HOST jako:

   HTTPS_PROXY_HOST=<proxy-host>

4. Znajdź zmienną HTTPS_PROXY_PORT i usuń jej komentarz (usuń wiodącą #).
5. Ustaw wartość HTTPS_PROXY_PORT jako:

   HTTPS_PROXY_PORT=<proxy-port>

6. Zapisz i zamknij plik devicemove.sh.
7. Otwórz plik partner.cfg i dodaj wymagany refres_token.
8. Sprawdź, czy host BroadWorks, nazwa użytkownika i hasło są poprawnie skonfigurowane w partner.cfg.
9. Uruchom skrypt:

   ./devicemove.sh

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

Dla BroadCloud Carrier

Administratorzy mogą ustawić rollback_to_broadcloud= true w conf/partner.cfg, aby włączyć automatyczne wycofywanie. Spowoduje to zwraca urządzenia do BroadCloud po pomyślnej migracji w tym samym lub w różnych regionach z NS Sync. W przypadku nieudanych migracji skontaktuj się z proś Cisco TAC bą o wycofanie.

Dla Cisco BroadWorks i Webex dla BroadWorks

Proces cofania dla Cisco BroadWorks i Webex dla BroadWorks jest następujący:

1. Otwórz bilet, Cisco TAC aby poprosić o przywrócenie urządzenia.
2. Uruchom narzędzie do przenoszenia urządzenia w trybie cofania na dodatkowym serwerze aplikacji BroadWorks, aby przywrócić migracje urządzeń. Spowoduje to przywrócenie adresu URL DMS do adresu DMS dostawcy usług dla profili urządzeń w Cisco BroadWorks i ponownie aktywować numery telefonów.
3. Z Webex Calling espół ustawia adres URL DMS z powrotem na adres URL DMS dostawcy usług w profilach urządzeń w. Webex Calling
4. Administratorzy partnerów muszą dezaktywować lub usunąć numery telefonów w portalu Control Hub. Webex Calling
5. Administratorzy partnerów muszą przenieść numery telefonów PSTN z powrotem do Cisco BroadWorks.

Instrukcje uruchamiania narzędzia do przenoszenia urządzenia w trybie cofania

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

Uruchom poniższe polecenie w dodatkowym 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óć liczby

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

Dzienniki terminali

Po pomyślnym uruchomieniu narzędzia do przenoszenia urządzenia do operacji cofania otrzymamy następujące dzienniki w terminalu:

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