Cambios de red

La red propia del router se guarda como un documento, network, en la base de datos de configuración:

• los puertos físicos (activos o inactivos, MTU),
• los bonds (miembros, modo, tasa LACP, política de hash, intervalo MII, MTU),
• las direcciones en los puertos y bonds,
• la ruta por defecto y las rutas estáticas sobre ellos,
• los servidores DNS del equipo.

dtvsold escribe esto en un único archivo de netplan, /etc/netplan/90-dtvsol.yaml. La primera aplicación mueve cualquier otro archivo de netplan a /etc/netplan/disabled/. Las VLAN no están en netplan: el router las crea al arrancar. Vea VLAN.

Precaución

No edite /etc/netplan/90-dtvsol.yaml a mano. Se reescribe a partir de la base de datos.

Revise antes de cambiar

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

Importar la red en ejecución

En un servidor que se configuró a mano, lea una vez la red en ejecución (kernel y netplan) hacia la base de datos:

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

--save se niega cuando el archivo de netplan generado a partir de ella perdería un ajuste de los archivos actuales (marcado LOST en la salida). Revise esos primero. --force lo guarda de todos modos.

Cambiar y aplicar desde la CLI

Edite el documento. El editor verifica el JSON y guarda primero una versión de la configuración:

dtvsol config edit network

Luego verifique y aplique:

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

Lo que hace apply:

1. Respalda el directorio de netplan (con los ajustes de los miembros de los bonds y los ajustes de DNS) y guarda una versión de la configuración.
2. Verifica el archivo nuevo con netplan generate y luego ejecuta netplan apply.
3. Compara el kernel con el estado anterior (direcciones, rutas por defecto, anuncios de router) y lista cada diferencia.
4. Espera su confirmación. Si no confirma dentro de 120 segundos, se restablece la red anterior.

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

Una aplicación se rechaza cuando quitaría la dirección que está usando su sesión SSH o la API. --force la aplica de todos modos.

Peligro

Use --force solo desde una consola (IPMI/BMC o una pantalla local), nunca a través del enlace que está cambiando. La reversión de 120 segundos es su única forma de volver atrás.

Solo un cambio a la vez puede estar esperando su confirmación.

Cambiar y aplicar desde el monitor

Los administradores pueden cambiar puertos y bonds en Settings → Interfaces del monitor:

1. Haga clic en un puerto o en un bond y cámbielo. Para un puerto: habilitado o deshabilitado, MTU, o stop managing this port (dejar de administrar este puerto). Para un bond: miembros, modo y parámetros, MTU. Haga clic en Keep this change (conservar este cambio).
2. Los cambios se acumulan en una barra en la parte superior: N interface(s) changed — not applied yet. Haga clic en Review and apply… (revisar y aplicar).
3. El router muestra qué cambia, qué se rechaza, qué direcciones se eliminan y el nuevo archivo de netplan. Todavía no se ha tocado nada.
4. Haga clic en Apply — rolls back in 120 s unless you confirm. La página puede perder contacto con el router durante unos segundos.
5. Verifique que todo funcione y luego haga clic en Confirm (confirmar) en el aviso de la parte superior de la pestaña Settings. Roll back now (revertir ahora) restablece la red anterior de inmediato.

El monitor nunca fuerza un cambio rechazado. Rechaza todo lo que quite la dirección de su navegador, de una sesión SSH o de la API. Si usted cambia el uplink, la página le advierte que un cambio equivocado deja al router incomunicado.

Stop managing this port saca un puerto de la configuración, para que netplan no lo toque (por ejemplo, un enlace que no es del router). Un miembro de un bond o un puerto con direcciones no se puede liberar: primero sáquelo del bond o elimine sus direcciones.

El enlace de red USB de una BMC (a menudo usb0) se muestra como el enlace de la BMC y nunca se administra.

Cada cambio hecho desde el monitor queda registrado con el nombre del usuario en /opt/dtvsol/log/api.log.

Cuando un cambio salió mal

• No haga nada: después de 120 segundos, la red anterior se restablece.
• Desde una consola: dtvsol netcfg rollback.
• Estados más antiguos: dtvsol config versions, luego dtvsol config restore <id> --yes y dtvsol netcfg apply.