Guía de Operaciones

Procedimientos operativos diarios

Dependencia Crítica: OmniMessage Core

IMPORTANTE: La puerta de enlace SMPP de OmniMessage no puede funcionar sin acceso a OmniMessage Core. Todo el procesamiento de mensajes ocurre en OmniMessage - la puerta de enlace es solo un traductor de protocolo.

Si OmniMessage se vuelve inaccesible:

❌ No se pueden enviar nuevos mensajes
❌ No se pueden recuperar mensajes pendientes
❌ No se puede informar el estado de entrega
❌ El sistema parece colgarse o agotar el tiempo

Verificar la Salud de OmniMessage:

# Probar conectividad API
curl -k https://omnimessage-core.example.com:8443/api/system/health

# Verificar URL API configurada en los registros
grep api_base_url /opt/omnimessage-smpp/config/runtime.exs

Operaciones Diarias

Verificación de Salud Matutina

Realizar estas verificaciones al inicio de cada día:

Acceder al Panel Web
- URL: https://your-server:8087
- Verificar si el panel se carga correctamente
Verificar el Estado de Conexión
- Navegar a: SMPP → Estado en Vivo
- Verificar que todas las conexiones muestren "Conectado" (verde)
- Anotar cualquier enlace desconectado
Revisar Métricas de Mensajes
- Navegar a: pestaña de Cola
- Verificar que los conteos de mensajes sean razonables
- Asegurarse de que no haya acumulación inesperada en la cola
Verificar Registros del Sistema
- Navegar a: pestaña de Registros
- Buscar mensajes de error (rojo)
- Anotar cualquier patrón de advertencia
Revisar Métricas de Prometheus
- curl http://localhost:4000/metrics
- O verificar paneles de Grafana
- Asegurarse de que las tasas de mensajes sean normales

Monitoreo Continuo

Configurar alertas para:

Fallos de conexión (> 2 minutos fuera de servicio)
Altas tasas de fallos de entrega (> 5%)
Sin tráfico durante períodos prolongados
Desconexiones frecuentes

Ver MONITORING.md para la configuración de alertas.

Comprendiendo el Enrutamiento de Mensajes

La puerta de enlace enruta mensajes entre OmniMessage Core y conexiones SMPP utilizando dos campos clave:

dest_smsc - Enruta mensajes salientes a enlaces de cliente. Cuando OmniMessage coloca un mensaje en la cola con dest_smsc: "vodafone_uk", el enlace de cliente de la puerta de enlace llamado vodafone_uk lo recoge y lo envía a través de SMPP submit_sm.
source_smsc - Enruta mensajes entrantes a enlaces de servidor. Cuando OmniMessage coloca un mensaje en la cola con source_smsc: "partner_acme", la puerta de enlace lo entrega a los clientes conectados al enlace de servidor llamado partner_acme a través de SMPP deliver_sm.

Distinción clave: Los enlaces de cliente envían PDUs submit_sm (la puerta de enlace es el ESME que se presenta a un operador). Los enlaces de servidor envían PDUs deliver_sm (la puerta de enlace es el SMSC que entrega a un ESME conectado).

Registro del Frontend

La puerta de enlace se registra automáticamente con OmniMessage Core para que el backend sepa qué conexiones SMPP están disponibles para el enrutamiento de mensajes.

Nombre de registro: Controlado por la configuración smsc_name (predeterminado: "smpp_gateway", env: SMSC_NAME)
Latido: Enviado cada 60 segundos para mantener el registro activo
Expiración: El registro expira en el backend después de 90 segundos sin un latido
Registro por enlace: Cada par habilitado se registra individualmente bajo su clave de enrutamiento, por lo que el nombre del frontend registrado es igual al dest_smsc en el que el backend enruta:
- Pares de cliente: registrados bajo su queue configurada (si está configurada), de lo contrario, el nombre del par simple. Varios pares de cliente que comparten una queue por lo tanto se registran bajo ese único nombre compartido.
- Enlaces de servidor: registrados bajo su nombre de enlace.

Si la puerta de enlace se detiene o pierde conectividad con OmniMessage Core, sus registros expiran y el backend deja de enrutar mensajes hacia ella.

Solución de problemas: Si los mensajes no se están enrutando a la puerta de enlace, verifique:

