---
title: "Alta Disponibilidade KVM com SafeKit: Instale o Módulo kvm.safe para Failover"
canonical: "https://safekit.eviden.com/pt-br/quick-install/safekit-quick-installation-guide-with-kvm/"
description: "Saiba como configurar kvm.safe para um cluster KVM ativo/ativo com SafeKit. Obtenha alta disponibilidade no nível da VM com uma arquitetura de 2 nós sem compartilhamento. Replique várias VMs de forma síncrona entre os nós para failover automático sem o custo de uma SAN ou armazenamento compartilhado."
category: "quick-install"
lang: "pt-br"
topics: "Guia de Instalação Rápida de Alta Disponibilidade para KVM, Limitações SafeKit de Alta Disponibilidade, Visão geral da solução SafeKit/KVM, Instalação da solução SafeKit/KVM no Linux (kvm.safe), Configuração passo a passo da solução SafeKit/KVM, Demonstração de uma solução de alta disponibilidade em nível de máquina virtual"
translation: "translate_md 2026-11-08.15 | glossaire 2026-11-09.11 | Translation LLM | 30 expressions"
---
# Alta Disponibilidade KVM com SafeKit: Instale o Módulo kvm.safe para Failover {#kvm-high-availability-with-safekit-install-the-kvmsafe-module-for-failover}
## Guia de Instalação Rápida de Alta Disponibilidade para KVM {#quick-guide}
Este guia explica como configurar um **cluster mirror** para KVM usando SafeKit, garantindo o failover automático e a replicação síncrona sem a necessidade de armazenamento compartilhado.
Para obter ajuda, você pode usar [SafeKit AI 🤖](https://safekit.eviden.com/pt-br/resources/safekit-support/).
### 1. Visão geral {#1-overview}
* **Arquitetura:** utiliza um sistema de dois nós (primário/secundário).
* **Proteção de dados:** implementa a replicação síncrona em tempo real para **perda zero de dados** (RPO = 0).
### 2. Instalação {#2-installation}
* **Software:** Instale o motor SafeKit em ambos os servidores.
* **Módulo:** Baixe o módulo de aplicativo pré-configurado `kvm.safe`.
### 3. Configuração {#3-configuration}
* **Console da Web:** configure as pastas específicas que contêm os arquivos KVM.
* **Monitoramento:** Inicie o monitoramento e a proteção do aplicativo KVM.
## Limitações SafeKit de Alta Disponibilidade {#safekit-ha-limitations}
Limite/Requisito | Motivo e Impacto | Alternativa recomendada
---|---|---
Tamanho da replicação: alguns TBs | Tempo de resincronização após falha ([etapa 3](https://safekit.eviden.com/pt-br/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)): • Rede de 1 Gb/s ≈ 3 horas/TB • Rede de 10 Gb/s ≈ 1 hora/TB (dependendo do desempenho de gravação do disco) | • Usar [armazenamento compartilhado externo](https://safekit.eviden.com/pt-br/best-practises/san-vs-nas-shared-storage-for-a-failover-cluster/) (mais caro, mais complexo).
Contagem de arquivos: < 1.000.000 de arquivos | • Desempenho do tempo de resincronização após uma falha ([etapa 3](https://safekit.eviden.com/pt-br/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)). • Tempo necessário para comparar cada arquivo entre os dois nós. | • Coloque os vários arquivos a serem replicados em um disco rígido virtual/máquina virtual. • Apenas os arquivos que representam o disco rígido virtual/máquina virtual serão replicados e resincronizados neste caso.
Capacidade de failover: ≤ 32 VMs | • Cada VM é executada em um módulo mirror independente. • Máximo de 32 módulos mirror em execução no mesmo cluster. | • Utilize um armazenamento compartilhado externo e outra solução de cluster de máquinas virtuais (mais cara e mais complexa).
Arquitetura de rede: rede LAN/VLAN entre locais remotos | • Failover automático do [endereço IP virtual](https://safekit.eviden.com/pt-br/best-practises/how-a-virtual-ip-address-works/) com 2 nós na mesma sub-rede. • Boa largura de banda para resincronização ([passo 3](https://safekit.eviden.com/pt-br/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)). • Baixa latência para [replicação síncrona](https://safekit.eviden.com/pt-br/best-practises/synchronous-replication-vs-asynchronous-replication/): normalmente < 5 ms RTT; valores mais altos devem ser validados em relação à taxa de gravação do aplicativo. | • Se os dois nós estiverem em sub-redes diferentes (comum na nuvem), use [outras opções de redirecionamento](https://safekit.eviden.com/pt-br/best-practises/how-a-virtual-ip-address-works/#safekit-virtual-ip-implementation): um balanceador de carga, CLIs de provedor de nuvem, BGP ou redirecionamento de DNS. • Utilize soluções de backup com replicação assíncrona para redes com alta latência.
## Visão geral da solução SafeKit/KVM {#overview-of-the-safekit--kvm-solution}
A solução é descrita aqui: **💡 [Alta Disponibilidade Simples de KVM Linux sem Armazenamento Compartilhado]()**
## Instalação da solução SafeKit/KVM no Linux (kvm.safe) {#installation-of-the-safekit--kvm-solution-on-linux-kvmsafe}
### Pré-requisitos {#prerequisites}
* KVM instalado em 2 nós Linux.
* Aplicações críticas instaladas em uma ou mais máquinas virtuais.
* Máximo de 32 máquinas virtuais por host KVM.
* Os dados replicados totais são limitados a alguns terabytes — além disso, o tempo de resincronização torna-se significativo.
* Interconexão mínima de 1 Gb/s entre os nós (10 Gb/s recomendada para resincronização mais rápida).
* O failover de IP requer que ambos os nós estejam na mesma LAN ou LAN estendida (L2) — redes L3 roteadas não são suportadas (exceto com [balanceadores de carga em nuvem]() 🛠️).
### Instalação de pacotes no Linux {#package-installation-on-linux}
* Instale a versão gratuita do SafeKit em 2 nós Linux. Observação: a avaliação gratuita inclui todos os recursos SafeKit. Ao final da avaliação, você pode ativar chaves de licença permanentes sem desinstalar o pacote.
* Após o download do pacote safekit_xx.bin, execute-o para extrair o rpm e o script safekitinstall e, em seguida, execute o script **safekitinstall**
* Responda **sim** à configuração automática do firewall
* Defina a senha para o console da web e o usuário padrão **admin**. **Defina a mesma senha em todos os nós.**
Baixar SafeKit (Linux) >
### Instalação do módulo no Linux {#module-installation-on-linux}
* Baixe o módulo kvm.safe.
O módulo é gratuito. Ele contém os arquivos userconfig.xml e os scripts de reinicialização.
* Coloque **kvm.safe** em **/opt/safekit/Application_Modules/generic/**.
Baixar kvm.safe (Linux) >
## Configuração passo a passo da solução SafeKit/KVM {#step-by-step-configuration-of-the-safekit--kvm-solution}
⚠️ A configuração KVM é apresentada com uma máquina virtual chamada `VM1` e contém o aplicativo a ser reiniciado em caso de falha.
⚠️ Você terá que repetir esta configuração para todas as máquinas virtuais que deseja replicar e reiniciar.
### 1. Pré-requisitos {#prerequisite}
A imagem da máquina virtual VM1 está no arquivo `/var/lib/libvirt/images/vm1.qcow2`. Antes de configurar SafeKit, você deve executar a seguinte configuração para colocar a máquina virtual em um diretório específico da vm1 que será replicado pelo SafeKit.
No nó 1:
* Parar vm1:
virsh shutdown vm1
* Crie um diretório `vm1/`:
mkdir -p /var/lib/libvirt/images/vm1/
* Copie a imagem vm1 para o novo local:
cp -a /var/lib/libvirt/images/vm1.qcow2 /var/lib/libvirt/images/vm1/
A imagem original vm1 pode ser excluída assim que os testes com o novo local forem bem-sucedidos.
* Edite o arquivo de configuração vm1:
EDITOR=vi virsh edit vm1
E altere a linha:
por:
* Defina a [opção de cache como "nenhuma"](https://safekit.eviden.com/wp-content/uploads/2022/07/kvm-2.png) no mesmo arquivo, para garantir a integridade dos dados em caso de falha:
* Feche o arquivo de configuração vm1
* Desativar [o início automático da vm1](https://safekit.eviden.com/wp-content/uploads/2022/07/kvm-3.png):
virsh autostart vm1 --disable
* Crie um arquivo de configuração `vm1.xml` para vm1:
virsh dumpxml vm1 > vm1.xml
No nó 2:
* Copie o arquivo de configuração `vm1.xml` do nó 1. Observação: sempre que a configuração vm1 for alterada no nó 1, você deverá reaplicar a nova configuração no nó 2.
* Crie vm1, mas não a inicie:
virsh define vm1.xml
* Desativar o início automático vm1:
virsh autostart vm1 --disable
* Crie o diretório para o local da imagem:
mkdir -p /var/lib/libvirt/images/vm1/
### 2. Inicie o console SafeKit {#2-launch-the-safekit-console}
* Inicie o console da web em um navegador em um nó do cluster, conectando-se a `http://localhost:9010`.
* Insira `admin` como nome de usuário e a senha definida durante a instalação.
Você também pode executar o console em um navegador em uma estação de trabalho externa ao cluster.
⚠️ A configuração do SafeKit é feita em ambos os nós a partir de um único navegador.
ℹ️ Para proteger o console da web, consulte 🛠️ [11. Protegendo o serviço da web SafeKit](https://safekit.eviden.com/pt-br/resources/safekit-user-guide-82/#https) no Guia do Usuário.
### 3. Configurar endereços de nós {#3-configure-node-addresses}
* Insira os endereços IP do nó, pressione a `Tab key` para verificar a conectividade e preencha os nomes dos nós. Se node1 ou node2 estiverem em vermelho, verifique a conectividade do navegador com ambos os nós e verifique o firewall em ambos os nós para 🛠️ [solucionar problemas](https://safekit.eviden.com/pt-br/resources/safekit-user-guide-82/#Troubleshooting).
* Em seguida, clique em `Save and apply` para salvar a configuração.
* Verifique a mensagem `Success` ✅ em ambos os nós.
* Se ocorrer uma `Failure` de configuração ❌ em um nó, abra o acordeão ▼ desse nó e revise as mensagens. Observe que você pode usar a IA SafeKit 🤖 para obter assistência.
ℹ️ Se desejar, você pode adicionar uma nova `LAN and nodes` (primeiro ➕) para criar um segundo heartbeat e uma rede de replicação dedicada.
ℹ️ Se você clicar em `Advanced configuration`, o arquivo `cluster.xml` será exibido. Este arquivo é preenchido automaticamente pelo console e implantado nos nós.
### 4. Selecione um módulo {#4-select-a-module}
* No `New module`, clique no módulo `kvm.safe`.
ℹ️ No banner azul na parte superior, 🛜 `node1` representa o nó de conexão do console. Este nó retransmite solicitações para `node2` quando necessário.
ℹ️ O console procura por `xxx.safe` no diretório `Application_Modules/generic/` no nó de conexão (`node1`) se você colocou um módulo lá durante a instalação.
### 5. Configure o módulo {#5-configure-the-module}
* Escolha o início `Automatic` do módulo na inicialização sem atraso.
* Normalmente, você tem uma única rede `Heartbeat` na qual a replicação é feita. Mas, você pode definir uma rede privada, se necessário (adicionando uma LAN na etapa 3).
* Insira em `VM_PATH` o caminho raiz do diretório replicado (`/var/lib/libvirt/images`).
* Insira em `VM_NAME` o nome da máquina virtual (`vm1`).
Assumimos que os arquivos VM1 estão em `/var/lib/libvirt/images/vm1/` (consulte [os pré-requisitos](#prerequisite)). Este diretório será replicado em tempo real pelo SafeKit.
ℹ️ Você não precisa configurar um endereço IP virtual. VM1 será reiniciada no KVM secundário com seu endereço IP físico, e esse endereço IP será redirecionado.
### 6. Verificador personalizado para detetar o mau funcionamento da máquina virtual {#6-custom-checker-to-detect-vm-malfunction}
O verificador personalizado verifica se a VM está em execução (com o comando ’virsh domstate’). Se a VM não estiver em execução, o verificador personalizado reinicia automaticamente a VM no mesmo nó KVM ou no outro.
* Clique em `Checkers / Custom` (veja a imagem).
* `Resource name` identifica a máquina virtual com um nome de recurso no SafeKit: `custom.VM_NAME_check`.
* Com `restart` em `Action`, a VM é reiniciada no mesmo nó KVM. Após 3 reinicializações malsucedidas em 24 horas, o módulo SafeKit kvm para no nó primário e ocorre um failover da VM no nó secundário.
* Se você definir `stopstart` em `Action`, haverá um failover direto no outro nó KVM assim que a VM não estiver em execução.
ℹ️ Para manutenção, se você quiser parar a máquina virtual, o verificador personalizado a reiniciará automaticamente. Para evitar isso, você pode [suspender temporariamente o verificador 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/04/safekit-disable-checkers.png). Ou você pode removê-lo excluindo a linha de configuração no console.
### 7. Editar scripts (opcional) {#7-edit-scripts-optional}
* Não edite os scripts.
### 8. Criptografia de comunicação (opcional) {#8-communication-encryption-optional}
* Mantenha a criptografia da comunicação entre os nós.
### 9. Salvar e aplicar {#9-save-and-apply}
* `Save and apply` a configuração e os scripts em ambos os nós.
### 10. Verifique se a configuração foi bem-sucedida {#10-verify-successful-configuration}
* Verifique a mensagem `Success` ✅ em ambos os nós e clique em `Monitor modules`.
* Se ocorrer uma `Failure` de configuração ❌ em um nó, abra o acordeão ▼ desse nó e revise as mensagens. Observe que você pode usar a IA SafeKit 🤖 para obter assistência.
### 11. Inicie o nó com dados atualizados {#11-start-the-node-with-up-to-date-data}
* Se o nó 1 tiver o diretório replicado atualizado para `vm1/`, selecione-o e ⋯ `Force start` ▶ `As primary`.
Quando o nó 2 for iniciado, todos os dados serão copiados do nó 1 para o nó 2.
⚠️ Se você fizer a escolha errada, corre o risco de sincronizar dados desatualizados em ambos os nós.
⚠️ Também se presume que `VM1` está parada no nó 1 para que SafeKit instale os mecanismos de replicação e, em seguida, inicie `VM1` no script `start_prim`.
⚠️ Use `Start` para inícios subsequentes: SafeKit mantém o servidor mais atualizado. Iniciar `As primary` é um início especial na primeira vez ou durante operações excepcionais.
### 12. Aguarde a transição para ALONE (verde) {#12-wait-for-the-transition-to-alone-green}
* O nó 1 deve atingir o estado ALONE (verde), o que significa que o script `start_prim` foi executado no nó 1.
⚠️ Se ALONE (verde) não for atingido ou se VM1 não for iniciado, analise o motivo com o [log do módulo 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/24-module-log-script.png) do nó 1.
* Clique no ícone **de log** 🔍 do `node1` para abrir o log do módulo e procure mensagens de erro, como um verificador que detecta um erro e interrompe o módulo.
* Clique em `start_prim` no log: as mensagens de saída do script são exibidas à direita e os erros podem ser detectados, como VM1 iniciada incorretamente.
* Use o SafeKit AI 🤖 para obter ajuda com as mensagens de log.
⚠️ Se o cluster estiver no estado `WAIT (red) not uptodate, STOP (red) not uptodate`, pare o nó WAIT e [force o seu início como primário 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/10-monitoring-mirror-stop-stop-prim.png).
### 13. Iniciar o nó 2 {#13-start-node-2}
* ⋯ `Start` o nó 2 com o seu menu contextual.
* Aguarde o SECOND estado (verde).
ℹ️
* O nó 2 permanece no SECOND estado (laranja) enquanto resincroniza os diretórios replicados (cópia do nó 1 para o nó 2).
* Isso pode levar algum tempo, dependendo do tamanho dos arquivos a serem resincronizados nos diretórios replicados e da largura de banda da rede.
* Para ver o progresso da cópia, consulte o [log do módulo 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/27-module-log-reintegration.png) e os [recursos de replicação 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/26-replication-resources-reintegration.png) do nó 2. Use o SafeKit AI 🤖 para obter assistência com as mensagens de log.
### 14. Verifique se o cluster está operacional {#14-verify-that-the-cluster-is-operational}
* Verifique se o cluster está verde/verde com `VM1` em execução no nó PRIM e não em execução no nó SECOND.
Apenas as alterações dentro dos arquivos são replicadas em tempo real neste estado.
### 15. Testes {#15-testing}
* Pare o nó PRIM rolando para baixo no menu contextual e clicando em `Stop`.
* Verifique se há um failover no SECOND nó, que deve ficar ALONE (verde).
* Verifique com as ferramentas KVM se `VM1` está sendo executada no nó 2.
⚠️ Se ALONE (verde) não for atingido no node2 ou se VM1 não for iniciada, analise o motivo com o [log do módulo 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/38-module-log-script-second.png) do nó 2.
* Clique no ícone **de log** 🔍 do `node2` para abrir o log do módulo e procure mensagens de erro, como um verificador detectando um erro e interrompendo o módulo.
* Clique em `start_prim` no log: as mensagens de saída do script são exibidas à direita e os erros podem ser detectados, como VM1 iniciada incorretamente.
* Use o SafeKit AI 🤖 para obter ajuda com as mensagens de log.
⚠️
* Se tudo estiver bem, inicie o node1, que irá ressincronizar os diretórios replicados do node2.
* Se as coisas derem errado, pare node2 e [force o nó 1 a iniciar como primário 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/10-monitoring-mirror-stop-stop-prim.png), que será reiniciado com seus dados localmente íntegros no momento da parada.
ℹ️ Observe que você tem uma **[🖼️ linha do tempo](https://safekit.eviden.com/wp-content/uploads/2026/05/safekit-console-timeline.png)** 🕒 que pode ser útil para entender o que acontece no cluster.
### 16. Se necessário, configure um verificador de divisão de cluster {#16-if-necessary-configure-a-splitbrain-checker}
* Consulte ["Quais são os diferentes cenários em caso de isolamento de rede em um cluster?"](https://safekit.eviden.com/pt-br/best-practises/power-outage-and-network-isolation-in-a-cluster/) para saber se você precisa configurar um verificador de divisão de rede.
* Acesse a configuração do módulo e clique em `Checkers / Splitbrain` (veja a imagem) para editar os parâmetros do splitbrain.
* `Save and apply` a nova configuração para reimplementá-la em ambos os nós (o módulo deve ser interrompido em ambos os nós para salvar e aplicar).
**Parâmetros** :
* `Resource name` identifica a testemunha com um nome de recurso: `splitbrain.witness`. Você pode alterar esse valor para identificar a testemunha.
* `Witness address` é o argumento para um ping quando um nó passa de PRIM para ALONE ou de SECOND para ALONE. Altere este valor com o IP da testemunha (um elemento robusto, normalmente um roteador).
* Observação: você pode definir vários IPs separados por espaços em branco. Observe que os endereços IP devem ser acessíveis a partir de um nó, mas não do outro, no caso de isolamento de rede.
### 17. Replicando snapshots {#17-replicating-snapshots}
O diretório que contém os arquivos XML do snapshot é:
/var/lib/libvirt/qemu/snapshot/%VM_NAME%
onde `VM_NAME` é o nome da máquina virtual (vm1).
Observação: Se nenhum snapshot tiver sido criado, crie um para gerar o diretório (caso contrário, a configuração SafeKit falhará).
Para replicar:
* Na configuração do módulo, clique em `Advanced Configuration` (veja a imagem) para editar `userconfig.xml`.
* Insira as linhas abaixo na seção `` do userconfig.xml:
* `Save and apply` a nova configuração para reimplantar o arquivo userconfig.xml modificado em ambos os nós (o módulo deve ser interrompido em ambos os nós para salvar e aplicar).
* Crie snapshots no nó PRIM, seja através do virt-manager ou de uma linha de comando:
virsh snapshot-create-as vm1 snapshot-name
Observação: ao criar um snapshot com uma linha de comando, você precisa atualizar a visualização do snapshot no virt-manager.
As capturas de tela criadas no nó PRIM ficam operacionais no nó 2 após o failover, mas não são listadas no nó 2.
* Para importar um snapshot no nó 2, você deve executar o comando:
virsh snapshot-create --redefine vm1 /var/lib/libvirt/qemu/snapshot/vm1/snapshot-name
* O comando para listar todos os snapshots da vm1 é:
virsh snapshot-list vm1
### 18. Suporte {#18-support}
* Para obter suporte, faça 2 `Snapshots` SafeKit (2 arquivos .zip), um para cada nó.
ℹ️ [Mais informações sobre o suporte aqui](https://safekit.eviden.com/pt-br/resources/safekit-support/).
## Demonstração de uma solução de alta disponibilidade em nível de máquina virtual {#demonstration-of-a-vm-level-high-availability-solution}
### Vídeo SafeKit: Agrupamento em cluster no nível da máquina virtual com Hyper-V (5:15) {#demo-hyperv}
Neste vídeo, descubra como SafeKit implementa **alta disponibilidade para Hyper-V** sem a complexidade de uma SAN. Aprenda a configurar **a replicação de máquinas virtuais** entre dois nós para garantir o failover contínuo para suas cargas de trabalho virtualizadas críticas. Embora esta demonstração use Hyper-V no Windows, a solução funciona de forma idêntica com KVM no Linux.
### Capítulos {#chapters}
1. 🎬 [Visão geral da arquitetura: 2 nós Hyper-V e 2 máquinas virtuais](https://www.youtube.com/watch?v=H18s_-_CpmU&t=0s) (0:49)
2. 🎬 [Configurando o cluster e os módulos hyperv.safe](https://www.youtube.com/watch?v=H18s_-_CpmU&t=49s) (1:59)
3. 🎬 [Teste ao vivo: replicação de VM, migração e failover automático em caso de falha](https://www.youtube.com/watch?v=H18s_-_CpmU&t=168s) (2:26)
### Implementação passo a passo {#step-by-step-implementation}
* 🛠️ [Leia o guia para configurar um cluster mirror Hyper-V no Windows.](https://safekit.eviden.com/pt-br/quick-install/safekit-quick-installation-guide-with-hyper-v/)
* 🛠️ [Leia o guia para configurar um cluster mirror KVM no Linux.](https://safekit.eviden.com/pt-br/quick-install/safekit-quick-installation-guide-with-kvm/)