BroadWorks, BroadWorks용 Webex 및 BroadCloud에서 도매 RTM 솔루션으로 전환하는 마이그레이션 도구

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

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

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

전제 조건

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

MAC용 token_generator.sh 및 Windows용 token_generator.bat에서 JRE/JDK 환경 경로를 설정합니다. JAVA_HOME 경로가 이미 존재하는 경우 도구에 의해 다시 사용됩니다.

• 맥: JAVA_HOME="/사용자/cisco/jdk/zulu@1.8.282/콘텐츠/홈/"

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

실행 지침

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

Windows:

token_generator.bat

맥OS:

./token_generator쉬

산출:

도구 이름: 토큰 생성기 도구 버전: 1.13.0 웹 브라우저에서 URL을 로드합니다. http://localhost:8080://localhost:8080://localhost:8080://localhost:8080://localhost:8080:// 

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

사용자 인터페이스 일러스트레이션은 아래와 같이 참조할 수 있습니다.

그림 3: Cisco Webex로 로그인

그림 4: 인증서 창

그림 5: 토큰 생성

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

OCI-P 연결 활성화

장치 이동 도구는 OCI-P 명령을 통해 OCI-P 연결성을 활성화하기 위해 다음 단계를 사용하여 BroadWorks와 통신합니다.

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> 주소 설명 ======================== 127.0.0.1 local as 

4단계: CLI에서 아래 명령을 실행하여 구성이 올바른지 확인합니다.

 AS_CLI/Maintenance/ManagedObjects>는 broadworks를 활용하고 출력이 괜찮은지 확인합니다. 샘플 출력은 아래를 참조하십시오. AS_CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== * 서버: 확인..............: AS 버전...............: Rel_21.sp1_1.551 행정 주..: 잠금 해제 * 응용 프로그램: 이름 버전 배포된 관리 상태 유효 상태 ========================================================================================= 실행 및 프로비저닝 21.sp1_1.551 true 잠금 해제됨 잠금 해제됨 FlashPolicy 21.sp1_1.551 false 잠금 해제됨 중지됨 OpenClientServer 21.sp1_1.551 true 잠금 해제됨 잠금 해제됨 WebContainer 21.sp1_1.551 true 잠금 해제됨 잠금 해제됨 4 항목을 찾았습니다. * 호스팅된 애플리케이션: 이름 버전 컨텍스트 경로는 ================================================================== 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 항목을 찾았습니다. 

오픈 클라이언트 서버 배포 및 활성 확인

아래 명령어를 사용하여 보조 응용프로그램 서버가 배포되지 않았거나 이미 시작되지 않은 경우 클라이언트 서버 열기 기능을 배포하고 시작합니다.

1단계: 다음 CLI 명령어로 서버를 배포합니다.

AS_CLI/Maintenance/ManagedObjects> 애플리케이션 배포 OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> 애플리케이션 시작 OpenClientServer

번호 활성화 활성화

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

1단계: 번호 ation 명령을 실행합니다.

AS_CLI> cd 가입자 관리/번호 활성화

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

AS_CLI> 설정 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. 보조 Cisco BroadWorks 애플리케이션 서버에 대한 SSH를 사용하여 전제 조건을 구성하고 추출 도구를 실행합니다.
3. conf/exportTool.yml에서 Cisco BroadWorks에서 추출할 서비스 공급자 및 그룹 ID를 구성합니다. 아래 샘플 YAML 스니펫을 참조하십시오.

   서비스 제공자ID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 서비스 제공자ID-B:                        - 모두 

4. conf/partner.cfg 파일에 보조 Cisco BroadWorks 애플리케이션 서버 사용자 ID, 암호 및 호스트 이름이 올바른지 확인합니다.

   BROADWORKS_사용자_ID = 관리 BROADWORKS_암호 = 관리 BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = 토큰 생성기 도구에서 복사된 파트너 관리자의 새로 고침 토큰입니다. MIGRATION_MODE = 지원되는 값은 webex_for_broadworks_to_wholesale입니다. 기본값은 broadworks_to_wholesale입니다. BroadWorks용 webex_for_broadworks_to_wholesale Webex 마이그레이션에 대해 사용합니다. 

   새로 고침_토큰 속성은 BroadWorks용 Webex 마이그레이션에 대해 필수입니다.

