피드백을 보내 주셔서 감사합니다.

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

마지막 열은 transform-tool/input/newphones.csv 파일의 “기기 유형” 열에 대한 전화 모델 매핑을 제공합니다. (newphones.csv 관련 자세한 내용은 이 문서의 변형 툴 섹션을 참조하세요.)

파트너 관리자는 마이그레이션 도구 실행을 시작하기 전에 이 토큰 생성기 유틸리티 도구를 한 번 이상 실행해요. 이 도구를 실행하는 것은 파트너 계정이 Wholesale RTM 솔루션에 등록된 후 한 번만 하면 돼요. 이 도구를 사용하면 파트너 관리자가 웹 브라우저로 로그인하여 마이그레이션 도구의 파트너 구성 파일을 업데이트하는 데 필요한 고유 토큰을 얻을 수 있어요.

전제조건

컴퓨터에 자바 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

다운로드 후 마이그레이션 툴 바이너리를 추출해.

실행 지침

토큰 생성기 디렉토리 내 터미널에서 다음 명령을 실행하세요.

윈도우:

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 명령을 통해 브로드웍스와 통신해요. OCI-P 연결을 활성화하려면 아래 단계를 사용하세요.

1단계: CLI를 사용하여 일반 설정을 구성해요.

CLI에서 다음 명령을 실행하여 GeneralSettings 디렉토리로 변경하세요.

AS_CLI> cd /Applications/OpenClientServer/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.

오픈 클라이언트 서버가 배포되고 활성 상태인지 확인해

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

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 입력하세요.

브로드클라우드용이에요

추출 도구가 브로드클라우드 서비스 제공업체 포털에 통합되어 있어요. 서비스 제공자 관리자는 다음을 할 수 있어요.

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. 제출을 눌러 모든 고객과 현재 서비스 제공업체 소속의 모든 위치에 대해 추출 요청을 시작하세요.

시스코 브로드웍스, 브로드웍스용 웹엑스용

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

다음 섹션에서는 추출 도구 설치 및 구성 방법을 설명해요.

전제조건

1. 추출 도구 바이너리를 보조 시스코 브로드웍스 애플리케이션 서버에 SCP로 보내세요.
2. 필수 구성 및 추출 도구 실행을 위해 보조 Cisco BroadWorks 애플리케이션 서버에 SSH로 연결해요.
3. CONF/ExportTool.yml에서 시스코 브로드웍스에서 추출할 서비스 제공자와 그룹 ID를 구성하세요. 다음 샘플 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.
   

   REFRESH_TOKEN 속성은 브로드웍스용 웹엑스 마이그레이션에 필수예요.

5. 보조 시스코 브로드웍스 애플리케이션 서버 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_ .zip<timestamp>) 파일은 동일한 추출 도구 디렉터리에서 사용할 수 있어요. 변형 도구 입력용 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

관리자가 기업 프록시를 사용하여 도구를 운영하는 경우, 아래 단계에 따라 내보내기 스크립트를 구성하고 실행하세요.

내보내기 스크립트 구성 및 실행 단계

