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 by using earlier versions of ActiveSpaces must be upgraded by following the procedures detailed in "Upgrading from an Earlier Version" in TIBCO ActiveSpaces® Installation.

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 by using 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.

Subtopics