Registros para entradas "frontend_register"
Que el smsc_name coincida con lo que OmniMessage espera
Conectividad de red a OmniMessage Core (api_base_url)

Gestión de Conexiones SMPP

Cómo se Configuran los Pares SMPP

Las conexiones SMPP (pares) se pueden configurar utilizando dos métodos:

Método 1: Interfaz Web (Recomendado)

Ventaja: Los cambios tienen efecto inmediato, no se requiere reinicio
Ubicación: SMPP → Pares de Cliente / Pares de Servidor
Operaciones: Agregar, editar, eliminar pares
Persistencia: Almacenados en la base de datos Mnesia
Mejor para: Operaciones diarias, pruebas, cambios rápidos

Método 2: Archivo de Configuración

Ventaja: Configuración como código, control de versiones
Ubicación: /opt/omnimessage-smpp/config/runtime.exs
Operaciones: Definir pares en la configuración de Elixir
Persistencia: Basada en archivo, sobrevive a reinicios
Requiere: Reinicio del servicio después de los cambios
Mejor para: Configuración inicial, infraestructura como código

Nota: Los cambios en la interfaz web se almacenan por separado y anulan la configuración del archivo.

Ver CONFIGURATION.md para referencia del archivo de configuración.

Agregar una Nueva Conexión de Cliente

Propósito: Configurar la puerta de enlace para actuar como un ESME (cliente) conectándose al SMSC (servidor) de un operador

Preparación: Reunir información del operador:

Nombre de host/IP del servidor SMPP
Número de puerto (generalmente 2775)
ID del sistema (nombre de usuario)
Contraseña
Tipo de enlace (generalmente transceptor)
Límite TPS

Elija uno de los siguientes métodos:

Opción A: A través de la Interfaz Web (Recomendado)

Ventajas: Efecto inmediato, no se requiere reinicio

Pasos:

Navegar a Pares de Cliente:
- Abrir la Interfaz Web: https://your-server:8087
- Navegar a: SMPP → Pares de Cliente
Agregar Nuevo Par:
- Hacer clic en "Agregar Nuevo Par de Cliente"
- Completar el formulario:
  - Nombre: vodafone_uk (identificador único)
  - Host: smpp.vodafone.co.uk
  - Puerto: 2775
  - ID del Sistema: your_username
  - Contraseña: your_password
  - Tipo de Enlace: Transceptor
  - Límite TPS: 100
  - Frecuencia de Verificación de Cola: 1000
- Hacer clic en "Guardar"
La Conexión se Establece Automáticamente:
- La puerta de enlace intenta inmediatamente la conexión
- Navegar a: SMPP → Estado en Vivo
- El estado debería cambiar a "Conectado" (verde) dentro de 10-30 segundos
- Verificar la pestaña de Registros para el mensaje de enlace exitoso
Probar el Flujo de Mensajes:
- Navegar a: pestaña de Cola
- Enviar un mensaje de prueba con dest_smsc coincidiendo con el nombre del enlace
- Monitorear en Estado en Vivo para la transmisión
- Verificar la confirmación de entrega

Opción B: A través del Archivo de Configuración

Ventajas: Infraestructura como código, control de versiones

Pasos:

Editar el Archivo de Configuración:

sudo nano /opt/omnimessage-smpp/config/runtime.exs

Agregar Nuevo Enlace a la Configuración:

config :omnimessage_smpp, :binds, [
  # Enlaces existentes...

  # Agregar nuevo enlace
  %{
    name: "vodafone_uk",
    mode: :client,
    bind_type: :transceiver,
    host: "smpp.vodafone.co.uk",
    port: 2775,
    system_id: "your_username",
    password: "your_password",
    tps_limit: 100,
    queue_check_frequency: 1000,

    # Opcional: fijar la IP/puerto de origen local si el operador los blanquea
    bind_source_ip: "10.20.30.40",
    bind_source_port: 5000,

    # Opcional: compartir una cola de backend entre varios enlaces (por defecto se usa el nombre)
    queue: "vodafone_uk"
  }
]

Ver CONFIGURATION.md para la lista completa de parámetros de enlace de cliente, incluyendo bind_source_ip, bind_source_port, y queue.

Guardar y Reiniciar el Servicio:

# Guardar archivo (Ctrl+X, Y, Enter en nano)

# Reiniciar servicio
sudo systemctl restart omnimessage-smpp

