- 홈
- /
- 문서
도매 RTM 솔루션으로의 전환을 위한 마이그레이션 도구
최소한의 사전 구성으로 마이그레이션을 실행합니다. 실행 명령을 쉽게 만듭니다. 관리자 는 프로비저닝 후 데이터를 검토하고 마이그레이션 직후에 전화를 걸고 받을 수 있습니다. UC-One 클라이언트를 위한 Webex 앱의 자동 업그레이드를 지원합니다.
개요
이 문서의 목적은 Cisco BroadWorks, Webex for BroadWorks, BroadCloud에서 Wholesale 및 Webex Calling으로 마이그레이션하는 데 필요한 도구 사용에 대한 자세한 지침을 제공하는 것입니다. 이 문서에서는 기존 Cisco BroadWorks, Webex for BroadWorks 및 BroadCloud 고객을 Wholesale Route-to-Market 솔루션으로 마이그레이션하는 데 도움이 되도록 설계된 마이그레이션 도구 세트에 대해 설명합니다.
마이그레이션 도구는 BroadWorks에서 Wholesale 서비스로의 완전한 전환을 용이하게 하기 위해 고안되었습니다. 이러한 서비스는 동일한 고객 조직 내에서 두 서비스가 장기적으로 공존하도록 설계되지 않았습니다.
이주 영향
이주 후의 영향은 다음과 같습니다.
관리자
마이그레이션 후 관리자는 다음을 수행해야 합니다.
- CommPilot 대신 Partner Hub와 Control Hub를 사용하여 기능을 구성하기 시작하세요.
- 마이그레이션에 포함되지 않은 기능을 다시 구성합니다.
마이그레이션 도구가 완료된 후 자동으로 마이그레이션되지 않는 기능은 수동으로 마이그레이션해야 합니다.
사용자
지원되는 기능은 마이그레이션 후에도 마이그레이션 전과 동일하게 작동해야 합니다. 마이그레이션에서 지원되지 않는 Webex Calling 기능은 마이그레이션 후 Webex에서 재구성해야 합니다.
- 사용자는 통화 기록과 메시지 기록을 잃게 됩니다.
- 사용자는 모든 개인 키줄 설정 및 사용자 정의 내용을 잃게 되며, 마이그레이션 후 이러한 설정을 다시 구성해야 합니다. 예로는 단축 다이얼이 있습니다.
- 사용자는 처음 로그인할 때 액세스 코드와 비밀번호를 재설정해야 합니다.
- UC-One 클라이언트를 사용하는 사용자는 처음 로그인할 때 Webex 앱으로 업그레이드해야 합니다.
마이그레이션 도구 아키텍처
마이그레이션 도구 아키텍처는 4가지 도구로 구성됩니다.
- 추출 도구—Cisco BroadWorks에서 기업, 그룹, 번호, 사용자, 서비스, 전화 및 소프트 클라이언트를 추출합니다. BroadCloud 파트너는 서비스 제공자 포털에 추출 요청을 제출해야 합니다.
- 변환 도구— 추출 도구로 추출한 정보를 편집 가능한 JSON 파일로 변환합니다.
- 프로비저닝 도구— Webex 공용 API를 사용하여 고객, 위치, 번호, 사용자, 서비스 및 전화를 프로비저닝하기 위해 변환 도구의 JSON 출력 파일을 사용합니다.
- 장치 이동 도구—변환 도구 JSON 출력 파일을 사용하여 프로필을 다시 빌드하고 전화기를 재부팅하고, Wholesale RTM 솔루션에서 번호를 활성화하고, Cisco BroadWorks에서 전화 번호를 비활성화합니다.
- 이 도구는 Cisco BroadWorks에서 전화 및 소프트 클라이언트 프로필과 번호 활성화를 되돌리는 것을 지원합니다.
- BroadCloud 파트너는 서비스 제공자 포털에서 마이그레이션 요청을 제출해야 합니다.
다음 그림은 관리자가 마이그레이션 작업을 시작한 후 Cisco BroadWorks, 공개 API와 통신하고 향후 분석을 위해 Webex 서비스에 메트릭을 업로드하여 4개의 도구가 순차적으로 작동하는 방식을 보여줍니다.

