netplan-try (8)

Leading comments

Automatically generated by Pandoc 1.19.2.4

(The comments found at the beginning of the groff file "man8/netplan-try.8".)

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)

AUTHORS

Daniel Axtens (<daniel.axtens@canonical.com>).