Defining a Data Grid

To define and configure a data grid, complete the steps in this task.

This task implements decisions about the structure of your data grid, creating a data grid definition within a TIBCO FTL realm service. The realm service delivers the information to the component processes of the data grid and your application processes that use the grid.

The examples in these steps illustrate adding commands to a configuration script. When the script is complete, the administration tool executes the script to define the data grid.

Alternatively, you could execute each step immediately as a separate administration tool command, instead of accumulating them in a script.

You have already completed the task Designing a Data Grid. This task refers to decisions you recorded during that task.

Prerequisites

A realm service must be running and reachable.

Procedure

  1. In a text editor, begin editing a script file.
    Follow the convention of naming your script with the .tibdg file name extension.
  2. Add a script command to create the data grid using the syntax: grid create [option=value]... [<grid_name>]. For example: 
    grid create statekeeper_count=1 copyset_size=1 mydevgrid
    Note: For more information on grid create option, see Grid Create Configuration Options.
    You can run the following command for a list of all the options for the grid create script command: 
    tibdg help grid create

Define the Component Processes of the Data Grid

  1. For each copyset, add a script command to create that copyset. For example: 
    copyset create copyset_name
  2. For each node, add a script command to create that node. For example: 
    node create --copyset copyset_name node_name
  3. For each state keeper, add a script command to create that state keeper. For example: 
    keeper create keeper_name
  4. For each proxy, add a script command to create that proxy. For example: 
    proxy create proxy_name
  5. Optional. Run the script to create the data grid.
    Alternatively, you might postpone this step until you have defined the tables of the data base (see the task Defining a Table). 
    tibdg -s script_file_path -r http://<host>:<port>>

    where <host> and <port> refer to the realm service URL.

What to do next

Starting the Data Grid Processes

  • Grid Create Configuration Options
    The following configuration options can be used with the tibdg grid create command.
  • Configuration Options to Use Specific Ports and Network Interfaces
    TIBCO ActiveSpaces leverages TIBCO FTL internally to aid in connecting the different TIBCO ActiveSpaces processes so that they can communicate over the network. In certain cases, you can specify additional configuration information when initially setting up the data grid processes to help influence what ports and network interfaces must be chosen when the processes are started.