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.
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 --saveO 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 damageconfere 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 validateevgpu-os hw detectpara 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 drivernvidia, 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 provisionpara 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-usere 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
ano menu da sessão,vgpu-os soundou 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 --splashExplica 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:
- Pressione Esc enquanto o computador inicia (o menu também volta sozinho depois de um boot que falhou).
- Escolha Advanced options for vGPU OS GNU/Linux → vGPU OS rescue console.
- O console de resgate é o Debian por baixo do appliance. Digite
vgpu-os diagnosticspara o relatório completo, ouexitpara 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.