Ir para o conteúdo

Roteiro: Gerenciar destinos do dispatcher

Perfil necessário: admin (criar/alterar) | viewer (consulta) Menus usados: Plataforma, Sistema Risco: alto (o dispatcher decide para onde as chamadas de mídia e destinos dinâmicos saem; destino errado ou set editado à mão desvia tráfego real) Rollback: reverter os campos no mesmo dialog (destino/peso/prioridade/estado) ou recriar a entrada excluída; após qualquer reversão, recarregar o dispatcher em Sistema → OpenSIPS. Entradas de media server voltam sozinhas ao salvar o MS correspondente em Media Servers (sincronização automática, set 900).

Pré-requisitos

  • [ ] Entender a que serve o setid que vai editar: 900 = media servers (reservado, gerido pelo catálogo Media Servers); outros sets são destinos dinâmicos de roteamento
  • [ ] Destino SIP válido no formato sip:<host>:<porta> (socket opcional para forçar a interface de saída)
  • [ ] Perfil admin

Passo a passo

1. Abrir a página Dispatcher

Caminho: Plataforma → Infraestrutura → Dispatcher Clique: [Novo Dispatcher] (somente para destinos que não nascem de outra entidade)

Lista de destinos dispatcher com o botão Novo Dispatcher destacado

Colunas da listagem: Set ID, Destino, Socket (interface de saída opcional), Peso, Prioridade, Estado, Probe, Descrição, Attrs.

Leitura de estado (sem clique): - Estado: Tag verde Ativo (state = 0, habilitado para seleção) ou vermelha Inativo (state = 1, fora da rotação). - Probe: Ligado (probe_mode > 0) → o módulo dispatcher envia OPTIONS periódicos (ds_ping_interval 15s, ds_probing_mode 1) e gerencia o estado automaticamente — destino que não responde vai para probing/inativo sozinho. Desligado (probe_mode 0) → estado só muda manualmente ou por reload. - Set 900: linhas com media_server=1 em Attrs e descrição MS:<nome> são o espelho automático do catálogo Media Servers — não edite à mão; mude o MS na página dele.

Resultado esperado: estado coerente com a realidade (nada Ativo que não atende, nada Inativo em produção saudável).

2. Criar um destino

Caminho: Plataforma → Infraestrutura → Dispatcher Clique: [Novo Dispatcher] → botão [Criar] no rodapé do dialog

Dialog Novo Dispatcher aberto

Preencha:

Campo Obrig. Formato/exemplo Efeito
Set ID * sim inteiro ≥ 0 (ex. 900) Grupo lógico de seleção (ds_select_dst); 900 é reservado para media servers
Destino * sim sip:192.168.1.50:5060 URI SIP completa do destino
Peso não (default 1) texto numérico (ex. 1, 50%) Distribuição dentro do set
Prioridade não (default 0) inteiro ≥ 0 Ordem de preferência na listagem/seleção
Estado não (default Ativo (0)) Ativo (0) | Inativo (1) Participa ou não da seleção
Probe Mode não (default Desligado (0)) Desligado (0) | Ligado (1) Liga monitoração OPTIONS do destino
Atributos não texto (ex. media_server=1) Metadados consumidos pelas rotas (ex. attrs do MS)
Descrição não texto curto (max ~64 chars) Contexto operacional

Resultado esperado: nova linha com o setid informado; se Probe Mode = Ligado, OPTIONS começam a ser enviados ao destino.

3. Ativar/desativar um destino (manutenção)

Caminho: Plataforma → Infraestrutura → Dispatcher Clique: ícone Editar (lápis) na linha → Estado Inativo (1) → [Salvar] (ou voltar para Ativo (0) para reabilitar). Exclusão pelo ícone de lixeira pede confirmação Excluir dispatcher "<destino>"?.

Quando mexer: - Destino de mídia (set 900): preferir Ativo/Inativo na página Media Servers — a sincronização replica aqui. - Destino de outro set: editar aqui mesmo; para tirar do ar sem apagar, use Estado = Inativo (1). - Probe desligado e destino fora: ligue Probe Mode = Ligado para o dispatcher detectar a volta sozinho.

Resultado esperado: Tag de Estado refletindo a mudança na listagem.

4. Recarregar o dispatcher

Caminho: Sistema → OpenSIPS Clique: [Recarregar todos os módulos] — ou o cartão Dispatcher → Recarregar para recarregar só este módulo (ds_reload)

Reload OpenSIPS com o botão Recarregar todos os módulos destacado

Resultado esperado: card verde de sucesso. O OpenSIPS lê a tabela e passa a usar os destinos novos imediatamente; chamadas em curso não são afetadas.

Checagem de estado via MI (opcional, no host): opensips-cli -x mi ds_list mostra os sets, destinos e o estado calculado (probing/active/inactive) na memória do OpenSIPS — é a verdade operacional, a coluna Estado da UI reflete a tabela do banco.

Validação

  • [ ] Visual: destino novo listado no setid correto com Estado = Ativo.
  • [ ] Visual: entradas media_server=1 (set 900) batem com os MS ativos em Media Servers.
  • [ ] Funcional: opensips-cli -x mi ds_list reflete o set/destino alterado após o reload.
  • [ ] Funcional (set 900): negação com tratamento de áudio roteia para o destino do set e o anúncio toca.

Erros comuns

Sintoma Causa provável Correção
Destino novo nunca selecionado Reload (ds_reload) não executado Sistema → OpenSIPS → Recarregar todos os módulos
Destino sempre rejeitado / timeout Estado Ativo mas destino fora (probe Desligado) Ligar Probe Mode ou corrigir o URI do destino
Anúncios param de tocar Entrada do set 900 apagada/alterada à mão Recriar via Media Servers (salvar o MS re-sincroniza) ou editar o destino
Estado na UI difere do comportamento Memória do OpenSIPS desatualizada vs tabela Recarregar; conferir ds_list via MI
Seleção pega sempre o mesmo destino Peso/prioridade uniformes ou só um destino Ativo Ajustar pesos/prioridades no mesmo set
Destino com URI inválida (sem sip:) Digitação no campo Destino Editar para sip:<host>:<porta> e recarregar
Dois destinos duplicados no mesmo set Criação manual + sincronização do MS Remover o duplicado manual; manter a fonte no catálogo

Tabela de referência rápida

Tarefa Onde Ação
Ver estado/probing colunas Estado e Probe Ativo/Inativo, Ligado/Desligado
Criar destino [Novo Dispatcher] setid + sip:host:porta
Tirar destino da rotação lápis da linha Estado = Inativo (1)
Media server página Media Servers (não editar aqui) Ativo/Inativo sincroniza o set 900
Aplicar mudanças Sistema → OpenSIPS Dispatcher → Recarregar (ds_reload)
Estado real na memória host opensips-cli -x mi ds_list