Procedimentos - Projeto Empresa Livre

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== 🔄 Converter Disco IDE/SATA → SCSI no Proxmox VE ======

===== 📋 Visão Geral =====

Procedimento para converter discos **IDE** ou **SATA** para **SCSI (VirtIO SCSI)** no Proxmox VE.

**Benefícios da conversão**

* Melhor desempenho de I/O
* Menor overhead de virtualização
* Melhor integração com recursos do Proxmox
* Recomendado para sistemas operacionais modernos

---

===== ⚠️ ALERTA — Backup Obrigatório =====

<WRAP important>
NÃO execute este procedimento sem backup válido da VM.
</WRAP>

A conversão altera a forma como o sistema operacional acessa o disco.

Problemas possíveis:

* Falha de boot
* ''INACCESSIBLE_BOOT_DEVICE'' (Windows)
* Disco não reconhecido
* Necessidade de reversão manual

**Boas práticas recomendadas**

* Backup completo da VM
* Snapshot da VM (quando aplicável)
* Backup externo / PBS

**Checklist pré-mudança**

^ Item ^ Esperado ^
| Backup realizado | Sim |
| VirtIO ISO disponível | Sim |
| Janela de manutenção | Sim |
| Plano de retorno conhecido | Sim |

---

===== 🧭 Escolha o Método =====

^ Método ^ Indicado para ^
| **Opção 1 — GUI / Método Seguro** | Windows / Aprendizado |
| **Opção 2 — Shell / CLI** | Linux / Administração rápida |

---

====== 🖥️ Opção 1 — GUI / Método Seguro (Windows — Recomendado) ======

<WRAP tip>
Método recomendado para ambientes Windows e para quem está aprendendo.
</WRAP>

**Fluxo do procedimento**

<code>
Instalar VirtIO + QEMU Guest Agent
↓
Validar Windows
↓
Desligar VM
↓
Adicionar disco SCSI teste
↓
Validar reconhecimento do driver
↓
Desligar VM
↓
Converter disco principal
↓
Ajustar boot
↓
Inicializar
↓
Validar
↓
Remover disco teste
</code>

---

===== Etapa 1 — Instalar VirtIO e QEMU Guest Agent =====

Adicionar ISO VirtIO.

Caminho:

<code>
VM → Hardware → CD/DVD Drive → virtio-win.iso
</code>

Inicializar a VM.

Dentro do Windows instalar:

* VirtIO SCSI Driver
* QEMU Guest Agent
* Balloon Driver (opcional)
* Drivers de rede VirtIO (opcional)

Reiniciar o Windows.

Opcionalmente habilitar o guest agent:

<code>
VM → Options → QEMU Guest Agent → Enabled
</code>

---

===== Etapa 2 — Validar instalação =====

Confirmar:

* Windows inicia normalmente
* Login funcional
* Drivers instalados corretamente

Validação opcional do Guest Agent.

No host:

<code bash>
qm config VMID | grep agent
</code>

Esperado:

<code>
agent: 1
</code>

Teste opcional:

<code bash>
qm guest cmd VMID get-osinfo
</code>

Exemplo:

<code bash>
qm guest cmd 100 get-osinfo
</code>

Após validar:

**Desligar a VM**

<code>
VM → Shutdown
</code>

---

===== Etapa 3 — Configurar controlador SCSI =====

No Proxmox:

<code>
VM → Hardware → SCSI Controller
</code>

Selecionar:

<code>
VirtIO SCSI Single
</code>

Adicionar disco temporário.

Caminho:

<code>
VM → Hardware → Add → Hard Disk
</code>

Configurar:

* Bus/Device → **SCSI**
* Size → **1 GB**

Inicializar VM.

---

===== Etapa 4 — Validar reconhecimento do controlador =====

Dentro do Windows:

Abrir:

<code>
Gerenciamento de Disco
</code>

Executar:

* Inicializar disco
* Criar volume simples
* Atribuir letra **D:**
* Formatar volume

Criar arquivo de validação:

