Saltar al contenido principal

Introducción a RAN Monitor

Guía Rápida para Desplegar y Configurar RAN Monitor

Instrucciones paso a paso para configurar RAN Monitor en su entorno

Tabla de Contenidos​

  1. Descripción General
  2. Requisitos Previos
  3. Proceso de Configuración Inicial
  4. Verificación
  5. Próximos Pasos

Descripción General​

Esta guía le llevará a través del despliegue inicial de RAN Monitor, desde la preparación de la infraestructura hasta la primera conexión de la estación base.

Lo que Logrará​

Al final de esta guía, usted habrá:

  • ✓ Preparado la infraestructura requerida (MySQL, InfluxDB)
  • ✓ Configurado RAN Monitor con los detalles de su entorno
  • ✓ Iniciado la aplicación RAN Monitor
  • ✓ Conectado su primera estación base Nokia AirScale
  • ✓ Verificado que las métricas fluyan a InfluxDB
  • ✓ Accedido al panel de control de la interfaz web

Tiempo Estimado: 30-60 minutos para la configuración inicial

Requisitos Previos​

Antes de desplegar RAN Monitor, asegúrese de tener lo siguiente:

Requisitos de Infraestructura​

Servidor de Base de Datos MySQL

  • Versión: MySQL 5.7+ o MariaDB 10.3+
  • Acceso: Conectividad de red desde el servidor de RAN Monitor
  • Permisos: Privilegios de CREATE, SELECT, INSERT, UPDATE, DELETE
  • Base de Datos: Base de datos vacía creada para RAN Monitor
  • Recomendación: Instancia o esquema de base de datos dedicado

Base de Datos de Series Temporales InfluxDB

  • Versión: InfluxDB 1.8+ o 2.0+
  • Acceso: Conectividad de red desde el servidor de RAN Monitor
  • Bucket/Base de Datos: Creado y listo para el almacenamiento de métricas
  • Token de API: Con permisos de escritura al bucket (InfluxDB 2.x)
  • Almacenamiento: Espacio en disco suficiente para su política de retención

Servidor de RAN Monitor

  • SO: Linux (Ubuntu 20.04+, CentOS 8+, o similar)
  • RAM: 4GB mínimo, 8GB recomendado
  • CPU: 2 núcleos mínimo, 4+ núcleos recomendados
  • Disco: 20GB mínimo para la aplicación y registros
  • Red: Conectividad a estaciones base, MySQL e InfluxDB

Requisitos de Red​

Conectividad de Red

  • RAN Monitor → Estaciones base Nokia AirScale (puerto 8080)
  • Estaciones base Nokia → RAN Monitor (puerto 9076 para webhooks)
  • RAN Monitor → MySQL (puerto 3306)
  • RAN Monitor → InfluxDB (puerto 8086)
  • Operadores → Interfaz Web de RAN Monitor (puerto 9443)

Reglas de Firewall

  • Permitir entrada en el puerto 8080 (comunicación de la estación base)
  • Permitir entrada en el puerto 9076 (receptor de webhook)
  • Permitir entrada en el puerto 9443 (Interfaz Web HTTPS)
  • Permitir salida a MySQL e InfluxDB

Requisitos de Estación Base Nokia​

Para Cada Estación Base:

  • Dirección IP - Dirección de red donde la estación base es accesible
  • Puerto - Puerto de la interfaz de gestión (típicamente 8080)
  • Credenciales - Nombre de usuario y contraseña para la autenticación WebLM
  • Ruta de Red - Conectividad verificada (el ping debe tener éxito)
  • Interfaz de Gestión - Habilitada y accesible

Claves de Autenticación del Gestor

  • Clave Privada - Para la autenticación del gestor (formato PEM)
  • Certificado Público - Certificado de identidad del gestor (formato DER)
  • Proporcionado por Nokia o generado con OpenSSL

Grafana (Opcional pero Recomendado)​

  • Versión: Grafana 8.0+
  • Acceso: Conectividad de red a InfluxDB
  • Propósito: Paneles de análisis y alertas

Proceso de Configuración Inicial​

Paso 1: Preparar la Infraestructura​

1.1 Configurar la Base de Datos MySQL

Cree la base de datos para RAN Monitor:

CREATE DATABASE ran_monitor CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Cree un usuario dedicado con los privilegios apropiados:

CREATE USER 'ran_monitor_user'@'%' IDENTIFIED BY 'secure_password';
GRANT CREATE, SELECT, INSERT, UPDATE, DELETE ON ran_monitor.* TO 'ran_monitor_user'@'%';
FLUSH PRIVILEGES;

Verifique la conectividad desde el servidor de RAN Monitor:

mysql -h <mysql-host> -u ran_monitor_user -p ran_monitor

1.2 Desplegar InfluxDB

Para InfluxDB 1.x, cree la base de datos:

influx -execute 'CREATE DATABASE "nokia-monitor"'

Para InfluxDB 2.x, cree un bucket:

influx bucket create -n nokia-monitor -o your-org

Cree un token de API con permisos de escritura (InfluxDB 2.x):

influx auth create --org your-org --write-buckets

Guarde el token para usarlo en la configuración.

