VMware Integrated OpenStack Administration Guide

Modified on 13 JAN 2020 VMware Integrated OpenStack 6.0

You can find the most up-to-date technical documentation on the VMware website at:

https://docs.vmware.com/

If you have comments about this documentation, submit your feedback to

docfeedback@vmware.com

VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com

Copyright © 2015-2020 VMware, Inc. All rights reserved. Copyright and trademark information.

VMware Integrated OpenStack Administration Guide

VMware, Inc. 2

https://docs.vmware.com/ mailto:docfeedback@vmware.com http://pubs.vmware.com/copyright-trademark.html

Contents

1 VMware Integrated OpenStack Administration Guide 7

2 Deployment Configuration 8 Add Capacity to an OpenStack Deployment 8

Add Controller Nodes to Your Deployment 8

Scale OpenStack Services 9

Add Compute Clusters to Your Deployment 9

Add Storage to the Image Service 10

Add Clusters to the Block Storage Service 11

Enable HA on Your Deployment 12

Modify Management and API Access Networks 13

Update Component Credentials 13

Add Certificates to Your Deployment 14

Profile OpenStack Services 14

Create Multiple Horizon Regions 15

Create a Custom Theme for the VMware Integrated OpenStack Dashboard 16

Customize OpenStack Settings 17

Create a Tenant Virtual Data Center 18

Using the Tenant Virtual Data Center vAPIs 20

Delete an OpenStack Deployment 22

3 Neutron Network Configuration 23 Create a Provider Network 23

Create a Provider Network with NSX-T Data Center 24

Create a Provider Network with NSX Data Center for vSphere 25

Create a Provider Network with VDS Networking 27

Create an External Network 28

Create an External Network with NSX-T Data Center 28

Create an External Network with NSX Data Center for vSphere 29

Create a Tenant Network 31

Create a Layer 2 Bridge 32

Create a Layer 2 Bridge with NSX-T Data Center 32

Create a Layer 2 Bridge with NSX Data Center for vSphere 33

Create a Neutron Availability Zone with NSX-T Data Center 33

Configure VMware Integrated OpenStack with an NSX Manager Cluster 36

Use NSX-T Data Center N-VDS Enhanced Data Path Mode with OpenStack 37

Configure VLAN Transparency 38

Configure MAC Learning 38

VMware, Inc. 3

Specify Tenant Router Types for NSX Data Center for vSphere 39

Add an NSX-T Data Center Back End to an NSX Data Center for vSphere Deployment 40

Create a Provider Security Group 41

Use NSX Data Center for vSphere Security Policies in OpenStack 43

Create a Load Balancer 44

Create a DNS Zone 47

4 Authentication and Identity 49 Create an OpenStack Project 49

Create a Cloud User 50

Create a User Group 51

Manage Keystone Domains 52

Configure LDAP Authentication 52

Configure VMware Identity Manager Federation 55

Configure Keystone to Keystone Federation 58

Configure Generic SAML 2.0 Federation 60

5 OpenStack Instances 65 Manage OpenStack Flavors 66

Launch an Instance 66

Import Virtual Machines into VMware Integrated OpenStack with NSX Data Center for vSphere 67

Import Virtual Machines into VMware Integrated OpenStack with NSX-T Data Center 71

Migrate an Instance 73

Enable Live Resize 74

Configure Multiple Virtual Interface Drivers 75

Enable Huge Page Support 76

Use Affinity to Control OpenStack Instance Placement 77

Use DRS to Control OpenStack Instance Placement 78

Define VM and Host Groups for Placing OpenStack Instances 78

Create a DRS Rule for OpenStack Instance Placement 79

Apply VM Group Settings to Image Metadata 80

Configure QoS Resource Allocation for Instances 81

Configure Virtual CPU Pinning 83

Configure Passthrough for Networking Devices 84

Configure Passthrough for Non-Networking Devices 86

Configure Passthrough for an NVIDIA GRID vGPU 88

Supported Flavor Extra Specs 89

6 Cinder Volumes and Volume Types 93 Create a Volume 93

Create a Multi-Attach-Capable Volume 95

VMware Integrated OpenStack Administration Guide

VMware, Inc. 4

Transfer a Volume 96

Create a Volume Type 97

Manage a Volume 98

Migrating Volumes Between Datastores 99

Migrate All Volumes from a Datastore 99

