禅道一键安装包迁移/更新禅道一键安装包 分享链接/book/zentaopms/1428.html?releaseID=21

问：什么情况需要更新禅道一键安装包？

答：禅道从20.0及以后版本开始不再支持php5.x，如需升级至20.0及以后版本的禅道且当前版本的禅道是通过一键安装包的方式安装的，则需要更新禅道一键安装包。

前期准备：迁移前后的服务器禅道版本需保持一致。如果旧禅道版本较低，建议：

1、升级旧服务器禅道至预期新版本；

2、在新服务器中安装相同新版本的禅道；

3、实施迁移动作。

升级新版本禅道方法可参考链接：https://www.zentao.net/book/zentaopms/469.html 

一、备份旧系统数据

1、admin账号登录旧禅道系统，进入“后台-系统设置-备份”页面；

2、点击页面右上角"设置"（第一次操作时，为确保安全性，需在服务器中创建ok.txt文件，按提示创建即可。创建完成之后需重新回到当前页面刷新，即可出现下下图的设置窗口），勾选“不需要防下载PHP文件头”，点击”保存“；

3、点击页面右上角”开始备份“，系统会自动开始备份直至完成；

4、备份完成后，页面会显示最新的备份文件（后续主要会用到“sql.php”后缀的文件）。备份文件同时也展示备份路径。如图所示，下方示例禅道系统（服务器为Linux系统）的备份路径为“/opt/zbox/app/zentao/tmp/backup”（此路径可从当前页面右上角的“设置”中进行更改，所以实际备份可能与当前示例路径不同。Windows服务器的路径也会与下方示例不同。请参考实际备份文件当中展示的路径）。

二、新服务器安装禅道-下载新版本的一键安装包并完成安装

1、下载想要使用的新版本禅道。访问禅道官网，进入”动态“，在动态中左侧找到“产品相关-禅道下载”，然后再右侧搜索框中搜索想要下载的新禅道版本：以“IPD4.3”为例；

禅道官网-动态-禅道下载链接：https://www.zentao.net/download.html

2、点击进入要下载禅道的页面，下滑页面找到“下载链接”（通常在页面最下方），根据新的服务器系统及架构选择对应的禅道进行下载；

3、根据服务器系统，参考手册完成安装并启动禅道。若admin可以正常登录禅道，即表示安装成功。

Windows一键安装包参考手册：https://www.zentao.net/book/zentaopms/811.html

Linux一键安装包参考手册：https://www.zentao.net/book/zentaopms/458.html

三、将备份导入新禅道数据库

1. 第一种方式：

1、admin账号进入新系统后台，系统设置-备份，点击"设置"（按提示创建ok.txt文件），勾选“不需要防下载PHP文件头”，点击“保存”（参考上方“一、备份旧系统数据-步骤2”）；

2、将旧服务器中的备份文件（"sql.php"后缀文件）拷贝到新系统的备份目录中。新备份目录可在备份页面右上角点击“设置”查看；

3、为新备份更改属主和所属分组为nobody和nogroup，并为文件分配读写权限；
更改属主及所属分组命令参考（其中的“202509110848134ipd4_3.sql.php”需替换为您实际环境中的“sql.php”文件）：

sudo chown nobody:nogroup /opt/zbox/app/zentao/tmp/backup/202509110848134ipd4_3.sql.php

更改文件权限命令参考（其中的“202509110848134ipd4_3.sql.php”需替换为您实际环境中的“sql.php”文件）：

sudo chmod 755 202509110848134ipd4_3.sql.php

4. 刷新禅道后台备份页面。此时界面中会出现新复制过来的备份sql文件（"sql.php”格式文件），点击这个文件右侧的“还原”图标，等待还原完成。

2. 第二种方式：

使用命令行方式导入数据库-以Linux一键安装包为例：

当旧系统备份后，会生成“.sql.php”后缀文件。此时需要将文件后缀改为“.sql”（即去掉“.php”。例如将上一种方式中的“202509110848134ipd4_3.sql.php”文件更改为“202509110848134ipd4_3.sql”）。去掉后即可进行导入。

服务器操作命令参考(其中的“202509110848134ipd4_3.sql”需替换为您实际环境中的“sql”文件)：

/opt/zbox/bin/mysql  -uroot -p123456 zentao < 202509110848134ipd4_3.sql

3. 第三种方式：

1、访问禅道一键安装包首页，点击“数据库管理”；

2、输入数据库地址：127.0.0.1:3306，用户：root，密码：123456，登录数据库；

3、当旧系统备份后，会生成“.sql.php”后缀文件。此时需要将文件后缀改为“.sql”（即去掉“.php”。例如将上一种方式中的“202509110848134ipd4_3.sql.php”文件更改为“202509110848134ipd4_3.sql”）。去掉后即可进行导入；

4、选择数据库：zentao，点击“导入”；

5、点击“选择文件”，选择您刚才更改后缀的sql备份文件，点击“执行”。

四、拷贝附件目录

上述操作可以将旧禅道系统中的数据迁移至新禅道系统，但是附件还未迁移。所以需要将附件也从旧系统中迁移至新系统中。

1、使用有权限的账号进入旧禅道服务器中，拷贝旧禅道系统中的附件；

2、将旧禅道服务器中的附件放入新禅道服务器的路径中。

不同系统操作方法如下：

Windows系统

拷贝附件路径：ZenTao\app\zentao\www\data\upload\1
拷贝方式：在旧服务器的上述路径中对整个“1”文件夹里面的内容进行复制，然后到新服务器中找到相同路径，将内容粘贴到“1”文件夹中即可。

Linux系统

拷贝附件路径：/opt/zbox/app/zentao/www/data/upload/1/

拷贝方式：

1、进入旧服务器的上述路径中，将“1”文件夹中的所有内容进行复制；

2、将旧服务器中拷贝的数据放入新服务器的上述路径中；

3、为新服务器的“1”文件夹下的文件夹配置属主和所属分组。命令参考：

sudo chown -R nobody:nogroup /opt/zbox/app/zentao/www/data/upload/1/*

4、为新服务器“1”文件夹下的文件夹分配读写权限（推荐755权限）。命令参考：

sudo chmod -R 755 /opt/zbox/app/zentao/www/data/upload/1/*

五、访问禅道

登录系统验证数据，确认数据无误后再正式使用禅道。