Proxmox Cluster HA: Checklist Completa Installazione e Verifica (2026)

Un cluster Proxmox HA installato in produzione. Failover testato in ambiente di test. Mai testato in produzione. Al primo nodo che cade, le VM rimangono bloccate per 45 minuti perché il quorum non era configurato correttamente. Questo è uno scenario reale, un’esperienza diretta che evidenzia quanto sia critico non solo installare un cluster Proxmox HA, ma anche verificarne ogni singolo aspetto. L’alta disponibilità non è un’opzione, è una necessità per qualsiasi ambiente enterprise che gestisce carichi di lavoro mission-critical. Se un cluster non funziona come previsto durante un’emergenza, il suo valore è nullo. Questa guida fornisce una checklist dettagliata per l’installazione e la verifica di un cluster Proxmox HA, basata su anni di esperienza sul campo con centinaia di VM.

Prerequisiti: Rete Dedicata e NTP Sincronizzato

Prima di addentrarci nell’installazione vera e propria, è fondamentale preparare l’infrastruttura di base. Due aspetti sono cruciali per la stabilità e l’affidabilità di un cluster Proxmox HA: la rete dedicata per il traffico del cluster e la perfetta sincronizzazione temporale tra tutti i nodi.

Rete dedicata per il traffico del cluster

Il traffico di heartbeat e Corosync, essenziale per la comunicazione tra i nodi e la gestione del quorum, deve essere isolato. Utilizzare una rete separata garantisce che eventuali congestioni sulla rete di gestione o delle VM non influenzino la stabilità del cluster. Idealmente, ogni nodo dovrebbe avere almeno due interfacce di rete fisiche dedicate al traffico Corosync, configurate in un bonding (es. LACP o balance-rr) per la ridondanza e il throughput. In ambienti con 300+ VM, la stabilità della rete cluster è prioritaria. Studi recenti indicano che il 30% degli split-brain in cluster HA è causato da problemi di rete (ClusterLabs Report 2025).

NTP sincronizzato

La precisione temporale è un requisito non negoziabile per il corretto funzionamento del quorum. Un disallineamento anche minimo tra gli orologi dei nodi può portare a problemi di quorum, causando blocchi o split-brain. Configura tutti i nodi Proxmox per sincronizzarsi con server NTP affidabili, preferibilmente interni alla tua rete o pool pubblici come pool.ntp.org. Verifica regolarmente lo stato della sincronizzazione NTP.

Installazione Cluster e Quorum Device

Una volta preparati i prerequisiti, possiamo procedere con la creazione e l’espansione del cluster.

Creazione del cluster

Il primo passo è creare il cluster dal primo nodo. Questo comando inizializza il cluster e lo prepara per l’aggiunta di altri nodi.

pvecm create mycluster

Aggiunta di nodi al cluster

Dopo aver creato il cluster, puoi aggiungere i nodi rimanenti. Assicurati che il firewall sia configurato correttamente per permettere la comunicazione Corosync sulle porte 5404 e 5405 UDP.

pvecm add <ip-nodo1>

Sostituisci con l’indirizzo IP del nodo già membro del cluster. Ripeti per tutti i nodi che desideri aggiungere.

Verifica stato cluster

Dopo aver aggiunto i nodi, verifica lo stato del cluster per assicurarti che tutti i nodi siano online e che il quorum sia stabilito.

pvecm status

Quorum Status e Quorum Device

Il quorum è il meccanismo che previene lo split-brain, assicurando che solo una partizione del cluster possa operare. In un cluster con un numero pari di nodi (specialmente due), un Quorum Device (QDevice) è essenziale. Un QDevice è un host esterno leggero (es. un Raspberry Pi) che agisce come voto aggiuntivo, permettendo al cluster di mantenere il quorum se uno dei due nodi fallisce.

corosync-quorumtool -s

Questo comando ti mostrerà lo stato del quorum. Assicurati che il numero di voti attivi sia sufficiente per mantenere il quorum (Generalmente, (Numero_Nodi / 2) + 1).

Storage Condiviso: Ceph o NFS/iSCSI

Per l’alta disponibilità, le VM devono poter accedere ai loro dischi da qualsiasi nodo del cluster. Questo richiede uno storage condiviso.

Ceph: Soluzione Distribuita

Ceph è una soluzione di storage distribuito integrata nativamente in Proxmox. Offre alta disponibilità, scalabilità e performance. L’installazione di Ceph su Proxmox è relativamente semplice.

pveceph init --network 10.10.10.0/24 # Inizializza Ceph sul nodo corrente
pveceph createmon # Crea un monitor Ceph
pveceph createosd /dev/sdb # Aggiungi un disco come OSD (Object Storage Device)
pveceph createpool vm-storage # Crea un pool per le VM

Ricorda di configurare Ceph su tutti i nodi e di avere almeno 3 OSD per la ridondanza. La stabilità di Ceph è direttamente proporzionale al numero di OSD e alla qualità della rete di interconnessione.

NFS/iSCSI: Storage Esterno

In alternativa a Ceph, puoi utilizzare storage esterni basati su NFS o iSCSI. Assicurati che lo storage sia anch’esso ad alta disponibilità e che i nodi Proxmox abbiano una connettività ridondante all’array di storage. Un singolo punto di fallimento nello storage condiviso vanificherebbe l’HA del cluster Proxmox.

HA Groups e Policy di Failover

Proxmox HA Manager gestisce automaticamente il riavvio delle VM su un nodo funzionante in caso di failure. Puoi definire gruppi HA e policy specifiche.

