Red Hat OpenStack Platform 16.0 Instances and Images Guide Managing Instances and Images Last Updated: 2020-10-23 Red Hat OpenStack Platform 16.0 Instances and Images Guide Managing Instances and Images OpenStack Team [email protected] Legal Notice Copyright © 2020 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 The Instances and Images guide provides procedures for the management of instances, images of a Red Hat OpenStack Platform environment. Table of Contents Table of Contents .P .R . E. .F . A. .C . E. 6. .C . H. .A . P. .T .E . R. 1.. .I .M . A. .G . .E . S. .E . R. .V . I.C . E. 7. 1.1. UNDERSTANDING THE IMAGE SERVICE 7 1.1.1. Image Signing and Verification 7 1.1.2. Image conversion 8 1.1.3. Image Introspection 8 1.1.4. Interoperable Image Import 9 1.1.5. Improving scalability with Image service caching 9 1.1.6. Image pre-caching 10 1.1.6.1. Configuring the default interval for periodic image pre-caching 10 1.1.6.2. Using a periodic job to pre-cache an image 10 1.2. MANAGE IMAGES 13 1.2.1. Creating an Image 13 1.2.1.1. Use a KVM Guest Image With Red Hat OpenStack Platform 13 1.2.1.2. Create Custom Red Hat Enterprise Linux or Windows Images 14 1.2.1.2.1. Create a Red Hat Enterprise Linux 7 Image 15 1.2.1.2.2. Create a Red Hat Enterprise Linux 6 Image 20 1.2.1.2.3. Create a Windows Image 25 1.2.1.3. Use libosinfo 26 1.2.2. Upload an Image 26 1.2.3. Update an Image 27 1.2.4. Import an Image 28 1.2.4.1. Import from a Remote URI 28 1.2.4.2. Import from a Local Volume 28 1.2.5. Delete an Image 29 1.2.6. Hide or Unhide an Image 29 1.2.7. Show Hidden Images 30 1.2.8. Enabling image conversion 30 1.2.9. Converting an image to RAW format 30 1.2.9.1. Configuring Image Service to accept RAW and ISO only 30 1.2.10. Storing an image in RAW format 31 .C . H. .A . P. .T .E . R. 2. C. .O . .N . F. .I G. .U . .R .I .N . G. T. .H . E. C. .O . M. P. .U . T. .E . .( N. O. .V . A. .) . S. E. .R . V. .I C. .E . .3 . 2. 2.1. CONFIGURING MEMORY FOR OVERALLOCATION 33 2.2. CALCULATING RESERVED HOST MEMORY ON COMPUTE NODES 33 2.3. CALCULATING SWAP SIZE 34 .C . H. .A . P. .T .E . R. 3. C. O. .N . F. .I G. U. .R . E. .O . .P . E. N. S. T. .A . C. .K . .C . O. .M . .P . U. .T . E. S. T. .O . .R .A . G. E. .3 . 5. 3.1. ARCHITECTURE OVERVIEW 35 3.2. CONFIGURATION 36 .C . H. .A . P. .T .E . R. 4. .V . I.R . T. U. .A . .L . M. A. .C . H. .I N. E. .I N. S. T. .A . N. .C . E. .S . .3 . 9. 4.1. MANAGE INSTANCES 39 4.1.1. Add Components 39 4.1.2. Launch an Instance 39 4.1.2.1. Launch Instance Options 40 4.1.3. Update an Instance (Actions menu) 41 4.1.4. Resize an Instance 43 4.1.5. Connect to an Instance 43 4.1.5.1. Access an Instance Console using the Dashboard 44 4.1.5.2. Directly Connect to a VNC Console 44 1 Red Hat OpenStack Platform 16.0 Instances and Images Guide 4.1.6. View Instance Usage 45 4.1.7. Delete an Instance 45 4.1.8. Manage Multiple Instances at Once 45 4.2. MANAGE INSTANCE SECURITY 46 4.2.1. Manage Key Pairs 46 4.2.1.1. Create a Key Pair 46 4.2.1.2. Import a Key Pair 46 4.2.1.3. Delete a Key Pair 46 4.2.2. Create a Security Group 47 4.2.3. Create, Assign, and Release Floating IP Addresses 47 4.2.3.1. Allocate a Floating IP to the Project 47 4.2.3.2. Assign a Floating IP 47 4.2.3.3. Release a Floating IP 48 4.2.4. Log in to an Instance 48 4.2.5. Inject an admin Password Into an Instance 49 4.3. MANAGE FLAVORS 50 4.3.1. Update Configuration Permissions 51 4.3.2. Create a Flavor 51 4.3.3. Update General Attributes 52 4.3.4. Update Flavor Metadata 52 4.3.4.1. View Metadata 52 4.3.4.2. Add Metadata 52 4.4. MANAGE HOST AGGREGATES 57 4.4.1. Enable Host Aggregate Scheduling 58 4.4.2. View Availability Zones or Host Aggregates 58 4.4.3. Add a Host Aggregate 58 4.4.4. Update a Host Aggregate 59 4.4.5. Delete a Host Aggregate 59 4.5. SCHEDULE HOSTS 60 4.5.1. Configure Scheduling Filters 61 4.5.2. Configure Scheduling Weights 64 4.5.2.1. Configure Weight Options for Hosts 64 4.5.3. Configure Placement Service Traits 65 4.5.3.1. libvirt virtualization driver capabilities as placement service traits 66 4.5.3.2. Using placement service traits to specify resource provider requirements 66 4.5.4. Configuring a guaranteed minimum bandwidth QoS 67 4.5.4.1. Removing a guaranteed minimum bandwidth QoS from an instance 69 4.5.5. Reserve NUMA Nodes with PCI Devices 69 4.5.6. Configure Emulator Threads to run on Dedicated Physical CPU 70 4.6. MANAGE INSTANCE SNAPSHOTS 70 4.6.1. Create an Instance Snapshot 71 4.6.2. Manage a Snapshot 72 4.6.3. Rebuild an Instance to a State in a Snapshot 72 4.6.4. Consistent Snapshots 72 4.7. USE RESCUE MODE FOR INSTANCES 73 4.7.1. Preparing an Image for a Rescue Mode Instance 73 4.7.1.1. Rescue Image if Using ext4 Filesystem 73 4.7.2. Adding the Rescue Image to the OpenStack Image Service 74 4.7.3. Launching an Instance in Rescue Mode 74 4.7.4. Unrescuing an Instance 75 4.8. SET A CONFIGURATION DRIVE FOR INSTANCES 75 4.8.1. Configuration Drive Options 75 4.8.2. Use a Configuration Drive 75 2 Table of Contents .C . H. .A . P. .T .E . R. 5. M. I.G . .R . A. .T .I .N . G. V. .I R. .T . U. .A . L. M. .A . C. .H . .I N. .E . .I N. .S . T. .A . N. .C . E. .S . B. .E . T. .W . .E .E . N. C. .O . .M . .P . U. .T .E . .N . O. D. .E . S. .7 . 6. 5.1. MIGRATION TYPES 76 5.2. MIGRATION CONSTRAINTS 78 5.3. PREPARING TO MIGRATE 79 5.4. COLD MIGRATING AN INSTANCE 80 5.5. LIVE MIGRATING AN INSTANCE 81 5.6. CHECKING MIGRATION STATUS 82 5.7. EVACUATING AN INSTANCE 83 5.7.1. Evacuating one instance 83 5.7.2. Evacuating all instances on a host 84 5.7.3. Configuring shared storage 85 5.8. TROUBLESHOOTING MIGRATION 86 5.8.1. Errors during migration 86 5.8.2. Never-ending live migration 87 5.8.3. Instance performance degrades after migration 88 .C . H. .A . P. .T .E . R. 6. .S .C . A. .L . I.N . G. .D . E. .P . L. O. Y. .M . E. .N . T. .S . .W . .I T. .H . .C . O. .M . .P . U. .T . E. C. .E .L . L. .S . .8 .9 . 6.1. CELL COMPONENTS 89 6.2. CELL DEPLOYMENTS ARCHITECTURE 90 6.3. CONSIDERATIONS FOR MULTI-CELL DEPLOYMENTS 91 6.4. DEPLOYING A MULTI-CELL OVERCLOUD 93 6.5. CREATING AND PROVISIONING A CELL 98 6.6.