Scroll to navigation

GEOSTORE(8)   GEOSTORE(8)

NAME

geostore - geo cluster attribute manager

SYNOPSIS

geostore set [-t ticket] [-s site] [-c config] attribute value

geostore get [-t ticket] [-s site] [-c config] attribute

geostore delete [-t ticket] [-s site] [-c config] attribute

geostore list [-t ticket] [-s site] [-c config]

DESCRIPTION

Applications running in GEO cluster environments may need more information apart from tickets to make decisions. One example may be the status of data replication.

geostore is a helper program to manage site attributes. The attributes are defined on a per-ticket basis, that is every ticket may have one or more attributes.

It can set an attribute value, retrieve an attribute, or delete it. The attributes are stored in the CIB status section which is managed by the pacemaker cib process. boothd(8) provides transport for attributes to other sites.

crm_ticket(8) is invoked at the target site to manage the attributes.

SHORT EXAMPLES

# geostore set -t ticket-A -s other bigdb-repl-status UPTODATE
# geostore get -t ticket-A -s other bigdb-repl-status
# geostore delete -t ticket-A -s 44.0.0.61 bigdb-repl-status
# geostore list -t ticket-A -s other

OPTIONS

-t

Ticket scope of the attribute (required, if more than one ticket is configured).

-s

Site address or name where the attribute is to be stored/retrieved.

The special value 'other' can be used to specify the other
site. Obviously, in that case, the booth configuration must
have exactly two sites defined.

-c configfile

Configuration to use.

Can be a full path to a configuration file, or a short name; in the latter case, the directory /etc/booth and suffix .conf are added. Per default booth is used, which results in the path /etc/booth/booth.conf.

-h, --help

Give a short usage output.

COMMANDS

set

Sets the attribute to the value.

get

Get the attribute value and print it to stdout. If the attribute doesn’t exist, appropriate error message is printed to stderr.

delete

Delete the attribute. If the attribute doesn’t exist, appropriate error message is printed to stderr.

list

List all attributes and their values stored at the site.

EXIT STATUS

0

Success.

1

Request failed or bad usage.

RESOURCES

GitHub: <https://github.com/ClusterLabs/booth>

COPYING

Copyright © 2015 Dejan Muhamedagic <dmuhamedagic@suse.com>

Free use of this software is granted under the terms of the GNU General Public License (GPL) as of version 2 (see COPYING file) or later.

SEE ALSO

boothd(8), crm_attribute(8)

2022-07-30