Pular para o conteúdo
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.3.0, 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 e se o Secure Boot está desligado. Para instalar o driver de novo, rode sudo vgpu-os-hw provision.
  • 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.

A VM não usa a GPU NVIDIA

  • A placa precisa estar com o driver da NVIDIA: em vgpu-os hw validate, a GPU deve aparecer com o driver nvidia, as linhas VM memory e CUDA driver em OK. Com o nouveau, o driver aberto da comunidade, as VMs não rodam nela.
  • O driver é compilado no computador e não é assinado: com o Secure Boot ligado, o kernel não o carrega. Desligue o Secure Boot no firmware e reinicie.
  • Se você recusou o driver no primeiro setup, rode sudo vgpu-os-hw provision para ser perguntado de novo.

Veja GPUs e drivers.

O painel web não abre

  • Use o endereço que o console do OSX-REIMS mostra, com https://, em um computador da mesma rede.
  • Na primeira vez, o navegador mostra um aviso de segurança, porque o certificado é criado no próprio computador. Aceite o aviso para continuar; a impressão digital para conferir está em /etc/vgpu-os/webui/tls.sha256.
  • Enquanto o OSX-REIMS não termina a preparação, o painel mostra Configuração inicial pendente: conclua-a no monitor do vGPU OS.
  • Para entrar, use o usuário vgpu-user e a senha definida na instalação. Depois de muitas tentativas erradas, o painel espera alguns segundos antes de aceitar outra.

Veja Painel web.

O monitor ficou preto depois de trocar o modo

Não faça nada: o modo em teste volta sozinho ao anterior depois de 15 segundos. Se um modo salvo não funcionar mais, rode vgpu-os display reset por SSH, ou use Voltar ao modo do monitor no painel web.

A VM não tem som

  • Confira a saída escolhida: tecla a no menu da sessão, vgpu-os sound ou Este computador › Som no painel web. Use o tom de teste para ouvir cada saída.
  • O som pode estar desligado nas configurações daquela VM, no OSX-REIMS.
  • O som de inicialização do OpenCore só existe nas VMs criadas a partir do OSX-REIMS 0.6.0.

A bridge não liga

A bridge precisa de uma porta de rede com cabo; Wi-Fi não pode ser usado. Uma VM marcada como Bridge não inicia enquanto a bridge estiver desligada: ligue-a em Maintenance › VM network (ou Manutenção › Rede das VMs no painel web), ou mude a rede da VM para NAT.

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.