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

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

파트너 관리자는 마이그레이션 도구를 실행하기 전에 이 토큰 생성 유틸리티 도구를 최소 한 번 실행해야 합니다. 이 도구를 실행하는 것은 파트너 계정이 도매 RTM 솔루션에 온보딩된 후 한 번만 수행하면 되는 작업입니다. 이 도구를 사용하면 파트너 관리자가 웹 브라우저를 통해 로그인하여 마이그레이션 도구의 파트너 구성 파일을 업데이트하는 데 필요한 고유 토큰을 얻을 수 있습니다.

전제 조건

컴퓨터에 Java 8, 11, 17 또는 21을 설치하십시오. 자바는 다음과 같은 다양한 경로를 통해 구할 수 있습니다.

• 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

맥OS:

./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.

현재 GeneralSettings를 얻으려면 CLI에서 다음 명령을 실행하십시오.

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.

오픈 클라이언트 서버가 배포되어 활성화되었는지 확인하십시오.

보조 애플리케이션 서버에 Open Client Server가 배포되지 않았거나 아직 시작되지 않은 경우, 아래 명령어를 사용하여 Open Client Server를 배포하고 시작하십시오.

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 서비스 제공업체 포털에 통합되어 있습니다. 서비스 제공업체 관리자는 다음과 같은 작업을 수행할 수 있습니다.

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

다음 그림들은 서비스 제공업체 포털을 보여줍니다.

그림 6: 서비스 제공업체 포털

그림 7: 서비스 제공업체 포털

CSV 추출 요청

CSV 추출 요청 시작

1. 고객 CSV 파일을 다운로드하세요

   CSV 추출 요청 시작 섹션의 오른쪽 상단에 있는 고객 CSV 다운로드 [ 링크를 클릭합니다.

2. 고객 목록을 수정하세요

   관리자는 이 CSV 파일을 편집하여 데이터 추출이 필요한 고객만 포함시킬 수 있습니다.

3. 업로드 및 제출

   편집 후 수정된 CSV 파일을 업로드하세요.

   제출 을 클릭하여 나열된 고객 및 해당 위치 정보에 대한 추출 요청을 시작하십시오.

고객 위치 CSV 파일 추출 요청 시작

1. 고객 및 다운로드 위치를 선택하세요

   드롭다운 메뉴에서 고객을 선택하세요.

   ] 고객 보기→ 사이트 탭 → 위치를 CSV로 내보내기에서 해당 locations.csv 파일을 다운로드하세요.

2. 위치 파일을 편집하세요

   관리자는 CSV 파일을 편집하여 추출하고자 하는 위치만 포함시킬 수 있습니다.

3. 업로드 및 제출

   수정된 locations.csv 파일을 업로드하고 제출을 클릭하세요.

   선택한 고객에 대해 지정된 위치만 추출 요청에 포함됩니다.

모든 고객에 대한 추출 요청 시작

1. 제출 을 클릭하여 현재 서비스 제공업체에 속한 모든 고객 과 해당 고객의 모든 위치에 대한 추출 요청을 시작하세요.

Cisco BroadWorks 및 Webex for BroadWorks의 경우

1. 추출 도구는 파트너 네트워크 내의 보조 Cisco BroadWorks 애플리케이션 서버에서 실행되며 OCI-P를 통해 연결됩니다.
2. 이 도구는 Cisco BroadWorks 또는 BroadCloud 플랫폼에서 원시 엔터프라이즈, 그룹, 번호, 사용자, 서비스, 장치 및 소프트 클라이언트 데이터를 가져와 변환 도구의 입력으로 사용할 수 있는 XML 파일로 출력합니다.

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

전제 조건

1. SCP를 사용하여 추출 도구 바이너리를 보조 Cisco BroadWorks 애플리케이션 서버로 전송합니다.
2. 필수 구성 요소를 구성하고 추출 도구를 실행하려면 보조 Cisco BroadWorks 애플리케이션 서버에 SSH로 접속하십시오.
3. Cisco BroadWorks에서 추출할 서비스 제공업체 및 그룹 ID를 구성합니다. conf/exportTool.yml. 다음 YAML 코드 예시를 참조하십시오.

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

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   Webex를 BroadWorks로 마이그레이션하려면 REFRESH_TOKEN 속성이 필수입니다.

