Skip to main content

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>.