Cómo quitar un nodo del cluster Proxmox que ya no tiene VMs ni CTs: guía completa y segura

Si administras un cluster Proxmox VE, puede que en algún momento necesites eliminar un nodo que ya no tiene máquinas virtuales (VMs) ni contenedores (CTs). Hacerlo de manera correcta garantiza que el cluster siga estable y evita errores graves.

Esta guía paso a paso te enseñará cómo quitar un nodo del cluster Proxmox de forma segura, sin tocar archivos críticos del sistema, y con todas las buenas prácticas incluidas.

---

Índice

1. Por qué eliminar un nodo del cluster
2. Paso 1: Verificar que el nodo no tenga VMs ni CTs
3. Paso 2: Comprobar el estado del cluster
4. Paso 3: Eliminar el nodo del cluster
5. Paso 4: Limpiar el nodo eliminado de forma segura
6. Paso 5: Verificar la estabilidad del cluster
7. Consideraciones finales y buenas prácticas
8. Preguntas frecuentes

Por qué eliminar un nodo del cluster

Hay varias razones para quitar un nodo de Proxmox:

• El nodo ya no tiene VMs ni CTs, por lo que su permanencia es innecesaria.
• Necesitas reutilizar el hardware para otro proyecto o cluster.
• Deseas simplificar la administración del cluster y reducir la complejidad.
• Problemas de hardware o configuración que hacen que mantenerlo sea más costoso que eliminarlo.

⚠️ Nunca elimines un nodo sin revisar que el cluster tenga suficientes nodos activos para mantener el quorum.

Paso 1: Verificar que el nodo no tenga VMs ni CTs

Antes de eliminar un nodo, asegúrate de que no tenga cargas activas:

# Listar VMs
qm list

# Listar contenedores
pct list

Si las listas están vacías, el nodo está listo para eliminarse.

🔹 Consejo: Si hay VMs o CTs, migra o elimina las que no necesites. Eliminar un nodo con cargas activas puede provocar pérdida de datos.

Paso 2: Comprobar el estado del cluster

Desde cualquier nodo activo del cluster, verifica el estado:

pvecm status

Esto mostrará:

• Número de nodos en el cluster (Nodes)
• Estado del quorum
• ID y nombre de cada nodo

Ejemplo de salida:

pvecm status
Cluster information
-------------------
Name:             pve
Config Version:   5
Transport:        knet
Secure auth:      on

Quorum information
------------------
Date:             Wed Jan 21 18:49:46 2026
Quorum provider:  corosync_votequorum
Nodes:            3
Node ID:          0x00000001
Ring ID:          1.31c50
Quorate:          Yes

Votequorum information
----------------------
Expected votes:   3
Highest expected: 3
Total votes:      3
Quorum:           2  
Flags:            Quorate 

Membership information
----------------------
    Nodeid      Votes Name
0x00000001          1 192.168.1.2 (local)
0x00000002          1 192.168.1.3
0x00000003          1 192.168.1.4

🔹 Verifica que haya al menos un nodo activo además del que vas a eliminar para mantener el quorum.

Paso 3: Eliminar el nodo del cluster

Para eliminar un nodo llamado nodo3 desde otro nodo activo:

pvecm delnode nodo3

Esto:

• Elimina la configuración del nodo del cluster (/etc/pve/nodes/) de manera segura
• Actualiza la base de datos distribuida del cluster
• Mantiene el cluster estable

⚠️ Recomendación: Apaga el nodo antes de eliminarlo:

ssh root@nodo3 "shutdown now"

Paso 4: Limpiar el nodo eliminado de forma segura

Si quieres reutilizar el nodo fuera del cluster, hazlo así:

1. Detener los servicios relacionados con el cluster:

systemctl stop pve-cluster
systemctl stop corosync
systemctl stop pvedaemon

2. Limpiar datos locales del cluster (no tocar /etc/pve):

rm -rf /var/lib/pve-cluster
rm -rf /var/lib/corosync/*

3. Reinicia el nodo y estará listo como servidor independiente o para instalar Proxmox de nuevo.

✅ Importante: No intentes borrar archivos dentro de /etc/pve. Esta carpeta está gestionada por el cluster y PMXCFS, y borrarla manualmente puede romper la configuración de los demás nodos.

Paso 5: Verificar la estabilidad del cluster

Después de eliminar el nodo, revisa que el cluster sigue operativo:

pvecm status
pvecm nodes

• Asegúrate de que el nodo eliminado ya no aparezca
• Comprueba que el quorum siga activo
• Confirma que los nodos restantes estén en línea y funcionando correctamente

🔹 También puedes revisar los logs si hay dudas:

journalctl -xe | grep pve

Consideraciones finales y buenas prácticas

1. Respaldos: Haz backup del cluster antes de eliminar nodos.
2. Almacenamiento compartido: Verifica que otros nodos sigan teniendo acceso a los volúmenes compartidos (NFS, ZFS, Ceph).
3. Quorum: Nunca elimines un nodo si el cluster ya está justo en el mínimo de quorum.
4. Documentación: Mantén un registro de todos los cambios para auditoría y recuperación.
5. Reutilización: Después de la limpieza, el nodo puede reinstalarse para otro cluster o uso independiente.

Preguntas frecuentes sobre eliminar nodos en Proxmox

1. ¿Puedo eliminar un nodo con VMs o CTs?
No. Primero migra o elimina todas las VMs y CTs.

2. ¿Es necesario apagar el nodo antes de eliminarlo del cluster?
Sí. Evita conflictos y errores en la base de datos del cluster.

3. ¿Qué pasa si el cluster queda sin quorum?
El cluster puede quedar inoperativo. Siempre verifica el quorum antes de eliminar nodos.

4. ¿Se eliminan los datos de almacenamiento local del nodo?
No. Solo se eliminan las referencias al nodo en el cluster. Los datos locales permanecen intactos.

Conclusión

Eliminar un nodo de Proxmox que ya no tiene VMs ni CTs es seguro si:

• Verificas que el nodo esté vacío
• Compruebas el estado y quorum del cluster
• Usas pvecm delnode desde otro nodo
• Detienes servicios y limpias datos locales de forma segura
• Revisas la estabilidad del cluster restante

Siguiendo estos pasos, puedes mantener tu cluster estable y reutilizar nodos sin riesgo de corrupción.