nixos: nixos/doc/manual/administration/rollback.xml to CommonMark
This commit is contained in:
parent
b5215f3f73
commit
99493b61ea
38
nixos/doc/manual/administration/rollback.section.md
Normal file
38
nixos/doc/manual/administration/rollback.section.md
Normal file
|
@ -0,0 +1,38 @@
|
||||||
|
# Rolling Back Configuration Changes {#sec-rollback}
|
||||||
|
|
||||||
|
After running `nixos-rebuild` to switch to a new configuration, you may
|
||||||
|
find that the new configuration doesn't work very well. In that case,
|
||||||
|
there are several ways to return to a previous configuration.
|
||||||
|
|
||||||
|
First, the GRUB boot manager allows you to boot into any previous
|
||||||
|
configuration that hasn't been garbage-collected. These configurations
|
||||||
|
can be found under the GRUB submenu "NixOS - All configurations". This
|
||||||
|
is especially useful if the new configuration fails to boot. After the
|
||||||
|
system has booted, you can make the selected configuration the default
|
||||||
|
for subsequent boots:
|
||||||
|
|
||||||
|
```ShellSession
|
||||||
|
# /run/current-system/bin/switch-to-configuration boot
|
||||||
|
```
|
||||||
|
|
||||||
|
Second, you can switch to the previous configuration in a running
|
||||||
|
system:
|
||||||
|
|
||||||
|
```ShellSession
|
||||||
|
# nixos-rebuild switch --rollback
|
||||||
|
```
|
||||||
|
|
||||||
|
This is equivalent to running:
|
||||||
|
|
||||||
|
```ShellSession
|
||||||
|
# /nix/var/nix/profiles/system-N-link/bin/switch-to-configuration switch
|
||||||
|
```
|
||||||
|
|
||||||
|
where `N` is the number of the NixOS system configuration. To get a
|
||||||
|
list of the available configurations, do:
|
||||||
|
|
||||||
|
```ShellSession
|
||||||
|
$ ls -l /nix/var/nix/profiles/system-*-link
|
||||||
|
...
|
||||||
|
lrwxrwxrwx 1 root root 78 Aug 12 13:54 /nix/var/nix/profiles/system-268-link -> /nix/store/202b...-nixos-13.07pre4932_5a676e4-4be1055
|
||||||
|
```
|
|
@ -1,41 +0,0 @@
|
||||||
<section xmlns="http://docbook.org/ns/docbook"
|
|
||||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
||||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
||||||
version="5.0"
|
|
||||||
xml:id="sec-rollback">
|
|
||||||
<title>Rolling Back Configuration Changes</title>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
After running <command>nixos-rebuild</command> to switch to a new
|
|
||||||
configuration, you may find that the new configuration doesn’t work very
|
|
||||||
well. In that case, there are several ways to return to a previous
|
|
||||||
configuration.
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
First, the GRUB boot manager allows you to boot into any previous
|
|
||||||
configuration that hasn’t been garbage-collected. These configurations can
|
|
||||||
be found under the GRUB submenu “NixOS - All configurations”. This is
|
|
||||||
especially useful if the new configuration fails to boot. After the system
|
|
||||||
has booted, you can make the selected configuration the default for
|
|
||||||
subsequent boots:
|
|
||||||
<screen>
|
|
||||||
<prompt># </prompt>/run/current-system/bin/switch-to-configuration boot</screen>
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
Second, you can switch to the previous configuration in a running system:
|
|
||||||
<screen>
|
|
||||||
<prompt># </prompt>nixos-rebuild switch --rollback</screen>
|
|
||||||
This is equivalent to running:
|
|
||||||
<screen>
|
|
||||||
<prompt># </prompt>/nix/var/nix/profiles/system-<replaceable>N</replaceable>-link/bin/switch-to-configuration switch</screen>
|
|
||||||
where <replaceable>N</replaceable> is the number of the NixOS system
|
|
||||||
configuration. To get a list of the available configurations, do:
|
|
||||||
<screen>
|
|
||||||
<prompt>$ </prompt>ls -l /nix/var/nix/profiles/system-*-link
|
|
||||||
<replaceable>...</replaceable>
|
|
||||||
lrwxrwxrwx 1 root root 78 Aug 12 13:54 /nix/var/nix/profiles/system-268-link -> /nix/store/202b...-nixos-13.07pre4932_5a676e4-4be1055
|
|
||||||
</screen>
|
|
||||||
</para>
|
|
||||||
</section>
|
|
|
@ -10,7 +10,7 @@
|
||||||
</para>
|
</para>
|
||||||
<xi:include href="../from_md/administration/boot-problems.section.xml" />
|
<xi:include href="../from_md/administration/boot-problems.section.xml" />
|
||||||
<xi:include href="../from_md/administration/maintenance-mode.section.xml" />
|
<xi:include href="../from_md/administration/maintenance-mode.section.xml" />
|
||||||
<xi:include href="rollback.xml" />
|
<xi:include href="../from_md/administration/rollback.section.xml" />
|
||||||
<xi:include href="store-corruption.xml" />
|
<xi:include href="store-corruption.xml" />
|
||||||
<xi:include href="network-problems.xml" />
|
<xi:include href="network-problems.xml" />
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
42
nixos/doc/manual/from_md/administration/rollback.section.xml
Normal file
42
nixos/doc/manual/from_md/administration/rollback.section.xml
Normal file
|
@ -0,0 +1,42 @@
|
||||||
|
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-rollback">
|
||||||
|
<title>Rolling Back Configuration Changes</title>
|
||||||
|
<para>
|
||||||
|
After running <literal>nixos-rebuild</literal> to switch to a new
|
||||||
|
configuration, you may find that the new configuration doesn’t work
|
||||||
|
very well. In that case, there are several ways to return to a
|
||||||
|
previous configuration.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
First, the GRUB boot manager allows you to boot into any previous
|
||||||
|
configuration that hasn’t been garbage-collected. These
|
||||||
|
configurations can be found under the GRUB submenu <quote>NixOS -
|
||||||
|
All configurations</quote>. This is especially useful if the new
|
||||||
|
configuration fails to boot. After the system has booted, you can
|
||||||
|
make the selected configuration the default for subsequent boots:
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
# /run/current-system/bin/switch-to-configuration boot
|
||||||
|
</programlisting>
|
||||||
|
<para>
|
||||||
|
Second, you can switch to the previous configuration in a running
|
||||||
|
system:
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
# nixos-rebuild switch --rollback
|
||||||
|
</programlisting>
|
||||||
|
<para>
|
||||||
|
This is equivalent to running:
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
# /nix/var/nix/profiles/system-N-link/bin/switch-to-configuration switch
|
||||||
|
</programlisting>
|
||||||
|
<para>
|
||||||
|
where <literal>N</literal> is the number of the NixOS system
|
||||||
|
configuration. To get a list of the available configurations, do:
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
$ ls -l /nix/var/nix/profiles/system-*-link
|
||||||
|
...
|
||||||
|
lrwxrwxrwx 1 root root 78 Aug 12 13:54 /nix/var/nix/profiles/system-268-link -> /nix/store/202b...-nixos-13.07pre4932_5a676e4-4be1055
|
||||||
|
</programlisting>
|
||||||
|
</section>
|
Loading…
Reference in a new issue