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
       SIGINT signals.

       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!

SEE ALSO

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

AUTHORS

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

                                                                                   netplan-try(8)