Verificar Conexión:
- Navegar a: SMPP → Estado en Vivo
- Encontrar nueva conexión
- El estado debería ser "Conectado" (verde)
- Verificar registros para enlace exitoso
Probar el Flujo de Mensajes:
- Navegar a: pestaña de Cola
- Enviar un mensaje de prueba con dest_smsc coincidiendo con el nuevo nombre de enlace
- Monitorear en Estado en Vivo para la transmisión
- Verificar la confirmación de entrega

Agregar un Enlace de Servidor

Propósito: Configurar la puerta de enlace para actuar como un SMSC (servidor) aceptando conexiones de ESMEs externas (clientes asociados)

Preparación:

Generar Credenciales:
- Crear un ID de sistema único: partner_name
- Crear una contraseña fuerte
- Documentar y compartir de manera segura con el socio
Obtener Información del Socio:
- Direcciones IP de origen del socio
- Volumen de mensajes esperado (para límite TPS)
- Tipos de enlace requeridos

Elija uno de los siguientes métodos:

Opción A: A través de la Interfaz Web (Recomendado)

Ventajas: Efecto inmediato, no se requiere reinicio

Pasos:

Navegar a Pares de Servidor:
- Abrir la Interfaz Web: https://your-server:8087
- Navegar a: SMPP → Pares de Servidor
Agregar Nuevo Par de Servidor:
- Hacer clic en "Agregar Nuevo Par de Servidor"
- Completar el formulario:
  - Nombre: partner_acme (identificador único)
  - ID del Sistema: acme_corp
  - Contraseña: secure_password_123
  - Tipos de Enlace Permitidos: Seleccionar todos (Transmisor, Receptor, Transceptor)
  - Lista Blanca de IP: 203.0.113.0/24 (separados por comas para múltiples)
  - Límite TPS: 50
  - Frecuencia de Verificación de Cola: 1000
- Hacer clic en "Guardar"
Puerta de Enlace Lista para la Conexión:
- El par de servidor ahora está activo y esperando la conexión del socio
- No se requiere reinicio
Compartir Información con el Socio:
- Dirección IP de la puerta de enlace
- Puerto: 2775
- ID del Sistema: acme_corp
- Contraseña: secure_password_123
- Tipo de Enlace: Como se configuró
Esperar la Conexión del Socio:
- Navegar a: SMPP → Estado en Vivo
- Observar la conexión entrante
- Verificar el éxito de la autenticación
- Comprobar que la IP coincida con la lista blanca

Opción B: A través del Archivo de Configuración

Ventajas: Infraestructura como código, control de versiones

Pasos:

Editar el Archivo de Configuración:

sudo nano /opt/omnimessage-smpp/config/runtime.exs

Agregar Enlace de Servidor y Configuración de Escucha:

# Agregar a la lista de server_binds
config :omnimessage_smpp, :server_binds, [
  # Enlaces de servidor existentes...

  # Agregar nuevo enlace de servidor
  %{
    name: "partner_acme",
    system_id: "acme_corp",
    password: "secure_password_123",
    allowed_bind_types: [:transmitter, :receiver, :transceiver],
    ip_whitelist: ["203.0.113.0/24"],
    tps_limit: 50,
    queue_check_frequency: 1000
  }
]

# Asegurarse de que la configuración de escucha exista (solo se necesita una vez)
config :omnimessage_smpp, :listen, %{
  host: "0.0.0.0",
  port: 2775,
  max_connections: 100
}

Guardar y Reiniciar el Servicio:
```
sudo systemctl restart omnimessage-smpp
```
Compartir Información con el Socio:
- Dirección IP de la puerta de enlace
- Puerto: 2775
- ID del Sistema: acme_corp
- Contraseña: secure_password_123
- Tipo de Enlace: Como se configuró
Esperar la Conexión del Socio:
- Navegar a: SMPP → Estado en Vivo
- Observar la conexión entrante
- Verificar el éxito de la autenticación
- Comprobar que la IP coincida con la lista blanca

Modificar Conexión Existente

Propósito: Actualizar parámetros de conexión (límites TPS, contraseñas, lista blanca de IP, etc.)

Elija uno de los siguientes métodos:

Opción A: A través de la Interfaz Web (Recomendado)

Ventajas: Efecto inmediato, no se requiere reinicio

