Scroll to navigation

SHEEPDOG(8) System Manager's Manual SHEEPDOG(8)

NAME

dog - Command line utility for the sheep daemon

SYNOPSIS

dog <command> <subcommand> [options]

DESCRIPTION

dog - Sheepdog is a distributed storage system for QEMU. It provides highly available block level storage volumes to virtual machines. Sheepdog supports advanced volume management features such as snapshot, cloning, and thin provisioning. The architecture of Sheepdog is fully symmetric; there is no central node such as a meta-data server.

The server daemon is called sheep(8). A command line utility is available via dog(8). QEMU virtual machines use the sheep daemon via a block driver available in qemu(1).

For more information, run 'dog <command> <subcommand> --help'.

COMMAND & SUBCOMMAND

Options:
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
check and repair image's consistency

Options:
-P, --prealloc preallocate all the data objects
-y, --hyper create a hyper volume
-c, --copies specify the data redundancy level
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-v, --verbose print more information than default

Description:
create an image

Options:
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-v, --verbose print more information than default

Description:
create a snapshot

Options:
-s, --snapshot specify a snapshot id or tag name
-P, --prealloc preallocate all the data objects
-c, --copies specify the data redundancy level
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-v, --verbose print more information than default

Description:
clone an image

Options:
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
delete an image

Options:
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit
-f, --force do operation forcibly
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-v, --verbose print more information than default

Description:
rollback to a snapshot

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-h, --help display this help and exit

Description:
list images

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
show images in tree view format

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
show images in Graphviz dot format

Options:
-i, --index specify the index of data objects
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
show object information in the image

Options:
-i, --index specify the index of data objects
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit
-o, --oid specify the object id of the tracking object

Description:
show the object epoch trace in the image

Options:
-d, --delete delete a key
-x, --exclusive write in an exclusive mode
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
set a VDI attribute

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
get a VDI attribute

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
resize an image

Options:
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
read data from an image

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-w, --writeback use writeback mode
-h, --help display this help and exit

Description:
write data to an image

Options:
-s, --snapshot specify a snapshot id or tag name
-F, --from create a differential backup from the snapshot
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
create an incremental backup between two snapshots

Options:
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
restore snapshot images from a backup

Available subcommands:
flush flush the cache of the vdi specified.
delete delete the cache of the vdi specified in all nodes.
info show usage of the cache
purge purge the cache of all vdi (no flush)

Options:
-s, --snapshot specify a snapshot id or tag name
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
Run 'dog vdi cache' for more information

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-h, --help display this help and exit
-l, --local issue request to local node

Description:
kill node

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-h, --help display this help and exit

Description:
list nodes

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-h, --help display this help and exit

Description:
show information about each node

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit
-P, --progress show progress of recovery in the node
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes

Description:
show recovery information of nodes

Available subcommands:
info show multi-disk information
plug plug more disk(s) into node
unplug unplug disk(s) from node

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-A, --all show md information of all the nodes
-h, --help display this help and exit

Description:
See 'dog node md' for more information

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-w, --watch watch the stat every second
-h, --help display this help and exit

Description:
show stat information about the node

Available subcommands:
level manipulate loglevel

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
show or set log level of the node

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-r, --raw raw output mode: omit headers, separate fields with
single spaces and print all sizes in decimal bytes
-h, --help display this help and exit
-s, --backend show backend store information

Description:
show cluster information

Options:
-b, --store specify backend store
-c, --copies specify the default data redundancy (number of copies)
-t, --strict do not serve write request if number of nodes is not sufficient
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
create a Sheepdog store

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
stop Sheepdog

Available subcommands:
save save snapshot to localpath
list list snapshot of localpath
load load snapshot from localpath

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
snapshot/restore the cluster

Available subcommands:
force force recover cluster immediately
enable enable automatic recovery and run once recover if necessary
disable disable automatic recovery

Options:
-a, --address specify the daemon address (default: localhost)
-f, --force do not prompt for confirmation
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
See 'dog cluster recover' for more information

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
reweight the cluster

Options:
-a, --address specify the daemon address (default: localhost)
-p, --port specify the daemon port
-h, --help display this help and exit

Description:
check and repair cluster

DEPENDENCIES

Sheepdog requires QEMU 0.13.z or later and Corosync 1.y.z or 2.y.z.

FILES

none

SEE ALSO

sheep(8), qemu(1), sheepfs(8), corosync_overview(8)

AUTHORS

This software is developed by the Sheepdog community which may be reached via mailing list at <sheepdog@lists.wpkg.org>.

2019-0104