Importar desde CSV

Para cargar muchos abonados a la vez — desde un sistema de facturación, una hoja de cálculo o el router que está reemplazando — complete archivos CSV en el formato propio del Super Router e impórtelos. El router lee solo este formato: usted exporta sus datos con estas columnas, el router verifica cada línea y nada cambia hasta que usted lo indique.

Los archivos

Un archivo por tipo, en UTF-8, con una línea de encabezado con los nombres de las columnas y luego una línea por elemento. Las columnas se separan con comas (también se aceptan los punto y coma de una hoja de cálculo); un valor que contiene una coma va entre comillas. Solo las columnas marcadas como obligatorias deben estar presentes; las demás pueden omitirse o dejarse vacías.

Importe en este orden: plans, networks, clients, services.

plans.csv

Columna	Obligatoria	Significado
name	sí	Letras, dígitos, _ y -, hasta 40. Un plan que ya existe se actualiza.
down_mbps, up_mbps	sí	Bajada y subida, en Mbit/s.
comment		Texto libre.

name,down_mbps,up_mbps,comment
plan_100_100,100,100,Home 100

networks.csv

Las redes de los abonados: una VLAN, la dirección del router en ella (el gateway de los abonados), servida por DHCP.

Columna	Obligatoria	Significado
vlan	sí	1–4094.
parent	sí	El puerto o bond del router en el que está (bond0).
gateway	sí	La dirección del router con el prefijo: 10.21.0.1/22.
name		Una etiqueta.
protocol		802.1q (por defecto) o 802.1ad (una S-VLAN).
enabled		yes (por defecto) o no: se crea apagada y sin servir — para tomar el relevo de otro router; se enciende cuando ese router suelta la red.

vlan,parent,gateway,name,protocol,enabled
21,bond0,10.21.0.1/22,Flat OLT 1,802.1q,yes

clients.csv

Abonados por dirección MAC, cada uno con su dirección IPv4 fija.

Columna	Obligatoria	Significado
mac	sí	AA:BB:CC:00:00:05.
ip	sí	En una de las redes del router (no su dirección de red, gateway ni broadcast).
name		El nombre del abonado (se guarda como comentario).
plan		Un plan que exista (importe primero plans.csv).
shaper		Dónde se limita la velocidad del plan: olt (por defecto) o router. Vea Planes y shaping.
ipv6		Una dirección IPv6 fija, en la misma interfaz.
expires		La fecha de vencimiento (YYYY-MM-DD): se suspende ese día.
suspended		yes o no (por defecto).
comment		Texto libre.

mac,ip,name,plan,shaper,ipv6,expires,suspended,comment
AA:BB:CC:00:00:05,10.21.0.5,Juan Perez,plan_100_100,olt,,2027-01-31,no,

Un archivo completo se importa con una sola recarga de DHCP; si DHCP la rechaza, no se conserva nada.

services.csv

Abonados con su ONT: cada línea registra la ONT en la OLT, crea su service-port y le asigna su dirección, como lo hace dtvsol service add. Las ONU deben estar conectadas y todavía sin registrar.

Columna	Obligatoria	Significado
name	sí	El cliente.
sn	sí	El número de serie de la ONT: 16 dígitos hexadecimales (48575443AC9FD29A) o la forma del fabricante (HWTCAC9FD29A).
olt	sí	Una OLT registrada.
pon	sí	El puerto PON, frame/slot/port (0/1/3).
plan	sí	Un plan que exista.
ref		La referencia de su sistema de facturación (única).
contract		El número de contrato.
user_vlan		La VLAN en la que la ONU envía su tráfico, cuando no es la de por defecto.
ipv6, iptv		yes o no.
expires		La fecha de vencimiento.
comment		Texto libre.

name,sn,olt,pon,plan,ref,contract,user_vlan,ipv6,iptv,expires,comment
Maria Lopez,48575443AC9FD29A,olt-1,0/1/3,plan_100_100,CUST-1001,C-0001,,no,no,,

Verificar y luego importar

dtvsol import template clients > clients.csv        # an empty file with the header and an example
dtvsol import clients clients.csv                   # check every line: nothing changes
dtvsol import clients clients.csv --apply           # import (all or nothing)
dtvsol import clients clients.csv --apply --skip-errors   # import the good lines, list the rest

La verificación enumera cada línea con un problema y el motivo: una MAC o dirección no válida, una dirección que no está en ninguna de las redes del router, una MAC o dirección ya usada — en el router o antes en el mismo archivo —, un plan que no existe, una OLT que no está registrada, un número de serie que ya es un servicio.

La página Settings → Import (Configuración → Importar) del monitor hace lo mismo: elija el tipo, descargue su plantilla, elija su archivo, Check (Verificar) y luego Import (Importar).