1. export.sh 파일 여세요.
2. HTTPS_PROXY_HOST 변수를 찾아 주석 처리를 제거하세요 (앞 # 제거).

3. HTTPS_프록시_호스트 값을 다음과 같이 설정하세요.

   HTTPS_PROXY_HOST=<proxy-host>

4. HTTPS_PROXY_PORT 변수를 찾아 주석 처리를 제거하세요 (앞 # 제거).
5. HTTPS_프록시_포트 값을 다음과 같이 설정하세요.

   HTTPS_PROXY_PORT=<proxy-port>

6. export.sh 파일 저장하고 닫으세요.
7. partner.cfg 파일을 열고 필요한 새로고침_토큰을 추가하세요.
8. 브로드웍스 호스트, 사용자 이름, 암호가 partner.cfg 파일에 올바르게 구성되어 있는지 확인하세요.
9. 스크립트 실행:

   ./export.sh

약혼 양식:

추출 도구 (브로드클라우드와 브로드웍스) 가 이제 실행 중에 참여 양식 SUA.xlsx 제목의 통합 XLSX 파일을 자동으로 생성해요. 파일은 관련 워크시트에서 사용 가능한 모든 데이터로 미리 채워져 있어 파트너 완료를 간소화하고 가속화할 수 있어요.

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

전제조건

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

1. conf/partner.cfg 파일에서 REFRESH_TOKEN (토큰 제너레이터 도구에서 복사한 토큰) 과 NAME_OF_MAIN_LOCATION을 설정하세요.

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. 필요에 따라 conf/partner.cfg 파일에 PROVISIONING_ID (파트너 허브의 템플릿에서 복사) 를 설정하세요.

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   고객 이메일 주소를 더 완벽하게 확인하려면 선택적으로 PROVISIONING_ID를 설정할 수 있어요.
3. 누락된 정보가 있으면 input/customers.csv 파일에서 누락된 정보를 구성하세요 (다음 섹션 참조).
4. input/users.csv 파일에 최종 사용자 이메일 주소를 추가해요.
5. 새 휴대폰을 프로비전하려면 사용자 새 전화의 mac 주소와 이메일 주소를 input/newphones.csv 파일에 추가하세요. 파트너 관리자가 도매 통화에서 새 전화를 제공하려는 경우에만 필요해요.
6. input/cxessentials.csv 파일을 사용하여 브로드웍스 콜센터를 CXEssentials로 변환하세요.
7. 선택적으로 UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS 속성을 활성화해서 모든 콜 센터를 CXEssentials로 변환하세요.
8. 관리자가 고객 위치를 위치별로 마이그레이션할 수 있게 해주는 대기업 마이그레이션을 지원하는 데 input/locations.csv 파일을 사용하세요.
9. Cisco BroadWorks 장치 프로필에서 MAC 주소를 사용할 수 없을 때 SIP REGISTER 메시지의 사용자-에이전트 헤더에서 MAC 주소 사용을 선택적으로 활성화하세요. conf/partner.cfg 파일에서 use_Mac_Address_From_SIP_Register=Yes 줄 주석 제거해요
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 파일에 추가하세요. 또한 사용자가 주 소유자인지 공유 사용자인지 (공유 통화 출연의 경우) 적어주세요. 파트너 관리자가 홀세일 콜링에서 일반 게이트웨이 디바이스를 사용하려는 경우에만 필요해요.

    브로드클라우드에서 도매로 마이그레이션하는 경우에는 이 기능을 사용할 수 없어요.

12. 브로드클라우드 마이그레이션의 경우, 메시징 스테이션 유형의 모든 사용자를 voice_mail_group으로 변환하려면 리알토 스테이션 유형이 메시징인 행의 도매 패키지 값을 voice_mail_group으로 바꿔서 conf/rialto_station_type_to_wholesale_package.csv 파일을 업데이트하세요.

    선택적으로 partner.cfg 파일의 COMMON_VOICE_MAIL_GROUP_PASSCODE 속성을 활성화하여 음성 메일 그룹의 기본 PIN을 구성하세요.

    이 속성이 partner.cfg 내에 지정되지 않은 경우, customers.csv 파일의 CommonVoiceMailGroup 암호 열에 고객별로 입력해야 해요.

13. 일반 연락처를 다음으로 마이그레이션하려면 Webex Calling

    엔터프라이즈 및 사이트 수준의 일반 연락처 관리를 위한 개선 사항이에요. 이제 구성 설정에 따라 이러한 연락처를 조직 연락처 (조직 연락처) 또는 가상 내선으로 마이그레이션할 수 있어요. 다음은 이 마이그레이션 과정을 안내하는 세부 정보예요.

    키 구성:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      partner.cfg 파일에 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE라는 새 속성이 도입됐어요. 이 속성은 일반 연락처를 리알토에서 로 마이그레이션하는 방식을 결정해요. Webex Calling

    • 커먼_전화_LIST_TO_VIRTUAL_EXTENSION_START_RANGE 구성 안 함

      공통 연락처가 조직 연락처 (조직 연락처) 로 마이그레이션될 거예요.

      추가 구성이 필요 없어요.

      연락처는 조직 수준에서 계속 액세스할 수 있어요.

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE 구성해서

      공통 연락처는 가상 익스텐션으로 마이그레이션돼요.

      각 연락처에는 내선 번호가 추가되고 내선 번호의 시작 범위는 partner.cfg 의 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE 속성에 정의되어 있어요.

      가상 확장은 문의 범위에 따라 조직 수준과 위치 수준 모두에서 지원돼요.

14. Webex에 기본 통화 녹음 공급업체를 활성화해요.

    이 단계는 Dubber로 구성된 사용자의 통화 녹음 설정을 Webex의 Cisco 기본 통화 녹음으로 마이그레이션할 때만 필요해요.

    이 옵션 활성화하려면:

    • partner.cfg 파일에서 다음 속성을 설정하세요. Default_Call_Recording_vendor=Webex.
    • 또한 WEBX_CALL_RECORDING_STORAGE_REGION 속성을 사용하여 저장 지역을 구성하세요.

      브로드클라우드의 온디맨드 레코딩 옵션은 에서 Webex Calling 지원되지 않아요. 이 통화 녹음 설정은 마이그레이션되지 않고 예외 보고서에 표시돼요.

15. 선택한 전화번호 마이그레이션 시 제외하기:

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

    • 처음에 트랜스폼 툴을 처음으로 실행해요. 완료되면 도구가 출력/타임스탬프/ 디렉토리 내에 telephone_numbers_inventory.csv 파일을 생성해요. 고객이 이 파일을 검토하고 예정된 마이그레이션에서 제외해야 하는 각 전화번호의 “Drop Tn's” 열에 “예”라고 표시해야 해요.
    • 적절한 제외 플래그로 telephone_numbers_inventory.csv 파일을 업데이트한 후, 변형 도구가 두 번째로 실행돼요. 업데이트된 파일은 다음 형식의 인수로 전달되어야 해요.

      ./transform.sh -extract=입력/추출_데이터_1747640608219.zip -서비스 번호= {filepath/telephone_numbers_inventory.csv}

16. 선택적으로 ALLOW_RESTRICT_BY_PARTNER_MODE 속성을 OFF로 설정하면 고객 관리자가 컨트롤 허브에서 파트너가 정의한 설정을 수정할 수 있어요.
17. 브로드클라우드에서 휴대폰 번호 (브로드웍스 모빌리티) 를 마이그레이션하는 용도예요 Webex Calling

    이 섹션에서는 브로드웍스 모빌리티 (고객 휴대폰 번호) 기능을 브로드클라우드 (모바일 네트워크 통합) 에서 홀세일 Webex Calling (Webex Go 모바일 네트워크 사업자) 로 마이그레이션하는 방법을 간략하게 설명해요.

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

    새 속성 ASSIGN_MOBILE_NUMBERS_TO_USERS가 partner.cfg 파일에 추가됐어요. 이 속성을 활성화하면 휴대폰 번호를 할당하고 사용자들에게 이전할 수 있어요.

    • 이 기능은 브로드클라우드에서 도매로 마이그레이션하는 경우에만 지원돼요.
    • 홀세일 웹엑스에서는 최종 사용자가 휴대폰 번호나 PSTN 번호 (둘 다 가질 수는 없음) 를 가질 수 있어요. 브로드클라우드와 다르게 말이죠.
    • 휴대폰 번호가 사용자에게 할당되면 주 PSTN 번호가 보조 (대체) 번호가 돼요.
    • 워크스페이스 또는 가상 회선으로 전환되는 사용자의 휴대폰 번호는 마이그레이션할 수 없어요.
    • 홀세일 웹엑스에서 휴대폰 번호를 할당하면 컨트롤 허브에 활성으로 표시돼요. 이 상태라고 해서 번호가 바로 전화를 받을 준비가 된 건 아니에요. 통화 기능은 마이그레이션이 완전히 완료된 후에만 사용할 수 있어요.
    • 최종 사용자가 발신 사용자 포털 (CUP) 에서 구성한 휴대폰 통합 설정은 마이그레이션되지 않아요. 마이그레이션 후에 전화번호, 휴대폰 번호, 내선 번호 전화가 오면 모든 사용자 기기에서 벨이 울려요.

18. 고객 마이그레이션 중에 패키지 수량 제한을 선택적으로 구성하려면 input/package_quantity.csv 파일에 각 패키지의 수량을 지정하세요. 구성된 패키지 수량은 사용자/작업공간에 할당된 패키지 수보다 크거나 같아야 해요.

    브로드웍스용 Webex에서 도매업으로의 마이그레이션에서는 패키지 수량 제한이 현재 지원되지 않아요.

    변환 도구를 실행할 때 업데이트된 파일을 입력 매개변수로 제공하세요.<extract_zip_file>/transform.sh -추출= -패키지 제한=입력/패키지_수량.csv .

19. 브로드웍스/브로드클라우드에서 여러 고객의 사이트를 홀세일의 단일 고객으로 마이그레이션하세요 Webex Calling
    • 브로드클라우드/브로드웍스에서 단일 도매 고객 조직의 Webex 도매 플랫폼으로 여러 고객 사이트를 마이그레이션하는 것을 지원하기 위해 새로운 런타임 모드인 통합 마이그레이션이 변환 도구에 도입되었어요. 이 모드가 활성화되면 도구가 여러 고객 사이트를 하나의 도매 고객 조직으로 통합해요.

      -consolidatedMigration

    • 통합 마이그레이션과 함께 사용할 수 있는 다른 선택적 인수들이 있어요, 예컨대

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • -TargetEnterpriseID가 제공되고 추출 도구 출력 파일에 ID가 있으면 도매 고객 조직을 만드는 데 사용되며 ID를 찾을 수 없으면 도구는 추출 도구 출력 파일에서 사용 가능한 고객 세부 정보를 사용하도록 대체됩니다.
    • -통합외부 ID를 주면 고객의 외부 ID를 설정하고, 지정하지 않으면 도구는 외부 ID에 기존 흐름을 사용하도록 대체돼요.
    • <timestamp>통합된 JSON (customer.json) 파일은 출력/ /통합 디렉터리에서 사용할 수 있어요.

input/customers.csv 파일을 작성하고 있어요.

input/customers.csv 파일은 시스코 브로드웍스나 브로드클라우드에 없을 수도 있는 데이터를 제공해요. 필수 정보가 모두 있으면 이 파일을 비워 둘 수 있어요. 모든 열을 입력할 필요는 없어요. 빠진 정보만 필수예요.

아래 표는 input/customers.csv 에서 가장 중요한 칼럼에 대한 설명이에요.

input/users.csv 작성 중이에요

input/users.csv 파일은 시스코 브로드웍스나 브로드클라우드에 없을 수도 있는 데이터를 제공해요. 필수 정보가 모두 있으면 이 파일을 비워 둘 수 있어요. 모든 열을 입력할 필요는 없어요. 빠진 정보만 필수예요.

실행 지침

어떤 운영 체제에서든 변형 도구를 실행하세요. 윈도우와 macOS에서 도구를 실행하려면 아래 단계를 사용하세요.

윈도우

윈도우에서 변형 도구를 실행하려면 아래 명령을 실행하세요.

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

맥 오에스

macOS에서 변형 도구를 실행하려면 다음 단계를 실행하세요.

1. 가상 환경을 만들고 종속성을 설치해서 파이썬으로 변환 도구를 실행하세요.

   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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

고객/사용자 사전 점검

변환 도구는 잠재적인 프로비저닝 문제를 잡기 위해 Webex에 API 호출을 해요. 기본적으로 고객 주소와 기본 이메일을 검증해요. conf/partner.cfg 파일에 PROVISIONING_ID 값이 지정되면 위치 정보의 유효성도 검사해요. 사전 점검 결과는 예외 보고서에 포함돼요.

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

사전 점검

고객 정보에 대한 사전 확인 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

예외 보고서

<timestamp>변환 도구가 output/ /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> 샘플 고객.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 Public API를 사용해요. 변환 도구 출력 JSON (customer.json) 파일을 입력으로 읽고 Webex 도매 RTM 솔루션에서 고객, 위치, 번호, 사용자, 서비스 및 장치를 프로비전해요.

전제조건

프로비저닝 도구 디렉토리 내에 다음 전제 조건을 구성하세요.

1. 컴퓨터에 자바 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, 윈도우의 경우 provisioning_tool.bat 에서 JAVA_HOME 환경 변수를 설정하세요.
3. partner.cfg 파일:
   • WHOLESALE_PROVISIONING_ID와 REFRESH_TOKEN (토큰 생성기 도구에서 복사한 토큰) 을 설정하세요. 파트너 관리자가 계정 팀에 문의하여 PROVISIONING_ID를 받아야 해요.

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • 파트너가 사용자들에게 환영 이메일을 보내는 것을 원하지 않으면 SEND_SUBSCRIBERS_WELCOME_EMAIL을 false로 설정하세요. 기본값은 참이에요.

     웹엑스는 최종 사용자에게만 환영 이메일을 보낸대요. 고객 관리자는 환영 이메일을 받지 못해요.

     미국 및 캐나다 지역에 거주하는 사용자와 고객 관리자는 RedSky로부터 별도의 이메일 알림을 받게 돼요. RedSky E911 플랫폼에서 이 이메일을 보내 응급 서비스 고객 계정 생성을 확인해요. 이 레드스카이 이메일은 웨벡스 환영 이메일과는 별개이고 웹엑스 이메일 설정에 의해 제어되지 않아요. 미국과 캐나다에 있는 도매 조직의 경우, RedSky가 응급 서비스 제공자로 자동 활성화돼요.

4. 브로드웍스 마이그레이션을 위한 웹엑스의 WEBX4BWKS_EMAIL_SUBJECT 속성을 사용하여 브로드웍스 구독자를 위해 웹엑스에 비밀번호 변경 요청 이메일 제목을 보내세요.
5. 브로드웍스 마이그레이션을 위한 웹엑스의 WEBEX4BWKS_EMAIL_BODY 속성을 사용하여 브로드웍스 구독자를 위해 웹엑스에 비밀번호 변경 요청 이메일 본문을 보내세요.
6. 고객 생성 후 태그를 추가하려면 CUSTOM_TAGS 속성을 사용하세요.
7. 도매 할인을 적용하려면 마이그레이션을 시작하기 전에 파트너 관리자가 Cisco 어카운트 팀에 문의해야 해요.

   APPLY_WHOLESALE_DISCOUNTS라는 새 숙소가 partner.cfg 에 추가됐어요. 사용자와 작업 공간에 할인을 적용하려면 이 속성을 활성화하세요.

8. (선택 사항) PSTN 연결을 명시적으로 구성해요

   주 위치를 포함하여 마이그레이션 중에 제공되는 모든 위치에 PSTN 연결을 지정하려면 partner.cfg 파일에 다음 속성을 추가하세요.

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   속성이 구성되지 않았거나 주석 처리되지 않은 경우, 프로비저닝 도구는 기본 PSTN 연결 선택 프로세스를 사용해요.

실행 지침

윈도우와 macOS에서 도구를 실행하려면 다음 단계를 사용하세요.

윈도우

윈도우 OS에서 도구를 실행하려면 다음 단계를 실행하세요.

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

맥 오에스

macOS에서 도구를 실행하려면 다음 단계를 실행하세요.

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

브로드웍스 마이그레이션을 위한 웹엑스의 전제 조건

파트너 관리자는 브로드웍스 동시 사용 기능을 위한 웹엑스의 브로드웍스 온보딩 템플릿을 업데이트해야 해요. 다음 이미지를 참조하세요.

Webex for BroadWorks 온보딩 템플릿이 마이그레이션을 지원하도록 업데이트되면, Cisco 어카운트 팀에 요청하여 파트너 수준에서 “도매 파트너 블렌딩 활성화” 기능 토글을 활성화하세요. 이 설정을 사용하면 프로비저닝 도구가 프로비저닝 중에 기존 Webex for BroadWorks 고객에게 도매 패키지를 자동으로 추가할 수 있어요.

추가 인수를 넣고 프로비저닝 도구를 실행하세요.

준비 단계: 관리자가 브로드웍스 사용자를 도매 구독자로 규정하고 브로드웍스 사용자를 위한 Webex를 계속 사용할 수 있는 기본 단계입니다.

유지 관리 단계: 관리자가 BroadWorks 사용자를 위해 기존 Webex에 도매 라이선스를 할당할 수 있는 두 번째 단계예요. 인수 유지 관리와 함께 프로비저닝 도구를 실행해야 해요.

마이그레이션 후 단계: 관리자가 BroadWorks를 도매로 완전히 전환할 수 있는 마지막 단계예요. 사후 마이그레이션 인수를 붙이고 프로비저닝 도구를 실행해야 해요.

터미널 로그

다음은 프로비저닝 성공 시 터미널에 있는 로그예요.

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>프로비저닝 도구가 출력/ /*.성공/오류 파일 안에 성공 및 오류 보고서를 생성해요. 출력 성공 및 오류 로그를 검토하여 프로비저닝이 성공했는지 확인해 주세요.

시스템이 출력/통합_보고서/ 디렉토리에 프로비져닝_보고서_*.csv 파일을 생성해요. 이 파일에는 각 엔티티와 설정에 대한 성공 및 실패 세부 정보가 모두 포함되어 있으며 포괄적인 프로비저닝 보고서를 제공합니다.

프로비전 도구는 출력/통합_보고서/ 디렉토리에 프로비져닝_통계_*.csv 파일도 생성해요. 이 보고서에는 프로비전에 성공한 고객 수와 실패한 고객 수, 위치, 사용자, 장치 및 그룹 기능이 포함돼요.

파트너 관리자는 파트너 허브와 컨트롤 허브 포털에서 고객 프로비저닝을 확인할 수 있어요. 파트너 허브와 컨트롤 허브 포털에서 가져온 다음 그림을 참조하세요.

그림 8: 파트너 허브

그림 9: 컨트롤 허브

그림 10: 디바이스들

그림 11: 전화 걸기

사후 프로비저닝 제한사항

BroadCloud 마이그레이션을 위한 프로비저닝이 완료되면 다음 작업이 차단돼요.

• CAP 포털 — 사용자 또는 포팅된 장치 추가.
• SP 포털 — 기기나 번호로 ADD 주문 생성하기.
• RSB API — 기기나 번호로 ADD 주문 생성하고 사용자 생성해요. 기기나 번호로 한 RSB ADD 주문은 거부돼요.

브로드클라우드에서 도매로 마이그레이션 — 기기 등록 제한

같은 지역 내에서 BroadCloud에서 Wholesale로 고객을 마이그레이션하는 파트너 관리자의 경우, 프로비저닝 도구를 실행한 후 도매에서 장치를 추가할 수 있어요. 하지만 해당 장치는 해당 위치에 대한 마이그레이션 (장치 이동) 이 완료된 후에만 Webex 플랫폼에 등록할 수 있게 돼요.

이 제한은 다음에는 적용되지 않아요.

• 브로드웍스/W4B에서 홀세셀로 이주하는 고객들.
• 여러 지역에 걸친 브로드클라우드에서 도매업으로의 마이그레이션.

추천 안내요

장치 등록 문제를 피하려면, 동일 지역 브로드클라우드에서 홀세일 마이그레이션을 위해 Webex 플랫폼에 장치를 등록하기 전에 위치 수준의 장치 이동 마이그레이션을 완료하세요.

브로드클라우드용이에요

브로드클라우드 파트너의 경우, 서비스 제공업체 포털을 사용하여 번호, 기기 및 공유 통화 출연 (SCA) 마이그레이션에 대한 마이그레이션 요청을 제출하세요.

서비스 제공업체 포털에서 마이그레이션 요청에는 최대 50명의 고객이 포함될 수 있어요. 하루에 요청 최대 10개까지 제출할 수 있어요.

관리자가 conf/partner.cfg 파일에서 rollback_to_Broadcloud=TRUE를 설정하여 자동 롤백을 활성화할 수 있어요. 마이그레이션 후 장치를 브로드클라우드로 다시 이동시켜요. NS Sync로 동일 지역 및 다른 지역 마이그레이션을 모두 지원하지만 성공적인 마이그레이션에만 지원해요. 실패한 경우 관리자가 롤백을 Cisco TAC 요청하기 전에 금액을 올려야 해요.

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

• 마이그레이션 — 번호, 기기 및 공유 통화 출현 (SCA) 마이그레이션 요청을 시작하려면 이 옵션을 선택하세요.
• 장치 상태 - 브로드클라우드 및 통화 중 장치의 현재 상태를 보려면 이 옵션을 선택하세요.

다음 그림은 서비스 제공업체 포털을 보여줘요.

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

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

선택한 위치 이전 (선택 사항)

customer.json 파일에 나열된 특정 하위 위치에 대해 마이그레이션을 시작하려면 요청에 locations.csv 파일을 포함하세요. 이 CSV에는 이주하려는 위치만 나열돼요.

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

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

번호 연결 끊기 옵션 활성화해요

브로드클라우드 이동통신사에 동일한 SIP 트렁크를 사용할 Webex Calling 때 관리자는 번호 연결 끊기 옵션을 사용해야 해요. 이렇게 하면 브로드클라우드로 마이그레이션 후 걸려오는 전화 번호에서 전화번호가 삭제돼요.

이 옵션을 활성화하려면,

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

번호 연결이 끊기지 않으면 Cisco TAC 요청 올려주세요.

시스코 브로드웍스, 브로드웍스용 웹엑스용

시스코 브로드웍스와 브로드웍스 마이그레이션을 위한 웹엑스의 경우, 도구는 파트너 네트워크 내의 보조 시스코 브로드웍스 애플리케이션 서버에서 실행되고 OCI-P를 통해 AS에 연결돼요. 변환 도구 출력 JSON (customer.json) 파일을 입력으로 사용하고 OCI-P 명령을 실행하여 장치와 소프트 클라이언트를 마이그레이션해요.

작업 성공 시, 디바이스 이동 툴은:

1. 시스코 브로드웍스에서 디바이스를 등록 취소하고 홀세일에 등록하세요.
2. UC-one 클라이언트를 사용하는 사용자는 처음 로그인할 때 Webex 앱으로 리디렉션해요.
3. 시스코 브로드웍스에서 전화번호를 비활성화하거나 브로드클라우드에서 전화번호를 제거하세요.
4. 도매에서 번호 활성화해요.
5. 브로드클라우드 마이그레이션을 위해 홀세일 공유 통화 출연 생성하세요. [이 단계는 브로드클라우드 마이그레이션에만 적용할 수 있어요].

6. 관리자가 회사 프록시를 사용하여 도구를 운영하는 경우 아래 단계에 따라 프로비저닝 스크립트를 구성하고 실행하세요.

   구성 절차

   1. devicemove.sh 파일 여세요.
   2. PROXY_HOST 변수를 찾아 주석 처리를 제거하세요 (devicemove.sh 앞 # 제거).

   3. PROXY_HOST 값을 다음과 같이 설정하세요.

      PROXY_HOST=<proxy-host>

   4. PROXY_PORT 변수를 찾아 주석 처리를 제거하세요 (devicemove.sh 앞 # 제거).

   5. PROXY_PORT 값을 다음과 같이 설정하세요.

      PROXY_PORT=<proxy-port>

   6. PROXY_SCHEME 변수를 찾아 주석 처리를 제거해 주세요 (devicemove.sh 앞 # 제거). 이 단계는 선택사항이에요. 댓글이 남아 있으면 PROXY_SCHEME의 기본값은 HTTP예요.

   7. PROXY_SCHEME 값을 다음과 같이 설정하세요.

      PROXY_SCHEME=<proxy-scheme>

   8. devicemove.sh 파일 저장하고 닫으세요.
   9. partner.cfg 파일을 열고 필요한 새로고침_토큰을 추가하세요.
   10. 브로드웍스 호스트, 사용자 이름, 암호가 partner.cfg 파일에 올바르게 구성되어 있는지 확인하세요 .

   11. 스크립트 실행:

       ./devicemove.sh

SCP와 SSH

1. SCP는 보조 시스코 브로드웍스 애플리케이션 서버로의 디바이스 이동 툴이에요.
2. 필수 조건을 구성하고 장치 이동 도구를 실행하려면 보조 Cisco BroadWorks 애플리케이션 서버에 SSH로 연결해요.

전제조건

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. CONF/DeviceMoveTool.conf 파일에서 보조 시스코 브로드웍스 애플리케이션 서버 사용자 ID, 암호, 호스트 이름이 정확한지 확인하세요.

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. 활성화 이메일을 재보내려면 conf/partner.cfg 파일에서 Send_Subscribers_Welcome_Email=TRUE를 설정해야 해요.

   관리자가 마이그레이션 중에 사용자들에게 초대 이메일을 보내려면 conf/partner.cfg 파일에서 “Send_subscribers_Welcome_Email=True” 속성의 주석 처리를 제거해야 해요. 그렇지 않으면 재산은 변하지 않아야 돼요.

4. devicemove.sh 에서 JDK/JRE 환경 경로가 올바른지 확인해 주세요.

   JAVA_HOME=/usr/local/java/java_base

5. 관리자가 입력 디렉토리에 있는 locations.csv 파일을 사용하여 기업 내 모든 그룹 대신 특정 그룹을 마이그레이션할 수 있어요.

폴리콤 전화기

폴리콤 폰을 Cisco BroadWorks에서 홀세일 콜링으로 옮기려면 파트너 관리자가 Cisco BroadWorks 각 폴리콤 디바이스 템플릿의 시스템 수준에서 새 ID/디바이스 프로파일 유형 파일을 만들어야 해요. 그림 14를 참조하고 사용자 지정 파일 Device-Move-Tool/CONF/DeviceProfile/ {region} /polycom_vvx.cfg 업로드하세요. 새 장치 파일을 업로드한 후 새로 만든 파일이 그룹 수준에 있는지 확인하세요. 또한 파일 마이그레이션_%BWMAC 주소%.CFG가 시스템의 기존 파일과 충돌하지 않는지 확인하세요.)

기기 이동 툴에서 내부적으로 사용해요.

폴리콤 폰의 마이그레이션 프로세스:

1. 장치 이동 도구가 장치 수준에서 %BWMACAddress%.cfg 파일을 polycom_vvx2.cfg 로 대체해요. 이 파일은 마이그레이션_%BWMAC주소%.CFG를 가리키고 있어요.
2. 그룹 수준이나 장치 수준에서 장치 프로필을 재구성하세요.
   그룹 수준이나 장치 수준에서 작동하는 것은 device-move-tool/conf/partner.cfg 파일에 있는 DeviceLeveleBuild 매개 변수의 구성에 따라 달라져요.
3. 장치 이동 도구가 Cisco BroadWorks 애플리케이션 서버에 그룹 수준 또는 장치 수준에서 전화를 재부팅하도록 요청해요.
4. 재부팅 요청 후 폴리콤 전화기가% BWMACAddress%.CFG를 다운로드하여 처리해요. 그러면 폴리콤 전화기에 Migration_%BWMACAddress%.CFG를 다운로드하여 처리하게 돼요. 그러면 device.prov.ServerName이 https://plcm.sipflash.com 으로 설정돼요.
   https://plcm.sipflash.com 미국 지역의 경우, 다른 지역은 URL이 달라요.
5. 폴리콤 전화가 https://plcm.sipflash.com 에서 %BWMACAddress%.CFG를 다운로드해서 DMS에서 관리해요. Webex Calling

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

실행 지침

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

장치 이동 도구는 장치 이동 도구 디렉토리 내의 보조 Cisco BroadWorks 애플리케이션 서버에서 실행돼요.

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -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: 활성 숫자

관리자가 회사 프록시를 사용하여 도구를 운영하는 경우 아래 단계에 따라 devicemove 스크립트를 구성하고 실행하세요.

디바이스무브 스크립트 구성 및 실행 단계

1. devicemove.sh 파일 여세요.
2. HTTPS_PROXY_HOST 변수를 찾아 주석 처리를 제거하세요 (앞 # 제거).

3. HTTPS_프록시_호스트 값을 다음과 같이 설정하세요.

   HTTPS_PROXY_HOST=<proxy-host>

4. HTTPS_PROXY_PORT 변수를 찾아 주석 처리를 제거하세요 (앞 # 제거).
5. HTTPS_프록시_포트 값을 다음과 같이 설정하세요.

   HTTPS_PROXY_PORT=<proxy-port>

6. devicemove.sh 파일 저장하고 닫으세요.
7. partner.cfg 파일을 열고 필요한 새로고침_토큰을 추가하세요.
8. 브로드웍스 호스트, 사용자 이름, 암호가 partner.cfg 파일에 올바르게 구성되어 있는지 확인하세요.
9. 스크립트 실행:

   ./devicemove.sh

복구 작업은 한 번에 한 엔터프라이즈에서 실행해야 해요.

브로드클라우드 캐리어용

관리자가 conf/partner.cfg 파일에서 rollback_to_Broadcloud=TRUE로 설정하여 자동 롤백을 활성화할 수 있어요. 이렇게 하면 NS Sync로 동일 또는 지역 간 마이그레이션에 성공한 후 장치가 BroadCloud로 반환돼요. 실패한 마이그레이션의 경우 롤백 요청 Cisco TAC 전에 연락하세요.

시스코 브로드웍스, 브로드웍스용 웹엑스용

시스코 브로드웍스와 브로드웍스용 웹엑스의 되돌리기 프로세스는 다음과 같아요.

1. 티켓 여시고 기기 되돌리라고 요청하세요Cisco TAC.
2. 장치 마이그레이션을 되돌리려면 보조 BroadWorks 애플리케이션 서버의 복귀 모드에서 장치 이동 도구를 실행하세요. 그러면 DMS URL이 시스코 브로드웍스의 디바이스 프로파일에 대한 서비스 제공자 DMS URL로 다시 설정되고 전화번호가 다시 활성화돼요.
3. Webex Calling팀이 DMS URL을 장치 프로필의 서비스 공급자 DMS URL로 다시 설정해요. Webex Calling
4. 파트너 관리자가 Control Hub 포털을 Webex Calling 통해 전화번호를 비활성화하거나 삭제해야 해요.
5. 파트너 관리자가 PSTN 전화번호를 시스코 브로드웍스로 다시 옮겨야 해요.

장치 이동 도구를 되돌리기 모드에서 실행하는 방법

장치 이동 도구를 되돌리기 모드로 실행하려면 아래 단계를 따르세요.

장치 이동 툴 디렉토리 내의 보조 Cisco BroadWorks 애플리케이션 서버에서 아래 명령을 실행하세요.

프로필 되돌리세요.

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

번호 되돌리세요.

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -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