Configurazione HA Manager

ha-manager status ti darà una panoramica dello stato attuale delle risorse HA. Puoi definire quali VM o container debbano essere gestiti dall’HA e con quali policy (es. max_relocate, max_restart).

ha-manager status

Le HA Groups permettono di raggruppare VM che devono stare sullo stesso nodo o su nodi diversi, prevenendo che un failover sposti tutte le VM critiche su un singolo host, sovraccaricandolo. Questo è particolarmente utile in ambienti con 2.000+ workstation virtualizzate.

Test Failover e Verifica che Funzioni Davvero

Questo è il passo più critico: la verifica pratica che il cluster HA funzioni come previsto. Non basta fidarsi delle configurazioni teoriche.

Test di failover manuale

Simula il failover di una VM per verificare che venga correttamente migrata e riavviata su un altro nodo.

ha-manager crm-command migrate <vmid> <node>

Sostituisci con l’ID della VM e con il nome del nodo di destinazione. Questo è un test controllato. Il vero test è la simulazione di un guasto.

Simulazione di un guasto reale

Scollega la rete da un nodo, spegni un nodo forzatamente. Osserva i tempi di recovery delle VM. Questo è l’unico modo per essere certi che la configurazione HA sia robusta. Misura il tempo di downtime e assicurati che rientri negli SLA previsti. In un ambiente enterprise, un failover deve avvenire in pochi minuti, non in 45.

Monitoring Cluster con Prometheus + Grafana

Un cluster HA senza monitoring proattivo è una bomba a orologeria. Integra Proxmox con Prometheus per la raccolta di metriche e Grafana per la visualizzazione e gli alert. Monitora lo stato del quorum, l’utilizzo delle risorse dei nodi, la latenza dello storage e lo stato delle VM HA. Alert critici per corosync_quorum_votes_total o proxmox_ha_resource_status possono salvarti da un disastro.

Errori Comuni nell’Installazione e Come Evitarli

Mancanza di rete dedicata per Corosync: Causa latenza e instabilità. Soluzione: configura un’interfaccia di rete separata e un bonding.
NTP non sincronizzato: Porta a split-brain. Soluzione: configura server NTP su tutti i nodi e verifica regolarmente.
Quorum insufficiente in cluster a 2 nodi: Il cluster si blocca se un nodo cade. Soluzione: implementa un QDevice.
Storage condiviso non HA: Se lo storage fallisce, fallisce tutto. Soluzione: usa Ceph o storage SAN/NAS con ridondanza.
Mancanza di test di failover reali: La teoria non basta. Soluzione: simula guasti reali e misura i tempi di recovery.
Firewall non configurato correttamente: Blocca il traffico Corosync. Soluzione: apri le porte UDP 5404 e 5405.
Versioni Proxmox non allineate: Problemi di compatibilità. Soluzione: mantieni tutti i nodi alla stessa versione e patch level.

FAQ — Domande Frequenti

Come posso aggiungere un nodo Proxmox a un cluster esistente?

Per aggiungere un nodo, prima installa Proxmox sul nuovo hardware. Poi, dal nodo esistente, crea un join token con pvecm add . Dal nuovo nodo, usa questo token per unirlo al cluster. Assicurati che le impostazioni di rete e NTP siano corrette. La procedura è ben documentata nella documentazione ufficiale di Proxmox.

Qual è la differenza tra HA Group e HA Policy?

Un HA Group definisce un raggruppamento logico di risorse (VM/CT) e nodi. Permette di specificare su quali nodi un gruppo di VM può essere eseguito. Le HA Policy, invece, definiscono il comportamento del sistema in caso di fallimento di una risorsa, ad esempio quante volte tentare di riavviare una VM o se migrarla su un altro nodo. Puoi avere più policy per diversi livelli di criticità delle VM.

È obbligatorio un QDevice per un cluster Proxmox HA?

Non strettamente obbligatorio per cluster con più di due nodi, ma è fortemente raccomandato per cluster a due nodi. In un cluster a due nodi, senza un QDevice, se un nodo fallisce, non c’è una maggioranza di voti per mantenere il quorum, e il cluster si blocca completamente. Il QDevice fornisce un terzo voto esterno, permettendo al nodo superstite di mantenere la maggioranza e continuare a operare.

Come posso monitorare lo stato del mio cluster Proxmox?

Per un monitoring efficace, integra Prometheus e Grafana. Proxmox espone metriche tramite un exporter che Prometheus può raccogliere. Grafana ti permette di creare dashboard personalizzate e configurare alert per eventi critici come la perdita di quorum, l’eccessivo utilizzo di risorse o lo stato di failure delle VM HA. Questo ti permette di rilevare problemi prima che diventino interruzioni di servizio.

Conclusioni con takeaway operativi

L’implementazione di un cluster Proxmox HA è un passo fondamentale per garantire la continuità operativa. Tuttavia, l’installazione è solo l’inizio. La vera sfida sta nella verifica e nel mantenimento costante. Ricorda: una rete dedicata per Corosync, NTP sincronizzato e un Quorum Device adeguato sono pilastri non negoziabili. Integra un monitoring robusto e, soprattutto, testa il failover in condizioni reali. Solo così potrai essere certo che il tuo cluster resisterà quando la produzione è a rischio. La tranquillità di un ambiente IT stabile è il risultato di una pianificazione meticolosa e di test rigorosi.

Aggiornato: Luglio 2026