5. 수정하세요 JDK/JRE 보조 Cisco BroadWorks 애플리케이션 서버의 경우 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. REFRESH_TOKEN(토큰 생성 도구에서 복사한 토큰)과 NAME_OF_MAIN_LOCATION을 설정하세요. conf/partner.cfg 파일:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. 선택적으로 파트너 허브의 템플릿에서 복사한_프로비저닝 ID를 설정합니다. conf/partner.cfg 파일:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   고객 이메일 주소에 대한 보다 완전한 확인을 위해 선택적으로_프로비저닝 ID를 설정할 수 있습니다.
3. 누락된 정보를 구성하세요 input/customers.csv 파일이 없는 경우 (다음 섹션 참조).
4. 최종 사용자 이메일 주소를 추가하세요 input/users.csv 파일.
5. 새 휴대폰을 등록해야 하는 경우, 사용자의 새 휴대폰의 MAC 주소와 이메일 주소를 추가하십시오. input/newphones.csv 파일. 이는 파트너 관리자가 도매 통화에 새 전화기를 추가하려는 경우에만 필요합니다.
6. BroadWorks 콜센터를 CxEssentials로 전환하려면 다음을 사용하십시오. input/cxessentials.csv 파일.
7. 선택적으로, 모든 콜센터를 CxEssentials로 변환하려면 UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS 속성을 활성화하십시오.
8. 사용하세요 input/locations.csv 관리자가 고객 위치를 하나씩 마이그레이션할 수 있도록 대규모 기업 마이그레이션을 지원하는 파일입니다.
9. Cisco BroadWorks 장치 프로필에서 MAC 주소를 사용할 수 없는 경우 SIP REGISTER 메시지의 User-Agent 헤더에서 MAC 주소를 사용하도록 선택적으로 활성화할 수 있습니다. USE_MAC_ADDRESS_FROM_SIP_줄의 주석을 해제하세요. REGISTER=yes 파일 conf/partner.cfg
10. 선택적으로 ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD, 및 ANALOG_USER_TYPE_DISABLE_T38 속성을 활성화하여 모든 아날로그 유형 사용자에 대해 통화 대기, 대기 음악 및 T38 비활성화 설정을 구성할 수 있습니다.

11. 범용 게이트웨이 장치를 설정하려면 장치의 MAC 주소와 사용자 ID를 추가하십시오. input/genericgateways.csv 파일. 또한, 해당 사용자가 기본 소유자인지 아니면 공유 사용자(공유 통화 화면의 경우)인지 여부를 명시하십시오. 이는 파트너 관리자가 도매 통화에서 일반 게이트웨이 장치를 사용하려는 경우에만 필요합니다.

    이 기능은 BroadCloud에서 Wholesale로의 마이그레이션에는 사용할 수 없습니다.

