1 环境要求
部署服务器要求:
操作系统: Ubuntu 22.04 / CentOS 7 64 位系统
CPU/内存: 4核8G
磁盘空间: 200G
2 安装/升级企业版
2.1 升级企业版
如果您当前已经部署了 DataEase 的开源版,且您的服务器可以访问公网下载镜像资源,可参考以下步骤修改配置文件,加载企业版相关的镜像容器;如果您的服务器环境不通外网,或者您当前没有部署 DataEase 的开源版本,可直接下载企业版部署包进行部署,参考下面 2.2 章节进行操作。
# 编辑配置文件
vim /opt/dataease2.0/.env
# 将配置项 DE_INSTALL_MODE 改为 enterprise
DE_INSTALL_MODE=enterprise
# 保存退出
# 加载新镜像
dectl reload
加载完成后,登陆 DataEase 页面,参考下面第 6 章节,下载并更新 license 即可。如果您的服务器有防火墙或访问限制,需开放以下端口:
2.2下载离线安装包
进入飞致云 support 门户,点击访问 support 门户,使用邮箱/密码 或 短信验证码登陆(我们在为您的企业开通企业版 License 授权的时候,会使用对接人的邮箱和电话进行账号注册,请联系相关对接人获取账号)。
注:如果您没有 support 门户账号,请点击申请试用。
进入订阅管理-正式订阅/临时订阅-订阅详情,进入下载页面,下载对应版本的安装包
注意:下载最新版本即可,同版本的安装包一般有两个,分别适配 arm 架构和 amd 架构的服务器,根据服务器的架构选择对应的安装包,x86 的服务器选择 amd 架构。
3 端口要求
部署 DataEase 离线服务需要开通的访问端口说明如下:
4 安装部署
4.1 解压安装包
以 root 用户 ssh 登录到目标机器, 并执行如下命令:
cd /tmp
# 解压安装包(dataease-online-installer-v2.0.0.tar.gz 为示例安装包名称,操作时可根据实际安装包名称替换)
tar zxvf dataease-online-installer-v2.0.0.tar.gz
4.2 设置安装参数(可选)
DataEase 支持以配置文件的形式来设置安装参数,如安装目录、服务运行端口、数据库配置参数等,具体参数请参见安装包中的 install.conf 文件:
# 基础配置
## 安装目录
DE_BASE=/opt
## Service 端口
DE_PORT=8100
## 登录超时时间,单位min。如果不设置则默认8小时,也就是480
DE_LOGIN_TIMEOUT=480
## 安装模式,community | enterprise
DE_INSTALL_MODE=enterprise
# 数据库配置
## 是否使用外部数据库
DE_EXTERNAL_MYSQL=false
## 数据库地址
DE_MYSQL_HOST=mysql-de
## DataEase 数据库库名
DE_MYSQL_DB=dataease
## 数据库用户名
DE_MYSQL_USER=root
## 数据库密码
DE_MYSQL_PASSWORD=Password123@mysql
## 数据库参数
DE_MYSQL_PARAMS="autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false&allowPublicKeyRetrieval=true"
注意:如果你是从开源版升级到企业版,还需修改安装目录的 .env 文件(这是个隐藏文件,在安装目录执行 ls -al 可以看到,安装目录默认为 /opt/dataease2.0/),将其中的 DE_INSTALL_MODE 值修改为 enterprise。
DE_PORT=8100
DE_APISIX_KEY=b3b3a497450a47fc9bea74d4b1aa3333
DE_MYSQL_PARAMS=autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false&allowPublicKeyRetrieval=true
DE_LOGIN_TIMEOUT=480
DE_BASE=/opt
DE_SELENIUM_CPU_LIMIT=1
DE_MYSQL_PASSWORD=Password123@mysql
DE_INSTALL_MODE=enterprise
DE_MYSQL_HOST=mysql-de
DE_EXTERNAL_MYSQL=false
DE_SELENIUM_MEM_LIMIT=2g
DE_VERSION=v2.2.0
DE_MYSQL_PORT=3306
DE_MYSQL_USER=root
DE_MYSQL_DB=dataease
4.3 执行安装脚本
# 进入安装包目录(dataease-online-installer-v2.0.0 为示例安装包目录名称,操作时可根据实际安装包名称替换)
cd dataease-online-installer-v2.0.0
# 运行安装脚本
/bin/bash install.sh
如果使用外部数据库进行安装,只能使用 MySQL 8.X 版本。同时 DataEase 对数据库部分配置项有要求,请参考下附的数据库配置,修改环境中的数据库配置文件
[mysqld]
datadir=/var/lib/mysql
default-storage-engine=INNODB
character_set_server=utf8
lower_case_table_names=1
table_open_cache=128
max_connections=2000
max_connect_errors=6000
innodb_file_per_table=1
innodb_buffer_pool_size=1G
max_allowed_packet=64M
transaction_isolation=READ-COMMITTED
innodb_flush_method=O_DIRECT
innodb_lock_wait_timeout=1800
innodb_flush_log_at_trx_commit=0
sync_binlog=0
group_concat_max_len=1024000
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
skip-name-resolve
[mysql]
default-character-set=utf8
[mysql.server]
default-character-set=utf8
特别注意以下几个参数的设置:
character_set_server=utf8
lower_case_table_names=1
group_concat_max_len=1024000
请参考文档中的建库语句创建 DataEase 使用的数据库,DataEase 服务启动时会自动在配置的库中创建所需的表结构及初始化数据。
CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
安装脚本使用 /opt/dataease2.0 作为默认安装目录,DataEase 的配置文件、数据及日志等均存放在该安装目录 安装目录目录结构说明:
/opt/dataease2.0/
├── apisix #-- 存放 APISIX 组件的配置文件以及其日志文件持久化目录
├── bin #-- 安装过程中需要加载到容器中的脚本
├── cache #-- 存放 Ehcache 的缓存文件,主要缓存的是权限相关的数据
├── conf #-- DataEase 各组件及数据库等中间件的配置文件
├── data #-- DataEase 各组件及数据库等中间件的数据持久化目录
├── docker-compose-apisix.yml #-- DataEase 内建的 APISIX 所需的 Docker Compose 文件
├── docker-compose-mysql.yml #-- DataEase 内建的 MySQl 所需的 Docker Compose 文件
├── docker-compose.yml #-- DataEase 基础 Docker Compose 文件,定义了网络等基础信息
├── logs #-- DataEase 各组件的日志文件持久化目录
└── templates #-- DataEase 各组件及数据库等中间件的配置文件的原始文件
5 登录访问
安装成功后,通过浏览器访问如下页面登录:
- 访问地址 : http://目标服务器IP地址:服务运行端口
- 登录用户名: admin
- 登录密码: DataEase@123456
6 下载并更新 License
进入飞致云 support 门户的订阅信息页面,下载 License。
登陆 DataEase,点击右上角用户头像,进入关于页面,点击更新 License,上传 License 文件即可。