man > netplan-try(8)

NETPLAN-TRY(8)                                                                        NETPLAN-TRY(8)

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.

       A configuration can be confirmed or rejected interactively or by sending the SIGUSR1 or  SIG‐
       INT signals.

       This may be especially useful on remote systems, to prevent an administrator being permanent‐
       ly 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
       configuration 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 AT canonical.com>).

                                                                                      NETPLAN-TRY(8)