지원되는 전화는 Webex Calling에서 프로비저닝 도구에서 자동으로 생성되고 사용자에게 지정됩니다. "장치 이동 도구에서 지원됨" 열에 "예"로 표시된 전화는 장치 이동 도구가 실행될 때 Cisco BroadWorks 또는 BroadCloud에서 Webex Calling으로 자동으로 이동됩니다. 해당 열에 "아니요"로 표시된 전화기는 Cisco BroadWorks 장치 템플릿 또는 전화기 자체에서 DMS URL을 변경하려면 수동 개입이 필요합니다.

마지막 열에서는 전화기 모델을 파일 transform-tool/input/newphones.csv의 "장치 유형" 열에 매핑합니다. (newphones.csv에 대한 자세한 정보는 이 문서의 변환 도구 섹션을 참조하십시오.)

파트너 관리자는 마이그레이션 도구를 실행하기 전에 최소한 한 번 이 토큰 생성기 유틸리티 도구를 실행합니다. 이 도구를 실행하면 파트너 계정이 Wholesale RTM 솔루션에 등록된 후 일회성 활동입니다. 이 도구를 통해 파트너 관리자는 웹 브라우저를 통해 로그인하여 마이그레이션 도구의 파트너 구성 파일을 업데이트하는 데 필요한 고유한 토큰을 얻을 수 있습니다.

전제 조건

컴퓨터에 Java 8, 11, 17 또는 21을 설치합니다. Java는 다음과 같은 다양한 소스에서 사용할 수 있습니다.

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

다운로드한 후 마이그레이션 도구 바이너리를 추출합니다.

실행할 안내

토큰 생성기 디렉터리 내의 터미널에서 다음 명령을 실행합니다.

Windows:

token_generator.bat

MacOS:

./token_generator.sh

출력:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

터미널의 웹 브라우저에서 URL을 열고 파트너 관리자 자격 증명으로 로그인하여 토큰을 가져오고 추가 사용을 위해 동전을 복사합니다.

사용자 인터페이스 설명은 참조를 위해 아래에 제공됩니다.

그림 3: Cisco Webex로 로그인

그림 4: 자격 증명 창

그림 5: 토큰 생성

보조 BroadWorks 서버에서 추출 및 장치 이동 도구를 실행하기 전에 다음 단계를 구성합니다.

OCI-P 연결 활성화

장치 이동 도구는 OCI-P 명령을 통해 BroadWorks와 통신하며, OCI-P 연결을 활성화하려면 아래 단계를 사용하십시오.

단계 1: CLI를 사용하여 일반 설정을 구성합니다.

CLI에서 다음 명령어를 실행하여 GeneralSettings 디렉터리로 변경합니다.

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

CLI에서 다음 명령어를 실행하여 현재 GeneralSettings를 가져옵니다.

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

설정이 상단과 일치하지 않는 경우, set 명령어를 사용하여 설정을 다시 구성합니다.

단계 2: CLI를 사용하여 OCI 프록시를 구성합니다.

디렉터리를 OCI 프록시로 변경합니다.

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

다음 CLI를 실행하여 현재 설정을 가져옵니다. 다음 항목이 나타납니다.

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

설정이 상단과 일치하지 않는 경우, set 명령어를 사용하여 설정을 다시 구성합니다.

단계 3: CLI를 사용하여 OCI 프로비저닝을 구성합니다.

프로비저닝 디렉터리로 변경:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

다음 명령어를 실행하여 현재 OCI 프로비저닝 설정을 가져옵니다.

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

단계 4: CLI에서 아래 명령어를 실행하여 구성이 올바른지 확인하십시오.

 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.

오픈 클라이언트 서버가 배포되고 활동 중인지 확인

배포되지 않았거나 아직 시작되지 않은 경우, 아래 명령어를 사용하여 보조 응용프로그램 서버에서 오픈 클라이언트 서버를 배포하고 시작하십시오.

단계 1: 다음 CLI 명령을 사용하여 서버를 배포합니다.

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

단계 2: 다음 명령어로 서버를 시작합니다.

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

번호 활성화 활성화

번호를 활성화하려면 CLI에서 다음 명령을 실행합니다.

