'\" t
.\"     Title: geostore
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.12
.\"      Date: 2022-07-28
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "GEOSTORE" "8" "2022-07-28" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
geostore \- geo cluster attribute manager
.SH "SYNOPSIS"
.sp
\fBgeostore\fP \fIset\fP [\-t \fIticket\fP] [\-s \fIsite\fP] [\-c \fIconfig\fP] \fIattribute\fP \fIvalue\fP
.sp
\fBgeostore\fP \fIget\fP [\-t \fIticket\fP] [\-s \fIsite\fP] [\-c \fIconfig\fP] \fIattribute\fP
.sp
\fBgeostore\fP \fIdelete\fP [\-t \fIticket\fP] [\-s \fIsite\fP] [\-c \fIconfig\fP] \fIattribute\fP
.sp
\fBgeostore\fP \fIlist\fP [\-t \fIticket\fP] [\-s \fIsite\fP] [\-c \fIconfig\fP]
.SH "DESCRIPTION"
.sp
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.
.sp
\fIgeostore\fP 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.
.sp
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 \fIcib\fP process. \fIboothd(8)\fP provides
transport for attributes to other sites.
.sp
\fIcrm_ticket(8)\fP is invoked at the target site to manage the
attributes.
.SH "SHORT EXAMPLES"
.sp
.if n .RS 4
.nf
.fam C
# 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
.fam
.fi
.if n .RE
.SH "OPTIONS"
.sp
\fB\-t\fP
.RS 4
Ticket scope of the attribute (required, if more than one
ticket is configured).
.RE
.sp
\fB\-s\fP
.RS 4
Site address or name where the attribute is to be stored/retrieved.
.sp
.if n .RS 4
.nf
.fam C
The special value \(aqother\(aq can be used to specify the other
site. Obviously, in that case, the booth configuration must
have exactly two sites defined.
.fam
.fi
.if n .RE
.RE
.sp
\fB\-c\fP \fIconfigfile\fP
.RS 4
Configuration to use.
.sp
Can be a full path to a configuration file, or a short name; in the latter
case, the directory \fI/etc/booth\fP and suffix \fI.conf\fP are added.
Per default \fIbooth\fP is used, which results in the path
\fI/etc/booth/booth.conf\fP.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Give a short usage output.
.RE
.SH "COMMANDS"
.sp
\fB\fIset\fP\fP
.RS 4
Sets the attribute to the value.
.RE
.sp
\fB\fIget\fP\fP
.RS 4
Get the attribute value and print it to \fIstdout\fP. If the
attribute doesn\(cqt exist, appropriate error message is printed
to \fIstderr\fP.
.RE
.sp
\fB\fIdelete\fP\fP
.RS 4
Delete the attribute. If the attribute doesn\(cqt exist,
appropriate error message is printed to \fIstderr\fP.
.RE
.sp
\fB\fIlist\fP\fP
.RS 4
List all attributes and their values stored at the site.
.RE
.SH "EXIT STATUS"
.sp
\fB0\fP
.RS 4
Success.
.RE
.sp
\fB1\fP
.RS 4
Request failed or bad usage.
.RE
.SH "RESOURCES"
.sp
GitHub: \c
.URL "https://github.com/ClusterLabs/booth" "" ""
.SH "COPYING"
.sp
Copyright \(co 2015 Dejan Muhamedagic <\c
.MTO "dmuhamedagic\(atsuse.com" "" ">"
.sp
Free use of this software is granted under the terms of the GNU
General Public License (GPL) as of version 2 (see \f(CRCOPYING\fP file)
or later.
.SH "SEE ALSO"
.sp
\fIboothd(8)\fP, \fIcrm_attribute(8)\fP