1.3 Verificar Rutas de Red

Asegúrese de la conectividad de red a todas las estaciones base:

# Probar conectividad a cada estación base
ping 10.7.15.66

# Verificar que el puerto de gestión sea accesible
telnet 10.7.15.66 8080

Verifique que MySQL e InfluxDB sean accesibles:

# Probar conectividad a MySQL
telnet <mysql-host> 3306

# Probar conectividad a InfluxDB
curl http://<influxdb-host>:8086/ping

Paso 2: Configurar RAN Monitor​

Toda la configuración se gestiona en el archivo config/runtime.exs.

2.1 Configuración de la Base de Datos

Edite config/runtime.exs y configure la conexión a MySQL:

config :ran_monitor, RanMonitor.Repo,
  username: "ran_monitor_user",
  password: "secure_password",
  hostname: "mysql-host",
  database: "ran_monitor",
  stacktrace: true,
  show_sensitive_data_on_connection_error: true,
  pool_size: 10

2.2 Configuración de InfluxDB

Configure la conexión a InfluxDB:

config :ran_monitor, RanMonitor.InfluxDbConnection,
  auth: [
    username: "monitor",
    password: "influx_password"  # O token de API para InfluxDB 2.x
  ],
  database: "nokia-monitor",
  host: "influxdb-host"

2.3 Configuración de Endpoints Web

Configure los endpoints web:

# Endpoint SOAP/API principal para estaciones base
config :ran_monitor, RanMonitor.Web.Endpoint,
  http: [ip: {0, 0, 0, 0}, port: 8080],
  check_origin: false,
  secret_key_base: "generate_with_mix_phx_gen_secret",
  server: true

# Interfaz Web del Panel de Control (HTTPS)
config :control_panel, ControlPanelWeb.Endpoint,
  url: [host: "0.0.0.0", port: 9443, scheme: "https"],
  https: [
    ip: {0, 0, 0, 0},
    port: 9443,
    keyfile: "priv/cert/omnitouch.pem",
    certfile: "priv/cert/omnitouch.crt"
  ]

# Endpoint de webhook para notificaciones de estaciones base
config :ran_monitor, RanMonitor.Web.Nokia.Airscale.Endpoint,
  url: [host: "0.0.0.0"],
  http: [ip: {0, 0, 0, 0}, port: 9076],
  server: true

2.4 Configuración de Nokia

Configure sus identificadores de red y estaciones base:

config :ran_monitor,
  general: %{
    mcc: "001",  # Su Código de País Móvil
    mnc: "001"   # Su Código de Red Móvil
  },
  nokia: %{
    ne3s: %{
      webhook_url: "http://<ran-monitor-ip>:9076/webhook",
      private_key: Path.join(Application.app_dir(:ran_monitor, "priv"), "external/nokia/ne.key.pem"),
      public_key: Path.join(Application.app_dir(:ran_monitor, "priv"), "external/nokia/ne.cert.der"),
      reregister_interval: 30
    },
    airscales: [
      %{
        address: "10.7.15.66",
        name: "Site-A-BS1",
        port: "8080",
        web_username: "admin",
        web_password: "password"
      }
    ]
  }

2.5 Generar Certificados SSL (si es necesario)

Para la Interfaz Web HTTPS, genere certificados SSL:

# Certificado autofirmado para laboratorio/pruebas
openssl req -newkey rsa:2048 -nodes -keyout priv/cert/omnitouch.pem \
  -x509 -days 365 -out priv/cert/omnitouch.crt

Para producción, use certificados firmados por CA.

Para opciones de configuración detalladas, consulte la Guía de Configuración en Tiempo de Ejecución.

Paso 3: Iniciar el Sistema​

Una vez configurado, inicie RAN Monitor.

3.1 Ejecutar Migraciones de Base de Datos

Inicialice el esquema de la base de datos:

mix ecto.migrate

Esto crea todas las tablas necesarias para la gestión del estado de la sesión.

3.2 Iniciar RAN Monitor

Inicie la aplicación:

mix phx.server

O para despliegue en producción:

MIX_ENV=prod mix release
_build/prod/rel/ran_monitor/bin/ran_monitor start

3.3 Monitorear los Registros de Inicio

Observe los registros para un inicio exitoso:

[info] Running RanMonitor.Web.Endpoint with cowboy
[info] Running ControlPanelWeb.Endpoint with cowboy
[info] Running RanMonitor.Web.Nokia.Airscale.Endpoint with cowboy
[info] Starting RAN Monitor Manager
[info] Connecting to InfluxDB...
[info] InfluxDB connection established
[info] Attempting registration with device: Site-A-BS1
[info] Successfully registered with Site-A-BS1

Busque:

  • Endpoints web iniciados
  • Conexiones de base de datos establecidas
  • Conectividad de InfluxDB confirmada
  • Intentos de registro de la estación base

Verificación​

Paso 4: Verificar Operación​

Verifique que el sistema esté funcionando correctamente.

4.1 Acceder al Panel de Control de la Interfaz Web

Abra su navegador y navegue a:

https://<ran-monitor-ip>:9443

Debería ver el panel de control de RAN Monitor.

