Expanding a GBase 8a Cluster: Adding a GNode in Practice

Source: Dev.to

Prerequisites

• Existing healthy GBase 8a cluster
• New server with a static IP address
• Network connectivity between all nodes

Expansion Procedure

1. Stop services on existing nodes

gcadmin all stop

2. Configure the new node

• Set a static IP and verify connectivity:

ping 172.16.5.172

• On the new node, perform the following tasks:
  • Create the gbase user and group
  • Tune system and kernel parameters
  • Run the SetSysEnv.py environment script
  • Configure password‑less SSH
  • Update demo.options with the new node’s details:

NEW_NODE_IP=172.16.5.178
NODE_ROLE=gnode
CLUSTER_NAME=my_gcluster

• Accept the license agreement and confirm the target node when prompted by the installer.

3. Register the node

gcadmin addNode --host=172.16.5.178 --role=gnode

4. Verify node addition

gcadmin show cluster

Best‑Practice Checklist

• Backup first – always back up data before expanding.
• Version match – ensure the new node runs the same software version as the cluster.
• Resource planning – allocate sufficient storage and memory.
• Network latency – keep latency between new and existing nodes within acceptable limits.

Post‑Expansion Validation

Cluster status

gcadmin all status

Node connectivity

gcadmin show nodes

Data distribution

gbase -e "show distribution"

Conclusion

Following these steps yields a smoothly scaled GBase 8a cluster, ready to handle continued data growth with its distributed engine.