© 2008 AudioCodes Ltd. All rights reserved. Paulo Borelli Pré-vendas, AudioCodes, Brasil Dezembro de 2008 Debug Records Versões 5.2/5.4/5.6

© 2008 AudioCodes Ltd. All rights reserved.

Paulo Borelli

Pré-vendas, AudioCodes, Brasil

Dezembro de 2008

Debug RecordsVersões 5.2/5.4/5.6

AudioCodes confidential information

Introdução

• A versão 5.2 introduz uma nova e avançada ferramenta de debug.

• O Debug Recording (DR) permite a captura remota de pacotes de sinalização, mídia, DSPs, protocolos TDM etc.

• Numa mesma interface, unifica-se a configuração dos diversos tipos de informações de debug do gateway.

• As antigas ferramentas TrunkTraces (/TrunkTraces) e DSP Records (/FAE) foram desativadas e substituídas por comandos do DR.

• O DR aplica-se a todos os gateways MP-11x/124 e Mediant/IPMedia com SIP, MGCP e MEGACO


Introdução

Rede IP

Regras:• R2• PRI• SS7• TDM• Analógico• …

Regras:• SIP• RTP• MGCP• H.248• RTCP• SCTP• …

Windows 2000/XP/Vista& WireShark 0.99.8

O usuário definirá na ferramenta DR:• Os tipos de pacotes que deseja capturar (Regras ou Trace Rules)• Para qual IP os pacotes capturados serão enviados (IP Targets)

PABX

Target

MP-11x/124Mediant 600/1000/2000/3000/5000/8000


Operação – Acesso

• A ferramenta Debug Recordings encontra-se em:

http://<IP do Gateway>/FAE• Exemplo:

http://192.168.1.1/FAE


• A configuração é feita por linha de comando.• Clique em Cmd Shell



• Ative o Debug Recording com o comando “DR”• Clique em ENTER• Você verá a lista completa de comandos do DR. Exemplos:

– StopRecording– StartRecording– SetDefaultTargets– etc.



• As letras maiúsculas indicam as formas reduzidas dos comandos

• Exemplos– STOPrecording pode ser ativado por “STOP” (ou “stop”)– AddIPControlTrace pode ser ativado por “AIPCT” (ou “aipct”)– SetDefaultTarget pode ser ativado por “SDT” (ou “sdt”)– etc.– Ao digitar os comandos, não faz diferença usar maiúsculas ou minúsculas



Operação – Filosofia

• O usuário definirá o “target”. O target é o destino para onde o gateway enviará a(s) captura(s). O target tem que ser um PC com Windows 2000/XP/Vista rodando WireShark 0.99.8.– Nenhuma outra versão de WireShark ou Ethereal funcionará. Os plugins de

Debug Recording da AudioCodes só funcionam na 0.99.8. Não funcionam em versões anteriores nem posteriores.

– Por default, os pacotes DR são enviados para a porta UDP 925 (destino).– Exemplo: ait 192.168.1.100

• Neste caso, o PC está em 192.168.1.100 (porta UDP default = 925)

– Exemplo: ait 192.168.1.100 999• Neste caso, os traces serão enviados à porta UDP 999 do PC cujo IP é 192.168.1.100

– É necessário instalar os plugins AudioCodes no diretório de plugins do WireShark (veja detalhes à frente)



• O usuário deverá definir as Trace Rules.• Cada Trace Rule define o tipo de informação que será

capturado (SIP, CAS, ISDN etc.).• Para múltiplas capturas simultâneas, defina múltiplas Trace

Rules.• Cada Trace Rule deve apontar para um target, a fim de que

os pacotes sejam recebidos no PC.• Os pacotes com as capturas são enviados ao target

encapsulados no protocolo proprietário “AudioCodes Debug Recording”.

• Após instalar os plugins no WireShark, este terá condições de decodificar os pacotes.



• Captura de CAS

• Captura de SIP

• Captura de RTP

• Exemplos no WireShark– Porta UDP (Destino) = 925– Após o protocolo “AudioCodes Debug Recording”, encontram-se os

protocolos capturados (CAS, SIP, RTP…)


Operação – Comandos Básicos

• Para ver o guia de referência de cada comando, basta digitar o nome do comando (abreviado ou não) na linha de comando

• ait (AddIpTrace) – adiciona um novo target• Exemplo: ait 192.168.1.100• É possível mudar o número da porta UDP default (destino):

• Exemplo: ait 192.168.1.100 999• Isto faria com que os pacotes fossem enviados à porta UDP 999

• lt (ListTargets) – lista os targets existentes• rt (RemoveTarget) – remove um target da lista. A opção “all”

remove todos os targets configurados• Exemplo: rt all• Exemplo: rt 0 (onde “0” é o índice do target conforme lista gerada pelo

comando “lt”)



• aipct (AddIPControlTrace) – cria uma regra (rule) para capturar protocolos de controle (como SIP ou MGCP).• Exemplo: aipct n2h sip• Neste exemplo, é criada a regra para captura de SIP. No caso de SIP (e

também MGCP), a captura é sempre nos dois sentidos por default – Net to Host (n2h) e Host to Net (h2n). Porém, é necessário indicar um dos sentidos. “net” é a rede IP e “host” é o gateway.