4.2 Verificar el Estado de la Estación Base

En la Interfaz Web:

  1. Navegue a la página Estaciones Base
  2. Verifique que su estación base aparezca en la lista
  3. El estado debería mostrarse como "Asociado" (verde)
  4. El estado de registro debería ser "Registrado"
  5. La información de la sesión debería mostrar una sesión activa con tiempo de expiración

Si el estado es rojo/fallido, verifique:

  • Conectividad de red a la estación base
  • Credenciales son correctas
  • La interfaz de gestión de la estación base es accesible
  • Registros de la aplicación para mensajes de error

4.3 Confirmar que las Métricas Fluyan a InfluxDB

En la Interfaz Web:

  1. Navegue a la página Estado de InfluxDB
  2. El estado de conexión debería ser verde
  3. Los conteos de mediciones deberían estar aumentando
  4. Verifique los conteos de "Métricas de Rendimiento", "Configuración" y "Alarmas"

Alternativamente, consulte InfluxDB directamente:

# InfluxDB 1.x
influx -database 'nokia-monitor' -execute 'SELECT COUNT(*) FROM PerformanceMetrics'

# InfluxDB 2.x
influx query 'from(bucket:"nokia-monitor")
  |> range(start: -1h)
  |> filter(fn: (r) => r._measurement == "PerformanceMetrics")
  |> count()'

4.4 Revisar Registros de Inicio

Verifique los registros de la aplicación en busca de errores:

En la Interfaz Web:

  1. Navegue a la página Registros de Aplicación
  2. Filtre por nivel "Error"
  3. Verifique que no haya errores críticos

O revise la salida de la consola si se está ejecutando a través de mix phx.server.

4.5 Verificar Detalles del Dispositivo

En la Interfaz Web:

  1. Haga clic en su estación base desde la página de Estaciones Base
  2. Verifique:
    • Los detalles de registro están poblados
    • La sesión tiene un tiempo de expiración válido
    • Las métricas recientes muestran datos
    • El estado de configuración muestra parámetros

Próximos Pasos​

Ahora que RAN Monitor está en funcionamiento, aquí están los próximos pasos recomendados:

Acciones Inmediatas​

  1. Agregar Más Estaciones Base

    • Agregue dispositivos adicionales a config/runtime.exs
    • Reinicie la aplicación para recoger los cambios
    • Consulte la Guía de Operaciones Comunes

  2. Configurar Paneles de Grafana

  3. Configurar Retención de Datos

  4. Configurar Alarmas y Alertas

    • Revise las alarmas activas en la Interfaz Web
    • Configure reglas de alerta en Grafana
    • Configure canales de notificación
    • Consulte la Guía de Gestión de Alarmas

Preparación Operativa​

Revisión de Documentación:

Entrenamiento del Equipo:

  • Realice un recorrido por la Interfaz Web con el equipo de operaciones
  • Practique flujos de trabajo comunes (verificación de salud diaria, investigación de alarmas)
  • Revise los procedimientos de escalado para alarmas críticas

Configuración de Monitoreo:

  • Cree paneles operativos en Grafana
  • Establezca reglas de alerta para métricas críticas
  • Configure canales de notificación (Slack, correo electrónico, PagerDuty)

Fortalecimiento de Seguridad:

  • Reemplace certificados autofirmados por certificados firmados por CA
  • Mueva credenciales a variables de entorno
  • Restringa los permisos de archivo en config/runtime.exs
  • Configure reglas de firewall

Despliegue en Producción​

Antes de la Producción:

  • Pruebe primero en el entorno de staging
  • Verifique que todas las estaciones base se conecten correctamente
  • Confirme que las métricas sean precisas
  • Pruebe las notificaciones de alarmas
  • Documente cualquier configuración personalizada

Lanzamiento en Producción:

  • Despliegue durante la ventana de mantenimiento
  • Monitoree de cerca las primeras 24 horas
  • Tenga un plan de reversión listo
  • Mantenga contactos de soporte disponibles

Operaciones Continuas:

  • Verificaciones de salud diarias a través de la Interfaz Web
  • Revisión semanal de tendencias de alarmas
  • Planificación de capacidad mensual con Grafana
  • Copias de seguridad regulares de configuración

Obtener Ayuda​

Recursos de Solución de Problemas​

Documentación​

Problemas Comunes para Primeras Veces​

Estación Base No Registrada:

  • Verifique la conectividad de red (ping)
  • Verifique que las credenciales sean correctas
  • Confirme que el puerto 8080 sea accesible
  • Revise los registros de la aplicación en busca de errores

Conexión a InfluxDB Fallida:

  • Verifique que InfluxDB esté en ejecución
  • Verifique la configuración de host y puerto
  • Confirme que el token de API tenga permisos de escritura
  • Pruebe la conectividad: curl http://<influxdb-host>:8086/ping

Interfaz Web No Accesible:

  • Verifique que el puerto HTTPS 9443 esté abierto
  • Verifique que los certificados SSL estén presentes
  • Confirme que el endpoint web se haya iniciado en los registros
  • Intente acceder desde la máquina local primero

Documentación Relacionada​