표 1. 마이그레이션 도구
요구 사항
마이그레이션 도구를 실행하기 전에 파트너는 다음 요구 사항을 충족해야 합니다.
- 파트너 및 파트너 관리자 계정은 Wholesale RTM 솔루션에 포함되어야 합니다. 사전 판매 단계에서는 파트너가 추출 도구를 실행하기 위해 Wholesale RTM 솔루션에 온보딩할 필요가 없습니다.
- 파트너는 모든 요구 사항이 충족되었는지 확인하기 위해 사전 이주 체크리스트를 살펴봐야 합니다.
- 추출 및 장치 이동 도구를 실행하려면 Cisco BroadWorks 시스템 관리자 자격 증명이 필요합니다. 이는 BroadCloud 파트너에게는 적용되지 않습니다.
- 위험을 최소화하기 위해 유지 관리 기간 동안 보조 Cisco BroadWorks 애플리케이션 서버에서 추출 및 장치 이동 도구를 실행해야 합니다. BroadCloud 파트너는 서비스 공급자 포털에서 장치 이동 도구를 실행합니다.
- 지원되는 Webex Calling 장치목록을 검토하세요.
- 지원되지 않는 Webex Calling 장치목록을 검토하세요.
- 파트너는 Cisco의 계정 팀에 문의하여 휴대폰 및 기기에 지원되는 펌웨어 버전을 확인해야 합니다.
- UC-One 클라이언트는 다음 버전으로 업그레이드해야 합니다.
- Desktop Communicator 클라이언트는 버전 22.9.12 이상이어야 합니다.
- Mobile Connect 클라이언트는 3.9.14 이상 버전이어야 합니다.
- 관리자의 컴퓨터에는 다음이 있어야 합니다.
- JDK/JRE Provisioning Tool에는 1.8이 필요합니다.
- MAC 및 Linux 컴퓨터에서는 Transform Tool을 사용하려면 Python 3.10.5 이상이 필요합니다.
- 고객은 유효한 청구 주소를 가지고 있어야 하며, 최종 사용자는 Cisco BroadWorks에 구성된 비즈니스 이메일 주소를 가지고 있어야 합니다. 값이 설정되지 않은 경우 파트너 관리자는 고객에게 연락하여 값을 얻어야 합니다. 변환 도구를 실행하기 전에 이러한 세부 정보를 CSV(쉼표로 구분된 값) 파일에 추가해야 합니다. 변환 도구에는 예제 CSV 파일이 제공됩니다.
마이그레이션 계획
마이그레이션 계획에는 3단계가 있습니다.
- 준비
- 추출 도구를 사용하여 사용자 데이터 사본 가져오기
- 토큰 생성 도구를 사용하여 토큰을 생성하세요
- 변환 도구를 사용하여 사용자 데이터 포맷
- 프로비저닝
- 추출 도구를 사용하여 최신 사용자 데이터를 가져옵니다.
- 변환 도구를 사용하여 사용자 데이터 포맷
- 프로비저닝 도구를 사용하여 사용자 프로비저닝
- 마이그레이션
- Device Move Tool을 사용하여 장치 마이그레이션
- 장치 없이 마이그레이션 [ Control Hub를 통한 전화번호 활성화 ]
파트너 관리자가 Cisco BroadWorks에서 Wholesale로 옮길 장치가 없는 경우 장치 이동 도구를 실행할 필요가 없습니다. 파트너 관리자는 아래의 공개 링크를 사용하여 Control Hub 포털을 통해 직접 전화 번호를 활성화할 수 있습니다. 자세한 정보는 Control Hub에서 전화 번호 관리를 참조하십시오.
파트너 관리자가 Control Hub를 통해 전화번호를 활성화한 경우 Cisco BroadWorks에서 전화번호를 비활성화하는 것은 선택 사항입니다.
Wholesale Calling으로 자동 마이그레이션된 기능
다음 사용자 기능은 마이그레이션 도구를 통해 자동으로 마이그레이션됩니다.
- 음성 메시지 설정 및 사용자 지정 인사말(음성 메시지, 개인화된 이름 오디오 및 사용자 PIN은 마이그레이션되지 않음)
- 대체 번호
- BroadWorks Anywhere
- 바쁜 램프 필드
- 발신자 ID(사용자 정의 이름 및 전화번호)
- 통화 대기
- 통화 전달 설정(통화 전달 always/busy/no answer/not 도달 가능)
- 통화 가로채기
- 방해하지 마시오
- 팩스 설정
- 원격 사무실
- 공유된 통화 외관
- 동시 링 개인(일정 및 선택 기준 포함)
- 전화 알림(일정 및 선택 기준 포함)
- 익명의 통화 거절
- 선택적 통화 거부
- 선택적 통화 전달
- 직접 호출 픽업 및 바지인
- 바지인 면제
- 푸시투토크
- 개인 정보
- 대기 중 음악
- 휴일 서비스
- 야간 서비스
다음 그룹 기능은 마이그레이션 도구를 통해 자동으로 마이그레이션됩니다.
- 자동 전화 교환
- 한 레벨만
- 맞춤 인사말
- 통화 전달 설정(항상, 통화 중, 선택적)
- 대체 번호
- Webex에서는 휴일 메뉴를 이용할 수 없습니다.
- 선택적 통화 거부
- Cisco BroadWorks 콜센터 표준 및 BroadCloud 콜 큐:
- 기본 구성
- 맞춤 인사말
- 대리인 및 감독자
- 통화 전달 설정(항상, 통화 중, 선택적)
- 대체 번호
- 보류 중인 음악
- 통화 대기
- 전화 받기
- 헌트 그룹
- 통화 전달 설정(항상, 통화 중, 선택적, 연결 불가)
- 대체 번호
- 위치 코드(위치 또는 그룹당 하나)
- 호출 그룹
- 일정(그룹 수준만 해당, 기업 일정은 마이그레이션되지 않음)
- 음성 포털
- 보류 중인 음악
- 일반 전화번호 목록
지원되는 장치
지원되는 전화기는 프로비저닝 도구를 통해 자동으로 생성되어 Webex Calling 사용자에게 할당됩니다. "장치 이동 도구에서 지원" 열에 "예"로 표시된 전화기는 장치 이동 도구를 실행하면 Cisco BroadWorks 또는 BroadCloud에서 Webex Calling으로 자동으로 이동됩니다. 해당 열에 "아니요"로 표시된 전화기의 경우 Cisco BroadWorks 장치 템플릿이나 전화기 자체에서 DMS URL을 변경하려면 수동으로 개입해야 합니다.
마지막 열은 파일의 "장치 유형" 열에 대한 휴대폰 모델 매핑을 제공합니다. transform-tool/input/newphones.csv. (newphones.csv에 대한 자세한 내용은 이 문서의 변형 도구 섹션을 참조하세요).
휴대폰 모델 |
장치 이동 도구에서 지원됨 |
newphones.csv의 기기 유형 |
---|---|---|
시스코 MPP 6821 |
예 |
DMS 시스코 6821 |
시스코 MPP 6841 |
예 |
DMS 시스코 6841 |
시스코 MPP 6851 |
예 |
DMS 시스코 6851 |
시스코 MPP 6861 |
예 |
DMS 시스코 6861 |
시스코 MPP 6871 |
예 |
DMS 시스코 6871 |
시스코 MPP 7811 |
예 |
DMS 시스코 7811 |
시스코 MPP 7821 |
예 |
DMS 시스코 7821 |
시스코 MPP 7832 |
예 |
DMS 시스코 7832 |
시스코 MPP 7841 |
예 |
DMS 시스코 7841 |
시스코 MPP 7861 |
예 |
DMS 시스코 7861 |
시스코 MPP 8811 |
예 |
DMS 시스코 8811 |
시스코 MPP 8832 |
예 |
DMS 시스코 8832 |
시스코 MPP 8841 |
예 |
DMS 시스코 8841 |
시스코 MPP 8845 |
예 |
DMS 시스코 8845 |
시스코 MPP 8851 |
예 |
DMS 시스코 8851 |
시스코 MPP 8861 |
예 |
DMS 시스코 8861 |
시스코 MPP 8865 |
예 |
DMS 시스코 8865 |
시스코 MPP 8875 |
예 |
DMS 시스코 8875 |
시스코 ATA191 |
예 |
DMS 시스코 191 |
시스코 ATA192 |
예 |
DMS 시스코 192 |
시스코 DBS 110 |
예 |
DMS 시스코 DBS110 |
폴리콤 VVX101 |
예 |
DMS 폴리콤 VVX101 |
폴리콤 VVX150 |
예 |
DMS 폴리콤 VVX150 |
폴리콤 VVX201 |
예 |
DMS 폴리콤 VVX201 |
폴리콤 VVX250 |
예 |
DMS 폴리콤 VVX250 |
폴리콤 VVX301 |
예 |
DMS 폴리콤 VVX301 |
폴리콤 VVX311 |
예 |
DMS 폴리콤 VVX311 |
폴리콤 VVX350 |
예 |
DMS 폴리콤 VVX350 |
폴리콤 VVX401 |
예 |
DMS 폴리콤 VVX401 |
폴리콤 VVX411 |
예 |
DMS 폴리콤 VVX411 |
폴리콤 VVX450 |
예 |
DMS 폴리콤 VVX450 |
폴리콤 VVX501 |
예 |
DMS 폴리콤 VVX501 |
폴리콤 VVX601 |
예 |
DMS 폴리콤 VVX601 |
폴리콤 트리오 8300 |
예 |
DMS 폴리콤 트리오8300 |
폴리콤 트리오 8500 |
예 |
DMS 폴리콤 트리오8500 |
폴리콤 트리오 8800 |
예 |
DMS 폴리콤 트리오8800 |
폴리콤 사운드스테이션 5000 |
예 |
DMS 폴리콤 SSIP5000 |
폴리콤 사운드스테이션 6000 |
예 |
DMS 폴리콤 SSIP6000 |
예링크 T33G |
예 |
DMS Yealink T33G |
예링크 T41S |
예 |
DMS Yealink T41S |
예링크 T42S |
예 |
DMS Yealink T42S |
예아링크 T43U |
예 |
DMS Yealink T43U |
예링크 T46U |
예 |
DMS Yealink T46U |
예링크 T46S |
예 |
DMS Yealink T46S |
예링크 T48S |
예 |
DMS Yealink T48S |
예링크 T48U |
예 |
DMS Yealink T48U |
예아링크 T53W |
예 |
DMS Yealink T53W |
예링크 T54W |
예 |
DMS Yealink T54W |
예링크 T57W |
예 |
DMS Yealink T57W |
예링크 T58V |
예 |
DMS Yealink T58V |
예아링크 CP920 |
예 |
DMS Yealink CP920 |
예아링크 CP960 |
예 |
DMS Yealink CP960 |
예링크 W52B |
예 |
DMS Yealink W52P |
예링크 W56B |
예 |
DMS Yealink W56P |
예링크 W60B |
예 |
DMS Yealink W60P |
예링크 W70B |
예 |
DMS Yealink W70P |
예아링크 CP925 |
예 |
DMS Yealink CP925 |
예아링크 CP965 |
예 |
DMS Yealink CP965 |
지원되지 않는 장치
고객이 Wholesale RTM 솔루션에서 지원하지 않는 기기를 사용하는 경우 해당 기기는 마이그레이션 대상이 아닙니다. 이 경우에는 다음과 같은 옵션이 있습니다.
- 마이그레이션하기 전에 Cisco BroadWorks에서 새 전화기를 프로비저닝하세요.
- Cisco BroadWorks에 기존 전화기를 그대로 두고, 사용자는 Webex 앱을 설치해야만 전화를 걸고 받을 수 있습니다.
도매 통화 패키지
마이그레이션 도구에는 가입자를 위한 도매 통화 패키지를 선택하기 위한 기본 설정 세트가 있습니다. 나중에 다른 패키지가 필요한 경우 파트너 관리자가 Control Hub에서 이를 변경할 수 있습니다.
Cisco BroadWorks 마이그레이션 패키지 구성
Cisco BroadWorks에서 마이그레이션하는 모든 가입자는 기본적으로 Webex Calling 패키지를 사용하게 됩니다. 통화 대기 또는 음성 메일이 할당되지 않은 가입자에게 Webex 음성 패키지가 필요한 경우 Transform Tool의 partner.cfg 파일에서 USE_WEBEX_VOICE_PACKAGE 줄의 주석 처리를 제거하여 이를 활성화할 수 있습니다.
BroadWorks 마이그레이션 패키지 매핑을 위한 Webex
BroadWorks 패키지용 Webex는 자동으로 도매 통화 패키지에 매핑됩니다. 이는 구성할 수 없습니다.
BroadWorks 패키지용 Webex |
도매 통화 패키지 |
---|---|
소프트폰 |
Webex Voice |
기본 |
Webex Calling |
표준 |
Webex 제품군 |
프리미엄 |
Webex 제품군 |
BroadCloud 마이그레이션 패키지 매핑
BroadCloud Carrier 맵 패키지는 스테이션 유형에 따라 마이그레이션됩니다. 기본 매핑은 Transform Tool의 구성 파일 conf/rialto_station_type_to_wholesale_package.csv에서 구성할 수 있습니다.
BroadCloud 캐리어 스테이션 유형 |
도매 통화 패키지 |
---|---|
기본 |
Webex Voice |
회의실 |
Webex Voice |
메시징 |
Webex Voice |
표준 |
Webex Voice |
경영진 |
Webex 제품군 |
다른 모든 스테이션 유형 |
Webex Voice |
BroadWorks 또는 BroadCloud 사용자 계정을 Webex Calling 작업 공간으로 변환
Webex Workspace는 다음과 같은 여러 사람이 공유하는 전화기입니다. 예를 들어: 회의실, 창고 또는 로비에 있는 전화. 이러한 전화기는 Webex 사용자 대신 Webex 작업 공간으로 Webex Calling에서 구성될 수 있습니다. 마이그레이션 프로세스 중에 Cisco BroadWorks 또는 BroadCloud Carrier의 사용자 계정을 자동으로 작업 공간으로 변환하는 옵션을 사용할 수 있습니다.
단계:
- 파일 transform_tool에서 /input/users.csv, 사용자에게 “common_area” 패키지를 할당하여 작업 공간으로 변환합니다.
- 예: bwuser@domain,,,common_area
- (BroadCloud 전용) 특정 스테이션 유형의 모든 사용자 계정을 작업 공간으로 변환하려면 항목을 추가하세요. transform-tool/conf/rialto_station_type_to_wholesale_package.csv를 선택하고 Wholesale 패키지를 “common_area_calling”로 설정합니다.
- 예: conference_room_v2,common_area_calling
- 변형 도구를 실행합니다.
- 프로비저닝 도구를 실행합니다.
- 새로 만든 고객 조직의 Control Hub를 열고 SIP 도메인을 설정합니다(그림 2, Control Hub에서 SIP 도메인 구성 참조).
- 프로비저닝 도구를 다시 실행하세요. 이렇게 하면 작업 공간이 생성되고 해당 작업 공간에 전화기가 할당됩니다.
제한 사항:
사용자 기능 구성(예: 통화 전달, 방해 금지)은 작업 공간에 자동으로 마이그레이션되지 않습니다.

