Add a Storage Tier Using the CLI

You can add custom storage tiers for OSDs to meet specific container disk requirements.

Note

Bare Metal Ceph does not fully support custom tiers and its usage is not recommended. If the use of storage tiers is mandatory, use Rook Ceph as the storage backend.

About this task

Describes procedure to add a custom tier using Rook Ceph as storage backend. For more information about storage tiers, see Rook Ceph Tiers and Chassis.

Prerequisites

• On an All-in-One Simplex or Duplex system, controller-0 must be provisioned and unlocked before you can add a secondary tier.

• On Standard (2+2) and DX+ (2+2) systems, all nodes with OSDs or monitors must be unlocked and available before secondary tiers can be added.

Procedure

1. List the names of any other existing storage tiers.

   To create a new tier, you must assign a unique name.

   ~(keystone_admin)]$ system storage-tier-list ceph_cluster
   +---------+---------+--------+--------------------------------------+
   | uuid    | name    | status | backend_using                        |
   +---------+---------+--------+--------------------------------------+
   | acc8... | storage | in-use | 649830bf-b628-4170-b275-1f0b01cfc859 |
   +---------+---------+--------+--------------------------------------+
   

2. To create a new tier, you must assign a unique name using only lowercase letters.

   ~(keystone_admin)]$ system storage-tier-list ceph_rook_cluster
   
   +--------------+--------------------------------------+
   | Property     | Value                                |
   +--------------+--------------------------------------+
   | uuid         | 220f17e2-8564-4f4d-8665-681f73d13dfb |
   | name         | gold                                 |
   | type         | ceph                                 |
   | status       | defined                              |
   | backend_uuid | None                                 |
   | cluster_uuid | 5c48ed22-2a03-4b90-abc4-73757a594494 |
   | OSDs         | []                                   |
   | created_at   | 2018-02-19T21:36:59.302059+00:00     |
   | updated_at   | None                                 |
   +--------------+--------------------------------------+
   

3. Add a storage backend to provide access to the tier.

   ~(keystone_admin)]$ system storage-tier-add ceph_rook_cluster gold
   

   For example, to add a storage backend named gold-store using the new tier:

   ~(keystone_admin)]$ system storage-backend-add -n gold-store -t 220f17e2-8564-4f4d-8665-681f73d13dfb ceph
   System configuration has changed.
   Please follow the administrator guide to complete configuring the system.
   
   +-----------+--------------+----------+------------+-----------+----------+--------------------+
   | uuid      | name         | backend  | state      | task      | services | capabilities       |
   +-----------+--------------+----------+------------+-----------+----------+--------------------+
   | 23e396f2- | shared_servi | external | configured | None      | glance   |                    |
   |           | ces          |          |            |           |          |                    |
   |           |              |          |            |           |          |                    |
   | 558e5573- | gold-store   | ceph     | configured | None      | None     | min_replication: 1 |
   |           |              |          |            |           |          | replication:     2 |
   |           |              |          |            |           |          |                    |
   | 5ccdf53a- | ceph-store   | ceph     | configured | provision | None     | min_replication: 1 |
   |           |              |          |            |-storage   |          | replication:     2 |
   |           |              |          |            |           |          |                    |
   |           |              |          |            |           |          |                    |
   +-----------+--------------+----------+------------+-----------+----------+--------------------+
   

Postrequisites

You must assign OSDs to the tier. For more information, see StarlingX Storage Configuration and Management: Rook Ceph OSD Management.

To delete a tier that is not in use by a storage backend and does not have OSDs assigned to it, use the command:

~(keystone_admin)]$ system storage-tier-delete
usage: system storage-tier-delete <cluster name or uuid> <storage tier name or uuid>

For example:

~(keystone_admin)]$ system storage-tier-delete ceph_rook_cluster 268c967b-207e-4641-bd5a-6c05cc8706ef