Open topic with navigation

TIBCO ActiveSpaces® - Enterprise Edition 5.0.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 changes 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 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 runs 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

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO ActiveSpaces® - Enterprise Edition

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