5. 보조 Cisco BroadWorks 애플리케이션 서버 JDK/JRE 환경 경로가 파일과 다른 경우 export.sh 파일에서 JDK/JRE 환경 경로를 수정합니다.

   JAVA_HOME=/usr/local/java/java_base

실행 지침

추출 도구 디렉터리에서 보조 Cisco BroadWorks 애플리케이션 서버에서 아래의 명령을 실행합니다.

./export.sh

터미널 로그

다음 로그는 성공적인 내보내기의 터미널에서 사용할 수 있습니다. BroadSoft 데이터 내보내기 도구 실행 중:

 BroadSoft 데이터 내보내기 도구 실행 ************************************************ 내보내기 도구 v: 1.15.0 SP=collabmigrationtestSP에 대해 시작된 내보내기_engg, Group=collabmigrationtestGRP_engg SP=collabmigrationtestSP에 대한 사용자 내보내기_engg, Group=collabmigrationtestGRP_engg SP=collabmigrationtestSP에 대해 완료된 사용자 내보내기_engg, Group=collabmigrationtestGRP_engg SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg 내보내기 완료된 내보내기 덤프 Zip 디렉터리: output/20221017223452_ExportTool 내보내기 덤프 Zip 파일 이름 :extracted_data_1666060500618.zip 파일 이름의 extracted_data_1666060500618.zip은 ZIP 파일 생성 프로세스가 완료되었습니다. ZIP 파일로 변환 된 내보내기 파일 ************************************************** 

출력

출력 ZIP(extracted_data_.zip) 파일은 동일한 추출 도구 디렉터리에서 사용할 수 있습니다. 아래의 명령어를 사용하여 변환 도구 입력에 대한 ZIP 파일을 보고 사용합니다.

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 10월  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 10월  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 10월  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 10월  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_.zip) 파일을 입력으로 읽고 원시 XML을 프로비저닝 도구에서 사용하는 JSON 형식으로 변환합니다.

전제 조건

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

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

   새로 고침_토큰=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 이름_of_MAIN_LOCATION=Main 

2. (Partner Hub의 템플릿에서 복사) PROVISIONING_ID를 conf/partner.cfg 파일에 선택적으로 설정합니다.

   프로비저닝_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   고객 이메일 주소를 보다 완전하게 확인하려면 선택적으로 프로비저닝_ID를 설정할 수 있습니다.
3. 누락된 경우 input/customers.csv 파일에서 누락된 정보를 구성합니다(다음 섹션 참조).
4. 입력/users.csv 파일에 최종 사용자 이메일 주소를 추가합니다.
5. 새 전화기를 프로비저닝해야 하는 경우 사용자의 새 전화기의 mac 주소 및 이메일 주소를 입력/newphones.csv 파일에 추가합니다. 이는 파트너 관리자가 도매 통화에서 새 전화기를 프로비저닝하려는 경우에만 필요합니다.
6. input/cxessentials.csv 파일을 사용하여 BroadWorks 콜센터를 CxEssentials로 변환합니다.
7. 선택적으로 모든 통화 센터를 CxEssentials로 변환하려면 UPGRADE_ALL_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" 행에 대한 설명을 취소합니다.

입력/고객 채우기.csv

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

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

실행 지침

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

Windows

아래의 명령을 실행하여 Windows에서 변환 도구를 실행합니다.

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

macOS

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

1. 가상 환경을 만들고 종속성을 설치하여 Python을 사용하여 변환 도구를 실행합니다.

   python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 파이썬3 -m venv venv source venv/bin/activate python3 -m pip install requests-oauthlib 

