summaryrefslogtreecommitdiffstats
path: root/docs/gluster-block.8
diff options
context:
space:
mode:
authorPrasanna Kumar Kalever <prasanna.kalever@redhat.com>2017-02-21 18:25:56 +0530
committerPrasanna Kumar Kalever <pkalever@redhat.com>2017-02-27 04:03:12 -0500
commit23c424c01bc58c477de513b297cf3b822166a069 (patch)
tree789a9083c514e100e81aab09609b05016b86c474 /docs/gluster-block.8
parent58a376a080c80698a6c243b1dfe948c60ae16ac2 (diff)
docs: add man page for gluster-block cli
Change-Id: Iff9d693ce4478582ddbbbe487b00d71f456929f8 Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
Diffstat (limited to 'docs/gluster-block.8')
-rw-r--r--docs/gluster-block.8124
1 files changed, 124 insertions, 0 deletions
diff --git a/docs/gluster-block.8 b/docs/gluster-block.8
new file mode 100644
index 0000000..f50e95c
--- /dev/null
+++ b/docs/gluster-block.8
@@ -0,0 +1,124 @@
+.TH gluster-block 8 "command line utility" " 26 Feb 2017" "Red Hat, Inc."
+.PP
+
+
+.SH NAME
+gluster-block - Gluster Block Storage Console Manager (command line utility)
+.PP
+
+
+.SH SYNOPSIS
+.B gluster-block
+<\fBcreate|list|info|delete\fR>
+<\fBvolname\fR[\fB/blockname\fR]>
+[\fB<args>\fR]
+.PP
+
+
+.SH DESCRIPTION
+The Gluster Block Storage Console Manager(\fBgluster-block\fR) is a CLI utility, which aims at making gluster backed block storage creation and maintenance as simple as possible.
+
+Note that the gluster-blockd daemon is responsible for block management, hence the daemon must be running on all servers.
+.PP
+
+
+.SH COMMANDS
+.SS
+\fBcreate\fR <VOLNAME/NEW-BLOCKNAME> [ha <COUNT>] <HOST1[,HOST2,..]> <BYTES>
+create block device.
+.TP
+[ha <COUNT>]
+multipath requirement for high availability (default: 1)
+.TP
+<HOST1,[HOST2....]>
+servers in the pool where targets will be exported.
+.TP
+<BYTES>
+size in KiB|MiB|GiB|TiB|PiB ...
+.PP
+
+.SS
+\fBlist\fR <VOLNAME>
+list available block devices.
+.PP
+
+.SS
+\fBinfo\fR <VOLNAME/BLOCKNAME>
+details about block device.
+.PP
+
+.SS
+\fBdelete\fR <VOLNAME/BLOCKNAME>
+delete block device.
+.PP
+
+.SS
+.BR help
+show this message and exit.
+.PP
+
+.SS
+.BR version
+show version info and exit.
+.PP
+
+
+.SH EXAMPLES
+.nf
+To create a block device of size 1GiB
+.B # gluster-block create blockVol/sampleBlock ${HOST} 1GiB
+
+To create a block device of size 1GiB with multi-path(replica) 3
+.B # gluster-block create blockVol/sampleBlock ha 3 ${HOST1},${HOST2},${HOST3} 1GiB
+
+You can pass more no. of nodes than ha count, this will actually help create in recovering from
+failures, incase creation of block fails on any of scheduled(always first in list) ha count nodes.
+.B # gluster-block create blockVol/sampleBlock ha 3 ${HOST1},${HOST2},${HOST3},${HOST4},${HOST5} 1GiB
+
+To list available block devices
+.B # gluster-block list blockVol
+
+To get details of a block device
+.B # gluster-block info blockVol/sampleBlock
+
+To delete a block device
+.B # gluster-block delete blockVol/sampleBlock
+.fi
+.PP
+
+.SH FILES
+/var/log/gluster-block/*
+.br
+/var/run/gluster-block.socket
+.br
+/var/run/gluster-block.lock
+.PP
+
+
+.SH REPORTING BUGS
+Report bugs via gluster-devel <gluster-devel@gluster.org
+.br
+or <https://github.com/gluster/gluster-block/issues>
+
+
+.SH AUTHOR
+Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
+
+.SH THANKS
+Vijay Bellur <vbellur@redhat.com>
+.br
+Pranith Kumar Karampuri <pkarampu@redhat.com>
+
+
+
+.SH SEE ALSO
+.nf
+\fBtargetcli\fR(8), \fBtcmu-runner\fR(8), \fBglusterfs\fR(8), \fBglusterd\fR(8), \fBgluster\fR(8)
+.fi
+.PP
+
+
+.SH COPYRIGHT
+.nf
+Copyright (c) 2016 Red Hat, Inc. <http://www.redhat.com>
+.PP