离线安装

1 环境要求

部署服务器要求:

  • 操作系统: CentOS 7.x
  • CPU/内存: 4核8G
  • 磁盘空间: 200G

2 下载安装包

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

3 解压安装包

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

  1. cd /tmp
  2. # 解压安装包
  3. tar zxvf dataease-v1.5.0-offline.tar.gz

4 设置安装参数(可选)

注意:强烈建议不要将安装包的路径作为 DataEase 的安装目录,对日常的维护以及后续版本的升级会带来一些不必要的麻烦。

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

从 v1.9.0 版本开始,DataEase 支持多种部署模式,调整 install.conf 文件中 DE_ENGINE_MODE 参数来设置不同的安装部署模式,DE_ENGINE_MODE 可选值有 local、simple、cluster,分别对应本地模式、精简模式、集群模式,具体可参考【安装模式】说明。
如不调整,则默认安装精简模式。

  1. # 基础配置
  2. ## 安装目录
  3. DE_BASE=/opt
  4. ## Service 端口
  5. DE_PORT=80
  6. ## 部署及运行模式,可选值有 local、simple、cluster,分别对应 本地模式、精简模式、集群模式
  7. DE_ENGINE_MODE=simple
  8. ## docker 网段设置
  9. DE_DOCKER_SUBNET=172.19.0.0/16
  10. ## docker 网关 IP
  11. DE_DOCKER_GATEWAY=172.19.0.1
  12. ## Apache Doris FE IP (外部 Doris 此参数无效)
  13. DE_DORIS_FE_IP=172.19.0.198
  14. ## Apache Doris BE IP (外部 Doris 此参数无效)
  15. DE_DORIS_BE_IP=172.19.0.199
  16. # 数据库配置
  17. ## 是否使用外部数据库
  18. DE_EXTERNAL_MYSQL=false
  19. ## 数据库地址
  20. DE_MYSQL_HOST=mysql
  21. ## 数据库端口
  22. DE_MYSQL_PORT=3306
  23. ## DataEase 数据库库名
  24. DE_MYSQL_DB=dataease
  25. ## 数据库用户名
  26. DE_MYSQL_USER=root
  27. ## 数据库密码
  28. DE_MYSQL_PASSWORD=Password123@mysql
  29. # Apache Doris 配置
  30. ## 是否使用外部 Apache Doris
  31. DE_EXTERNAL_DORIS=false
  32. ## Doris 地址
  33. DE_DORIS_HOST=doris-fe
  34. ## Doris 查询连接端口
  35. DE_DORIS_PORT=9030
  36. ## Doris http端口
  37. DE_DORIS_HTTPPORT=8030
  38. ## Doris 数据库名称
  39. DE_DORIS_DB=dataease
  40. ## Doris 用户名
  41. DE_DORIS_USER=root
  42. ## Doris 密码
  43. DE_DORIS_PASSWORD=Password123@doris
  44. # Kettle 配置
  45. ## 是否使用外部 Kettle - (目前还不支持外部Kettle,除非不需运行Kettle,否则请不要修改此参数)
  46. DE_EXTERNAL_KETTLE=false
  47. ## Kettle 服务器地址
  48. DE_CARTE_HOST=kettle
  49. ## Kettle 访问端口
  50. DE_CARTE_PORT=18080
  51. ## Kettle 用户名
  52. DE_CARTE_USER=cluster
  53. ## Kettle 密码
  54. DE_CARTE_PASSWORD=cluster

5 执行安装脚本

  1. # 进入安装包目录
  2. cd dataease-v1.5.0-offline
  3. # 运行安装脚本
  4. /bin/bash install.sh

注意:如果使用外部数据库进行安装,推荐使用 MySQL 5.7 版本。同时 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_AUTO_CREATE_USER,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_general_ci;

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

  1. /opt/dataease/
  2. ├── bin #-- 安装过程中需要加载到容器中的脚本
  3. ├── conf #-- DataEase 各组件及数据库等中间件的配置文件
  4. ├── custom-drivers #-- DataEase 自定义驱动程序目录
  5. ├── data #-- DataEase 各组件及数据库等中间件的数据持久化目录
  6. ├── docker-compose-doris.yml #-- DataEase 内建的 Doris 所需的 Docker Compose 文件
  7. ├── docker-compose-kettle.yml #-- DataEase 内建的 Kettle 所需的 Docker Compose 文件
  8. ├── docker-compose-mysql.yml #-- DataEase 内建的 MySQl 所需的 Docker Compose 文件
  9. ├── docker-compose.yml #-- DataEase 基础 Docker Compose 文件,定义了网络等基础信息
  10. ├── logs #-- DataEase 各组件的日志文件持久化目录
  11. ├── plugins #-- DataEase 第三方插件目录
  12. └── templates #-- DataEase 各组件及数据库等中间件的配置文件的原始文件

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

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

6 其他注意事项

内置示例数据以 flyway 的形式在 DataEase 启动时自动插入到了 MySQL 数据库中,如果使用了外部 MySQL 或者修改了内置 MySQL 的容器名称的话,需要登录到 DataEase 控制台,进入到【数据源】页面,选择 “demo” 数据源,将 “demo” 数据源的相关连接信息修改正确,保存后即可正常使用内置示例数据。

modify-demo-dataset