단계 1: 번호 활성화 명령어를 실행합니다.

AS_CLI> cd SubscriberMgmt/NumberActivation

단계 2: 활성화 활성화된 명령을 실행합니다.

AS_CLI> set dnMode groupAndUserActivationEnabled

단계 3: 확인 프롬프트에서 Y를 입력합니다.

BroadCloud용

추출 도구는 BroadCloud 서비스 공급자 포털에 통합됩니다. 서비스 공급자 관리자는 다음 작업을 실행할 수 있습니다.

1. 요청당 최대 50명의 고객에 대한 추출 요청을 제출합니다.
   동일한 고객에 대해 하루에 10번 이상 추출 요청을 제출할 수 없습니다.
2. 요청 제출 날짜로부터 최대 28일 동안 추출된 데이터 파일을 ZIP 형식으로 다운로드합니다.

아래 그림은 서비스 공급자 포털을 보여줍니다.

그림 6: 서비스 공급자 포털

그림 7: 서비스 공급자 포털

Cisco BroadWorks 및 BroadWorks용 Webex

1. 추출 도구는 파트너 네트워크 내에서 보조 Cisco BroadWorks 응용프로그램 서버에서 실행되고 OCI-P를 통해 연결합니다.
2. 이 도구는 Cisco BroadWorks 또는 BroadCloud 플랫폼에서 원시 기업, 그룹, 번호, 사용자, 서비스, 장치 및 소프트 클라이언트의 데이터를 가져오고 변환 도구에 대한 입력을 제공하는 XML 파일로 이 데이터를 출력합니다.

다음 섹션에서는 추출 도구를 설치하고 구성하는 방법에 대해 설명합니다.

전제 조건

1. SCP는 보조 Cisco BroadWorks 애플리케이션 서버에 대한 추출 도구 바이너리를 설정합니다.
2. SSH를 보조 Cisco BroadWorks 애플리케이션 서버에 연결하여 전제 조건을 구성하고 추출 도구를 실행합니다.
3. conf/exportTool.yml의 Cisco BroadWorks에서 추출하도록 서비스 공급자 및 그룹 ID를 구성합니다. 아래 샘플 YAML 스니펫을 참조하십시오.

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

4. conf/partner.cfg 파일에서 보조 Cisco BroadWorks 응용프로그램 서버 사용자 ID, 비밀번호 및 호스트 이름이 올바른지 확인하십시오.

   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 속성은 BroadWorks용 Webex 마이그레이션에 대해 필수입니다.

5. 보조 Cisco BroadWorks 응용프로그램 서버 JDK/JRE 환경 경로가 파일과 다른 경우 export.sh 파일에서 JDK/JRE 환경 경로를 수정합니다.

   JAVA_HOME=/usr/local/java/java_base

실행할 안내

추출 도구 디렉터리에서 보조 Cisco BroadWorks 응용프로그램 서버에서 아래 명령을 실행합니다.

./export.sh

터미널 로그

성공적으로 내보내는 경우 터미널에서 다음 로그를 사용할 수 있습니다. 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
**************************************************

출력

출력 ZIP(extracted_data_<timestamp>.zip) 파일은 동일한 추출 도구 디렉터리에서 사용할 수 있습니다. 아래의 명령을 사용하여 변환 도구 입력에 대한 ZIP 파일을 확인하고 사용하십시오.

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

이 변환 도구는 모든 마이그레이션에 대해 실행됩니다. 변환 도구는 파트너의 관리자 노트북을 포함하여 모든 컴퓨터에서 실행되고 Webex 공용 API를 사용합니다. 이는 추출 도구 출력 ZIP(extracted_data_<timestamp>.zip) 파일을 입력으로 읽고 원시 XML을 프로비저닝 도구에서 사용하는 JSON 형식으로 변환합니다.

전제 조건

마이그레이션 도구 바이너리를 다운로드하고 추출한 후 다음 전제 조건을 구성합니다.

