Documentação · Uso
Console
O menu do OSX-REIMS: criar e gerenciar VMs, ver logs e fazer a manutenção do computador.
Esta documentação corresponde ao OSX-REIMS 0.3.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 console é o menu do OSX-REIMS no terminal. Ele reúne o que é preciso no dia a dia: criar e gerenciar VMs, ver logs e fazer a manutenção do computador.
Abrir o console
- No menu de aplicativos, abra OSX-REIMS. O console abre em uma janela de terminal, com 160 × 35 caracteres no Ptyxis, o terminal padrão do Ubuntu, e no GNOME Terminal. A janela fecha quando você sai; se o console terminar com erro, ela fica aberta até você pressionar Enter.
- Ou, em um terminal, rode:
osx-reimsO console precisa de um terminal interativo. Para automatizar, use os comandos.
Tela principal
A tela principal lista as VMs, com número, versão do macOS e estado de cada uma, e mostra o menu:
| Tecla | Opção |
|---|---|
1 |
Create new VM: cria uma VM (veja Primeira VM) |
2 |
Import VM disk: cria uma VM a partir do disco QCOW2 de um macOS já instalado em outra VM (veja Importar uma VM) |
3 |
Manage VMs: inicia, desliga e reinicia VMs |
4 |
View logs: lista os logs recentes |
5 |
Maintenance: apaga VMs, limpa o cache e confere o computador |
Q |
Quit: sai do console |
Basta pressionar a tecla da opção.
Nota
Enquanto o ambiente não estiver pronto (no primeiro uso ou depois de uma atualização), a tela mostra o motivo e oferece S (Prepare environment), que roda o osx-reims setup. Criar, importar e gerenciar VMs ficam indisponíveis até lá.
Gerenciar VMs
Manage VMs lista as VMs e pergunta o número. Com a VM desligada, o console pergunta a memória, os processadores e, se ela já passou pela primeira inicialização, qual OpenCore usar. Depois, inicia a VM.
Se a VM escolhida já estiver rodando, o console oferece:
| Tecla | Opção |
|---|---|
S |
Shut down: o macOS fecha tudo com segurança (recomendado) |
R |
Restart: reinicia à força, sem salvar |
F |
Force power off: corta a energia da VM |
T |
Terminate process: para quando a VM não responde |
C |
Cancel: não faz nada |
Ao desligar, o OSX-REIMS espera o macOS por até 60 segundos. Se ele não desligar, pode haver uma confirmação na janela da VM ou um app impedindo o desligamento. Então você escolhe entre Wait longer (esperar mais), Force power off (forçar o desligamento) e Cancel (a VM continua ligada).
Com a VM aberta
A VM abre na própria janela. Para desligá-la, use o menu Apple › Desligar, dentro do macOS. Mantenha o terminal aberto enquanto usa a VM.
No terminal, estas teclas agem sobre a VM. Pressione a mesma tecla duas vezes em até 5 segundos para confirmar:
| Tecla | O que faz |
|---|---|
S |
Pede ao macOS para desligar |
R |
Reinicia a VM à força |
F |
Desliga a VM à força; o que não foi salvo se perde |
T |
Encerra o processo da VM; o que não foi salvo se perde |
O primeiro Ctrl+C só avisa que a VM continua rodando; um segundo, em até 5 segundos, pede ao macOS para desligar. Fechar o terminal não desliga a VM.
Ver logs
View logs lista as 15 execuções mais recentes, com data, ação, VM e resultado. Digite o número de um log e pressione Enter para abri-lo; setas e PgUp/PgDn rolam o texto, e Q volta. Enter sem número volta ao menu.
| Resultado | Significado |
|---|---|
| Done | A ação terminou |
| Nothing was done | Nada foi feito |
| Cancelled | A ação foi cancelada |
| Failed | A ação falhou |
| Terminal closed with the VM running | O terminal foi fechado com a VM ligada |
| unfinished | A ação está em andamento ou foi interrompida |
Os logs ficam em /opt/osx-reims/logs/, e os 100 mais recentes são mantidos. Para pedir ajuda, compartilhe o log da execução com o problema e um log do doctor (veja Solução de problemas).
Manutenção
| Tecla | Opção |
|---|---|
1 |
Delete a VM: apaga uma VM desligada |
2 |
Delete all VMs: apaga todas as VMs, que precisam estar desligadas |
3 |
Clean cache: apaga os instaladores do macOS baixados |
4 |
Check this computer: roda o doctor, cujo log é o que você compartilha ao pedir ajuda |
5 |
Prepare environment: roda o setup |
6 |
Update Reims vGPU: versão testada ou mais recente, com as VMs desligadas |
B |
Back: volta ao menu principal |
Apagar VMs e limpar o cache sempre pedem confirmação, e a resposta padrão é não. Apagar uma VM não pode ser desfeito.