Solução de problemas

Comece sempre pelo diagnóstico: ele reúne o que é preciso para entender o problema e pode ser compartilhado com segurança.

vgpu-os diagnostics --save

O pendrive não inicia#

• Confira se o firmware está em modo UEFI (não legado/CSM).
• Desligue o Secure Boot.
• Grave a ISO de novo, no pendrive inteiro e em modo DD. Veja Instalação.
• No menu do pendrive, Advanced / Rescue ... → Check this medium for damage confere a gravação.

Tela preta ou imagem corrompida no instalador#

Escolha Install vGPU OS (safe graphics) no menu do pendrive. A instalação é a mesma, com vídeo básico; os drivers corretos são instalados depois, no primeiro setup.

O primeiro setup diz que não há internet#

O vGPU OS precisa de rede cabeada com DHCP; Wi-Fi não é suportado nesta versão. Conecte o cabo a um roteador que entregue endereço automaticamente e escolha tentar de novo.

Se a placa de rede não for reconhecida, vgpu-os diagnostics mostra a seção Network. A ISO traz firmware para placas Realtek e Broadcom (bnx2/bnx2x).

Os gráficos não validam (FAIL ou SOFTWARE)#

• Rode vgpu-os hw validate e vgpu-os hw detect para ver cada GPU, o driver em uso e se ela responde ao Vulkan.
• Confira se o monitor está ligado na GPU que você espera: a GPU do monitor precisa responder ao Vulkan.
• Com NVIDIA, confira se você autorizou o driver proprietário e se o Secure Boot está desligado.
• Se você trocou de GPU ou de porta do monitor, reinicie: o vGPU OS relê o hardware a cada inicialização. Se preciso, refaça o setup com sudo vgpu-os-firstboot --force.

Sem virtualização (KVM)#

Se vgpu-os hw validate acusa que o KVM não existe, a virtualização está desligada no firmware. Habilite Intel VT-x / Virtualization Technology ou AMD-V / SVM Mode e reinicie.

A tela de carregamento não aparece#

vgpu-os diagnostics --splash

Explica por que ela não foi desenhada. O sistema funciona sem ela.

O computador demora para ligar#

Veja a seção Boot de vgpu-os diagnostics: ela mostra o tempo total e cada etapa, com os segundos desde o início do kernel.

Console de resgate#

Quando a sessão não abre, o menu de boot tem um console de resgate:

1. Pressione Esc enquanto o computador inicia (o menu também volta sozinho depois de um boot que falhou).
2. Escolha Advanced options for vGPU OS GNU/Linux → vGPU OS rescue console.
3. O console de resgate é o Debian por baixo do appliance. Digite vgpu-os diagnostics para o relatório completo, ou exit para sair.

No pendrive, Advanced / Rescue ... → Rescue console (root shell) oferece o mesmo tipo de acesso sem usar o sistema instalado.

Problemas no OSX-REIMS ou nas VMs#

Criação de VMs, Reims vGPU, OpenCore e o macOS são assunto do OSX-REIMS: veja a solução de problemas do OSX-REIMS (abre em nova aba). O osx-reims doctor funciona igual no vGPU OS.

Pedir ajuda#

No canal #vgpu-os-chat do Discord, conte o que aconteceu, o que aparece na tela e anexe o arquivo gerado por vgpu-os diagnostics --save, para que outros membros possam analisar.