Upgrading the Agent
This page covers upgrading an existing Stealthium agent to the current release. If you are installing for the first time, use the Installation page instead.
The commands below reuse the package, image, and chart names from the Installation page. An upgrade does not change the run flags or chart values, so reuse the ones you installed with.
Upgrade
apt (Debian and Ubuntu)
sudo apt-get update
sudo apt-get install -y --only-upgrade stealthium
sudo systemctl restart stealthium
RPM (Enterprise Linux)
There is no dnf repository yet, so upgrade by hand. Get the newer stealthium
RPM for your EL version and architecture from your Stealthium contact, then upgrade
and restart the service:
sudo dnf upgrade ./stealthium-<version>.el9.x86_64.rpm
sudo systemctl restart stealthium
Docker
docker pull registry.backend.stealthium.io/stealthium/release:latest
docker rm -f stealthium-agent
Then re-run the container with the same flags from the Installation page (privileged, host PID, and the same volume mounts and environment).
The image is published as :latest. For a repeatable deployment, record the image
digest after pulling so you can redeploy the same build:
docker image inspect registry.backend.stealthium.io/stealthium/release:latest \
--format '{{index .RepoDigests 0}}'
Helm
Re-run the same helm upgrade --install you installed with. Add --reuse-values so
your API key and registry credentials are preserved:
helm upgrade --install stealthium-agent \
oci://registry.backend.stealthium.io/stealthium/release/stealthium-agent \
--namespace stealthium \
--reuse-values
The agent runs as a DaemonSet with a RollingUpdate strategy and maxUnavailable: 1,
so the upgrade rolls one node at a time. Watch it finish with:
kubectl -n stealthium rollout status ds/stealthium-agent
Verify
apt
dpkg -l stealthium
systemctl status stealthium
RPM (Enterprise Linux)
rpm -q stealthium
systemctl status stealthium
Docker
docker inspect --format '{{.Config.Image}}' stealthium-agent
docker ps
Helm
helm list -n stealthium
kubectl -n stealthium get pods
Rollback
If an upgrade misbehaves, pin back to a known-good version.
apt
apt list -a stealthium # list available versions
sudo apt-get install -y --allow-downgrades stealthium=<version>
sudo systemctl restart stealthium
sudo apt-mark hold stealthium # stop it moving until you unhold
Release the hold later with sudo apt-mark unhold stealthium.
RPM (Enterprise Linux)
Get the known-good stealthium RPM from your Stealthium contact and downgrade to it:
sudo dnf downgrade ./stealthium-<version>.el9.x86_64.rpm
sudo systemctl restart stealthium
To hold the version, install the versionlock plugin and lock the package:
sudo dnf install python3-dnf-plugin-versionlock
sudo dnf versionlock add stealthium
Remove the lock later with sudo dnf versionlock delete stealthium.
Docker
Recreate the container from a known-good image. If you recorded a digest, re-pull by digest; otherwise use the prior release tag if your registry exposes one.
Helm
helm history stealthium-agent -n stealthium # find the good revision
helm rollback stealthium-agent <revision> -n stealthium
Or re-run helm upgrade --install with --version <older-version>.