12. BroadCloud 마이그레이션의 경우 메시징 스테이션 유형이 []인 모든 사용자를 voice_mail_group로 변환하려면 conf/rialto_station_type_to_wholesale_package.csv 파일을 업데이트하여 [ Rialto Station Type 이 messaging인 행의 Wholesale Package 값을 voice_mail_group 로 바꿉니다.

    선택적으로 partner.cfg에서 COMMON_VOICE_MAIL_GROUP_PASSCODE 속성을 활성화하여 음성 메일 그룹의 기본 PIN을 구성할 수 있습니다.

    partner.cfg에 이 속성이 지정되지 않은 경우, customers.csv 파일의 commonVoicemailGroupPassCode 열에 고객별로 해당 속성을 제공해야 합니다.

13. 일반 연락처를 Webex 통화로 마이그레이션하기 위해

    이는 기업 및 사이트 수준의 공통 연락처 관리를 위한 개선 사항입니다. 이러한 연락처는 구성 설정에 따라 조직 연락처(Org Contacts) 또는 가상 내선 번호로 마이그레이션할 수 있습니다. 아래는 마이그레이션 과정을 안내하는 세부 정보입니다.

    주요 설정:

    • 일반 전화 목록으로__가상_내선 으로__시작__범위

      partner.cfg 파일에 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE라는 새로운 속성이 추가되었습니다. 이 속성은 공통 연락처가 Rialto에서 Webex Calling으로 마이그레이션되는 방식을 결정합니다.

    • _일반_전화 목록_없이_가상_내선_시작_범위 구성됨

      일반 연락처는 조직 연락처(Org Contacts)로 이전됩니다.

      별도의 설정이 필요하지 않습니다.

      연락처 정보는 조직 수준에서 계속 이용 가능합니다.

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE가 구성된 경우

      공통 연락처는 가상 내선 번호로 이전됩니다.

      각 연락처에는 내선 번호가 추가되며 내선의 시작 범위는 partner.cfg의 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE 속성에 정의됩니다.

      가상 내선 번호는 연락처 범위에 따라 조직 수준과 위치 수준 모두에서 지원됩니다.

14. Webex에서 기본 통화 녹음 업체를 활성화합니다.

    이 단계는 Dubber 로 구성된 사용자의 통화 녹음 설정을 Webex의 Cisco Native Call Recording 로 마이그레이션할 때만 필요합니다.

    이 옵션을 활성화 하려면:

    • partner.cfg 파일에서 다음 속성을 설정하세요. DEFAULT_CALL_RECORDING_VENDOR=Webex.
    • 또한, WEBEX_CALL_RECORDING_STORAGE_REGION 속성을 사용하여 저장 영역을 구성하십시오.

      BroadCloud의 온디맨드 녹화 옵션은 Webex 통화에서 지원되지 않습니다. 이러한 통화 녹음 설정은 이전되지 않으며 예외 보고서에 표시됩니다.

15. 마이그레이션에서 특정 전화번호 제외:

    마이그레이션 프로세스에서 특정 전화번호를 제외하려면 변환 도구를 사용하여 다음 두 단계 절차를 따라야 합니다.

    • 변환 도구를 처음 실행할 때. 작업이 완료되면 도구는 telephone_numbers_inventory.csv라는 이름의 파일을 생성하며, 해당 파일은 다음 위치에 저장됩니다. output/timestamp/ 예배 규칙서. 고객은 이 파일을 검토하고 향후 마이그레이션에서 제외할 각 전화번호의 "Drop Tn's" 열에 "예"라고 표시해야 합니다.
    • telephone_numbers_inventory.csv 파일을 적절한 제외 플래그로 업데이트한 후 변환 도구가 두 번째로 실행됩니다. 업데이트된 파일은 다음 형식으로 인수로 전달해야 합니다.

      ./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}

16. 선택적으로 ALLOW_RESTRICT_BY_PARTNER_MODE 속성을 OFF로 설정하면 고객 관리자가 Control Hub에서 파트너 정의 설정을 수정할 수 있습니다.
17. BroadCloud에서 Webex Calling으로 모바일 번호(BroadWorks Mobility)를 마이그레이션하려면 다음 단계를 따르세요.

    이 섹션에서는 BroadWorks Mobility(고객 모바일 번호) 기능이 BroadCloud (모바일 네트워크 통합)에서 Wholesale Webex Calling (Webex Go 모바일 네트워크 사업자)로 마이그레이션되는 과정을 설명합니다.

    필수 조건- 마이그레이션 프로세스를 시작하기 전에 파트너 관리자는 Cisco 계정 팀에 연락하여 클라우드 연결 PSTN(CCP) 공급업체 및 사용자 지정 통신 사업자 목록(CCL) 구성을 수행해야 합니다.

    ASSIGN_MOBILE_NUMBERS_TO_USERS, 새로운 속성이 partner.cfg 파일에 추가되었습니다. 이 속성을 활성화하면 휴대폰 번호를 사용자에게 할당하고 마이그레이션할 수 있습니다.

    • 이 기능은 BroadCloud-to-Wholesale 마이그레이션에만 지원됩니다.
    • Wholesale Webex에서는 BroadCloud와 달리 최종 사용자가 휴대전화 번호 또는 PSTN 번호 중 하나만 가질 수 있습니다(둘 다는 불가).
    • 휴대전화 번호가 사용자에게 할당되면 기본 PSTN 번호는 보조(대체) 번호가 됩니다.
    • 워크스페이스 또는 가상 회선으로 전환되는 사용자의 경우 휴대폰 번호를 이전할 수 없습니다.
    • Wholesale Webex에서 휴대폰 번호가 할당되면 Control Hub에서 활성 상태로 표시됩니다. 이 상태는 해당 번호가 즉시 통화를 받을 수 있다는 것을 의미하지는 않습니다. 통화 기능은 마이그레이션이 완전히 완료된 후에만 사용할 수 있습니다.
    • 발신 사용자 포털(CUP)에서 최종 사용자가 구성한 휴대폰 통합 설정은 마이그레이션되지 않습니다. 마이그레이션이 완료되면 전화번호, 휴대전화 번호 또는 내선 번호로 전화가 걸려오면 사용자의 모든 기기에서 벨소리가 울립니다.

채우다 input/customers.csv

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

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

채우다 input/users.csv

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

실행 방법 안내

변환 도구는 모든 운영 체제에서 실행할 수 있습니다. 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=

Customer/user 사전 점검

변환 도구는 잠재적인 프로비저닝 문제를 파악하기 위해 Webex에 API 호출을 합니다. 기본적으로 고객의 주소와 기본 이메일 주소를 검증합니다. 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

예외 보고서

Transform Tool은 예외 보고서를 출력/<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을 설치하십시오. 자바는 다음과 같은 다양한 경로를 통해 구할 수 있습니다.
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. 마이그레이션 도구 바이너리를 다운로드하고 압축을 푼 후, MAC용 provisioning_tool.sh 파일과 Windows용 provisioning_tool.bat 파일에서 JAVA_HOME 환경 변수를 설정하십시오.
3. partner.cfg 파일:
   • 도매_프로비저닝_ID와 새로 고침_토큰(토큰 생성 도구에서 복사한 토큰)을 설정합니다. 파트너 관리자는_프로비저닝 ID를 받기 위해 담당 계정 팀에 문의해야 합니다.

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

     Webex는 최종 사용자에게만 환영 이메일을 보냅니다. 고객 관리자는 환영 이메일을 받지 못합니다.

     미국과 캐나다에 거주하는 사용자 및 고객 관리자는 RedSky로부터 별도의 이메일 알림을 받습니다. RedSky E911 플랫폼에서 긴급 서비스 고객 계정 생성을 확인하기 위해 이메일을 발송합니다. 이 RedSky 이메일은 Webex 환영 이메일과는 별개이며 Webex 이메일 설정의 영향을 받지 않습니다. 미국과 캐나다의 도매업체의 경우, RedSky가 자동으로 긴급 서비스 제공업체로 설정됩니다.

4. Webex for BroadWorks 마이그레이션을 위해 Webex for BroadWorks 구독자에게 암호 변경 요청 이메일 제목을 보내려면 WEBEX4BWKS_EMAIL_SUBJECT 속성을 사용하십시오.
5. Webex for BroadWorks 마이그레이션을 위해 Webex for BroadWorks 구독자에게 암호 변경 요청 이메일 본문을 보내려면 WEBEX4BWKS_EMAIL_BODY 속성을 사용하십시오.
6. 고객 생성 후 태그를 추가하려면 CUSTOM_TAGS 속성을 사용하십시오.
7. 도매 할인을 적용하려면 파트너 관리자는 마이그레이션을 시작하기 전에 Cisco 계정 팀에 문의해야 합니다.

   APPLY_WHOLESALE_DISCOUNTS 라는 새로운 속성이 partner.cfg에 추가되었습니다. 이 속성을 활성화하면 사용자와 작업 공간에 할인을 적용할 수 있습니다.

실행 방법 안내

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

Windows

Windows 운영 체제에서 도구를 실행하려면 다음 단계를 수행하십시오.

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=

Webex for BroadWorks 마이그레이션을 위한 필수 조건

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

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

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

준비 단계: 이 단계는 관리자가 BroadWorks 사용자를 도매 구독자로 프로비저닝하고 BroadWorks 사용자를 위한 Webex를 계속 진행할 수 있는 기본 단계입니다.

유지 관리 단계: 두 번째 단계에서는 관리자가 기존 Webex for BroadWorks 사용자에게 도매 라이선스를 할당할 수 있습니다. 프로비저닝 도구를 실행할 때 인수 maintenance를 사용해야 합니다.

마이그레이션 후 단계: 이 단계는 관리자가 BroadWorks를 도매 버전으로 완전히 전환할 수 있는 최종 단계입니다. 프로비저닝 도구를 실행할 때 인수 postmigration를 지정해야 합니다.

터미널 로그

다음은 프로비저닝이 성공적으로 완료되었을 때 터미널에 표시되는 로그입니다.

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

실행 시 생성된 위치 수를 나타내는 표가 출력됩니다.

출력

