[MAN] netplan-try

Content-type: text/html; charset=UTF-8

netplan-try

Section: (8)
Updated:
Index Return to Main Contents

---

 

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 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>).

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

KNOWN ISSUES

SEE ALSO

AUTHORS

---

This document was created by man2html, using the manual pages.
Time: 04:46:03 GMT, September 16, 2022