河图

所需的软件

需要安装 JDK 8 (1.8.0_191 及以上的版本)才能进行产品部署

服务器版数据库支持：mysql5.7、mysql8、KingbaseES-V8.6、Gbase8s-8.8v3.3、oracle 11g、OpenGauss

解压产品包

警告：

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

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

windows：使用解压软件解压

应用目录

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

安装步骤

1. 修改服务端口（可选）

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

2. 启动应用程序

Linux：sh bin/start.sh

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

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

提示：

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

3.系统初始化

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

3.1 选择产品版本

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

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

警告：

演示版仅用于产品试用。

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

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

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

提示：

仅服务器版有该配置。

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

3.3 选择安装产品4.3+

提示：

1. 产品安装时，可以选择安装一个产品。如果后续想使用其他产品，可以访问以下地址追加新产品。 http://localhost:7778/admin/index.html#/init

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

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

3.5 创建系统默认管理员账号

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

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

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

提示：

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

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

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

3.8 退出太极河图管理平台

3.9 使用 3.7 步骤中创建的账号登录太极河图数据可视化平台；

在浏览器输入访问地址：http://localhost:7778/account/index.html

常见问题

系统日志

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

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

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

修改安装目录下的 bin/start.sh文件，指定河图运行所需的 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 为修改后的端口号

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