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)

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_interval15s,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 commedia_server=1emAttrse descriçãoMS:<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

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)

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_listmostra 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_listreflete 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 |