Pasos:

Navegar a Pares:
- Abrir la Interfaz Web: https://your-server:8087
- Para conexiones de cliente: SMPP → Pares de Cliente
- Para conexiones de servidor: SMPP → Pares de Servidor
Editar Par:
- Encontrar el par a modificar
- Hacer clic en el botón "Editar"
- Actualizar los parámetros deseados:
  - Cambios comunes: límite TPS, contraseña, lista blanca de IP, host/puerto
- Hacer clic en "Guardar"
Los Cambios se Aplican Inmediatamente:
- La conexión se reconecta automáticamente con la nueva configuración
- No se requiere reinicio del servicio
- Navegar a: SMPP → Estado en Vivo para verificar
Verificar Cambios:
- Comprobar que la conexión se establezca con éxito
- Monitorear la pestaña de Registros en busca de errores
- Probar el flujo de mensajes si es aplicable

Opción B: A través del Archivo de Configuración

Ventajas: Infraestructura como código, control de versiones

Pasos:

Editar el Archivo de Configuración:

sudo nano /opt/omnimessage-smpp/config/runtime.exs

Modificar Parámetros de Enlace:
- Encontrar el enlace en la lista de :binds o :server_binds
- Actualizar los parámetros deseados:
  - Cambios comunes: límite TPS, contraseñas, lista blanca de IP, host/puerto
- Ejemplo:
```
%{
  name: "vodafone_uk",
  # ... otros parámetros
  tps_limit: 150,  # Cambiado de 100
  password: "new_password"  # Contraseña actualizada
}
```
Guardar y Reiniciar el Servicio:
```
sudo systemctl restart omnimessage-smpp
```
Verificar Cambios:
- Navegar a: SMPP → Estado en Vivo
- Comprobar que la conexión se establezca con éxito
- Monitorear registros en busca de errores
- Probar el flujo de mensajes

Eliminar una Conexión

Propósito: Descontinuar una conexión SMPP

Pasos:

Notificar a las Partes Interesadas:
- Informar al operador/socio
- Coordinar ventana de inactividad
Desconectar a través de la Interfaz Web:
- Navegar a: SMPP → Estado en Vivo
- Encontrar la conexión
- Hacer clic en "Eliminar Conexión"
- Confirmar acción
Eliminar Configuración:
- Navegar a: SMPP → Pares de Cliente/Servidor
- Encontrar la conexión
- Hacer clic en "Eliminar"
- Confirmar eliminación
Verificar Eliminación:
- Comprobar Estado en Vivo - la conexión debería haber desaparecido
- Revisar registros para un apagado limpio

Habilitar y Deshabilitar Conexiones

Propósito: Tomar temporalmente una conexión fuera de línea sin eliminar su configuración

Los pares tienen un campo enabled que controla si están activos. Los pares deshabilitados conservan toda su configuración pero no establecen ni aceptan conexiones.

A través de la Interfaz Web:

Navegar a: SMPP → Pares de Cliente o Pares de Servidor
Encontrar el par a deshabilitar
Hacer clic en "Editar"
Desmarcar la casilla "Habilitado"
Hacer clic en "Guardar"

La conexión se eliminará inmediatamente. Para volver a habilitar, repetir los pasos y marcar la casilla nuevamente.

Casos de uso:

Ventanas de mantenimiento planificadas del operador
Pausar temporalmente una conexión de socio durante una investigación
Deshabilitar una conexión mientras se espera nuevas credenciales

Comportamiento de Conexión

Lógica de Reconexión

Cuando un enlace de cliente se desconecta inesperadamente, la puerta de enlace intenta reconectarse automáticamente:

Intervalo de reintento: Cada 30 segundos
Inicio escalonado: Cuando varios enlaces se inician simultáneamente (por ejemplo, después de un reinicio del servicio), las conexiones se escalonan con retrasos de 500 ms entre cada enlace para evitar abrumar la red
Inicio resiliente: Si un operador no es accesible al inicio de la puerta de enlace, la puerta de enlace se inicia con éxito y reintenta la conexión en segundo plano

Enquire Link (Keepalive)

La puerta de enlace envía periódicamente PDUs SMPP enquire_link para verificar que las conexiones estén vivas:

