DEV Community

GBASE Database
GBASE Database

Posted on

GBASE 数据库 | GBase 8a Database GDOM Deployment Guide

The GBase 8a MPP Database Operation Management System (GDOM) is a B/S architecture tool designed to provide full lifecycle operation and maintenance (O&M) support for the GBase 8a MPP database. It offers a range of functionalities including cluster management, host management, health checks, and alerts, all aimed at reducing customer O&M costs, improving efficiency, and ensuring 24/7 operation of the cluster.

GDOM Environment Setup Checklist

Server Installed Components Node Type Remarks
10.0.0.211 nginx, gdom-service Deployment
10.0.0.212 haproxy Installation Optional
10.0.0.213 mysql Installation
10.0.0.214 mysql Installation Optional
10.0.0.215 Redis, RocketMQ Installation

Note: Node Types

  1. Deployment Node: This is where the GDOM installation package is deployed. GDOM installation, service start/stop, uninstallation, and status queries are all managed from this node. It is the special installation node for managing GDOM services.
  2. Installation Node: This is the server for installing GDOM components. For high availability configuration, if deploying with a single node, ignore the optional nodes.

1. Unpacking the Installation Package

1.1. On the 10.0.0.211 machine, use the root user to unpack the package:

[root@nginx_gdom-service /opt]# tar -xf GDOM-v3.0.0-build1.2.tar.gz 
Enter fullscreen mode Exit fullscreen mode

2. Set Up User Trust

2.1. Prerequisite: Configure demo.options to specify the servers requiring mutual trust.

Edit demo.options:

vim /opt/GDOM-v3.0.0-build1.2/demo.options 
Enter fullscreen mode Exit fullscreen mode

Example configuration:

gdomRoot=/opt/gdom gdomService=10.0.0.211 gdomServicePort=8080 user=gdom gdomDb=10.0.0.213,10.0.0.214 gdomDbPort=3306 gdomDbUrl= gdomDbUser=root gdomDbPwd=1 gdomDbHa=10.0.0.212 gdomDbHaPort=3307 gdomDbHaMonitorPort=8811 gdomDbHaMonitorAdmin=admin gdomDbHaMonitorPwd=admin gdomNginx=10.0.0.211 gdomNginxPort=8810 gdomNginxUrl= gdomRedis=10.0.0.215 gdomRedisPort=7481 gdomRedisDb=0 gdomRedisUrl= gdomMq=10.0.0.215 gdomMqPort=9876 gdomDashBoardPort=9898 gdomMqUrl= 
Enter fullscreen mode Exit fullscreen mode

2.2. Execute on all machines:

useradd gdom passwd gdom su - gdom ssh-keygen -t rsa -P '' ssh-copy-id *.*.*.* 
Enter fullscreen mode Exit fullscreen mode

3. Set Up Auto Start (Optional)

3.1. On the deployment machine:

[root@nginx_gdom-service ~]# vim /etc/rc.local 
Enter fullscreen mode Exit fullscreen mode

Add the following configuration:

#!/bin/sh -e /opt/GDOM-v3.0.0-build1.2/gdomStart.sh -a exit 0 
Enter fullscreen mode Exit fullscreen mode

Explanation:

  • /opt: The parent directory where the GDOM installation package is unpacked.
  • GDOM-v3.0.0-build1.2: The directory where the GDOM installation package is unpacked.
  • gdomStart.sh -a: The one-click start script for GDOM.

4. GDOM Deployment

4.1. Note: Ensure that the user has permission to operate on the GDOM root directory on all nodes.

On all machines, execute:

mkdir /opt/gdom chown -R gdom.gdom /opt/gdom 
Enter fullscreen mode Exit fullscreen mode

4.2. On the deployment machine, run the installation script:

[root@nginx_gdom-service /opt/GDOM-v3.0.0-build1.2]# su - gdom [gdom@nginx_gdom-service /opt/GDOM-v3.0.0-build1.2]# sh gdomInstall.sh -a 
Enter fullscreen mode Exit fullscreen mode

5. Start GDOM Service

5.1. On the deployment machine, start the service:

[gdom@nginx_gdom-service /opt/GDOM-v3.0.0-build1.2]$ sh gdomStart.sh -a 
Enter fullscreen mode Exit fullscreen mode

5.2. After starting the service, access the browser:

  • URL: http://10.0.0.211:8810
  • Default Username: admin
  • Default Password: admin123

To stop the service:

sh gdomStop.sh -a 
Enter fullscreen mode Exit fullscreen mode

To check the service status:

sh gdomStatus.sh -a 
Enter fullscreen mode Exit fullscreen mode

6. Explanation of demo.options

# GDOM installation root directory gdomRoot=/opt/pjx # Backend service installation node (comma-separated) gdomService=192.168.1.2 # Backend service port (affects frontend requests to gdom-service) gdomServicePort=8080 # GDOM user user=gdom # Repository installation nodes (for high availability configuration, comma-separated) gdomDb=192.168.1.4,192.168.1.5 # Repository access port (affects backend requests to MySQL) gdomDbPort=3306 # Existing repository IP address gdomDbUrl=192.168.3.87 # Repository connection user gdomDbUser=root # Repository connection password gdomDbPwd=111111 # High availability proxy node for repository (recommended to deploy separately) gdomDbHa=192.168.1.3 # Repository high availability access port gdomDbHaPort=3307 # Repository high availability proxy monitor access port gdomDbHaMonitorPort=8811 # Repository high availability proxy monitor login user gdomDbHaMonitorAdmin=admin # Repository high availability proxy monitor login password gdomDbHaMonitorPwd=admin # Nginx installation node gdomNginx=192.168.1.2 # Nginx access port (affects browser access) gdomNginxPort=8810 # Existing Nginx IP address [If this is set, gdomNginx is invalid] gdomNginxUrl= # Redis installation node gdomRedis=192.168.1.6 # Redis access port (affects backend requests to Redis) gdomRedisPort=7481 # Redis DB to use gdomRedisDb=0 # Existing Redis IP address [If this is set, gdomRedis is invalid] gdomRedisUrl= # RocketMQ installation node gdomMq=192.168.1.6 # RocketMQ access port (affects backend requests to RocketMQ) gdomMqPort=9876 # RocketMQ monitoring platform access port (optional) gdomDashBoardPort=9898 # Existing RocketMQ IP address [If this is set, gdomMq is invalid] gdomMqUrl= 
Enter fullscreen mode Exit fullscreen mode

Note: MySQL, Redis, RocketMQ, and Nginx are optional components.

If the user’s environment already has these components, configure their URL properties in demo.options. Regardless of whether they are newly installed or already present, the ports need to be configured.

For the best results, it is recommended to do a fresh installation to avoid conflicts with existing middleware.


With GDOM, you can ensure efficient O&M operations, simplified management, and seamless service monitoring for your GBase 8a deployment. Happy managing!

Top comments (0)