From 2d2a97769cf0ecb736cb922982b333a72f4c00e0 Mon Sep 17 00:00:00 2001 From: galal-hussein Date: Wed, 3 Jan 2024 22:18:45 +0200 Subject: [PATCH] Add section about rpm upgrades Signed-off-by: galal-hussein --- docs/upgrade/manual_upgrade.md | 44 +++++++++++++++++++++++++++++++++- 1 file changed, 43 insertions(+), 1 deletion(-) diff --git a/docs/upgrade/manual_upgrade.md b/docs/upgrade/manual_upgrade.md index 6488e155..19a76a68 100644 --- a/docs/upgrade/manual_upgrade.md +++ b/docs/upgrade/manual_upgrade.md @@ -3,7 +3,7 @@ title: Manual Upgrades --- -You can upgrade rke2 by using the installation script, or by manually installing the binary of the desired version. +You can upgrade rke2 by using the installation script, by manually installing the binary of the desired version, or by using rpm upgrades in case of rpm installation. >**Note:** Upgrade the server nodes first, one at a time. Once all servers have been upgraded, you may then upgrade agent nodes. @@ -68,6 +68,48 @@ Or to manually upgrade rke2: 3. Stop the old rke2 binary 4. Launch the new rke2 binary +### Upgrade rke2 Using the RPM upgrades + +In case of RPM installation, its expected to upgrade rke2 from an older version using rpm upgrades, for example: + +```sh +# zypper upgrade +zypper update rke2-server +``` + +```sh +yum update rke2-server +``` +This will upgrade `rke2-server` rpm package to the latest package in your channel which is configured initially in the yum or zypper repos by the install script at the initial installation. + +If upgrading agent nodes, you should specify name of the `rke2-agent` package + +```sh +# zypper upgrade +zypper update rke2-agent +``` + +```sh +# yum upgrade +yum update rke2-agent +``` + +Remember to restart the rke2 process after installing: + +```sh +# Server nodes: +systemctl restart rke2-server + +# Agent nodes: +systemctl restart rke2-agent +``` + +**Note**: in case you enabled `rke2-selinux` you should also be able to upgrade rke2-selinux to the latest version using: + +```sh +yum update rke2-selinux +``` + ### Restarting rke2 Restarting rke2 is supported by the installation script for systemd.