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

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)

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]

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)

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 allsem 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 |