표 2: Control Hub에서 SIP 도메인 구성
토큰 생성 도구
파트너 관리자는 마이그레이션 도구를 실행하기 전에 이 토큰 생성기 유틸리티 도구를 최소한 한 번 실행합니다. 이 도구를 실행하는 것은 파트너 계정이 Wholesale RTM 솔루션에 등록된 후 한 번만 수행하면 됩니다. 이 도구를 사용하면 파트너 관리자가 웹 브라우저를 통해 로그인하여 마이그레이션 도구의 파트너 구성 파일을 업데이트하는 데 필요한 고유한 토큰을 얻을 수 있습니다.
전제 조건
컴퓨터에 Java 8, 11, 17 또는 21을 설치합니다. Java는 다음을 포함한 다양한 소스에서 제공됩니다.
- https://learn.microsoft.com/en-us/java/openjdk/download
- https://aws.amazon.com/corretto/
- https://www.oracle.com/java/technologies/downloads/#java21
다운로드 후 마이그레이션 도구 바이너리를 추출합니다.
이 단계는 선택 사항입니다
실행 지침
토큰 생성기 디렉토리 내부의 터미널에서 다음 명령을 실행합니다.
-
토큰 생성 도구를 실행하려면 다음 포트를 사용할 수 있어야 합니다. 포트: 8080, 50009, 50010, 50011, 50012, 50013
-
언급된 포트 중 하나 이상이 사용자 컴퓨터에서 연결을 위해 열려 있어야 합니다.
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을 열고 파트너 관리자 자격 증명으로 로그인하여 TOKEN을 받은 후, 나중에 사용하기 위해 복사하세요.
참고용으로 사용자 인터페이스 그림이 아래에 나와 있습니다.
그림 3: Cisco Webex로 로그인
그림 4: 자격 증명 창
그림 5: 토큰 생성
BroadWorks 설정 작업
보조 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 프로비저닝을 구성합니다.
Provisioning 디렉토리로 변경:
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를 배포하고 시작합니다(배포되지 않았거나 아직 시작되지 않은 경우). 아래 명령을 사용하세요.
1단계: 다음 CLI 명령을 사용하여 서버를 배포합니다.
AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer
2단계: 다음 명령어로 서버를 시작합니다.
AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer
숫자 활성화 활성화
CLI에서 다음 명령을 실행하여 번호 활성화를 활성화하세요.
1단계: 번호 활성화 명령을 실행합니다.
AS_CLI> cd SubscriberMgmt/NumberActivation
2단계: 활성화가 활성화된 명령을 실행합니다.
AS_CLI> set dnMode groupAndUserActivationEnabled
3단계: 확인 메시지가 나타나면 Y를 입력합니다.
추출 도구
BroadCloud의 경우
추출 도구는 BroadCloud 서비스 제공자 포털에 통합되어 있습니다. 서비스 제공자 관리자는 다음을 수행할 수 있습니다.
- 요청당 최대 50명의 고객에 대한 추출 요청을 제출합니다.하루에 같은 고객에 대해 10번 이상 추출 요청을 제출할 수 없습니다.
- 요청 제출일로부터 최대 28일 동안 보관 가능한 ZIP 형식의 추출된 데이터 파일을 다운로드하세요.
다음 그림은 서비스 제공자 포털을 보여줍니다.

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

