1 / 25

Debug Records Versões 5.2/5.4/5.6

Debug Records Versões 5.2/5.4/5.6. 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.

matana
Download Presentation

Debug Records Versões 5.2/5.4/5.6

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Debug Records Versões5.2/5.4/5.6

  2. 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 todosos gateways MP-11x/124 e Mediant/IPMedia com SIP, MGCP e MEGACO

  3. Introdução • O usuáriodefiniránaferramenta DR: • Os tipos de pacotesquedesejacapturar (Regrasou Trace Rules) • Para qual IP ospacotescapturadosserãoenviados (IP Targets) MP-11x/124 Mediant 600/1000/2000/3000/5000/8000 • Regras: • R2 • PRI • SS7 • TDM • Analógico • … • Regras: • SIP • RTP • MGCP • H.248 • RTCP • SCTP • … PABX Target Windows 2000/XP/Vista & WireShark0.99.8 Rede IP

  4. Operação – Acesso • A ferramenta Debug Recordings encontra-se em: http://<IP do Gateway>/FAE • Exemplo: http://192.168.1.1/FAE

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

  6. Operação – Acesso • 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.

  7. Operação – Acesso • 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

  8. Operação – Filosofia • O usuáriodefinirá o “target”. O target é o destinoparaonde o gateway enviará a(s) captura(s). O target tem que ser um PC com Windows 2000/XP/Vista rodandoWireShark 0.99.8. • Nenhumaoutraversão de WireSharkou Ethereal funcionará. Os plugins de Debug Recording da AudioCodes sófuncionamna 0.99.8. Nãofuncionamemversõesanterioresnemposteriores. • Por default, ospacotes DR sãoenviadospara a portaUDP 925 (destino). • Exemplo: ait 192.168.1.100 • Nestecaso, o PC estáem 192.168.1.100 (porta UDP default = 925) • Exemplo: ait 192.168.1.100 999 • Nestecaso, os traces serãoenviados à porta UDP 999 do PC cujo IP é 192.168.1.100 • É necessárioinstalarosplugins AudioCodes no diretório de plugins do WireShark (vejadetalhes à frente)

  9. Operação – Filosofia • 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.

  10. Operação – Filosofia • Exemplos no WireShark • Porta UDP (Destino) = 925 • Após o protocolo “AudioCodes Debug Recording”, encontram-se os protocolos capturados (CAS, SIP, RTP…) • Captura de CAS • Captura de SIP • Captura de RTP

  11. Operação – Comandos Básicos • Para ver o guia de referência de cadacomando, bastadigitar o nome do comando (abreviadoounão) nalinha de comando • ait (AddIpTrace) – adiciona um novo target • Exemplo: ait 192.168.1.100 • É possívelmudar o número da porta UDP default (destino): • Exemplo: ait 192.168.1.100 999 • Istofaria com queospacotesfossemenviados à porta UDP 999 • lt (ListTargets) – listaos targets existentes • rt (RemoveTarget) – remove um target da lista. A opção “all” remove todosos targets configurados • Exemplo: rt all • Exemplo: rt 0 (onde “0” é o índice do target conformelistageradapelocomando “lt”)

  12. Operação – Comandos Básicos • aipct(AddIPControlTrace) – criaumaregra (rule) paracapturarprotocolos de controle (como SIP ou MGCP). • Exemplo: aipct n2h sip • Nesteexemplo, é criada a regraparacaptura de SIP. No caso de SIP (e também MGCP), a captura é semprenosdoissentidospor default – Net to Host (n2h) e Host to Net (h2n). Porém, é necessárioindicar um dos sentidos. “net” é a rede IP e “host” é o gateway. • apst(AddPstnSignalingTrace) – criaumaregraparacapturarprotocolos de sinalização TDM (CAS, ISDN, SS7). • Exemplo (CAS R2): apstcas • Exemplo (ISDN-PRI): apstisdn • Exemplo (SS7): apst ss7 • É necessárioentrarnapágina de Trunk Traces e indicaremquaistroncosseráfeita a captura de PSTN (vide próximo slide)

  13. Operação – Comandos Básicos • No caso de SS7, parauso do comandoapst, é tambémnecessárioativar traces no Link SS7 e no respectivo Signaling Node (SN). Trace Ativado no SN Trace Ativado no Link

  14. Operação – Comandos Básicos • Para realizarcapturas de PSTN (CAS ou ISDN) é necessárioacessar a página TrunkTraces. O link estánaprópriapágina /FAE. • Altereapenasoscampos dos troncos. Nãoutilize osdemaiscampos • 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

  15. Operação – Comandos Básicos • 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 anctpermitecapturar: • 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ógicoou TDM) emformato RTP (sempre G.711u) parafácilleitura/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

  16. Operação – Plugins do WireShark • Estes pluginsfuncionamapenas no WireShark0.99.8. Emnenhumoutro – nem posterior nem anterior. • Os arquivossão: • Ponhaestesarquivos no diretório de plugins do WireShark0.99.8. • Exemplo: C:\Program Files\Wireshark\plugins\0.99.8

  17. Operação – Plugins do WireShark • Carregue o WireShark normalmente • Verifique se nãohámensagens de errodurantesuainicialização • Verifique se ospluginsforamcorretamentecarregadospelo WireShark. • Edit -> Preferences -> Protocols Se você modificar a porta UDP default (destino) no gateway (comando “ait”), faça a mesma modificação no WireShark!

  18. Operação – Exemplo • Queremoscapturar SIP, RTP e CAS-R2 e receberospacotes no PC em 192.168.1.100 (naporta UDP 925) • Utilizaremos a seguinteseqüência de comandos: • dr (entramosnaferramenta de Debug Recording) • ait 192.168.1.100 (criamos um target no IP 192.168.1.100) • aipct n2h sip (criamosumaregraparacapturar SIP) • apstcas(criamosumaregraparacapturar CAS-R2) • anct all-with-pcm 1 dynamic (paracapturar a mídia RTP da chamadaativa e todas as novas) • Em TrunkTraces, configure “acFULL_TRACE” no troncodesejado • start • Inicie a captura no WireShark e realize umachamada de testes • Interrompa a captura do WireShark aofim do teste • Execute o comando “stop”

  19. Operação – Exemplo • Para olhar a captura no WireShark, utilize o filtro: • acdrouudp.port==925 • Para olharsomente o conteúdoSIP vindopor DR: • acdr && sip • Para olharsomente o conteúdoRTP vindopor DR: • acdr && rtp • E assimpordiante. • Para olhartanto SIP quanto RTP: • acdr && (sip || rtp) • Muitasfunçõesdo WireShark funcionarãonormalmente: • GráficoVoIP 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 outrasfunções.

  20. Operação – Exemplo SIP + SDP + RTP + CAS SS7 (Lado TDM)

  21. Operação – Exemplo SIP + CAS

  22. Operação – Exemplo SS7 (Lado TDM)

  23. Características Operacionais • Até 10 targets podem ser criados • Até 50 regras (rules) de capturapodem ser criadas • Até 30 capturassimultâneas de mídia (RTP) na TP-6310 (Mediant 3000) • Até 15 capturassimultâneas de mídia (RTP) na TP-1610 (Mediant 2000) e no MP-118 • É possívelconfiguraros targets paraquerecebamos traces emportasdiferentes da UDP 925 (via comando “ait”)

  24. CUIDADO! • A ferramenta Debug Records é implementadanos DSPs dos gateways. • Portanto, DR consomecanais de voz! • Não a use se o gateway estiverpróximo de 100% de ocupação, poiselepoderárejeitar novas chamadas. • Aoconcluir as capturas, desative a ferramenta (comando STOP). • No caso de SS7, desligueos traces do Signaling Node e do Link SS7.

  25. Para Recomeçar… • Se vocêprecisarrecomeçar, é possível “limpar” a ferramentautilizandoosseguintescomandos: • rtr all (remove todas as regras) • rt all (remove todosos targets) • stop (interrompecapturasemcurso) • Agora, recrieseu target, suasregras e digite start novamente.

More Related