Pular para o conteúdo
vGPU OS
Documentação: Primeiro setup

Documentação · Começando

Primeiro setup

O que acontece na primeira inicialização: rede, hardware, drivers de vídeo, OSX-REIMS e validação dos gráficos.

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.

Na primeira inicialização depois da instalação, o vGPU OS termina de configurar o computador sozinho. É aqui que os drivers de vídeo são escolhidos para a sua máquina. O cabo de rede precisa estar conectado.

Tela de carregamento

Entre o menu de boot e qualquer tela do vGPU OS aparece a tela de carregamento, com Starting vGPU OS: pode levar um minuto e o console abre sozinho. Não troque de terminal (Ctrl+Alt+F1 a F6) enquanto ela estiver na tela.

As cinco etapas

A tela de boas-vindas (Welcome to vGPU OS 0.1.2) lista o que será feito:

  1. Conferir a rede. Sem internet, o setup explica que precisa de uma conexão cabeada com DHCP e pergunta se deve tentar de novo — conecte o cabo e confirme.
  2. Examinar o hardware. Processador, virtualização, KVM, IOMMU e cada GPU, com o driver em uso e em qual delas o monitor está ligado.
  3. Instalar os drivers de vídeo. O setup mostra o plano — pacotes de driver e firmware do Debian para cada GPU, módulos do kernel e, se houver IOMMU, a linha do kernel proposta — e pergunta Install it now?. Nada é instalado sem essa confirmação.
  4. Instalar o OSX-REIMS, incluindo o que ele precisa para compilar o Reims vGPU.
  5. Validar os gráficos, conferindo que a GPU responde de verdade ao Vulkan — não uma renderização por software.

O disco não é alterado além da instalação de programas.

Perguntas opcionais

  • IOMMU. Se o firmware oferece IOMMU, o setup pergunta se deve ativá-lo no kernel. Não é necessário para o Reims vGPU; aceitar exige uma reinicialização.
  • NVIDIA. Com uma GPU NVIDIA, o setup pergunta se deve instalar o driver proprietário do repositório non-free do Debian e o Vulkan da NVIDIA. O CUDA nunca é instalado.

Uma reinicialização automática

O firmware de algumas GPUs só é lido quando o driver inicia. Quando isso acontece, o setup avisa que o computador vai reiniciar e continuar sozinho — nada mais é necessário. Depois do reinício aparece Continuing the first setup after the restart.

Resultado

O setup termina com First setup is finished. e o veredito dos gráficos:

Estado Significado
READY A GPU foi validada com Vulkan (Graphics: ready na tela). Tudo pronto
SOFTWARE Não há GPU utilizável (ou você aceitou renderização por software). O macOS fica muito lento
FAIL A GPU não passou na validação. O OSX-REIMS não é preparado; veja Solução de problemas

O OSX-REIMS abre em seguida

Com os gráficos prontos, o console do OSX-REIMS abre sozinho, em tela cheia. Na primeira vez ele:

  1. mostra a licença do OSX-REIMS, que precisa ser aceita neste computador;
  2. prepara o ambiente em etapas — sistema, GPU e Vulkan, grupos, KVM, Rust, download e compilação do Reims vGPU e do QEMU dele. A senha do vgpu-user pode ser pedida nas etapas que precisam de administrador.

A compilação baixa código do GitHub e leva vários minutos. Ao final aparece o menu principal do OSX-REIMS, pronto para Create new VM. Para criar e operar VMs, siga a documentação do OSX-REIMS: Primeira VM (abre em nova aba).

Refazer o primeiro setup

Se o setup parou no meio (sem rede, por exemplo) ou você trocou a GPU, é possível rodá-lo de novo pelo terminal:

sudo vgpu-os-firstboot --force

Veja como abrir um terminal em Comandos.