Manual: netplan-try

NETPLAN-TRY(8)					   System Manager's Manual				      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 con‐
       firm 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 configu‐
       ration 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@canonical.com).

													      NETPLAN-TRY(8)