太极河图数据可视化平台

# 河图

# 安装环境

1、 JDK 17 (支持 JDK 21)2024.1+

建议安装以下版本OpenJDK adoptium (opens new window)

windows请下载zip格式安装包安装jdk。

2、数据库 （安装服务器版需配置数据库）

支持以下数据库：mysql5.7、mysql8、KingbaseES-V8.6、openGauss 5.0.0、oracle 11g、Gbase8s-8.8v3.3

# 安装步骤

# 1. 解压产品包

警告：

安装目录及当前登录用户名不要出现中文字符

Linux：执行命令进行解压 unzip -d hetu hetu-2024.1.zip

windows：使用解压软件解压

# 应用目录

--bin：启动脚本
--lib：程序包
--config：配置文件
--logs：日志存储路径
--web：资源文件
--work：系统工作目录，存放上传的文件数据
--piugin：第三方jar包插件

# 2. 修改服务端口（可选）

服务启动端口默认 7778 ，若需要修改端口，部署根目录找到 config/application.yml 进行修改

# 3. 启动应用程序

Linux：sh bin/start.sh

windows：进入 bin 目录，双击 start.bat

查看启动日志 logs/hetu_console.log 提示 HeTu start success，则启动完成。

提示：

选择产品并安装后，根据页面提示的申请码申请授权。

# 4.系统初始化

在浏览器中输入访问网址。http://ip:端口/admin/index.html，如：http://localhost:7778/admin/index.html。

# 4.1 选择产品版本

  • 演示版本： 使用内嵌数据库进行数据初始化。

  • 服务器版： 需要外置数据库用于数据初始化。

选择产品版本

警告：

演示版仅用于产品试用。

服务器版需使用空库，库中不要有表数据

# 4.2 选择服务器版本，配置数据库信息配置

配置数据库信息

数据库URL根据用户输入的数据库类型、主机、端口、数据库生成，如果生成的地址不符合需要，可以对URL地址进行修改

提示：

仅服务器版有该配置。

使用 Kingbase 数据库， 安装前需要确认数据库 data 目录下的文件kingbase.conf中ora_input_emptystr_isnull的设置为ora_input_emptystr_isnull = off 。

# 4.3 选择安装产品4.3+

输入授权码

提示：

  1. 产品安装时，可以选择安装一个产品。如果后续想使用其他产品，可以访问以下地址追加新产品

    http://ip:端口/admin/index.html#/init。如： http://localhost:7778/admin/index.html#/init

  2. 追加产品后会生成新的授权码，但是不影响原有已安装的产品使用。如果想正常使用新安装的产品，需要根据新的申请码申请授权。

# 4.4 输入根据申请码获取的产品授权码

输入授权码

# 4.5 创建系统默认管理员账号

设置默认管理员

# 4.6 初始化完成自动跳转到太极河图管理平台登录界面，使用 4.5 步骤中创建的账号登录系统

太极河图管理平台网址为：http://ip:端口/admin/index.html。

初始化完成

# 4.7 在[账号管理]->[账户信息]中创建一个账号

提示：

[账号管理]->[账户信息]创建的账号，账号类型为注册用户。

如果需要创建管理端账号，需要通过[组织机构]->[用户管理]进行用户创建。

注册用户用户登录河图可视化平台，系统用户用于登录管理端

创建用户

# 4.8 退出太极河图管理平台

退出系统

# 4.9 使用 4.7 步骤中创建的账号登录太极河图数据可视化平台

在浏览器输入访问地址：http://ip:端口 如：http://localhost:7778

登录

# 程序关闭

Linux：sh bin/stop.sh

windows：进入河图运行程序所在命令行窗口，按下Ctrl + c 组合键关闭程序，禁止直接关闭命令行窗口。

# 常见问题

# 系统日志

logs/                   日志文件夹
├── hetu_console.log    控制台日志（Linux系统有该文件，windows系统打印到命令行控制台中）
├── hetu_info.log       当天系统执行日志
├── hetu_error.log      当天系统异常日志
└── backup              日志历史记录

# 1、修改数据库连接

打开安装目录下的 config/dbconfig.properties文件，可修改数据库连接信息。修改后需要执行bin/stop.sh关闭程序后，执行bin/start.sh重启程序

