Solução da comunidade

Como corrigir o erro «Falha ao carregar a tabela dm» durante uma atualização do ZimaOS

A ZimaCube owner hit a dm-table error while updating from an early ZimaOS release. The working solution was to move through an intermediate ZimaOS version before attempting the 1.4.0 upgrade again.

O que significa, neste caso, “Failed to Load dm Table: Invalid Argument”?

Em abril de 2025, um novo proprietário de um ZimaCube comunicou que uma atualização para o ZimaOS 1.4 falhou com o erro Failed mounting bundle: Failed to load dm table: Invalid argument. A mesma falha ocorreu tanto através da atualização disponibilizada automaticamente como após a transferência manual da imagem da versão.

O detalhe fundamental era a versão inicial. Um membro da equipa da IceWhale afirmou que se tinha deparado recentemente com o problema e perguntou se a versão instalada era anterior à 1.2.5.

Que correção recomendou a equipa da IceWhale?

A recomendação da equipa dependia da versão: se o sistema estivesse numa versão anterior à ZimaOS 1.2.5, deveria primeiro ser feita uma atualização offline para a 1.2.5 e só depois a atualização para a 1.4.0. Tratava-se de um percurso de atualização faseado para versões iniciais, não de uma correção universal para todos os erros de atualização atuais.

O autor original começou com o ZimaOS 1.2.1 e comunicou mais tarde que uma atualização offline para a 1.3.3 foi bem-sucedida, após a qual a atualização normal para a 1.4.0 funcionou.

Como funciona atualmente o processo de atualização offline?

O atual guia de atualização offline do ZimaOS instrui os utilizadores a transferirem o pacote de instalação RAUCB adequado, colocá-lo no diretório de atualização offline, aguardarem que o ZimaOS o detete e, em seguida, executarem a atualização através da interface.

Versão do ZimaOS Diretório do pacote offline
Anterior à 1.4.1 /ZimaOS-HD/rauc/offline/
1.4.1 e posteriores /ZimaOS-HD/.ota/offline/

Esta alteração do diretório é importante porque a resposta da comunidade de 2025 remetia para um fluxo de atualização offline mais antigo. Não utilize automaticamente o caminho antigo numa versão atual.

O que deve fazer se vir o mesmo erro hoje?

  1. Registe a versão exata do ZimaOS instalada.
  2. Registe a versão de destino e a mensagem de erro completa.
  3. Se estiver a atualizar a partir de uma versão inicial 1.2.x para a 1.4.0, a solução de atualização faseada deste tópico é diretamente relevante.
  4. Para versões mais recentes, siga a documentação atual de atualização offline do ZimaOS.
  5. Utilize o pacote RAUCB destinado à versão de destino e o diretório adequado à sua versão atual.
  6. Faça uma cópia de segurança dos dados importantes antes de efetuar uma recuperação ou alterações de versão em várias etapas.

Perguntas frequentes

O hardware do ZimaCube tinha defeito?

O tópico não comprova a existência de uma falha de hardware. O problema foi resolvido alterando o percurso de atualização do software.

Todos os utilizadores do ZimaOS devem atualizar primeiro para a 1.2.5?

Não. Essa recomendação destinava-se especificamente a sistemas anteriores à 1.2.5 que tentavam chegar ao ZimaOS 1.4.0.

Onde devo colocar agora um pacote de atualização offline?

A documentação atual utiliza /ZimaOS-HD/.ota/offline/ para a versão 1.4.1 e posteriores, enquanto as versões mais antigas utilizam /ZimaOS-HD/rauc/offline/.