Pular para o conteúdo
Documentação: Atualizar e remover

Documentação · Uso

Atualizar e remover

Instale uma nova versão do OSX-REIMS ou remova-o do computador.

Alfa

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 --check

Com o osx-reims update

Desligue todas as VMs, baixe o .deb da versão nova no canal e rode:

osx-reims update

Sem 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.deb

No 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:

  1. 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
  2. Instale o pacote novo por cima do atual:

    sudo apt install ./osx-reims_<versão>_amd64.deb

    Se 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-reims

A 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.