1. 새로 고침_토큰 (토큰 생성기 도구에서 복사된 토큰) 및 conf/partner.cfg 파일에 있는 _기본_ 위치의 이름_을 설정합니다.

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. 선택적으로 conf/partner.cfg 파일에 있는 프로비저닝_ID(Partner Hub의 템플릿에서 복사됨)를 설정합니다.

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   고객 이메일 주소의 완전한 확인을 얻기 위해 선택적으로 프로비저닝 ID를 설정할 수 있습니다_.
3. 누락된 경우 input/customers.csv 파일에 누락된 정보를 구성하십시오(다음 섹션 참조).
4. input/users.csv 파일에 최종 사용자 이메일 주소를 추가합니다.
5. 새 전화기를 프로비저닝하는 경우, 사용자의 새 전화기의 mac 주소 및 이메일 주소를 input/newphones.csv 파일에 추가합니다. 이는 파트너 관리자가 도매점 통화에서 새로운 전화를 프로비저닝하려는 경우에만 필요합니다.
6. input/cxessentials.csv 파일을 사용하여 BroadWorks 통화 센터를 CxEssentials로 변환합니다.
7. (선택 사항) 모든 통화 센터를 CxEssentials로 변환하려면 _모든_CALL_CENTERS_TO_CX_ESSENTIALS 속성을 업그레이드 활성화합니다.
8. 관리자가 위치별로 고객의 위치를 마이그레이션할 수 있는 대기업 마이그레이션을 지원하려면 input/locations.csv 파일을 사용하십시오.
9. 선택적으로 Cisco BroadWorks 장치 프로필에서 MAC 주소를 사용할 수 없는 경우 SIP REGISTER 메시지의 사용자 에이전트 헤더에서 MAC 주소의 사용을 활성화합니다. 파일 conf/partner.cfg에서 "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" 회선 주석 해제
10. 네트워크 서버 동기화 기능을 사용하면 관리자는 동일한 지역 마이그레이션에서 프로비저닝하는 동안 전화 번호, MAC 주소 및 사용자 이메일 주소를 프로비저닝할 수 있습니다. 활성화하려면 USE_NS_SYNC=yesconf/partner.cfg에서 설정합니다.

    NS 동기화가 비활성화된 경우, 전화 번호 및 장치 프로비저닝을 건너뛰고 사용자는 임시 이메일 주소를 받게 됩니다.

input/customers.csv 기입

파일 input/customers.csv는 Cisco BroadWorks 또는 BroadCloud에 누락될 수 있는 데이터를 제공합니다. 모든 필수 정보를 이미 사용할 수 있는 경우 이 파일은 비워둘 수 있습니다. 모든 열을 입력할 필요는 없으며, 누락된 정보만 필수입니다.

아래 표는 input/customers.csv에서 가장 중요한 열을 설명합니다.

실행할 안내

모든 운영 체제에서 변환 도구를 실행합니다. Windows 및 macOS에서 도구를 실행하려면 아래 단계를 사용하십시오.

Windows는

Windows에서 변환 도구를 실행하려면 아래 명령을 실행하십시오.

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

macOS

macOS에서 변환 도구를 실행하려면 다음 단계를 실행하십시오.

1. 가상 환경을 만들고 종속성을 설치하여 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. 변환 도구를 실행합니다.

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

고객/사용자 사전 검사

변환 도구는 API 통화를 Webex로 실행하여 잠재적인 프로비저닝 문제를 파악합니다. 기본적으로 고객의 주소 및 기본 이메일의 유효성을 검증합니다. PROVISIONING_ID 값이 conf/partner.cfg 파일에 지정된 경우, 이는 위치 정보도 검증합니다. 사전 검사 결과는 예외 보고서에 포함됩니다.

또한 변환 도구를 실행할 때 다음과 같은 선택적 매개 변수를 추가할 수 있습니다.

사전 검사

고객 정보에 대해 사전 검사 API를 실행하는 것 외에도 변환 도구는 가입자 이메일에 대한 사전 검사 API도 실행합니다.

사전 검사

기본적으로 사전 검사 오류(즉, 프로비저닝을 차단하는 문제)만 예외 보고서에 포함됩니다. 이 플래그를 추가하면 성공적인 사전 검사 결과도 포함됩니다(예: 자동으로 첨부할 수 있는 Webex 조직이 이미 존재하는 경우).

