Importar de CSV

Para trazer muitos assinantes de uma vez — de um sistema de cobrança, de uma planilha ou do roteador que você está substituindo — preencha arquivos CSV no formato próprio do Super Router e importe-os. O roteador lê apenas este formato: você exporta os seus dados nestas colunas, ele verifica cada linha, e nada muda até que você mande.

Os arquivos

Um arquivo por tipo, em UTF-8, com uma linha de cabeçalho com os nomes das colunas e depois uma linha por item. Vírgulas separam as colunas (os pontos e vírgulas de uma planilha também são aceitos); um valor que contém vírgula vai entre aspas. Só as colunas marcadas como obrigatórias precisam estar presentes; as outras podem ser omitidas ou ficar vazias.

Importe nesta ordem: planos, redes, clientes, serviços.

plans.csv

Coluna	Obrigatória	Significado
name	sim	Letras, dígitos, _ e -, até 40. Um plano que já existe é atualizado.
down_mbps, up_mbps	sim	Download e upload, em Mbit/s.
comment		Texto livre.

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

networks.csv

As redes dos assinantes: uma VLAN, o endereço do roteador nela (o gateway dos assinantes), servida por DHCP.

Coluna	Obrigatória	Significado
vlan	sim	1–4094.
parent	sim	A porta ou o bond do roteador em que ela está (bond0).
gateway	sim	O endereço do roteador com o prefixo: 10.21.0.1/22.
name		Um rótulo.
protocol		802.1q (padrão) ou 802.1ad (uma S-VLAN).
enabled		yes (padrão) ou no: criada desligada e não servida — para assumir no lugar de outro roteador; é ligada quando aquele libera a rede.

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

clients.csv

Assinantes por endereço MAC, cada um com o seu endereço IPv4 fixo.

Coluna	Obrigatória	Significado
mac	sim	AA:BB:CC:00:00:05.
ip	sim	Em uma das redes do roteador (não o endereço de rede, de gateway ou de broadcast dela).
name		O nome do assinante (guardado como comentário).
plan		Um plano que existe (importe plans.csv primeiro).
shaper		Onde a velocidade do plano é limitada: olt (padrão) ou router. Veja Planos e shaping.
ipv6		Um endereço IPv6 fixo, na mesma interface.
expires		A data de término (YYYY-MM-DD): suspenso nesse dia.
suspended		yes ou no (padrão).
comment		Texto livre.

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,

Um arquivo inteiro é importado com um único reload do DHCP; se o DHCP o recusar, nada é mantido.

services.csv

Assinantes com a sua ONT: cada linha registra a ONT na OLT, cria a sua service-port e lhe dá o seu endereço, como faz dtvsol service add. As ONUs precisam estar conectadas e ainda não registradas.

Coluna	Obrigatória	Significado
name	sim	O cliente.
sn	sim	O serial da ONT: 16 dígitos hexadecimais (48575443AC9FD29A) ou a forma do fabricante (HWTCAC9FD29A).
olt	sim	Uma OLT registrada.
pon	sim	A porta PON, frame/slot/port (0/1/3).
plan	sim	Um plano que existe.
ref		A referência do seu sistema de cobrança (única).
contract		O número do contrato.
user_vlan		A VLAN em que a ONU envia o seu tráfego, quando não é a padrão.
ipv6, iptv		yes ou no.
expires		A data de término.
comment		Texto livre.

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, depois 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

A verificação lista cada linha com problema e o motivo: um MAC ou endereço inválido, um endereço que não está em nenhuma das redes do roteador, um MAC ou endereço já em uso — no roteador ou antes no mesmo arquivo —, um plano que não existe, uma OLT que não está registrada, um serial que já é um serviço.

A página Settings → Import (Configurações → Importar) do monitor faz o mesmo: escolha o tipo, baixe o seu modelo, selecione o seu arquivo, Check (Verificar) e depois Import (Importar).