Open topic with navigation

TIBCO ActiveSpaces® 4.8.0

# Administration Tool

tibdg is an administrative command-line tool for ActiveSpaces. You can use it to define data grid components, tables, and indexes; to see the status of data grid components; and to save and restore the definitions of a data grid.

## Usage Help

To see a summary of commands, run the administration tool with the help command:

    tibdg help

To see information about a specific command or command area, run the administration tool with the help command and the command as an argument. For example:

    tibdg help copyset

    tibdg help table

    tibdg help status

## Realm Service Interactions

Administration tool commands interact with the realm service:

- Storing definitions in the realm service
- Retrieving definitions from the realm service
- Retrieving status information from the realm service

Every interaction command requires the location of the realm service, either as an argument or as the value of an environment variable.

## Modes of Operation

You can use the administration tool in two ways:

- Immediate command execution: When you run tibdg, the tool makes the change in the realm service workspace, and immediately deploys that change to the realm service's clients (namely, data grid component processes).

  This mode is convenient for changes to a running data grid (such as adding a new table), for saving the data grid definition to a file, and for requesting status information about a running data grid.

- Command script: Alternatively, you can create a command script file containing several commands. Then tibdg executes that batch of commands, accumulating those changes in the realm service workspace. Finally, the tool deploys all the workspace changes to the realm service's clients before exiting.

  This mode is convenient for a series of related changes, such as defining a data grid, or creating a table and its columns.

Consider the following two examples, which accomplish the same goal: defining a data grid. The first example runs five separate command-lines, deploying each change immediately.

    tibdg grid create
    tibdg copyset create my_copyset
    tibdg node create my_node
    tibdg keeper create my_keeper
    tibdg proxy create my_proxy

In contrast, the second example consists of five commands in a script file, my_script_file.tibdg:

    grid create
    copyset create my_copyset
    node create my_node
    keeper create my_keeper
    proxy create my_proxy

Then it runs the script with one command-line, deploying all the changes at the end.

    tibdg -s my_script_file.tibdg

For more information about the realm service and its workspace, see TIBCO FTL® Administration.

Subtopics

Copyright © 2009-2022. Cloud Software Group, Inc. All Rights Reserved.