geostore

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)



                                   10/30/2018                        GEOSTORE(8)