Red Hat OpenStack Platform 13 Storage Guide Understanding, using, and managing persistent storage in OpenStack Last Updated: 2021-05-18 Red Hat OpenStack Platform 13 Storage Guide Understanding, using, and managing persistent storage in OpenStack OpenStack Team [email protected] Legal Notice Copyright © 2021 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Abstract This guide details the different procedures for using and managing persistent storage in a Red Hat OpenStack Platform environment. It also includes procedures for configuring and managing the respective OpenStack service of each persistent storage type. Table of Contents Table of Contents .M . A. .K . I.N . .G . .O . P. .E . N. S. .O . U. .R . C. .E . .M . .O . R. .E . .I N. .C . L. .U . S. .I V. .E . .4 . .C . H. .A . P. .T .E . R. 1.. .I .N . T. .R .O . .D . U. .C . T. .I O. N. T. O. .P . E. .R .S . I.S . T. .E .N . .T . S. .T . O. .R . A. .G . .E . I.N . R. E. .D . .H . .A .T . .O . .P .E . N. .S . T. .A . C. .K . .P . L. A. .T . F. .O . R. .M . 5. 1.1. SCALABILITY AND BACK END 6 1.2. ACCESSIBILITY AND ADMINISTRATION 6 1.3. SECURITY 7 1.4. REDUNDANCY AND DISASTER RECOVERY 7 .C . H. .A . P. .T .E . R. 2. B. .L . O. .C . .K . S. .T . O. .R . A. .G . E. A. .N . D. .V .O . .L . U. .M . .E .S . 9. 2.1. BACK ENDS 9 2.2. BLOCK STORAGE SERVICE ADMINISTRATION 9 2.2.1. Group volume settings with volume types 9 2.2.1.1. List the Capabilities of a Host Driver 10 2.2.1.2. Create and Configure a Volume Type 11 2.2.1.3. Edit a Volume Type 11 2.2.1.4. Delete a Volume Type 11 2.2.1.5. Create and Configure Private Volume Types 12 2.2.2. Create and configure an internal tenant for the Block Storage service 12 2.2.3. Configure and enable the image-volume cache 13 2.2.4. Use Quality-of-Service specifications 14 2.2.4.1. Basic volume Quality of Service 15 2.2.4.2. Create and Configure a QOS Spec 15 2.2.4.3. Set Capacity-Derived QoS Limits 15 2.2.4.4. Associate a QOS Spec with a Volume Type 16 2.2.4.5. Disassociate a QOS Spec from a Volume Type 16 2.2.5. Configure volume encryption 17 2.2.5.1. Configure Volume Type Encryption Through the Dashboard 17 2.2.5.2. Configure Volume Type Encryption Through the CLI 18 2.2.6. Configure how volumes are allocated to multiple back ends 18 2.2.7. Configure and use consistency groups 19 2.2.7.1. Set Up Consistency Groups 19 2.2.7.2. Create and Manage Consistency Groups 20 2.2.7.3. Create and Manage Consistency Group Snapshots 21 2.2.7.4. Clone Consistency Groups 21 2.3. BASIC VOLUME USAGE AND CONFIGURATION 22 2.3.1. Create a volume 22 2.3.2. Specify Back End for Volume Creation 23 2.3.3. Edit a Volume’s Name or Description 24 2.3.4. Resize (Extend) a Volume 24 2.3.5. Delete a Volume 24 2.3.6. Attach and Detach a Volume to an Instance 25 2.3.6.1. Attach a Volume to an Instance 25 2.3.6.2. Detach a Volume From an Instance 25 2.3.7. Read-Only Volumes 25 2.3.8. Change a Volume’s Owner 25 2.3.8.1. Transfer a Volume from the Command Line 25 2.3.8.2. Transfer a Volume Using the Dashboard 26 2.3.9. Create, Use, or Delete Volume Snapshots 27 2.3.9.1. Protected and Unprotected Snapshots in a Red Hat Ceph Back End 28 2.3.10. Upload a Volume to the Image Service 28 2.3.11. Changing the Type of a Volume (Volume Re-typing) 28 1 Red Hat OpenStack Platform 13 Storage Guide 2.4. ADVANCED VOLUME CONFIGURATION 29 2.4.1. Migrate a Volume 29 2.4.1.1. Migrate between Hosts 29 2.4.1.2. Migrate between Back Ends 30 2.5. MULTIPATH CONFIGURATION 30 2.5.1. Configuring multipath on new deployments 31 2.5.2. Configuring multipath on existing deployments 33 2.5.3. Verifying multipath configuration 35 .C . H. .A . P. .T .E . R. 3. O. B. .J . E. C. .T . .S . T. .O . R. .A . G. .E . .S . E. R. .V . I.C . .E . .3 . 6. 3.1. OBJECT STORAGE RINGS 36 3.1.1. Rebalancing rings 36 3.1.2. Checking cluster health 36 3.1.3. Increasing ring partition power 38 3.1.4. Creating custom rings 38 3.2. OBJECT STORAGE SERVICE ADMINISTRATION 38 3.2.1. Setting worker processes 38 3.2.2. Configuring fast-post 38 3.2.3. Enabling at-rest encryption 39 3.2.4. Deploying a standalone Object Storage cluster 39 3.2.4.1. Creating the roles_data.yaml File 39 3.2.4.2. Deploying the New Roles 41 3.2.5. Using external SAN disks 41 3.2.5.1. SAN disk deployment configuration 42 3.3. BASIC CONTAINER MANAGEMENT 42 3.3.1. Creating a container 42 3.3.2. Creating a pseudo folder for a container 43 3.3.3. Deleting a container 43 3.3.4. Uploading an object 43 3.3.5. Copying an object 44 3.3.6. Deleting an object 44 .C . H. .A . P. .T .E . R. 4. .S .H . .A . R. E. .D . .F . I.L . E. S . Y. .S . T. .E .M . .S . .S .E . R. .V . I.C . E. .4 . 5. 4.1. BACK ENDS 45 4.2. CREATING AND MANAGING SHARE TYPES 45 4.2.1. Creating a share 46 4.2.2. Listing shares and exporting information 48 4.2.3. Ensuring network connectivity to the share 48 4.2.4. Granting share access 50 4.2.5. Revoking access to a share 51 4.2.6. Mounting a share on an instance 52 4.2.6.1. Verifying the environment 52 4.2.6.2. Mounting the share 53 4.2.7. Deleting a share 53 4.2.8. Quotas in the Shared File System service 54 4.2.9. Troubleshooting asynchronous failures 54 4.2.9.1. Scenario 54 2 Table of Contents 3 Red Hat OpenStack Platform 13 Storage Guide MAKING OPEN SOURCE MORE INCLUSIVE Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message . 4 CHAPTER 1. INTRODUCTION TO PERSISTENT STORAGE IN RED HAT OPENSTACK PLATFORM CHAPTER 1. INTRODUCTION TO PERSISTENT STORAGE IN RED HAT OPENSTACK PLATFORM Red Hat OpenStack Platform (RHOSP) provides the foundation to build a private or public Infrastructure-as-a-Service (IaaS) cloud on top of Red Hat Enterprise Linux. It is a scalable, fault- tolerant platform for the development of cloud-enabled workloads. You can manage most features of the backup service by using either the RHOSP dashboard or the command-line client methods, however you must use the command line to execute some of the more advanced procedures. NOTE For the complete suite of documentation for Red Hat OpenStack Platform, see Red Hat OpenStack Platform Documentation. This guide discusses procedures for creating and managing persistent storage. Within RHOSP, this storage is provided by three main services: Block Storage (openstack-cinder) Object Storage (openstack-swift) Shared File System Storage (openstack-manila) These services provide different types of persistent storage, each with its own set of advantages in different use cases.