From b32c2d83052e9b425a5959bed40ca03bcfdb5780 Mon Sep 17 00:00:00 2001 From: Paul Broadwith Date: Fri, 4 Aug 2023 15:49:04 +0100 Subject: [PATCH] (doc) Add notes on downgrading to latest 1.x / 5.x --- .../en-us/guides/upgrading-to-chocolatey-v2-v6.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/input/en-us/guides/upgrading-to-chocolatey-v2-v6.md b/input/en-us/guides/upgrading-to-chocolatey-v2-v6.md index 1fbe7d79e9..e9c9610e3f 100644 --- a/input/en-us/guides/upgrading-to-chocolatey-v2-v6.md +++ b/input/en-us/guides/upgrading-to-chocolatey-v2-v6.md @@ -32,6 +32,19 @@ We have listed the bug fixes, features and improvements below that we feel you s When you run the [Chocolatey CLI install command](https://chocolatey.org/install), you are installing the latest version of Chocolatey CLI each time. To install a specific version, set the environment variable `chocolateyVersion` before running the installation command. See the [documentation for more information](https://docs.chocolatey.org/en-us/choco/setup#installing-a-particular-version-of-chocolatey). +### Downgrading to the Latest 1.x and 5.x Stable Chocolatey Product Versions + +If you have issues after upgrading to the 2.x and 6.x versions of Chocolatey products, please see the [support options available](#what-should-you-do-if-you-have-questions). + +Before downgrading from 2.x and 6.x to 1.x and 5.x of Chocolatey products, please ensure that you understand the [Support Lifecycle](xref:chocolatey-components-dependencies-and-support-lifecycle). If you still want to downgrade, follow the steps below: + +1. If you have Chocolatey GUI and / or Chocolatey GUI Licensed Extension, then uninstall them by running `choco uninstall chocolateygui.extension chocolateygui` from an elevated session. +1. This step requires you to downgrade products depending on what you have installed. + 1. If you have Chocolatey Agent installed, downgrade it by running `choco upgrade chocolatey-agent --version=1.1.2 --allow-downgrade` from an elevated session. Note that this will also downgrade both Chocolatey CLI and Chocolatey Licensed Extension. + 1. If you have Chocolatey Licensed Extension installed, downgrade it by running `choco upgrade chocolatey.extension --version 5.0.3 --allow-downgrade` from an elevated session. Note that this will also downgrade Chocolatey CLI. + 1. If you _only_ have Chocolatey CLI installed, downgrade it by running `choco upgrade chocolatey --version 1.4.0 --allow-downgrade` from an elevated session. +1. If you uninstalled Chocolatey GUI and / or Chocolatey GUI Licensed Extension, then install the latest 1.x versions by running `choco install chocolateygui.extension -y --version=1.0.3`. + ### Sonatype Nexus Repository Sources The Sonatype Nexus Repository Manager has an [issue that can cause it to go into an infinite loop of querying for packages from a NuGet v2 feed](https://issues.sonatype.org/browse/NEXUS-13426) (you will need a login for the Sonatype Jira system to view the issue). The only affects Sonatype Nexus NuGet v2 feeds as it has been fixed for NuGet v3 feeds. @@ -127,7 +140,7 @@ If you need side-by-side functionality, or cannot uninstall packages installed s ### The List Command Now Lists Local Packages Only and the `--local-only` and `-lo` Options Have Been Removed -In version 1.0.0 of Chocolatey CLI, we added notices that the `choco list` command will list only local packages, and deprecated the `-l` and it's alias options. See this [GitHub issue for more information](https://github.com/chocolatey/choco/issues/158). We have also removed the `-a` and it's alias options from the `list` command as it no longer made sense to have that option once side-by-side installs were removed. +In version 1.0.0 of Chocolatey CLI, we added notices that the `choco list` command will list only local packages, and deprecated the `-l` and its alias options. See this [GitHub issue for more information](https://github.com/chocolatey/choco/issues/158). We have also removed the `-a` and its alias options from the `list` command as it no longer made sense to have that option once side-by-side installs were removed. To summarize, the following options were removed: