netplan-try (8)
Leading comments
Automatically generated by Pandoc 1.19.2.4
NAME
netplan-try - try a configuration, optionally rolling it back
SYNOPSIS
B]netplan] [--debug] B]try] -h | --help
B]netplan] [--debug] B]try] [--config-file I]CONFIG_FILE]] [--timeout I]TIMEOUT]]
DESCRIPTION
B]netplan try] takes a B]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 I]CONFIG_FILE]
-
In addition to the usual configuration, apply I]CONFIG_FILE].
It must be a YAML file in the B]netplan](5) format.
- --timeout I]TIMEOUT]
-
Wait for I]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
B]netplan try] uses similar procedures to B]netplan apply], so some of the same caveats apply around virtual devices.
There are also some known bugs: if B]netplan try] times out or is cancelled, make sure to verify if the network configuration has in fact been reverted.
As with B]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!
SEE ALSO
B]netplan](5), B]netplan-generate](8), B]netplan-apply](8)