Intervalo predeterminado: 60 segundos (configurable por enlace a través de enquire_link_interval)
Deshabilitar: Establecer enquire_link_interval: 0 (no recomendado)
Detección de fallos: Si el par remoto deja de responder a enquire_link, la conexión se considera muerta y comienza la reconexión

Monitorear la salud de enquire_link a través de las métricas de Prometheus smpp_enquire_link_sent_total y smpp_enquire_link_received_total. Una brecha creciente entre enviados y recibidos indica problemas de conexión.

Limitación de Tasa TPS

Cada enlace aplica su tps_limit utilizando una ventana deslizante por segundo:

Los mensajes se cuentan dentro de cada ventana de 1 segundo
Cuando se alcanza el límite, el trabajador de la cola se pausa hasta el siguiente segundo
Un máximo de 100 mensajes puede estar en vuelo (esperando respuesta) por enlace en cualquier momento
La ventana se restablece automáticamente al inicio de cada nuevo segundo

Si observa un rendimiento lento, verifique que:

tps_limit esté configurado lo suficientemente alto para su tráfico
queue_check_frequency sea lo suficientemente bajo para mantener el flujo de la tubería
El operador esté respondiendo a los mensajes de manera oportuna (respuestas lentas reducen el rendimiento efectivo)

Gestión del Flujo de Mensajes

Verificación de la Cola de Mensajes

Propósito: Monitorear mensajes pendientes

Pasos:

Acceder a la Cola:
- Navegar a: pestaña de Cola
- Ver lista de mensajes pendientes
Verificar Detalles del Mensaje:
- Hacer clic en la fila del mensaje
- Revisar:
  - Número de destino
  - Cuerpo del mensaje
  - SMSC objetivo (dest_smsc)
  - Intentos de entrega
  - Estado
Buscar Mensaje Específico:
- Usar filtro de búsqueda
- Filtrar por destino, contenido o SMSC

Solución de Problemas de Mensajes Atascados

Síntomas: Mensajes que no se entregan

Pasos:

Verificar Estado de Conexión:
- Navegar a: SMPP → Estado en Vivo
- Verificar que la conexión objetivo esté conectada
- Si está desconectada, ver Reconectando
Verificar Detalles del Mensaje:
- Navegar a: pestaña de Cola
- Encontrar mensaje atascado
- Comprobar que el campo dest_smsc coincida con el nombre de la conexión
- Verificar la marca de tiempo deliver_after (programación de reintentos)
Verificar Intentos de Entrega:
- Altos intentos = fallos repetidos
- Verificar registros para mensajes de error
- Puede indicar formato inválido o rechazo del operador
Intervención Manual (si es necesario):
- Contactar al operador para verificar el problema
- Puede ser necesario cancelar y reenviar el mensaje
- Consultar con el equipo de backend sobre problemas en la cola

Passthrough de Recibos de Entrega (DLR)

Un recibo de entrega (DLR) es un mensaje SMPP que informa el estado final de un mensaje enviado. La puerta de enlace envía un DLR de vuelta a un enlace que envía cuando el enlace establece deliver_receipts: true. Utilice esta función para un enlace de interconexión cuyo operador necesita confirmación de entrega para cada mensaje.

La puerta de enlace envía el recibo como un PDU deliver_sm con el esm_class establecido en 0x04 (Recibo de Entrega del SMSC). El recibo lleva el mismo ID de mensaje que la puerta de enlace devolvió en el submit_sm_resp, por lo que el operador puede correlacionar el recibo con el envío original.

Requisitos

Establecer deliver_receipts: true en el enlace de servidor. Ver CONFIGURATION.md.
Establecer cache_enabled: false en el mismo enlace. El almacenamiento en caché devuelve un ID de mensaje temporal que no coincide con el ID central, por lo que un enlace en caché rompe la correlación del recibo. La puerta de enlace escribe una advertencia al inicio si un enlace establece ambos.

Flujo de Mensajes

Valores de estado del recibo

El campo stat del recibo informa el estado final del mensaje.

Estado del Core	Recibo `stat`	Significado
`delivered`	`DELIVRD`	El destinatario recibió el mensaje.
`expired`	`EXPIRED`	El período de validez del mensaje terminó antes de la entrega.
`dropped`	`UNDELIV`	La puerta de enlace no pudo entregar el mensaje.
`rejected`	`REJECTD`	El núcleo rechazó el mensaje.
`balance_rejected`	`REJECTD`	El núcleo rechazó el mensaje por razones de saldo de cuenta.