<code>
D:\virtio-scsi-validado.txt
</code>

<WRAP tip>
O disco D: existe apenas para validar que o Windows reconheceu corretamente o controlador VirtIO/SCSI antes da migração do disco do sistema (C:).
</WRAP>

**Resultado esperado**

Windows reconhece normalmente a unidade **D:**.

<WRAP warning>
Não prossiga se:

* Disco não aparecer
* Driver apresentar erro
* Windows não reconhecer o dispositivo

  </WRAP>

Após validar:

**Desligar novamente a VM**

<code>
VM → Shutdown
</code>

---

===== Etapa 5 — Converter disco principal =====

No Proxmox:

<code>
VM → Hardware
</code>

Localizar o disco atual.

Exemplos:

<code>
IDE0
ou
SATA0
</code>

Executar:

* Selecionar disco atual
* Clicar **Detach**

O disco passará para a seção **Unused Disk**.

Agora reanexar o mesmo disco.

Caminho:

<code>
VM → Hardware → Unused Disk → Edit
</code>

Configurar:

<code>
Bus/Device → SCSI0
</code>

Salvar alterações.

---

===== Etapa 6 — Ajustar ordem de boot =====

Caminho:

<code>
VM → Options → Boot Order
</code>

Configurar:

<code>
SCSI0
</code>

como primeiro dispositivo de boot.

---

===== Etapa 7 — Inicializar e validar =====

Inicializar a VM.

Confirmar:

* Windows inicia normalmente
* Login funcional
* Disco **C:** operacional
* Sem BSOD
* Aplicações funcionando

---

===== Etapa 8 — Remover disco temporário =====

Após validar o boot normal.

No Proxmox:

<code>
VM → Hardware
</code>

Selecionar o disco temporário de 1GB.

Executar:

* **Detach**
* **Remove**

<WRAP info>
O disco temporário foi utilizado apenas para validar o funcionamento do driver VirtIO/SCSI.
</WRAP>

Conversão concluída.

---

===== 🚑 Procedimento de Retorno — BSOD / INACCESSIBLE_BOOT_DEVICE =====

<WRAP important>
Se o Windows não iniciar após a conversão, utilize este procedimento de retorno.
</WRAP>

Parar VM.

No Proxmox:

<code>
VM → Hardware
</code>

Executar:

* Detach do **SCSI0**
* Reanexar o disco original em **IDE0** ou **SATA0**

Depois ajustar:

<code>
VM → Options → Boot Order
</code>

Restaurar boot original.

Inicializar novamente.

---

====== ⌨️ Opção 2 — Shell / CLI ======

<WRAP tip>
Método indicado para Linux, automação ou administração rápida.
</WRAP>

**Fluxo do procedimento**

<code>
Verificar configuração
↓
Configurar controlador
↓
Converter disco
↓
Ajustar boot
↓
Inicializar
↓
Validar
</code>

---

===== Etapa 1 — Verificar configuração atual =====

Verificar configuração da VM:

<code bash>
qm config VMID
</code>

Verificar controlador SCSI:

<code bash>
qm config VMID | grep scsihw
</code>

---

===== Etapa 2 — Configurar controlador SCSI =====

Caso necessário:

<code bash>
qm set VMID --scsihw virtio-scsi-single
</code>

---

===== Etapa 3 — Converter disco =====

IDE → SCSI

<code bash>
qm set VMID --scsi0 local-lvm:vm-100-disk-0
qm set VMID --delete ide0
</code>

SATA → SCSI

<code bash>
qm set VMID --scsi0 local-lvm:vm-100-disk-0
qm set VMID --delete sata0
</code>

---

===== Etapa 4 — Ajustar boot =====

<code bash>
qm set VMID --boot order=scsi0
</code>

---

===== Etapa 5 — Inicializar e validar =====

Inicializar:

<code bash>
qm start VMID
</code>

Validar:

* Sistema iniciou normalmente
* Disco operacional
* Sem erros de boot

---

===== 📚 Referência =====

https://pve.proxmox.com/pve-docs/