Documentação · Uso
Atualizar e remover
Instale uma nova versão do OSX-REIMS ou remova-o do computador.
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.
Atualizar o OSX-REIMS
Cada nova versão é baixada pelo botão Gerar meu link de download no canal #osx-reims do Discord dos membros, com o pacote .deb e a soma de verificação .sha256 (veja Obtendo o OSX-REIMS). O que mudou em cada versão está nas Notas de versão.
A tela principal do console mostra uma linha quando existe uma versão mais nova publicada. Para conferir pelo terminal:
osx-reims update --checkCom o osx-reims update
Desligue todas as VMs, baixe o .deb da versão nova no canal e rode:
osx-reims updateSem um arquivo, o comando procura osx-reims_*.deb na pasta Downloads, na Área de Trabalho, na sua pasta pessoal e na pasta atual, e pergunta qual usar. Você também pode indicar o arquivo:
osx-reims update ~/Downloads/osx-reims_0.6.0_amd64.debNo console, o mesmo está em Maintenance › Update OSX-REIMS; depois de atualizar, o console se fecha, para que a próxima janela abra já na versão instalada.
O comando confere o arquivo, compara as versões e instala com o apt. Ele também confere a impressão digital (SHA-256) contra a publicada, que chega ao computador por um caminho diferente do arquivo: um arquivo com a versão publicada, mas impressão digital diferente, não é instalado.
Nota
Clicar duas vezes no .deb não funciona para atualizar: a Central de Aplicativos do Ubuntu mostra um pacote cujo nome já está instalado como "Instalado", sem comparar as versões, e o botão fica cinza. É por isso que o osx-reims update existe.
Pelo apt
O caminho antigo continua valendo, e é o único possível na primeira instalação:
-
Baixe os dois arquivos para a mesma pasta, abra um terminal nela e confira o download:
sha256sum -c osx-reims_<versão>_amd64.deb.sha256 -
Instale o pacote novo por cima do atual:
sudo apt install ./osx-reims_<versão>_amd64.debSe o apt terminar com uma linha que começa com
Notice: Download is performed unsandboxed as root, tudo bem: ela é normal quando o arquivo está na pasta pessoal.
Depois de atualizar
Faça o que a instalação pedir no final:
osx-reims setup, quando a nova versão traz um programa de inicialização das VMs novo ou um texto de licença novo, que precisa ser aceito. Ele pode ser rodado quantas vezes for preciso e não muda o que já está pronto;osx-reims update-reims, com todas as VMs desligadas, quando o Reims vGPU também precisa ser atualizado (veja Versão do Reims vGPU).
VMs em execução não são afetadas pela instalação pelo apt; o osx-reims update exige que todas estejam desligadas, porque o pacote substitui arquivos que uma VM em execução está usando. As VMs, os instaladores baixados e os logs são mantidos.
Dica
Vindo da 0.4.1: com todas as VMs desligadas, instale o pacote e rode osx-reims update-reims --tested. A 0.6.0 usa o Reims vGPU reescrito, e esse comando o atualiza, recompila e instala o novo programa de inicialização das VMs. A licença continua aceita, e as VMs mantêm discos, identidade e configurações. A configuração memória da GPU deixa de existir. Veja O Reims vGPU reescrito.
Remover o OSX-REIMS
sudo apt remove osx-reimsA remoção apaga só os arquivos do programa. Nada do que você criou é apagado:
| Caminho | O que é |
|---|---|
/opt/osx-reims/cache, full, logs e state |
Instaladores baixados, imagens completas, logs e o estado do setup |
/opt/osx-reims/backup |
Os backups das VMs |
/opt/reims-vgpu |
O Reims vGPU e as VMs, em vm/disks |
~/.cargo e ~/.rustup |
O Rust |
A mensagem no fim da remoção lista esses caminhos. Apague-os você mesmo se não precisar mais deles.
Importante
Se você ligou a ponte de rede das VMs, rode osx-reims network bridge off antes de remover o pacote: a remoção não desfaz a ponte, porque o computador pode estar usando essa mesma rede.
Se o seu terminal é o Ptyxis, o lançador também guarda as configurações da janela do console em ~/.local/state/osx-reims/ptyxis.
Se alguma VM tinha início automático, o serviço deixa de fazer efeito com a remoção do pacote, porque o programa que ele chamaria não está mais lá. O login automático do Ubuntu, se você o tiver ligado, é uma configuração do próprio sistema e continua valendo: desligue-o nas Configurações do Ubuntu, ou com osx-reims autostart off --no-login antes de remover o pacote.
Cuidado
As VMs ficam dentro de /opt/reims-vgpu. Apagar essa pasta apaga todas as VMs e o macOS instalado nelas, sem volta.
Para remover o Rust instalado pelo setup, use rustup self uninstall. O sudo apt purge osx-reims remove também a configuração do KVM em /etc/modprobe.d/osx-reims-kvm.conf e a de memória em /etc/sysctl.d/60-osx-reims.conf, mas continua sem apagar os seus dados. O seu usuário continua nos grupos kvm, render e video.
Fim da assinatura
Quando a assinatura de membro termina, a licença deixa de valer e o OSX-REIMS deve ser removido do computador. As VMs e os demais dados que você criou continuam sendo seus. Veja Licença.