Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add section about rpm upgrades #141

Merged
merged 1 commit into from
Jan 8, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 43 additions & 1 deletion docs/upgrade/manual_upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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.
Expand Down