docs/doc/source/storage/kubernetes/configure-the-internal-ceph-storage-backend.rst
egoncalv 6279629b87 Add support for configuring storage services on the cluster network.
Worked on a downstream bug.

Patch 1: Fixed typo.

Patch 2: Worked on Mary's comments.

Signed-off-by: egoncalv <elisamaraaoki.goncalves@windriver.com>
Change-Id: I107a670f2528d318a6aaf56620841eb1e1902233
2021-06-01 14:47:06 -03:00

73 lines
2.4 KiB
ReStructuredText

.. oim1582827207220
.. _configure-the-internal-ceph-storage-backend:
===========================================
Configure the Internal Ceph Storage Backend
===========================================
This section provides steps to configure the internal Ceph storage backend.
Depending on the system type, |prod| can be configured with an internal
Ceph storage backend on controller nodes or on dedicated storage nodes.
.. rubric:: |prereq|
Unlock all controllers before you run the following commands to configure
the internal Ceph storage backend.
.. rubric:: |proc|
.. _configuring-the-internal-ceph-storage-backend-steps-xdm-tmz-vkb:
#. Run the following command:
.. code-block:: none
~(keystone_admin)$ system storage-backend-add ceph --confirmed
.. note::
The default network used to deploy Ceph services on is the management
network and this should be sufficient for most systems. The
cluster-host network should only be considered for systems that are
using a 1Gb management |NIC|.
For cluster-host network, use the following command:
.. code-block:: none
~(keystone_admin)]$ system storage-backend-add --network cluster-host ceph --confirmed
#. Wait for Ceph storage to be configured. Run the following command to
check if Ceph storage is configured:
.. code-block:: none
~(keystone_admin)$ system storage-backend-list
#. On a Standard configuration with Controller Storage, that is, where
Ceph |OSDs| are to be configured on the controller nodes, configure the
third Ceph monitor instance on a worker node, using the following
command:
.. code-block:: none
~(keystone_admin)$ system ceph-mon-add <worker_node>
.. note::
For Standard configuration with dedicated Storage, that is, where
Ceph |OSDs| are to be configured on dedicated Storage nodes, the
third Ceph monitor instance is configured by default on the first
storage node.
.. note::
CephFS support requires Metadata servers \(MDS\) to be deployed. When
CephFS is configured, an MDS is deployed automatically along with each
node that has been configured to run a Ceph Monitor.
#. Configure Ceph |OSDs|. For more information, see :ref:`Provision
Storage on a Controller or Storage Host Using Horizon
<provision-storage-on-a-controller-or-storage-host-using-horizon>`.