본 제품에 대한 문서 세트는 편견 없는 언어를 사용하기 위해 노력합니다. 본 설명서 세트의 목적상, 편견 없는 언어는 나이, 장애, 성별, 인종 정체성, 민족 정체성, 성적 지향성, 사회 경제적 지위 및 교차성에 기초한 차별을 의미하지 않는 언어로 정의됩니다. 제품 소프트웨어의 사용자 인터페이스에서 하드코딩된 언어, RFP 설명서에 기초한 언어 또는 참조된 서드파티 제품에서 사용하는 언어로 인해 설명서에 예외가 있을 수 있습니다. 시스코에서 어떤 방식으로 포용적인 언어를 사용하고 있는지 자세히 알아보세요.
Cisco는 전 세계 사용자에게 다양한 언어로 지원 콘텐츠를 제공하기 위해 기계 번역 기술과 수작업 번역을 병행하여 이 문서를 번역했습니다. 아무리 품질이 높은 기계 번역이라도 전문 번역가의 번역 결과물만큼 정확하지는 않습니다. Cisco Systems, Inc.는 이 같은 번역에 대해 어떠한 책임도 지지 않으며 항상 원본 영문 문서(링크 제공됨)를 참조할 것을 권장합니다.
이 문서에서는 PCCE(Packaged Contact Center Enterprise) 환경에서 라이브 데이터 문제를 구성하고 트러블슈팅하는 데 필요한 단계에 대해 설명합니다.
다음 주제에 대한 지식을 보유하고 있으면 유용합니다.
PCCE
Finesse
Cisco CUIC(Unified Intelligence Center)
라이브 데이터
이 문서의 정보는 다음 소프트웨어 및 하드웨어 버전을 기반으로 합니다.
PCCE 버전: 12.6
Finesse 버전: 12.6
CUIC-LiveData 버전: 12.6
이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.
Live Data는 Live Data 보고서에 대해 고가용성으로 실시간 이벤트를 처리하는 데이터 프레임워크입니다. Live Data는 주변 장치 게이트웨이 및 라우터의 에이전트 및 통화 이벤트를 지속적으로 처리합니다. 이벤트가 발생하면 Live Data는 Unified Intelligence Center 보고 클라이언트에 실시간 업데이트를 지속적으로 푸시합니다. PG 및 라우터는 이벤트가 발생할 때 에이전트 및 통화 이벤트를 Live Data로 푸시합니다. 그런 다음 Live Data는 스트림 내에서 이벤트를 지속적으로 집계 및 처리하고 정보를 게시합니다. CUIC는 메시지 스트림에 가입하여 이벤트를 실시간으로 수신하고 Live Data 보고서를 지속적으로 업데이트합니다. 상담원 상태 등의 개별 상태 값은 발생 시 새로 고쳐집니다. 대기열의 통화와 같은 다른 값은 약 3초마다 새로 고쳐집니다.
Packaged 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 연결로 복구됩니다.
Socket.IO 클라이언트는 Live Data 서버의 양쪽에 연결하여 Live Data 보고서 이벤트 스트림(Socket.IO 스트림)을 수신합니다. Unified Intelligence Center 클라이언트는 Socket.IO 클라이언트의 예입니다. 또한 대기 Live Data 서버는 활성 서버에서 프록시로 Socket.IO 스트림을 생성합니다. Socket.IO 클라이언트 하트비트가 손실되면 Socket.IO 연결이 실패합니다. 그러면 Socket.IO 클라이언트가 다른 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
PCCE 구축에서 라이브 데이터에 대한 인증서 교환
참고: 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] 및 다음 추가 문자를 사용할 수 있습니다.
PCCE 2000 에이전트 구축에는 공동 상주 CUIC-LD-IdS 클러스터가 필요합니다. PCCE 2000 Agent 구축에는 Live Data에 대한 수동 컨피그레이션이 필요하지 않습니다. 초기화 프로세스 중에 'CuicLiveDataConfigTask' 작업은 LD API를 사용하여 대부분의 컨피그레이션을 구성합니다.
여기에는 다음 항목이 포함됩니다.
초기화 후, 관리자가 수동으로 완료해야 하는 작업:
CORS를 구성하는 자세한 단계는 이 문서의 Live Data에 대한 CORS(Cross Origin Resource Sharing) 구성 섹션에서 확인할 수 있습니다.
2000 에이전트 구축과 마찬가지로 PCCE 랩 구축에는 Live Data에 대한 수동 컨피그레이션이 필요하지 않습니다. 초기화 프로세스 중에 'CuicLiveDataConfigTask' 작업은 LD API를 사용하여 대부분의 컨피그레이션을 구성합니다.
초기화 후, 관리자가 수동으로 완료해야 하는 작업:
참고: Cisco 버그 ID CSCwh53057에 설명된 대로 PCCE 12.6.2 랩 듀플렉스 모드의 경우 .
1단계
Live Data 초기 설정
2단계
각 AW 컴퓨터에서 로컬 데이터베이스 초기화 도구를 실행한 다음 배포자 서비스를 다시 시작합니다
3단계
Live Data로 작동하도록 AW DB에서 SQL 사용자를 구성합니다.
기본 및 보조 AW DB 서버에서 > SSMS(SQL Server Management Studio)를 시작합니다.
4단계
Live Data로 작동하도록 구성된 SQL 사용자에 대해 AWDB에서 SQL 쿼리를 실행합니다.
USE master
GO
GRANT CONTROL ON CERTIFICATE :: UCCESymmetricKeyCertificate TO "<user>"
GRANT VIEW DEFINITION ON SYMMETRIC KEY :: UCCESymmetricKey TO "<user>"
<user>를 4단계에서 생성한 사용자의 사용자 이름으로 대체합니다.
5단계
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 액세스가 있는지 확인하고, 결과를 보고합니다. (테스트 상태는 '성공'으로 표시되어야 합니다.) 게시자와 구독자 모두에 AW DB를 구성할 필요는 없습니다. 게시자와 구독자 간에 컨피그레이션이 복제됩니다.
구성된 기본 및 보조 AW DB를 보려면 다음 명령을 사용합니다.
show live-data aw-access
6단계
라이브 데이터 서버를 컴퓨터 서비스 레코드에 연결
set live-data machine-services <user@domain>
이 명령을 사용하면 LD 서버가 검색 가능하도록 LD 서버가 머신 서비스 테이블에 등록될 수 있습니다. 또한 LD API를 호출하기 위한 자격 증명도 등록합니다.
사용자가 machine services 명령을 성공적으로 실행해야 하는 요구 사항:
참고:
7단계
CUIC에서 Live Data 데이터 데이터 소스를 설정합니다.
set live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
위치
이 명령이 성공적으로 실행되면 CUIC GUI의 Datasources(데이터 소스) 탭에서 기본 및 보조 Live Data(라이브 데이터) 데이터 소스를 볼 수 있습니다.
이 컨피그레이션을 보려면 다음 명령을 사용합니다.
show live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
8단계
cisco.com에서 Live Data 보고서를 다운로드하고 CUIC 서버로 Live Data 보고서를 가져옵니다.
참고: Live Data 보고서의 버전은 중앙 컨트롤러의 버전과 일치해야 합니다.
9단계
CCE 관리 페이지(https://<AW-Server>/cceadmin)에서 Desktop Settings(데스크톱 설정) >> Resources(리소스) >> Desktop Layouts(데스크톱 레이아웃) 탭으로 이동하여 기본 'my-cuic-server'를 올바른 CUIC 서버 FQDN으로 바꿉니다.
10단계
라이브 데이터에 대한 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 Socket.IO 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 Socket.IO 서비스에 사용됩니다.
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. AW 데이터베이스에서 이 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. AW 데이터베이스에서 이 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 Socket.IO 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 |
05-Aug-2024 |
최초 릴리스 |