'\" t
.\"     Title: geostore
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 10/12/2016
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "GEOSTORE" "8" "10/12/2016" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
geostore \- geo cluster attribute manager
.SH "SYNOPSIS"
.sp
\fBgeostore\fR \fIset\fR [\-t \fIticket\fR] [\-s \fIsite\fR] [\-c \fIconfig\fR] \fIattribute\fR \fIvalue\fR
.sp
\fBgeostore\fR \fIget\fR [\-t \fIticket\fR] [\-s \fIsite\fR] [\-c \fIconfig\fR] \fIattribute\fR
.sp
\fBgeostore\fR \fIdelete\fR [\-t \fIticket\fR] [\-s \fIsite\fR] [\-c \fIconfig\fR] \fIattribute\fR
.sp
\fBgeostore\fR \fIlist\fR [\-t \fIticket\fR] [\-s \fIsite\fR] [\-c \fIconfig\fR]
.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\fR 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\fR process\&. \fIboothd(8)\fR provides transport for attributes to other sites\&.
.sp
\fIcrm_ticket(8)\fR is invoked at the target site to manage the attributes\&.
.SH "SHORT EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
# 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
.fi
.if n \{\
.RE
.\}
.SH "OPTIONS"
.PP
\fB\-t\fR
.RS 4
Ticket scope of the attribute (required, if more than one ticket is configured)\&.
.RE
.PP
\fB\-s\fR
.RS 4
Site address or name where the attribute is to be stored/retrieved\&.
.sp
.if n \{\
.RS 4
.\}
.nf
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\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-c\fR \fIconfigfile\fR
.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\fR
and suffix
\fI\&.conf\fR
are added\&. Per default
\fIbooth\fR
is used, which results in the path
\fI/etc/booth/booth\&.conf\fR\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Give a short usage output\&.
.RE
.SH "COMMANDS"
.PP
\fB\fIset\fR\fR
.RS 4
Sets the attribute to the value\&.
.RE
.PP
\fB\fIget\fR\fR
.RS 4
Get the attribute value and print it to
\fIstdout\fR\&. If the attribute doesn\(cqt exist, appropriate error message is printed to
\fIstderr\fR\&.
.RE
.PP
\fB\fIdelete\fR\fR
.RS 4
Delete the attribute\&. If the attribute doesn\(cqt exist, appropriate error message is printed to
\fIstderr\fR\&.
.RE
.PP
\fB\fIlist\fR\fR
.RS 4
List all attributes and their values stored at the site\&.
.RE
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Success\&.
.RE
.PP
\fB1\fR
.RS 4
Request failed or bad usage\&.
.RE
.SH "RESOURCES"
.sp
GitHub: https://github\&.com/ClusterLabs/booth
.SH "COPYING"
.sp
Copyright \(co 2015 Dejan Muhamedagic <dmuhamedagic@suse\&.com>
.sp
Free use of this software is granted under the terms of the GNU General Public License (GPL)\&.
.SH "SEE ALSO"
.sp
\fIboothd(8)\fR, \fIcrm_attribute(8)\fR