Documentação · Uso
Uso diário
A sessão do vGPU OS: console do OSX-REIMS, VMs em tela cheia, monitor, som, rede das VMs, backup, reiniciar e desligar.
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.
Depois do primeiro setup, o vGPU OS se comporta como um aparelho: ligou, abriu o console do OSX-REIMS. Não há área de trabalho, login gráfico nem gerenciador de arquivos.
Ligar o computador
- O menu de boot fica escondido e o sistema inicia direto (pressione Esc enquanto ele carrega para ver o menu).
- A tela de carregamento
Starting vGPU OScobre a inicialização. - O console do OSX-REIMS abre em tela cheia.
Se uma inicialização falhar, o menu de boot volta a aparecer sozinho na seguinte, por alguns segundos.
O console do OSX-REIMS
É a mesma interface do OSX-REIMS no Ubuntu: criar, importar, gerenciar e manter VMs, ver logs. No vGPU OS ela ocupa a tela toda e o cabeçalho mostra a versão com o sufixo +vgpuos, por exemplo v0.6.0+vgpuos1. Logo abaixo do menu aparece o endereço do painel web, como Web panel: https://<endereço>.
A documentação completa do console está no site do OSX-REIMS: Console (abre em nova aba), Primeira VM (abre em nova aba) e Configurações da VM (abre em nova aba).
Diferenças no vGPU OS:
- as janelas das VMs abrem sempre em tela cheia, no mesmo compositor Wayland do console;
- a GPU de cada VM pode ser escolhida nas configurações da VM, quando há mais de uma. Veja GPUs e drivers;
- cada VM tem som, a rede em NAT ou em bridge e a taxa de atualização, como no Ubuntu (veja abaixo);
- tudo o que o console faz com as VMs também pode ser feito pelo painel web, de outro computador da rede.
Para dar o teclado ao macOS, clique na tela da VM; para devolvê-lo ao vGPU OS, pressione Ctrl+Alt+Super juntos.
Voltar do macOS para o console
A VM ocupa a tela inteira. Para voltar ao console, desligue o macOS pelo menu Apple → Desligar; a VM fecha e o console volta a aparecer. As opções de desligar, reiniciar e forçar a VM também estão no console, em Manage VMs, e no painel web.
Início automático
Nas configurações da VM, no OSX-REIMS, marque a VM para iniciar sozinha. Ao ligar o computador, o vGPU OS abre o console e a VM inicia em seguida, até a tela do macOS — sem nenhuma tecla no caminho.
Reiniciar e desligar o computador
Ao sair do console do OSX-REIMS (opção Quit), aparece um menu da sessão:
| Tecla | Ação |
|---|---|
| Enter | Abre o console de novo |
d |
O monitor: resolução e taxa de atualização |
a |
O som: por onde sai e o volume |
s |
Abre um terminal (avançado) |
r |
Reinicia o computador |
p |
Desliga o computador |
Monitor: resolução e taxa de atualização
O monitor começa no modo que ele mesmo indica como preferido, que muitas vezes é 60 Hz em um monitor capaz de 120 ou 144 Hz. Como a VM recebe a taxa do monitor quando inicia, vale escolher o modo certo:
- tecla
dno menu da sessão,vgpu-os displayem um terminal ou Este computador › Monitor no painel web; - o modo novo é testado por 15 segundos e só fica se você confirmar. Se o monitor apagar, não faça nada: o modo anterior volta sozinho;
- o modo escolhido vale para aquele monitor, naquela porta, em todas as inicializações.
vgpu-os display resetvolta ao modo do próprio monitor; - com uma VM ligada, o modo não pode ser trocado.
Cada VM também tem a própria taxa de atualização nas configurações do OSX-REIMS: automática (a do monitor, o padrão) ou uma taxa fixa.
Som
As VMs têm som: o macOS toca pela saída de som do vGPU OS, e o OpenCore toca o som de inicialização nas VMs novas. Escolha por onde o som sai — o HDMI ou DisplayPort do monitor, as caixas da placa-mãe ou um fone USB — e o volume:
- tecla
ano menu da sessão,vgpu-os soundem um terminal ou Este computador › Som no painel web.
A escolha e o volume ficam guardados para as próximas inicializações, e uma troca chega na hora a uma VM ligada. Nas configurações de cada VM, no OSX-REIMS, o som pode ser desligado.
Rede das VMs
Cada VM usa NAT, o padrão: ela sai para a internet pelo endereço do vGPU OS e só é acessada por ele. Com a bridge, a VM recebe um endereço próprio do roteador e pode ser acessada de qualquer computador da rede, enquanto o vGPU OS mantém o endereço dele.
- Ligue a bridge uma vez: no console do OSX-REIMS, Maintenance › VM network, ou no painel web, Manutenção › Rede das VMs. Ela precisa de uma porta de rede com cabo; a rede para por alguns segundos.
- Ao iniciar a VM, escolha Bridge na configuração Network dela.
Backup & Restore
Uma VM inteira pode virar um único arquivo e ser restaurada depois, por cima dela mesma ou como uma VM nova: no console do OSX-REIMS, Backup & Restore (tecla 6), ou na aba Backup & Restore do painel web.
Atenção
Os backups ficam em /opt/osx-reims/backup, no mesmo disco das VMs. Uma falha do disco ou uma reinstalação apaga os dois. Para guardar um backup, copie o arquivo para outro computador por SSH.
Terminal e acesso remoto
Para diagnóstico e manutenção, há quatro caminhos até um terminal Linux, sempre com o usuário vgpu-user:
- a opção
sdo menu da sessão; - Ctrl+Alt+F2 abre uma tela de login em texto; Ctrl+Alt+F1 volta à sessão;
- SSH a partir de outro computador da rede;
- a aba Terminal do painel web.
Para acompanhar o uso das GPUs, rode nvtop em um desses terminais.
Os comandos disponíveis estão em Comandos.