Ir para o conteúdo

Roteiro: Recarregar o OpenSIPS após mudanças (reload por módulo)

Perfil necessário: admin Menus usados: Sistema Risco: baixo no reload em si (não derruba chamadas); alto se esquecido — banco e memória do OpenSIPS divergem e o comportamento em produção não reflete o cadastro Rollback: não há "reload reverso": corrija o dado no CRUD correto e recarregue novamente

Pré-requisitos

  • [ ] Mudança já salva no banco (CRUD correspondente)
  • [ ] Serviço do OpenSIPS no ar (systemctl status opensips)
  • [ ] Você sabe qual dado mudou — a tabela abaixo indica o módulo

Quando recarregar: mudança → módulo

Mudou (tela → dado) Módulo a recarregar Comando MI interno
Avançado → Endereços Confiáveis (IPs sem registro, permissões) Endereços confiáveis address_reload
Avançado → Dialplan (regras manuais) ou qualquer regra gerada por sync de perfis/políticas Dialplan dp_reload
Infraestrutura → Dispatcher (destinos/sets de load balancing) Dispatcher ds_reload
Grupos/destinos que alimentam o dispatcher (sync de grupos) Dispatcher ds_reload
Carrier routing / troncos compilados (sync de rotas) Dispatcher (sets) — ver detalhes no roteiro da operadora ds_reload
Várias mudanças ao mesmo tempo, ou dúvida sobre qual módulo Recarregar todos os módulos address_reload + dp_reload + ds_reload

Regra prática: na dúvida, Recarregar todos os módulos — é barato e seguro.

Passo a passo

1. Abrir a página de reload

Caminho: Plataforma → Sistema → Reload OpenSIPS

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

No topo há a seção Sincronizar políticas e rede: o botão [Sincronizar Tudo] recompila perfis de saída/normalização (/line-profiles/sync-all), sincroniza o dispatcher a partir dos grupos e atualiza context_info dos endereços confiáveis — antes de recarregar os módulos por conta própria.

2. Sincronizar políticas e rede (quando mudou perfil/rota/normalização)

Clique: [Sincronizar Tudo]

Resultado esperado: cartão de resultado verde "Compilação e sincronização concluídas" com contadores: rota(s) compiladas, regra(s) de normalização, perfil(is), entradas de dispatcher criadas, endereços atualizados. Se aparecer amarelo "Concluído com avisos — ver detalhes", leia os contadores antes de prosseguir.

3. Recarregar um módulo específico

Caminho: Plataforma → Sistema → Reload OpenSIPS → Recarregar módulos individualmente Clique: [Recarregar] do cartão desejado (Endereços confiáveis, Dialplan ou Dispatcher)

Cartões de reload individual com o Recarregar do Dialplan destacado

Resultado esperado: toast verde "Dialplan recarregado" / "Endereços recarregados" / "Dispatcher recarregado" e cartão de resultado com os detalhes JSON do MI.

4. Recarregar tudo (caminho padrão)

Clique: [Recarregar todos os módulos]

Botão Recarregar todos os módulos

Resultado esperado: mensagem "Todos os módulos recarregados". Se vier "Alguns módulos falhados" (amarelo), abra os detalhes para ver qual módulo falhou e repita o reload individual dele.

5. Validar o efeito real

  • [ ] Comportamento refletido: chamada de teste usa a regra/destino novo (CDR/fluxo SIP evidencia)
  • [ ] Sem erros novos em Plataforma → Sistema → Logs
  • [ ] Testes da área passam quando aplicável (Testar Dialplan, Testar Classificação, teste de normalização)

Logs do OpenSIPS

Validação

  • [ ] Visual: cartão de resultado verde na página de reload
  • [ ] Funcional: cenário SIPp/chamada de teste exercita a mudança; ou MI opensips-cli -x mi get_statistics all sem erros após o reload

Erros comuns

Sintoma Causa provável Correção
Reload falha / erro de comunicação OpenSIPS parado ou MI inacessível systemctl status opensips, journalctl -u opensips -f, repetir o reload
Mudança salva não tem efeito módulo errado recarregado (ou reload esquecido) usar Recarregar todos os módulos
"Alguns módulos falhados" falha parcial em um módulo repetir o reload individual do módulo que falhou
Perfis/rotas compiladas divergem sync não executado antes do reload [Sincronizar Tudo] antes de recarregar
Comportamento diverge do banco dado errado no CRUD de origem corrigir o dado e recarregar de novo

Tabela de referência rápida

Botão O que faz Quando usar
Sincronizar Tudo recompila perfis + normalização, sync dispatcher e endereços (e já recarrega) após mudar perfis de saída, planos de entrega, grupos
Recarregar (Endereços confiáveis) address_reload (permissions) após mudar endereços confiáveis/IPs
Recarregar (Dialplan) dp_reload após mudar regras de dialplan
Recarregar (Dispatcher) ds_reload após mudar destinos/sets de dispatcher
Recarregar todos os módulos os três acima em sequência rotina padrão pós-mudança, dúvida sobre o módulo