Linux升级失败 – 故障排除提示

总的来说，3CX的升级脚本将基于Linux的客户从V16的Debian 9升级到V18的Debian 10，成功率为92%。在这篇博文中，我们将介绍其余8%未能成功升级的案例的常见解决方案。

做备份

在您尝试任何软件更新之前，请对您的3CX系统进行全面备份，并从运行3CX的主机上下载。这将允许在任何不可预见的情况下迅速恢复。升级脚本也会对你的系统进行基本备份，但是，它不包含语音邮件、录音或呼叫历史数据。如果你的系统无法访问，这个备份对你来说没有什么帮助。

在升级失败/中止的情况下，首先要做的是检查原因。确切的原因可以在3CX系统通过电子邮件发送给管理员的状态报告中找到。另外，你也可以检查/tmp/UPDATE.log文件。注意，重启后，该日志文件会从系统中删除，所以需要在任何重启前检查该文件。

很大一部分不成功的升级是由客户安装了额外的软件包、源列表或在一个不被官方支持的环境/托管提供商中运行。总的来说，这些是导致升级失败的最常见原因的70%。

你的v16安装不会受到升级尝试的影响，并返回到你在升级前的位置。

检查

该日志将包含以下内容之一：

Preparation: Found an uncommon source list

Sources seems to be include oldstable

解决方案/该怎么做

你必须对你的3CX系统做一个完整的备份，并使用我们的3CX iso或3CX部署服务从客户门户重新部署。然后进行恢复。这不仅有助于直接升级到v18，还能确保底层操作系统得到3CX的完全支持。

在你尝试升级你的3CX系统时，Debian的两个软件包管理器有时会很忙。这两种情况加起来占了升级不成功的10%。通常情况下，没有什么可担心的，因为从尝试升级的那一刻起，系统在v16中没有变化。

您的v16安装不会受到升级尝试的影响，并返回到您在升级之前的位置。

检查

日志中会有以下的响应行：

There seems to be an apt file lock in place.

There seems to be a dpkg file lock in place.。

解决方案

建议你在30分钟内再次尝试升级进程。如果情况没有变化，你可以调试APT或DPKG被锁定的原因，或者采取通过备份和恢复功能将系统重新安装到一个新的Debian 10实例上。如果你不确定你之前是如何安装3CX的，这也可以消除任何不确定性。

在15%的情况下，由于各种原因，如错误的配置操作系统语言或数据库中错误的区域划分，操作系统没有升级。

你的v16安装不受升级尝试的影响，并返回到你在升级前的位置!

检查

日志中会有以下的响应行：

Locales seems to be invalid

Inspect the log entries above to determine the cause.

解决方法

建议您在30分钟内再次尝试升级过程。如果情况没有改变，通过备份和恢复功能将系统重新安装到一个新的 Debian 10 实例。如果您不确定之前是如何安装3CX的，这也可以消除任何不确定性。

最后5%（总共8%的不可升级的系统中）有一个未定义的状态。由于分析的原因，系统从未对升级过程作出反应。

检查

日志中会有一行。

Upgrade/Update/Simulation/Download failed (package)

解决方案

为了解决这种状态，请在升级前对您的3CX系统进行完整的备份，并使用我们的3CX iso或3CX部署服务从客户门户网站上重新部署它。这不仅有助于直接升级到v18，还能确保底层操作系统得到3CX的完全支持。