Configuração e análise de log do Jabber E911

Introduction

Este documento descreve a implantação do Jabber E911 junto com uma análise de rastreamento em relação ao comportamento do Jabber quando o 911 ou os números de emergência são discados do softphone.

Prerequisites

Requirements

A Cisco recomenda que você conheça:

• Configuração do Cisco Unified Communications Manager.
• Conceitos básicos do protocolo SIP.
• Roteamento de chamada básica no CUCM.

Componentes Utilizados

Este documento não se restringe a versões de software e hardware específicas.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Configurar

A configuração básica do número E911

O recurso Remote Worker Emergency Calling (RWEC) permite que você ofereça suporte confiável a chamadas de emergência para funcionários remotos com conexões VPN (Virtual Private Network) remotas. As chamadas de emergência de usuários externos são roteadas para o PSAP (Public Safety Answering Point, ponto de atendimento de segurança pública) e as informações de local fornecidas pelo usuário são fornecidas com cada chamada.

Você deve configurar o Intrado (um aplicativo de terceiros) no Cisco Emergency Responder antes de configurar o recurso RWEC. Para obter informações sobre como configurar o Intrado no Cisco Emergency Responder, consulte o Cisco Emergency Responder Administration Guide.

Etapa 1. Configurar o usuário como um trabalhador remoto:

1. Navegue até Cisco Unified CM Administration >Device > Phone.
2. Digite os critérios de pesquisa apropriados para localizar o telefone e clique em Localizar. Uma lista de telefones que correspondem aos critérios de pesquisa é exibida.

3. Selecione o telefone para o qual deseja configurar o RWEC. A janela Phone Configuration é exibida.

4. Na seção Device Information (Informações do dispositivo), selecione a ID de usuário apropriada na lista suspensa Owner User ID (ID de usuário proprietário) e marque a caixa de seleção Require off-local location (Exigir local externo).
5. Click Save.

Etapa 2. Especifique uma rota alternativa para chamada de emergência

1. Navegue até Cisco Unified CM Administration > System > Service Parameters.
2. Na lista suspensa Servidor, selecione um servidor.
3. Na lista suspensa Serviço, selecione Cisco CallManager. A janela Service Parameter Configuration é exibida.
4. Na seção Clusterwide Parameters (Emergency Calling for Required Off-premise Location), especifique Alternate Destination for Emergency Call.
5. Especifique um Espaço de Pesquisa de Chamada Alternativo para Chamada de Emergência.
6. Click Save.

Etapa 3. Configurar o servidor de aplicativos

Observação: você deve configurar o servidor de aplicativos para permitir que o Proxy E911 se comunique com o Cisco Emergency Responder. O proxy E911 é usado para direcionar os usuários para o servidor de aplicativos onde eles entram no local do dispositivo.

1. Navegue até Cisco Unified CM Administration > System > Application Server.
2. Clique em Adicionar novo. A janela Servidor de aplicativos é exibida.
3. Na lista suspensa Tipo de servidor de aplicativos, selecione Gerenciamento de local CER.
4. Clique em Next
5. No campo Nome, especifique um nome para identificar o servidor de aplicativos a ser configurado.
6. No campo de endereço IP, especifique o endereço IP do servidor a ser configurado.
7. Na lista Available Application Users (Usuários de aplicativos disponíveis), selecione o usuário do aplicativo e clique na seta para baixo.
8. No campo URL do usuário final, digite uma URL para os usuários finais associados a este servidor de aplicativos.
9. Click Save.

Etapa 4. Configurar mensagens E911

1. Navegue até Cisco Unified CM Administration > System > E911 Messages.
2. Selecione o link de idioma necessário das mensagens E911. A página E911 Messages Configuration (Configuração de mensagens E911) exibe as mensagens de Contrato, Isenção de responsabilidade e Erro.
3. (Opcional) Edite as mensagens E911 a serem exibidas em dispositivos externos.
4. Click Save.

Implantação

