ekko/doc/source/glossary.rst

75 lines
1.6 KiB
ReStructuredText

.. _Glossary:
############
Glossary
############
.. _B:
****
B
****
.. _Backup:
**Backup**
A single backup containing refence to all objects needed to reassemble a disk
image. A backup would reference all `Segment`_ and a `Manifest`_. A backup
is part of a `Backupset`_.
.. _Backupset:
**Backupset**
A backupset is a uuid used to provide a unique identifier to a collection of
backups allowing for thier location in storage to be non-conflicting with
other backupsets. A backupset references a single disk in an instance. When a
`Restore`_ is preformed and a new `Backup`_ is started and new backupset uuid
would be generated.
.. _M:
****
M
****
.. _Manifest:
**Manifest**
A manifest is a file that tracks metadata and information about a single
`Backup`_. It has enough information to locate each `Segment`_ that is
required to bit-for-bit reassemble the block device the `Backup`_ was taken
from.
.. _R:
****
R
****
.. _Restore:
**Restore**
A restore refers to reassembling a `Backup`_ from it's backing storage into
an image that can then be booted or otherwise attached to an instance. It
reads the `Manifest`_ of the `Backup`_ that you want to restore and pulls all
of the appropriate objects and then unencrypts and uncompresses them before
reassembling the final image and uploading it to Glance.
.. _S:
****
S
****
.. _Segment:
**Segment**
A segment is a section of the block device. It is typially 4MiB in size. A
`Manifest`_ contains a list of segments that, when combined, would produce a
bit-for-bit copy of the original block device the `Backup`_ was taken from.