• apst (AddPstnSignalingTrace) – cria uma regra para capturar protocolos de sinalização TDM (CAS, ISDN, SS7).• Exemplo (CAS R2): apst cas• Exemplo (ISDN-PRI): apst isdn• Exemplo (SS7): apst ss7• É necessário entrar na página de Trunk Traces e indicar em quais

troncos será feita a captura de PSTN (vide próximo slide)



• No caso de SS7, para uso do comando apst, é também necessário ativar traces no Link SS7 e no respectivo Signaling Node (SN).

Trace Ativado no SN Trace Ativado no Link



• Para realizar capturas de PSTN (CAS ou ISDN) é necessário acessar a página TrunkTraces. O link está na própria página /FAE.

• Altere apenas os campos dos troncos. Não utilize os demais campos• Eleja o(s) tronco(s) no(s) qual(is) será feita a captura e configure-o(s) em

“acFULL_TRACE”• Enable PSTN Trace from Web = Off• Port = 0• Clique em Submit



• anct (AddNextCallTrace) – cria uma regra para capturar pacotes RTP/RTCP, T.38, Syslog entre outros.• Exemplo: anct all-with-pcm 1 dynamic• Isto gerará a captura da chamada atual e de todas as novas chamadas até

que a captura seja interrompida.• No MP-11x/124, na versão 5.2, usar anct all 1 dynamic• O anct permite capturar:

• Mídia IP (RTP) – pacotes entre o DSP e a rede IP (G.711A, G.711u, G.729, G.723.1 etc.)

• Mídia TEL (Analógico ou TDM) em formato RTP (sempre G.711u) para fácil leitura/execução – pacotes entre o DSP e o lado TEL.

• start – inicia as capturas de acordo com as regras configuradas

• stop – interrompe todas as capturas em curso


Operação – Plugins do WireShark

• Estes plugins funcionam apenas no WireShark 0.99.8. Em nenhum outro – nem posterior nem anterior.

• Os arquivos são:

• Ponha estes arquivos no diretório de plugins do WireShark 0.99.8.• Exemplo: C:\Program Files\Wireshark\plugins\0.99.8


• Carregue o WireShark normalmente• Verifique se não há mensagens de erro durante sua

inicialização• Verifique se os plugins foram corretamente carregados pelo

WireShark.• Edit -> Preferences -> Protocols

Operação – Plugins do WireShark

Se você modificar a porta UDP default (destino) no gateway (comando “ait”), faça a mesma modificação no WireShark!


Operação – Exemplo

• Queremos capturar SIP, RTP e CAS-R2 e receber os pacotes no PC em 192.168.1.100 (na porta UDP 925)

• Utilizaremos a seguinte seqüência de comandos:• dr (entramos na ferramenta de Debug Recording)• ait 192.168.1.100 (criamos um target no IP 192.168.1.100)• aipct n2h sip (criamos uma regra para capturar SIP)• apst cas (criamos uma regra para capturar CAS-R2)• anct all-with-pcm 1 dynamic (para capturar a mídia RTP da

chamada ativa e todas as novas)• Em TrunkTraces, configure “acFULL_TRACE” no tronco desejado• start

• Inicie a captura no WireShark e realize uma chamada de testes• Interrompa a captura do WireShark ao fim do teste• Execute o comando “stop”



• Para olhar a captura no WireShark, utilize o filtro:acdr ou udp.port==925

• Para olhar somente o conteúdo SIP vindo por DR:acdr && sip

• Para olhar somente o conteúdo RTP vindo por DR:acdr && rtp

• E assim por diante.• Para olhar tanto SIP quanto RTP:acdr && (sip || rtp)

• Muitas funções do WireShark funcionarão normalmente:• Gráfico VoIP Calls• Gravação de arquivo de áudio (.au) a partir do G.711u (DSP<->TEL) ou a

partir do G.711 capturado da rede IP entre outras funções.



SIP + SDP + RTP + CAS

SS7 (Lado TDM)


Operação – Exemplo SIP + CAS


Operação – Exemplo SS7 (Lado TDM)


Características Operacionais

• Até 10 targets podem ser criados• Até 50 regras (rules) de captura podem ser criadas• Até 30 capturas simultâneas de mídia (RTP) na TP-6310

(Mediant 3000)• Até 15 capturas simultâneas de mídia (RTP) na TP-1610

(Mediant 2000) e no MP-118• É possível configurar os targets para que recebam os traces

em portas diferentes da UDP 925 (via comando “ait”)


CUIDADO!

• A ferramenta Debug Records é implementada nos DSPs dos gateways.

• Portanto, DR consome canais de voz!• Não a use se o gateway estiver próximo de 100% de

ocupação, pois ele poderá rejeitar novas chamadas.• Ao concluir as capturas, desative a ferramenta (comando

STOP).• No caso de SS7, desligue os traces do Signaling Node e do

Link SS7.


Para Recomeçar…

• Se você precisar recomeçar, é possível “limpar” a ferramenta utilizando os seguintes comandos:• rtr all (remove todas as regras)• rt all (remove todos os targets)• stop (interrompe capturas em curso)• Agora, recrie seu target, suas regras e digite start

novamente.

Documents

© 2008 AudioCodes Ltd. All rights reserved. Paulo Borelli Pré-vendas, AudioCodes, Brasil Dezembro de 2008 Debug Records Versões 5.2/5.4/5.6