1.安装客户端步骤

禅道服务端：当前部署，可在网页访问。使用docker 容器部署的。

禅道客户端：是用户访问的application ，主要是在用户端部署的程序。

禅道客户端服务器：客户端依赖的服务器，一般部署在服务器上。

1.1页面上配置客户端服务器的参数

1.2 上面有版本的显示，注意这个版本和客户端版本 禅道版本要一致，

　　客户端要是打开的状态

　　上面有默认端口，客户端登录的时候可不写，如果是自定义的端口，客户端登录的时候需要配置ip+端口

　　点击保存出现下载客户端服务器的页面

1.3如果已经下载过同版本的客户端服务器，则只需要下载配置文件就可以了，xxd.conf

1.4 因为我之前用的版本是3.2.1  这个版本没有客户端服务器，所以下载不下来，这也是导致后面要版本升级的原因。

 1.5  xxd 是客户端服务器启动的程序，./xxd

　　config 里面是配置文件，如果需要替换配置文件的 就在此文件夹中替换

1.6 这个是xxd.cnf的内容，如果客户端登录有问题，请确认这里面的端口号，禅道的ip 端口 还有密匙  是否有default 

 1.7 启动客户端服务器 ./xxd

1.8 下载客户端 点击头像 下面有客户端的下载，只有配置了客户端的参数，才有这个选项。

1.9 启动客户端

 1.10 连接客户端，账号密码和禅道网页版一致，需要确认服务器的ip 和端口 注意：此ip时禅道客户端服务器的ip，如果不是默认端口，需要增加端口

登录成功 此页面功能可参照官网。

2.客户端连接不成功解决

2.1因为版本不一致问题、12.3.3的禅道没有客户端服务器的支持、

3.禅道版本问题

3.1 最初方案是重新部署高版本的禅道，进行数据迁移。但是发现数据库的表结构和表数量都发生了变化，无法进行数据迁移。

新版本数据库（有可能是针对新项目管理创建的，因为后面升级成功后，表的数量并没有增加）

 旧版本数据库

 3.2 第二方案进行升级，因为是容器部署，官网提供三种升级，windows 一键部署升级，linux一键部署升级，源码升级。不知道应该那种方式升级，纠结好久，后面加了禅道开源讨论群，才知道属于源码升级

 但是我想升级的版本居然没有源码包

 3.4退而求其次 找了16.4的版本的源码包进行替换

3.5下载源码包：wget https://www.zentao.net/dl/zentao/16.4/ZenTaoPMS.16.4.zip 

3.6 解压  unzip

 3.7 替换文件 次文件下下面文件，全部覆盖到员pms 下面

cp /home/czc/xtc/zentaopms/* ./ -a

然后重启禅道容器，原ip+端口/upgrade.php  进行登录

提示需要创建文件 touch /www/zentaopms/www/ok.txt  注意是在容器里面创建，之前在宿主机上创建后没有反应。才想起是要在容器中创建

3.8 根据提示 进行更新，确认版本，执行数据库语句，选择 经典管理模式还是 全新项目管理集模式，我是选择的经典项目管理模式，所以到这一步已经完成了，如果是全新项目集管理模式，需要根据官网进行配置项目。

3.9 确认数据完成

4.服务器程序永久开启

4.1 ./xxd 这样开启程序  ctrl+c 就关闭了，或者关闭终端也关闭了

所以才用   nohup ./xxd & 直接关掉终端就永久开启程序了

5.总结：

5.1.历时两天解决问题

5.2一开始文档读不懂，不知道各种源文件是怎样的，概念理解不清晰。

5.3禅道官网文件错综复杂，需要了解后才能找到相应的文件