Documentação · Começando
Importar uma VM
Crie uma VM a partir do disco QCOW2 de um macOS já instalado em outra VM, como no OSX-PROXMOX.
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.
Se você já tem um macOS instalado em outra VM, como no OSX-PROXMOX, o OSX-REIMS pode criar uma VM a partir do disco dela, sem baixar nem instalar o macOS de novo.
Antes de começar
O disco precisa:
- estar no formato QCOW2 (
.qcow2); - não depender de outro arquivo (sem backing file);
- não estar em uso por uma VM ligada;
- passar na verificação do
qemu-img check, sem erros.
Também é preciso ter espaço livre na pasta das VMs para os dados do disco, mais uma pequena margem: o disco é copiado de verdade para a nova VM.
Dica
Um disco em outro formato, ou que depende de outro arquivo, pode ser convertido antes em um único disco QCOW2. Por exemplo: qemu-img convert -O qcow2 disco.img disco.qcow2.
Importar pelo console
Abra o console e escolha Import VM disk (tecla 2). O OSX-REIMS mostra as VMs existentes e pergunta:
- Número da nova VM, de 10 a 99. O padrão é o primeiro número livre.
- Caminho do disco QCOW2. Você pode arrastar o arquivo do gerenciador de arquivos para o terminal.
- Versão do macOS no disco: Ventura (13), Sonoma (14), Sequoia (15), Tahoe (26) ou Other, uma versão não testada com o OSX-REIMS. Ela é a versão mostrada na lista de VMs. Se o caminho do arquivo tiver o nome de uma versão, ela vem como padrão.
Depois do resumo, com o número da VM, a versão, o tamanho do disco e quantos dados serão copiados, confirme Import the VM?. O OSX-REIMS então:
- confere o disco;
- gera a identidade da VM e o disco de inicialização com o OpenCore;
- copia o disco do macOS para a VM e confere a cópia.
No fim, o console oferece iniciar a VM na hora: pressione S.
Nota
Se o disco não tiver uma partição APFS ou HFS+, o OSX-REIMS avisa que ele não parece ser um disco de macOS e pergunta se deve importar mesmo assim. A resposta padrão é não.
Depois da importação
- O arquivo original não é alterado e deixa de ser usado: você pode apagá-lo depois.
- A VM aparece como Ready for first use. Na primeira inicialização, o macOS inicia pelo disco importado, com o disco de inicialização da própria VM.
- A VM recebe uma identidade nova: número de série, MLB, UUID, ROM e endereço MAC. Por isso, os serviços da Apple podem pedir para você entrar de novo na conta.
- Memória e processadores são escolhidos a cada inicialização, como em qualquer VM. O disco mantém o tamanho que já tinha.
Pelo terminal
osx-reims import -d ~/Downloads/macos.qcow2 -m tahoe| Opção | O que faz |
|---|---|
-i, --id <n> |
Número da VM, de 10 a 99 (padrão: o primeiro livre) |
-d, --disk <arquivo> |
Disco QCOW2 a importar |
-m, --macos <nome> |
ventura, sonoma, sequoia, tahoe ou other (com -y, o padrão é a versão citada no caminho do disco; senão, other) |
-y, --yes |
Não faz perguntas e exige --disk; um disco sem partição APFS ou HFS+ é importado com um aviso |
--debug |
Inclui o rastreamento do bash no log |
Mensagens comuns
| Mensagem | O que fazer |
|---|---|
… is not a QCOW2 disk |
Converta o disco para QCOW2 antes, com qemu-img convert -O qcow2 |
… depends on another file |
Una os arquivos em um único disco, com qemu-img convert -O qcow2 |
… is in use by a running VM |
Desligue a VM que usa o disco e tente de novo |
… has errors (qemu-img check) |
Repare o disco ou exporte-o de novo da VM de origem |
Not enough disk space |
Libere espaço na pasta das VMs: a importação precisa de espaço para os dados do disco |
O log de cada importação fica em /opt/osx-reims/logs/, com import no nome do arquivo.