# 2、产品重新安装

删除安装目录下的 config/dbconfig.properties文件，并清空原河图安装数据库中的库表数据。修改后需要执行bin/stop.sh关闭程序后，执行bin/start.sh重启程序

# 3、启动日志提示"JDK Java compiler not available, Ensure HeTu is running with the java executable from a JDK or JRE"

1、检查操作系统是否已经正确安装 JDK

windows 需要检查JAVA_HOME、CLASSPATH、Path 是否正确配置

2、检查环境变量 是否同时存在 JRE 和 JDK 的环境变量，JDK 的优先级应高于 JRE

3、检查是否安装了多个java程序

windows 执行 where java

linux 执行 whereis java

# 4、指定河图运行的 java 程序

服务器中安装多个版本的 java 程序时，可指定河图运行的 java 版本

修改安装目录下的 bin/start.sh文件，指定河图运行所需的 java 程序

指定程序运行的java程序

# 5、更新产品授权

访问以下地址进行重新授权 http://localhost:7778/admin/index.html#/init

7778 为程序启动时的默认端口号，如果修改过该端口号，需要修改 7778 为修改后的端口号

# 6、数据库初始化提示"java.sql.SQLException: Incorrect string value: '\xE5\x9C\XA3\xE6\x96\ xB9.' for column"或者" java.sql.SQLException: #HY000"

修改数据库编码为utf8mb4或utf8，修改后清空数据库已初始化的表，然后进行重新安装

# 7、日志提示启动成功，但是通过浏览器无法访问

在安装河图的服务器上执行curl http://localhost:7778，检查是否有正常数据返回。如果正常返回数据，请检查服务器与浏览器间的网络连接。

7778 为程序启动时的默认端口号，如果修改过该端口号，需要修改 7778 为修改后的端口号

curl方式访问

# 8、安装过程提示"drill 连接失败"

日志文件logs/hetu_info.log提示错误Area [/E:/hetu/work/temp/drill/udf/registry] must be writable and executable for application user

安装目录中work/temp/drill/udf 文件夹下手动创建三个文件夹 registry, staging,tmp。然后把这三个文件夹的完全控制权限授予所有人或Everyone

文件夹右键 -> 属性 -> 安全 -> 权限设置 -> 添加 -> 授予所有人完全控制权限

添加文件权限

# 9、系统登录页面无法显示图片验证码

日志文件logs/hetu_info.log提示错误java.lang.NullPointerException: null at sun.awt.FontConfiguration.getVersion(FontConfiguration.java:1264)

操作系统缺失字体导致 执行以下命令

yum -y install fontconfig
yum -y install dejavu-sans-fonts-2.33-6.el7.noarch
yum -y install dejavu-sans-mono-fonts-2.33-6.el7.noarch
yum -y install dejavu-serif-fonts-2.33-6.el7.noarch

# 10、数据库选择MYSQL，提示Public Key Retrieval is not allowed错误

检查数据库认证方式

select host, user, plugin from mysql.user;

更新 mysql 数据库认证方式，修改caching_sha2_password为mysql_native_password

# 11、迁移数据到其他服务器

方式1：通过导入导出进行数据迁移。

方式2：数据拷贝

  1. 数据库导入到待安装环境

  2. 解压安装包

  3. 复制原安装目录下config中的dbconfig.properties到待安装环境，修改数据库连接信息

  4. 拷贝原安装目录下的work目录到待安装环境

  5. 启动程序

  6. 更新授权

# 12、自定义数据库方言

1、添加hibernate方言jar包到lib目录下（可选）

2、修改安装目录下的 config/application-prod.yml文件，新增以下内容

spring:
  jpa:
    #指定方言实现类
    database-platform:

如gbase8s为

spring:
  jpa:
    database-platform: org.hibernate.dialect.GBasedbtDialect

3、重启程序

# 13、查询安装的版本

当前安装版本为4.5.0

方式一：打开浏览器控制台 安装版本

方式二：查看启动日志

linxu：安装目录下的logs/hetu_console.log日志

windows：命令行窗口

安装版本

Last Updated: 1/3/2024, 9:04:26 AM

← 任务调度(可选) →