Conceptos

Clientes y servicios

El router conoce dos tipos de abonado.

Los servicios son el modelo actual. Un servicio es un cliente final, una ONT, una velocidad, una dirección fija y un id permanente (svc_xxxxxxxx). Su sistema de facturación (billing) lo crea con una sola llamada. El router registra la ONT en la OLT y configura todo de su propio lado. Nunca se necesita una dirección MAC: si el cliente cambia el router de su casa, el servicio sigue funcionando con la misma dirección.

Los clientes son el modelo anterior, basado en MAC. Un cliente es una dirección MAC con una IP fija en una VLAN que usted creó. El listener MK-api compatible con MikroTik trabaja con clientes. Los clientes siguen totalmente soportados para las redes que los necesitan.

	Servicio	Cliente
Se identifica por	ONT (puerto e id de ONT, mediante Option 82)	Dirección MAC
Se crea con	dtvsol service add, POST /services	dtvsol clients add, MK-api
VLAN	una por puerto PON, creada automáticamente	una que usted crea
Velocidad aplicada por	la OLT (CAR)	el router (tc HTB)
Suspensión	la ONT se desactiva en la OLT y la dirección se bloquea	la dirección se bloquea en el router

Una VLAN por puerto PON

Cada router tiene su propia S-VLAN en cada OLT. Dentro de ella, cada puerto PON tiene su propia C-VLAN:

C-VLAN = 100 + card × 16 + pon

El puerto 0/1/0 (tarjeta 1, PON 0) es la VLAN 116. El puerto 0/0/3 es la VLAN 103.

Cada puerto PON recibe su propia /24 del pool IPv4 de los servicios (svc_ipv4_pool en /opt/dtvsol/etc/config.php), y su propia /64 cuando IPv6 está configurado:

port network = pool + (C-VLAN − 100) × 256      VLAN 100 → 100.64.0.0/24
gateway      = .1                               VLAN 116 → 100.64.16.0/24
ONT address  = .2 + ONT id                      ONT 7    → 100.64.16.9

En el router, la interfaz del puerto se llama v<svlan>.<cvlan>, por ejemplo v1000.116. Usted nunca asigna VLAN ni direcciones a mano: se derivan de la OLT, la tarjeta, el puerto y el id de ONT.

Los routers de varios operadores pueden compartir una OLT. Cada router tiene su propia S-VLAN en ella.

Option 82

Cuando una ONT pide una dirección, la OLT agrega DHCP Option 82 a la solicitud: de qué puerto y de qué ONT viene. El router entrega la dirección fija de la ONT solo a una solicitud cuyo Option 82 identifica a esa ONT. Por eso un servicio no necesita dirección MAC.

Vea lo que recibe el router:

dtvsol option82

Bloques de puertos CGNAT

Los abonados suelen tener direcciones privadas (por ejemplo, de 100.64.0.0/10). CGNAT los hace salir a través de un pequeño pool de direcciones públicas.

El CGNAT del router es determinista. Cada dirección pública se divide en bloques de puertos fijos (de 2048 puertos cada uno por defecto, de los puertos 1024–65535). Cada abonado recibe un bloque en una dirección pública y lo conserva. Cada asignación y liberación se escribe en /opt/dtvsol/log/cgnat-mappings.log.

Así no hay que guardar un log por conexión. Para responder “quién usó XXX.XXX.XXX.70 puerto 40000 en ese momento”, busque el bloque:

dtvsol cgnat lookup XXX.XXX.XXX.70 40000

Consulte CGNAT.

Configuración guardada y versiones

Toda la configuración vive en un único archivo SQLite, /opt/dtvsol/data/dtvsol.db. Clientes, servicios, VLAN, OLT, planes, la red y lo demás son documentos dentro de él. Cada cambio es una transacción.

Como en la flash de un switch, usted puede guardar versiones:

dtvsol config save "before the new OLT"
dtvsol config versions
dtvsol config diff 12 running
dtvsol config restore 12 --yes

La copia de seguridad diaria guarda una versión por sí misma cuando la configuración cambió. Los documentos nunca se editan a mano: use dtvsol config edit <name>, que valida el JSON y guarda antes una versión. Consulte Copia de seguridad y restauración.

La reversión de 120 segundos

Un cambio en la red propia del router (puertos, bonds, sus direcciones, la ruta por defecto) puede dejarlo a usted sin acceso. Por eso se aplica con una red de seguridad:

1. Se respaldan los archivos de netplan y se guarda una versión de la configuración.
2. El archivo nuevo se valida con netplan generate y luego se aplica.
3. Usted tiene 120 segundos para confirmar. Sin confirmación, se restablece la red anterior.

Un cambio que quitaría la dirección que usa su sesión SSH, la API o el monitor se rechaza antes de ejecutar nada.

dtvsol netcfg apply
dtvsol netcfg confirm      # keep it
dtvsol netcfg rollback     # or put the old one back now

La página Settings → Interfaces (Configuración → Interfaces) del monitor funciona de la misma manera. Consulte Cambios de red.