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

Zainstaluj na komputerze oprogramowanie Java 8, 11, 17 lub 21. 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 uruchamiania

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

Windows:

token_generator.bat

System 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ę 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
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

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

Krok 3: Użyj 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> get
Address Description
========================
127.0.0.1 local as

Krok 4: Uruchom 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ź, 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> deploy application OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> start application 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> set 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:

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

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 = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

   REFRESH_TOKEN Ta właściwość 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:

 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_<timestamp>.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 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

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_<timestamp>.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
10. Funkcja synchronizacji serwera sieciowego umożliwia administratorom udostępnianie numerów telefonów, adresów MAC i adresów e-mail użytkowników podczas inicjowania obsługi w tej samej migracji regionu. Aby ją włączyć, ustaw USE_NS_SYNC=yes w conf/partner.cfg.

    Jeśli synchronizacja NS jest wyłączona, numer telefonu i udostępnianie urządzeń zostaną pominięte, a użytkownicy otrzymają tymczasowe adresy e-mail.

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
   python3 -m pip install phonenumbers
   

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:

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

Raport wyjątku

Narzędzie Transform generuje raport wyjątku w katalogu output/<timestamp>/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:

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

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

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

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 na komputerze oprogramowanie Java 8, 11, 17 lub 21. 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 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.
6. Funkcja synchronizacji serwera sieciowego umożliwia administratorom udostępnianie numerów telefonów, adresów MAC i adresów e-mail użytkowników podczas inicjowania obsługi w tej samej migracji regionu. Aby ją włączyć, ustaw USE_NS_SYNC=yes w conf/partner.cfg.

   Jeśli synchronizacja NS jest wyłączona, numer telefonu i udostępnianie urządzeń zostaną pominięte, a użytkownicy otrzymają tymczasowe adresy e-mail.

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:

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

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

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

Wymagania wstępne dla 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:

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

Zostanie wydrukowana tabela 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.

Funkcja Synchronizacja serwera sieciowego umożliwia administratorom dezaktywację lokalizacji BroadCloud i aktywację lokalizacji Webex Calling poprzez ustawienie USE_NS_SYNC=yes w conf/partner.cfg. Po migracji urządzenia i numery telefonów są aktywowane w lokalizacji Webex Calling.

Administratorzy mogą włączyć automatyczne przywracanie, ustawiając ROLLBACK_TO_BROADCLOUD=true w conf/partner.cfg pliku, który przenosi urządzenia z powrotem do BroadCloud po migracji. Obsługuje migracje w tym samym i różnych regionach dzięki usłudze NS Sync, ale tylko w przypadku udanych migracji. W przypadku nieudanych operacji administratorzy muszą zgłosić TAC firmy Cisco przed złożeniem prośby o wycofanie.

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_PASSWORD = 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 na stronie 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:

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

Dzienniki terminalu

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

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

Wyjście

Po migracji urządzeń urządzenia są 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

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óć numery

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