DEV Community

mmllllzcn
mmllllzcn

Posted on

GBase Database (GBase 8s) One-Click Installation Guide: Step-by-Step Walkthrough

#gbase #database #数据库 #todayilearned

Installing a database involves more than extracting a package and running a script. You also need to configure the instance name, network port, installation directory, character set, and storage resources.

GBase Database (GBase 8s) provides a one-click installation workflow that combines software installation and database instance initialization into a streamlined process.

In this guide, we'll walk through the complete GBase Database one-click installation process, from extracting the installation package to verifying the generated JDBC connection string.

Prerequisites

Before starting the installation, prepare the following:

  • A supported Linux operating system and compatible installation package.
  • Sufficient disk space and memory for your intended workload.
  • Root or appropriate administrative privileges for preparing the installation environment.
  • The installation package and its accompanying PluginPak directory.
  • A planned installation path, instance name, and available network port.

Follow the installation instructions provided with your specific GBase Database distribution, especially for operating system compatibility and account permissions.

Step 1: Extract the GBase Database Installation Package

Create or navigate to your installation directory and extract the package.

cd /opt/GBase
tar -vxf GBase8sV8.8_TL_3.6.2_2_RHEL6_x86_64.tar
Enter fullscreen mode Exit fullscreen mode

The filename above is an example of a specific GBase 8s distribution. Replace it with the actual package filename you downloaded.

After extraction, locate the PluginPak directory. This directory contains the configuration file and installation script used in the following steps.

Step 2: Configure the init.ini File

Before running the installer, edit PluginPak/init.ini and review the installation parameters.

USER_OS_PWD    = GBase@123
GBASEDBTSERVER = gbase01
PORT           = 9088
GBASEDBTDIR    = /opt/gbase8s
DB_LOCALE      = zh_CN.utf8
SHM_SIZE       = 0
CHUNK_SIZE     = 5120
Enter fullscreen mode Exit fullscreen mode

Each parameter controls an important part of the installation.

Parameter Purpose
USER_OS_PWD Password for the operating system account used by the installation workflow
GBASEDBTSERVER Database instance name
PORT Network listening port
GBASEDBTDIR Database installation directory
DB_LOCALE Database locale and character-handling configuration
SHM_SIZE Shared memory configuration, in MB
CHUNK_SIZE Initial storage allocation parameter, in MB

Important configuration notes:

  • Password: Replace the example password with an appropriate secure value. Do not use demonstration credentials in production.
  • Port: The example uses 9088. Confirm that the port is available and consistent with your intended connection configuration.
  • Installation path: Ensure /opt/gbase8s has sufficient space and the required ownership and permissions.
  • Locale: Confirm that zh_CN.utf8 matches your application's character-set requirements before initializing the database.
  • Shared memory: In this installation workflow, SHM_SIZE=0 enables automatic sizing, described as one-quarter of available memory. Verify this behavior against your package documentation and review resource allocation for production systems.
  • Storage: Confirm the meaning and sizing behavior of CHUNK_SIZE in the supplied installation documentation.

The exact defaults and supported values may vary by package version, so validate them before proceeding.

Step 3: Run the One-Click Installation Script

After reviewing the configuration, switch to the installation directory and execute the script.

cd /opt/GBase/PluginPak
sh install_init.sh
Enter fullscreen mode Exit fullscreen mode

The script performs the installation and instance initialization according to the supplied configuration. Follow any prompts or error messages displayed by your specific package.

A successful run may produce output similar to the following:

Product install status:
  1)GBase8s V8.8: Successful
  2)GBase Connect: Successful
JDBC URL: jdbc:gbasedbt-sqli://0.0.0.0:9088/gbasedb:GBASEDBTSERVER=gbase01
Enter fullscreen mode Exit fullscreen mode

This output indicates that the listed components were installed successfully and provides a JDBC connection string for client configuration.

Step 4: Verify Database Connectivity

Seeing a JDBC URL is a useful installation milestone, but it should not be treated as complete proof of application connectivity.

Before using the instance, verify that:

  1. The database instance is running.
  2. The configured port is listening.
  3. Network access and firewall rules permit the intended connection.
  4. The JDBC driver is available to your application.
  5. A connection test succeeds with valid credentials.

The example URL contains 0.0.0.0, which is a bind-address convention rather than a destination clients should normally use. Replace it with the actual server hostname or IP address when configuring a remote client, and confirm the database name and connection properties against your environment.

Final Thoughts

The GBase Database (GBase 8s) one-click installation process reduces repetitive setup work by combining software installation and instance initialization into a short workflow.

The key is to prepare the environment, review init.ini, execute install_init.sh, and verify the resulting database connection.

Automation makes deployment faster, but careful configuration makes it dependable. For development environments, proof-of-concept projects, and repeatable test deployments, this approach provides a practical starting point for getting a GBase Database instance running efficiently.

Top comments (0)