DataKit介绍
openGauss官方文档：https://docs-opengauss.osinfra.cn/zh/docs/5.0.0/docs/ToolandCommandReference/DataKit.html
DataKit使用文档和开发文档：https://gitee.com/opengauss/openGauss-workbench/tree/master/openGauss-datakit/doc
功能介绍
openGauss的开发运维涉及到很多复杂操作，DataKit提供了一个可视化操作的运维界面，可以帮助用户管理，安装，监控运维自己的openGauss数据库以及对应的物理机资源。
DataKit是一个以资源（物理机，数据库）为底座的开发运维工具，将上层的开发运维工具插件化，各插件之间相互独立，方便用户按需引入。各插件围绕DataKit的资源中心进行扩展开，完成数据库的运维，监控，迁移，开发，建模等复杂的操作。
Datakit安装部署在服务器上，是一个自动化运维的平台。可以部署不同类型的插件来实现不同的功能，是跟随opengauss5.0发布的新软件，也可以用来监控小于5.0的opengauss版本。
原理简介
DataKit是基于spring-brick开发的插件化的工具，前台使用vue，后台使用spring-bot技术栈。DataKit基座提供资源管理，安全中心，日志中心等基础的公共能力，具体的数据库安装，运维，监控，数据迁移等能力是基于spring-brick开发的插件工具，可以灵活的在基座上面安装卸载，方便客户按需使用。
特性优势
本项目是基于Web的openGauss的可视化的一体化工具：DataKit，目的是方便客户使用和管理openGauss可视化工具，可以为客户降低openGauss数据库安装使用门槛，做到安全中心管理，插件管理，以及其它功能包括一键化部署、卸载、组件化安装、多版本升级和日常运维。
DataKit安装
root用户执行
jar包下载并上传
jar包下载有以下两种方式
1.通过openGauss官网下载：https://www.opengauss.org/zh/download/
2.通过opengauss官方gitee仓库下载：
仓库地址：https://gitee.com/opengauss/openGauss-workbench
当前最新版本安装包地址 https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/tools/Datakit/Datakit-5.1.1.tar.gz
openGauss官方gitee仓库的安装包一般会比openGauss官网的安装包版本高，包含最新功能和基础修复。
本文档采用opengauss官方gitee仓库下载最新版本的安装包：https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/tools/Datakit/Datakit-5.1.1.tar.gz
迁移工具DataKit的jar包下载地址：https://www.opengauss.org/zh/download/，下载后将jar包上传至/topsoft/server/DataKit5/下
--创建存放位置目录
mkdir -p /topsoft/server/DataKit5
--下载DataKit的jar包
wget https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/tools/Datakit/Datakit-5.1.1.tar.gz
--解压DataKit的jar包
cd /topsoft/server/DataKit5
tar -xvf Datakit-5.1.1.tar.gz
--查看解压后的内容
[root@top175:/topsoft/server/DataKit5]$ ls -l
total 544956
-rw-r--r-- 1 root root 939 Jan 15 21:45 application-temp.yml
-rw-r--r-- 1 root root 463564895 Feb 19 14:01 Datakit-5.1.1.tar.gz
drwxr-xr-x 2 root root 4096 Jan 15 21:49 doc
-rw-r--r-- 1 root root 94429167 Jan 15 21:45 openGauss-datakit-5.1.1.jar
-rw-r--r-- 1 root root 1378 Jan 15 21:45 run.sh
drwxr-xr-x 2 root root 4096 Jan 15 21:49 visualtool-plugin
创建目录
cd /topsoft/server/DataKit5
mkdir -p logs config ssl files配置文件application-temp.yml
修改application-temp.yml文件中的数据链链接ip、port、database、dbuser、dbpassword，配置文件application-temp.yml保存位置：/topsoft/server/DataKit5/config
omm初始用户不能用于连接，需提前创建业务用户，若业务用户已存在则不用创建。
将配置文件application-temp.yml移动到/topsoft/server/DataKit5/config 目录下，修改config目录下application-temp.yml配置文件中的数据库连接ip、port、database、username、password,
并将配置文件中涉及的默认工作目录/ops均修改为实际工作目录/topsoft/server/DataKit5/，test-while-idle配置为false。
[root@top175:/topsoft/server/DataKit5]$ mv application-temp.yml config/
[root@top175:/topsoft/server/DataKit5/config]$ vi application-temp.yml
:%s#/opt#/topsoft/server/DataKit5#g修改前
--查看原配置文件内容
[root@top175:/topsoft/server/DataKit5/config]# cat application-temp.yml
system:
# File storage path
defaultStoragePath: /ops/files
# Whitelist control switch
whitelist:
enabled: false
server:
port: 9494
ssl:
key-store: /ops/ssl/keystore.p12
key-store-password: 123456
key-store-type: PKCS12
enabled: true
servlet:
context-path: /
logging:
file:
path: /ops/logs/
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: org.opengauss.Driver
url: jdbc:opengauss://ip:port/database?currentSchema=public&batchMode=off
username: dbuser
password: dbpassword
druid:
test-while-idle: true
test-on-borrow: true
validation-query: "select 1"
validation-query-timeout: 10000
connection-error-retry-attempts: 0
break-after-acquire-failure: true
max-wait: 6000
keep-alive: true
max-active: 30
min-evictable-idle-time-millis: 600000
management:
server:
port: 9494更改后的配置文件内容
[root@top175:/topsoft/server/DataKit5/config]# cat application-temp.yml
system:
# File storage path
defaultStoragePath: /topsoft/server/DataKit5/files
# Whitelist control switch
whitelist:
enabled: false
server:
port: 9494
ssl:
key-store: /topsoft/server/DataKit5/ssl/keystore.p12
key-store-password: 123456
key-store-type: PKCS12
enabled: true
servlet:
context-path: /
logging:
file:
path: /topsoft/server/DataKit5/logs/
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: org.opengauss.Driver
url: jdbc:opengauss://192.168.3.175:15400/dataexchange?currentSchema=public&batchMode=off
username: uxsino
password: Uxs!nO10
druid:
test-while-idle: true
test-on-borrow: true
validation-query: "select 1"
validation-query-timeout: 10000
connection-error-retry-attempts: 0
break-after-acquire-failure: true
max-wait: 6000
keep-alive: true
max-active: 30
min-evictable-idle-time-millis: 600000
management:
server:
port: 9494
生成ssl文件
root用户下操作
使用keytool工具生成密钥，需要注意的是keytool -genkey命令用于创建SSL文件（包括密钥对和证书），并且它与 JDK (Java Development Kit)是有关系的。keytool 是JDK提供的一个工具，用于管理密钥库和证书，用于加密和身份验证等安全通信。而我们前面提到该平台依赖JDK11环境，所以这里使用JDK11来创建密钥文件。
su - root
keytool -genkey -noprompt \
-dname "CN=opengauss, OU=opengauss, O=opengauss, L=Beijing, S=Beijing, C=CN"\
-alias opengauss\
-storetype PKCS12 \
-keyalg RSA \
-keysize 2048 \
-keystore /topsoft/server/DataKit5/ssl/keystore.p12 \
-validity 3650 \
-storepass 123456
需要修改的参数：
-keystore /topsoft/server/DataKit5/ssl/keystore.p12 #位置，视情况修改
-storepass top_123 #top_123密码，视情况修改 注意：
storepass与配置文件application-temp.yml中的key-store-password保持一致
keystore路径与配置文件application-temp.yml中的key-store路径保持一致
启动datakit
--启动
cd /topsoft/server/DataKit5
nohup java -Xms2048m -Xmx4096m -jar openGauss-datakit-5.1.1.jar --spring.profiles.active=temp > ./logs/datakit.out 2>&1 &
--查看日志
tail -200f /topsoft/server/DataKit5/logs/datakit.out问题处理
版本太低，采用的是官网下载的datakit-5.1.0，参考霸王龙博客从gitee下载新版datakit-5.1.1解决
--问题描述
启动查看日志提示如下报错：
Caused by: org.opengauss.util.PSQLException: Connection to 127.0.0.1:5432 refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.
at org.opengauss.core.v3.ConnectionFactoryImpl.openConnectionImpl(ConnectionFactoryImpl.java:352)
at org.opengauss.core.ConnectionFactory.openConnection(ConnectionFactory.java:53)
at org.opengauss.jdbc.PgConnection.<init>(PgConnection.java:255)
at org.opengauss.Driver.makeConnection(Driver.java:561)
at org.opengauss.Driver.connect(Driver.java:314)
at com.alibaba.druid.pool.DruidAbstractDataSource.createPhysicalConnection(DruidAbstractDataSource.java:1657)
at com.alibaba.druid.pool.DruidAbstractDataSource.createPhysicalConnection(DruidAbstractDataSource.java:1723)
at com.alibaba.druid.pool.DruidDataSource$CreateConnectionThread.run(DruidDataSource.java:2838)
--原因
不晓得是不是版本太低
--解决办法
将datakit-5.1.0更换成datakit-5.1.1解决登录datakit平台
启动成功后，可通过浏览器界面访问datakit平台
登录地址：https://192.168.3.175:9494/，其中192.168.3.175为实际ip
初始用户：admin
初始密码：admin123
首次登录需修改初始密码
admin123@123