프로비저닝 도구는 출력/<external_id>내부에 성공 및 오류 보고서를 생성합니다. /*.success/error 파일. 프로비저닝이 성공적으로 완료되었는지 확인하려면 출력 성공 및 오류 로그를 검토하십시오.

시스템은 output/consolidated_reports/ 디렉터리에 Provisioning_Report_*.csv 파일을 생성합니다. 이 파일에는 각 엔티티 및 해당 설정에 대한 성공 및 실패 세부 정보가 모두 포함되어 있어 포괄적인 프로비저닝 보고서를 제공합니다.

파트너 관리자는 파트너 허브 및 컨트롤 허브 포털에서 고객 프로비저닝을 확인할 수 있습니다. 파트너 허브 및 컨트롤 허브 포털의 다음 그림을 참조하십시오.

그림 8: Partner Hub

그림 9: Control Hub

그림 10: 장치

그림 11: 통화

프로비저닝 후 제한 사항

BroadCloud 마이그레이션 프로비저닝이 완료되면 다음 작업은 차단됩니다:

• CAP 포털 – 사용자 또는 포팅된 장치 추가.
• SP 포털 – 장치 또는 번호를 사용하여 추가 주문을 생성합니다.
• RSB API – 기기 또는 번호를 사용하여 추가 주문을 생성하고 사용자를 생성합니다. 기기 또는 번호를 사용하여 RSB ADD 주문을 하는 경우 주문이 거부됩니다.

브로드클라우드용

BroadCloud 파트너의 경우 서비스 제공업체 포털을 사용하여 번호, 장치 및 공유 통화 표시(SCA) 마이그레이션 요청을 제출하십시오.

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

관리자는 conf/partner.cfg 파일에 ROLLBACK_TO_BROADCLOUD=true 를 설정하여 자동 롤백을 활성화할 수 있으며, 이렇게 하면 마이그레이션 후 장치가 BroadCloud로 다시 이동합니다. NS Sync를 사용하면 동일 지역 및 다른 지역으로의 마이그레이션을 모두 지원하지만, 마이그레이션이 성공적으로 완료된 경우에만 가능합니다. 실패한 경우 관리자는 롤백을 요청하기 전에 Cisco TAC에 문의해야 합니다.

포털에서 마이그레이션 유형을 선택하는 데 사용할 수 있는 옵션은 두 가지입니다.

• 마이그레이션 – 번호, 기기 및 공유 통화 표시(SCA) 마이그레이션 요청을 시작하려면 이 옵션을 선택하십시오.
• 장치 상태 – BroadCloud 및 통화에서 장치의 현재 상태를 보려면 이 옵션을 선택하십시오.

다음 그림들은 서비스 제공업체 포털을 보여줍니다.

그림 12: 서비스 제공업체 포털

그림 13: 서비스 제공업체 포털

선택한 위치를 마이그레이션합니다 (선택 사항)

customer.json 파일에 나열된 위치 중 특정 하위 집합에 대한 마이그레이션을 시작하려면 요청에 locations.csv 파일을 포함하세요. 이 CSV 파일에는 마이그레이션할 위치만 나열되어 있어야 합니다.

사용 가능한 활성 사이트 목록을 다운로드하려면 고객 보기 → 고객 선택 → 위치를 CSV로 내보내기로 이동하세요.

그림 14: 위치 정보를 CSV 파일로 내보내기

연결 끊김 번호 옵션을 활성화하세요

Webex 통화와 BroadCloud Carrier에 동일한 SIP 트렁크를 사용하는 경우 관리자는 번호 연결 해제 옵션을 사용해야 합니다. 이렇게 하면 BroadCloud로 마이그레이션 후 수신 전화가 차단됩니다.

이 옵션을 활성화하려면,

1. partner.cfg 파일에서 DISCONNECT_NUMBERS_FROM_RIALTO로 설정하십시오. = 예.
2. 동일한 customer.json 파일과 업데이트된 partner.cfg파일을 사용하여 마이그레이션 도구를 다시 실행하세요.

번호 연결이 끊어지지 않으면 Cisco TAC 요청을 제출하십시오.

Cisco BroadWorks 및 Webex for BroadWorks의 경우

Cisco BroadWorks 및 Webex for BroadWorks 마이그레이션의 경우, 해당 도구는 파트너 네트워크 내의 보조 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 마이그레이션을 위해 Wholesale에서 공유 통화 표시를 생성합니다. [This 이 단계는 BroadCloud에만 적용됩니다. migrations].

SCP와 SSH

1. SCP를 사용하여 장치 이동 도구를 보조 Cisco BroadWorks 애플리케이션 서버로 이동합니다.
2. 필수 구성 요소를 설정하고 장치 이동 도구를 실행하려면 보조 Cisco BroadWorks 애플리케이션 서버에 SSH로 접속하십시오.

전제 조건

1. REFRESH_TOKEN(토큰 생성 도구에서 복사한 토큰)을 설정하세요. conf/partner.cfg 파일:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. 활성화 이메일을 다시 보내려면_구독자_환영_을 전송하도록 설정해야 합니다. EMAIL=true 에서 conf/partner.cfg 파일.

   관리자가 마이그레이션 중에 사용자에게 초대 이메일을 보내려면 "SEND_SUBSCRIBERS_WELCOME_" 주석 처리를 해제해야 합니다. EMAIL=true" 부동산 conf/partner.cfg 파일. 그렇지 않으면 해당 속성은 변경되지 않은 상태로 유지되어야 합니다.

4. 확인하세요 JDK/JRE devicemove.sh에서 환경 변수 경로가 올바릅니다.

   JAVA_HOME=/usr/local/java/java_base

5. 관리자는 입력 디렉터리의 locations.csv 파일을 사용하여 기업 전체 그룹이 아닌 특정 그룹만 마이그레이션할 수 있습니다.

폴리콤 전화기

Polycom 전화기를 Cisco BroadWorks에서 Wholesale Calling으로 이전하려면 파트너 관리자가 새 계정을 생성해야 합니다. Identity/Device Cisco BroadWorks의 시스템 레벨에 있는 프로필 유형 파일 각 Polycom 장치 템플릿. 그림 14를 참조하여 사용자 지정 파일을 업로드하세요 . device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. 새 장치 파일을 업로드한 후, 새로 생성된 파일이 그룹 수준에 존재하는지 확인하십시오. 또한 파일 migration_%BWMAC ADDRESS%.cfg가 시스템에 이미 있는 파일과 충돌하지 않는지 확인하십시오.

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

폴리콤 전화기 마이그레이션 프로세스:

1. 장치 이동 도구는 장치 수준에서 파일 %BWMACADDRESS%.cfg를 polycom_vvx2.cfg로 바꿉니다. 이 파일은 migration_%BWMACADDRESS%.cfg를 참조합니다.
2. 그룹 수준 또는 장치 수준에서 장치 프로필을 다시 빌드하십시오.
   그룹 수준 또는 장치 수준에서 작동하는지 여부는 파일의 deviceLevelRebuild 매개변수 구성에 따라 달라집니다. device-move-tool/conf/partner.cfg.
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 전화기는 https://plcm.sipflash.com 에서 %BWMACADDRESS%.cfg 파일을 다운로드하고 Webex 통화 DMS에 의해 관리됩니다.

그림 14: Identity/device 프로필 유형 파일 추가

실행 방법 안내

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

출력

기기 마이그레이션이 완료되어 기기들이 온라인 상태가 되었고 사용 준비가 되었습니다. make/receive 전화. 장치 상태의 예시는 그림 15를 참조하십시오.

그림 15: 장치 상태

기기 마이그레이션이 완료된 후, 번호가 활성화되었습니다. 활성화된 숫자의 예시를 보려면 그림 16을 참조하십시오.

그림 16: 활성 번호

되돌리기 작업은 한 번에 하나의 기업에 대해 실행해야 합니다.

브로드클라우드 캐리어용

관리자는 자동 롤백을 활성화하기 위해 [ conf/partner.cfg 안에 ROLLBACK_TO_BROADCLOUD=true 를 설정할 수 있습니다. 이 기능은 NS Sync를 사용하여 동일 지역 또는 다른 지역으로 마이그레이션이 성공적으로 완료된 후 장치를 BroadCloud로 반환합니다. 마이그레이션이 실패한 경우 롤백을 요청하기 전에 Cisco TAC에 문의하십시오.

Cisco BroadWorks 및 Webex for BroadWorks의 경우

Cisco BroadWorks 및 Webex for BroadWorks의 복원 프로세스는 다음과 같습니다.

1. Cisco TAC에 티켓을 열어 장치 복원을 요청하십시오.
2. 장치 마이그레이션을 되돌리려면 보조 BroadWorks 애플리케이션 서버에서 장치 이동 도구를 되돌리기 모드로 실행하십시오. 이렇게 하면 Cisco BroadWorks의 장치 프로필에 대한 DMS URL이 서비스 제공업체 DMS URL로 다시 설정되고 전화번호가 다시 활성화됩니다.
3. Webex Calling 팀은 Webex Calling의 장치 프로필에서 DMS URL을 서비스 제공업체의 DMS URL로 다시 설정합니다.
4. 파트너 관리자는 제어 허브 포털을 통해 Webex 통화에서 전화번호를 비활성화하거나 삭제해야 합니다.
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