离线安装

    注意：

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

    部署服务器要求：

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

    参考此问题，进行 Windows 宿主机的配置。

    使用管理员身份运行：

    重启操作系统

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

    2.2 设置 WSL2 为默认

    以管理员身份执行：

    2.3 安装 Ubuntu

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

    2.4 检测 Ubuntu WSL 版本

    以管理员身份执行：

    1. wsl.exe -l -v

    WSL版本1

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

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

    出现下图结果即为成功：

    下载，如果使用的是 macOS，Install Docker Desktop on Mac | Docker Documentation 。

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

    2.6 Docker 设置

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

    2.7 下载安装包

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

    安装包下载链接:

    2.8 启动 Ubuntu

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

    1. sudo su -

    启动Ubuntu

    在 Ubuntu 命令行中执行命令：

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

    2.10 解压安装包

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

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

    2.11 设置安装参数（可选）

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

    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 此参数无效)
    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. ## 数据库密码
    30. # Apache Doris 配置
    31. ## 是否使用外部 Apache Doris
    32. DE_EXTERNAL_DORIS=false
    33. ## Doris 地址
    34. DE_DORIS_HOST=doris-fe
    35. ## Doris 查询连接端口
    36. DE_DORIS_PORT=9030
    37. ## Doris http端口
    38. DE_DORIS_HTTPPORT=8030
    39. ## Doris 数据库名称
    40. DE_DORIS_DB=dataease
    41. ## Doris 用户名
    42. DE_DORIS_USER=root
    43. ## Doris 密码
    44. DE_DORIS_PASSWORD=Password123@doris
    46. # Kettle 配置
    47. ## 是否使用外部 Kettle - (目前还不支持外部Kettle，除非不需运行Kettle，否则请不要修改此参数)
    48. DE_EXTERNAL_KETTLE=false
    49. ## Kettle 服务器地址
    50. DE_CARTE_HOST=kettle
    51. ## Kettle 访问端口
    52. DE_CARTE_PORT=18080
    53. ## Kettle 用户名
    54. DE_CARTE_USER=cluster
    55. ## Kettle 密码
    56. DE_CARTE_PASSWORD=cluster

    2.12 执行安装脚本

    1. cd dataease-v1.5.0-offline
    2. # 运行安装脚本
    3. /bin/bash install.sh
    1. [mysqld]
    2. datadir=/var/lib/mysql
    5. character_set_server=utf8
    6. lower_case_table_names=1
    7. table_open_cache=128
    8. max_connections=2000
    9. max_connect_errors=6000
    10. innodb_file_per_table=1
    11. innodb_buffer_pool_size=1G
    12. max_allowed_packet=64M
    13. transaction_isolation=READ-COMMITTED
    14. innodb_flush_method=O_DIRECT
    15. innodb_lock_wait_timeout=1800
    16. innodb_flush_log_at_trx_commit=0
    17. sync_binlog=0
    18. group_concat_max_len=1024000
    19. sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
    20. skip-name-resolve
    22. [mysql]
    23. default-character-set=utf8
    25. [mysql.server]
    26. default-character-set=utf8

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

    请参考文档中的建库语句创建 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. ├── 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

    由于采用 wsl2 的方案，如果在 Windows 系统中访问 DataEase 服务，需要在 wsl2 中查看网卡 IP 地址（在 18945 版本后，微软对 wsl2 做了改进，可以使用 localhost 访问 wsl2）：

      同时，如果局域网内需要访问此台 Windows 上的 DataEase 服务，可以通过端口转发实现：（Powershell 管理员身份运行）

      对于高版本 Windows 支持 localhost 映射为 wsl2 地址，否则请参考上一步获取 wsl2 地址。

      查看所有转发规则，如果有如下显示，则说明其他局域网内的主机可以通过此台 Windows 访问 DataEase 服务了。

      1. netsh ineterface portproxy show all

      端口转发

      注意：内置示例数据以 flyway 的形式在 DataEase 启动时自动插入到了 MySQL 数据库中，如果使用了外部 MySQL 或者修改了内置 MySQL 的容器名称的话，需要登录到 DataEase 控制台，进入到【数据源】页面，选择 “demo” 数据源，将 “demo” 数据源的相关连接信息修改正确，保存后即可正常使用内置示例数据；
      提示：Windows 使用 docker-compose 部署 Kettle 及 Doris ，若出现 doris-fe 无限重启问题，可参考此篇知识库。