Uninstall or downgrade Cluster Validation Suite (CVS) on ROCm

Uninstall or downgrade Cluster Validation Suite (CVS) on ROCm#

2026-09-24

4 min read time

Applies to Linux

These steps remove or roll back the CVS CLI on the head node. They don’t uninstall ROCm, drivers, or packages on cluster workers.

Identify how CVS was installed#

To identify how CVS was installed, use these commands from the cloned CVS on the head node (they don’t require an active venv):

Command

Installation via

ls .cvs_venv/bin/cvs

Makefile (make install) if the command is succesful

ls <venv>/bin/cvs

pip into a virtual environment if the command succeeds for a venv you created

docker images cvs

Docker image if the command lists cvs:local (or the tag you used)

If a venv is already active, you can also run:

which cvs
pip show cvs

Typical which cvs paths when a venv is active:

  • .../cvs/.cvs_venv/bin/cvs — Makefile

  • Another .../bin/cvs path — custom pip venv

Note

which cvs only works if a virtual environment is already active (or cvs is otherwise on PATH). An empty result often means the venv is not activated, not that CVS is missing.

Uninstall CVS#

If installed with make install#

Deactivate the environment, then remove the venv that make install created:

deactivate
cd /path/to/cvs/source
rm -rf .cvs_venv
which cvs

Expected output after a successful removal:

$ which cvs
$

cvs is no longer on PATH. Delete the clone if you no longer need the source tree.

If installed with pip in a custom venv#

pip uninstall cvs
which cvs

Expected output:

Found existing installation: cvs 0.2.0
Uninstalling cvs-0.2.0:
  Successfully uninstalled cvs-0.2.0

$ which cvs
$

Then deactivate and remove the venv directory if you no longer need it.

If installed as a Docker image#

Stop a named container if you created one, then remove the image:

docker rm -f cvs-head
docker rmi cvs:local
docker images cvs

Expected output:

Untagged: cvs:local
Deleted: sha256:...

$ docker images cvs
REPOSITORY   TAG   IMAGE ID   CREATED   SIZE

Downgrade CVS#

CVS is installed from source. To move to an older release, check out that version and reinstall with the same method you originally used.

Example using make install:

cvs --version
cd /path/to/cvs/source
git fetch origin
git checkout <older-version>
make install
source .cvs_venv/bin/activate
cvs --version

Expected output:

$ cvs --version
0.2.0
...
$ cvs --version
0.1.0

Use pip install dist/cvs*.tar.gz or docker build --tag cvs:local . instead if that is how you originally installed CVS.

Next steps#

Contents