ejabberd从2.1.9升级至22.10的备份迁移问题求助

一、版本升级路径 #

从ejabberd 16.02可以直接跳级到22.10，无需逐版本升级。ejabberd新版本启动时会自动处理旧版本（包括16.02）的数据库结构迁移，但前提是要确保16.02的数据库已经完成从2.1.9的迁移，且数据状态正常。

二、数据迁移到全新安装的22.10 #

完全可以导出用户、密码、共享花名册等核心数据到全新安装的22.10中，但需注意不同版本间模块（如pubsub）的数据结构差异，这也是当前导入报错的核心原因。

三、备份与导入报错处理 #

1. ejabberdctl dump导入pubsub_node报错 #

报错bad_type是因为ejabberd 2.1.9的pubsub_item数据结构与后续版本（包括2.1.13、22.10）的Mnesia表定义不兼容，字段数量、类型或存储格式发生了变化。

解决选项：

• 跳过非核心pubsub数据：如果头像、pubsub节点等数据不是必须保留的，直接在dump文件中删除所有以{pubsub_node,和{pubsub_item,开头的行，再执行导入。后续让用户重新上传头像、重建pubsub节点即可。
• 手动转换数据格式：对比新旧版本的pubsub_item结构，编写脚本批量转换dump文件中的条目。例如，ejabberd 2.1.9的pubsub_item格式为{pubsub_item, {ItemID, NodeID}, CreationTime, ModificationTime, Content}，而新版本可能新增了Publisher字段，需调整为对应格式后再导入。
• 先升级到中间版本再导出：在测试环境部署ejabberd 2.1.13，直接将原2.1.9的Mnesia数据目录复制过去启动，ejabberd会自动完成数据库结构迁移。待服务稳定后，用ejabberdctl dump导出兼容格式的数据，再导入到22.10中。

2. ejabberdctl backup报错 #

报错Cannot prepare checkpoint (replica not available)是单节点环境下Mnesia schema配置异常导致的。

解决步骤：

1. 停止ejabberd服务：

   ejabberdctl stop
   

2. 进入Erlang调试shell修复schema：

   ejabberdctl debug
   

3. 在Erlang shell中执行以下命令：

   mnesia:change_table_copy_type(schema, node(), disc_copies).
   mnesia:wait_for_tables(mnesia:system_info(tables), 60000).
   q().
   

4. 重新启动ejabberd并尝试备份：

   ejabberdctl start
   ejabberdctl backup /tmp/jabba.backup
   

5. 若仍失败，直接备份Mnesia数据目录（最可靠方式）：

   ejabberdctl stop
   tar czf ejabberd_mnesia_backup.tar.gz /var/lib/ejabberd/Mnesia.ejabberd@jabba/
   

四、分步升级落地建议 #

1. 全量备份原数据：停止ejabberd，打包Mnesia数据目录，作为兜底备份。
2. 测试环境过渡升级：部署ejabberd 2.1.13，复制原Mnesia目录启动，等待自动完成数据库迁移，验证服务正常后导出dump。
3. 全新部署22.10：初始化新服务器的ejabberd 22.10，导入2.1.13导出的dump文件，若仍有pubsub报错则清理对应数据。
4. 验证核心功能：测试用户登录、消息收发、共享花名册等功能，确认正常后切换生产流量。

内容的提问来源于stack exchange，提问作者Umberto Bernardi