Se você usar o Jabber internamente, poderá defini-lo como faria com um telefone físico através do plano de discagem ou através do Cisco Emergency Responder (CER).

Se você o usa em um ambiente remoto, há algumas maneiras de abordá-lo e ele difere do Jabber para Windows/MAC e Jabber no iPhone e Android.

Para usuários remotos Windows e MAC, o CER tem uma página de mobilidade na qual os usuários podem atualizar manualmente sua localização E911. Se, por exemplo, você trabalha de casa, você pode digitar seu endereço residencial como a Linha de Resposta de Emergência (ERL) para seu Número de Diretório (DN), mas você deve alterá-lo quando voltar para o escritório ou mudar para outro local.

Para dispositivos móveis, o padrão é fazer com que o Jabber use a rede celular e o número quando o número 911 for discado para que o local do telefone seja o que é recebido pelo PSAP (Public Safety Answering Point, ponto de atendimento de segurança pública) e possa identificar o local do chamador e retornar a chamada, se necessário.

Além disso, o sistema rastreia e atualiza automaticamente mudanças e alterações de equipamentos. Se você implantar esse recurso, ele poderá ajudar a garantir uma conformidade mais efetiva com as obrigações legais ou regulamentares e reduzir o risco de responsabilidade relacionada às chamadas de emergência como resultado.

Note: Muitos dos provedores de serviços E911, como Redsky, também fornecem serviços de mobilidade semelhantes ao CER.

No guia de configuração do Jabber, você pode observar esta descrição:

Análise de log

No Jabber Problem Report (Relatório de problemas do Jabber), o comportamento do mapa padrão do número de emergência E911 pode ser visto. Aqui está a análise de dígitos e o processo de chamada:

2021-09-14 14:53:26,773 DEBUG [0x0000000107573880] [nyservice/TelephonyAdapterVoice.cpp(317)] [jcf.tel.adapter] [applyDirectoryLookupRules] - Number BEFORE applying directory lookup rules: [9911] 
2021-09-14 14:53:26,773 DEBUG [0x0000000107573880] [ory/ContactResolutionFeatureSet.cpp(424)] [ContactService-ContactsAdapter] [resolveBySipUriOrNumber] - sip uri=, number=9911, display name=9911 
2021-09-14 14:53:37,252 DEBUG [0x0000000107573880] [pl/CommunicationHistoryItemImpl.cpp(151)] [CommunicationHistoryService-CommunicationHistoryAdapter] [CommunicationHistoryItemImpl] - New item contains: jid = dialedNumber = 9911 displayName = 9911 contact picked from phone number 

Dois relatórios de problemas Jabber foram coletados, um passa pela rede GSM e outro pelo tronco SIP para o CUCM. Ambos foram comparados.

2021-09-29 12:38:53,644 INFO  [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(561)] [jcf.tel.config] [setUptheConfigListeners] - Config notifier added for Value property Key: [E911NotificationUrl]
2021-09-29 12:38:53,644 DEBUG [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(675)] [jcf.tel.config] [cacheAllConfigFromService] - Config not found for Key: [E911NotificationUrl]. Using default value: []
2021-09-29 12:38:53,646 INFO  [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(561)] [jcf.tel.config] [setUptheConfigListeners] - Config notifier added for Value property Key: [EnableE911OnPremLocationPolicy]
2021-09-29 12:38:53,646 INFO  [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(568)] [jcf.tel.config] [setUptheConfigListeners] - Config notifier added for isDefined property for key: [EnableE911OnPremLocationPolicy]
2021-09-29 12:38:53,646 INFO  [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(561)] [jcf.tel.config] [setUptheConfigListeners] - Config notifier added for Value property Key: [EnableE911EdgeLocationPolicy]
2021-09-29 12:38:53,646 INFO  [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(568)] [jcf.tel.config] [setUptheConfigListeners] - Config notifier added for isDefined property for key: [EnableE911EdgeLocationPolicy]
2021-09-29 12:38:53,646 INFO  [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(561)] [jcf.tel.config] [setUptheConfigListeners] - Config notifier added for Value property Key: [E911EdgeLocationWhiteList]
2021-09-29 12:38:53,646 INFO  [0x000000010b6db880] [ager/TelephonyConfigManagerImpl.cpp(568)] [jcf.tel.config] [setUptheConfigListeners] - Config notifier added for isDefined property for key: 
2021-09-29 12:38:53,688 DEBUG [0x000000010b6db880] [nyservice/TelephonyAdapterVoice.cpp(317)] [jcf.tel.adapter] [applyDirectoryLookupRules] - Number BEFORE applying directory lookup rules: [9911]
2021-09-29 12:38:53,688 DEBUG [0x000000010b6db880] [nyservice/TelephonyAdapterVoice.cpp(321)] [jcf.tel.adapter] [applyDirectoryLookupRules] - Number AFTER applying directory lookup rules: [9911]

