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

91 lines
2.2 KiB
ReStructuredText

=================
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
.. include:: footer.rst