116 lines
3.0 KiB
HTML
116 lines
3.0 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of netplan-try</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>netplan-try</H1>
|
|
Section: (8)<BR>Updated: <BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
<P>
|
|
|
|
netplan-try - try a configuration, optionally rolling it back
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<P>
|
|
|
|
netplan [-debug] try -h | -help
|
|
<P>
|
|
|
|
netplan [-debug] try [-config-file
|
|
CONFIG_FILE] [-timeout TIMEOUT]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
netplan try takes a <A HREF="/cgi-bin/man/man2html?5+netplan">netplan</A>(5) configuration,
|
|
applies it, and automatically rolls it back if the user does not confirm
|
|
the configuration within a time limit.
|
|
<P>
|
|
|
|
A configuration can be confirmed or rejected interactively or by sending
|
|
the SIGUSR1 or SIGINT signals.
|
|
<P>
|
|
|
|
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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h, -help</B>
|
|
|
|
<DD>
|
|
Print basic help.
|
|
<DT id="2"><B>-debug</B>
|
|
|
|
<DD>
|
|
Print debugging output during the process.
|
|
<DT id="3"><B>-config-file </B>CONFIG_FILE
|
|
|
|
<DD>
|
|
In addition to the usual configuration, apply CONFIG_FILE.
|
|
It must be a YAML file in the <A HREF="/cgi-bin/man/man2html?5+netplan">netplan</A>(5) format.
|
|
<DT id="4"><B>-timeout </B>TIMEOUT
|
|
|
|
<DD>
|
|
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.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>KNOWN ISSUES</H2>
|
|
|
|
<P>
|
|
|
|
netplan try uses similar procedures to netplan
|
|
apply, so some of the same caveats apply around virtual devices.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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!
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<P>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?5+netplan">netplan</A>(5), <A HREF="/cgi-bin/man/man2html?8+netplan-generate">netplan-generate</A>(8),
|
|
<A HREF="/cgi-bin/man/man2html?8+netplan-apply">netplan-apply</A>(8)
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Daniel Axtens (<<A HREF="mailto:daniel.axtens@canonical.com">daniel.axtens@canonical.com</A>>).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="5"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="6"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="7"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="8"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="9"><A HREF="#lbAF">KNOWN ISSUES</A><DD>
|
|
<DT id="10"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="11"><A HREF="#lbAH">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:14 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|