Essas configurações de política identificam que 911 é discado no Jabber e atua como o comportamento padrão.

Esse comportamento pode ser identificado se você navegar para o dispositivo TCT ou BOT no CUCM, onde você pode encontrar o campo Números de emergência na seção Layout de configuração específico do produto. Você pode pressionar? ao lado do cabeçalho da seção, que o leva à página de ajuda on-line, onde você pode encontrar uma declaração muito clara de como ele deve funcionar:

               

Números de emergência:

Uma lista delimitada por ',' de números de emergência (por exemplo, 911). Esses números serão discados através do GSM em vez do softphone.

Padrão: 999,911,112

Comprimento máximo: 32".

Imagem do caminho para a configuração:

Esse cenário não cobre o tratamento de chamadas SIP, pois ele é redirecionado para o CER para executar o roteamento de chamada apropriado.

Note: Você também pode remover o 911 para ser reconhecido como um número de emergência para o CUCM de acordo com o Guia de Configuração de Recursos.
Quando o número de emergência Jabber é removido do manipulador de chamadas, o processamento da chamada é executado como uma chamada normal.

Neste cenário, em que a chamada é roteada para o CER e para o PSAP, o processamento da chamada deve gerar um CONVITE para iniciar uma chamada como uma chamada SIP regular:

O CONVITE SIP É gerado, o número é tomado como "911" e roteado através do tronco SIP.

2021-09-29 13:11:30,890 DEBUG [0x00000001705f7000] [/sipcc/core/sipstack/ccsip_debug.c(1735)] [csf.sip-call-control] [platform_print_sip_msg] - sipio-sent---> INVITE sip:911@daviher2.domain.com;user=phone SIP/2.0
Via: SIP/2.0/TCP 10.1.10.15:50748;branch=z9hG4bK0f77f9f5
From: "Edward Blake 5518" sip:5518@ daviher2.domain.com ;tag=5e2487c68e45000957e9a9ab-2d8246a4
To: sip:911@ daviher2.domain.com Call-ID: 5e2487c6-8e450004-07c6c702-0b33584b@10.1.10.15Max-Forwards: 70
Session-ID: 726dd14700105000a0005e2487c68e45;remote=00000000000000000000000000000000
Date: Wed, 29 Sep 2021 17:11:30 GMT
CSeq: 101 INVITE
User-Agent: Cisco-TCT
Contact: sip:e1a29201-56bf-2042-32c5-75b15ba90785@10.1.10.15:50748;transport=tcp;+u.sip!devicename.ccm.cisco.com="TCTEDWBLK";video;bfcp
Expires: 180
Accept: application/sdp
Allow: ACK,BYE,CANCEL,INVITE,NOTIFY,OPTIONS,REFER,REGISTER,UPDATE,SUBSCRIBE,INFO
Remote-Party-ID: "Edward Blake 5518" sip:5518@daviher2.domain.com ;party=calling;id-type=subscriber;privacy=off;screen=yes
Call-Info: <urn:x-cisco-remotecc:callinfo>; security=NotAuthenticated; orientation=to; call-instance=1; isVoip
Supported: replaces,join,sdp-anat,norefersub,resource-priority,extended-refer,X-cisco-callinfo,X-cisco-serviceuri,X-cisco-escapecodes,X-cisco-service-control,X-cisco-srtp-fallback,X-cisco-monrec,X-cisco-config,X-cisco-sis-7.0.0,X-cisco-xsi-8.5.1
Allow-Events: kpml,dialog
Recv-Info: conference
Recv-Info: x-cisco-conference
Content-Length: 2730
Content-Type: application/sdp
Content-Disposition: session;handling=optional

