Documentação · Uso
Painel web
O painel no navegador de outro computador da rede: entrar, abas, VMs, monitor, som, backup, manutenção e terminal.
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.
Desde a versão 0.2.0, o vGPU OS tem um painel web: as VMs e o computador podem ser operados pelo navegador de outro computador, celular ou tablet da mesma rede. O monitor conectado ao vGPU OS continua sendo onde a tela das VMs aparece; o painel é o controle remoto delas.
Abrir o painel
O painel começa a funcionar quando o primeiro setup termina e fica disponível assim que o OSX-REIMS conclui a própria preparação. O endereço aparece:
- no console do OSX-REIMS, logo abaixo do menu, como
Web panel: https://<endereço>; - nas telas da sessão e na tela de login em texto (Ctrl+Alt+F2);
- no fim do primeiro setup.
Abra esse endereço no navegador e entre com o usuário vgpu-user e a senha definida na instalação.
Nota
O painel usa só HTTPS, com um certificado criado no próprio computador na instalação. Por isso, o navegador mostra um aviso de segurança na primeira vez; aceite-o para continuar. A impressão digital do certificado, para conferir, fica em /etc/vgpu-os/webui/tls.sha256. Um endereço http:// é redirecionado para o https://.
A sessão do painel termina depois de 30 minutos sem uso ou de 12 horas. O painel funciona em português e em inglês, nos temas claro e escuro, e pode ser adicionado à tela de início do celular.
Importante
Use o painel só na sua rede local. Quem tiver a senha do vgpu-user controla o computador inteiro pelo painel, inclusive pelo terminal.
Abas
| Aba | O que tem |
|---|---|
| Máquinas virtuais | As VMs, com o estado e o tempo ligado de cada uma: criar, iniciar, desligar, reiniciar, forçar o desligamento, encerrar o processo, excluir e marcar o início automático |
| Este computador | Processador, memória, placa de vídeo, discos, e os cartões Monitor e Som |
| Manutenção | As ações do menu Maintenance do console do OSX-REIMS, e a Rede das VMs |
| Backup & Restore | Backup de uma VM em um arquivo, restauração e exclusão de backups |
| Logs e diagnósticos | Os logs das execuções do OSX-REIMS, como em View logs no console |
| Terminal | Um terminal do vgpu-user no navegador |
Cada ação longa aparece em Atividade, com o andamento; a saída fica também em Logs e diagnósticos. O rodapé mostra as versões do vGPU OS e do OSX-REIMS. Reiniciar e desligar o computador também ficam no painel; com VMs ligadas, ele pede para desligá-las antes.
Máquinas virtuais
- Nova VM: número, versão do macOS e tamanho do disco. O Recovery é baixado da Apple, com uma barra de progresso, e a instalação do macOS aparece no monitor do vGPU OS.
- Iniciar: o painel mostra as configurações da VM — memória, processadores, VMs dentro do macOS, taxa de atualização, rede e som — e as guarda para os próximos inícios, como no console. Em opções avançadas ficam a instalação do OpenCore da VM na EFI do disco do macOS e o instalador conectado de novo, só naquele início, para concluir uma instalação interrompida ou reparar o macOS.
- Uma VM só inicia com a sessão do monitor ativa: a janela dela abre no monitor conectado ao vGPU OS.
As configurações de cada VM são as do OSX-REIMS: veja Configurações da VM (abre em nova aba).
Este computador
Além do hardware e do uso de cada parte, atualizado a cada 5 segundos, esta aba tem dois ajustes do próprio vGPU OS:
- Monitor: a resolução e a taxa de atualização. Um modo novo é testado por 15 segundos e só fica se você confirmar; se o monitor apagar, não faça nada e o modo anterior volta sozinho. Voltar ao modo do monitor desfaz a escolha. O modo não muda com uma VM ligada.
- Som: por onde sai o som — o HDMI ou DisplayPort do monitor, as caixas da placa-mãe ou um fone USB —, o volume, o mudo e um tom de teste.
Os dois também existem na tela do vGPU OS e por SSH: veja Uso diário.
Manutenção
As mesmas ações do menu Maintenance do console: verificar o computador (o osx-reims doctor), limpar o cache, preparar o ambiente, atualizar e recompilar o Reims vGPU, conferir a versão publicada do OSX-REIMS e excluir todas as VMs. As que exigem as VMs desligadas avisam antes.
Em Rede das VMs, a bridge é ligada ou desligada. Com ela ligada, cada VM marcada como Bridge ao iniciar 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. A bridge precisa de uma porta de rede com cabo; ao ligá-la, a rede para por alguns segundos e o painel pode desconectar e voltar. Se o computador não recuperar o endereço em um minuto, a mudança é desfeita sozinha.
Backup & Restore
- Fazer backup: a VM inteira — disco do macOS, disco de boot, identidade e configurações — vira um único arquivo compactado. Uma VM ligada é desligada antes, se você concordar. Os instaladores ficam de fora, a menos que você peça.
- Restaurar: por cima da própria VM, que volta a ser como no backup, ou como uma VM nova, com outro número.
- Excluir um backup.
Os arquivos ficam em /opt/osx-reims/backup, no mesmo disco das VMs, e são os mesmos do Backup & Restore do console. Eles protegem de um engano ou de uma atualização que deu errado, não de uma falha do disco nem de uma reinstalação: para guardar um backup, copie o arquivo para outro computador por SSH (por exemplo, com scp).
Terminal
Um shell do vgpu-user no navegador, como o terminal da sessão. Ele fecha ao sair do painel, no fim da sessão ou depois de 30 minutos sem digitar, e cada abertura fica registrada.
Uma instalação nova do vGPU OS vem com o terminal ligado. Para desligá-lo, apague a linha WEBUI_TERMINAL=on de /etc/vgpu-os/webui.conf.