Promoções

Uma promoção aumenta a velocidade de todos os planos, ou dos planos escolhidos, por um tempo: todo sábado o dobro da velocidade, três vezes o download todas as noites, velocidade em dobro na semana do Natal. O roteador verifica a cada minuto, pelo seu próprio horário local, e altera as velocidades quando uma promoção começa ou termina. Ninguém precisa estar acordado às 22:00 para ligá-la.

Configure-as com dtvsol promo …, a API ou a aba Services do monitor.

Exemplos

dtvsol promo add saturday x2 days sat                                   # every Saturday, all day, ×2
dtvsol promo add nights x3 from 22:00 to 06:00 max 1000                 # every night ×3, never above 1 Gb/s
dtvsol promo add xmas down x2 start 2026-12-24 end 2026-12-31           # a week, download only
dtvsol promo add weekend-nights x2 days fri,sat from 20:00 to 02:00 plans plan_100_100,plan_200_200
dtvsol promo                                                            # what runs now, every plan's speed
dtvsol promo at "2026-10-03 23:30"                                      # the speeds at another time
dtvsol promo off nights                                                 # keep it, stop it
dtvsol promo del xmas

O que uma promoção diz

Palavra	Significado
x2	Download e upload ×2 (qualquer número de 1 a 10: x1.5)
down x3 / up x2	Só aquela direção (ou multiplicadores diferentes)
max 1000	Nenhuma velocidade acima de 1000 Mb/s, por maior que seja o multiplicador
days sat,sun	Os dias da semana (all, ou nenhum: todos os dias)
from 22:00 to 06:00	O horário (nenhum: o dia inteiro). Uma janela que passa da meia-noite pertence ao dia em que começa: sexta 22:00–06:00 vai até sábado 06:00
start / end	O primeiro e o último dia (YYYY-MM-DD)
plans a,b	Os planos que ela aumenta (nenhum: todos os planos)
comment …	O que você diz aos assinantes

• Duas promoções no mesmo plano não se multiplicam: vale a mais rápida, em cada direção.
• Uma promoção nunca reduz uma velocidade: um teto abaixo da velocidade de um plano deixa o plano como está.
• dtvsol promo at … (e o campo de horário do monitor) mostra a velocidade de cada plano em qualquer momento, para conferir uma promoção antes que ela comece.

Onde a velocidade aumenta

A velocidade de cada assinante é limitada em um só lugar (Planos e controle de banda):

• Assinantes que o roteador limita (shaper router): na hora, quando a promoção começa e termina.
• Assinantes que a OLT limita (serviços — a maioria): o roteador altera a velocidade das tabelas de tráfego da OLT no lugar, em até um minuto depois que a promoção começa ou termina. Os service-ports de uma tabela acompanham na hora; nenhuma ONT é tocada nem interrompida, e isso custa algumas gravações por OLT, seja qual for o número de assinantes.

Uma tabela de tráfego só é alterada quando é seguro:

• todo service-port nela é um dos serviços deste roteador (na sua S-VLAN) — as tabelas de outro operador, e as tabelas padrão da OLT, nunca são tocadas;
• todos os planos nela querem a mesma velocidade agora. Dois planos que compartilham uma tabela mas não uma promoção são um conflict (conflito): a tabela fica como está, e dtvsol promo avisa.

O roteador confere as tabelas de novo a cada 30 minutos (uma OLT reiniciada a partir da configuração salva, uma tabela alterada à mão), e cinco minutos depois de uma alteração que falhou; uma falha também é um alarme.

dtvsol promo (e a aba Services do monitor) mostra todas as tabelas da OLT: a sua taxa, os planos nela e se ela está ok, changed (alterada), em conflict (conflito) ou shared (compartilhada).

Cada plano com as suas tabelas

O roteador dá a cada plano as suas próprias tabelas de tráfego na OLT, uma para o download e uma para o upload, para que uma promoção possa aumentar um plano sozinho, em uma direção. Os serviços novos já as recebem. Os serviços criados antes continuam em tabelas compartilhadas por velocidade:

dtvsol promo tables                    # which services are on their plan's own tables
dtvsol promo move-tables olt-1         # what would be moved
dtvsol promo move-tables olt-1 --yes   # move them

Mover refaz o service-port de internet de cada serviço nas tabelas do seu plano: cada ONU perde a conexão por alguns segundos, uma depois da outra. Faça isso em um horário tranquilo. Até lá, uma promoção ainda chega a uma tabela compartilhada sempre que todos os seus planos são aumentados da mesma forma (uma promoção para todos os planos, igual nas duas direções).