O SIP TENTANDO do servidor CUCM significa que ele entrou em contato com o dispositivo remoto para estabelecer a chamada SIP.

2021-09-29 13:11:30,953 DEBUG [0x00000001705f7000] [/sipcc/core/sipstack/ccsip_debug.c(1735)] [csf.sip-call-control] [platform_print_sip_msg] - sipio-recv<--- SIP/2.0 100 Trying
Via: SIP/2.0/TCP 10.1.10.24:50748;branch=z9hG4bK0f77f9f5
From: "Edward Blake 5518" sip:5518@ daviher2.domain.com >;tag=5e2487c68e45000957e9a9ab-2d8246a4
To: sip:911@ daviher2.domain.com Date: Wed, 29 Sep 2021 17:11:30 GMT
Call-ID: 5e2487c6-8e450004-07c6c702-0b33584b@10.1.10.24
CSeq: 101 INVITE
Allow-Events: presence
Content-Length: 0

O SIP 180 Ringing mostra que a negociação inicial de chamada SIP ocorreu e o dispositivo remoto é alertado.

[SIP][MSG]                                                                                                           [SOCK][.]<--- SIP/2.0 180 Ringing
2021-09-29 13:11:38,824 DEBUG [0x00000001705f7000] [/sipcc/core/sipstack/ccsip_debug.c(1735)] [csf.sip-call-control] [platform_print_sip_msg] - sipio-recv<--- SIP/2.0 180 Ringing
Via: SIP/2.0/TCP 10.1.10.24:50748;branch=z9hG4bK0f77f9f5
From: "Edward Blake 5518" sip:5518@ daviher2.domain.com >;tag=5e2487c68e45000957e9a9ab-2d8246a4
To: < To: sip:911@ daviher2.domain.com >;tag=331350799~1551199b-213c-4609-83c4-4420b55caf48-39377222
Date: Wed, 29 Sep 2021 17:11:30 GMT
Call-ID: 5e2487c6-8e450004-07c6c702-0b33584b@10.1.10.24
CSeq: 101 INVITE
Allow: INVITE, OPTIONS, INFO, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY
Allow-Events: presence
Server: Cisco-CUCM12.5
Call-Info: <urn:x-cisco-remotecc:callinfo>; security= Unknown; orientation= to; ui-state= ringout; gci= 2-11891177; isVoip; call-instance= 1
Send-Info: conference, x-cisco-conference
Session-ID: 00000000000000000000000000000000;remote=726dd14700105000a0005e2487c68e45
Remote-Party-ID: <sip:919082059688@10.1.10.11>;party=called;screen=no;privacy=off
Contact: <sip:911@10.1.10.11:5060;transport=tcp>
Content-Length: 0

O SIP 200 OK é recebido para concluir a chamada e informar quais codecs foram negociados.

