summaryrefslogtreecommitdiff
path: root/RELEASE_NOTES.md
diff options
context:
space:
mode:
Diffstat (limited to 'RELEASE_NOTES.md')
-rw-r--r--RELEASE_NOTES.md14
1 files changed, 13 insertions, 1 deletions
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0370618757..cf162cb7e5 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -6,9 +6,21 @@ Chef 15 release notes will be added here as development progresses.
## Breaking Changes
+### Chef packages now remove /opt/chef before installation
+
+The intent of this change is that on upgrading packages the /opt/chef directory is removed of any `chef_gem` installed gem versions and other
+modifications to /opt/chef that might be preserved and cause issues on upgrades. Due to technical details with rpm script execution order
+the way this was implemented was that a pre-installation script wipes /opt/chef before every install (done consistently this way on
+every package manager).
+
+Users who are properly managing customizations to /opt/chef through Chef recipes won't be affected, because their customizations will still be installed by
+the new chef-client package.
+
+You'll see a warning that the /opt/chef directory will be removed during the package installation process.
+
### Package provider allow_downgrade is now true by default
-We reversed the default behavior to `allow_downgrade true` for our package providers. To override this setting to refuse downgrades, use the `allow_downgrade —false` flag. This behavior change will mostly affect users of the rpm and zypper package providers.
+We reversed the default behavior to `allow_downgrade true` for our package providers. To override this setting to prevent downgrades, use the `allow_downgrade false` flag. This behavior change will mostly affect users of the rpm and zypper package providers.
```
package "foo" do