Nota técnica sobre fontes de dados CUIC para UCCX

Introduction

 Este documento descreve as várias fontes de dados na página de administração do Cisco Unified Intelligence Center (CUIC) na solução Unified Contact Center Express (UCCX), sua funcionalidade, configuração e técnicas de solução de problemas.

O comportamento da fonte de dados CUIC mudou em relação às versões, e este artigo descreve o comportamento como visto a partir da versão UCCX 11.5(1).

Visão geral de fontes de dados CUIC

Fonte de dados é o nome dado à conexão entre um servidor e um banco de dados que permite que o servidor execute consultas SQL no banco de dados.
A conexão feita aqui é uma conexão JDBC.

Configuração da fonte de dados do CUIC UCCX

Como mostrado na imagem, o aplicativo do CUIC co-residente para CCX tem 3 tipos de fontes de dados internas já pré-configuradas. 

Fonte de dados CUIC

Esta é uma fonte de dados baseada em consulta e é a conexão do banco de dados com o banco de dados CUIC (cuic_data) sobre a porta TCP 1500 e usa o usuário cuic_report para executar consultas no banco de dados CUIC.

Fonte de dados UCCX

Esta também é uma fonte de dados baseada em consulta e é a conexão do banco de dados ao banco de dados CCX (db_cra) sobre a porta TCP 1504 e usa o usuário do UCCX Historical reporting (uccxhruser) para buscar relatórios. O CUIC e o UCCX são fontes de dados Informix e são editáveis.

Fonte de dados de transmissão de dados ao vivo

Esta é uma conexão de websocket não baseada em consulta usada para Dados dinâmicos e não é editável, o que significa que você não pode alterar os parâmetros manualmente.

Essa fonte de dados pesquisa continuamente o serviço SocketIO do mecanismo UCCX para buscar os resultados de dados em tempo real do RTDM (Real-Time Data Manager) do mecanismo UCCX. Isso sempre aponta para o nó local, pois busca resultados do serviço do mecanismo principal.

Interação de gerenciamento de senha 

Alterações de versões anteriores

Até o UCCX 11.0, a fonte de dados UCCX usa o uccxhrc como o usuário padrão do banco de dados para recuperar dados históricos e exibi-los no CUIC, como mostrado na imagem.

Como mostrado na imagem, quando o UCCX 11.5 é iniciado, a fonte de dados usa o uccxhruser como o usuário de banco de dados padrão do UCCX.

                                                                                                                       

Você também pode usar o uccxhruser para conectar qualquer usuário de banco de dados externo ao UCCX, para extrair dados históricos (por exemplo: Um servidor de relatórios terceirizado ou Cisco WorkForce Otimization (WFO).

Usuário do Historical Reporting (uccxhruser)

Esse usuário pode se conectar aos datastores de configuração, histórico e repositório (CDS, HDS e RDS) e tem estes privilégios:

• Acesso somente leitura a tabelas de histórico, configuração e repositório.
• Execute os procedimentos armazenados.
• Criar novos procedimentos armazenados.

Como a versão 11.5 usa esse usuário para a fonte de dados UCCX, para atualizar a senha, navegue para

Barra de menus do Unified CCX Administration > Ferramentas > Gerenciamento de senha > Usuário do Historical Reporting.

ele altera a senha da fonte de dados UCCX automaticamente para relatórios de histórico com o CUIC.

Em uma configuração de HA, essa alteração não é propagada para o outro nó, portanto, ela precisa ser atualizada em ambos os nós.
Além disso, em configurações de HA, você pode Verificar consistência ao clicar no ícone na página Gerenciamento de senha para confirmar se as senhas correspondem em ambos os nós e são consistentes em todo o cluster. 

A inconsistência da senha pode fazer com que a fonte de dados fique off-line após o redirecionamento (por exemplo: Pós-failover).

Redirecionamento do Host da Fonte de Dados UCCX em HA

A Cisco recomenda apontar a fonte de dados UCCX para o nó secundário atual para receber relatórios, de modo a evitar carga adicional no serviço do mecanismo principal.
A execução de relatórios históricos pode, às vezes, aumentar o uso da CPU no processo uccxoninit, o que leva uma CPU excessiva e causa problemas de desempenho no servidor. Portanto, esta recomendação para apontar o armazenamento de dados históricos para o nó secundário está em vigor.

Aqui considere N1 como o nó do editor do UCCX (Nó 1) e N2 como o nó do assinante (Nó 2).
Em um cenário normal, ambos os nós têm a fonte de dados UCCX apontando para o mesmo nó.

Exemplo: 

Se a fonte de dados N1 estiver apontando para N1, então a fonte de dados N2 também estará apontando para N1. 

O comportamento de redirecionamento de fontes de dados difere em versões diferentes e abaixo estão alguns dos cenários específicos da versão:

Versões anteriores do UCCX 10.5(1) e 10.6(1)

Quando você faz login pela primeira vez no CUIC, o armazenamento de dados histórico precisa ser apontado manualmente para o nó secundário, dependendo da versão instalada.

Etapa 1. Faça login no CUIC.

Etapa 2. Clique em fonte de dados.

Etapa 3. Selecione a fonte de dados UCCX.

Etapa 4. Clique em Editar.

Etapa 5. Altere o Host da Fonte de Dados para o do nó secundário (por exemplo, altere o Nome da Instância para o do nó secundário). 

Etapa 6. Clique em Test connection (Testar conexão).

Passo 7. Clique em Salvar.

Cenário 1: N1 é principal e a fonte de dados está apontando para N2 para ambos os nós.

Ao alterar a propriedade primária do nó, o redirecionamento da fonte de dados CCX não acontece e continua a apontar para o mesmo nó onde estava apontando antes da alteração na propriedade primária.

Portanto, aqui a fonte de dados N1 e N2 continua a apontar para N2, que agora é o nó primário após failover.

Antes e depois do failover, ele aponta para o mesmo nó N2, como mostrado na imagem:

 

Cenário 2: N1 é primário e a fonte de dados está apontando para N2 para ambos os nós. Encerramento do mecanismo e do banco de dados em N2.

Agora, se o CCX Engine em N2 parar, não haverá alteração na fonte de dados, mas no momento em que o banco de dados é desligado em N2, a fonte de dados CCX não redireciona automaticamente para N1 e desativa com a marca red-X. Agora para receber o relatório O banco de dados de subnó precisa ser ativado ou apontar manualmente a fonte de dados para o banco de dados de nó N1.

Antes e depois do failover, ele aponta para o mesmo nó N2, como mostrado na imagem:

Versão 11.0(1) e 11.5(1)

A fonte de dados CCX aponta automaticamente para o nó secundário quando a instalação do nó 2 para HA é concluída. Não é necessário apontar a fonte de dados manualmente para o nó secundário.

Cenário 1: N1 é primário e a fonte de dados está apontando para N2 para ambos os nós.

Agora, ao alterar a propriedade primária do nó, o redirecionamento da fonte de dados CCX acontece e, após a fonte de dados de failover, ele aponta para N1 (agora secundário) para ambos os nós.

Antes do failover apontar para N2.

Após o failover apontar para N1

Cenário 2: N1 é primário e a fonte de dados está apontando para N2 para ambos os nós. Encerramento do mecanismo e do banco de dados em N2.

Agora, se o mecanismo em N2 parar, não há alteração na fonte de dados, mas no momento em que o banco de dados é desligado em N2, a fonte de dados CCX é redirecionada automaticamente para N1.

Antes de parar o banco de dados em N2

  Após parar o banco de dados em N2

Portanto, a fonte de dados geral sempre aponta para o banco de dados secundário.

Fonte de dados de transmissão de dados ao vivo 

O relatório Dados dinâmicos usa essa fonte de dados de transmissão. Essa é uma fonte de dados de estoque pré-configurada no Unified Intelligence Center e os campos não são editáveis. Os relatórios de Dados dinâmicos fornecem estatísticas em tempo real para Agente e Supervisor. Os relatórios de dados em tempo real (em tempo real) de agentes e supervisores podem ser executados no CUIC e também disponíveis no desktop finesse como gadgets. Os dados dinâmicos são consumidos pelo serviço de relatórios do Intelligence Center.

Na página de listagem da fonte de dados, o nome do host principal ou o endereço IP é exibido. Essa fonte de dados faz uma conexão de websocket sobre a porta 12015 para o serviço de E/S de socket, responsável pelo feed de Dados dinâmicos, portanto, essa é uma conexão de fluxo contínua e sempre aponta para o nó atual, ou seja, N1 aponta para IP/nome de host de N1 e N2 pontos para IP/nome de host de N2.

O serviço da Web Dados dinâmicos é basicamente usado para fazer chamadas de descanso. Basicamente tem suporte para três chamadas de descanso.

• Token de Autenticação: O token é necessário para se conectar - faça uma nova conexão com o serviço Socket IO.
  Os clientes enviam um token para cada solicitação de conexão que é validada pelo serviço de E/S de soquete fazendo uma chamada restante para o serviço Web Live Data.
  
  
• Solicitação de instantâneo: A solicitação de snapshot é solicitar que o serviço de E/S do soquete envie dados completos de captura de Snap.
  
  
• URL de autenticação: Essa API restante fornece as informações para esse agente, que são os valores válidos para os quais ele pode exibir dados nos relatórios de gadget LD.

Quando você faz login inicialmente no CUIC, essa fonte de dados precisa de certificados a serem aceitos na porta 12015. Depois de aceito, ele busca o token do mecanismo CCX na porta 9443 e, depois da autenticação do token, ele fica on-line. 

Esta fonte de dados ficando off-line por qualquer motivo faz com que todos os relatórios LD falhem.

Solução de problemas comuns

No banco de dados CUIC, você pode consultar a fonte de dados usando a tabela cuicdatasource.
Cada fonte de dados tem uma id de assinatura e é a mesma em todas as versões. Esta é a saída CLI do sistema 11.0 com informações importantes em BOLDS
run sql select * from cuic_data:cuicdatasource

id CCCCCCCC0000000AAAAAAA0000001
nome CUIC
description Fonte de dados para o banco de dados CUIC local
type Informix
dbhost ${HOSTNAME}
dbport 1500
dbuser cuic_reportuser
dbpassword {CUIC_DB_PASSWORD}
dbinstance ${INFORMIXSERVER}
dbname ${CUIC_DB_NAME}
dbencoding UTF-8
jdbcdriverclass com.informix.jdbc.IfxDriver
timezoneid
tempo de criação 2010-01-27 14:48:14.368
última atualização 2015-10-14 18:35:15.615
versão 1
padrão de partição
permissão de compartilhamento 3
minpoolsize 5
max poolsize 100
proprietário 1111111111111111111111111111AAA

id D7D7E1A6100001323635BD3F57F543
name UCCX
descrição
type Informix
dbhost 10.78.93.233
dbport 1504
dbuser uccxhruser
dbpassword cuicenc:85b5vBq+dMxeD1ZnIWIn9A==
dbinstance uccx_106_233_n2_uccx
dbname db_cra
dbencoding UTF-8
jdbcdriverclass com.informix.jdbc.IfxDriver
timezoneid GMT
tempo de criação 2017-05-18 18:03:52.00
última atualização 2017-05-28 02:18:43.770
proprietário 1111111111111111111111111111AAA

id E1350DCC1000013F000001CB0A4E5B4B
name Live Data Streaming Data Source
descrição UCCX Live Data Streaming Data Source
type Streaming
dbhost localhost
dbport 9443
dbuser
timezoneid UTC
tempo de criação 2017-04-05 12:11:00.00
última atualização 2017-04-05 12:11:00.00
minpoolsize 5
max poolsize 100
proprietário 1111111111111111111111111111AAA
brokerurl
esquema/tempo real do diagrama de tópicos
restuser LiveDataAdmin
restpassword ~12Live_Data!12
tokenurl livedata/token/new
websocketport 12015

3 linhas recuperadas.

Solução de problemas da fonte de dados de fluxo de LD

Para que a fonte de dados LD fique online, precisamos primeiro aceitar o certificado que ela oferece na porta 12015 no primeiro login no CUIC—>página da fonte de dados:
Depois de aceitar certificados, ele valida ainda mais o token com o mecanismo. Caso a fonte de dados LD ainda mostre offline, a verificação abaixo deve ser executada:

• Verifique o NTP usando o status ntp do utilitário: Os dados ao vivo dependem do NTP, pois precisam sincronizar eventos ao vivo que ocorrem. Certifique-se sempre de que a camada 5 do NTP esteja estática.
• utils diagnose test deve validar a rede corretamente.
• O adaptador de rede incorreto usado durante a implantação de óvulos pode causar desconexão intermitente de dados ao vivo.

Se as verificações acima forem boas, podemos validar se a fonte de dados está recebendo a solicitação de token autenticada ou não. Execute este url no navegador para verificar o mesmo:
https://FQDN-OF-SERVER.com:9443/livedata/token/new
nome de usuário:LiveDataAdmin
senha:~12Live_Data!12

Se a execução acima da url diretamente no navegador der este erro, ele confirma que o CCX não fornece token de autenticação.
O Firefox não pode estabelecer uma conexão com o servidor em uccx.mapenelsigorta.com:9443.

Portanto, há chances de você estar localizando o defeito CSCvb75279 e precisa entrar em contato com o TAC para obter soluções alternativas.

Para UCCX 11.6 e versões posteriores, use este URL com o nome de usuário e senha do uccxhruser para verificar se a fonte de dados está recebendo a solicitação de token autenticada ou não.

https://FQDN-OF-SERVER.com:9443/livedata/token/new

nome de usuário:uccxhruser
senha: Insira a senha necessária

  Uma autenticação bem-sucedida oferece um novo token, como mostrado na imagem:

Defeito do conhecimento para a fonte de dados de transmissão de dados ao vivo que está offline:

CSCvb67761 : Fonte de transmissão de dados ao vivo offline após 'maxThreads' esgotado na porta 9443
CSCvb75279 : Senha de armazenamento de chaves MIVR fora de sincronização, fazendo com que a fonte de fluxo LD fique off-line
CSCvc45189 : Fonte de Dados de Transmissão em Fluxo de Dados ao Vivo Offline após a reconstrução e restauração.

Fonte de dados UCCX mostrando off-line:

Certifique-se de que o banco de dados do CCX esteja online e verifique se o serviço do banco de dados do Cisco Unified CCX está EM SERVIÇO na página de manutenção do CCX.

A fonte de dados UCCX que se conecta ao banco de dados de histórico (db_cra) do CCX também pode ficar off-line se um dos parâmetros da página de configuração do curso de dados não estiver correto. Certifique-se de que todos os campos estão corretos, como mostrado na imagem, caso contrário, ele não poderá se conectar à instância do banco de dados.

                                                     

Até a versão 11.0, você usa o usuário uccxhrc para se conectar ao banco de dados e esse usuário tem permissões para executar procedimentos armazenados.

O CUIC usa o usuário uccxhrc para executar o procedimento armazenado e a senha para esse usuário está codificada. Então, caso todos os parâmetros estejam corretos e

mesmo assim, você vê a fonte de dados como offline e pode tentar atualizar a senha com estas credenciais:

Nome de usuário: uccxhrc
Senha: 5:T{i,5e!KqD*8

Depois de atualizar a senha manualmente no CUIC, clique em fonte de dados e selecione UCCX e, em seguida, Editar, faça um teste de conexão e clique em Salvar, como mostrado na imagem:

                                                 

A partir da versão 11.5, você não usa o usuário uccxhrc em vez do uccxhruser para se conectar ao banco de dados CCX.

A senha para uccxhruser é mantida por meio do gerenciamento de senha: CCX Administration > Tools > Password Management > Historical Reporting User. Mais informações estão no tópico de gerenciamento de senha.

Cuidado: Não use a senha 5:T{i,5e!KqD*8 da versão 11.5, pois não há nenhum usuário uccxhrc iniciando 11.5. Se você estiver atualizando a senha do uccxhruser em 11.5, tente manter com pouco uso de caracteres especiais e a senha não deve conter parênteses "(". 

ID do defeito se parênteses usado: CSCvf21099

Defeitos conhecidos:

CSCvb72142 : A alteração da senha do usuário do Historical Reporting às vezes quebra o CUIC

CUIC autônomo para CCX

O CCX da versão 11.0 suporta a integração do CUIC autônomo além do CUIC co-residente já existente.

O CUIC autônomo suporta várias fontes de dados, incluindo o Unified CCX.

AutônomoCuic pode ser configurado na página do aplicativo UCCX e pode ser usado para obter relatórios personalizados e pode ser instalado com licenças padrão, aprimoradas e premium.

Configuração do CUIC autônomo com UCCX 

      

1. Faça login no CUIC autônomo e selecione Fontes de dados na alça esquerda.
2. Selecione criar e adicionar fonte de dados UCCX. A ID de usuário do banco de dados é uccxhruser e a senha é definida na página de gerenciamento de senha:                                                                                                                                                                                                                                                                            
3. Faça login na página do Unified CCX Administrator.
4. Clique em Sistema e selecione Configuração independente do CUIC.
5. Como mostrado na imagem, insira FQDN do servidor CUIC autônomo, Nome da fonte de dados (criado no servidor CUIC autônomo), Nome de usuário e Senha do servidor CUIC.                                                                           
6. Click Save. As configurações do CUIC são salvas e uma mensagem de êxito é exibida.

Solução de problemas comum com a integração do CUIC autônomo

• Verifique se o FQDN está correto.
• Verifique se a conectividade de rede está UP e se o servidor CUIC pode ser acessado do servidor UCCX
• O nome de usuário ou a senha digitada para o servidor CUIC autônomo estão incorretos.
• O nome da instância fornecido para a fonte de dados com correspondência autônoma com o nome no UCCX.
• O serviço de banco de dados do Cisco Unified CCX na página Serviceability deve ser INSERVICE.