Migrate Unattached Cinder Volumes 99

Migrate Attached Cinder Volumes 101

Supported Volume Type Extra Specs 102

7 Glance Images 103 Import an Image 103

Import a Virtual Machine Template as an Image 104

Migrate an Image 105

Configure an Image for Windows Guest Customization 106

Supported Image Metadata 107

8 Heat Orchestration and Stacks 110 Generate a Heat Template 110

Launch a Stack 111

Configurable Heat Parameters 112

9 Swift Object Storage 114 Create the Swift Cluster 114

Add Nodes to Your Swift Cluster 115

Store Objects in Swift 116

10 Backup and Recovery 118 Back Up Your Deployment 118

Create a Scheduled Backup Task 119

Configure the Backup Service for Cinder 121

Restore Your Deployment from a Backup 122

11 Troubleshooting VMware Integrated OpenStack 128 Create a Support Bundle 128

VMware Integrated OpenStack Virtual Appliance Fails to Deploy 129

Synchronize OpenStack Instance State 129

Project Instance Table Is Slow to Display 129

User Deletion Intermittently Fails 130

Cinder Backup Fails Under High Concurrency 131

12 VMware Integrated OpenStack Command Reference 134

VMware Integrated OpenStack Administration Guide

VMware, Inc. 5

Comparison of Command-Line Operations 135

VMware Integrated OpenStack Toolbox 137

viocli add Command 138

viocli create Command 140

viocli delete Command 142

viocli generate Command 144

viocli get Command 145

viocli import Command 145

viocli migrate Command 146

viocli prepare Command 147

viocli reset Command 147

viocli restore Command 148

viocli start Command 148

viocli stop Command 149

viocli update Command 149

viocli version Command 151

VMware Integrated OpenStack Administration Guide

VMware, Inc. 6

VMware Integrated OpenStack Administration Guide 1 The VMware Integrated OpenStack Administration Guide shows you how to perform administrative tasks in VMware Integrated OpenStack, including how to create and manage projects, users, accounts, flavors, images, and networks.

Intended Audience This guide is for cloud administrators who want to create and manage resources with an OpenStack deployment that is fully integrated with VMware vSphere®. To do so successfully, you should be familiar with the OpenStack components and functions.

Terminology For definitions of terms as they are used in this document, see the VMware Glossary at https:// www.vmware.com/topics/glossary and the OpenStack Glossary at https://docs.openstack.org/doc-contrib- guide/common/glossary.html.

VMware, Inc. 7

https://www.vmware.com/topics/glossary https://www.vmware.com/topics/glossary https://docs.openstack.org/doc-contrib-guide/common/glossary.html https://docs.openstack.org/doc-contrib-guide/common/glossary.html

Deployment Configuration 2 You can modify the configuration of your VMware Integrated OpenStack deployment to add capacity, enable profiling, update credentials, and change or customize various settings.

This chapter includes the following topics:

n Add Capacity to an OpenStack Deployment

n Enable HA on Your Deployment

n Modify Management and API Access Networks

n Update Component Credentials

n Add Certificates to Your Deployment

n Profile OpenStack Services

n Create Multiple Horizon Regions

n Create a Custom Theme for the VMware Integrated OpenStack Dashboard

n Customize OpenStack Settings

n Create a Tenant Virtual Data Center

n Using the Tenant Virtual Data Center vAPIs

n Delete an OpenStack Deployment

Add Capacity to an OpenStack Deployment You can scale out the nodes, services, clusters, and datastores in your VMware Integrated OpenStack deployment to adapt to higher load.

Add Controller Nodes to Your Deployment You can scale out your deployment by adding more controller nodes.

Note The number of controller nodes in a deployment cannot be reduced. Ensure that you have sufficient resources before initiating a scale-out operation. Do not delete controller nodes through vSphere.

VMware, Inc. 8

Procedure

1 Log in to the Integrated OpenStack Manager web interface as the admin user.

2 In OpenStack Deployment, click the name of your deployment and open the Nodes tab.

3 Click Scale Out Controller Node.

4 Enter the desired number of controller nodes and click OK.

The new controller nodes are created. Once the nodes are displayed in the table and their status has changed to Ready, they can be used as part of your deployment.

Scale OpenStack Services You can dynamically scale OpenStack services in or out to adapt to changing system load.

Note VMware Integrated OpenStack does not support scaling the following services in or