1netplan-try(8)                                                  netplan-try(8)
2
3
4

NAME

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

SYNOPSIS

9       netplan [–debug] try -h | –help
10
11       netplan [–debug] try [–config-file CONFIG_FILE] [–timeout TIMEOUT]
12

DESCRIPTION

14       netplan try takes a netplan(5) configuration, applies it, and automati‐
15       cally rolls it back if the user  does  not  confirm  the  configuration
16       within a time limit.
17
18       A  configuration can be confirmed or rejected interactively or by send‐
19       ing the SIGUSR1 or SIGINT signals.
20
21       This may be especially useful on remote systems, to prevent an adminis‐
22       trator being permanently locked out of systems in the case of a network
23       configuration error.
24

OPTIONS

26       -h, –help
27              Print basic help.
28
29       –debug Print debugging output during the process.
30
31       –config-file CONFIG_FILE
32              In addition to the usual configuration, apply  CONFIG_FILE.   It
33              must be a YAML file in the netplan(5) format.
34
35       –timeout TIMEOUT
36              Wait for TIMEOUT seconds before reverting.  Defaults to 120 sec‐
37              onds.  Note that some network configurations (such as  STP)  may
38              take over a minute to settle.
39

KNOWN ISSUES

41       netplan  try  uses  similar procedures to netplan apply, so some of the
42       same caveats apply around virtual devices.
43
44       There are also some known bugs: if netplan try times  out  or  is  can‐
45       celled,  make  sure  to verify if the network configuration has in fact
46       been reverted.
47
48       As with netplan apply, a reboot should fix  any  issues.   However,  be
49       sure  to  verify that the config on disk is in the state you expect be‐
50       fore rebooting!
51

SEE ALSO

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

AUTHORS

56       Daniel Axtens (<daniel.axtens@canonical.com>).
57
58
59
60                                                                netplan-try(8)