跳转至

了解飞致云旗下开源产品

安装配置相关

1 DataEase 默认的登录信息

DataEase 成功安装后，默认内置了两个用户：

  • 管理员用户为 admin ，密码为 dataease
  • 体验用户为 demo ，密码为 dataease

2 查看 DataEase 相关日志信息

在 DataEase 的运行目录下有专门存放组件日志的目录（默认路径 /opt/dataease/logs)，各个组件的日志分别存放在以各自命名的目录下，如 dataease 目录存放的是 dataease 的运行日志，fe 目录存放的是 doris-fe 的运行日志等。可以通过查看相应的运行日志来定位一些使用中遇到的问题。
另外，也可以通过 docker logs 命令来查看容器中的一些日志输出，例如： 

docker logs -n 30 -f dataease

3 重置 DataEase 安装参数

以下为重置 DataEase 安装参数的通用方法，该方法涉及到重新安装 DataEase 的过程，耗时相对会长一些，如果只是简单的调整安装参数的话，可以参考具体的调整方案：

  1. 清除存放原有配置参数的相关文件。 
    # dectl - 文件中包含了默认运行目录
rm -f /usr/bin/dectl

# .env - 文件中包含了运行时参数，在默认运行目录 /opt/dataease 下，如有改动，请在相应的目录下查找
rm -rf /opt/dataease/.env

# (可选)如果要比较彻底的删除之前创建的相关文件的话，可以删除整个运行目录（默认为 /opt/dataease)
rm -rf /opt/dataease

  2. 进入 DataEase 安装包中，修改安装包中的 install.conf 文件，改为最新的配置参数。

  3. 重新执行安装脚本 bash install.sh，等待服务启动即可。

4 修改已安装的 DataEase 配置参数

第一次安装 DataEase 后，会在运行目录下创建一个 .env 文件(默认路径 /opt/dataease/.env)，install.conf 配置文件中的配置项会记录在此。后续的安装和升级操作，不会去修改 .env 文件；
修改运行端口，请参考80 端口被占用了，如何修改为其他端口？；
修改运行目录，请参考如何迁移已有的运行目录到其他路径上？；
修改 MySQL 相关配置，请参考如何修改内置 MySQL 端口？ 、在安装完 DataEase 后如何切换外部 MySQL？、 如何将 DataEase 数据库由外部 MySQL 切换为 内置 MySQL？等。

5 修改 DataEase 访问端口

当默认的访问端口 80 已被占用，如何修改为其它端口?

v1.0.2 及以后的版本，支持配置文件方案管理 DataEase 服务的运行，可以在 DataEase 运行目录下找到 .env 文件（(默认路径 /opt/dataease/.env)，修改文件里的 DE_PORT，保存后执行 dectl reload 即可；

v1.0.2 以前的版本，可以登录到 DataEase 服务器上，找到 .env 文件(默认路径 /opt/dataease/.env)，把 dataease 的运行端口 80 端口改为其他端口，然后执行 dectl reload 即可。

6 迁移运行目录

  1. 修改 /usr/bin/dectl，将 DE_BASE 改为新的目标路径，如: /home/test；
  2. 将原运行目录迁移到新的目标路径下；
    # 假设源运行目录为 /opt，新目标路径为 /home/test
mv /opt/dataease /home/test/
  3. 修改 .env 配置文件。源运行目录迁移到新路径下之后，修改该路径下 dataease/.env 文件，将 DE_BASE 改为新的目标路径，如: /home/test；
  4. 重启 DataEase 服务。 
    service dataease restart

7 修改运行环境 Docker 网段

从 v1.4.0 版本开始，DataEase 支持 docker 运行网段的修改：

v1.4.0 之后 v1.10.0 之前的版本，执行以下操作：

  1. 停止 DataEase 服务： service dataease stop；
  2. 修改运行目录 /opt/dataease 目录下的 docker-compose.yml ，将默认的 172.19.0.0/16 和 172.19.0.1 改为其他网段，如 172.33.0.0/16 和 172.33.0.1；
  3. 修改 /opt/dataease 目录下的 docker-compose-doris.yml，把里面 172.19.0.198 和 172.19.0.199 改为第二步设置的网段的 ip，如 172.33.0.198 和 172.33.0.199；
  4. 重启 DataEase 服务：service dataease restart。

v1.10.0 及之后的版本，执行以下操作：

  1. 停止 DataEase 服务： service dataease stop；
  2. 修改 /opt/dataease/.env 文件，把 DE_DOCKER_SUBNET、DE_DOCKER_GATEWAY 改为其他网段；
  3. 把 DE_DORIS_FE_IP、DE_DORIS_BE_IP 改为第二步设置的网段的 ip；
  4. 重启 DataEase 服务：service dataease restart。

8 非 root 用户能否安装 DataEase

可以支持非 root 的 sudoer 用户，在执行安装脚本的时候，加上 sudo 执行即可，例如： 

sudo bash install.sh

9 如何与 MeterSphere 安装在同一台服务器上？

DataEase 与 MeterSphere 安装在同一台服务器上时，有可能会发生以下冲突：

  • Docker 网段冲突
  • MySQL 容器名冲突

  1. 修改 MeterSphere 的网段
    修改 /opt/metersphere/docker-compose-base.yml，网络部分定义如下： 

    networks:
  ms-network:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: 172.20.0.0/16
          gateway: 172.20.0.1

  2. 重启 MeterSphere 服务 

    # uninstall 可以在停止 MeterSphere 服务的同时，删除其对应的 docker network
