安装禅道

linux用一键安装包(推荐) 分享链接 /book/zentaopms/458.html?releaseID=17

作者:刘振华 最后编辑:薛才杰 于 2024-12-13 08:53:14 浏览量:147635
摘要:本文介绍如何在linux下面使用禅道一键安装包搭建禅道的运行环境。

Linux一键安装包内置了Apache、PHP、MySQL和XXD 服务,不需要再单独安装。

从18.5 版本开始,Linux一键安装包分为x86_64位和arm64位两个包,请大家根据服务器的CPU架构选择对应的安装包。

《Linux一键安装包安装禅道》视频链接:https://www.zentao.net/zentao-install/zentao-linux-install-80523.html

一、安装

禅道软件下载地址:https://www.zentao.net/downloads.html 请根据自己的需要下载对应的版本。

1.1 将安装包直接解压到/opt目录下

cd /opt
wget https://www.zentao.net/dl/zentao/18.5/ZenTaoPMS.18.5.zbox_64.tar.gz
tar xvzf ZenTaoPMS.18.5.zbox_64.tar.gz 

特别说明:

  • 不要解压到别的目录再拷贝到/opt/,因为这样会导致文件的所有者和读写权限改变
  • 不要解压后把整个目录777权限。

1.2 Apache和MySQL常用命令

  • 启动所有服务:/opt/zbox/zbox start
  • 停止所有服务:/opt/zbox/zbox stop
  • 重启所有服务:/opt/zbox/zbox restart
  • 通过配置检查服务状态:/opt/zbox/zbox check 【18.10版本支持】



注:如果需要开机自动启动,可以把 /opt/zbox/zbox restart 加到操作系统的自启目录。

1.3 访问和登录禅道

启动Apache和MySQL服务后,浏览器直接访问 http://禅道服务器ip:apache端口 即可访问和登录禅道。

注意:

  • 如果网页无法访问,请先关闭禅道所在电脑的防火墙和selinux再刷新网页访问试一下。
  • 使用云服务器请注意在安全组中开放apache使用端口
  • 禅道默认管理员帐号是 admin,密码 123456。

登录后,即可使用禅道项目管理功能。具体的使用,请直接参考我们的使用手册文档。

 

1.4 其他参数

如果不加任何参数执行 /opt/zbox/zbox 会打印输出命令可用参数:

Usage: ./zbox {start|stop|status|check} [--aport=8080] [--mport=3307]

  • --aport参数 可以修改Apache的端口
  • --mport参数 可以修改Mysql的端口

例如(apache端口改为8080,mysql端口改为3307):

/opt/zbox/zbox --aport 8080 --mport 3307 start
15:49:49 root@mini zbox → /opt/zbox/zbox --aport 8080 --mport 3307 start
 15:52:09.54 INFO  ==> Starting service with custom port,Apache port=8080, MySQL port=3307...
 15:52:09.57 INFO  ==> Stopping the apache service...
 15:52:10.68 INFO  ==> The apache service is stopped.
 15:52:10.69 INFO  ==> Starting apache service...
 15:52:10.76 INFO  ==> Stopping the mysql service...
 15:52:11.79 INFO  ==> MySQL stop successfully.
 15:52:11.80 INFO  ==> Starting mysql service...
 15:52:12.94 WARN  ==> XXD is running.
==============================================================
Service             Port           Status    Version   Comment
==============================================================
Apache              8080           running   2.4.57
PHP                 -              running   7.4.33    prefork
MySQL               3307           running   10.6.14   MariaDB
XXD                 11443 11444    running   7.2.2
==============================================================
Application         Version
==============================================================
zentaomax           max4.5
adminer             4.8.1 

 

二、如何访问数据库

2.1 网页登录数据库

禅道数据库管理用的是adminer,但是为了安全,访问adminer的时候需要身份验证,需要运行 /opt/zbox/auth/adduser.sh来添加用户,如下命令:

# 进入脚本目录
cd /opt/zbox/auth
# 执行添加用户的脚本
bash adduser.sh
This tool is used to add user to access adminer
Account: admin  # 输入用户名
Password:       # 输入密码
Adding password for user admin 

