Version 2.2 - 2.3 Copyright © 2019 TigerGraph. All Rights Reserved.
Cluster expansion allows the user to add new machine nodes to an existing cluster and to redistribute data, while the entire system is offline.
The current TigerGraph system must be installed in cluster mode, not single-node mode.
The total graph data storage space for the expanded cluster should be at least 3 times as large as the current Gstore disk usage.
During the expansion process, a backup copy of all the graph data files is created, plus additional working space is needed.
To check your existing gstore disk space:
The new nodes are available.
The GBAR utility is used for cluster expansion. If this is your first time using GBAR, you must first run
gbar config. See the Backup and Restore guide. For a large system one of the key parameters is
backup_core_timeout. The default value is 5 hours. The config script gives guidance on estimating an appropriate value.
From the command line, switch to the
<tigergraph_root_dir>/pkg_pool/syspre_pkg directory under the TigerGraph root directory (
~/tigergraph/pkg_pool/syspre_pkg by default). In this directory, a utility script
set_syspre.sh is used to setup environment:
./set_syspre.sh -h to see the usage:
./set_syspre.sh -hUsage:./set_syspre.sh -i <IP address/host name> -u <sudo user> (-P <password> | -K <ssh key>) [-p <tigergraph user password>]./set_syspre.sh -hOptions:-h -- show the help-i -- the IP address of the new machine-u -- sudo user [default: $USER]-P -- sudo user password [default: empty]-K -- sudo user ssh key [default: empty]-p -- tigergraph user password [default: tigergraph][NOTE ]: This script must be run under tigergraph user.
For example, to set up the environment on a new node
192.168.1.6 with sudo user called
ubuntu and login key
ubuntu_rsa, run the following command:
./set_syspre.sh -i 192.168.1.6 -u ubuntu -K ~/.ssh/ubuntu_rsa
When done, the environment including system-prerequisites and ssh keys for the TigerGraph system will be set up on the new nodes.
To expand the cluster, run
gbar expand with a list of new nodes in the following format:
gbar expand <node_alias_1>:<ip_1>,<node_alias_1>:<ip_2>,...,<node_alias_n>:<ip_n>
For example, the following command adds two nodes to the cluster:
gbar expand m6:192.168.1.6,m7:192.168.1.7
The command above will redistribute the data on all nodes including m6 and m7, so that each node has about the same amount of data.
Advanced expansion configuration options are possible. Contact TigerGraph Support for guidance.
Should any errors occur, GBAR will roll back to the state before node expansion started. As a failsafe, a backup copy of the data is kept, until expansion either succeeds or finishes rollback.