Notas operativas

La puerta de enlace rastrea los mensajes en vuelo en memoria. Si el servicio se reinicia, los recibos de los mensajes que están en vuelo en ese momento se pierden. Este es un mecanismo de mejor esfuerzo.
Si la sesión del enlace está caída cuando un mensaje alcanza un estado terminal, la puerta de enlace mantiene el recibo y lo envía cuando la sesión se reconecta. La puerta de enlace elimina el recibo después de 24 horas.
Monitorear las métricas DLR para confirmar que la función funciona. Ver MONITORING.md.

Solución de Problemas de Conexión

Reconectando un Bind

Síntomas: La conexión muestra "Desconectado" (rojo)

Pasos:

Verificar Conectividad de Red:

ping -c 3 carrier-smpp-server.com
telnet carrier-smpp-server.com 2775

Verificar Registros en Busca de Errores:
- Navegar a: Pestaña de Registros
- Filtrar: Nivel de error
- Buscar fallos de autenticación, tiempos de espera de red
Verificar Credenciales:
- Navegar a: SMPP → Pares Cliente/Servidor
- Comprobar que system_id y contraseña son correctos
- Contactar al operador si no está seguro
Reconexión Manual:
- Navegar a: SMPP → Estado en Vivo
- Encontrar el bind desconectado
- Hacer clic en el botón "Reconectar"
- Esperar de 10 a 30 segundos
- Verificar si el estado cambia a "Conectado"
Si la Reconexión Falla:
- Verificar reglas del firewall
- Verificar que el servidor del operador esté operativo
- Contactar al soporte del operador
- Ver TROUBLESHOOTING.md

Manejo de Fallos de Autenticación

Síntomas: Fallos de bind repetidos en los registros

Causas:

Nombre de usuario/contraseña incorrectos
IP no incluida en la lista blanca del operador
Cuenta suspendida/expirada

Pasos:

Verificar Credenciales:
- Navegar a: SMPP → Pares Cliente
- Verificar nuevamente system_id y contraseña
- Confirmar con el operador
Verificar Inclusión de IP en la Lista Blanca:
- Confirmar tu IP de gateway con el operador
- Solicitar al operador que verifique la lista blanca de IP
Verificar Estado de la Cuenta:
- Verificar que la cuenta esté activa
- Comprobar si hay contratos expirados
- Contactar al departamento de facturación del operador
Actualizar Configuración:
- Si las credenciales cambiaron, actualizar en la interfaz web
- Hacer clic en "Reconectar" para reintentar con las nuevas credenciales

Monitoreo y Alertas

Verificando Métricas de Prometheus

Verificación rápida:

curl http://localhost:4000/metrics | grep smpp_connection_status

Salida esperada:

smpp_connection_status{bind_name="vodafone_uk",...} 1
smpp_connection_status{bind_name="att_us",...} 1

Todos los valores deberían ser 1 (conectado).

Respondiendo a Alertas

Alerta de Conexión Caída:

Verificar Interfaz Web → SMPP → Estado en Vivo
Intentar reconexión manual
Verificar registros en busca de errores
Contactar al operador si la interrupción es prolongada
Ver TROUBLESHOOTING.md

Alerta de Alta Tasa de Fallos:

Verificar registros en busca de patrones de error
Revisar cambios recientes en la configuración
Contactar al operador sobre rechazos
Verificar cumplimiento del formato de mensaje

Alerta de Sin Tráfico:

Verificar que la cola de backend tenga mensajes
Verificar que el enrutamiento dest_smsc sea correcto
Comprobar que los límites de TPS no sean demasiado restrictivos
Revisar la configuración de queue_check_frequency

Procedimientos de Mantenimiento

Mantenimiento de Rutina

Realizar mensualmente:

Revisar Métricas:
- Analizar tendencias de volumen de mensajes
- Verificar tasas de éxito de entrega
- Identificar oportunidades de optimización
Actualizar Documentación:
- Documentar cualquier cambio en la configuración
- Actualizar información de contacto
- Anotar ventanas de mantenimiento del operador
Auditoría de Credenciales:
- Revisar todas las contraseñas de SMPP
- Planificar rotación de credenciales
- Verificar que las listas blancas de IP estén actualizadas
Planificación de Capacidad:
- Revisar tasas de mensajes pico
- Comparar con límites de TPS
- Planificar para el crecimiento

