Alterações de rede

A rede do próprio roteador é armazenada como um documento, network, no banco de dados de configuração:

• as portas físicas (ativas ou desativadas, MTU),
• os bonds (membros, modo, LACP rate, hash policy, MII interval, MTU),
• os endereços nas portas e nos bonds,
• a rota padrão e as rotas estáticas neles,
• os servidores DNS do host.

O dtvsold grava isso em um único arquivo do netplan, /etc/netplan/90-dtvsol.yaml. A primeira aplicação move quaisquer outros arquivos do netplan para /etc/netplan/disabled/. As VLANs não ficam no netplan: o roteador as cria no boot. Veja VLANs.

Cuidado

Não edite /etc/netplan/90-dtvsol.yaml à mão. Ele é regravado a partir do banco de dados.

Olhe antes de alterar

dtvsol netcfg show               # the stored configuration, with VLANs and static routes
dtvsol netcfg render             # the netplan file it writes
dtvsol netcfg diff               # stored vs the running kernel vs /etc/netplan, and whether an apply is allowed

Importe a rede em execução

Em um servidor que foi configurado à mão, importe a rede em execução (kernel e netplan) para o banco de dados uma vez:

dtvsol netcfg import                   # show what would be stored, key by key
dtvsol netcfg render --proposed        # the netplan file it would write
dtvsol netcfg import --save

O --save recusa quando o arquivo do netplan gerado a partir disso perderia uma configuração dos arquivos atuais (marcada como LOST na saída). Verifique essas primeiro. O --force armazena mesmo assim.

Altere e aplique pela CLI

Edite o documento. O editor verifica o JSON e guarda uma versão da configuração antes:

dtvsol config edit network

Depois verifique e aplique:

dtvsol netcfg diff
dtvsol netcfg apply --try        # check the new file with netplan generate only
dtvsol netcfg apply

O que o apply faz:

1. Faz backup do diretório do netplan (com as configurações dos membros dos bonds e as configurações de DNS) e salva uma versão da configuração.
2. Verifica o novo arquivo com netplan generate e depois executa netplan apply.
3. Compara o kernel com o estado anterior (endereços, rotas padrão, router advertisements) e lista cada diferença.
4. Espera a sua confirmação. Sem confirmação em até 120 segundos, a rede anterior é restaurada.

dtvsol netcfg confirm            # keep the new network
dtvsol netcfg rollback           # put the previous one back now

Uma aplicação é recusada quando tiraria o endereço que a sua sessão SSH ou a API estão usando. O --force aplica mesmo assim.

Perigo

Use --force somente a partir de um console (IPMI/BMC ou uma tela local), nunca pelo link que você está alterando. O rollback de 120 segundos é a sua única forma de voltar.

Só uma alteração por vez pode ficar esperando confirmação.

Altere e aplique pelo monitor

Os admins podem alterar portas e bonds em Settings → Interfaces no monitor:

1. Clique em uma porta ou em um bond e altere-o. Para uma porta: ativada ou desativada, MTU, ou stop managing this port. Para um bond: membros, modo e parâmetros, MTU. Clique em Keep this change.
2. As alterações se acumulam em uma barra no topo: N interface(s) changed — not applied yet. Clique em Review and apply…
3. O roteador mostra o que muda, o que é recusado, quais endereços saem e o novo arquivo do netplan. Nada foi tocado ainda.
4. Clique em Apply — rolls back in 120 s unless you confirm. A página pode perder o contato com o roteador por alguns segundos.
5. Verifique se tudo funciona e clique em Confirm no aviso no topo da aba Settings. Roll back now restaura a rede antiga imediatamente.

O monitor nunca força uma alteração recusada. Ele recusa qualquer coisa que tire o endereço do seu navegador, de uma sessão SSH ou da API. Se você alterar o uplink, a página avisa que uma alteração errada deixa o roteador inacessível.

Stop managing this port tira uma porta da configuração, para que o netplan a deixe em paz (por exemplo, um link que não é do roteador). Um membro de bond ou uma porta com endereços não pode ser liberado: tire-o do bond ou apague os seus endereços primeiro.

O link de rede USB de uma BMC (muitas vezes usb0) é mostrado como o link da BMC e nunca é gerenciado.

Cada alteração feita pelo monitor é registrada com o nome do usuário em /opt/dtvsol/log/api.log.

Quando uma alteração deu errado

• Não faça nada: após 120 segundos a rede anterior está de volta.
• A partir de um console: dtvsol netcfg rollback.
• Estados mais antigos: dtvsol config versions, depois dtvsol config restore <id> --yes e dtvsol netcfg apply.