터미널 로그

성공적인 변환에 대한 터미널의 다음 로그:

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

예외 보고서

변환 도구는 output/<timestamp>/exception_report.txt 디렉토리 내에서 예외 보고서를 생성합니다. 이 보고서를 사용하여 마이그레이션에 영향을 미치는 문제를 식별하고 Cisco BroadWorks 시스템에서 수정할 수 있습니다.

예외를 해결하기 위해 사용자 데이터를 수정한 후 새 데이터로 추출 및 변환 도구를 다시 실행합니다. 샘플 예외 보고서 파일은 다음과 같습니다.

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

출력

출력 JSON(customer.json) 파일은 output/<timestamp>/<groupid> 디렉터리에서 사용할 수 있습니다. 샘플 customer.json 파일은 다음과 같습니다.

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

프로비저닝 도구는 일반적으로(파트너의 관리자 노트북)에서 실행되고 Webex 공용 API를 사용합니다. 변환 도구 출력 JSON(customer.json) 파일을 입력으로 읽고 Webex Wholesale RTM 솔루션에서 고객, 위치, 번호, 사용자, 서비스 및 장치를 프로비저닝합니다.

전제 조건

프로비저닝 도구 디렉터리 내에서 다음 전제 조건을 구성합니다.

1. 컴퓨터에 Java 8, 11, 17 또는 21을 설치합니다. Java는 다음과 같은 다양한 소스에서 사용할 수 있습니다.
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. 마이그레이션 도구 바이너리를 다운로드하고 추출한 후 JAVA를 설정합니다._HOME 환경 변수 provisioning_toolMAC용 .sh 및 provisioning_toolWindows용 .bat.
3. partner.cfg 파일:
   • 도매점_프로비저닝_ID 및 새로 고침_토큰(토큰 생성기 도구에서 복사된 토큰)을 설정합니다. 파트너 관리자는 프로비저닝_ID를 확인하려면 계정 팀으로 연락해야 합니다.

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • 파트너가 사용자에게 환영 이메일을 보내지 않으려면 허용_관리자_초대_ 이메일을 false로 설정합니다. 기본값은 true입니다.

4. BroadWorks용 Webex 마이그레이션에 대해 WEBEX4BWKS_EMAIL_SUBJECT 속성을 사용하여 BroadWorks용 Webex 구독자에 대한 비밀번호 변경 요청 이메일 제목을 보냅니다.
5. BroadWorks용 Webex 마이그레이션에 대해 WEBEX4BWKS_EMAIL_BODY 속성을 사용하여 BroadWorks용 Webex 구독자에 대한 비밀번호 변경 요청 이메일 본문을 보냅니다.
6. 네트워크 서버 동기화 기능을 사용하면 관리자는 동일한 지역 마이그레이션에서 프로비저닝하는 동안 전화 번호, MAC 주소 및 사용자 이메일 주소를 프로비저닝할 수 있습니다. 활성화하려면 USE_NS_SYNC=yesconf/partner.cfg에서 설정합니다.

   NS 동기화가 비활성화된 경우, 전화 번호 및 장치 프로비저닝을 건너뛰고 사용자는 임시 이메일 주소를 받게 됩니다.

BroadCloud 마이그레이션 동일한 지역의 경우:

1. 이 도구는 번호, 장치 및 공유 통화 표시 프로비저닝을 건너뜁니다.
2. 이 도구는 내선 번호 및 임시 내선 번호를 사용하여 사용자 및 가상 사용자를 만듭니다.

BroadCloud 마이그레이션 다른 지역:

1. 도구는 번호, 장치 및 공유된 통화 표시를 프로비저닝합니다.
2. 이 도구는 실제 전화 번호 및 내선 번호를 사용하여 사용자 및 가상 사용자를 만듭니다.
   모든 유럽 BroadCloud 마이그레이션은 다른 지역으로 이동합니다.

실행할 안내

Windows 및 macOS에서 도구를 실행하려면 다음 단계를 사용하십시오.

Windows는

Windows OS에서 도구를 실행하려면 다음 단계를 실행하십시오.

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

macOS

macOS에서 도구를 실행하려면 다음 단계를 실행하십시오.

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

