---
title: "Alta disponibilità Hyper-V con SafeKit: installare il modulo hyperv.safe per il failover"
canonical: "https://safekit.eviden.com/it/quick-install/safekit-quick-installation-guide-with-hyper-v/"
description: "Scopri come configurare hyperv.safe per un cluster Hyper-V attivo/attivo con SafeKit. Ottieni un’elevata disponibilità a livello di VM con un’architettura a 2 nodi shared-nothing. Replica in modo sincrono più VM tra i nodi per il failover automatico senza il costo di una SAN o di un’archiviazione condivisa."
category: "quick-install"
lang: "it"
topics: "Guida rapida all’installazione ad alta disponibilità per Hyper-V, Limitazioni SafeKit High Availability, Panoramica della soluzione SafeKit/Hyper-V, Installazione della soluzione SafeKit/Hyper-V su Windows (hyperv.safe), Configurazione passo-passo della soluzione SafeKit/Hyper-V, Dimostrazione della soluzione SafeKit/Hyper-V"
translation: "translate_md 2026-11-08.15 | glossaire 2026-11-09.11 | Translation LLM | 31 expressions"
---

# Alta disponibilità Hyper-V con SafeKit: installare il modulo hyperv.safe per il failover {#hyper-v-high-availability-with-safekit-install-the-hypervsafe-module-for-failover}

## Guida rapida all’installazione ad alta disponibilità per Hyper-V {#quick-guide}

Questa guida spiega come configurare un **cluster mirror** per Hyper-V utilizzando SafeKit, garantendo il failover automatico e la replica sincrona senza la necessità di uno storage condiviso. 

