glance/doc/source/man/glancereplicator.rst
Brian Rosmaita d785e837d0 Restore man pages source files
Partially reverts I6d67e7a40e16468bb7bf4ac742361fb44eec4e28 to
restore the source files for the man pages.  These are used by
some packagers (confirmed that this is the case for Ubuntu) to
generate the man pages included in their distributions.

Does not add the man pages back to the HTML index, so these will
be orphans for now.  A follow up patch will either add a man build
to tox, or add the HTML generation back so we can review generated
content.

Long term fix will be to merge the content of the --help text
in the cmd files with the content of the man pages and figure
out how to generate the man pages from the --help text.  Right
now, the --help text is better in some regards, and the man pages
are better in others.

Change-Id: I2aa85b63a196c75224630981b322fecbf36f1b7c
2017-03-03 16:34:27 -05:00

2.2 KiB

glance-replicator

Replicate images across multiple data centers

Author

glance@lists.launchpad.net

Date

2016-10-6

Copyright

OpenStack Foundation

Version

13.0.0

Manual section

1

Manual group

cloud computing

SYNOPSIS

glance-replicator <command> [options] [args]

DESCRIPTION

glance-replicator is a utility can be used to populate a new glance server using the images stored in an existing glance server. The images in the replicated glance server preserve the uuids, metadata, and image data from the original.

COMMANDS

help <command>

Output help for one of the commands below

compare

What is missing from the slave glance?

dump

Dump the contents of a glance instance to local disk.

livecopy

Load the contents of one glance instance into another.

load

Load the contents of a local directory into glance.

size

Determine the size of a glance instance if dumped to disk.

OPTIONS

-h, --help

Show this help message and exit

-c CHUNKSIZE, --chunksize=CHUNKSIZE

Amount of data to transfer per HTTP write

-d, --debug

Print debugging information

-D DONTREPLICATE, --dontreplicate=DONTREPLICATE

List of fields to not replicate

-m, --metaonly

Only replicate metadata, not images

-l LOGFILE, --logfile=LOGFILE

Path of file to log to

-s, --syslog

Log to syslog instead of a file

-t TOKEN, --token=TOKEN

Pass in your authentication token if you have one. If you use this option the same token is used for both the master and the slave.

-M MASTERTOKEN, --mastertoken=MASTERTOKEN

Pass in your authentication token if you have one. This is the token used for the master.

-S SLAVETOKEN, --slavetoken=SLAVETOKEN

Pass in your authentication token if you have one. This is the token used for the slave.

-v, --verbose

Print more verbose output