DEV Community

Michael
Michael

Posted on • Originally published at gbase8.cn

GBase Visio Rsynctool (GVR) Quick Deployment and Configuration

#gbase #database #数据库 #operations

GVR (GBase Visio Rsynctool) is a web-based management console for GBase 8a's active-active cluster synchronization tool, Rsynctool. It bundles a JRE and an embedded SQLite database, so you can unzip and run it immediately. This guide covers rapid deployment and common configuration changes.

Prerequisites

  • JRE: Bundled Java 8, no separate installation needed.
  • Python: 2.7 required on the host.
  • Memory: At least 4 GB RAM for testing (the main GVR process uses ~2 GB).
  • Port: Default 1526. Verify it is free with lsof -i:1526.

Deploy and Start

Extract the tarball and start the service:

tar xvf GBase_Visio_Rsynctool-9.5.4.5_build3.tar
cd GBase_Visio_Rsynctool-9.5.4.5_build3/
sh rsync.sh start
Enter fullscreen mode Exit fullscreen mode

After startup, open a browser and navigate to http://<IP>:1526 to access the GVR console.

Key Configuration Files

Inside the installation directory, the important files are:

  • application.yml – main configuration (e.g., server port)
  • application-druid.yml – backend database (SQLite / MySQL / PostgreSQL)
  • logback.xml – logging settings (default path /tmp/sync/logs)
  • ipmapping – IP mapping for environments where the management and data networks are separated

Changing the Web Port

Edit the server.port property in application.yml, then restart.

server:
  port: 8526
Enter fullscreen mode Exit fullscreen mode 
sh rsync.sh restart
Enter fullscreen mode Exit fullscreen mode

Switching the Backend Database to MySQL

GVR defaults to the embedded SQLite. To use MySQL instead:

  1. Create the database and run the initialization scripts. 
CREATE DATABASE gbase_gvr_demo;
USE gbase_gvr_demo;
SOURCE /opt/gbase/GBase_Visio_Rsynctool-9.5.4.5_build3/sql/gbase-gvr_mysql_4.2.sql;
Enter fullscreen mode Exit fullscreen mode

  1. Apply any required upgrade patches (e.g., upgrade_4.4.sql) and schema changes specific to your GVR version.

  2. Edit application-druid.yml: comment out the SQLite block and uncomment the MySQL section with the correct connection details.

spring:
    datasource:
        type: com.alibaba.druid.pool.DruidDataSource
        driverClassName: com.mysql.cj.jdbc.Driver
        druid:
            master:
                url: jdbc:mysql://localhost:3306/gbase_gvr_demo?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&allowMultiQueries=true
                username: root
                password: 111111
Enter fullscreen mode Exit fullscreen mode
  1. Restart GVR and check the log to confirm it started without errors. 
tail /tmp/sync/logs/gvr-error.log
Enter fullscreen mode Exit fullscreen mode

With its lightweight deployment and pluggable database backends, GVR can be set up quickly in almost any gbase database environment, making active-active synchronization management straightforward.

Top comments (0)