BroadWorks용 Webex 마이그레이션에 대한 전제 조건

파트너 관리자는 BroadWorks용 Webex 공존 기능에 대한 BroadWorks 온보딩 템플릿을 업데이트해야 합니다. 다음 이미지를 참조하십시오.

마이그레이션을 지원하기 위해 BroadWorks용 Webex 온보딩 템플릿이 업데이트되면 Cisco 계정 팀에게 파트너 수준에서 "wholesale-partner-blending-enabled" 기능 토글을 활성화하도록 요청하십시오. 이를 통해 도매점 패키지가 프로비저닝 중에 기존의 BroadWorks용 Webex 고객 조직에 추가될 수 있습니다.

추가 인수로 프로비저닝 도구를 실행합니다.

준비 단계: 은(는) 관리자가 BroadWorks 사용자를 도매점 가입자로 프로비저닝하고 BroadWorks용 Webex 사용자를 계속할 수 있는 기본 단계입니다.

유지관리 단계: 은(는) 관리자가 기존의 BroadWorks용 Webex 사용자에게 도매점 라이센스를 지정할 수 있는 두 번째 단계입니다. 인수 유지관리를 사용하여 프로비저닝 도구를 실행해야 합니다.

마이그레이션 후 단계: 이는 관리자가 BroadWorks를 Wholesale로 완전히 변환할 수 있는 마지막 단계입니다. 마이그레이션 후 인수를 사용하여 프로비저닝 도구를 실행해야 합니다.

터미널 로그

성공적인 프로비저닝에 대한 터미널의 로그는 다음과 같습니다.

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 ****************

테이블은 각 실행에 대해 생성된 위치의 수가 인쇄됩니다.

출력

