Pular para o conteúdo
vGPU OS
Documentação: Solução de problemas

Documentação · Ajuda

Solução de problemas

Gráficos seguros, rede, gráficos que não validam, console de resgate e como pedir ajuda com o diagnóstico certo.

Alfa

Esta documentação corresponde ao vGPU OS 0.1.2, em estágio alfa. Telas e comandos podem mudar entre versões; para saber a versão instalada, use vgpu-os version.

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

Importante

O vGPU OS não tem suporte técnico e é fornecido sem garantias. O canal #vgpu-os-chat é um espaço de ajuda entre membros: a ajuda é voluntária, e não há garantia de resposta, de prazo ou de solução. Pedidos de suporte por e-mail não são respondidos.

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.