그림 7: 서비스 제공자 포털
CSV 추출 요청
CSV 추출 요청 시작
-
고객 CSV 다운로드
CSV 추출 요청 시작 섹션의 오른쪽 상단에 있는 [ 고객 CSV 다운로드 링크를 클릭하세요.
-
고객 목록 편집
관리자는 이 CSV 파일을 편집하여 추출이 필요한 고객만 포함할 수 있습니다.
-
업로드 및 제출
편집 후 수정된 CSV를 업로드합니다.
나열된 고객과 연관된 위치에 대한 추출 요청을 시작하려면 제출 을 클릭하세요.
위치 CSV를 사용하여 고객에 대한 추출 요청 시작
-
고객 및 다운로드 위치 선택
드롭다운에서 고객을 선택하세요.
고객 보기→ 사이트 탭 → 위치를 CSV로 내보내기에서 해당 locations.csv 를 다운로드합니다.
-
위치 파일 편집
관리자는 CSV를 편집하여 추출하려는 위치만 포함할 수 있습니다.
-
업로드 및 제출
편집한 locations.csv를 업로드하고 제출을 클릭하세요.
선택한 고객의 지정된 위치만 추출 요청에 포함됩니다.
모든 고객에 대한 추출 요청 시작
- 제출 을 클릭하여 현재 서비스 제공자의 모든 고객 및 모든 위치 에 대한 추출 요청을 시작합니다.

Cisco BroadWorks 및 BroadWorks용 Webex의 경우
- 추출 도구는 파트너 네트워크 내의 보조 Cisco BroadWorks 애플리케이션 서버에서 실행되며 OCI-P를 통해 연결됩니다.
- 이 도구는 Cisco BroadWorks 또는 BroadCloud 플랫폼에서 원시 엔터프라이즈, 그룹, 숫자, 사용자, 서비스, 장치 및 소프트 클라이언트 데이터를 가져와서 변환 도구에 대한 입력을 제공하는 XML 파일로 출력합니다.
다음 섹션에서는 추출 도구를 설치하고 구성하는 방법을 설명합니다.
전제 조건
- SCP 추출 도구 바이너리를 보조 Cisco BroadWorks 애플리케이션 서버로 전송합니다.
- 보조 Cisco BroadWorks 애플리케이션 서버에 SSH를 실행하여 필수 구성 요소를 구성하고 추출 도구를 실행합니다.
- Cisco BroadWorks에서 추출할 서비스 공급자 및 그룹 ID를 구성합니다. conf/exportTool.yml. 다음 YAML 스니펫 샘플을 참조하세요.
ServiceProviderID-A: - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B: - ALL
- 보조 Cisco BroadWorks Application Server 사용자 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
속성은 Webex for BroadWorks 마이그레이션에 필수입니다. - 수정하다 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 형식으로 변환합니다.
전제 조건
마이그레이션 도구 바이너리를 다운로드하고 추출한 후 다음 필수 구성 요소를 구성합니다.
- REFRESH_TOKEN(토큰 생성기 도구에서 복사한 토큰) 및 NAME_OF_MAIN_LOCATION을 설정합니다. conf/partner.cfg 파일:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main
- 선택적으로 파트너 허브의 템플릿에서 복사한 PROVISIONING_ID를 설정합니다. conf/partner.cfg 파일:
PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1
고객 이메일 주소에 대한 보다 완벽한 검증을 받으려면 선택적으로 PROVISIONING_ID를 설정할 수 있습니다. - 누락된 정보를 구성하세요 input/customers.csv 파일(다음 섹션 참조)이 없는 경우.
- 최종 사용자 이메일 주소를 추가하세요. input/users.csv 파일.
- 새 전화기를 프로비저닝하려면 사용자의 새 전화기의 MAC 주소와 이메일 주소를 추가하세요. input/newphones.csv 파일. 이는 파트너 관리자가 도매 통화에 새로운 전화기를 제공하려는 경우에만 필요합니다.
- 다음을 사용하여 BroadWorks 콜센터를 CxEssentials로 변환합니다. input/cxessentials.csv 파일.
- 선택적으로 UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS 속성을 활성화하여 모든 콜센터를 CxEssentials로 변환합니다.
- 사용하세요 input/locations.csv 관리자가 고객의 위치를 위치별로 마이그레이션할 수 있도록 하는 대규모 엔터프라이즈 마이그레이션을 지원하는 파일
- Cisco BroadWorks 장치 프로필에서 MAC 주소를 사용할 수 없는 경우 SIP REGISTER 메시지의 User-Agent 헤더에서 MAC 주소 사용을 선택적으로 활성화합니다. "USE_MAC_ADDRESS_FROM_SIP_" 줄의 주석 처리를 제거합니다. REGISTER=yes" 파일에서 conf/partner.cfg
- 네트워크 서버 동기화 기능을 사용하면 관리자가 동일 지역 마이그레이션 중에 전화번호, MAC 주소, 사용자 이메일 주소를 제공할 수 있습니다. 이를 활성화하려면 [
conf/partner.cfg
에USE_NS_SYNC=yes
]을 설정하세요.NS 동기화가 비활성화되면 전화번호 및 기기 프로비저닝이 건너뛰어지고, 사용자는 임시 이메일 주소를 받게 됩니다.
- 선택적으로 ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD 및 ANALOG_USER_TYPE_DISABLE_T38 속성을 활성화하여 모든 아날로그 유형 사용자에 대한 통화 대기, 보류 음악 및 T38 비활성화 설정을 구성합니다.
채우기 input/customers.csv
파일 input/customers.csv Cisco BroadWorks 또는 BroadCloud에서 누락되었을 수 있는 데이터를 제공합니다. 모든 필수 정보가 이미 사용 가능한 경우 이 파일을 비워둘 수 있습니다. 모든 열을 채울 필요는 없습니다. 누락된 정보만 필수입니다.
아래 표는 가장 중요한 열을 설명합니다. input/customers.csv.
열 이름 |
규칙 |
---|---|
Id |
Cisco BroadWorks 엔터프라이즈 모드에서:
BroadWorks 서비스 공급자 모드에서 이는 Cisco BroadWorks 그룹 ID입니다. BroadCloud에서 이는 Rialto customerId입니다. |
externalId |
이는 해당 고객에 대한 파트너의 내부 식별자와 일치하는 식별자입니다. 이 열은 Webex 파트너 조직 내에서 고유해야 합니다. 이 열은 선택 사항이며, 고유 식별자는 변환 도구에 의해 자동으로 생성됩니다. 이 열은 기업 내의 그룹에는 사용되지 않습니다. |
고객 이름 |
기업의 경우 이 열은 Webex 고객 이름 필드로 사용됩니다. 기업 내 그룹의 경우 이 열은 위치 이름으로 사용됩니다. 위치 이름은 기업 내에서 고유해야 합니다. |
기본이메일 |
이는 Webex 고객 관리자의 이메일 주소로 사용됩니다. 이 열은 기업 내 그룹의 경우 선택 사항입니다. |
주소 열 |
기업의 경우 해당 주소는 청구지 주소와 첫 번째 위치 주소로 사용됩니다. 기업 내의 그룹의 경우 주소는 위치 주소로 사용됩니다. |
timezone |
이 기사의 시간대 섹션을 참조하세요. |
언어 | Webex가 지원하는 언어를 참조하세요. |
기본 음성 메일 핀 |
음성 메일 PIN 설정을 참조하세요. |
채우기 input/users.csv
파일 input/users.csv Cisco BroadWorks 또는 BroadCloud에서 누락되었을 수 있는 데이터를 제공합니다. 모든 필수 정보가 이미 사용 가능한 경우 이 파일을 비워둘 수 있습니다. 모든 열을 채울 필요는 없습니다. 누락된 정보만 필수입니다.
이 모든 필드는 선택 사항입니다.
열 이름 |
규칙 |
---|---|
사용자 ID |
사용자를 위한 고유 식별자입니다. 이는 BroadWorks 또는 BroadCloud 사용자 ID일 수 있습니다. |
이메일 | (선택 사항) 사용자의 이메일 주소. 제공된 경우 프로비저닝 목적으로 사용됩니다. |
전화번호 |
(선택 사항) 프로비저닝할 사용자의 전화번호입니다. |
패키지 |
(선택 사항) 사용자 패키지 유형. 허용되는 값: 음성, 통화, 스위트, common_area, virtual_line, dont_migrate또는 call_park_ext. dont_migrate 값은 파트너가 특정 사용자와 해당 장치 및 전화 번호를 프로비저닝 및 마이그레이션에서 제외하려는 경우에 사용됩니다. 이는 BroadWorks 및 BroadCloud모두에서 지원됩니다. 적용 시, 선택된 사용자와 연관된 리소스는 마이그레이션되거나 프로비저닝되지 않습니다. 이를 사용하려면 관리자가 users.csv 파일의 패키지 열에 dont_migrate 를 입력해야 합니다. |
내선, 확장명 |
(선택 사항) 사용자에게 할당할 전화번호입니다. |
이름 |
(선택 사항) 사용자의 전체 이름입니다. |
ata_settings |
(선택 사항) 허용되는 값: t38, 아날로그 에게 enable/disable 통화 대기, 보류 음악 및 T38 설정 T38: 이 옵션을 사용하면 통화 대기 및 대기 음악 기능이 비활성화되고, ATA 장치에 대한 T38 설정이 활성화됩니다. 비슷한 물건:
|
do_not_move_phone |
BroadWorks만 해당. Webex Calling으로의 장치 마이그레이션을 방지하기 위한 선택적 플래그입니다. 이 옵션을 사용하면 파트너가 Webex로 장치를 마이그레이션하거나 Webex Calling에서 전화 번호를 활성화하지 않고도 사용자에게 통화 설정, 장치 및 전화 번호를 제공할 수 있습니다. 이 설정은 BroadWorks에서만 사용할 수 있으며 BroadCloud에서는 사용할 수 없습니다. 이를 사용하려면 관리자가 users.csv 파일의 do_not_move_phone (BroadWorks에만 해당) 열에 do_not_move_phone 를 지정해야 합니다. 이를 통해 사용자는 번호를 활성화하거나 휴대폰을 옮기지 않고도 서비스를 제공받을 수 있으므로 BroadCloud를 통해 계속 작업할 수 있습니다. |
실행 지침
모든 운영체제에서 변환 도구를 실행하세요. Windows와 macOS에서 도구를 실행하려면 아래 단계를 따르세요.
윈도우
Windows에서 변환 도구를 실행하려면 아래 명령을 실행하세요.
transform.bat -extract= -customers= -users= -newphones=
macOS
macOS에서 변환 도구를 실행하려면 다음 단계를 실행하세요.
- 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
- 변형 도구를 실행합니다.
./transform.sh -extract= -customers= -users= -newphones=
Customer/user 사전 확인
변환 도구는 Webex에 API 호출을 보내 잠재적인 프로비저닝 문제를 포착합니다. 기본적으로 고객의 주소와 기본 이메일의 유효성을 검사합니다. PROVISIONING_ID 값이 지정된 경우 conf/partner.cfg 파일을 열면 위치 정보도 검증됩니다. 사전 점검 결과는 예외 보고서에 포함됩니다.
또한, 변환 도구를 실행할 때 다음과 같은 선택적 매개변수를 추가할 수 있습니다.
사전 확인
Transform Tool은 고객 정보에 대한 사전 확인 API를 실행하는 것 외에도 구독자 이메일에 대한 사전 확인 API도 실행합니다.
사전 체크인포
기본적으로 사전 확인 오류(즉, 프로비저닝을 차단하는 문제)만 예외 보고서에 포함됩니다. 이 플래그를 추가하면 성공적인 사전 확인 결과도 포함됩니다(예: 자동으로 첨부할 수 있는 Webex 조직이 이미 있는 경우).
precheckinfo 를 실행하는 데 추가 시간이 걸립니다.
터미널 로그
성공적인 변환 시 터미널에 다음 로그가 기록됩니다.
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>내부에 예외 보고서를 생성합니다. /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_for_broadworks_info` JSON 속성은 Webex for BroadWorks 마이그레이션에만 존재합니다. 그만큼 `broadcloud_info` JSON 속성은 BroadCloud 마이그레이션에만 적용됩니다.
프로비저닝 도구
프로비저닝 도구는 (파트너의 관리자 노트북)과 같은 모든 컴퓨터에서 실행될 수 있으며 Webex 공개 API를 사용합니다. Webex Wholesale RTM 솔루션에서 고객, 위치, 번호, 사용자, 서비스 및 장치를 입력으로 변환 도구 출력 JSON(customer.json) 파일을 읽고 프로비저닝합니다.
전제 조건
프로비저닝 도구 디렉토리 내에서 다음 필수 구성 요소를 구성합니다.
- 컴퓨터에 Java 8, 11, 17 또는 21을 설치합니다. Java는 다음을 포함한 다양한 소스에서 제공됩니다.
- 마이그레이션 도구 바이너리를 다운로드하고 추출한 후 MAC의 경우 provisioning_tool.sh, Windows의 경우 provisioning_tool.bat에 JAVA_HOME 환경 변수를 설정합니다.
- partner.cfg 파일:
- WHOLESALE_PROVISIONING_ID와 REFRESH_TOKEN(토큰 생성기 도구에서 복사한 토큰)을 설정합니다. 파트너 관리자는 계정 팀에 연락하여 PROVISIONING_ID를 받아야 합니다.
WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
-
파트너가 사용자에게 환영 이메일을 보내고 싶지 않은 경우 ALLOW_ADMIN_INVITE_EMAILS를 false로 설정합니다. 기본값은 true입니다.
- WHOLESALE_PROVISIONING_ID와 REFRESH_TOKEN(토큰 생성기 도구에서 복사한 토큰)을 설정합니다. 파트너 관리자는 계정 팀에 연락하여 PROVISIONING_ID를 받아야 합니다.
- Webex for BroadWorks 마이그레이션에 대해 WEBEX4BWKS_EMAIL_SUBJECT 속성을 사용하여 Webex for BroadWorks 구독자에게 비밀번호 변경 요청 이메일 제목을 보냅니다.
- Webex for BroadWorks 마이그레이션의 WEBEX4BWKS_EMAIL_BODY 속성을 사용하여 Webex for BroadWorks 구독자에게 비밀번호 변경 요청 이메일 본문을 보냅니다.
- 네트워크 서버 동기화 기능을 사용하면 관리자가 동일 지역 마이그레이션 중에 전화번호, MAC 주소, 사용자 이메일 주소를 제공할 수 있습니다. 이를 활성화하려면 [
conf/partner.cfg
에USE_NS_SYNC=yes
]을 설정하세요.NS 동기화가 비활성화되면 전화번호 및 기기 프로비저닝이 건너뛰어지고, 사용자는 임시 이메일 주소를 받게 됩니다.
BroadCloud 마이그레이션의 경우 동일한 지역:
- 이 도구는 번호, 장치 및 공유 통화 표시 프로비저닝을 건너뜁니다.
- 이 도구는 확장자 및 임시 확장자를 사용하여 사용자와 가상 사용자를 생성합니다.
BroadCloud 마이그레이션의 경우 다른 지역:
- 이 도구는 번호, 장치 및 공유 통화 모습을 제공합니다.
- 이 도구는 실제 전화번호와 내선번호를 이용해 사용자와 가상 사용자를 생성합니다.모든 유럽 BroadCloud 마이그레이션은 다른 지역으로 진행됩니다.
실행 지침
Windows와 macOS에서 도구를 실행하려면 다음 단계를 따르세요.
윈도우
Windows OS에서 도구를 실행하려면 다음 단계를 실행하세요.
To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input=
macOS
macOS에서 도구를 실행하려면 다음 단계를 실행하세요.
To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=
BroadWorks 마이그레이션을 위한 Webex의 필수 구성 요소
파트너 관리자는 BroadWorks 공존 기능을 위해 Webex에 대한 BroadWorks 온보딩 템플릿을 업데이트해야 합니다. 다음 이미지를 참조하세요.

BroadWorks 온보딩 템플릿용 Webex가 마이그레이션을 지원하도록 업데이트되면 Cisco 계정 팀에 요청하여 파트너 수준에서 "도매-파트너-블렌딩-활성화" 기능 토글을 활성화하세요. 이를 통해 프로비저닝 중에 기존 Webex for BroadWorks 고객 조직에 도매 패키지를 추가할 수 있습니다.
추가 인수를 사용하여 프로비저닝 도구를 실행합니다.
준비 단계: 관리자가 BroadWorks 사용자를 도매 구독자로 프로비저닝하고 BroadWorks 사용자를 위해 Webex를 계속 사용할 수 있는 기본 단계입니다.
유지 관리 단계: 관리자가 기존 Webex for BroadWorks 사용자에게 도매 라이선스를 할당할 수 있는 두 번째 단계입니다. 인수 maintenance와 함께 프로비저닝 도구를 실행해야 합니다.
이주 후 단계: 관리자가 BroadWorks를 Wholesale로 완전히 전환할 수 있는 마지막 단계입니다. 인수 postmigration을 사용하여 프로비저닝 도구를 실행해야 합니다.
터미널 로그
성공적인 프로비저닝에 대한 터미널 로그는 다음과 같습니다.
Tool Name: Provisioning Tool
Version: 1.15.0
********** Started Processing File : input/customer.json ****************
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
********** Completed File : input/customer.json ****************
각 실행에 대해 생성된 위치 수가 표시된 표가 인쇄됩니다.

출력
프로비저닝 도구는 출력/<external_id>내부에 성공 및 오류 보고서를 생성합니다. /*.success/error 파일. 성공적인 프로비저닝을 확인하려면 출력 성공 및 오류 로그를 검토하세요.
파트너 관리자는 Partner Hub 및 Control Hub 포털에서 고객 프로비저닝을 확인할 수 있습니다. Partner Hub 및 Control Hub 포털의 다음 그림을 참조하세요.

그림 8: Partner Hub

그림 9: Control Hub

그림 10: 장치

그림 11: 통화
장치 이동 도구
BroadCloud의 경우
BroadCloud 파트너의 경우 서비스 제공자 포털을 사용하여 번호, 장치 및 공유 통화 표시(SCA) 마이그레이션에 대한 마이그레이션 요청을 제출하세요.
서비스 제공자 포털 내에서 마이그레이션 요청에는 최대 50명의 고객을 포함할 수 있습니다. 하루에 최대 10개의 요청을 제출할 수 있습니다.
네트워크 서버 동기화 기능을 사용하면 관리자가 [ conf/partner.cfg
의 USE_NS_SYNC=yes
를 설정하여 broadCloud 위치를 비활성화하고 Webex Calling 위치를 활성화할 수 있습니다. 마이그레이션 후에는 Webex Calling 위치에서 장치와 전화 번호가 활성화됩니다.
관리자는 conf/partner.cfg
파일에서 ROLLBACK_TO_BROADCLOUD=true
를 설정하여 자동 롤백을 활성화할 수 있으며, 이를 통해 마이그레이션 후 장치가 BroadCloud로 다시 이동합니다. NS Sync를 사용하면 동일 지역 및 다른 지역 마이그레이션을 모두 지원하지만, 마이그레이션이 성공적으로 완료된 경우에만 해당됩니다. 실패한 롤백의 경우, 관리자는 롤백을 요청하기 전에 Cisco TAC에 문의해야 합니다.
포털에서 마이그레이션 유형을 선택하는 데 사용할 수 있는 옵션은 두 가지가 있습니다.
- 마이그레이션 – 번호, 장치 및 공유 통화 표시(SCA) 마이그레이션 요청을 시작하려면 이 옵션을 선택하세요.
- 장치 상태 – BroadCloud 및 Calling에서 장치의 현재 상태를 보려면 이 옵션을 선택하세요.
다음 그림은 서비스 제공자 포털을 보여줍니다.
그림 12: 서비스 제공자 포털
그림 13: 서비스 제공자 포털
선택한 위치 마이그레이션 (선택 사항)
customer.json
파일에 나열된 특정 위치 하위 집합에 대한 마이그레이션을 시작하려면 요청에 locations.csv
파일을 포함하세요. 이 CSV에는 마이그레이션하려는 위치만 나열되어야 합니다.
locations.csv가 제공되지 않으면 customer.json의 모든 위치가 마이그레이션됩니다.
용어 | 정의 |
---|---|
사이트 ID |
마이그레이션할 위치의 사이트 ID입니다. |
사이트 이름 |
마이그레이션할 위치의 이름입니다. |
사용 가능한 활성 사이트 목록을 다운로드하려면 고객 보기 → 고객 선택 → 위치를 CSV로 내보내기로 이동하세요.

그림 14: 위치를 CSV로 내보내기
Cisco BroadWorks 및 BroadWorks용 Webex의 경우
Cisco BroadWorks 및 Webex for BroadWorks 마이그레이션의 경우, 해당 도구는 파트너 네트워크 내의 보조 Cisco BroadWorks 애플리케이션 서버에서 실행되고 OCI-P를 통해 AS에 연결됩니다. Transform Tool 출력 JSON(customer.json) 파일을 입력으로 사용하고 OCI-P 명령을 실행하여 장치와 소프트 클라이언트를 마이그레이션합니다.
작업이 성공적으로 완료되면 장치 이동 도구는 다음을 수행합니다.
- Cisco BroadWorks에서 장치 등록을 해제하고 Wholesale에 등록합니다.
- UC-One 클라이언트를 사용하는 사용자는 처음 로그인 시 Webex 앱으로 리디렉션됩니다.
- Cisco BroadWorks에서 전화번호를 비활성화하거나 BroadCloud에서 전화번호를 제거합니다.
- 홀세일에서 숫자를 활성화합니다.
- BroadCloud 마이그레이션을 위해 Wholesale에서 공유 통화 모습을 만듭니다. [This 이 단계는 BroadCloud에만 적용됩니다. migrations].
SCP와 SSH
- SCP 장치 이동 도구를 보조 Cisco BroadWorks 애플리케이션 서버로 이동합니다.
- 보조 Cisco BroadWorks 애플리케이션 서버에 SSH를 실행하여 필수 구성 요소를 구성하고 장치 이동 도구를 실행합니다.
전제 조건
- 토큰 생성기 도구에서 복사한 토큰인 REFRESH_TOKEN을 설정합니다. conf/partner.cfg 파일:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
- 보조 Cisco BroadWorks Application Server 사용자 ID, 비밀번호 및 호스트 이름이 올바른지 확인하십시오. conf/deviceMoveTool.conf 파일:
BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost
- 활성화 이메일을 다시 보내려면 RESEND_INVITATION_을 설정해야 합니다. EMAILS=true 에서 conf/partner.cfg 파일.
관리자가 마이그레이션 중에 사용자에게 초대 이메일을 보내려면 "RESEND_INVITATION_" 의 주석 처리를 제거해야 합니다. EMAILS=true" 에 있는 재산 conf/partner.cfg 파일. 그렇지 않으면 해당 속성은 변경되지 않아야 합니다.
- 확인하다 JDK/JRE devicemove.sh의 환경 경로가 올바릅니다.
JAVA_HOME=/usr/local/java/java_base
- 관리자는 입력 디렉토리의 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가 시스템의 기존 파일과 충돌하지 않는지 확인하세요.
이는 장치 이동 도구에서 내부적으로 사용됩니다.
Polycom 전화기의 마이그레이션 프로세스:
- 장치 이동 도구는 장치 수준의 파일 %BWMACADDRESS%.cfg를 polycom_vvx2.cfg로 바꿉니다. 이 파일은 migration_%BWMACADDRESS%.cfg를 참조합니다.
- 그룹 수준 또는 장치 수준에서 장치 프로필을 다시 빌드합니다.그룹 수준 또는 장치 수준에서의 작동은 파일의 deviceLevelRebuild 매개변수 구성에 따라 달라집니다. device-move-tool/conf/partner.cfg.
- 장치 이동 도구는 Cisco BroadWorks 애플리케이션 서버에 그룹 수준 또는 장치 수준에서 전화기를 재부팅하도록 요청합니다.
- 재부팅 요청 후 Polycom 전화기는% BWMACADDRESS%.cfg를 다운로드하고 처리합니다. 이는 Polycom 전화기에 migration_%BWMACADDRESS%.cfg를 다운로드하고 처리하도록 요청하며, 이는 device.prov.serverName을 https://plcm.sipflash.com.로 설정합니다.https://plcm.sipflash.com 미국 지역의 경우 다른 지역의 URL은 다릅니다.
- Polycom 전화기는 https://plcm.sipflash.com 에서 %BWMACADDRESS%.cfg를 다운로드하고 Webex Calling 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: 활성화된 숫자
마이그레이션 되돌리기
되돌리기 작업은 한 번에 하나의 기업에 대해 실행되어야 합니다.
BroadCloud 통신사용
BroadCloud 파트너를 위한 복귀 프로세스는 다음과 같습니다.
- Cisco TAC에 티켓을 열어 장치 복구를 요청하세요.
- 되돌리기 모드에서 장치 이동 도구를 실행합니다.
- Webex Calling에서 전화번호가 할당 해제되고 사용자와 서비스에는 내선 번호만 남게 됩니다.
- Webex Calling의 이메일 주소는 임시 이메일 주소로 변경됩니다.
- Webex Calling에서 전화기가 삭제됩니다.
- 대체 ID로 사용되는 전화번호, 이메일 주소 및 전화번호는 BroadCloud에서 다시 생성됩니다.
- 휴대전화가 재부팅됩니다.
- 파트너 관리자는 PSTN 전화번호를 BroadCloud Carrier로 다시 옮겨야 합니다.
Cisco BroadWorks 및 BroadWorks용 Webex의 경우
Cisco BroadWorks 및 BroadWorks용 Webex에 대한 되돌리기 프로세스는 다음과 같습니다.
- Cisco TAC에 티켓을 열어 장치 복구를 요청하세요.
- 보조 BroadWorks 애플리케이션 서버에서 되돌리기 모드로 장치 이동 도구를 실행하여 장치 마이그레이션을 되돌립니다. 이렇게 하면 Cisco BroadWorks의 장치 프로필에 대한 DMS URL이 서비스 제공자 DMS URL로 다시 설정되고 전화 번호가 다시 활성화됩니다.
- Webex Calling 팀은 Webex Calling의 장치 프로필에서 DMS URL을 서비스 제공자 DMS URL로 다시 설정합니다.
- 파트너 관리자는 Control Hub 포털을 통해 Webex Calling의 전화 번호를 비활성화하거나 삭제해야 합니다.
- 파트너 관리자는 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
부록
대기업 마이그레이션
여러 지점을 둔 대규모 기업은 단일 유지 관리 기간 내에 모든 지점을 마이그레이션할 수 없습니다. 이 섹션에 설명된 기능을 사용하면 파트너가 한 번에 여러 위치를 마이그레이션할 수 있습니다.
단계
대규모 기업의 단계별 마이그레이션을 계획하려면 다음 단계를 따르세요.
- BroadWorks 또는 BroadCloud에서 엔터프라이즈 데이터를 추출합니다.
- 추출된 데이터에 위치 옵션 없이 변형 도구를 실행합니다.
- exception_report.txt에서 동시에 이동할 권장 위치 섹션을 찾아 마이그레이션 단계를 계획하고 위치 종속성에 대한 자세한 정보를 얻고, 기능 에이전트 목록 파일을 검사합니다(아래의 변환 도구 참조).
- locations_to_be_edited.csv를 수정하여 input/locations.csv를 생성합니다.
- 위치 옵션을 사용하여 변형 도구를 다시 실행합니다.
- exception_report.txt를 검사하여 현재 단계에 대한 위치 종속성 문제를 식별합니다.
- 필요에 따라 위치 종속성 문제를 해결합니다(locations.csv를 수정하여).
- 현재 단계에 대한 customer.json을 생성하기 위해 Transform 도구를 다시 실행합니다.
- 각 customer.json에 대해 프로비저닝 도구를 실행합니다.
- 유지 관리 기간 동안 장치 이동 도구를 실행하세요.
- 다음 단계에서는 4~10단계를 반복합니다.
변형 도구
위에서 언급한 대로 대규모 기업의 위치를 단계별로 마이그레이션하는 목표를 달성하기 위해 새 파일 locations.csv 가 선택 입력으로 추가되었습니다(-locations=input/locations.csv) transform-tool을 실행할 때.
locations.csv에는 위치에 따른 데이터가 포함되어 있습니다. 이는 발견된 데이터를 재정의합니다. input/customers.csv, 현재는 기업 데이터와 위치 데이터가 모두 포함되어 있습니다.
다음 표는 locations.csv의 세부 정보를 나열합니다. :
설명 |
값 |
기본값 |
필수 |
BroadWorks의 지도 |
BroadCloud의 지도 | |
---|---|---|---|---|---|---|
엔터프라이즈 ID |
고유한 기업 ID |
예 |
서비스 제공자 ID |
리알토 고객 ID | ||
위치 ID |
기업 내에서 고유한 위치 ID |
예 |
그룹 ID |
리알토 사이트 ID | ||
이주 상태 |
이 위치는 이전되었나요? |
이주했다, dont_migrate, 이주 중 |
이주하다 |
아니요 | ||
이름 |
이 위치의 이름. locationId를 사용하려면 비워두세요. |
아니요 | ||||
timezone |
아니요 | |||||
언어 |
아니요 | |||||
address1 |
아니요 | |||||
address2 |
아니요 | |||||
city |
아니요 | |||||
state |
아니요 | |||||
우편번호 |
우편번호 |
아니요 | ||||
국가 |
2자리 코드 |
아니요 |
대규모 기업에서 Transform 도구를 실행할 때 미리 채워진 locations_to_be_edited.csv에서 locations.csv를 구성할 수 있습니다. 계속해서 예를 살펴보세요.
locations.csv는 변형 도구를 실행할 때 선택적인 입력이므로 변형 도구는 옵션이 있는 경우 이전과 동일하게 동작합니다. -locations=input/locations.csv 존재하지 않습니다.
새로운 출력 파일
변환 도구에는 5개의 새로운 출력 파일이 있습니다.
- locations_to_be_edited.csv – 대규모 기업이 마이그레이션할 수 있도록 모든 위치 정보가 미리 입력되어 있습니다.
예:
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US
그만큼 partners/customers 이를 사용하면 locations.csv를 생성하여 특정 단계에 대해 마이그레이션할 위치를 제어할 수 있습니다(그리고 필요에 따라 위치 정보를 업데이트할 수 있습니다).
예: locations.csv 위의 locations_to_be_edited.csv에서 생성됨
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,migrated,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,migrating,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,dont_migrate,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US
이 locations.csv는 다음을 의미합니다. 이 단계의 경우 위치 auto_mig_ent_grp1은 마이그레이션되었고, 위치 auto_mig_ent_grp2는 마이그레이션 중이며, 위치 auto_mig_ent_grp3은 마이그레이션하지 마십시오.
- hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4개 파일은 동일한 목적을 갖습니다. 해당 기능의 전체 목록을 생성합니다 agents/supervisors/originators/targets/ 마이그레이션 위치에 다른 위치에 대한 종속성이 있는 경우 마이그레이션 위치에monitored_elements 가 있습니다.
이들은 거의 동일한 형식을 가지고 있습니다(3번째 열 이름은 기능에 따라 다름). 아래와 같습니다(위 단계에 대한auto_mig_ent_grp2의 헌트 그룹의 에이전트 목록):
예: 다음은 hunt_group_agents.csv에서 가져온 것입니다.
feature name,feature location,agent,location
Sarah Rodriguez,auto_mig_ent_grp2,agent_michael@domain.com,auto_mig_ent_grp1
Sarah Rodriguez,auto_mig_ent_grp2,agent_sally@domain.com,auto_mig_ent_grp1
변환 도구를 실행할 때 위치 옵션이 없는 경우 위의 4개 파일은 전체 목록을 생성합니다. hunt-group/call-center/paging-group/busy-lamp-field’s agents/supervisors/originators/targets/monitored_elements 기업 전체를 대상으로 단계별 마이그레이션을 계획하는 데 사용할 수 있습니다.
새로운 섹션 exception_report
대규모 기업에 대한 단계적 마이그레이션을 수행하는 동안 충족되지 않는 위치 종속성이 있는 경우 exception_report.txt 에 몇 가지 새로운 섹션이 추가됩니다.
예: 다음 새 섹션은 위치 auto_mig_ent_grpauto_mig_ent_grp3 에 있는 헌트 그룹 Sarah Rodriguez의 에이전트를 위한 것으로, 이 단계에서는 마이그레이션되지 않고 마이그레이션도 진행되지 않습니다.
Dependencies between locations - Hunt groups
Name Location Agent Agent's Location Comment
________________________________________________________________________________________________________________
Sarah Rodriguez auto_mig_ent_grp2 agent_william@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet
Sarah Rodriguez auto_mig_ent_grp2 agent_melody@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet
다음의 새로운 섹션에서는 마이그레이션 단계에서 위치를 그룹화하는 방법에 대한 권장 사항을 제시합니다.
동시에 이동하기 좋은 추천 위치:
Location auto_mig_ent_grp1 has dependency on location(s) auto_mig_ent_grp2, auto_mig_ent_grp3
Location auto_mig_ent_grp2 has dependency on location(s) auto_mig_ent_grp3
변형 도구를 실행할 때 위치 옵션이 없는 경우, 동시에 이동할 권장 위치 섹션에 모든 위치 종속성이 나열되어 계획의 편의성을 제공합니다.
위치 옵션(즉, 마이그레이션 단계)을 사용하여 변환 도구를 실행하는 경우 동시에 이동할 권장 위치 섹션에는 현재 단계에 대한 위치 종속성만 나열됩니다.
프로비저닝 도구
대규모 기업의 경우 프로비저닝 도구를 평소와 같이 실행할 수 있습니다.
장치 이동 도구
장치 이동 도구는 customer.json의 위치 하위 집합에 대해 실행할 수 있습니다. 이를 위해 두 개의 열이 있는 새로운 선택적 locations.csv 파일을 추가합니다.
External_id |
위치 이름 |
---|---|
외부 ID 값 |
이름 locations/group 이름 |
- 이것은 선택 사항인 파일로, 제공되지 않거나 빈 값으로 제공되면 모든 위치가 마이그레이션됩니다.
- 위치 이름과 해당 external_ID가 제공된 경우 해당 위치만 마이그레이션됩니다.
명령은 다음과 같습니다.
./devicemove.sh -input=/customer.json -locations=/Location_names.csv
시간대
미국:
"timeZones":["America/Adak","America/Anchorage","America/Chicago","America/Denver","America/Los_Angeles","America/New_York","America/Phoenix","Pacific/Honolulu"]
캐나다:
"timeZones":["America/Dawson_Creek","America/Edmonton","America/Halifax","America/Montreal","America/Regina","America/St_Johns","America/Vancouver","America/Winnipeg"]
호주:
"timeZones":["Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Hobart","Australia/Lord_Howe","Australia/Perth","Australia/Sydney"]
프랑스:
"timeZones":["Europe/Paris"]
포르투갈:
"timeZones":["Atlantic/Azores","Europe/Lisbon"]}
영국:
"timeZones":["Europe/London"]
이탈리아:
"timeZones":["Europe/Rome"]
독일:
"timeZones":["Europe/Berlin"]