离线安装(Windows)

环境要求

得益于 Docker 跨平台应用,DataEase 理论上可以部署在任何可以运行 Docker 的宿主机。

我们并非是只支持 Linux 操作系统,我们是支持可以部署 Docker 的任意 x86_64 的宿主机(Windows / Linux / macOS)

注意

  • 云虚拟机可能不支持,需要嵌套虚拟化
  • 物理机可以,Hyper-V 支持嵌套虚拟化

部署服务器要求

  • 操作系统: 可运行 docker 的 windows 操作系统
  • CPU/内存: 4核8G
  • 磁盘空间: 200G

本文将以 Windows 10 为例介绍如何在 Windows 10 上安装 DataEase。

安装 WSL

参考在 Windows 10 上安装 WSL | Microsoft Docs此问题,进行 Windows 宿主机的配置

使用管理员身份运行:

  1. dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  2. dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启操作系统

下载适用于 x64 计算机的 WSL2 Linux 内核更新包

设置 WSL2 为默认

以管理员身份执行:

  1. wsl --set-default-version 2

安装 Ubuntu

在 Windows 10 的应用商店里搜索”Ubuntu”并安装

安装Ubuntu

检测 Ubuntu WSL 版本

以管理员身份执行:

  1. wsl.exe -l -v

WSL版本1

示例中安装的 Ubuntu Name 为 “Ubuntu”, 如像上图出现 Ubuntu 版本为 1, 则继续执行命令:

  1. wsl.exe --set-version Ubuntu 2

出现下图结果即为成功:

WSL版本2

安装 Docker

下载Docker Desktop for Windows,如果使用的是 macOS,Install Docker Desktop on Mac | Docker Documentation

安装完成后双击 Docker Desktop Installer.exe 安装即可完成安装。

Docker 设置

Docker Desktop 安装完成后,进入 Settings 界面,选择 Resources 菜单下的 WSL INTEGRATION,按下图设置后,点击右下角的 Apply & Restart 即可。

docker设置

下载安装包

请自行下载 DataEase 最新版本的离线安装包(v1.2.3及以上版本)

安装包下载链接: https://community.fit2cloud.com/#/products/dataease/downloads

启动 Ubuntu

在应用商店里,选择 Ubuntu,点击”启动”按钮启动 Ubuntu,并执行命令切换到 root 用户:

  1. sudo su -

启动Ubuntu

检查 docker 环境

在 Ubuntu 命令行中执行命令:

  1. docker version

如能像下图一样正常显示 docker 版本信息,则能正常执行 DataEase 后续的安装操作,如出现异常,请根据提示信息解决异常问题。

docker检测

解压安装包

在 Ubuntu 中,以 root 用户执行如下命令

  1. # 假设安装包存放路径为 c:\dataease-v1.2.3-offline.tar.gz
  2. cd /mnt/c
  3. # 解压安装包
  4. tar zxvf dataease-release-v1.2.3-offline.tar.gz

设置安装参数(可选)

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

  1. # 基础配置
  2. ## 安装目录
  3. DE_BASE=/opt
  4. ## Service 端口
  5. DE_PORT=80
  6. # 数据库配置
  7. ## 是否使用外部数据库
  8. DE_EXTERNAL_MYSQL=false
  9. ## 数据库地址
  10. DE_MYSQL_HOST=mysql
  11. ## 数据库端口
  12. DE_MYSQL_PORT=3306
  13. ## DataEase 数据库库名
  14. DE_MYSQL_DB=dataease
  15. ## 数据库用户名
  16. DE_MYSQL_USER=root
  17. ## 数据库密码
  18. DE_MYSQL_PASSWORD=Password123@mysql

执行安装脚本

  1. # 进入安装包目录
  2. cd dataease-release-v1.2.3-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

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

  1. CREATE DATABASE `dataease` /*!40100 DEFAULT CHARACTER SET utf8mb4 */

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

安装目录目录结构说明

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

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

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

安装DataEase