Adding Copysets

To horizontally scale an existing data grid you can create additional copysets and create nodes to assign to these copysets.

Important: Data grids created using earlier versions of ActiveSpaces have to be upgraded by following the procedures detailed in 'Upgrading an Earlier Installation' in the TIBCO ActiveSpaces® Installation guide.

Use the copyset create command in the tibdg tool to create the copysets and nodes. Once created, though the nodes can be started they do not yet receive any data. Use the grid redistribute command in the tibdg tool to start the data redistribution process.

The tibdg grid redistribute command can be invoked at any time to assign data to newly added copysets. If the nodes involved in the redistribution are not running, they begin redistributing data once they are started.

For example, to grow a data grid from three copysets to four copysets, the following commands must be used: 

tibdg -r http://host:port copyset create cset4
tibdg -r http://host:port node create --copyset cset4 --dir ./s4_data s4

tibdgnode -r http://host:port -n s4

tibdg -r http://host:port grid redistribute
Note: Before starting any nodes in the new copyset, all members of the copyset must be added via the tibdg node create command. For example, if each copyset has two nodes (as defined by the copyset_size parameter supplied to the tibdg grid create command), you must create two nodes in the new copyset before starting the tibdgnode processes.

View the status of the redistribution by running the status command in the tibdg tool. 

tibdg -r http://host:port status
Caution: If you are using a secure realm server use https://host:port instead of http://host:port.
  • Data Redistribution
    Data redistribution is done in the background and does not block ongoing operations while data is being transferred.