docs/doc/source/storage/kubernetes/add-ssd-backed-journals-using-horizon.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8)
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +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**.