Reinicio del Servicio

Cuando sea necesario:

Después de cambios en el archivo de configuración
Después de actualizaciones del sistema
Durante la solución de problemas

Pasos:

# Verificar estado actual
sudo systemctl status omnimessage-smpp

# Reiniciar servicio
sudo systemctl restart omnimessage-smpp

# Verificar reinicio
sudo systemctl status omnimessage-smpp

# Verificar registros
sudo journalctl -u omnimessage-smpp -n 50

Verificar a través de la Interfaz Web:

Acceder al panel (puede tardar de 30 a 60 segundos en estar en línea)
Navegar a: SMPP → Estado en Vivo
Esperar a que todas las conexiones se establezcan (1-2 minutos)
Verificar registros en busca de errores

Copia de Seguridad de Configuración

Hacer copia de seguridad de archivos críticos antes de los cambios:

# Copia de seguridad de configuración
sudo cp /opt/omnimessage-smpp/config/runtime.exs \
  /opt/omnimessage-smpp/config/runtime.exs.backup.$(date +%Y%m%d)

# Copia de seguridad de certificados
sudo tar -czf /tmp/smpp-certs-$(date +%Y%m%d).tar.gz \
  /opt/omnimessage-smpp/priv/cert/

Restaurar si es necesario:

# Restaurar configuración
sudo cp /opt/omnimessage-smpp/config/runtime.exs.backup.YYYYMMDD \
  /opt/omnimessage-smpp/config/runtime.exs

# Reiniciar servicio
sudo systemctl restart omnimessage-smpp

Procedimientos de Emergencia

Interrupción Completa del Servicio

Pasos:

Verificar estado del servicio:
```
sudo systemctl status omnimessage-smpp
```
Si el servicio está detenido, iniciarlo:
```
sudo systemctl start omnimessage-smpp
```
Verificar registros en busca de la razón del fallo:
```
sudo journalctl -u omnimessage-smpp -n 100
```
Si no inicia:
- Verificar errores de sintaxis en la configuración
- Verificar que existan certificados SSL
- Verificar espacio en disco: df -h
- Verificar memoria: free -h
Contactar soporte si no se resuelve

Solicitudes de Desconexión de Emergencia del Operador

Pasos:

Cerrar la conexión de inmediato:
- Navegar a: SMPP → Estado en Vivo
- Encontrar la conexión afectada
- Hacer clic en "Cerrar Conexión"
Documentar la razón:
- Anotar el nombre del operador
- Registrar la hora y la razón
- Guardar correspondencia
Investigar el problema:
- Verificar patrones recientes de mensajes
- Revisar registros en busca de errores
- Identificar la causa raíz
Coordinar la resolución:
- Trabajar con el operador
- Implementar soluciones
- Probar antes de reconectar

Pico de Alto Volumen

Síntomas: Tráfico de mensajes inesperadamente alto

Pasos:

Verificar límites de TPS:
- Navegar a: SMPP → Estado en Vivo
- Verificar que las conexiones no estén limitadas
- Puede ser necesario aumentar temporalmente los límites de TPS
Monitorear la estabilidad del operador:
- Estar atento a desconexiones
- Verificar tasas de éxito de entrega
Coordinar con el backend:
- Verificar que la fuente de mensajes sea legítima
- Puede ser necesario implementar limitación de tasa aguas arriba
Escalar si es necesario:
- Puede ser necesario agregar instancias adicionales de gateway
- Contactar soporte para obtener asesoramiento sobre escalamiento

Mejores Prácticas

Lista de Verificación Diaria

Verificar que todas las conexiones SMPP estén conectadas
Revisar registros de errores en busca de problemas
Monitorear la cola de mensajes para acumulaciones
Verificar paneles de Prometheus/Grafana
Verificar tasas de éxito de entrega > 98%

Tareas Semanales

Revisar tendencias de métricas
Verificar anomalías en patrones
Probar procedimientos de recuperación ante desastres
Actualizar documentación según sea necesario
Revisar y reconocer alertas

Tareas Mensuales

Auditoría de credenciales
Revisión de planificación de capacidad
Actualizar contactos del operador
Revisar y optimizar configuraciones de TPS
Hacer copia de seguridad de archivos de configuración