Per assistenza, puoi utilizzare [SafeKit AI 🤖](https://safekit.eviden.com/it/resources/safekit-support/).

### 1. Panoramica {#1-overview}

  * **Architettura:** utilizza un sistema a due nodi (primario/secondario).
  * **Protezione dei dati:** implementa la replica sincrona in tempo reale per **una perdita di dati pari a zero** (RPO = 0).

### 2. Installazione {#2-installation}

  * **Software:** installare il motore SafeKit su entrambi i server.
  * **Modulo:** Scarica il modulo dell’applicazione `hyperv.safe` preconfigurato.

### 3. Configurazione {#3-configuration}

  * **Console Web:** configurare le cartelle specifiche contenenti i file Hyper-V.
  * **Monitoraggio:** avvia il monitoraggio e la protezione dell’applicazione Hyper-V.

## Limitazioni SafeKit High Availability {#safekit-ha-limitations}

Limite/Requisito | Motivo e impatto | Alternativa consigliata  
---|---|---  
Dimensioni della replica: alcuni TB |  Tempo di risincronizzazione dopo un errore ([passaggio 3](https://safekit.eviden.com/it/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)): <br> • Rete da 1 Gb/s ≈ 3 ore/TB <br> • Rete da 10 Gb/s ≈ 1 ora/TB (a seconda delle prestazioni di scrittura del disco)  |  • Utilizzare [un’unità di archiviazione condivisa esterna](https://safekit.eviden.com/it/best-practises/san-vs-nas-shared-storage-for-a-failover-cluster/). Questa soluzione è più costosa e più complessa.   
Numero di file: < 1.000.000 |  • Lungo tempo di risincronizzazione dopo un guasto ([passaggio 3](https://safekit.eviden.com/it/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)). <br> • Tempo necessario per confrontare ciascun file su entrambi i nodi.  |  • Posizionare i file da replicare in un disco rigido virtuale o in una macchina virtuale. <br> • In questo caso, vengono replicati e risincronizzati solo i file del disco rigido virtuale o della macchina virtuale.   
Capacità di failover: ≤ 32 VM |  • Ogni VM viene eseguita in un modulo mirror indipendente. <br> • Un cluster può eseguire un massimo di 32 moduli mirror.  |  • Utilizzare un’unità di archiviazione condivisa esterna e un’altra soluzione di clustering per macchine virtuali. Questa soluzione è più costosa e più complessa.   
Architettura di rete: LAN o VLAN tra siti remoti |  • Failover automatico [dell’indirizzo IP virtuale](https://safekit.eviden.com/it/best-practises/how-a-virtual-ip-address-works/) quando entrambi i nodi si trovano nella stessa sottorete. <br> • Buona larghezza di banda per la risincronizzazione ([passaggio 3](https://safekit.eviden.com/it/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)). <br> • Bassa latenza per [la replica sincrona](https://safekit.eviden.com/it/best-practises/synchronous-replication-vs-asynchronous-replication/): in genere un RTT inferiore a 5 ms. Convalidare valori più elevati in base alla velocità di scrittura dell’applicazione.  |  • Se i due nodi si trovano in sottoreti diverse, cosa comune nel cloud, utilizzare una delle [altre soluzioni di reindirizzamento IP](https://safekit.eviden.com/it/best-practises/how-a-virtual-ip-address-works/#safekit-virtual-ip-implementation): un bilanciatore del carico, gli strumenti da riga di comando del provider cloud, il routing BGP o il reindirizzamento DNS. <br> • Utilizzare [soluzioni di backup](https://safekit.eviden.com/it/best-practises/high-availability-disaster-recovery-hadr/) con replica asincrona per reti ad alta latenza.   

 

## Panoramica della soluzione SafeKit/Hyper-V {#overview-of-the-safekit--hyper-v-solution}

La soluzione è descritta qui: **💡 [Semplice alta disponibilità Hyper-V senza storage condiviso (SAN)](<https://safekit.eviden.com/it/solutions/hyper-v-replication-automatic-failover-load-balancing/>)**

## Installazione della soluzione SafeKit/Hyper-V su Windows (hyperv.safe) {#installation-of-the-safekit--hyper-v-solution-on-windows-hypervsafe}

### Prerequisiti {#prerequisites}

  * Ruolo Hyper-V installato su 2 nodi Windows (integrato gratuitamente in tutte le versioni Windows, inclusa Windows per PC).
  * Applicazioni critiche installate all’interno di una o più macchine virtuali.
  * Massimo 32 macchine virtuali per host Hyper-V.
  * I dati totali replicati sono limitati a pochi terabyte; oltre questa soglia, il tempo di risincronizzazione diventa significativo.
  * Interconnessione minima di 1 Gb/s tra i nodi (10 Gb/s consigliati per una risincronizzazione più rapida).
  * Il failover IP richiede che entrambi i nodi si trovino sulla stessa LAN o LAN estesa (L2); le reti L3 instradate non sono supportate (eccetto con [i bilanciatori del carico cloud](<https://safekit.eviden.com/it/resources/safekit-user-guide-82/#Cloud>) 🛠️).

### Informazioni sui prodotti con licenza Siemens LMS {#about-products-under-siemens-lms-licensing}

  * Per evitare che la licenza Siemens si interrompa in caso di failover, il dongle contenente la chiave Siemens può essere inserito in un dispositivo USB su IP (come DIGI AnywhereUSB).
  * Il dongle può anche essere inserito in un PC esterno con il [server di licenze LMS](https://sid.siemens.com/r/A6V10426066/16779394955__2.6_en-US_16791369099) sul PC.
  * Nelle versioni più recenti del sistema di licenze Siemens, la chiave di licenza può essere inserita nel Trusted Platform Module della VM.

### Installazione del pacchetto su Windows {#package-installation-on-windows}

  * Scarica e installa la versione gratuita di SafeKit su 2 nodi Windows.   
Nota: la versione gratuita include tutte le funzionalità SafeKit. Al termine del periodo di prova, è possibile attivare le chiavi di licenza permanenti senza disinstallare il pacchetto. 
  * Al termine dell’installazione del pacchetto, selezionare **Imposta subito le credenziali della console e le regole del firewall** e configurare una password per l’utente **admin** della console SafeKit.   
**Imposta la stessa password su tutti i nodi.**
  * Escludere dalla scansione antivirus **C:/safekit/** (la directory di installazione predefinita) e **tutte le cartelle replicate** che si intende definire.   
Gli antivirus potrebbero incontrare difficoltà nel rilevare SafeKit a causa della sua stretta integrazione con il sistema operativo, dei meccanismi IP virtuali, della replica in tempo reale e del riavvio dei servizi critici. 

<a class="btn-download" href="/it/resources/safekit-free-trial/">Scarica SafeKit (Windows) ></a>

### Installazione del modulo su Windows {#module-installation-on-windows}

  * Scarica il modulo hyperv.safe. Il modulo è gratuito e contiene i file userconfig.xml e gli script di riavvio.
  * Inserire **hyperv.safe** in **C:/safekit/Application_Modules/generic**.

<a class="btn-download" href="/wp-content/uploads/downloads_safekit/version-82/modules_windows/hyperv.safe" download="hyperv.safe">Scarica hyperv.safe (Windows) ></a> 

 

## Configurazione passo-passo della soluzione SafeKit/Hyper-V {#step-by-step-configuration-of-the-safekit--hyper-v-solution}

⚠️ Leggi attentamente questi elementi prima di iniziare:

  * La configurazione Hyper-V viene presentata con una macchina virtuale denominata `VM1`. Leggere attentamente "1. Prerequisiti" per l’**organizzazione dei file VM1**. In caso contrario, il ripristino sul nodo secondario potrebbe non riuscire con dati incoerenti.
  * Dovrete ripetere questa configurazione per tutte le macchine virtuali che desiderate replicare e riavviare.
  * Il file system in cui sono archiviati i file delle macchine virtuali replicati da SafeKit deve essere NTFS; **ReFS non è supportato**.
  * SafeKit supporta la replica dei **checkpoint di produzione Hyper-V, ma non dei checkpoint standard**. Non utilizzare i checkpoint standard, altrimenti il ripristino sul nodo secondario potrebbe fallire con dati incoerenti.

### 1. Prerequisiti {#prerequisite}

Per la replica SafeKit, tutti i file della macchina virtuale VM1 (file di configurazione, disco rigido virtuale, ecc.) devono essere archiviati nella stessa cartella, anche se questo non è il comportamento predefinito di Hyper-V (ad esempio, D:/Repli-Hyper-V/VM1, dove VM1 è il nome della macchina virtuale).

Se tutti i file di VM1 non si trovano nella stessa cartella, utilizzare Gestione Hyper-V:

  * Esportare VM1 in una cartella, ad esempio in D:/Repli-Hyper-V
  * Questa esportazione creerà una cartella D:/Repli-Hyper-V/VM1 contenente tutti i file VM1
  * Rimuovere VM1 dall’inventario di Hyper-V Manager
  * Importa VM1, precedentemente esportata, in Hyper-V Manager

⚠️ Scatta un’istantanea della tua VM prima di iniziare la procedura.

⚠️ VM1 deve essere creata solo su un singolo nodo. L’unica cosa da creare sull’altro nodo è la directory VM1 (D:/Repli-Hyper-V/VM1).

⚠️ Assicurarsi che il nome (o i nomi) dello switch virtuale a cui fa riferimento la macchina virtuale esista su entrambi i server Hyper-V e corrisponda alla stessa rete fisica.

⚠️ Il failover del modulo Hyper-V (hyperv.safe) potrebbe non riuscire se i prerequisiti per la migrazione della VM non sono soddisfatti. Per rilevare problemi di compatibilità tra i nodi Hyper-V (hardware, rete, configurazione), consultare il documento 🛠️ [KB SK-0088 in questo documento](https://github.com/FR-LES-SAFEKIT-DEV/safekit-packages/releases/download/v8.2/SafeKit_8.2_Knowledge_Base.pdf).

### 2. Avviare la console SafeKit {#2-launch-the-safekit-console}

  * Avviare la console web in un browser su un nodo del cluster collegandosi a `http://localhost:9010`.
  * Inserire `admin` come nome utente e la password definita durante l’installazione.

È inoltre possibile eseguire la console in un browser su una workstation esterna al cluster.

⚠️ La configurazione di SafeKit viene eseguita su entrambi i nodi da un unico browser.

ℹ️ Per proteggere la console web, consultare 🛠️ [11. Protezione del servizio web SafeKit](https://safekit.eviden.com/it/resources/safekit-user-guide-82/#https) nella Guida per l’utente.

![Avviare la console web SafeKit per configurare il cluster Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/01-login-large.png)

### 3. Configurare gli indirizzi dei nodi {#3-configure-node-addresses}

  * Inserisci gli indirizzi IP dei nodi, premi il `Tab key` per verificare la connettività e compila i nomi dei nodi. Se node1 o node2 sono di colore rosso, controlla la connettività del browser con entrambi i nodi e controlla il firewall su entrambi i nodi per la 🛠️ [risoluzione dei problemi](https://safekit.eviden.com/it/resources/safekit-user-guide-82/#Troubleshooting).
  * Quindi, fare clic su `Save and apply` per salvare la configurazione.
  * Controllare il messaggio `Success` ✅ su entrambi i nodi.
  * Se si verifica un `Failure` di configurazione ❌ su un nodo, aprire il ▼ fisco di quel nodo e rivedere i messaggi. Si noti che è possibile utilizzare SafeKit AI 🤖 per assistenza.

ℹ️ Se lo desideri, puoi aggiungere una nuova `LAN and nodes` (prima ➕) per creare un secondo heartbeat e una rete di replica dedicata.

ℹ️ Se si fa clic su `Advanced configuration`, viene visualizzato il file `cluster.xml`. Questo file viene popolato automaticamente dalla console e distribuito sui nodi.

![Inserisci i nodi del cluster Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/02-cluster-edit.png)

### 4. Seleziona un modulo {#4-select-a-module}

  * Nel `New module`, fare clic sul modulo `hyperv.safe`.

ℹ️ Nel banner blu in alto, 🛜 `node1` rappresenta il nodo di connessione della console. Questo nodo inoltra le richieste a `node2` quando necessario.

ℹ️ La console cerca `xxx.safe` nella directory `Application_Modules/generic/` sul nodo di connessione (`node1`) se hai inserito un modulo lì durante l’installazione.

![Scegli il modulo per Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/04-module-new.png)

### 5. Configurare il modulo {#5-configure-the-module}

  * Scegliere l’avvio `Automatic` del modulo all’avvio senza ritardi.
  * Normalmente, si dispone di una singola rete `Heartbeat` su cui viene eseguita la replica. Tuttavia, è possibile definire una rete privata, se necessario (aggiungendo una LAN al passaggio 3).
  * In `VM_PATH`, inserire il percorso radice della directory replicata (D:/Repli-Hyper-V).
  * In `VM_NAME`, inserire il nome della macchina virtuale (VM1).

Si presuppone che tutti i file VM1 si trovino in D:/Repli-Hyper-V/VM1 (vedere [i prerequisiti](#prerequisite)). Questa directory verrà replicata in tempo reale da SafeKit. Non eseguire la replica parziale, poiché il failover non funzionerà.

I valori `NORMAL_STOP` e `FORCE_STOP` possono essere "`stop`", "`save`" o "`off`":

  * "`stop`" arresta la VM quando il modulo viene arrestato.
  * "`save`" salva lo stato corrente della VM (sospensione) quando il modulo viene arrestato.
  * "`off`" spegne la VM (power off) quando il modulo viene arrestato.

Si consiglia di utilizzare "`stop`" perché spegne la VM e quindi la riavvia quando il modulo viene arrestato e riavviato. Pertanto, se l’applicazione all’interno della VM si arresta in modo anomalo, viene riavviata.

Questo sarà il caso, ad esempio, quando si passa da un ruolo primario a uno secondario.

ℹ️ Non è necessario configurare un indirizzo IP virtuale. VM1 verrà riavviata sul server Hyper-V secondario con il suo indirizzo IP fisico e questo indirizzo IP verrà reindirizzato.

ℹ️ Quando si applica la configurazione SafeKit, l’ `Automatic Start Action` della macchina virtuale è impostata su `Nothing` in Hyper-V. Ciò garantisce che la VM non si avvii automaticamente all’avvio dell’host Hyper-V, ma venga avviata solo quando il modulo stesso viene avviato.

![Inserisci i parametri Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/19-module-hyperv-edit-config-1.png)

### 6. Controllo personalizzato per rilevare il malfunzionamento della VM {#vm-checker}

Il checker personalizzato invia messaggi heartbeat dall’host alla VM a intervalli regolari. Spetta quindi al servizio Hyper-V heartbeat installato nella VM inviare una risposta a ciascuno di questi messaggi heartbeat.

Se il servizio Hyper-V heartbeat non risponde al messaggio (VM bloccata, arrestata in modo anomalo o ha cessato di funzionare), il checker personalizzato esegue un’azione per riavviare la VM sullo stesso nodo Hyper-V o sull’altro.

  * Fare clic su `Checkers / Custom` (vedere l’immagine).
  * Impostare un nome a scelta in `Resource name` (ad esempio VM1). `Resource name` identifica la macchina virtuale con un nome di risorsa in SafeKit: `custom.VM1`.
  * Con `restart` in `Action`, la VM viene riavviata sullo stesso nodo Hyper-V. Dopo 3 riavvii non riusciti in 24 ore, il modulo SafeKit hyperv si arresta sul nodo primario e si verifica un failover della VM sul nodo secondario.
  * Se si imposta `stopstart` in `Action`, si verifica un failover diretto sull’altro nodo Hyper-V non appena la VM non risponde agli heartbeat.

ℹ️ Per la manutenzione, se si desidera arrestare la macchina virtuale, il checker personalizzato la riavvierà automaticamente. Per evitare ciò, è possibile [sospendere temporaneamente il checker 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/04/safekit-disable-checkers.png). Oppure è possibile rimuoverlo eliminando la riga di configurazione nella console.

ℹ️ Lo stesso vale quando si desidera ripristinare un checkpoint. Hyper-V interromperà la VM per eseguire l’operazione e il checker della VM potrebbe reagire negativamente riavviando automaticamente la VM. Per evitare ciò, [sospendi il checker 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/04/safekit-disable-checkers.png) prima di procedere con l’operazione.

ℹ️ Per impostazione predefinita, il controllo personalizzato concede 50 secondi all’avvio della VM prima di considerarla non disponibile. Se la VM Hyper-V richiede più tempo per l’avvio, è possibile aumentare questo ritardo aggiungendo -InitialGrace al controllo personalizzato vmcheck.ps1 in userconfig.xml. Il valore è espresso in incrementi di 5 secondi. Ad esempio, -InitialGrace 20 concede un periodo di tolleranza di 100 secondi: `<custom ident="VM1" exec="vmcheck.ps1" arg="%VM_NAME% -InitialGrace 20" when="prim" action="restart"></custom>`.

![Inserisci i parametri del checker personalizzato Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/04/safekit-custom-checker-hyperv.png)

### 7. Modifica gli script (facoltativo) {#7-edit-scripts-optional}

  * Non modificare gli script.

### 8. Crittografia della comunicazione (opzionale) {#8-communication-encryption-optional}

  * Mantenere la crittografia della comunicazione tra i nodi.

![Crittografia della comunicazione del modulo Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/07-module-encryption.png)

### 9. Salva e applica {#9-save-and-apply}

  * `Save and apply` la configurazione e gli script su entrambi i nodi.

![Salva e applica la configurazione del modulo Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/08-module-save.png)

### 10. Verificare la corretta configurazione {#10-verify-successful-configuration}

  * Controllare il messaggio `Success` ✅ su entrambi i nodi e fare clic su `Monitor modules`.
  * Se si verifica un `Failure` di configurazione ❌ su un nodo, aprire il ▼ fisco di quel nodo e rivedere i messaggi. Si noti che è possibile utilizzare SafeKit AI 🤖 per assistenza.

![Verifica l’esito della configurazione del modulo Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/09-module-save-check.png)

### 11. Avviare il nodo con i dati aggiornati {#11-start-the-node-with-up-to-date-data}

  * Se il nodo 1 dispone della directory replicata aggiornata per `VM1/`, selezionarla e ⋯ `Force start` ▶ `As primary`.

Quando il nodo 2 viene avviato, tutti i dati verranno copiati dal nodo 1 al nodo 2.

⚠️ Se si effettua la scelta sbagliata, si corre il rischio di sincronizzare dati obsoleti su entrambi i nodi.

⚠️ Si presuppone inoltre che `VM1` sia arrestata sul nodo 1 in modo che SafeKit installi i meccanismi di replica e quindi avvii `VM1` nello script `start_prim`.

⚠️ Utilizzare `Start` per gli avvii successivi: SafeKit mantiene il server più aggiornato. L’avvio `As primary` è un avvio speciale la prima volta o durante operazioni eccezionali.

![Avviare come primario il nodo Hyper-V con i dati aggiornati](https://safekit.eviden.com/wp-content/uploads/2024/03/10-monitoring-mirror-stop-stop-prim.png)

### 12. Attendere la transizione a ALONE (verde) {#12-wait-for-the-transition-to-alone-green}

  * Il nodo 1 dovrebbe raggiungere lo stato ALONE (verde), il che significa che lo script `start_prim` è stato eseguito sul nodo 1.

⚠️ Se ALONE (verde) non viene raggiunto o se VM1 non viene avviato, analizzare il motivo con il [registro del modulo 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/24-module-log-script.png) del nodo 1.

  * Fare clic sull’icona **del log** 🔍 del `node1` per aprire il log del modulo e cercare messaggi di errore, ad esempio un checker che rileva un errore e arresta il modulo.
  * Fare clic su `start_prim` nel log: i messaggi di output dello script vengono visualizzati a destra ed è possibile rilevare errori, ad esempio se VM1 non si è avviata correttamente.
  * Usa SafeKit AI 🤖 per ricevere assistenza con i messaggi di log.

⚠️ Se il cluster è in stato `WAIT (red) not uptodate, STOP (red) not uptodate`, arrestare il nodo WAIT e [forzarne l’avvio come primario 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/10-monitoring-mirror-stop-stop-prim.png).

![Il primo nodo Hyper-V si avvia come primario e diventa ALONE](https://safekit.eviden.com/wp-content/uploads/2024/03/12-monitoring-alone-stop.png)

### 13. Avviare il nodo 2 {#13-start-node-2}

  * ⋯ `Start` il nodo 2 con il suo menu contestuale.
  * Attendere il SECOND stato (verde).

ℹ️ Il nodo 2 rimane nel SECOND stato (arancione) durante la risincronizzazione delle directory replicate (copia dal nodo 1 al nodo 2).

  * Questa operazione potrebbe richiedere del tempo, a seconda delle dimensioni dei file da risincronizzare nelle directory replicate e della larghezza di banda della rete.
  * Per visualizzare l’avanzamento della copia, consultare il [registro del modulo 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/27-module-log-reintegration.png) e le [risorse di replica 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/26-replication-resources-reintegration.png) del nodo 2. Utilizzare SafeKit AI 🤖 per assistenza con i messaggi di registro.

ℹ️ Quando si utilizzano i dischi differenziali Hyper-V, solo il disco differenziale deve essere risincronizzato dopo la sincronizzazione iniziale, risparmiando tempo per i dischi rigidi virtuali di grandi dimensioni.

![Avviare il nodo 2 Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/03/13-monitoring-alone-stop-start.png)

### 14. Verificare che il cluster sia operativo {#14-verify-that-the-cluster-is-operational}

  * Verificare che il cluster sia verde/verde con `VM1` in esecuzione sul nodo PRIM e non sul nodo SECOND.

In questo stato, solo le modifiche all’interno dei file vengono replicate in tempo reale.

![Il nodo Hyper-V 2 è SECOND (verde)](https://safekit.eviden.com/wp-content/uploads/2024/03/14-monitoring-prim-second.png)

### 15. Test {#15-testing}

  * Arrestare il nodo PRIM scorrendo il relativo menu contestuale e facendo clic su `Stop`.
  * Verificare che sia presente un failover sul SECOND nodo, che dovrebbe diventare ALONE (verde).
  * Verificare con il gestore Hyper-V che `VM1` sia in esecuzione sul nodo 2.

⚠️ Se ALONE (verde) non viene raggiunto sul node2 o se VM1 non è avviata, analizzare il motivo con il [log del modulo 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/38-module-log-script-second.png) del nodo 2.

  * Fare clic sull’icona **del registro** 🔍 del `node2` per aprire il registro del modulo e cercare messaggi di errore, ad esempio un checker che rileva un errore e arresta il modulo.
  * Fare clic su `start_prim` nel log: i messaggi di output dello script vengono visualizzati a destra ed è possibile rilevare errori, ad esempio se VM1 non si è avviata correttamente.
  * Usa SafeKit AI 🤖 per ricevere assistenza con i messaggi di log.

⚠️ Poiché lo script `start_prim` importa la macchina virtuale sul nodo 2, il failover potrebbe non riuscire a causa delle 🛠️ [Impostazioni Hyper-V (vedere KB SK-0088 in questo documento)](https://github.com/FR-LES-SAFEKIT-DEV/safekit-packages/releases/download/v8.2/SafeKit_8.2_Knowledge_Base.pdf).

⚠️ Se tutto è a posto, avviare node1. Node1 risincronizzerà quindi le directory replicate da node2.

Se le cose vanno male, arrestare node2 e [forzare node 1 ad avviarsi come primario 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/10-monitoring-mirror-stop-stop-prim.png), che si riavvierà con i suoi dati localmente integri al momento dell’arresto.

ℹ️ Tieni presente che hai una 🕒 **[cronologia 🖼️](https://safekit.eviden.com/wp-content/uploads/2026/05/safekit-console-timeline.png)** che può essere utile per capire cosa succede nel cluster.

![Arrestare il modulo Hyper-V sul server PRIM](https://safekit.eviden.com/wp-content/uploads/2024/03/16-monitoring-prim-second-stop.png)

### 16. Se necessario, configurare un checker split-brain {#16-if-necessary-configure-a-splitbrain-checker}

  * Per sapere se è necessario configurare un checker split-brain, consultare la sezione [Quali sono i diversi scenari in caso di isolamento della rete in un cluster?](https://safekit.eviden.com/it/best-practises/power-outage-and-network-isolation-in-a-cluster/).
  * Andare alla configurazione del modulo e fare clic su `Checkers / Splitbrain` (vedere immagine) per modificare i parametri di splitbrain.
  * `Save and apply` la nuova configurazione per ridistribuirla su entrambi i nodi (il modulo deve essere arrestato su entrambi i nodi per salvare e applicare).

**Parametri** :

  * `Resource name` identifica il witness con un nome di risorsa: `splitbrain.witness`. È possibile modificare questo valore per identificare il witness.
  * `Witness address` è l’argomento per un ping quando un nodo passa da PRIM a ALONE o da SECOND a ALONE. Modificare questo valore con l’IP del witness (un elemento robusto, in genere un router).
  * Nota: è possibile impostare più IP separati da spazi bianchi. Assicurarsi che gli indirizzi IP siano accessibili da un nodo ma non dall’altro in caso di isolamento della rete.

![Inserisci i parametri di splitbrain Hyper-V](https://safekit.eviden.com/wp-content/uploads/2024/04/safekit-split-brain-checker.png)

### 17. Riavvio automatico in caso di errore di un servizio critico all’interno della VM {#17-automatic-restart-if-a-critical-service-fails-inside-the-vm}

Se si desidera un riavvio automatico o un failover quando un servizio critico all’interno della VM si arresta in modo anomalo, è possibile configurare le proprietà di ripristino del servizio (vedere l’immagine).

Innanzitutto, è necessario configurare il [checker personalizzato della VM](#vm-checker) precedentemente descritto.

Quindi, in Microsoft Service Manager all’interno della VM, selezionare il servizio critico e, nelle proprietà di ripristino del servizio, configurare lo spegnimento della VM in caso di errore del servizio critico.

Per fare ciò, nelle Opzioni di ripristino del servizio critico, scegliere "**Esegui un programma**" in caso di errori. Nelle opzioni di esecuzione del programma, impostare `C:/Windows/System32/shutdown.exe` come programma e `/s /c "service fails"` come parametri della riga di comando.

Naturalmente, è possibile implementare un ripristino più graduale con i propri script. Tuttavia, si tenga presente che l’arresto della VM abiliterà il checker personalizzato nell’host. Il checker personalizzato rileverà che l’heartbeat Hyper-V non risponde più. Riavvierà quindi la VM sullo stesso server Hyper-V o eseguirà il failover sull’altro server Hyper-V (a seconda della sua configurazione).

Per testare la funzionalità, utilizzare Task Manager e terminare il processo (Termina attività) associato al servizio critico. Un’interruzione pulita del servizio tramite Gestione servizi o il comando "net stop" non attiva l’azione di ripristino all’interno di Gestione servizi Windows.

![Failover della VM Hyper-V in caso di errore di un servizio critico](https://safekit.eviden.com/wp-content/uploads/2023/11/hyperv-critical-service.png)

### 18. Supporto {#18-support}

  * Per ottenere assistenza, eseguire due `Snapshots` SafeKit (due file .zip), uno per ciascun nodo.

ℹ️ [Maggiori informazioni sul supporto qui](https://safekit.eviden.com/it/resources/safekit-support/).

![Scatta istantanee Hyper-V per il supporto](https://safekit.eviden.com/wp-content/uploads/2024/03/30-snapshots-mirror.png)

 

## Dimostrazione della soluzione SafeKit/Hyper-V {#demonstration-of-the-safekit--hyper-v-solution}

### Video SafeKit: clustering a livello di macchina virtuale con Hyper-V (5:15) {#demo-hyperv}

In questo video, scopri come SafeKit implementa **l’alta disponibilità per Hyper-V** senza la complessità di una SAN. Impara a configurare **la replica delle macchine virtuali** tra due nodi per garantire un failover continuo per i tuoi carichi di lavoro virtualizzati critici. Sebbene questa dimostrazione utilizzi Hyper-V su Windows, la soluzione funziona in modo identico con KVM su Linux.

### Capitoli {#chapters}

  1. 🎬 [Panoramica dell’architettura: 2 nodi Hyper-V e 2 macchine virtuali](https://www.youtube.com/watch?v=H18s_-_CpmU&t=0s) (0:49)
  2. 🎬 [Configurazione del cluster e dei moduli hyperv.safe](https://www.youtube.com/watch?v=H18s_-_CpmU&t=49s) (1:59)
  3. 🎬 [Test dal vivo: replica, migrazione e failover automatico della VM in caso di arresto anomalo](https://www.youtube.com/watch?v=H18s_-_CpmU&t=168s) (2:26)

### Implementazione passo-passo {#step-by-step-implementation}

  * 🛠️ [Leggi la guida per configurare un cluster mirror Hyper-V su Windows.](https://safekit.eviden.com/it/quick-install/safekit-quick-installation-guide-with-hyper-v/)
  * 🛠️ [Leggi la guida per configurare un cluster mirror KVM su Linux.](https://safekit.eviden.com/it/quick-install/safekit-quick-installation-guide-with-kvm/)