2021-09-29 13:11:47,577 DEBUG [0x00000001705f7000] [/sipcc/core/sipstack/ccsip_debug.c(1735)] [csf.sip-call-control] [platform_print_sip_msg] - sipio-recv<--- SIP/2.0 200 OK
Via: SIP/2.0/TCP 10.1.10.24:50748;branch=z9hG4bK0f77f9f5
From: "Edward Blake 5518" sip:5518@ daviher2.domain.com >;tag=5e2487c68e45000957e9a9ab-2d8246a4
To: < To: sip:911@ daviher2.domain.com >;tag=331350799~1551199b-213c-4609-83c4-4420b55caf48-39377222
Date: Wed, 29 Sep 2021 17:11:30 GMT
Call-ID: 5e2487c6-8e450004-07c6c702-0b33584b@10.1.10.24
CSeq: 101 INVITE
Allow: INVITE, OPTIONS, INFO, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY
Allow-Events: presence
Supported: replaces
Server: Cisco-CUCM12.5
Call-Info: <urn:x-cisco-remotecc:callinfo>; security= NotAuthenticated; orientation= to; gci= 2-11891177; isVoip; call-instance= 1
Send-Info: conference, x-cisco-conference
Session-ID: 42582595f8ee52f7a033f11b6679f7ed;remote=726dd14700105000a0005e2487c68e45
Remote-Party-ID: <sip:9082059688@10.1.10.11>;party=called;screen=yes;privacy=off
Contact: <sip:911@10.1.10.11:5060;transport=tcp>
Content-Type: application/sdp
Content-Length: 733

v=0
o=CiscoSystemsCCM-SIP 331350799 1 IN IP4 10.1.10.11
s=SIP Call
c=IN IP4 172.22.191.3
b=AS:80
t=0 0
m=audio 18594 RTP/AVP 0 101
a=ptime:20
a=rtpmap:0 PCMU/8000
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-15
a=trafficclass:conversational.audio.aq:admitted
m=video 0 RTP/AVP 31 34 96 97
a=rtpmap:31 H261/90000
a=rtpmap:34 H263/90000
a=rtpmap:96 H263-1998/90000
a=rtpmap:97 H264/90000
a=content:main
a=inactive
m=video 0 RTP/AVP 31 34 96 97
a=rtpmap:31 H261/90000
a=rtpmap:34 H263/90000
a=rtpmap:96 H263-1998/90000
a=rtpmap:97 H264/90000
a=content:slides
a=inactive
m=application 0 UDP/BFCP *
c=IN IP4 0.0.0.0
m=application 0 RTP/AVP 96
a=rtpmap:96 H224/0
a=inactive
m=application 0 UDP/UDT/IX

Finalmente, o dispositivo Jabber envia uma ACK SIP ao servidor, que indica que a chamada foi concluída com êxito.

2021-09-29 13:11:47,591 DEBUG [0x00000001705f7000] [/sipcc/core/sipstack/ccsip_debug.c(1735)] [csf.sip-call-control] [platform_print_sip_msg] - sipio-sent---> ACK sip:911@10.1.10.11:5060;transport=tcp SIP/2.0
Via: SIP/2.0/TCP 10.1.10.24:50748;branch=z9hG4bK0dbb4bc2
From: "Edward Blake 5518" sip:5518@ daviher2.domain.com >;tag=5e2487c68e45000957e9a9ab-2d8246a4
To: < To: sip:911@ daviher2.domain.com >;tag=331350799~1551199b-213c-4609-83c4-4420b55caf48-39377222
Call-ID: 5e2487c6-8e450004-07c6c702-0b33584b@10.1.10.24
Max-Forwards: 70
Session-ID: 726dd14700105000a0005e2487c68e45;remote=42582595f8ee52f7a033f11b6679f7ed
Date: Wed, 29 Sep 2021 17:11:47 GMT
CSeq: 101 ACK
User-Agent: Cisco-TCT
Remote-Party-ID: "Edward Blake 5518" sip:5518@ daviher2.domain.com >;party=calling;id-type=subscriber;privacy=off;screen=yes
Recv-Info: conference
Recv-Info: x-cisco-conference
Content-Length: 0

Com esse procedimento, a chamada passa pelo tronco SIP registrado no CUCM.

Note: É importante mencionar que você tem a opção de remover o 911 ou qualquer outro número de emergência para ser reconhecido como um número que não é de emergência e, nesse cenário, a chamada pode ser roteada conforme explicado nesta última análise de log.