diff --git a/modules/deploy/partials/linux/install-redpanda.adoc b/modules/deploy/partials/linux/install-redpanda.adoc index 2500efc719..91585263ce 100644 --- a/modules/deploy/partials/linux/install-redpanda.adoc +++ b/modules/deploy/partials/linux/install-redpanda.adoc @@ -31,6 +31,39 @@ curl -1sLf 'https://dl.redpanda.com/nzc4ZYQK3WRGd9sy/redpanda/cfg/setup/bash.rpm sudo -E bash && sudo yum install redpanda -y ---- +[IMPORTANT] +==== +To install a version of Redpanda that is older than the latest available version, you must also specify each dependency. For example, if installing `24.3.1~rc1-1` and you fail to specify each package and its version, you may encounter the following error: + +[source,bash] +---- +yum install redpanda=24.3.1~rc1-1 +Reading package lists... Done +Building dependency tree... Done +Reading state information... Done +Some packages could not be installed. This may mean that you have +requested an impossible situation or if you are using the unstable +distribution that some required packages have not yet been created +or been moved out of Incoming. +The following information may help to resolve the situation: + +The following packages have unmet dependencies: + redpanda : Depends: redpanda-rpk (= 24.3.1~rc1-1) but it is not going to be installed or + redpanda-rpk-fips (= 24.3.1~rc1-1) but it is not going to be installed + Depends: redpanda-tuner (= 24.3.1~rc1-1) but it is not going to be installed +E: Unable to correct problems, you have held broken packages. +---- +To troubleshoot this error, specify the full list of versions for each package. In this case: + +[source,bash] +---- +yum install \ + redpanda-tuner=24.3.1~rc1-1 \ + redpanda-rpk=24.3.1~rc1-1 \ + redpanda=24.3.1~rc1-1 +---- +==== + -- Debian/Ubuntu:: + @@ -41,5 +74,38 @@ curl -1sLf 'https://dl.redpanda.com/nzc4ZYQK3WRGd9sy/redpanda/cfg/setup/bash.deb sudo -E bash && sudo apt install redpanda -y ---- +[IMPORTANT] +==== +To install a version of Redpanda that is older than the latest available version, you must also specify each dependency. For example, if installing `24.3.1~rc1-1` and you fail to specify each package and its version, you may encounter the following error: + +[source,bash] +---- +apt install redpanda=24.3.1~rc1-1 +Reading package lists... Done +Building dependency tree... Done +Reading state information... Done +Some packages could not be installed. This may mean that you have +requested an impossible situation or if you are using the unstable +distribution that some required packages have not yet been created +or been moved out of Incoming. +The following information may help to resolve the situation: + +The following packages have unmet dependencies: + redpanda : Depends: redpanda-rpk (= 24.3.1~rc1-1) but it is not going to be installed or + redpanda-rpk-fips (= 24.3.1~rc1-1) but it is not going to be installed + Depends: redpanda-tuner (= 24.3.1~rc1-1) but it is not going to be installed +E: Unable to correct problems, you have held broken packages. +---- +To troubleshoot this error, specify the full list of versions for each package. In this case: + +[source,bash] +---- +apt install \ + redpanda-tuner=24.3.1~rc1-1 \ + redpanda-rpk=24.3.1~rc1-1 \ + redpanda=24.3.1~rc1-1 +---- +==== -- -===== \ No newline at end of file +===== +