[UCCX] Versão de JTAPI inconsistente com o UCM

Em ambientes com Cluster de UCM integrado com um (ou vários) Clusters de UCCX devemos ter cautela em relação a versão de JTAPI que é utilizada por ambas as soluções: A versão do JTAPI precisa ser a mesma para que a integração funcione.

Para quem não sabe, a integração UCM x UCCX funciona através de JTAPI. Caso queira aprender mais sobre, recomendo os seguintes links.

http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/jtapi_dev/8_6_1/jtapidevguide.html

http://www.oracle.com/technetwork/java/jtapi-136088.html

Continuando...

Ao realizar o update de versão do UCM para uma release mais recente, verifique no RELEASE NOTES da versão do update quais são as novas firmwares/plugins que serão instalados.

Este exemplo é do Release Notes do update 8.6(2a)su3:

http://www.cisco.com/web/software/282074295/102724/cucm-readme-862asu3.pdf

jtapi_plugin.PNG

Neste documento podemos ver que o update contém uma nova versão do plugin JTAPI para o UCM e desta forma teremos que atualizar o plugin nos servidores de UCCX, caso contrário, a integração não irá funcionar.

Verificando a versão do JTAPI no UCCX

Acesso o servidor via CLI e execute o comando #show uccx jtapi_client version

Será exibido a versão que está na partição ativa (em produção) e na partição inativa do UCCX.

#show uccx jtapi_client version

Active:Cisco JTAPI version 8.6(2.10000)-10 Release

Inactive: Cisco JTAPI version 8.5(1.10000)-1 Release

Conforme exibido acima, podemos ver que no UCCX a versão do JTAPI que encontra-se na partição ativa é a 8.6(2.10000)-10, e desta forma podemos deduzir que a versão de JTAPI que o UCM possui é a mesma, senão a integração não funcionaria.

Sincronizando a versão de JTAPI do UCCX com o UCM

Após realizado o upgrade do UCM e tomado nota de refazer o re-sincronismo do JTAPI no UCCX, agora temos duas opções: Fazer o resync via interface WEB ou via CLI.

Sincronizando o a versão do JTAPI via interface WEB

Após validar o upgrade do seu UCM com sucesso, agora é hora de verificar o UCCX. Logo após efetuar o login na interface de administração do UCCX você receberá uma mensagem de erro relacionado a versão do JTAPI não estar sincronizada. Não se assuste, para corrigir isso basta ir em Subsystems >>> Cisco Unified CM Telephony >>> Cisco JTAPI Resync


jtapi_resync.PNG

O sincronismo será feito (o UCCX baixa e aplica o novo client JTAPI do UCM) e será solicitado reiniciar o serviço UCCX Engine do UCCX, muito cuidado pois este é o serviço principal do UCCX, reiniciando ele ocorrerá indisponibilidade para os agentes, supervisores e principalmente para os clientes das filas de atendimento.

Após este procedimento, vá novamente em Cisco JTAPI Resync e execute a verificação, deverá aparecer versões consistentes. (Sucesso total)

jtapi_resync2.PNG

Sincronizando a versão do JTAPI via CLI

Jtapi error1.PNG

Caso o update via interface WEB não funcione (já aconteceu comigo, veja imagem acima) temos a opção via CLI. Acesse o servidor via CLI, e execute o comando

utils uccx jtapi_client update

o sincronismo será feito e será solicitado o restart dos serviços:


#utils service restart Cisco Unified CCX Cluster View Daemon

#utils service restart Cisco Tomcat

Histórico de versão
Revisão #
1 de 1
Última actualização:
‎03-02-2014 06:35 AM
Actualizado por:
 
Etiquetas (1)
Marcas (2)