ggatec(8) [freebsd man page]
GGATEC(8) BSD System Manager's Manual GGATEC(8) NAME
ggatec -- GEOM Gate network client and control utility SYNOPSIS
ggatec create [-n] [-v] [-o ro | wo | rw] [-p port] [-q queue_size] [-R rcvbuf] [-S sndbuf] [-s sectorsize] [-t timeout] [-u unit] host path ggatec rescue [-n] [-v] [-o ro | wo | rw] [-p port] [-R rcvbuf] [-S sndbuf] -u unit host path ggatec destroy [-f] -u unit ggatec list [-v] [-u unit] DESCRIPTION
The ggatec utility is a network client for GEOM Gate class. It is responsible for creation of ggate devices and forwarding I/O requests between geom_gate.ko kernel module and ggated(8) network daemon. Available commands: create Connect to given ggated(8) daemon and create a ggate provider related to the given remote file or device. rescue If ggatec process died/has been killed, you can save situation with this command, which creates new connection to the ggated(8) dae- mon and will handle pending and future requests. destroy Destroy the given ggate provider. list List ggate providers. Available options: -f Forcibly destroy ggate provider (cancels all pending requests). -n Do not use TCP_NODELAY option on TCP sockets. -o ro | wo | rw Specify permission to use when opening the file or device: read-only (ro), write-only (wo), or read-write (rw). Default is rw. -p port Port to connect to on the remote host. Default is 3080. -q queue_size Number of pending I/O requests that can be queued before they will start to be canceled. Default is 1024. -R rcvbuf Size of receive buffer to use. Default is 131072 (128kB). -S sndbuf Size of send buffer to use. Default is 131072 (128kB). -s sectorsize Sector size for ggate provider. If not specified, it is taken from device, or set to 512 bytes for files. -t timeout Number of seconds to wait before an I/O request will be canceled. 0 means no timeout. Default is 0. -u unit Unit number to use. -v Do not fork, run in foreground and print debug informations on standard output. host Remote host to connect to. path Path to a regular file or device. EXIT STATUS
Exit status is 0 on success, or 1 if the command fails. To get details about the failure, ggatec should be called with the -v option. EXAMPLES
Make use of CD-ROM device from remote host. server# cat /etc/gg.exports client RO /dev/acd0 server# ggated client# ggatec create -o ro server /dev/acd0 ggate0 client# mount_cd9660 /dev/ggate0 /cdrom SEE ALSO
geom(4), ggated(8), ggatel(8), mount_cd9660(8) AUTHORS
The ggatec utility as well as this manual page was written by Pawel Jakub Dawidek <pjd@FreeBSD.org>. BSD
April 26, 2004 BSD
Check Out this Related Man Page
HASTCTL(8) BSD System Manager's Manual HASTCTL(8) NAME
hastctl -- Highly Available Storage control utility SYNOPSIS
hastctl create [-d] [-c config] [-e extentsize] [-k keepdirty] [-m mediasize] name ... hastctl role [-d] [-c config] <init | primary | secondary> all | name ... hastctl list [-d] [-c config] [all | name ...] hastctl status [-d] [-c config] [all | name ...] hastctl dump [-d] [-c config] [all | name ...] DESCRIPTION
The hastctl utility is used to control the behaviour of the hastd(8) daemon. This utility should be used by HA software like heartbeat or ucarp to setup HAST resources role when changing from primary mode to secondary or vice versa. Be aware that if a file system like UFS exists on HAST provider and primary node dies, file system has to be checked for inconsistencies with the fsck(8) utility after switching secondary node to primary role. The first argument to hastctl indicates an action to be performed: create Initialize local provider configured for the given resource. Additional options include: -e extentsize Size of an extent. Extent is a block which is used for synchronization. hastd(8) maintains a map of dirty extents and extent is the smallest region that can be marked as dirty. If any part of an extent is modified, entire extent will be synchronized when nodes connect. If extent size is too small, there will be too much disk activity related to dirty map updates, which will degrade performance of the given resource. If extent size is too large, synchroniza- tion, even in case of short outage, can take a long time increasing the risk of losing up-to-date node before synchro- nization process is completed. The default extent size is 2MB. -k keepdirty Maximum number of dirty extents to keep dirty all the time. Most recently used extents are kept dirty to reduce num- ber of metadata updates. The default number of most recently used extents which will be kept dirty is 64. -m mediasize Size of the smaller provider used as backend storage on both nodes. This option can be omitted if node providers have the same size on both sides. If size is suffixed with a k, M, G or T, it is taken as a kilobyte, megabyte, gigabyte or terabyte measurement respectively. role Change role of the given resource. The role can be one of: init Resource is turned off. primary Local hastd(8) daemon will act as primary node for the given resource. System on which resource role is set to primary can use /dev/hast/<name> GEOM provider. secondary Local hastd(8) daemon will act as secondary node for the given resource - it will wait for connection from the primary node and will handle I/O requests received from it. GEOM provider /dev/hast/<name> will not be created on secondary node. list Present verbose status of the configured resources. status Present terse (and more easy machine-parseable) status of the configured resources. dump Dump metadata stored on local component for the configured resources. In addition, every subcommand can be followed by the following options: -c config Specify alternative location of the configuration file. The default location is /etc/hast.conf. -d Print debugging information. This option can be specified multiple times to raise the verbosity level. FILES
/etc/hast.conf Configuration file for hastctl and hastd(8). /var/run/hastctl Control socket used by hastctl to communicate with the hastd(8) daemon. EXIT STATUS
Exit status is 0 on success, or one of the values described in sysexits(3) on failure. EXAMPLES
Initialize HAST provider, create file system on it and mount it. nodeB# hastctl create shared nodeB# hastd nodeB# hastctl role secondary shared nodeA# hastctl create shared nodeA# hastd nodeA# hastctl role primary shared nodeA# newfs -U /dev/hast/shared nodeA# mount -o noatime /dev/hast/shared /shared nodeA# application_start Switch roles for the shared HAST resource. nodeA# application_stop nodeA# umount -f /shared nodeA# hastctl role secondary shared nodeB# hastctl role primary shared nodeB# fsck -t ufs /dev/hast/shared nodeB# mount -o noatime /dev/hast/shared /shared nodeB# application_start SEE ALSO
sysexits(3), geom(4), hast.conf(5), fsck(8), ggatec(8), ggatel(8), hastd(8), mount(8), newfs(8) AUTHORS
The hastctl was developed by Pawel Jakub Dawidek <pjd@FreeBSD.org> under sponsorship of the FreeBSD Foundation. BSD
March 14, 2013 BSD