--- title: 【万字实操】可视化运维平台openGauss Datakit，带你轻松玩转openGauss 5.0-官方技术文章-鲲鹏社区 description: 本文将从实操方面手把手带你安装Datakit以及使用Datakit部署openGauss5.0.0集群。 keywords: Gauss,万字实操,可视化运维平,Datakit,带你轻松玩转,官方技术文章,鲲鹏社区,特性优势 url: https://www.hikunpeng.com/developer/techArticles/20231109-3?envFlag=1 section: (其他) --- # 【万字实操】可视化运维平台openGauss Datakit，带你轻松玩转openGauss 5.0-官方技术文章-鲲鹏社区 URL: https://www.hikunpeng.com/developer/techArticles/20231109-3?envFlag=1 描述: 本文将从实操方面手把手带你安装Datakit以及使用Datakit部署openGauss5.0.0集群。 关键词: Gauss,万字实操,可视化运维平,Datakit,带你轻松玩转,官方技术文章,鲲鹏社区,特性优势 官方技术文章 [了解详情](https://www.hikunpeng.com/zh/developer/techArticles) 【万字实操】可视化运维平台openGauss Datakit，带你轻松玩转openGauss 5.0 【万字实操】可视化运维平台openGauss Datakit，带你轻松玩转openGauss 5.0 实战经验 发表于 2023/10/19 openGauss Datakit: openGauss社区推出的可视化的运维工具. ## 特性优势 （1）初级用户学习openGauss门槛高让你望而却步？ openGauss Datakit一键化安装企业版集群、监控、日志分析、SQL诊断，让你快速上手，快速部署，从容面对企业环境！ （2）不同openGauss版本运维命令让你晕头转向？ openGauss Datakit屏蔽命令差异，可视化操作，屏蔽命令差异，让你不再为细节犯愁，轻松驾驭openGauss数据库！ （3）数据迁移和校验速度慢成了难题？ openGauss Datakit携手全新迁移工具集，图形化、批量并行迁移全流程，速度大幅提升，告别烦恼！ （4）openGauss的监控和日志分析让你头疼？ openGauss Datakit一站式解决方案，让你轻松掌控数据库状态！ openGaussDatakit，开启数据库畅玩时代，让运维如丝般顺滑！ 完全干货，本文将从实操方面手把手带你安装Datakit以及使用Datakit部署openGauss5.0.0集群。 注意事项： （1）当前平台运行依赖于openJDK11 （2）平台使用的数据库，当前仅支持openGauss数据库，并且需要提前创建database （3）如果有防火墙，需要将部署服务器IP配置在平台使用的数据库（openGauss）的白名单列表中 （4）平台默认的登录账号密码：admin/admin123，请在首次登录后及时修改密码 注： 本文基于openEuler release 22.03 LTS x86_64部署openGaussDatakit5.0.0 ## Datakit的安装 ### 1. 环境准备 （1）创建安装包存放目录 ``` mkdir -p /soft/ ``` 我这里已经将用到的各种包整理到datakit-about.zip datakit下载地址： https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/tools/Datakit/Datakit-5.0.0.tar.gz [了解详情](https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/tools/Datakit/Datakit-5.0.0.tar.gz) 上传datakit-about.zip到/soft并解压： ``` cd /soft unzip datakit-about.zip ``` 解压后的目录结构如下 ``` /soft/datakit-about ├── datakit │ └── Datakit-5.0.0.tar.gz ├── docker │ └── docker-engine-18.09.0-300.oe2203.x86_64.rpm ├── openGaussRPM │ └── opengauss-2.1.0-5.oe2203.x86_64.rpm └── openjdk ├── giflib-5.2.1-4.oe2203.x86_64.rpm ├── java-11-openjdk-11.0.20.8-0.oe2203.x86_64.rpm ├── java-11-openjdk-headless-11.0.20.8-0.oe2203.x86_64.rpm ├── java-1.8.0-openjdk-1.8.0.352.b08-3.oe2203.x86_64.rpm ├── java-1.8.0-openjdk-devel-1.8.0.352.b08-3.oe2203.x86_64.rpm └── java-1.8.0-openjdk-headless-1.8.0.352.b08-3.oe2203.x86_64.rpm ``` （2）解压Datakit-5.0.0.tar.gz ``` cd /soft/datakit-about/datakit/ tar -xvf Datakit-5.0.0.tar.gz ``` 解压后的Datakit-5.0.0目录结构如下 ``` /soft/datakit-about/datakit/ ├── alert-monitor-5.0.0-repackage.jar ├── alert-monitor-README.md ├── application-temp.yml ├── base-ops-5.0.0-repackage.jar ├── base-ops-README.md ├── Datakit-5.0.0.tar.gz ├── data-migration-5.0.0-repackage.jar ├── data-migration-README.md ├── data-studio-readme.md ├── monitor-tools-1.0.0-repackage.jar ├── observability-instance-5.0.0-repackage.jar ├── observability-instance-README.md ├── observability-log-search-5.0.0-repackage.jar ├── observability-log-search-README.md ├── observability-sql-diagnosis-5.0.0-repackage.jar ├── observability-sql-diagnosis-README.md ├── openGauss-tools-monitor-README.md ├── visualtool-main.jar ├── visualtool-README.md └── webds-plugin-5.0.0-repackage.jar ``` 注： jar方式安装Datakit时略过此步骤 ``` cd /soft/datakit-about/docker/ rpm -ivh *.rpm ``` ### 3. 安装openJDK11 ``` cd /soft/datakit-about/openjdk rpm -ivh *.rpm ``` 系统中安装多个jdk版本，可以使用alternatives命令来切换默认的Java版本，后面会提到。 ### 4. 安装openGauss数据库 该平台当前仅支持openGauss数据库，并且需要提前创建database。 这里采用最简单的一种方式——通过RPM方式安装极简版的openGauss。 ``` cd /soft/datakit-about/openGaussRPM rpm -ivh *.rpm ``` 切换到openGauss用户 ``` su - opengauss ``` 进入openGauss数据目录 ``` cd $PGDATA ``` 编辑 postgresql.conf ``` vi postgresql.conf ``` 修改下面两个参数 ``` listen_addresses = '*' max_connections = 1000 ``` 编辑 pg_hba.conf ``` vi pg_hba.conf ``` 文末追加 ``` host all all 0.0.0.0/0 sha256 ``` 重启openGauss服务 ``` gs_ctl restart ``` 登录数据库 ``` gsql -d postgres -p 7654 -r ``` 修改openGauss密码 初次登录，执行命令时会提示修改openGauss密码 出现如下信息 ``` ERROR: Please use "ALTER ROLE user_name PASSWORD 'password';" to set the password of user opengauss before other operation! ``` 修改openGauss密码即可 ``` ALTER ROLE opengauss PASSWORD 'Admin@123'; ``` 创建用户 ``` CREATE USER trex IDENTIFIED BY 'Trex@123'; ``` 授权 ``` alter user trex sysadmin; ``` 创建数据库 ``` create database trexdb; ``` ### 5. 安装部署 （1）jar包方式（离线安装） 1）创建datakit工作目录，并在工作目录中创建存放系统运行数据的子目录 ``` mkdir -p /ogdatakit/{logs,config,ssl,files,visualtool-plugin} ``` 2）将visualtool-main.jar包复制到 /ogdatakit 下 ``` cd /ogdatakit/ cp /soft/datakit-about/datakit/visualtool-main.jar . ``` 3）将插件复制到/ogdatakit/visualtool-plugin ``` cp /soft/datakit-about/datakit/base-ops-5.0.0-repackage.jar /ogdatakit/visualtool-plugin ``` 4）修改配置文件 将配置文件application-temp.yml 复制到 /ogdatakit/config/下 修改application-temp.yml文件中的数据链链接ip、port、database、dbuser、dbpassword。 ``` cp /soft/datakit-about/datakit/application-temp.yml /ogdatakit/config/ vi /ogdatakit/config/application-temp.yml ``` 修改如下部分内容 5）修改配置文件中平台工作目录 ``` sed -i s#/ops#$(pwd)#g config/application-temp.yml ``` 6）创建ssl文件 keytool -genkey 命令用于创建 SSL 文件（包括密钥对和证书），并且它与 JDK（Java Development Kit）是有关系的。keytool 是 JDK 提供的一个工具，用于管理密钥库和证书，用于加密和身份验证等安全通信。 切换到openJDK11环境，并验证版本 ``` alternatives --config java java -version ``` ``` 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 $(pwd)/ssl/keystore.p12 \ -validity 3650 \ -storepass 123456 ``` 7）执行启动命令 ``` nohup java -Xms2048m -Xmx4096m -jar $(pwd)/visualtool-main.jar \ --spring.profiles.active=temp >$(pwd)/logs/visualtool-main.out 2>&1 & ``` 8）查看执行日志 ``` tail -200f /ogdatakit/logs/visualtool-main.out ``` 显示如下信息表示初始化完成 接下来就可以使用Datakit了，详见步骤 【Datakit的使用】 （2）docker方式安装（联网安装） 1）创建datakit工作目录，并在工作目录中创建存放系统运行数据的子目录 ``` mkdir -p /ogdatakit/{logs,config,ssl,files,visualtool-plugin} ``` 2）将visualtool-main.jar包复制到 /ogdatakit 下 ``` cd /ogdatakit/ cp /soft/datakit-about/datakit/visualtool-main.jar . ``` 3）将插件复制到/ogdatakit/visualtool-plugin ``` cp /soft/datakit-about/datakit/*.jar /ogdatakit/visualtool-plugin ``` 4）修改配置文件 将配置文件application-temp.yml 复制到 /ogdatakit/config/下 修改application-temp.yml文件中的数据链链接ip、port、database、dbuser、dbpassword. ``` cp /soft/datakit-about/datakit/application-temp.yml /ogdatakit/config/ vi /ogdatakit/config/application-temp.yml ``` 修改如下部分内容 5）创建ssl文件 keytool -genkey 命令用于创建 SSL 文件（包括密钥对和证书），并且它与 JDK（Java Development Kit）是有关系的。keytool 是 JDK 提供的一个工具，用于管理密钥库和证书，用于加密和身份验证等安全通信。 切换到openJDK11环境 ``` alternatives --config java ``` 验证版本 ``` java -version ``` 创建ssl文件 ``` cd /ogdatakit/ 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 $(pwd)/ssl/keystore.p12 \ -validity 3650 \ -storepass 123456 ``` 6）编辑Dockerfile ``` cd /ogdatakit/ vi Dockerfile ``` 粘贴以下内容 ``` FROM openjdk:11 ENV TZ=Asia/Shanghai RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone EXPOSE 9494 5432 WORKDIR /ops/ ENTRYPOINT ["java","-Xms2048m","-Xmx4096m", "-jar", "visualtool-main.jar"] ``` 7）构建镜像 ``` cd /ogdatakit/ docker build -f Dockerfile -t datakit:5.0.0 . ``` 8）启动容器 ``` cd /ogdatakit/ docker run -idt -p 9494:9494 \ -v /etc/localtime:/etc/localtime:ro \ -v $(pwd):/ops \ --name datakit datakit:5.0.0 \ --spring.profiles.active=temp ``` 显示的a25f5fdda47531e9c9093e501e569a4aeba59b610581d11c2ff4be317108e697为容器ID 列出当前正在运行的容器 ``` docker ps ``` 显示如下 查看日志 ``` docker logs -f datakit ``` 显示如下信息表示初始化完成 接下来就可以使用Datakit了，详见步骤 【Datakit的使用】 ## Datakit的使用 ### 1. 登录管理界面 在浏览器中打开如下地址：https://192.168.7.100:9494/ [了解详情](https://192.168.7.100:9494) 平台默认的登录账号密码：admin/admin123，请在首次登录后及时修改密码。 进入主界面 ### 2. 安装部署openGauss集群 此处以安装一主一备集群为例进行演示 （1）环境概要 | 主机名 | 操作系统 | 架构 | IP | | --- | --- | --- | ---| | trex01 | openEuler20.03 | x86_64 | 192.168.7.111 | | trex02 | openEuler20.03 | x86_64 | 192.168.7.112 | （2）安装前准备 下载openGauss企业版安装包：https://opengauss.org/zh/download/ [了解详情](https://opengauss.org/zh/download/) 下载完成后会得到 openGauss-5.0.0-openEuler-64bit-all.tar.gz 1）创建用户组dbgrp及用户 注： a. 操作系统root用户执行 b. trex01和trex02都操作 ``` groupadd dbgrp useradd -g dbgrp omm passwd omm ``` 密码这里设置为omm@123 2）给omm授予root权限 ``` chmod u+w /etc/sudoers vi /etc/sudoers ``` 追加如下内容 ``` omm ALL=(ALL) NOPASSWD: ALL ``` 3）创建软件包路径并授权 ``` mkdir -p /opt/software/openGauss chmod +x /opt/software/openGauss/ chown -R omm:dbgrp /opt/software ``` 4）在root用户下验证下述命令是否执行成功 注： 如果不成功，请检查上述3个步骤 ``` su - omm -c 'cd /opt/software/openGauss/' ``` 5）安装依赖包 ``` yum install libaio-devel flex bison ncurses-devel glibc-devel patch readline-devel libnsl2 bzip2 python3 expect ``` （3）配置服务器信息 进入Datakit管理界面 1）配置trex01 a. 新增物理机 注 ① 准确的来说，界面上应该是新增服务器，这里物理机和虚拟机均可 ② 如果服务器只有一个网卡，内外网ip可以设置成同一个。 ③ 端口为ssh端口 ④ 密码：操作系统root密码 b. 添加普通用户 注 这里添加的用户是在2.2.1步骤创建的omm用户 2）配置trex02 以配置trex01同样的方法，配置trex02 3）配置信息预览 trex01和trex02配置完成后，显示如下 （4）集群安装 1）选择安装的openGauss版本 此处以企业版为例 2）选择安装方式 这里以离线安装为例 3）上传安装包 点击上传 在弹出的界面直接点击图中的“+”上传，会自动识别并填充其它信息 选择 openGauss-5.0.0-openEuler-64bit-all.tar.gz 安装包名称可自定义，其它信息为自动识别 上传完成后，会显示到如下 选中openGauss的安装包 4）集群配置 a. 集群配置 注 ① 这里选择环境分离后，openGauss的环境变量会单独配置的自定义文件中，避免和用户环境变量产生混乱。 ② 根据个人习惯，你也可以不选择环境分离 b. 主节点配置 因为前面配置过服务器信息，这里直接下拉框选择即可 c. 备节点1配置 5）环境检测 图中的警告信息可忽略。 原因：这里内存建议32GB或以上是针对生产环境的要求，实际开发测试4GB完全可以正常安装。 6）集群信息预览 7）执行安装 注 安装过程中： ① openGauss集群安装完全自动化 ② 窗口中会显示执行命令的详细信息 ③ 请勿进行其他操作，否则将导致安装失败 8）安装完成 显示如下信息，表示安装成功 请妥善保管用户名密码 | 名称 | 值 | | --- | ---| | 集群标识 | cluster_trex | | 端口号 | 5432 | | 数据库用户 | gaussdb | | 主节点 | 192.168.7.111 | | 备节点1 | 192.168.7.112 | 初始化密码：Trex@123 默认数据库用postgres （5）集群一览 在首页界面可以看到集群一览信息 实时显示服务器的cpu使用率、内存使用率、网络状态、连接数等信息 （6）集群管理 进入集群管理界面，可以进行启动、停止、重启、备份、卸载、强制卸载、删除集群 （7）实例管理 新增数据源 （8）业务开发 1）填写数据库连接信息 数据库列表显示如下 2）创建测试表，并进行查询 （9）其他功能 关于其它功能，操作很简单，这里不做赘述，快开始动手探索吧!