3CX - Falha ao instalar atualização V18: Erros comuns e como corrigi-los


  •  

Durante uma análise recente, identificamos os dois principais problemas responsáveis pela falha na atualização dos sistemas: APT bloqueado ou listas de fontes de terceiros não suportadas.

Bloqueio APT

66% dos sistemas em que a atualização é interrompida normalmente é devido a um processo APT travado. Especificamente, a maioria desses sistemas possui um processo de atualização apt que começou em 2021 e permaneceu travado desde então. A solução para isso é simplesmente reiniciar o sistema antes de tentar atualizar.

Você pode identificar se o seu sistema se enquadra nos 66% descritos acima verificando as primeiras linhas do log enviado ao e-mail do administrador após uma atualização malsucedida. Se o log contiver entradas semelhantes às abaixo, a reinicialização do sistema deve resolver o problema e permitir que a atualização continue.

Exemplo de atualizações abortadas devido ao bloqueio do APT:

[19:06:24] Failed: Output of ps aux (apt lock)

/var/lib/apt/lists/lock:
root 15914 0.0 0.1 45940 7548 ? S 2021 14:40 | \_ apt-get update
root 11289 0.0 0.0 12780 916 ? S 19:06 0:0 | \_ grep 15914

[08:14:52] Failed: Output of ps aux (apt lock)

/var/lib/apt/lists/lock:
root 11550 0.0 0.1 45976 7816 ? S Sep24 4:24 | \_ apt-get update
root 28281 0.0 0.0 12780 928 ? S 08:14 0:00 | \_ grep 11550

[14:27:53] Failed: Output of ps aux (apt lock)

/var/lib/apt/lists/lock:
root 14734 0.0 0.4 46288 8336 ? S Sep26 6:04 | \_ apt-get update
root 26262 0.0 0.0 12780 984 ? S 14:27 0:00 | \_ grep 14734

Listas de fontes de terceiros

18% das atualizações abortadas são devido a listas de fontes de terceiros no diretório /etc/apt/sources.list.d/. Para garantir uma atualização tranquila, a 3CX deve minimizar a possibilidade de um repositório ou pacote de terceiros interromper o processo. É por isso que permitimos apenas um pequeno número de listas de fontes de terceiros que foram testadas por nossa equipe. Isso significa que quando o script de atualização detecta qualquer lista de fontes diferente das permitidas, ele abortará a atualização sem fazer nenhuma alteração.

Identificando listas de fontes de terceiros para remoção

Semelhante ao problema do APT descrito acima, é fácil identificar quaisquer listas de fontes de terceiros que interfiram na atualização. Se o log enviado para seu e-mail contiver entradas semelhantes às abaixo, você terá listas de fontes de terceiros que precisam ser removidas para que o script de atualização continue.

Preparation: Found an uncommon source list in /etc/apt/sources.list.d/: 3xcpbx.list Preparation: Found an uncommon source list in /etc/apt/sources.list.d/: 3cxpbx.listecho Preparation: Found an uncommon source list in /etc/apt/sources.list.d/: hetzner-mirror.list

No exemplo acima você pode ver três listas de fontes, hetzner-mirror.list e duas que se parecem com 3CX mas estão escritas incorretamente (3xcpbx.list, 3cxpbx.listecho). Isso fará com que a atualização seja abortada.

Lista de arquivos de origem permitidos

  • google-cloud.list
  • google-cloud-sdk.list
  • backports.list gce_sdk.list
  • 3cxpbx.list
  • 3cxpbx-testing.list
  • rasp.list
  • digitalocean-agent.list
  • google_osconfig_managed.list
  • google-cloud-monitoring.list
  • google-cloud-logging.list
  • droplet-agent.list

Certifique-se de que todos os arquivos em /etc/apt/sources.list.d/ estejam incluídos na lista acima.

Meu sistema não se enquadra nos problemas acima

Os dois problemas descritos são responsáveis por 84% de todas as atualizações abortadas e não afetam um sistema em execução de forma alguma, pois o script de atualização é encerrado antes de fazer qualquer alteração. Se o seu sistema estiver abaixo dos 16% restantes, consulte este documento.

Dicas gerais:

  • Agende a atualização fora do horário comercial
  • Antes de atualizar (qualquer software), você deve sempre fazer um backup completo de sua VM, bem como do 3CX (armazená-lo fora da máquina).
  • Certifique-se de que o sistema tenha recursos suficientes (especialmente memória e espaço em disco)
  • Se você estiver implantando em uma nova máquina, certifique-se de desligar a antiga antes de restaurar o backup, caso contrário você terá problemas de DNS FQDN (alternando constantemente entre o servidor antigo e o novo)

Você precisa de ajuda?

Se mesmo seguindo os passos acima você estiver encontrando dificuldades para atualizar ou se não está se sentindo seguro para aplicar a atualização. Entre em contato conosco, podemos ajudar neste processo.