打开浏览器,输入 http://禅道服务的ip:apache端口 点击“数据库管理”:

弹窗验证是输入运行 addusers.sh添加的用户名和密码:

image-20230811155828457

我加的用户名是admin,密码是admin!@#。那么授权页面里用户名和密码就填写adminadmin!@#

网页直接显示登录界面:

  • 系 统:默认选择MySQL。
  • 服务器:127.0.0.1:MySQL端口 (MySQL端口启用的是3307,那么就填写127.0.0.1:3307。注意:ip只能写127.0.0.1
  • 用户名: root(禅道默认的数据库用户名是root)
  • 密 码:123456(禅道默认的数据库密码是123456)
  • 数据库:zentao。

image-20230811160158247

导入数据

image-20230811160307849

2.2 命令行连接数据库

登录数据库:/opt/zbox/bin/mysql -u root -P MySQL端口 -p (如:/opt/zbox/bin/mysql -u root -P 3306 -p)

导入数据库:/opt/zbox/bin/mysql -u root -P MySQL端口 -p 要导入的库名 < XXXX.sql (如:/opt/zbox/bin/mysql -u root -P 3306 -p zentao < zentao.sql)

三、查看服务状态

执行 /opt/zbox/zbox status 可以查看当前服务状态和版本信息,如下:

/opt/zbox/zbox  status
 16:06:15.41 INFO  ==> Checking service status...
==============================================================
Service             Port           Status    Version   Comment
==============================================================
Apache              8080           running   2.4.57
PHP                 -              running   7.4.33    prefork
MySQL               3307           running   10.6.14   MariaDB
XXD                 11443 11444    running   7.2.2
==============================================================
Application         Version
==============================================================
zentaomax           max4.5
adminer             4.8.1 

四、其他说明

4.1 日志压缩与清理

Linux一键安装包默认对Apache的访问日志和错误日志按天进行压缩,但不会定期清理,请更加需要添加定时任务,维护压缩的日志文件。

Apache日志压缩的配置参见:/opt/zbox/etc/apache/httpd.conf

4.2 一键安装包目录结构说明

一键安装包的根目录有README 文件,里面详细的介绍了目录结构及功能。

4.3 XXD自动配置

XXD服务会自动与禅道建立联系并启动,如下图:

image-20230811165944418


4.4 配置文件

一键安装包首次启动时,会在根目录创建一个 .env 文件,这个文件中保存了一些初始配置,你可以根据情况更改这些配置,以下是关于配置的说明:


# Apache 主机地址,如果用外部Web服务,需要手动修改,18.10版本新增
export APACHE_HOST=127.0.0.1
# Aapche 端口号,通过--aport参数修改
export APACHE_PORT=80
# MySQL 主机地址,如果用外部MySQL,需要手动修改,18.10版本新增
export MYSQL_HOST=127.0.0.1
# MySQL 端口号,通过--mport参数修改
export MYSQL_PORT=3306
# MySQL 密码,如果手动更改后,需要修改这个配置
export MYSQL_PASS=123456
# 服务的默认用户,不要修改
export DEFAULT_USER="nobody"
# 服务的默认用户组,不要修改
export DEFAULT_GROUP="nogroup"
# 是否启用内置MySQL服务,18.10版本新增
export MYSQL_SERVICE=enabled
# 是否启用内置Apache服务,18.10版本新增
export APACHE_SERVICE=enabled
# 是否启用内置XXD服务,18.10 版本新增
export XXD_SERVICE=enabled
# 是否启用内置Roadrunner服务,18.10版本新增
export ROADRUNNER_SERVICE=enabled
# 设置PATH变量
export PATH=$PATH:/opt/zbox/bin
从18.10 版本开始,会兼容之前的配置,也就是说,如果用户做了修改,升级后不会覆盖配置,而且还会把新增的配置项添加到已有的配置文件中。


如果在.env中开启(enabled)或者禁用(disabled)了某些服务,需要通过 /opt/zbox/zbox check 使配置立即生效。


评论列表
🍥
谦逊的围巾 2025-03-24 07:43:33 回复
[root@centos50 zbox]# /opt/zbox/zbox start
07:32:59.21 INFO ==> Starting service with Apache port=80, MySQL port=3306, Redis port=6379...
07:32:59.22 WARN ==> MySQL is running.
07:32:59.24 INFO ==> Starting redis service...
/var/tmp/scl2DBnbT: line 8: -u: command not found
[root@centos50 zbox]# /opt/zbox/auth/adduser.sh
centos7已经关闭了原先的mysql和redis,使用的是21.6一键安装版
回复
还有个问题,导入的数据在哪个文件夹里,没有找到,我的centos是命令行版
回复
您好,建议咱们如果是新部署的话,可以用21.5的版本,21.6版本主要是用于JIRA和confluence数据的导入,如果不涉及JIRA和confluence数据使用,建议更换21.5版本重新安装看下呢
回复
能不能提供一下21.5的wget地址
回复
wget https://www.zentao.net/dl/zentao/21.5/ZenTaoPMS-21.5-zbox_amd64.tar.gz
回复
谢谢,现在根据操作说明,在目录下没有发现zentao.sql这个数据库脚本
回复
现在是想进行什么操作?部署无需要zentao.sql脚本,安装后 系统自动初始化 直接访问就可以的
🚙
2025-03-17 15:58:00 回复
root密码能改么 密码改了 .env文件也改了 页面打不开了 php就报错了
回复
/opt/zbox/app/zentao/config/my.php 或者mysql.php 文件中password需要改为新的密码。
🥓
侠义非凡的橡皮擦 2025-03-04 10:32:50 回复
为什么这两天登录时所有人会提示密码错误,莫名就不能登录,没人改密码(按照忘记密码的提示去tmp创建了文件,点击刷新只是提示创建文件的文件名变了,其他没反应)
回复
可以检查下服务器上是不是磁盘空间已经满了呢。
回复
您的回答对我很有帮助
回复
:)
回复
我也有这个问题 怎么解决的?
回复
登录时所有人会提示密码错误这个问题可能原因会比较多
1. 首先可以检查下服务器磁盘空间,如果磁盘空间满了,session无法存储,用户也会无法登录
2. 浏览器缓存的问题,不要使用浏览器缓存的账号密码,手动输入账号密码
3. 也可以打开debug,查看一下报错日志
(1)zentao/config/my.php 中debug的值改成true
(2)重新操作一下有问题的页面
(3)查看日志 zentao/tmp/log/文件中php开头的今天的文件有什么报错。注:不要找sql开头的文件。
(4)问题排查完成之后记得关闭debug,改为false
🥓
侠义非凡的橡皮擦 2025-03-04 10:30:04 回复
/opt/zbox/zbox restart --aport=86 --mport=3307 只有apache启动起来了,其他都是stopped
回复
启动过程中的日志输出有没有相关的提示?或者看下mysql的日志看看是不是有error导致无法正常启动呢
🎬
年轻有为的水桶 2025-03-03 16:57:40 回复
为什么实际端口和配置的不一致?
16:51:43.53 INFO ==> Starting service with Apache port=9003, MySQL port=3308, Redis port=6379...
16:51:43.58 INFO ==> Starting mysql service...
16:51:46.97 INFO ==> Checking MySQL database ...
16:51:50.35 INFO ==> Starting redis service...
16:51:50.40 INFO ==> Starting apache service...
16:51:50.51 INFO ==> Starting xxd service...
16:51:50.55 INFO ==> Starting roadrunner service...
=============================================================================
Service Port Status Version Comment
=============================================================================
Apache 80 running 2.4.62
PHP - running 8.1.31 prefork
MySQL 3306 running 10.6.20 MariaDB
XXD 11443 11444 running 9.2.2
Roadrunner - running 2023.3.12 @zentao
Redis 6379 running 6.2.16 Cache
回复
当前禅道版本安装的是哪一个版本?可以先尝试将禅道服务停止,然后zbox删除后重新解压一份,看下zbox目录下有没有一个.env 的文件,如果有,可以手动删除后重新start启动下,启动的时候指定下端口
📫
叶先生 2025-01-28 17:42:06 回复
root@openEuler:/opt# /opt/zbox/zbox start
/opt/zbox/zbox:行3: /opt/zbox/bin/php:无法执行二进制文件: Exec format error
root@openEuler:/opt# uname -m
aarch64
回复
服务器是否是ARM架构的?如果是ARM架构的话,下载一键包的时候,可以下载arm64的包部署试试。
21.4版本arm64 的下载地址:https://www.zentao.net/dl/zentao/21.4/ZenTaoPMS-21.4-zbox_arm64.tar.gz
如果还是不行的话,可以联系官网的客户经理同事,邀请加入技术交流群沟通。
😎
爽快的山楂 2025-01-24 16:02:11 回复
请问,要如何配置上传图片和文件的路径,我想修改文件路径到其他盘下进行存储
回复
物理文件目录 zentao/www/data/upload/1 目录,可以试试将该目录软链到存储盘。
回复
配置了软链后,还是存储在原路径下哦。。。然后我不小心把zentao/www/data/upload/1目录下的文件都rm删除了,现在前端提交需求附件的时候,会显示没有附件,要怎么处理哦。。。
回复
操作前是否有做过数据的备份?
或者看下代码目录zentao/tmp/backup/目录下是否有备份文件
有的话可以找下最近日期file结尾的备份文件。里面是附件,将这里的附件拷贝到对应的www/upload/1/目录下
回复
backup下有近期的file结尾的文件,直接复制到www/upload/1目录下就可以了吗?但是这个目录下之前有202501,202502文件夹以及index.html文件,现在也都没有了
回复
看下file结尾的备份文件下也有upload/1目录,将这个目录拷贝到对应的www/upload/下面,index.html文件没有影响。主要是202501这些月份名称的文件夹拷贝过去就可以了。
🙈
发怒的芹菜 2024-12-27 12:37:59 回复
您好,没有找到.env的配置文件,我想修改为自己的数据库
回复
需要最新版本/opt/zbox/目录下才有.env 文件,如果想连接自己数据库,可以修改/opt/zbox/app/zentao/config/my.php文件中数据库连接信息。
🥂
瘦瘦的火腿肠 2024-12-18 16:57:49 回复
为啥安装完访问不了页面 防火墙已关闭
回复
1、服务器的防火墙关闭或者开放端口,关闭selinux
2、如果是云服务器,需要在安全组里开放端口
3、网络需要能访问到服务器
🌄
傻傻的柳树 2024-12-16 17:40:38 回复
linux一键部署的禅道,内置的apache怎么使用代理服务啊,我在443下使用ProxyPass,ProxyPassReverse代理配置后,去/zbox restart ,提示代理错误。
回复
具体的配置内容可以提供下我们看看吗,需要根据具体的配置内容看下是什么问题。可以点击联系我们添加我们的商务同事,邀请加入技术交流群中,发下详细的配置一起看下。
回复
在/opt/zbox/etc/apache/ 在配置文件httpd.conf 配置的如图
ProxyPass /uxunCloudZentaoExtend http://127.0.0.1:8088/uxunCloudZentaoExtend
ProxyPassReverse /uxunCloudZentaoExtend http://127.0.0.1:8088/uxunCloudZentaoExtend
回复
您好,禅道linux一键安装包没有安装转发相关的扩展,不支持使用代理服务,建议搭建其他的代理服务,例如NGINX服务。
回复
好的
回复
那我怎么关闭禅道内置apache服务,把配置文件443那一段注释掉,在搭建Nginx服务吗?
回复
禅道中的apache配置默认是没有开启443的,如果咱们自己有修改的话 ,可以还原下默认的配置
回复
明白,感谢,我知道怎么操作 了。再次感谢你的解惑
回复
还有个小疑问,部署 了Nginx,那Nginx怎么代理禅道了,是不是如下配置
location /zentao/ {
proxy_pass http://127.0.0.1:8080/zentao;

禅道默认端口是8080吗?
回复
禅道的默认端口是80,Nginx 怎么代理禅道需要根据咱们具体需求设置下,可以在网上查询下nginx的配置使用。
回复
ok
丁芝
高级客户经理
17663906485
1481227768
统一服务热线 4006-8899-23
我要提问提问有任何问题,您都可以在这里提问。 问题反馈反馈点击这里,让我们聆听您的建议与反馈。