2. 변환 도구 실행:

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

고객/사용자 사전 확인

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

또한 변환 도구를 실행할 때 다음 옵션 매개 변수를 추가할 수 있습니다.

사전 확인

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

precheckinfo 정보

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

터미널 로그

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

요약 보고서 성공적으로 마이그레이션할 수 있는 BroadWorks 기업: 1 마이그레이션할 수 없는 BroadWorks 기업: 0 성공적으로 마이그레이션할 수 있는 BroadWorks 사용자: 4 마이그레이션할 수 없는 BroadWorks 사용자: 0 성공적으로 마이그레이션할 수 있는 전화기: Webex Calling과 호환되지 않는 3개의 전화: 0 

예외 보고서

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

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

예외 보고서 Tue Oct 18 08:12:09 2022 통신 차단 기능을 갖춘 기업 권장 사항: Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

출력

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

{ "customer": { "provisioningId": "!!!!!!!!!!대체_함께_PROVISIONINGID!!!!!!!!!!", "패키지": [ "webex_calling'''합계'''common_area_calling" ], "외부Id": "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": { "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "timezone": "America/New_요크", "언어": "en_us", "번호": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110"], "mainNumber": "+15205551101" } } } }, "broadworks_info'''합계'''service_provider_id사진: “collabmigrationtestSP”_engg'''합계'''group_id사진: “collabmigrationtestGRP”_engg" }, "가입자": [ { "amareswaranvel+benjaminjack@gmail.com": { "가입자": { "customerId": "!!!!!!!!!!REPLACE_함께_CUSTOMERID!!!!!!!!!!", "이메일": "amareswaranvel+benjaminjack@gmail.com", "포장": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "활성화됨": 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": { "활성화됨": 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": { "활성화됨": 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": { "활성화됨": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": { "enabled": true, "greeting": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_함께_PERSONID!!!!!!!!!!", "product": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants'''합계'''call_queues'''합계'''hunt_groups": [], "일정": [],call_parks'''합계'''call_pickups'''합계'''paging_groups'''합계'''voice_portals": [ { "name": "자동화된 음성 포털", "firstName": "자동화된", "lastName": "음성 포털", "languageCode": "en_us", "phoneNumber": "+15205551105", "extension": "1105" } ], "shared_call_appearances'''합계'''business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg 장치 프로필"], "connect_client_to_upgrade_to_webex_app": [], "위치": [],webex_for_broadworks_info": { "사용자": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

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

전제 조건

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

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

     도매_프로비저닝_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 새로 고침_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. BroadWorks용 Webex 마이그레이션에 대해 WEBEX4BWKS_이메일_제목 속성을 사용하여 BroadWorks용 Webex 구독자에 대한 비밀번호 변경 요청 이메일 제목을 보냅니다.
5. BroadWorks용 Webex 마이그레이션에 대해 WEBEX4BWKS_이메일_본문 속성을 사용하여 BroadWorks용 Webex 가입자에 대한 비밀번호 변경 요청 이메일 본문을 보냅니다.

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

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

BroadCloud 마이그레이션의 경우 다른 지역:

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

실행 지침

아래 단계를 사용하여 Windows 및 macOS에서 도구를 실행하십시오.

Windows

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

단일 고객을 프로비저닝하려면: provision.bat -input= 여러 고객을 프로비저닝하려면: provision.bat -input=(변환-도구-타임스탬프-출력-디렉터리-경로) 

macOS

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

단일 고객을 프로비저닝하려면: ./transform.sh -input= 여러 고객을 프로비저닝하려면: ./transform.sh -input= 

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

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

BroadWorks용 Webex에서 도매 마이그레이션에 대한 추가 인수로 프로비저닝 도구를 실행합니다.

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

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

마이그레이션 후 단계: 최종 단계 wher 관리자는 BroadWorks를 도매로 완전히 변환할 수 있습니다. 인수 마이그레이션 후로 프로비저닝 도구를 실행해야 합니다.

터미널 로그

다음은 성공적인 프로비저닝의 터미널에 있는 로그입니다.

도구 이름: 프로비저닝 도구 버전: 1.15.0 ********** 파일 처리 시작 : input/customer.json **************** 프로비저닝 고객 고객 프로비저닝을 완료하기 위해 고객 external_id_engg_grp1을 기다리는 중... 고객 1이 프로비저닝을 external_id_engg_grp완료할 때까지 기다리는 중...   고객 external_id_engg_grp1 상태: 프로비저닝된 프로비저닝 번호 프로비저닝 사용자 프로비저닝 사용자 기능 프로비저닝 인사말 프로비저닝 스케줄 프로비저닝 장치 프로비저닝 공유 통화 현황 프로비저닝 프로비저닝 자동 전화 교환 프로비저닝 통화 대기열 프로비저닝 헌트 그룹 프로비저닝 그룹 페이지 프로비저닝 통화 지정보류 프로비저닝 통화 픽업 프로비저닝 음성 포털 ********** 완료된 파일 : 입력/customer.json **************** 

각 실행에 대해 생성된 위치의 수와 함께 표가 인쇄됩니다.

출력

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

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

그림 8: 파트너 허브

그림 9: Control Hub

그림 10: 장치

그림 11: 통화

BroadCloud용

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

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

아래 숫자는 서비스 공급자 포털을 표시합니다.

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

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

Cisco BroadWorks 및 BroadWorks용 Webex용

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

성공적인 작동 시 장치 이동 도구는 다음과 같습니다.

1. Cisco BroadWorks에서 장치를 등록 해제하고 도매로 등록합니다.
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 파일에서 새로 고침_토큰(토큰 생성기 도구에서 복사된 토큰)을 설정합니다.

   새로 고침_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. 보조 Cisco BroadWorks 애플리케이션 서버 사용자 ID, 암호 및 호스트 이름이 conf/deviceMoveTool.conf 파일에 올바른지 확인합니다.

   BROADWORKS_사용자_ID = 관리 BROADWORKS_암호 = 관리 BROADWORKS_호스트_이름 = localhost 

3. devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

   에서 JDK/JRE 환경 경로가 올바른지 확인합니다
4. 관리자는 입력 디렉터리의 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. 그룹 수준 또는 장치 수준에서 장치 프로필을 다시 빌드합니다.
   그룹 수준 또는 장치 수준에서 실행은 파일 device-move-tool/conf/partner.cfg에서 파라미터 deviceLevelRebuild의 구성에 따라 달라집니다.
3. 장치 이동 도구는 Cisco BroadWorks 애플리케이션 서버에서 그룹 수준 또는 장치 수준에서 전화기를 재부팅하도록 요청합니다.
4. 재부팅 요청 후, Polycom 전화기를 다운로드하고 process% BWMACADDRESS%.cfg를 처리합니다. Polycom 전화기는 device.prov.serverName을 https://plcm.sipflash.com.(으)로 설정하는 migration_%BWMACADDRESS%.cfg를 다운로드하고 처리하도록 요청합니다.
   https://plcm.sipflash.com 미국 지역에 대해 다른 지역에 다른 URL이 있습니다.
5. Polycom 전화는 https://plcm.sipflash.com 에서 %BWMACADDRESS%.cfg를 다운로드하고 Webex Calling DMS에서 관리합니다.

그림 14: ID/장치 프로필 유형 파일 추가

실행 지침

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

장치 이동 도구는 장치 이동 도구 디렉터리 내의 보조 Cisco BroadWorks 애플리케이션 서버에서 실행됩니다.

디바이스 이동 단일 고객의 경우: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json 디바이스에서 여러 고객을 이동하려면: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json 디바이스 이동 도구는 1.35.0 릴리즈에서 단일/특정 전화기 마이그레이션을 지원합니다. 아래의 명령을 사용하십시오. ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

터미널 로그

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

도구 이름: 장치 이동 도구 버전: 1.15.0 장치 도구 시작됨... 마이그레이션을 위한 유효한 장치: ------------------------------------------------------------------------------------------------------------------- | 장치 유형 | 맥 | 버전 | 이메일 | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- 이 모든 장치를 마이그레이션하시겠습니까? ([Y]es or [N]o) 예 DMS Cisco MPP LC 재건 장치 프로세스에 대한 장치 프로필 업로드 장치 프로세스 재건 시작 장치 프로세스 완료 성공적으로 재부팅 프로세스 시작 재부팅 프로세스 완료 성공적으로 그룹 collabmigrationtestGRP_engg 아래에서 비즈니스 커뮤니케이터에 대한 프로필 수정 고객 조직 ID에 대해 시작된 webex 전화 번호 프로세스 활성화 : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c 고객 조직 id에 대해 완료된 webex 전화 번호 프로세스 활성화: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c groupId에 대해 시작된 broadworks 전화 번호 프로세스 비활성화 : collabmigrationtestGRP_engg groupId에 대해 완료된 broadworks 전화 번호 프로세스 비활성화: collabmigrationtestGRP_engg 장치 마이그레이션 완료됨 

출력

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

그림 15: 장치 상태

장치 마이그레이션 후 번호가 활성화됩니다. 숫자 16을 참조하여 숫자의 예제가 활성화되어 있는지 확인합니다.

그림 16: 번호 활성

한 번에 한 기업에 대해 되돌리기 작업을 실행해야 합니다.

BroadCloud Carrier용

BroadCloud 파트너에 대한 되돌리기 프로세스는 다음과 같습니다.

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

Cisco BroadWorks 및 BroadWorks용 Webex용

Cisco BroadWorks 및 BroadWorks용 Webex에 대한 되돌리기 프로세스는 다음과 같습니다.

1. 장치 복원을 요청하려면 Cisco TAC에서 티켓을 엽니다.
2. 보조 BroadWorks 애플리케이션 서버의 되돌리기 모드에서 장치 이동 도구를 실행하여 장치 마이그레이션을 되돌립니다. 이렇게 하면 DMS URL이 Cisco BroadWorks의 장치 프로필에 대한 서비스 공급자 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= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles(변환-도구-출력-고객-JSON-파일-경로)

번호 되돌리기

./devicemove.sh -input=  -revertNumbers

터미널 로그

되돌리기 작업을 위해 장치 이동 도구를 성공적으로 실행하는 터미널에서 다음 로그를 가져옵니다.

프로필 되돌리기

도구 이름: 장치 이동 도구 버전: 1.15.0 되돌리기 프로세스에 대해 시작된 장치 도구... Webex Calling에서 BroadWorks로 다시 이동할 수 있는 장치: - ------------------------------------------------------------------------------------------------------------------- | 장치 유형 | 맥 | 버전 | 이메일 | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Webex Calling에서 BroadWorks로 해당 장치를 다시 이동하시겠습니까? (예, Y, 아니요, N):  예 DMS Cisco MPP LC에 대한 장치 프로필 업로드 장치 프로세스 재구축 장치 프로세스 재구축 시작 성공적으로 재부팅 프로세스 시작 재부팅 프로세스 완료 성공적으로 장치 마이그레이션 완료 프로비저닝 해제 프로세스에 대해 완료됨 

번호 되돌리기

도구 이름: 장치 이동 도구 버전: 1.15.0 Broadworks로 번호를 계속 되돌리시겠습니까?  ([Y]es 또는 [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] 되돌리기 시작 groupId에 대해 시작된 broadworks 전화 번호 프로세스를 활성화합니다. collabmigrationtestGRP_engg groupId에 대해 완료된 broadworks 전화 번호 프로세스 활성화: collabmigrationtestGRP_engg 장치 마이그레이션 되돌리기 프로세스가 성공적으로 완료됨