NAME

       netplan-try - try a configuration, optionally rolling it back

SYNOPSIS

       netplan [--debug] try -h | --help

       netplan [--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  net‐
              plan(5) format.

       --timeout TIMEOUT
              Wait  for TIMEOUT seconds before reverting.  Defaults to 120 seconds.  Note that some network con‐
              figurations (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 net‐
       work 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!

SEE ALSO

       netplan(5), netplan-generate(8), netplan-apply(8)

AUTHORS

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

                                                                                                  netplan-try(8)