Skip to content

uninstall.md

Latest commit

 

History

History
171 lines (119 loc) · 4.01 KB

uninstall.md

File metadata and controls

171 lines (119 loc) · 4.01 KB
Raw

Uninstall CHV

This guide explains how to safely remove CHV packages while preserving or deleting data.

Standard removal (data preserved)

The default package removal intentionally preserves all persistent state. This prevents accidental data loss.

Debian / Ubuntu

sudo dpkg -r chv-node chv-controlplane chvctl
sudo apt-get autoremove

RHEL / Rocky / AlmaLinux

sudo rpm -e chv-node chv-controlplane chvctl

What is preserved

After standard removal, the following remain on disk:

Path Contents Preserved?
/var/lib/chv SQLite database, agent cache, storage volumes, images ✅ Yes
/etc/chv Configuration files (*.toml, certs, bootstrap token) ✅ Yes
/var/log/chv Service logs ✅ Yes
chv user and group System user ✅ Yes

What is removed

Path Contents Removed?
/usr/bin/chv* Binaries ✅ Yes
/lib/systemd/system/chv-*.service Systemd units ✅ Yes
/usr/share/chv UI assets, migrations ✅ Yes

Verify removal

# Binaries should be gone
which chvctl          # should return nothing
which chv-agent       # should return nothing

# Data should still exist
ls -la /var/lib/chv   # should show contents
ls -la /etc/chv       # should show contents

# User should still exist
getent passwd chv     # should show chv user
getent group chv      # should show chv group

Reinstall after removal

Because data is preserved, you can reinstall CHV and resume operation:

# Debian/Ubuntu
sudo dpkg -i chv-controlplane_0.1.0_amd64.deb chv-node_0.1.0_amd64.deb chvctl_0.1.0_amd64.deb

# RHEL/Rocky/Alma
sudo rpm -i chv-controlplane-0.1.0-1.x86_64.rpm chv-node-0.1.0-1.x86_64.rpm chvctl-0.1.0-1.x86_64.rpm

# Start services
sudo systemctl daemon-reload
sudo systemctl enable --now chv-controlplane chv-agent chv-stord chv-nwd

Your previous database, caches, and configs will be intact.

Complete removal (destructive)

⚠️ WARNING: This procedure permanently destroys all CHV data. Back up anything you need before proceeding.

1. Stop services

sudo systemctl stop chv-controlplane chv-agent chv-stord chv-nwd

2. Remove packages

# Debian/Ubuntu
sudo dpkg -r chv-node chv-controlplane chvctl
sudo apt-get autoremove

# RHEL/Rocky/Alma
sudo rpm -e chv-node chv-controlplane chvctl

3. Delete persistent data

sudo rm -rf /var/lib/chv
sudo rm -rf /etc/chv
sudo rm -rf /var/log/chv

4. Remove user and group

sudo userdel chv
sudo groupdel chv

5. Clean up runtime directories

sudo rm -rf /run/chv

6. Remove systemd state (if any lingering units)

sudo systemctl daemon-reload
sudo systemctl reset-failed

What to back up before removal

If you plan to reinstall or migrate CHV, back up these paths before removal:

# Back up everything
sudo tar -czf chv-backup-$(date +%Y%m%d).tar.gz /var/lib/chv /etc/chv /var/log/chv

Critical files to back up:

  • /var/lib/chv/controlplane.db — control plane database
  • /var/lib/chv/agent-cache.json — agent enrollment state
  • /var/lib/chv/storage/ — volume data and images
  • /etc/chv/certs/ — TLS certificates
  • /etc/chv/bootstrap.token — enrollment token (if still needed)

Troubleshooting

userdel: user chv is currently used by process ...

If the chv user is still referenced by running processes:

# Find and stop any lingering processes
sudo ps aux | grep chv
sudo kill -9 <pid>

# Retry user deletion
sudo userdel chv

Files remain after rm -rf

If files in /var/lib/chv are locked by a kernel module or container:

# Check for open file handles
sudo lsof +D /var/lib/chv

# Unmount any bind mounts
sudo umount /var/lib/chv/* 2>/dev/null || true

See also