Documentación Relacionada

CONFIGURATION.md - Configurar conexiones y ajustes
SOURCE_ADDRESS_WHITELIST.md - Restringir direcciones de origen por par de servidor
MONITORING.md - Configurar alertas de Prometheus
TROUBLESHOOTING.md - Resolver problemas comunes
README.md - Visión general del sistema

Dependencia Crítica: OmniMessage Core​

Operaciones Diarias​

Verificación de Salud Matutina​

Monitoreo Continuo​

Comprendiendo el Enrutamiento de Mensajes​

Registro del Frontend​

Gestión de Conexiones SMPP​

Cómo se Configuran los Pares SMPP​

Método 1: Interfaz Web (Recomendado)​

Método 2: Archivo de Configuración​

Agregar una Nueva Conexión de Cliente​

Opción A: A través de la Interfaz Web (Recomendado)​

Opción B: A través del Archivo de Configuración​

Agregar un Enlace de Servidor​

Opción A: A través de la Interfaz Web (Recomendado)​

Opción B: A través del Archivo de Configuración​

Modificar Conexión Existente​

Opción A: A través de la Interfaz Web (Recomendado)​

Opción B: A través del Archivo de Configuración​

Eliminar una Conexión​

Habilitar y Deshabilitar Conexiones​

Comportamiento de Conexión​

Lógica de Reconexión​

Enquire Link (Keepalive)​

Limitación de Tasa TPS​

Gestión del Flujo de Mensajes​

Verificación de la Cola de Mensajes​

Solución de Problemas de Mensajes Atascados​

Passthrough de Recibos de Entrega (DLR)​

Requisitos​

Flujo de Mensajes​

Valores de estado del recibo​

Notas operativas​

Solución de Problemas de Conexión​

Reconectando un Bind​

Manejo de Fallos de Autenticación​

Monitoreo y Alertas​

Verificando Métricas de Prometheus​

Respondiendo a Alertas​

Procedimientos de Mantenimiento​

Mantenimiento de Rutina​

Reinicio del Servicio​

Copia de Seguridad de Configuración​

Procedimientos de Emergencia​

Interrupción Completa del Servicio​

Solicitudes de Desconexión de Emergencia del Operador​

Pico de Alto Volumen​

Mejores Prácticas​

Lista de Verificación Diaria​

Tareas Semanales​

Tareas Mensuales​

Documentación Relacionada​

Dependencia Crítica: OmniMessage Core

Operaciones Diarias

Verificación de Salud Matutina

Monitoreo Continuo

Comprendiendo el Enrutamiento de Mensajes

Registro del Frontend

Gestión de Conexiones SMPP

Cómo se Configuran los Pares SMPP

Método 1: Interfaz Web (Recomendado)

Método 2: Archivo de Configuración

Agregar una Nueva Conexión de Cliente

Opción A: A través de la Interfaz Web (Recomendado)

Opción B: A través del Archivo de Configuración

Agregar un Enlace de Servidor

Opción A: A través de la Interfaz Web (Recomendado)

Opción B: A través del Archivo de Configuración

Modificar Conexión Existente

Opción A: A través de la Interfaz Web (Recomendado)

Opción B: A través del Archivo de Configuración

Eliminar una Conexión

Habilitar y Deshabilitar Conexiones

Comportamiento de Conexión

Lógica de Reconexión

Enquire Link (Keepalive)

Limitación de Tasa TPS

Gestión del Flujo de Mensajes

Verificación de la Cola de Mensajes

Solución de Problemas de Mensajes Atascados

Passthrough de Recibos de Entrega (DLR)

Requisitos

Flujo de Mensajes

Valores de estado del recibo

Notas operativas

Solución de Problemas de Conexión

Reconectando un Bind

Manejo de Fallos de Autenticación

Monitoreo y Alertas

Verificando Métricas de Prometheus

Respondiendo a Alertas

Procedimientos de Mantenimiento

Mantenimiento de Rutina

Reinicio del Servicio

Copia de Seguridad de Configuración

Procedimientos de Emergencia

Interrupción Completa del Servicio

Solicitudes de Desconexión de Emergencia del Operador

Pico de Alto Volumen

Mejores Prácticas

Lista de Verificación Diaria

Tareas Semanales

Tareas Mensuales

Documentación Relacionada