闲来一记
公司技术选型，看到了此工具，功能挺全的，借鉴学习一下
如果有其他异常或是问题，欢迎江湖朋友们随时交流
本文以V2版本的离线安装方式为例，在centos7中进行安装，主要参照官方安装说明，本篇补充可能遇到的一些问题
官方说明：https://dataease.io/docs/v2/installation/offline_INSTL_and_UPG/
源码地址：https://github.com/dataease/dataease
一、安装
1 环境要求
部署服务器要求：
代码语言：txt复制操作系统: Ubuntu 22.04 / CentOS 7 64 位系统
CPU/内存: 4核8G
磁盘空间: 200G2 下载离线安装包
官方说明：请自行下载 DataEase 最新版本的基础安装包，并复制到目标机器的 /tmp 目录下。
补充：基础安装包可以放到自己配置的路径下，便于管理。
安装包下载链接: https://community.fit2cloud.com/#/products/dataease/downloads
3 端口要求
部署 DataEase 离线服务需要开通的访问端口说明如下：
代码语言：txt复制端口 作用 说明
22 SSH 安装、升级及管理使用
8100 Web 服务端口 默认端口，根据用户需要可以更改4 安装部署
4.1 解压安装包
以 root 用户 ssh 登录到目标机器, 并执行如下命令：
代码语言：bash复制cd /tmp或
代码语言：bash复制cd /自己配置的路径下# 解压安装包（dataease-offline-installer-v2.5.0-ce.tar.gz 为示例安装包名称，操作时可根据实际安装包名称替换）
代码语言：bash复制tar zxvf dataease-offline-installer-v2.5.0-ce.tar.gz4.2 设置安装参数（可选）
DataEase 支持以配置文件的形式来设置安装参数，如安装目录、服务运行端口、数据库配置参数等，具体参数请参见安装包中的 install.conf 文件：
代码语言：bash复制# 基础配置
## 安装目录
DE_BASE=/opt
## Service 端口
DE_PORT=8100
## 登录超时时间，单位min。如果不设置则默认8小时，也就是480
DE_LOGIN_TIMEOUT=480
## 安装模式，community | enterprise
DE_INSTALL_MODE=community
# 数据库配置
## 是否使用外部数据库
## 如果使用自己的数据库，需要改为true
DE_EXTERNAL_MYSQL=false
## 数据库地址
## 如果使用自己的数据库，需要改为数据库对应的ip
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"4.3 执行安装脚本
# 进入安装包目录（dataease-offline-installer-v2.5.0-ce 为示例安装包目录名称，操作时可根据实际安装包名称替换）
代码语言：bash复制cd dataease-offline-installer-v2.5.0-ce# 运行安装脚本
代码语言：bash复制/bin/bash install.sh如果使用外部数据库进行安装，只能使用 MySQL 8.X 版本。同时 DataEase 对数据库部分配置项有要求，请参考下附的数据库配置，修改环境中的数据库配置文件
代码语言：bash复制[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特别注意以下几个参数的设置：
代码语言：bash复制character_set_server=utf8
lower_case_table_names=1
group_concat_max_len=1024000请参考文档中的建库语句创建 DataEase 使用的数据库，DataEase 服务启动时会自动在配置的库中创建所需的表结构及初始化数据。
代码语言：sql复制CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;安装脚本使用 /opt/dataease2.0 作为默认安装目录，DataEase 的配置文件、数据及日志等均存放在该安装目录 安装目录目录结构说明：
代码语言：bash复制/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 各组件及数据库等中间件的配置文件的原始文件二、登录访问
安装成功后，通过浏览器访问如下页面登录：
- 访问地址 : http://目标服务器IP地址:服务运行端口
- 登录用户名: admin
- 登录密码: DataEase@123456
三、常见安装问题
1、安装报错如下
解决方法：首先查看docker日志
代码语言：bash复制docker logs -n 30 -f dataease解决方法：如果日之内是关于数据库的报错，则查看dataease解压目录下install.conf中的数据库配置信息是否有误，特别注意配置项是否被注释掉了
2、拉取安装文件失败
解决方法：ping一下baidu.com，如果不通请检查dns是否配置，重新配置后重启网络
