docs/doc/source/storage/kubernetes/add-ssd-backed-journals-using-horizon.rst
Ron Stone 2b62f49a9d Fix symlinks
Changed paths to avoid '..', which breaks symlinks in newer versions of sphinx.
Consolidated installation include files under /_includes. Prefixed r5 versions with 'r5_'
Moved files that are used up/down, but at different paths under /shared/_includes
and /shared/figures
Move two include files to /_includes
Moved addtional images to /shared/figures/... Required for DS platform builds.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Ia38f4205c5803b3d1fc043e6c59617c34a4e5cbd
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
2021-09-02 13:31:45 +00:00

90 lines
2.8 KiB
ReStructuredText

.. qhr1552678653880
.. _add-ssd-backed-journals-using-horizon:
=====================================
Add SSD-Backed Journals Using Horizon
=====================================
On storage hosts with SSDs or NVMe drives, you can use SSD-backed Ceph
journals for improved I/O performance.
.. rubric:: |context|
If you prefer, you can use the |CLI|. For more information, see :ref:`Add
SSD-backed Journals Using the CLI
<add-ssd-backed-journals-using-the-cli>`.
For more information about SSD-backed journals, see :ref:`Storage on
Storage Hosts <storage-hosts-storage-on-storage-hosts>`.
.. rubric:: |prereq|
A storage host with a solid-state drive \(SSD\) or Non-Volatile Memory
Express \(NVMe\) drive is required.
To create or edit an SSD-backed journal, you must lock the host. The system
must have at least two other unlocked hosts with Ceph monitors. \(Ceph
monitors run on **controller-0**, **controller-1**, and **storage-0** only\).
.. rubric:: |proc|
#. Lock the host to prepare it for configuration changes.
On the **Hosts** tab of the Host Inventory page, open the drop-down
list for the host, and then select **Lock Host**.
The host is locked and reported as **Locked**, **Disabled**, and
**Online**.
#. Open the Host Detail page for the host.
To open the Host Detail page, click the name of the host on the
**Hosts** tab of the Host Inventory page.
#. Select the **Storage** tab to view the **Disks** and **Storage Functions** for the host.
.. image:: /shared/figures/storage/yts1496238000598.png
#. Assign the SSD to use for Ceph journals.
.. note::
This option is available only if the storage host is equipped with
at least one SSD.
#. Click **Assign Storage Function** to open the Assign Storage Function dialog box.
.. image:: /shared/figures/storage/wlx1464876289283.png
#. In the **Function** field, select Journal.
A simplified dialog is displayed.
.. image:: /shared/figures/storage/pzu1464883037926.png
#. In the **Disks** field, select the SSD device.
#. Click **Assign Storage Function**.
The journal function is assigned to the SSD.
.. image:: /shared/figures/storage/zfd1464884207881.png
#. Assign the journal function for use by one or more OSDs.
Use the **Edit** button for the OSD to open the Edit Storage Volume
dialog box, and then select the **Journal** to use with the OSD.
.. image:: /shared/figures/storage/eew1464963403075.png
#. Unlock the host to make it available for use.
On the **Hosts** tab of the Host Inventory page, open the drop-down
list for the host, and then select **Unlock Host**.
The host is rebooted, and its **Availability State** is reported as
**In-Test**. After a few minutes, it is reported as **Unlocked**,
**Enabled**, and **Available**.