지원되는 전화는 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 경로가 이미 존재하는 경우, 도구에서 다시 사용됩니다.

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

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

실행할 안내

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

Windows:

token_generator.bat

MacOS:

./token_generator.sh

출력:

도구 이름: 토큰 생성기 도구 버전: 1.13.0 웹 브라우저에서 URL을 로드합니다. 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/프로비저닝

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> 주소 설명 ======================== 127.0.0.1 로컬로 가져오기 

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

 AS_CLI/Maintenance/ManagedObjects> Broadworks를 가져오고 출력이 올바른지 확인하십시오. 샘플 출력에 대해서는 아래를 참조하십시오. AS_CLI/Maintenance/ManagedObjects> broadworks BroadWorks 관리 개체 ========================== * 서버: 아이덴티티..............: AS 버전...............: Rel_21.sp1_1.551 관리 상태..: 잠금 해제됨 * 응용프로그램: 이름 버전 배포된 관리 상태 효과적인 상태 ========================================================================================= 실행AndProvisioning 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: 번호 활성화 명령어를 실행합니다.

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 스니펫을 참조하십시오.

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

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

   BROADWORKS_USER_ID = admin BROADWORKS_비밀번호 = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = 파트너 관리자의 새로 고침 토큰이 토큰 생성 도구에서 복사되었습니다. 마이그레이션_모드 = 지원되는 값은 webex_for_broadworks_to_wholesale입니다. 기본값은 broadworks_to_wholesale입니다. BroadWorks용 Webex 마이그레이션에 webex_for_broadworks_to_wholesale 을(를) 사용합니다. 

   새로 고침_토큰 속성은 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 내보내기 완료된 내보내기 덤프 우편 디렉터리 : output/20221017223452_ExportTool 내보내기 덤프 우편 파일 이름 :extracted_data_1666060500618.zip이라는 이름의 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 10월 17 22:34 output/ drwxrwxr-x 2 bwadmin bwadmin 4096 10월 17 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 10월 17 22:35 extracted_data_1666060500618.zip 

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

전제 조건

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

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

   새로 고침_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 이름_OF_MAIN_LOCATION=Main 

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

   프로비저닝_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" 회선 주석 해제

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 

2. 변환 도구 실행:

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

고객/사용자 사전 검사

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

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

사전 검사

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

사전 검사

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

터미널 로그

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

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

예외 보고서

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

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

예외 보고서 10월 18일 화 08:12:09 2022년 통신 차단 기능 권장 사항 기업: Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

출력

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

{ "customer": { "provisioningId": "!!!!!!!!!!REPLACE_포함_PROVISIONINGID!!!!!!!!!!", "패키지": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "주소": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "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": "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "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": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_포함_CUSTOMERID!!!!!!!!!!", "이메일": "amareswaranvel+benjaminjack@gmail.com", "패키지": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "성": "Jack", "primaryPhoneNumber": "+15205551102", "내선 번호": "1102" } }, "기능": [ { "/v1/people/{personId}/features/voicemail": { "활성화됨": true, "sendBusyCalls": { "활성화됨": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": { "활성화됨": true, "인사말": "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": { "활성화됨": true, "인사말": "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": { "활성화됨": true, "인사말": "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": { "활성화됨": true, "인사말": "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": "자동화된", "성": "음성 포털", "languageCode": "en_us", "전화 번호": "+15205551105", "내선 번호": "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": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "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. 마이그레이션 도구 바이너리를 다운로드하고 추출한 후 JAVA를 설정합니다._HOME 환경 변수 provisioning_toolMAC용 .sh 및 provisioning_toolWindows용 .bat.
3. partner.cfg 파일:
   • 도매점_프로비저닝_ID 및 새로 고침_토큰(토큰 생성기 도구에서 복사된 토큰)을 설정합니다. 파트너 관리자는 프로비저닝_ID를 확인하려면 계정 팀으로 연락해야 합니다.

     도매점_프로비저닝_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. BroadWorks용 Webex 마이그레이션에 대해 WEBEX4BWKS_EMAIL_SUBJECT 속성을 사용하여 BroadWorks용 Webex 구독자에 대한 비밀번호 변경 요청 이메일 제목을 보냅니다.
5. BroadWorks용 Webex 마이그레이션에 대해 WEBEX4BWKS_EMAIL_BODY 속성을 사용하여 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 온보딩 템플릿이 업데이트되면 Cisco 계정 팀에게 파트너 수준에서 "wholesale-partner-blending-enabled" 기능 토글을 활성화하도록 요청하십시오. 이를 통해 도매점 패키지가 프로비저닝 중에 기존의 BroadWorks용 Webex 고객 조직에 추가될 수 있습니다.

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

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

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

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

터미널 로그

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

도구 이름: 프로비저닝 도구 버전: 1.15.0 ********** 파일 처리 시작됨 : input/customer.json **************** 프로비저닝 고객 external_id_engg_grp1이 프로비저닝을 완료할 때까지 기다리는 고객... 고객 external_id_engg_grp1이 프로비저닝을 완료할 때까지 기다리는 중...   고객 external_id_engg_grp1 상태 : 프로비저닝 번호 프로비저닝 사용자 프로비저닝 사용자 기능 프로비저닝 인사말 프로비저닝 일정 프로비저닝 장치 프로비저닝 공유 통화 표시 프로비저닝 자동 전화 교환 프로비저닝 통화 대기열 프로비저닝 헌트 그룹 프로비저닝 그룹 페이징 프로비저닝 통화 지정 보류 프로비저닝 통화 당겨받기 프로비저닝 음성 포털 ********** 완료된 파일 : 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개의 요청을 제출할 수 있습니다.

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

그림 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 파일에서 새로 고침_토큰(토큰 생성기 도구에서 복사된 토큰)을 설정합니다.

   새로 고침_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   Broadworks_사용자_ID = admin BROADWORKS_비밀번호 = admin BROADWORKS_호스트_이름 = localhost 

3. 활성화 이메일을 다시 보내려면 conf/partner.cfg 파일에서 다시 보내기_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 응용프로그램 서버에서 실행됩니다.

장치 단일 고객 이동의 경우: ./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 장치 도구 시작됨... 마이그레이션에 대해 유효한 장치 : ------------------------------------------------------------------------------------------------------------------- | 장치 유형 | Mac | 버전 | 이메일 | ------------------------------------------------------------------------------------------------------------------- | 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 또는 [N]o) 예 DMS Cisco MPP LC에 대한 장치 프로필 업로드 장치 다시 빌드 프로세스 시작됨 장치 다시 빌드 프로세스가 성공적으로 완료됨 재부팅 프로세스 시작됨 재부팅 프로세스가 성공적으로 완료됨 그룹 collabmigrationtestGRP 아래에서 Business Communicator에 대한 프로필을 수정함_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 이동 통신 사업자용

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

터미널 로그

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

프로필 복원

도구 이름: 장치 이동 도구 버전: 복원 프로세스를 위한 1.15.0 장치 도구 시작됨... Webex Calling에서 BroadWorks로 다시 이동할 수 있는 장치: - ------------------------------------------------------------------------------------------------------------------- | 장치 유형 | Mac | 버전 | 이메일 | ------------------------------------------------------------------------------------------------------------------- | 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] 또는 [N] o)  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] 복원 시작 중 groupId에 대해 Broadworks 전화 번호 활성화 프로세스가 시작되었습니다. collabmigrationtestGRP_engg groupId에 대해 broadworks 전화 번호 활성화 과정이 완료되었습니다. collabmigrationtestGRP_engg 장치 마이그레이션 복원 과정이 성공적으로 완료됨