본 제품에 대한 문서 세트는 편견 없는 언어를 사용하기 위해 노력합니다. 본 설명서 세트의 목적상, 편견 없는 언어는 나이, 장애, 성별, 인종 정체성, 민족 정체성, 성적 지향성, 사회 경제적 지위 및 교차성에 기초한 차별을 의미하지 않는 언어로 정의됩니다. 제품 소프트웨어의 사용자 인터페이스에서 하드코딩된 언어, RFP 설명서에 기초한 언어 또는 참조된 서드파티 제품에서 사용하는 언어로 인해 설명서에 예외가 있을 수 있습니다. 시스코에서 어떤 방식으로 포용적인 언어를 사용하고 있는지 자세히 알아보세요.
Cisco는 전 세계 사용자에게 다양한 언어로 지원 콘텐츠를 제공하기 위해 기계 번역 기술과 수작업 번역을 병행하여 이 문서를 번역했습니다. 아무리 품질이 높은 기계 번역이라도 전문 번역가의 번역 결과물만큼 정확하지는 않습니다. Cisco Systems, Inc.는 이 같은 번역에 대해 어떠한 책임도 지지 않으며 항상 원본 영문 문서(링크 제공됨)를 참조할 것을 권장합니다.
이 문서에서는 UCCE(Unified Contact Center Enterprise) 환경에서 라이브 데이터 문제를 구성하고 트러블슈팅하는 데 필요한 단계에 대해 설명합니다.
다음 주제에 대한 지식을 보유하고 있으면 유용합니다.
Cisco UCCE(Unified Contact Center Enterprise)
이 문서의 정보는 다음 소프트웨어 및 하드웨어 버전을 기반으로 합니다.
ICM 버전: 12.6
Finesse 버전: 12.6
CUIC/Live Data 버전: 12.6
이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.
Live Data는 Live Data 보고서에 대해 고가용성으로 실시간 이벤트를 처리하는 데이터 프레임워크입니다. Live Data는 주변 장치 게이트웨이 및 라우터의 에이전트 및 통화 이벤트를 지속적으로 처리합니다. 이벤트가 발생하면 Live Data는 Unified Intelligence Center 보고 클라이언트에 실시간 업데이트를 지속적으로 푸시합니다. PG 및 라우터는 이벤트가 발생할 때 에이전트 및 통화 이벤트를 Live Data로 푸시합니다. 그런 다음 Live Data는 스트림 내에서 이벤트를 지속적으로 집계 및 처리하고 정보를 게시합니다. CUIC는 메시지 스트림에 가입하여 이벤트를 실시간으로 수신하고 Live Data 보고서를 지속적으로 업데이트합니다. 상담원 상태 등의 개별 상태 값은 발생 시 새로 고쳐집니다. 대기열의 통화와 같은 다른 값은 약 3초마다 새로 고쳐집니다.
Unified CCE에서 라이브 데이터는 Cisco Voice VM(Operating System Virtual Machine)에 상주합니다. Finesse 에이전트 데스크톱에 라이브 데이터 보고서를 포함할 수 있습니다.
2000년 에이전트 구축
4000명 이상 에이전트 구축
활성 Live Data 서버는 라우터 및 모든 에이전트 PG에 대한 TIP 및 TOS 연결을 설정해야 합니다. 활성(대기) Live Data 서버는 라우터 및 모든 에이전트 PG에 대한 TOS 연결만 설정해야 합니다.
참고:
Live Data 서버는 콜드 액티브 또는 스탠바이 모드에서 작동합니다. Live Data 서버는 한 번에 하나만 활성화됩니다. 다른 Live Data 서버는 대기 상태입니다. 대기 Live Data 서버는 활성 서버의 상태를 지속적으로 모니터링합니다. 활성 서버에 장애가 발생하면 대기 서버가 이를 인계받아 활성 상태가 됩니다. 서비스 준비가 되면 오류가 발생한 서버가 대기 서버가 됩니다.
Live Data는 TIP 전송 프로토콜을 사용하여 라우터 및 PG 서버와 통신합니다. 활성 Live Data 서버는 라우터 및 PG의 양쪽에 TIP 연결을 설정합니다. 대기 Live Data 서버는 TIP 연결을 설정하지 않습니다. 한 번에 하나의 TIP 연결만 A측 또는 B측에 활성화됩니다. 활성 TIP 연결이 실패하면 활성 Live Data 서버는 유휴 TIP 연결로 복구됩니다.
SocketIO 클라이언트는 Live Data 서버의 양쪽에 연결하여 Live Data 보고서 이벤트 스트림(SocketIO 스트림)을 수신합니다. Unified Intelligence Center 클라이언트는 SocketIO 클라이언트의 예입니다. 또한 대기 Live Data 서버는 활성 서버에서 프록시로 SocketIO 스트림을 생성합니다. SocketIO 클라이언트 하트비트가 손실되면 SocketIO 연결에 실패합니다. 그러면 SocketIO 클라이언트가 다른 Live Data 서버로 장애 조치됩니다.
Live Data를 배포하기 전에 다음 검사를 수행합니다.
확인 1
ICM 서버에서 nslookup 명령을 사용하여 Live Data 게시자 및 가입자에 대한 정방향 및 역방향 DNS 조회를 확인합니다.
nslookup <Live-Data-Server-FQDN>
nslookup <Live-Data-Server-IP>
확인 2
Live Data Server CLI에서 라우터 및 PG에 대한 정방향 및 역방향 DNS 조회를 확인합니다(A측과 B측에 대한 확인 수행).
utils network host <FQDN>
<FQDN>을 라우터/PG의 공용 FQDN으로 바꿉니다.
utils network host <IP>
<IP>를 라우터/PG의 공용 IP 주소로 교체합니다(A측과 B측 모두 확인 수행).
확인 3
CCE 환경에 대한 NTP 컨피그레이션 및 요구 사항을 확인합니다. CCE 솔루션 설계 가이드의 NTP 및 시간 동기화 섹션을 참조하십시오.
확인 4
CCE 솔루션 설계 가이드에 따라 컨피그레이션 제한이 준수되는지 확인합니다.
참고:
확인 5
UCCE 구축에서 라이브 데이터에 대한 인증서 교환
참고: CA 서명 인증서가 CCE 구축(ICM, Finesse, CUIC, LD 및 ID)에서 사용되는 경우(동일한 인증 기관에서 서명) 이 검사를 건너뛸 수 있습니다.
자체 서명 인증서 사용 시
2000년 에이전트 구축
4000 및 12000 에이전트 구축
참고:
확인 6
모든 Live Data 컨피그레이션 명령에는 FQDN(정규화된 도메인 이름)을 사용해야 합니다. Live Data를 구성할 때 IP 주소를 사용하면 Live Data 서비스에 문제가 발생할 수 있습니다.
확인 7
a. 설정된 모든 Live Data 명령의 경우 복사 및 붙여넣기 작업 대신 비밀번호를 수동으로 입력합니다.
b. Live Data 설치 CLI 명령에 지원되는 문자 집합
CLI로 작업할 때(Live Data 전용 아님) 일반 영숫자 문자 [0-9] [A-Z] [a-z] 및 다음 추가 문자를 사용할 수 있습니다.
1단계
CCE 관리에서 Infrastructure(인프라) > Deployment Settings(구축 설정)(https://<AW-Server>/cceadmin) 아래에 올바른 구축 유형이 설정되었는지 확인합니다.
2단계
CCE 인벤토리에 서버를 추가합니다.
2000 에이전트 구축의 경우 CUIC-LD-IdS Publisher 옵션을 선택하여 공동 상주 CUIC-LD-IdS 클러스터를 추가합니다.
4000 이상 에이전트 구축의 경우 Unified Intelligence Center 게시자 옵션을 선택하여 독립형 CUIC 클러스터를 추가합니다.
참고: 4000개 이상의 에이전트 구축의 경우 set live-data machine-services 명령을 사용하여 Live Data 서버가 Inventory에 추가됩니다.
3단계
set live-data reporting-interval <reporting-interval-in-minutes> 명령을 사용하여 Live Data 보고 간격을 분 단위로 설정합니다.
현재 보고 간격 설정을 보려면 show live-data reporting-interval 명령을 사용합니다.
4단계
Live Data로 작동하도록 AW DB에 SQL 사용자 구성
기본 및 보조 AW DB 서버에서 > SSMS(SQL Server Management Studio)를 시작합니다.
5단계
Live Data로 작동하도록 구성된 SQL 사용자에 대해 SQL 쿼리를 실행합니다.
USE master
GO
GRANT CONTROL ON CERTIFICATE :: UCCESymmetricKeyCertificate TO "<user>"
GRANT VIEW DEFINITION ON SYMMETRIC KEY :: UCCESymmetricKey TO "<user>"
<user>를 4단계에서 생성한 사용자의 사용자 이름으로 대체합니다.
6단계
AW로 라이브 데이터 구성
set live-data aw-access primary <aw1-server-fqdn> <port> <aw-database> <sql-user>
set live-data aw-access secondary <aw2-server-fqdn> <port> <aw-database> <sql-user>
위치
이 명령은 Live Data에 기본 AW DB 및 보조 AW DB에 액세스하는 방법을 알려 줍니다. 또한 이 명령은 Live Data에서 기본 또는 보조 AW로의 연결을 자동으로 테스트하고, 구성된 사용자에게 적절한 AW DB 액세스가 있는지 확인하고, 결과를 보고합니다. (테스트 상태는 '성공'으로 표시되어야 합니다. Live Data 게시자 및 가입자 서버 모두에서 AW DB를 구성할 필요가 없습니다. Live Data 게시자와 가입자 노드 간에 컨피그레이션이 복제됩니다.
구성된 기본 및 보조 AW DB를 보려면 다음 명령을 사용합니다.
show live-data aw-access
7단계
라이브 데이터 서버를 머신 서비스 레코드에 연결(4000개 이상의 에이전트 구축에만 해당)
set live-data machine-services <user@domain>
이 명령을 사용하면 LD 서버가 검색 가능하도록 LD 서버가 머신 서비스 테이블에 등록될 수 있습니다. 또한 Live Data API를 호출하기 위한 자격 증명도 등록합니다.
사용자가 machine services 명령을 성공적으로 실행해야 하는 요구 사항:
참고:
8단계
CUIC에서 Live Data 데이터 데이터 소스를 설정합니다.
set live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
위치
이 명령이 성공적으로 실행되면 CUIC GUI의 Datasources(데이터 소스) 탭에서 기본 및 보조 Live Data(라이브 데이터) 데이터 소스를 볼 수 있습니다.
Live Data 데이터 데이터 소스 구성을 보려면 다음 명령을 사용합니다.
show live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
9단계
cisco.com에서 Live Data 보고서를 다운로드하고 CUIC 서버로 Live Data 보고서를 가져옵니다.
참고: Live Data 보고서는 중앙 컨트롤러의 버전과 일치해야 합니다.
10단계
Cisco Finesse 관리 페이지(https://<Finesse>/cfadmin)에서 Finesse Desktop Layout(Finesse 데스크톱 레이아웃) 탭으로 이동하여 기본 'my-cuic-server'를 올바른 CUIC 서버 FQDN으로 바꿉니다.
11단계
라이브 데이터에 대한 CORS(Cross Origin Resource Sharing) 구성
a. Finesse 게시자 및 가입자에서 utils finesse cors status 명령을 사용하여 CORS가 활성화되었는지 확인합니다.
이 옵션이 비활성화되어 있으면 utils finesse cors enable 명령을 사용하여 활성화할 수 있습니다.
b. 모든 CUIC 서버에서 CORS 명령을 실행합니다.
utils cuic cors enable
utils cuic cors allowed_origin add https://<finesse-publisher>
utils cuic cors allowed_origin add https://<finesse-subscriber>
utils cuic cors allowed_origin add https://<finesse-publisher>:8445
utils cuic cors allowed_origin add https://<finesse-subscriber>:8445
c. Live Data 게시자 및 가입자 서버에서 CORS 명령을 실행합니다.
utils live-data cors enable
utils live-data cors allowed_origin add https://<finesse-publisher>
utils live-data cors allowed_origin add https://<finesse-subscriber>
utils live-data cors allowed_origin add https://<finesse-publisher>:8445
utils live-data cors allowed_origin add https://<finesse-subscriber>:8445
d. CORS 컨피그레이션을 확인하려면
모든 CUIC 서버에서:
utils cuic cors status
utils cuic cors allowed_origin list
Live Data 게시자 및 가입자에서:
utils live-data cors status
utils live-data cors allowed_origin list
참고:
12단계
CLI 명령을 사용하여 모든 CUIC/LD 및 Finesse 서버를 다시 시작합니다.
utils system restart
'utils service list' 명령을 사용하여 모든 Live Data 서비스가 시작되었는지 확인합니다.
CCE Live Data ActiveMQ Service[STARTED]
CCE Live Data Cassandra Service[STARTED]
CCE Live Data Event Store Service[STARTED]
CCE Live Data SocketIO Service[STARTED]
CCE Live Data Storm DRPC Service[STARTED]
CCE Live Data Storm Nimbus Service[STARTED]
CCE Live Data Storm Supervisor Service[STARTED]
CCE Live Data Web Service[STARTED]
CCE Live Data Zookeeper Service[STARTED]
다음 명령을 사용하여 AW 서버에 대한 연결을 확인합니다.
show live-data aw-access
테스트 상태는 '성공'으로 표시되어야 합니다.
명령을 사용하여 Live Data 클러스터 상태 확인
show live-data failover
클러스터 상태 | 설명 |
쌍으로 작동 |
Live Data 서버가 활성 상태이며 원격 측과 통신합니다. |
페어링 대기 |
Live Data 서버가 대기 상태이며 원격 사이드와 통신 중입니다. |
격리-활성 |
Live Data 서버가 활성 상태이지만 원격 측과 통신할 수 없습니다. |
격리-대기 |
Live Data 서버가 대기 상태이지만 원격 측과 통신할 수 없습니다. |
단순화 모드 |
Live Data 서버가 단방향 모드로 작동하고 있습니다. |
서비스 중지 |
Live Data 서버가 작동하지 않습니다. |
연결 |
Live Data 서버가 원격 사이드와 핸드셰이크를 시도하고 있습니다. |
테스트 |
Live Data 서버가 원격 사이드와 통신할 수 없으며 Test-Other-Side 절차를 사용하여 ISOLATED-ACTIVE 또는 ISOLATED-STANDBY 상태 중 어떤 상태인지 확인합니다. |
사용 불가능 |
Live Data가 배포되지 않았습니다. |
참고: ISOLATED active/standby 상태는 Live Data 서버 간의 통신을 나타냅니다. 이로 인해 CUIC의 Live Data 데이터 데이터 원본이 오프라인 상태가 되지 않습니다.
a. 'show live-data failover' 명령이 클러스터 상태를 UNAVAILABLE로 표시하는 경우
작업 항목:
b. 'show live-data failover' 명령이 클러스터 상태를 OUT-OF-SERVICE로 표시하는 경우
작업 항목
c. 'show live-data failover' 명령이 클러스터 상태를 ISOLATED로 표시하는 경우
스트리밍 Live Data 데이터 데이터 원본이 다음 명령을 사용하여 올바른 호스트를 반영하는지 확인합니다.
show live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
'show live-data cuic-datasource'에 올바른 구성이 표시되지만 CUIC에서 Live Data Datasource가 오프라인으로 표시되는 경우:
참고: Live Data 버전 12.6.2부터는 포트 12005 및 12008이 더 이상 사용되지 않으며 이후 릴리스에서 제거됩니다. 이제 포트 443이 Live Data 웹 서비스 및 Live Data SocketIO 서비스에 사용됩니다.
show open ports 명령을 사용하여 Live Data Server CLI에서 포트 연결을 확인합니다.
show open ports regexp 4[0-5]03[45] (For Instance-0)
show open ports regexp 4[0-5]07[45] (For Instance-1)
netstat 명령을 사용하여 라우터 및 PG의 명령 프롬프트에서 포트 연결을 확인합니다.
netstat -an | findstr "<LD-SideA-IP> <LD-SideB-IP>"
OR
netstat -an | findstr 4[0-5]03[45] (For Instance-0)
netstat -an | findstr 4[0-5]07[45] (For Instance-1)
a. 포트가 LISTENING 상태로도 표시되지 않는 경우
b. 포트가 ESTABLISHED 상태가 아니고 계속해서 LISTENING 상태인 경우:
a. 팀별로 구성된 에이전트 수를 확인하는 SQL 쿼리:
awdb에 대해 쿼리 실행(프로덕션 영향 없음)
Select TeamName = AT.EnterpriseName, NumAgentsOnTeam = COUNT(ATM.SkillTargetID), SupervisorName = Person.LastName + ', ' + Person.FirstName
FROM Agent_Team AT LEFT OUTER JOIN
(Select * from Agent ) Agent ON AT.PriSupervisorSkillTargetID = Agent.SkillTargetID LEFT OUTER JOIN Person ON Person.PersonID = Agent.PersonID,
Agent_Team_Member ATM
WHERE ATM.AgentTeamID = AT.AgentTeamID
GROUP BY AT.EnterpriseName, Person.LastName + ', ' + Person.FirstName
ORDER BY AT.EnterpriseName
b. 직무 그룹별로 구성된 상담원 수를 확인하는 SQL 쿼리:
awdb에 대해 쿼리 실행(프로덕션 영향 없음)
Select Skill_Group.EnterpriseName, NumAgentsInSG = COUNT(Skill_Group_Member.AgentSkillTargetID)
FROM Skill_Group, Skill_Group_Member
WHERE Deleted = 'N' AND Skill_Group.SkillTargetID = Skill_Group_Member.SkillGroupSkillTargetID
GROUP BY EnterpriseName;
c.
업그레이드 후 Live Data 문제가 표시되면 'DBMmaintenance' 컨피그레이션 값을 확인합니다.
비활성화되어 있으면 DBMantenance를 0으로 설정하여 컨피그레이션을 변경하고 AW 서버에서 Apache Tomcat 서비스를 재시작합니다.
레지스트리 경로: HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\ICM\<인스턴스 이름>\Router<A/B>\Router\CurrentVersion\Configuration\Global\DBMaintenance.
file get activelog livedata/logs recurs compress
이 명령은 모든 Live Data 구성 요소에 대한 로그를 수집합니다
또는 개별 Live Data 구성 요소에 대한 로그도 수집할 수 있습니다.
CCE Live Data ActiveMQ
file get activelog livedata/logs/livedata-activemq
CCE Live Data Cassandra Service
file get activelog livedata/logs/livedata-cassandra
CCE Live Data Event Store Service
file get activelog livedata/logs/livedata-event-store
CCE Live Data SocketIO Service
file get activelog livedata/logs/socketio-service
CCE Live Data Storm Services
file get activelog livedata/logs/livedata-storm
CCE Live Data Web Service
file get activelog livedata/logs/livedata-web
CCE Live Data Zookeeper Service
file get activelog livedata/logs/livedata-zookeeper
Intelligence Center Reporting Service
file get activelog cuic/logs/ recurs compress
기간 문제에 대한 브라우저 콘솔 및 네트워크 로그를 수집합니다. 먼저 캐시를 지우고 브라우저를 다시 시작하고 로그인 시점부터 로그를 캡처하여 문제를 재현하려는 시도를 다룹니다
Chrome/Edge 브라우저의 경우:
Firefox 브라우저의 경우
VOS 서버에서 패킷 캡처를 실행하는 명령:
RTMT를 사용하여 패킷 캡처 수집:
CLI를 사용하여 패킷 캡처 수집:
패킷 캡처는 삭제될 때까지 디스크에 남아 있습니다. 이러한 캡처를 주기적으로 삭제하는 것이 좋습니다.
12.6(1)
솔루션 설계 가이드
설치 및 업그레이드 가이드
12.6(2)
솔루션 설계 가이드
설치 및 업그레이드 가이드
개정 | 게시 날짜 | 의견 |
---|---|---|
1.0 |
14-Feb-2024 |
최초 릴리스 |