离线安装与升级

1 环境要求

部署服务器要求:

  • 操作系统: CentOS/RHEL 7 及以上 64 位系统
  • CPU/内存: 4核8G
  • 磁盘空间: 200G

2 下载离线安装包

请自行下载 DataEase 最新版本的基础安装包,并复制到目标机器的 /tmp 目录下。
安装包下载链接: https://community.fit2cloud.com/#/products/dataease/downloads

3 端口要求

部署 DataEase 离线服务需要开通的访问端口说明如下:

端口作用说明
22SSH安装、升级及管理使用
8100Web 服务端口默认端口,根据用户需要可以更改

4 安装部署

4.1 解压安装包

以 root 用户 ssh 登录到目标机器, 并执行如下命令:

  1. cd /tmp
  2. # 解压安装包(dataease-online-installer-v2.0.0.tar.gz 为示例安装包名称,操作时可根据实际安装包名称替换)
  3. tar zxvf dataease-online-installer-v2.0.0.tar.gz

4.2 设置安装参数(可选)

DataEase 支持以配置文件的形式来设置安装参数,如安装目录、服务运行端口、数据库配置参数等,具体参数请参见安装包中的 install.conf 文件:

  1. # 基础配置
  2. ## 安装目录
  3. DE_BASE=/opt
  4. ## Service 端口
  5. DE_PORT=8100
  6. ## 登录超时时间,单位min。如果不设置则默认8小时,也就是480
  7. DE_LOGIN_TIMEOUT=480
  8. ## 安装模式,community | enterprise
  9. DE_INSTALL_MODE=community
  10. # 数据库配置
  11. ## 是否使用外部数据库
  12. DE_EXTERNAL_MYSQL=false
  13. ## 数据库地址
  14. DE_MYSQL_HOST=mysql-de
  15. ## DataEase 数据库库名
  16. DE_MYSQL_DB=dataease
  17. ## 数据库用户名
  18. DE_MYSQL_USER=root
  19. ## 数据库密码
  20. DE_MYSQL_PASSWORD=Password123@mysql
  21. ## 数据库参数
  22. DE_MYSQL_PARAMS="autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false&allowPublicKeyRetrieval=true"

4.3 执行安装脚本

  1. # 进入安装包目录(dataease-online-installer-v2.0.0 为示例安装包目录名称,操作时可根据实际安装包名称替换)
  2. cd dataease-online-installer-v2.0.0
  3. # 运行安装脚本
  4. /bin/bash install.sh

如果使用外部数据库进行安装,只能使用 MySQL 8.X 版本。同时 DataEase 对数据库部分配置项有要求,请参考下附的数据库配置,修改环境中的数据库配置文件

  1. [mysqld]
  2. datadir=/var/lib/mysql
  3. default-storage-engine=INNODB
  4. character_set_server=utf8
  5. lower_case_table_names=1
  6. table_open_cache=128
  7. max_connections=2000
  8. max_connect_errors=6000
  9. innodb_file_per_table=1
  10. innodb_buffer_pool_size=1G
  11. max_allowed_packet=64M
  12. transaction_isolation=READ-COMMITTED
  13. innodb_flush_method=O_DIRECT
  14. innodb_lock_wait_timeout=1800
  15. innodb_flush_log_at_trx_commit=0
  16. sync_binlog=0
  17. group_concat_max_len=1024000
  18. sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
  19. skip-name-resolve
  20. [mysql]
  21. default-character-set=utf8
  22. [mysql.server]
  23. default-character-set=utf8

特别注意以下几个参数的设置:

  1. character_set_server=utf8
  2. lower_case_table_names=1
  3. group_concat_max_len=1024000

请参考文档中的建库语句创建 DataEase 使用的数据库,DataEase 服务启动时会自动在配置的库中创建所需的表结构及初始化数据。

  1. CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

安装脚本使用 /opt/dataease2.0 作为默认安装目录,DataEase 的配置文件、数据及日志等均存放在该安装目录 安装目录目录结构说明:

  1. /opt/dataease2.0/
  2. ├── apisix #-- 存放 APISIX 组件的配置文件以及其日志文件持久化目录
  3. ├── bin #-- 安装过程中需要加载到容器中的脚本
  4. ├── cache #-- 存放 Ehcache 的缓存文件,主要缓存的是权限相关的数据
  5. ├── conf #-- DataEase 各组件及数据库等中间件的配置文件
  6. ├── data #-- DataEase 各组件及数据库等中间件的数据持久化目录
  7. ├── docker-compose-apisix.yml #-- DataEase 内建的 APISIX 所需的 Docker Compose 文件
  8. ├── docker-compose-mysql.yml #-- DataEase 内建的 MySQl 所需的 Docker Compose 文件
  9. ├── docker-compose.yml #-- DataEase 基础 Docker Compose 文件,定义了网络等基础信息
  10. ├── logs #-- DataEase 各组件的日志文件持久化目录
  11. └── templates #-- DataEase 各组件及数据库等中间件的配置文件的原始文件

安装成功后,通过浏览器访问如下页面登录:

  1. 地址: http://目标服务器IP地址:服务运行端口
  2. 用户名: admin
  3. 密码: DataEase@123456

5 升级步骤

按照本文档离线安装步骤,下载新版本安装包并上传解压后,重新执行安装命令进行升级。(升级前备份是个良好的习惯哦,备份参考见: 备份还原 ):

  1. # 进入项目目录
  2. cd dataease-online-installer-v2.0.0
  3. # 运行安装脚本
  4. /bin/bash install.sh
  5. # 查看 DataEase 状态
  6. dectl status