table of contents
| netplan-try(8) | netplan-try(8) |
NAME¶
netplan-try - try a configuration, optionally rolling it backSYNOPSIS¶
netplan [–debug] try -h | –helpnetplan [–debug] try [–config-file CONFIG_FILE] [–timeout TIMEOUT]
DESCRIPTION¶
netplan try takes a netplan(5) configuration, applies it, and automatically rolls it back if the user does not confirm the configuration within a time limit.This may be especially useful on remote systems, to prevent an administrator being permanently locked out of systems in the case of a network configuration error.
OPTIONS¶
- -h, –help
- Print basic help.
- –debug
- Print debugging output during the process.
- –config-file CONFIG_FILE
- In addition to the usual configuration, apply CONFIG_FILE. It must be a YAML file in the netplan(5) format.
- –timeout TIMEOUT
- Wait for TIMEOUT seconds before reverting. Defaults to 120 seconds. Note that some network configurations (such as STP) may take over a minute to settle.
KNOWN ISSUES¶
netplan try uses similar procedures to netplan apply, so some of the same caveats apply around virtual devices.There are also some known bugs: if netplan try times out or is cancelled, make sure to verify if the network configuration has in fact been reverted.
As with netplan apply, a reboot should fix any issues. However, be sure to verify that the config on disk is in the state you expect before rebooting!