프로비저닝 도구는 output/<external_id>/*.success/error 파일 내에서 성공 및 오류 보고서를 생성합니다. 출력 성공 및 오류 로그를 검토하여 성공적인 프로비저닝을 확인합니다.

파트너 관리자는 Partner Hub 및 Control Hub 포털에서 고객 프로비저닝을 확인할 수 있습니다. Partner Hub 및 Control Hub 포털에서 다음 삽화를 참조하십시오.

그림 8: 파트너 허브

그림 9: Control Hub

그림 10: 장치

그림 11: 통화

BroadCloud용

BroadCloud 파트너의 경우, 서비스 공급자 포털을 사용하여 번호, 장치 및 SCA 마이그레이션에 대한 마이그레이션 요청을 제출합니다.

서비스 공급자 포털 내에서 마이그레이션 요청에는 최대 50명의 고객을 포함할 수 있습니다. 하루에 최대 10개의 요청을 제출할 수 있습니다.

네트워크 서버 동기화 기능을 통해 관리자는 USE_NS_SYNC=yes 에서 conf/partner.cfg을(를) 설정하여 broadCloud 위치를 비활성화하고 Webex Calling 위치를 활성화할 수 있습니다. 마이그레이션 후에 장치 및 전화 번호는 Webex Calling 위치에서 활성화됩니다.

관리자는 ROLLBACK_TO_BROADCLOUD=true 파일에서 conf/partner.cfg 설정하여 자동화된 롤백을 활성화할 수 있으며, 이는 마이그레이션 후에 장치를 다시 BroadCloud로 이동합니다. 이는 NS 동기화를 사용하여 동일 및 다른 지역 마이그레이션을 모두 지원하지만 성공적인 마이그레이션을 위해서만 지원합니다. 실패한 항목에 대해 관리자는 롤백을 요청하기 전에 Cisco TAC를 제출해야 합니다.

아래 그림은 서비스 공급자 포털을 보여줍니다.

그림 12: 서비스 공급자 포털

그림 13: 서비스 공급자 포털

Cisco BroadWorks 및 BroadWorks용 Webex

Cisco BroadWorks 및 BroadWorks용 Webex 마이그레이션의 경우, 도구는 파트너 네트워크 내에서 보조 Cisco BroadWorks 응용프로그램 서버에서 실행되고 OCI-P를 통해 AS에 연결합니다. 이는 변환 도구 출력 JSON(customer.json) 파일을 입력으로 사용하고, OCI-P 명령어를 실행하여 장치 및 소프트 클라이언트를 마이그레이션합니다.

작업이 성공하면 장치 이동 도구는 다음과 같습니다.

1. Cisco BroadWorks에서 장치를 등록 해제하고 Wholesale에 등록합니다.
2. UC-One 클라이언트를 사용하는 사용자는 처음으로 로그인할 때 Webex 앱으로 리디렉트됩니다.
3. Cisco BroadWorks에서 전화 번호를 비활성화하거나 BroadCloud에서 전화 번호를 제거하십시오.
4. 도매점에서 번호를 활성화합니다.
5. BroadCloud 마이그레이션에 대해 도매점에서 공유된 통화 모양을 만듭니다. [이 단계는 BroadCloud 마이그레이션에만 적용됩니다].

SCP 및 SSH

1. SCP 장치는 보조 Cisco BroadWorks 애플리케이션 서버로 도구를 이동합니다.
2. SSH를 보조 Cisco BroadWorks 애플리케이션 서버에 연결하여 전제 조건을 구성하고 장치 이동 도구를 실행합니다.

전제 조건

1. conf/partner.cfg 파일에서 새로 고침_토큰(토큰 생성기 도구에서 복사된 토큰)을 설정합니다.

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. conf/deviceMoveTool.conf 파일에서 보조 Cisco BroadWorks 응용프로그램 서버 사용자 ID, 비밀번호 및 호스트 이름이 올바른지 확인하십시오.

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. 활성화 이메일을 다시 보내려면 conf/partner.cfg 파일에서 RESEND_INVITATION_EMAILS=true를 설정해야 합니다.

   관리자가 마이그레이션 중에 사용자에게 초대장 이메일을 보내고자 하는 경우, conf/partner.cfg 파일에서 "RESEND_INVITATION_EMAILS=true" 속성을 주석 해제해야 합니다. 그렇지 않으면 속성은 변경되지 않은 채로 유지되어야 합니다.

4. devicemove.sh에서 JDK/JRE 환경 경로가 올바른지 확인하십시오.

   JAVA_HOME=/usr/local/java/java_base

5. 관리자는 입력 디렉터리에서 locations.csv 파일을 사용하여 기업 아래의 모든 그룹 대신 특정 그룹을 마이그레이션할 수 있습니다.

Polycom 전화

Polycom 전화를 Cisco BroadWorks에서 도매점 통화로 이동하려면 파트너 관리자가 Cisco BroadWorks 각 Polycom 장치 템플릿의 시스템 수준에서 새로운 ID/장치 프로필 유형 파일을 만들어야 합니다. 그림 14를 참조하고 사용자 정의 파일 device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg를 업로드합니다. 새 장치 파일을 업로드한 후 새로 생성된 파일이 그룹 수준에서 존재하는지 확인합니다. 또한 파일 migration_%BWMAC ADDRESS%.cfg이 시스템에 있는 기존의 파일과 충돌하지 않는지 확인하십시오.)

이는 장치 이동 도구에서 내부적으로 사용됩니다.

Polycom 전화기에 대한 마이그레이션 프로세스:

1. 장치 이동 도구는 장치 수준에서 %BWMACADDRESS%.cfg 파일을 polycom_vvx2.cfg로 대체합니다. 이 파일은 migration_%BWMACADDRESS%.cfg를 참조합니다.
2. 그룹 수준 또는 장치 수준에서 장치 프로필을 다시 빌드합니다.
   그룹 수준 또는 장치 수준에서 작업하는 작업은 file device-move-tool/conf/partner.cfg의 파라미터 deviceLevelRebuild의 구성에 따라 달라집니다.
3. 장치 이동 도구는 Cisco BroadWorks 애플리케이션 서버에 그룹 수준 또는 장치 수준에서 전화기를 재부팅하도록 요청합니다.
4. 재부팅 요청 후 Polycom 전화기는 % BWMACADDRESS%.cfg를 다운로드하고 처리합니다. 이는 Polycom 전화기에 migration_%BWMACADDRESS%.cfg를 다운로드하고 처리하도록 요청하며, 이는 device.prov.serverName을 https://plcm.sipflash.com.(으)로 설정합니다.
   https://plcm.sipflash.com 미국 지역에 대해 다른 지역에서는 다른 URL이 있습니다.
5. Polycom 전화는 %BWMACADDRESS%.cfghttps://plcm.sipflash.com 에서 다운로드하고, Webex Calling DMS에서 관리합니다.

그림 14: 아이덴티티/장치 프로필 유형 파일 추가

실행할 안내

DMT를 호출하는 방법은 두 가지가 있습니다. 첫 번째는 한 번에 한 고객을 통해 호출하는 것이고 다른 하나는 여러 고객을 동시에 실행하는 것입니다.

장치 이동 도구는 장치 이동 도구 디렉터리 내의 보조 Cisco BroadWorks 응용프로그램 서버에서 실행됩니다.

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

터미널 로그

다음은 장치 마이그레이션을 위한 장치 이동 도구를 성공적으로 실행한 터미널의 로그입니다.

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

출력

장치 마이그레이션 후 장치가 온라인으로 지정되고 전화를 걸고 받을 준비가 되었습니다. 장치 상태의 예를 보려면 그림 15를 참조하십시오.

그림 15: 장치 상태

장치 마이그레이션 후에 번호가 활성화되었습니다. 숫자 16을 참조하여 어떤 번호가 활성 상태인지 예를 참조하십시오.

그림 16: 번호 활동 중

복원 작업은 한 번에 한 개의 기업에 대해 실행되어야 합니다.

BroadCloud 이동 통신 사업자용

BroadCloud 파트너에 대한 복원 프로세스는 다음과 같습니다.

1. 장치 복원을 요청하려면 Cisco TAC에서 티켓을 엽니다.
2. 복원 모드에서 장치 이동 도구를 실행합니다.
   • 전화 번호는 Webex Calling에서 지정 해제되며, 사용자 및 내선 번호만 포함된 서비스에서 나갑니다.
   • Webex Calling에 있는 이메일 주소는 임시 이메일 주소로 복원됩니다.
   • 전화가 Webex Calling에서 삭제됩니다.
   • 전화 번호, alternateId로 사용되는 이메일 주소 및 전화는 BroadCloud에서 다시 생성됩니다.
   • 전화가 재부팅됩니다.
3. 파트너 관리자는 PSTN 전화 번호를 다시 BroadCloud 이동 통신 사업자로 이동해야 합니다.

Cisco BroadWorks 및 BroadWorks용 Webex

Cisco BroadWorks 및 BroadWorks용 Webex에 대한 복원 과정은 다음과 같습니다.

1. 장치 복원을 요청하려면 Cisco TAC에서 티켓을 엽니다.
2. 장치 마이그레이션을 복원하려면 보조 BroadWorks 응용프로그램 서버에서 복원 모드에서 장치 이동 도구를 실행하십시오. 이는 Cisco BroadWorks에서 장치 프로필에 대해 DMS URL을 서비스 공급자 DMS URL로 다시 설정하고 전화 번호를 다시 활성화합니다.
3. Webex Calling 팀은 Webex Calling의 장치 프로필에서 DMS URL을 서비스 공급자 DMS URL로 다시 설정합니다.
4. 파트너 관리자는 Control Hub 포털을 통해 Webex Calling에서 전화 번호를 비활성화하거나 삭제해야 합니다.
5. 파트너 관리자는 PSTN 전화 번호를 다시 Cisco BroadWorks로 이동해야 합니다.

복원 모드에서 장치 이동 도구를 실행하기 위한 안내

복원 모드에서 장치 이동 도구를 실행하려면 아래 단계를 따르십시오.

장치 이동 도구 디렉터리 내에서 보조 Cisco BroadWorks 응용프로그램 서버에서 아래 명령을 실행합니다.

프로필 복원

./devicemove.sh -input=  -revertProfiles

번호 복원

./devicemove.sh -input=  -revertNumbers

터미널 로그

복원 작업을 위한 장치 이동 도구를 성공적으로 실행하면 터미널에서 다음 로그를 가져옵니다.

프로필 복원

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

번호 복원

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