安装12开源版

(推荐)Linux用一键安装包 分享链接 /book/zentaopms/90.html?releaseID=1

作者:王春生 最后编辑:薛才杰 于 2024-07-03 11:26:00 浏览量:986022
摘要:本文介绍如何在Linux下面使用禅道一键安装包搭建禅道的运行环境。

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

从18.5 版本开始,Linux一键安装包分为x68_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-01-15 14:23:36 回复
你好,第一遍安装21版本的时候也成功运行了,卸载我先stop以后 rm-rf把zbox目录删了,换了18.11版本的安装包重新安装,解压后start出错,一直提示
14:22:39.45 INFO ==> Starting service with Apache port=80, MySQL port=3306...
14:22:39.52 ERROR ==> MySQL 3306 port is already in use.
我更改了端口号启动也是提示这个,然后我去查找3306占用端口,kill了之后还是不行,mysql也卸载了,但是还是启动不了,请问这要怎么解决呢
回复
您好,定位该问题,需要更多的信息,有禅道同事添加您的微信,请通过下
回复
已解决,18.11 一键安装版有问题。使用18.12 版本没有问题。
🍭
低调的太阳 2025-01-07 14:30:27 回复
[pid 27418] (38)Function not implemented: AH00141: Could not initialize random number generator
Start Apache fail. You can see the log /opt/zbox/logs/apache_error.log
启动报这个,请问如何解决
回复
您好,这样的报错在安装禅道 Linux 一键安装包时,通常与系统环境中缺少合适的随机数生成相关的机制或配置有关。
可以根据您的服务器,通过网络找一下修复的方法 。
如果修复起来比较困难,建议您使用 docker 的安装方式 ,能规避这个问题。
docker 安装禅道可以参考
https://www.zentao.net/book/zentaopms/docker-1111.html
🛵
冷静的水煮鱼 2024-09-05 18:08:28 回复
1.可以修改为其他目录下不?比如/data目录下?
2.在config/my.php文件里修改了外部数据库配置,启动后无法登录了
回复
您好,linux一键安装包只能部署在/opt下。如果您是考虑到/opt目录空间的话,可以将/opt/zbox/app/zentao/www/data/upload/1目录软链接到/data下,这个目录是上传附件目录,主要占用空间的就是这个目录了。config/my.php文件里修改了外部数据库配置,启动后无法登录,这个无法登录是指访问不了禅道登录页面,还是登录页面输入账号密码提示错误。访问不了禅道登录页面的话可能是因为config/my.php里信息填写的不对,这个您可以联系qq2679672214,邀请到禅道交流群,具体截图看看。
🙈
面冷心慈的茶壶 2024-08-14 16:28:22 回复
4.4修改配置的.env根目录没看到啊
回复
这个文件是隐藏的,可以用ls -la看下呢
😯
成熟的卡布奇诺 2024-08-06 10:04:42 回复
解压完之后在当前文件下执行命令 /zbox/zbox start
-bash: /zbox/zbox: No such file or directory
回复
您好,咱们安装和启动的时候是使用的root用户吗?建议使用root用户呢。
🌙
禅道5647 2023-09-04 16:47:39 回复
数据库登录 会话已过期,请重新登录 Warning: session_write_close(): write failed: No space left on device (28) in /opt/zbox/app/adminer/index.php on line 73
回复
检查下服务器磁盘空间,可能是磁盘空间已满导致的无法登陆:)
🎸
禅道8595 2023-08-30 18:00:04 回复
Centos 7系统下直接使用命令启动没有问题,但使用systemctl start zentao.service出现tput: No value for $Term or no -T specified错误,该怎么处理
回复
如果是一键安装包部署的,执行 /opt/zbox/zbox start 试试呢?
回复
直接使用该命令没有问题。现在想添加到systemctl中进行自启动管理有问题。应该是脚本哪里使用了tput但systemctl不支持
回复
感谢回复,已解决。
🎓
荆波 2023-05-27 14:19:56 回复
Base table or view not found: 1932 Table 'zentao.zt_config' doesn't exist in engine in /opt/zbox/app/zentao/framework/router.class.php:81
回复
您好,请问是如何操作导致的报错?方便可以添加页面上方QQ沟通问题。
😄
Mind the gaps 2023-04-08 15:13:53 回复
/opt/zbox/zbox start
Function not implemented: AH00141: Could not initialize random number generator
Start Apache fail.这是什么原因呢?
回复
是新部署的吗?还是之前有稳定运行过。另外,服务器的操作系统的版本是什么,内核版本是什么?
wu 2023-03-23 10:41:13 回复
这个配置有什么问题吗,添加到httpd.conf下重启Apache报错,注释掉重启正常

Listen 443
<VirtualHost *:443>
ServerName test.com:443
ServerAlias *.xxx.com
DocumentRoot "/zentaopms/www/"

SSLEngine On
SSLCertificateFile /etc/ssl/certs/server.crt
SSLCertificateKeyFile /etc/ssl/certs/server.key
SSLProtocol all -SSLv2 -SSLv3
SSLCipherSuite HIGH:3DES:!aNULL:!MD5:!SEED:!IDEA

<Directory "/zentaopms/www">
AllowOverride All
Require all granted
</Directory>

</VirtualHost>
回复
使用linux一键安装包配置ssl证书,可以参考下这个例子:
具体例子:
<VirtualHost *:443>
ServerAdmin zentao@local.net
DocumentRoot "/opt/zbox/app/zentao/www/"
ServerName zentao.xxx.com
# ServerAlias *.xxx.com

SSLEngine On
SSLCertificateFile /opt/zbox/etc/apache/ssl/star.srcnet.cn.crt
SSLCertificateKeyFile /opt/zbox/etc/apache/ssl/star.srcnet.cn.key

<Directory "/opt/zbox/app/zentao/www">
AllowOverride all
Require all granted
</Directory>
ErrorLog "/opt/zbox/logs/apache_error_log"
CustomLog "/opt/zbox/logs/apache_access_log" combind
</VirtualHost>
魏中显
高级客户经理
18561939726
1746749398
统一服务热线 4006-8899-23
我要提问提问有任何问题,您都可以在这里提问。 问题反馈反馈点击这里,让我们聆听您的建议与反馈。