From 812ff6ca9fcd3e629e49d4328905f33eee8ca3f5 Mon Sep 17 00:00:00 2001 From: Qiaowei Ren Date: Thu, 4 Jan 2018 13:43:33 +0800 Subject: initial code repo This patch creates initial code repo. For ceph, luminous stable release will be used for base code, and next changes and optimization for ceph will be added to it. For opensds, currently any changes can be upstreamed into original opensds repo (https://github.com/opensds/opensds), and so stor4nfv will directly clone opensds code to deploy stor4nfv environment. And the scripts for deployment based on ceph and opensds will be put into 'ci' directory. Change-Id: I46a32218884c75dda2936337604ff03c554648e4 Signed-off-by: Qiaowei Ren --- src/ceph/doc/ceph-volume/index.rst | 64 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 src/ceph/doc/ceph-volume/index.rst (limited to 'src/ceph/doc/ceph-volume/index.rst') diff --git a/src/ceph/doc/ceph-volume/index.rst b/src/ceph/doc/ceph-volume/index.rst new file mode 100644 index 0000000..5cf4778 --- /dev/null +++ b/src/ceph/doc/ceph-volume/index.rst @@ -0,0 +1,64 @@ +.. _ceph-volume: + +ceph-volume +=========== +Deploy OSDs with different device technologies like lvm or physical disks using +pluggable tools (:doc:`lvm/index` itself is treated like a plugin) and trying to +follow a predictable, and robust way of preparing, activating, and starting OSDs. + +:ref:`Overview ` | +:ref:`Plugin Guide ` | + + +**Command Line Subcommands** +There is currently support for ``lvm``, and plain disks (with GPT partitions) +that may have been deployed with ``ceph-disk``. + +* :ref:`ceph-volume-lvm` +* :ref:`ceph-volume-simple` + + +Migrating +--------- +Starting on Ceph version 12.2.2, ``ceph-disk`` is deprecated. Deprecation +warnings will show up that will link to this page. It is strongly suggested +that users start consuming ``ceph-volume``. + +New deployments +^^^^^^^^^^^^^^^ +For new deployments, :ref:`ceph-volume-lvm` is recommended, it can use any +logical volume as input for data OSDs, or it can setup a minimal/naive logical +volume from a device. + +Existing OSDs +^^^^^^^^^^^^^ +If the cluster has OSDs that were provisioned with ``ceph-disk``, then +``ceph-volume`` can take over the management of these with +:ref:`ceph-volume-simple`. A scan is done on the data device or OSD directory, +and ``ceph-disk`` is fully disabled. + +Encrypted OSDs +^^^^^^^^^^^^^^ +If using encryption with OSDs, there is currently no support in ``ceph-volume`` +for this scenario (although support for this is coming soon). In this case, it +is OK to continue to use ``ceph-disk`` until ``ceph-volume`` fully supports it. +This page will be updated when that happens. + +.. toctree:: + :hidden: + :maxdepth: 3 + :caption: Contents: + + intro + systemd + lvm/index + lvm/activate + lvm/prepare + lvm/scan + lvm/systemd + lvm/list + lvm/zap + simple/index + simple/activate + simple/scan + simple/systemd -- cgit 1.2.3-korg