Host Decommission: Incomplete Platform9 Cleanup

Problem

After executing the command pcdctl decommission-node --force on host, the following packages weren't cleanly removed/still present in the host :

Decommissioned Host
    
 
$ systemctl list-units --all | grep pf9● pf9-libvirt-exporter.service                 not-found   inactive   dead      pf9-libvirt-exporter.service● pf9-neutron-ovn-metadata-agent.service       not-found   active     running   pf9-neutron-ovn-metadata-agent.service● pf9-node-exporter.service                    not-found   inactive   dead      pf9-node-exporter.service● pf9-prometheus.service                       not-found   inactive   dead      pf9-prometheus.service● pf9-remote-write.service                     not-found   inactive   dead      pf9-remote-write.service● pf9-sidekick.service                         not-found   inactive   dead      pf9-sidekick.service
Copy

Environment

Component - pcdctl

Answer

This is a known issue; the Platform9 team has filed the bug PCD-3504 to address the issue.

The fix for this issue is expected to be available in the v2025.12 December release.

Workaround

The workaround is to manually clean the stale packages using the below steps:

Disable the affected service from the impacted host:

Affected host
    
xxxxxxxxxx
 
sudo systemctl disable pf9-libvirt-exporter pf9-node-exporter pf9-prometheus pf9-remote-write pf9-sidekick 2>/dev/null
Copy

Try to stop if any of the services are stoppable:

Affected Host
    
xxxxxxxxxx
 
sudo systemctl stop pf9-libvirt-exporter pf9-node-exporter pf9-prometheus pf9-remote-write pf9-sidekick 2>/dev/null
Copy

Remove unit files and drop-ins (common locations)

Affected Host
    
xxxxxxxxxx
 
sudo rm -f /etc/systemd/system/pf9-libvirt-exporter.service sudo rm -f /etc/systemd/system/pf9-node-exporter.service sudo rm -f /etc/systemd/system/pf9-prometheus.service sudo rm -f /etc/systemd/system/pf9-remote-write.service sudo rm -f /etc/systemd/system/pf9-sidekick.service
Copy

Drop-in directories if present:

Affected Host
    
xxxxxxxxxx
 
sudo rm -rf /etc/systemd/system/pf9-libvirt-exporter.service.d sudo rm -rf /etc/systemd/system/pf9-node-exporter.service.d sudo rm -rf /etc/systemd/system/pf9-prometheus.service.d sudo rm -rf /etc/systemd/system/pf9-remote-write.service.d sudo rm -rf /etc/systemd/system/pf9-sidekick.service.d
Copy

Reload systemd state

Affected Host
    
xxxxxxxxxx
 
sudo systemctl daemon-reloadsystemctl list-units --all | grep pf9
Copy

Purge leftover packages

Affected Host
    
xxxxxxxxxx
 
sudo apt-get purge -y pf9-libvirt-exporter pf9-node-exporter pf9-prometheus pf9-remote-write pf9-sidekick || true sudo apt-get autoremove -ysudo apt-get autoclean
Copy

Remove residual binaries/configs

Affected Host
    
xxxxxxxxxx
 
sudo rm -f /etc/systemd/system/pf9-.timer sudo rm -f /etc/systemd/system/pf9-.socketsudo systemctl daemon-reload sudo systemctl reset-failed
Copy

Verify if the stale packages are cleaned up using:

Affected Host
    
xxxxxxxxxx
 
systemctl list-units --all | grep pf9
Copy

Last updated on

Was this page helpful?