1.9. 从之前的 CouchDB 版本升级

1.9.1. 重要提示

  • 在升级 CouchDB 之前,始终备份您的 data/ etc/ 目录。

  • 我们建议您用新版本提供的版本覆盖您的 etc/default.ini 文件。新的默认值有时包含启用默认功能的强制性更改。始终将您的自定义设置放在 etc/local.ini 或任何 etc/local.d/*.ini 文件中。

1.9.2. 从 CouchDB 2.x 升级

如果您来自 CouchDB 2.x 的先前版本,升级很简单。

1.9.2.1. 独立(单节点)升级

如果您运行的是独立(单节点)CouchDB 节点

  1. 计划停机时间。

  2. 备份所有内容。

  3. 检查附带的 etc/local.ini 文件中是否有新的推荐设置,并将任何所需的更改合并到您自己的本地设置文件(s)中。

  4. 停止 CouchDB。

  5. 就地升级 CouchDB。

  6. 如果您没有管理员用户,请务必 创建管理员用户。CouchDB 3.0+ 需要管理员用户才能启动(管理员聚会已经结束)。

  7. 启动 CouchDB。

  8. 放松!您完成了。

1.9.2.2. 集群升级

CouchDB 2.x 和 3.x 明确设计为在升级过程中允许“混合集群”。这使您能够在整个集群中执行滚动重启,一次升级一个节点,以实现零停机时间升级。该过程也完全可以在您选择的配置管理工具中进行脚本化。

我们为这个功能感到自豪,您也应该感到自豪!

如果您运行的是 CouchDB 集群

  1. 备份所有内容。

  2. 检查附带的 etc/local.ini 文件中是否有新的推荐设置,并将任何所需的更改合并到您自己的本地设置文件(s)中,并将这些更改暂存为在您升级节点时发生。

  3. 停止单个节点上的 CouchDB。

  4. 就地升级该 CouchDB 安装。

  5. 启动 CouchDB。

  6. 通过 /_membership 端点仔细检查该节点是否已重新加入集群。如果您的负载均衡器具有由 /_up 端点驱动的运行状况检查功能,请检查它是否也认为该节点是健康的。

  7. 在集群中剩余的节点上重复最后 4 个步骤。

  8. 放松!您完成了。

1.9.3. 从 CouchDB 1.x 升级

要从 CouchDB 1.x 升级,首先升级到 CouchDB 2.x 的版本。您需要先将所有数据库转换为 CouchDB 2.x 格式;有关说明,请参阅那里的升级说明。然后,升级到 CouchDB 3.x。