diff options
author | Maximilian Bosch <maximilian@mbosch.me> | 2020-03-26 11:00:23 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-03-26 11:00:23 +0100 |
commit | 89bcf4b7e23f52af03acd81f70cd13deb9b033fd (patch) | |
tree | 190f818bcb6ebea826df369ffc3752939d17ccc9 /nixos/doc/manual | |
parent | c3392946b1c643750666e936557006f0b1e584d3 (diff) | |
parent | 702f645aa8de543fa813aba07b11c26067d6094b (diff) | |
download | nixlib-89bcf4b7e23f52af03acd81f70cd13deb9b033fd.tar nixlib-89bcf4b7e23f52af03acd81f70cd13deb9b033fd.tar.gz nixlib-89bcf4b7e23f52af03acd81f70cd13deb9b033fd.tar.bz2 nixlib-89bcf4b7e23f52af03acd81f70cd13deb9b033fd.tar.lz nixlib-89bcf4b7e23f52af03acd81f70cd13deb9b033fd.tar.xz nixlib-89bcf4b7e23f52af03acd81f70cd13deb9b033fd.tar.zst nixlib-89bcf4b7e23f52af03acd81f70cd13deb9b033fd.zip |
Merge pull request #82353 from Ma27/nextcloud-upgrade-path
nixos/nextcloud: fix upgrade path from 19.09 to 20.03
Diffstat (limited to 'nixos/doc/manual')
-rw-r--r-- | nixos/doc/manual/release-notes/rl-2003.xml | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/nixos/doc/manual/release-notes/rl-2003.xml b/nixos/doc/manual/release-notes/rl-2003.xml index e5351519f8da..02d05dec0a2b 100644 --- a/nixos/doc/manual/release-notes/rl-2003.xml +++ b/nixos/doc/manual/release-notes/rl-2003.xml @@ -648,6 +648,55 @@ auth required pam_succeed_if.so uid >= 1000 quiet <xref linkend="opt-environment.systemPackages"/>. </para> </listitem> + <listitem> + <para> + <package>nextcloud</package> has been updated to <literal>v18.0.2</literal>. This means + that users from NixOS 19.09 can't upgrade directly since you can only move one version + forward and 19.09 uses <literal>v16.0.8</literal>. + </para> + <para> + To provide a safe upgrade-path and to circumvent similar issues in the future, the following + measures were taken: + <itemizedlist> + <listitem> + <para> + The <package>pkgs.nextcloud</package>-attribute has been removed and replaced with + versioned attributes (currently <package>pkgs.nextcloud17</package> and + <package>pkgs.nextcloud18</package>). With this change major-releases can be backported + without breaking stuff and to make upgrade-paths easier. + </para> + </listitem> + <listitem> + <para> + Existing setups will be detected using + <link linkend="opt-system.stateVersion">system.stateVersion</link>: by default, + <package>nextcloud17</package> will be used, but will raise a warning which notes + that after that deploy it's recommended to update to the latest stable version + (<package>nextcloud18</package>) by declaring the newly introduced setting + <link linkend="opt-services.nextcloud.package">services.nextcloud.package</link>. + </para> + </listitem> + <listitem> + <para> + Users with an overlay (e.g. to use <package>nextcloud</package> at version + <literal>v18</literal> on <literal>19.09</literal>) will get an evaluation error + by default. This is done to ensure that our + <link linkend="opt-services.nextcloud.package">package</link>-option doesn't select an + older version by accident. It's recommended to use <package>pkgs.nextcloud18</package> + or to set <link linkend="opt-services.nextcloud.package">package</link> to + <package>pkgs.nextcloud</package> explicitly. + </para> + </listitem> + </itemizedlist> + </para> + <warning> + <para> + Please note that if you're comming from <literal>19.03</literal> or older, you have + to manually upgrade to <literal>19.09</literal> first to upgrade your server + to Nextcloud v16. + </para> + </warning> + </listitem> </itemizedlist> </section> |