msctl uninstall
# reload 会重新启动 MeterSphere 服务，并按照第一步的设置创建新的 docker network
msctl reload

  3. 修改 DataEase MySQL 容器相关配置
    修改 /opt/dataease/docker-compose.yml，将 dataease 的 depends_on 里的 mysql 改为 mysql-de，例如： 

      dataease:
    image: registry.cn-qingdao.aliyuncs.com/dataease/dataease:v1.0.0
    container_name: dataease
    ports:
      - 80:8081
    mem_limit: 4096m
    volumes:
      - dataease-conf:/opt/dataease/conf
      - dataease-logs:/opt/dataease/logs
      - dataease-plugins:/opt/dataease/plugins/thirdpart
      - dataease-kettle-data:/opt/dataease/data/kettle
    depends_on:
      mysql-de:
        condition: service_healthy
    修改 /opt/dataease/docker-compose-mysql.yml，将 mysql 相关的容器名改为 mysql-de，将 mysql 的运行端口改为 53306，例如： 
      mysql-de:
    image: registry.cn-qingdao.aliyuncs.com/dataease/mysql:5.7.25
    container_name: mysql-de
    healthcheck:
      test: ["CMD", "mysqladmin" ,"ping", "-h", "localhost"]
      interval: 5s
      timeout: 3s
      retries: 10
    env_file:
      - ./conf/mysql.env
    ports:
      - 53306:3306
    volumes:
      - /opt/dataease/conf/my.cnf:/etc/mysql/conf.d/my.cnf
      - /opt/dataease/bin/mysql:/docker-entrypoint-initdb.d/
      - dataease-mysql-data:/var/lib/mysql
    networks:
      - dataease-network
    修改 /opt/dataease/conf/dataease.properties，将数据库 URL 信息改为如下： 
    spring.datasource.url=jdbc:mysql://mysql-de:3306/dataease?autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false

  4. 修改 DataEase 服务启动端口（可选）
    修改 /opt/dataease/docker-compose.yml，将 dataease 的运行端口改为如8088（注意，后端容器运行端口8081不能修改)： 

      dataease:
    image: registry.cn-qingdao.aliyuncs.com/dataease/dataease:v1.0.0
    container_name: dataease
    ports:
      - 8088:8081

  5. 启动 DataEase 服务 

    dectl reload

10 DataEase 部署成功但无法访问

在 CentOS 7.x 环境下一键安装脚本默认会执行相关命令开放防火墙的 DataEase 访问端口，若没有设置公有云安全组，DataEase 部署成功后，dectl status 查看各组件状态均为 healthy ，页面也是无法访问的。
解决方法如下（以 CentOS 7.x）为例：

1.检查防火墙状态： 

systemctl status firewalld.service
2.防火墙状态为 active (running)开放 80 端口，重载防火墙，重启 Docker ，重启 DataEase： 
firewall-cmd --zone=public --add-port=80/tcp --permanent && firewall-cmd --reload && service docker restart && service dataease restart
3.在公有云部署，私有云、或者虚拟化环境部署，存在安全组，防火墙状态为 inactive (dead) 的情况下，依然访问不到 DataEase。 检查安全组是否开放 80 端口。若为 OpenStack 等存在安全组的私有云，第一步仍然是检查安全组是否开放 80 端口。

4.在确认安全组、防火墙均为正确配置后，考虑 Docker 网桥冲突的问题。 提供一个比较简单的排查思路（只适用于虚拟机除了 Docker 外没有其它网络桥接的情况），执行： 

service docker stop && ip addr show
查看网络信息，若存在冲突情况，则会看到仍然有多余的网桥 br-xxxxx 存在，执行： 
brctl delbr <br-xxxxx> && systemclt restart network
删除该网桥后，重启 Docker，重启 DataEase，执行： 
service docker start && service dataease restart
网桥删除可参考：https://ignorantshr.github.io/person-blog/linux/%E5%88%A0%E9%99%A4%E7%BD%91%E6%A1%A5/

11 如何修改 Kettle 容器的 Java 运行时内存

若出现 Kettle 内存溢出，可以编辑 opt/dataease/docker-compose-kettle.yml 文件调整 Kettle 容器的 Java 运行时内存，如下示例调整为 8G，再重启服务即可。

environment:
- PENTAHO_DI_JAVA_OPTIONS=-Xms1024m -Xmx8192m -XX:MaxPermSize=256m -Dfile.encoding=utf-8

12 安装 DataEase 过程报错 Schema dataease contains a failed migration to version XX

1.报错详情
安装 DataEase 时，日志报错 “Schema dataease contains a failed migration to version 43 !” 说明有 SQL 执行失败；
有可能用户使用了外置 MySQL，没有修改 max_allowed_packet 的值引起的，先确认 my.cnf 的配置与官网文档指定的配置一致；
（使用外置MySQL my.cnf 配置：https://dataease.io/docs/installation/offline_installation/#5）
如果安装环境配置均正确，请尝试以下步骤，手动执行产生失败的 SQL。

2.下载 SQL
访问 GitHub https://github.com/dataease/dataease/tree/dev/core/backend/src/main/resources/db/migration
（如果网络不通畅，可以访问 Gitee https://gitee.com/fit2cloud-feizhiyun/DataEase/tree/dev/core/backend/src/main/resources/db/migration）
查看对应 version 的 flyway sql，比如报错中显示 “ version 43”，则下载 V43 这个 SQL 文件
sql-v64

3.执行 SQL
将此 SQL 文件下载打开，然后重新手动一条条执行下，全部执行成功后修改 dataease_version 表对应版本的 success 值为1，然后 dectl reload 重启服务即可。 dataease_verison