From 67f7a4b0b94ea25f9508707a31879aeb03d81dc9 Mon Sep 17 00:00:00 2001 From: Lamont Granquist Date: Tue, 20 Nov 2018 15:28:11 -0800 Subject: add a RELEASE_NOTE on /opt/chef wiping this is certainly worth documenting. Signed-off-by: Lamont Granquist --- RELEASE_NOTES.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index a4aca19c26..07b98e247f 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 +### Omnibus chef packages now wipe /opt/chef before installation + +The intent of this is that on upgrading packages the /opt/chef directory is wiped of any stray `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). + +This will not affect anyone who is properly managing customizations to /opt/chef via chef recipes itself since they will be installed by +the new chef-client package. + +The package installation emits a message that /opt/chef is being removed to inform the user that this action is taking place. + ### 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 ignore downgrades, use the `allow_downgrade false` flag. This behavior change will mostly affect users of the rpm and zypper package providers. ``` package "foo" do -- cgit v1.2.1 From 791d6db3cefa860bafef06c62dd74d6bae2aaaaa Mon Sep 17 00:00:00 2001 From: Lamont Granquist Date: Tue, 20 Nov 2018 15:30:09 -0800 Subject: tweaks Signed-off-by: Lamont Granquist --- RELEASE_NOTES.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 07b98e247f..ec568fc199 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -6,14 +6,14 @@ Chef 15 release notes will be added here as development progresses. ## Breaking Changes -### Omnibus chef packages now wipe /opt/chef before installation +### Omnibus chef packages now removes /opt/chef before installation -The intent of this is that on upgrading packages the /opt/chef directory is wiped of any stray `chef_gem` installed gem versions and other +The intent of this is that on upgrading packages the /opt/chef directory is removed of any stray `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). -This will not affect anyone who is properly managing customizations to /opt/chef via chef recipes itself since they will be installed by +This will not affect any user who is properly managing customizations to /opt/chef via chef recipes itself since they will be installed by the new chef-client package. The package installation emits a message that /opt/chef is being removed to inform the user that this action is taking place. -- cgit v1.2.1 From 8deab370b8f117f86c61baaee70144c39787c6ba Mon Sep 17 00:00:00 2001 From: Lamont Granquist Date: Tue, 20 Nov 2018 15:30:45 -0800 Subject: another tweak Signed-off-by: Lamont Granquist --- RELEASE_NOTES.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index ec568fc199..e5604af2c4 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -8,7 +8,7 @@ Chef 15 release notes will be added here as development progresses. ### Omnibus chef packages now removes /opt/chef before installation -The intent of this is that on upgrading packages the /opt/chef directory is removed of any stray `chef_gem` installed gem versions and other +The intent of this change is that on upgrading packages the /opt/chef directory is removed of any stray `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). -- cgit v1.2.1 From 4ddb5704d8e32930f88f6fca4ff3411a97216ed0 Mon Sep 17 00:00:00 2001 From: Lamont Granquist Date: Tue, 20 Nov 2018 15:31:23 -0800 Subject: another word tweak on this block Signed-off-by: Lamont Granquist --- RELEASE_NOTES.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index e5604af2c4..aa226bdcac 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -20,7 +20,7 @@ The package installation emits a message that /opt/chef is being removed to info ### 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 ignore 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 -- cgit v1.2.1 From b398079d6e8e1061521fdd5d5b27c58bcac93fc9 Mon Sep 17 00:00:00 2001 From: Lamont Granquist Date: Tue, 20 Nov 2018 15:41:55 -0800 Subject: scrub omnibus word Signed-off-by: Lamont Granquist --- RELEASE_NOTES.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index aa226bdcac..ba555f90d1 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -6,7 +6,7 @@ Chef 15 release notes will be added here as development progresses. ## Breaking Changes -### Omnibus chef packages now removes /opt/chef before installation +### 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 stray `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 -- cgit v1.2.1 From 348e82d93ddf0abb401ae748a5c8d6be41862189 Mon Sep 17 00:00:00 2001 From: Lamont Granquist Date: Mon, 26 Nov 2018 15:14:40 -0800 Subject: notes from code review Signed-off-by: Lamont Granquist --- RELEASE_NOTES.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index ba555f90d1..797154c732 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -8,15 +8,15 @@ Chef 15 release notes will be added here as development progresses. ### 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 stray `chef_gem` installed gem versions and other +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). -This will not affect any user who is properly managing customizations to /opt/chef via chef recipes itself since they will be installed by +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. -The package installation emits a message that /opt/chef is being removed to inform the user that this action is taking place. +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 -- cgit v1.2.1