Pular para o conteúdo
Documentação: Versão do Reims vGPU

Documentação · Uso

Versão do Reims vGPU

Versão testada ou mais recente: como escolher, atualizar e voltar.

Alfa

Esta documentação corresponde ao OSX-REIMS 0.6.0, em estágio alfa. Comandos e opções podem mudar entre versões; na dúvida, confira osx-reims --help na versão instalada.

O OSX-REIMS usa o Reims vGPU (abre em nova aba), baixado do repositório original para /opt/reims-vgpu e compilado no seu computador. Cada versão do OSX-REIMS é testada com um commit específico do Reims vGPU, mas você pode escolher qual versão seguir.

Nota

O OSX-REIMS e o Reims vGPU são projetos independentes, de autores diferentes. O OSX-REIMS usa o Reims vGPU como software de terceiros, sob a licença dos seus autores, e não participa do seu desenvolvimento.

Testada ou mais recente

Versão O que é
Tested (testada) O commit testado com a sua versão do OSX-REIMS. É o padrão e a opção recomendada
Latest (mais recente) O commit mais novo do branch master do Reims vGPU, ainda não testado com o OSX-REIMS

No OSX-REIMS 0.6.0, a versão testada é o commit c099dd5a, já no Reims vGPU reescrito (veja abaixo). Até a 0.4.1, era o commit 69a57dd6.

A escolha é feita na primeira execução do osx-reims setup e fica salva. O osx-reims doctor mostra qual versão o computador segue.

Atenção

A versão mais recente pode trazer correções e novidades, mas também pode não compilar ou impedir as VMs de iniciar. Se isso acontecer, volte para a testada.

Trocar de versão ou atualizar

Com todas as VMs desligadas, rode:

osx-reims update-reims

Ou, no console, escolha Maintenance › Update Reims vGPU. O comando:

  1. pergunta qual versão seguir, oferecendo a escolha atual;
  2. mostra o commit atual, o novo, quantos commits mudam e a versão seguida;
  3. pede confirmação; para uma versão não testada, a resposta padrão é não;
  4. baixa o novo commit e compila o Reims vGPU: primeiro a biblioteca dele, depois o QEMU com ela. A compilação leva alguns minutos, e as VMs não podem iniciar até ela terminar.

Se o Reims vGPU já estiver no commit escolhido, nada é compilado. Para compilar de novo mesmo assim, use osx-reims setup --rebuild.

Quem segue a versão mais recente não recebe commits novos sozinho: rode osx-reims update-reims de novo para buscar o commit mais novo do master. O setup mantém o commit que já está compilado.

Recompilar a mesma versão do zero

Uma compilação que funcionava pode parar de funcionar depois de uma atualização do sistema, que move bibliotecas sob uma compilação já feita, ou depois de uma compilação interrompida no meio. Com todas as VMs desligadas:

osx-reims rebuild-reims

No console, o mesmo está em Maintenance › Rebuild Reims vGPU. Ele compila o QEMU-Reims de novo, do zero, no mesmo commit: nada é baixado e a versão seguida não muda. É diferente do setup --rebuild, que compila por cima da pasta existente — o que não resolve quando o problema é justamente a pasta.

A compilação atual não é apagada primeiro: ela é movida para o lado e removida só quando a nova passa nas mesmas verificações que o setup faz. Se a compilação ou as verificações falharem, ou se você interromper com Ctrl+C, a anterior volta ao lugar e as VMs iniciam como antes. O comando para antes de mudar qualquer coisa quando o código-fonte do QEMU está ausente ou em outro commit, quando a pasta de compilação tem arquivos de outro usuário ou quando há menos de 3 GB livres ao lado do Reims vGPU.

Se a nova versão falhar

Se o novo commit não compilar ou não passar nas verificações, o update-reims volta para o commit que funcionava e o compila de novo, então as VMs continuam iniciando como antes. O log mostra o que falhou.

Se a nova versão compilar, mas as VMs não iniciarem com ela, volte para a testada:

osx-reims update-reims --tested

As correções do OSX-REIMS no Reims vGPU

O OSX-REIMS aplica correções próprias ao Reims vGPU durante a compilação e as desfaz logo depois, então a pasta /opt/reims-vgpu fica como o commit dela. Elas foram feitas para o commit testado:

  • uma corrige a janela preta de uma VM em uma GPU NVIDIA em compositores sem sincronização explícita, como o do vGPU OS;
  • outra faz o seletor do OpenCore, o logo da Apple e o Recovery do macOS serem desenhados a cerca de 60 quadros por segundo, em vez de 10.

Em outro commit (a versão mais recente ou um commit escolhido), uma correção que não se aplica mais é deixada de fora, com um aviso no log do setup (building without it). Para voltar ao commit testado e às correções, use osx-reims update-reims --tested.

O Reims vGPU reescrito

O OSX-REIMS 0.6.0 é testado com um commit posterior à reescrita do Reims vGPU, que trocou o projeto inteiro: o macOS passa a ver o dispositivo gráfico apple-gfx-pci do QEMU, que usa o driver da própria Apple, e a biblioteca do Reims vGPU é ligada ao QEMU. A janela da VM também é nova: clique nela para o macOS receber o teclado e use Ctrl+Alt+Super para devolvê-lo ao Ubuntu.

Ao instalar a 0.6.0 por cima de uma versão anterior, o Reims vGPU que está no computador ainda é o de antes da reescrita, e o start avisa: This version of OSX-REIMS needs the new Reims vGPU. Com todas as VMs desligadas, rode:

osx-reims update-reims --tested

Ele leva o Reims vGPU para o commit novo, limpa o que sobrou da compilação antiga e compila de novo (cerca de 3 minutos, além do download). As VMs existentes continuam com os próprios discos, identidade e configurações. A compilação antiga, em /opt/reims-vgpu/vendor/qemu/build, não é apagada: ela pode ser removida depois, para recuperar o espaço.

Ao instalar uma nova versão do OSX-REIMS

Uma nova versão do OSX-REIMS pode ser testada com outro commit do Reims vGPU. Se o computador segue a versão testada e ela mudou, a instalação do pacote avisa para rodar osx-reims update-reims, com as VMs desligadas. Se ele segue a mais recente ou um commit escolhido, a instalação lembra que a atualização fica por sua conta.

Commit específico (avançado)

A opção --reims-ref <ref> do setup e do update-reims aceita um commit, tag ou branch do Reims vGPU. Essa escolha não é testada e fica salva até você escolher --tested ou --latest.

Nota

Alterações locais em /opt/reims-vgpu interrompem o setup e o update-reims: nada é limpo nem desfeito automaticamente.