Solución de problemas

Empiece por el doctor

dtvsol doctor            # the router, and the registered OLT against the router's records
dtvsol doctor --no-olt   # the router only (fast)

El doctor solo lee. Imprime los hallazgos agrupados por área, del más grave al menos grave. Cada hallazgo tiene una severidad (critical, warning, info), el problema, los detalles y una solución (fix).

Área	Qué revisa
dhcp	la configuración y el servicio DHCP, las subredes de cada VLAN servida
delegation	delegación de prefijos IPv6: pools y subredes que no delegan nada
ipv6-gateway	VLANs servidas por DHCPv6 sin router advertisements (los clientes no recibirían gateway IPv6)
addressing	direcciones de red o de broadcast usadas como dirección del router, dos interfaces en una misma subred
vlans	tags de VLAN reclamados dos veces, VLANs que faltan en el kernel
routes, nat	rutas estáticas y pools de NAT comparados con el kernel
persistence	direcciones y VLANs registradas pero no activas, o activas pero no registradas (se pierden en el próximo reinicio)
boot	problemas en el arranque que retrasan las VLANs, las rutas y DHCP
clients	clientes asociados a interfaces o direcciones que no existen
antispoof	reglas de anti-spoofing comparadas con la configuración
store, data	la base de datos de configuración, y archivos de datos que no se pueden interpretar
backup	el respaldo diario y su copia externa
ntp	la hora para las OLT
olt	el registro de OLT, y la OLT comparada con el router: S-VLAN, uplinks, Option 82, la ONT y el service-port de cada servicio

Si /opt/dtvsol/etc/config.php tiene un error, la API no puede arrancar, y dtvsol doctor lo indica primero.

Qué está mal en este momento

dtvsol alarms            # the alarm register, checked every minute
dtvsol alerts            # current conditions
dtvsol version           # software version and the state of the main services
dtvsol daemon status     # API and DHCP status

Logs

Todos en /opt/dtvsol/log/:

Archivo	Qué contiene
api.log	lo que el router hizo y cambió, con quién lo hizo (el nombre del usuario para los cambios desde el monitor), y las líneas del respaldo
auth.log	inicios de sesión fallidos: claves de API incorrectas e inicios de sesión fallidos en el monitor (AUTH-FAIL <ip>), leído por fail2ban
cgnat-mappings.log	cada asignación y liberación de bloques CGNAT
olt-commands.jsonl	cada comando enviado a una OLT, con la respuesta (la Console del monitor)
oltmon-settings.log	cada cambio de configuración hecho en el monitor: hora, dirección, usuario

dtvsol daemon log        # the last lines of api.log
dtvsol daemon logf       # follow it

Servicios del sistema

Unidad	Función
dtvsol-api	el daemon dtvsold: la API en :8880
dtvsol-oltmon	el monitor web en :8881
dtvsol-mkapi	MK-api en :8728
dtvsol-vlans	en el arranque: VLANs, rutas, interfaces de servicios, limitación de velocidad, CGNAT, redirecciones de puertos
isc-dhcp-server, isc-dhcp-server6, radvd	DHCP y router advertisements de IPv6
fail2ban, snmpd, chrony	bloqueos, el agente SNMP, la hora
dtvsol-olt-collect.timer	el recolector de OLT, cada 5 minutos
dtvsol-olt-sync.timer	los planes hacia las OLT, cada 15 minutos
dtvsol-olt-maint.timer	guardados en las OLT y respaldos de configuración
dtvsol-backup.timer	el respaldo diario del router
dtvsol-licence.timer	la renovación diaria de la licencia
dtvsol-antispoof.path, dtvsol-pd-routes.path	siguen los archivos de leases de DHCP

systemctl status dtvsol-api
journalctl -u dtvsol-api -n 100
journalctl -u dtvsol-oltmon -f
journalctl -u dtvsol-olt-collect -n 50
systemctl list-timers 'dtvsol-*'

Problemas comunes

El monitor o la API no responden desde mi PC. Su dirección no está en la lista de permitidos, o fail2ban la bloqueó. En el router:

dtvsol protect list
dtvsol protect add XXX.XXX.XXX.0/24 "NOC"
dtvsol fail2ban
dtvsol fail2ban unban XXX.XXX.XXX.23

El monitor dice “wait” (espere) al iniciar sesión. Cinco inicios de sesión fallidos desde una dirección en 10 minutos. Espere, o use la contraseña correcta. Un admin puede restablecerla: dtvsol monitor user passwd <name>.

Un cambio de red se revirtió solo. No se confirmó dentro de los 120 segundos. Aplíquelo de nuevo y confirme: dtvsol netcfg apply, luego dtvsol netcfg confirm.

POST /services responde 404. El serial no está en la tabla autofind de la OLT: la ONU no está conectada, no está encendida, todavía no se ha visto o ya está registrada. Verifique con dtvsol service unregistered.

POST /services responde 502. La OLT rechazó la operación o no se pudo alcanzar. El campo error trae las palabras de la propia OLT. No se creó nada. Revise el comando en la Console del monitor.

“vlan does not exist on this router” al agregar un servicio. Cree la interfaz de la S-VLAN de la OLT en el puerto o bond que da hacia la OLT (dtvsol vlan add, 802.1Q, id N, sin dirección).

Un abonado no recibe dirección. Revise dtvsol option82 (¿la OLT inserta Option 82?), dtvsol service get <id> (estado en vivo, lease) y dtvsol antispoof log 1h.

Alarmas de licencia. dtvsol licence status, luego sudo dtvsol licence refresh. El router debe poder llegar al middleware de DTVSOL por HTTPS. Sin una licencia válida, los drivers de OLT se detienen.

El doctor dice que algo no sobrevivirá a un reinicio. Siga su solución. Para una dirección que solo está en el kernel, agréguela correctamente con dtvsol ip add, o guarde la red en ejecución con dtvsol netcfg import --save.