Red Hat Openstack Platform 8 Quickstart Guide For Cloudforms With Red Hat Openstack Platform
Red Hat Openstack Platform 8 Quickstart Guide For Cloudforms With Red Hat Openstack Platform
Red Hat Openstack Platform 8 Quickstart Guide For Cloudforms With Red Hat Openstack Platform
8
QuickStart Guide for CloudForms
with Red Hat OpenStack Platform
OpenStack Team
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red
Hat OpenStack Platform
OpenStack Team
[email protected]
Legal Notice
Copyright © 2017 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, 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.
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 Software Collections 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.
Abstract
Getting started with CloudForms on Red Hat OpenStack Platform
Table of Contents
Table of Contents
.CHAPTER
. . . . . . . . .1.. .INTRODUCTION
. . . . . . . . . . . . . . TO
. . . RED
. . . . HAT
. . . . .CLOUDFORMS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3. . . . . . . . . .
1.1. ARCHITECTURE 3
1.2. REQUIREMENTS 4
1.3. GETTING HELP AND GIVING FEEDBACK 4
1.4. DOCUMENTATION FEEDBACK 5
.CHAPTER
. . . . . . . . .2.. .INSTALLING
. . . . . . . . . . . CLOUDFORMS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6. . . . . . . . . .
2.1. OBTAINING THE CLOUDFORMS MANAGEMENT ENGINE APPLIANCE 6
2.2. UPLOADING THE APPLIANCE TO OPENSTACK 6
2.3. ADDING A RULE TO A SECURITY GROUP 7
2.4. CREATING A CUSTOM FLAVOR FOR CLOUDFORMS MANAGEMENT ENGINE 8
2.5. LAUNCHING THE CLOUDFORMS MANAGEMENT ENGINE APPLIANCE 9
2.6. ADDING A FLOATING IP ADDRESS 10
2.7. CONFIGURING A DATABASE FOR CLOUDFORMS MANAGEMENT ENGINE 11
2.8. CONFIGURING AN INTERNAL DATABASE 11
2.9. CONFIGURING AN EXTERNAL DATABASE 12
. . . . . . . . . .3.. .ADDING
CHAPTER . . . . . . . AN
. . . OPENSTACK
. . . . . . . . . . . . CLOUD
. . . . . . . PROVIDER
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
...........
. . . . . . . . . .4.. .ADDING
CHAPTER . . . . . . . AN
. . . OPENSTACK
. . . . . . . . . . . . INFRASTRUCTURE
. . . . . . . . . . . . . . . . . PROVIDER
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
...........
4.1. CONFIGURING RED HAT CLOUDFORMS TO RECEIVE EVENTS 18
4.2. CONFIGURING THE TELEMETRY SERVICE TO STORE EVENTS 18
. . . . . . . . . .5.. .CLOUDFORMS
CHAPTER . . . . . . . . . . . . . LIFECYCLE
. . . . . . . . . . .MANAGEMENT
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
...........
5.1. PROVISIONING 20
5.2. PROVISIONING AN OPENSTACK INSTANCE FROM AN IMAGE 20
5.3. CONTROLLING THE POWER STATE OF AN INSTANCE 22
5.4. VIEWING CAPACITY AND UTILIZATION CHARTS FOR AN INSTANCE 22
. . . . . . . . . .6.. .FURTHER
CHAPTER . . . . . . . . .READING
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
...........
1
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
2
CHAPTER 1. INTRODUCTION TO RED HAT CLOUDFORMS
Red Hat CloudForms 4.0 is comprised of a single component, the CloudForms Management Engine.
It has the following feature sets:
Automate: IT Process, Task and Event, Provisioning, and Workload Management and
Orchestration.
1.1. ARCHITECTURE
The diagram below describes the capabilities of CloudForms Management Engine. Its features are
designed to work together to provide robust management and maintenance of your virtual
infrastructure.
The CloudForms Management Engine Server (Server) resides on the Appliance. It is the
software layer that communicates between the SmartProxy and the Virtual Management
Database. It includes support for HTTPS communications.
The Virtual Management Database (VMDB) resides either on the Appliance or another computer
3
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
accessible to the Appliance. It is the definitive source of intelligence collected about your Virtual
Infrastructure. It also holds status information regarding Appliance tasks.
The CloudForms Management Engine Console (Console) is the Web interface used to view and
control the Server and Appliance. It is consumed through Web 2.0 mash-ups and web services
(WS Management) interfaces.
The SmartProxy can reside on the Appliance or on an ESX Server. If not embedded in the
Server, the SmartProxy can be deployed from the Appliance. A SmartProxy agent must be
configured in each storage location, and must be visible to the Appliance. The SmartProxy acts
on behalf of the Appliance communicating with it over HTTPS on standard port 443.
1.2. REQUIREMENTS
To use CloudForms Management Engine, the following requirements must be met:
Mozilla Firefox for versions supported under Mozilla’s Extended Support Release (ESR)
Adobe Flash Player 9, or above. At the time of publication, you can access it at
http://www.adobe.com/products/flashplayer/
The CloudForms Management Engine Appliance must already be installed and activated in your
enterprise environment.
The SmartProxy must have visibility to the virtual machines and cloud instances that you want to
control.
The resources that you want to control must have a SmartProxy associated with them.
Important
Due to browser limitations, Red Hat supports logging in to only one tab for each multi-
tabbed browser. Console settings are saved for the active tab only. For the same reason,
CloudForms Management Engine does not guarantee that the browser’s Back button will
produce the desired results. Red Hat recommends using the breadcrumbs provided in the
Console.
Search or browse through a knowledgebase of technical support articles about Red Hat
products.
4
CHAPTER 1. INTRODUCTION TO RED HAT CLOUDFORMS
Red Hat also hosts a large number of electronic mailing lists for discussion of Red Hat software and
technology. You can find a list of publicly available mailing lists at
https://www.redhat.com/mailman/listinfo. Click on the name of any mailing list to subscribe to that list
or to access the list archives.
If you find a typographical error in this manual, or if you have thought of a way to make this manual
better, please submit a report to GSS through the customer portal.
When submitting a report, be sure to mention the manual’s identifier: QuickStart Guide for
CloudForms with OpenStack
If you have a suggestion for improving the documentation, try to be as specific as possible when
describing it.
If you have found an error, please include the section number and some of the surrounding text
so that we can easily find it.
5
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
CloudForms Management Engine can be installed and configured in a few quick steps. After
downloading the CloudForms Management Engine appliance from the Red Hat Customer Portal, the
installation process takes you through the steps of uploading it to a supported virtualization
environment or cloud provider.
Note
After installing the CloudForms Management Engine appliance, you must configure the
database for Red Hat CloudForms. See Section 2.7, “Configuring a Database for
CloudForms Management Engine”.
1. Go to access.redhat.com and log in to the Red Hat Customer Portal using your customer
account details.
4. Click Red Hat CloudForms to access the product download page. The latest version of
each download displays by default.
5. From the list of installers and images under Product Software, select CFME OpenStack
Virtual Appliance and click Download Now.
Log in to your OpenStack dashboard to upload the CloudForms Management Engine appliance.
5. From Image Source list, select Image Location. Note that currently only images available
from an HTTP URL are supported.
6. In Image Location, enter the external (HTTP) URL you will load the image from, for
example, http://example.com/image.iso.
7. From the Format list, select the image format. For example, ISO - Optical Disk
Image.
6
CHAPTER 2. INSTALLING CLOUDFORMS
8. Specify the Architecture. For example, i386 for a 32-bit architecture, or x86-64 for a 64-
bit architecture.
9. Leave the Minimum Disk (GB) and Minimum RAM (MB) fields empty.
10. Check the Public box to make the appliance available to all users.
11. Check the Protected box to protect the image from being accidentally deleted.
The appliance’s image is placed in a queue to be uploaded. It may take some time before the status
of the image changes from Queued to Active.
Note
In the default configuration, the default security group accepts all connections from the
default source; all instances within the default group can talk to each other on any port.
1. From the OpenStack dashboard, navigate to Project > Compute > Access & Security.
2. Navigate to Security Groups > Manage Rules on the row for the default security
group.
7
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
g. Click Add.
A flavor is a resource allocation profile that specifies, for example, how many virtual CPUs and how
much RAM can be allocated to an instance. For example, you can run CloudForms Management
Engine on a Red Hat OpenStack m1.large flavor, which specifies a virtual machine with 4 cores,
8GB RAM, and 80GB disk space. Creating a flavor to run CloudForms Management Engine is
optional.
The following procedure demonstrates how to create a flavor with the minimum requirements (4
vCPUs, 6GB RAM, 40GB disk space) for CloudForms Management Engine. For more information
about flavors, see the Red Hat Enterprise Linux OpenStack Platform Administration User Guide.
8
CHAPTER 2. INSTALLING CLOUDFORMS
4. Configure the settings to define a flavor that meets CloudForms Management Engine
system requirements.
VCPUs: 4
1. From the OpenStack dashboard, navigate to Project > Compute > Instances.
4. Select the custom flavor for your instance. The flavor selection determines the computing
resources available to your instance. The resources used by the flavor are displayed in the
Flavor Details pane.
Boot from image - displays a new field for Image Name. Select the image from the
drop-down list.
Boot from snapshot - displays a new field for Instance Snapshot. Select the snapshot
from the drop-down list.
Boot from volume - displays a new field for Volume. Select the volume from the drop-
down list.
Boot from image (creates a new volume) - boot from an image and create a volume
by choosing Device Size and Device Name for your volume. Some volumes can be
persistent. To ensure the volume is deleted when the instance is deleted, select Delete
on Terminate.
9
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
Boot from volume snapshot (creates a new volume) - boot from volume snapshot
and create a new volume by choosing Volume Snapshot from the drop-down list and
adding a Device Name for your volume. Some volumes can be persistent. To ensure
the volume is deleted when the instance is deleted, select Delete on Terminate.
7. Click Networking and select a network for the instance by clicking the + (plus) button for
the network from Available Networks.
8. Click Launch.
When you create an instance, Red Hat OpenStack Platform automatically assigns a fixed IP address
in the network to which the instance belongs. This IP address is permanently associated with the
instance until the instance is terminated.
In addition to the fixed address, you can also assign a floating IP address to an instance. Unlike
fixed IP addresses, you can modify floating IP addresses associations at any time, regardless of the
state of the instances involved.
1. At the command-line on your Red Hat OpenStack Platform controller, create a pool of
floating IP addresses using the nova-manage floating create command. Replace
IP_BLOCK with the desired block of IP addresses (expressed in CIDR notation).
3. Click Floating IPs > Allocate IP To Project. The Allocate Floating IP window
is displayed.
4. Click Allocate IP to allocate a floating IP from the pool. The allocated IP address appears in
the Floating IPs table.
10
CHAPTER 2. INSTALLING CLOUDFORMS
5. Select the newly allocated IP address from the Floating IPs table. Click Associate to
assign the IP address to a specific instance.
Note
Before using CloudForms Management Engine, you will need to configure the database options for
it. CloudForms Management Engine provides two options for database configuration:
Note
See CPU Sizing Assistant for a Dedicated VMDB Host in the Deployment Planning Guide
for guidelines on CPU requirements.
11
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
Important
Before installing an internal database, add a disk to the infrastructure hosting your
appliance. See the documentation specific to your infrastructure for instructions on how to
add a disk. As a storage disk usually cannot be added while a virtual machine is running,
Red Hat recommends adding the disk before starting the appliance. Red Hat CloudForms
only supports installing of an internal VMDB on blank disks. The installation will fail if the
disks are not blank.
1. Start the appliance and open a terminal from your virtualization or cloud provider.
2. After starting the appliance, log in with a user name of root and the default password of
smartvm. This displays the Bash prompt for the root user.
If this is not the first CFME appliance, choose 2) Fetch key from remote machine to
fetch the key from the first CFME appliance. All CFME appliances in a multi-region
deployment must use the same key.
1) /dev/vdb: 20480
Choose disk:
Important
Creating a new region destroys any existing data on the chosen database.
12
CHAPTER 2. INSTALLING CLOUDFORMS
session timeouts, and format the PostgreSQL server log for improved system support. Due to these
requirements, Red Hat recommends that external CloudForms Management Engine databases use
a postgresql.conf file based on the standard file used by the CloudForms Management Engine
appliance.
Ensure you configure the settings in the postgresql.conf to suit your system. For example,
customize the shared_buffers setting according to the amount of real storage available in the
external system hosting the PostgreSQL instance. In addition, depending on the aggregate number
of appliances expected to connect to the PostgreSQL instance, it may be necessary to alter the
max_connections setting.
Because the postgresql.conf file controls the operation of all databases managed by a single
instance of PostgreSQL, do not mix CloudForms Management Engine databases with other types of
databases in a single PostgreSQL instance.
13
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
5. Enter the Host Name (or IPv4 or IPv6 address) of the provider.
Important
The Host Name must use a unique fully qualified domain name.
6. Enter the API Port of your Keystone service. The default port is 5000.
Important
If the Keystone service is configured to use SSL, you must enter the SSL port for
Keystone.
7. Select the appropriate API Version from the list. The default is Keystone v2.
8. Select the appropriate Zone for the provider. By default, the zone is set to default.
9. In the Credentials area, under Default, provide the login credentials required for the
Keystone user:
Important
To enable discovery of OpenStack cloud providers, ensure that the iptables for
the OpenStack host providing Keystone services allows port 5000 access to all
hosts on the same network.
14
CHAPTER 3. ADDING AN OPENSTACK CLOUD PROVIDER
10. You can use AMPQ if ceilometer is not configured for Events. If AMQP credentials were
changed during the OpenStack provider install, use the AMQP tab of the Credentials area
to provide the login credentials required for the Advanced Message Queuing Protocol
messaging service on your OpenStack Nova component:
Note
parameter_defaults:
CeilometerStoreEvents: true
Then, add this environment file to the overcloud deploy command, for
example:
Note
In order to collect inventory and metrics from an OpenStack environment, the CloudForms
Management Engine Appliance requires that the adminURL endpoint for the OpenStack
environment should be on a non-private network. Hence, the OpenStack adminURL
endpoint should be assigned an IP address other than 192.168.x.x. Additionally, make
sure that all the Keystone endpoints must be accessbile, otherwise refresh will fail.
15
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
Note
For Red Hat CloudForms to be able to receive events from a Red Hat OpenStack provider,
the OpenStack configuration file must be modified. Specifically, the notification_driver
field must be defined.
For Nova and Heat, in order to start getting notifications, manually change the
configuration files as below and restart services.
/etc/heat/heat.conf
notification_driver=glance.openstack.common.notifier.rpc_notifie
r
notification_topics=notifications
/etc/nova/nova.conf
notification_driver=messaging
notification_topics=notifications
16
CHAPTER 4. ADDING AN OPENSTACK INFRASTRUCTURE PROVIDER
After you have deployed your CloudForms Management Engine appliance, you can begin managing
your OpenStack environment by adding it as an OpenStack Infrastructure provider. Supply the
details of the admin account to get access to the resources in the admin tenant:
3. Enter the Name of the provider to add. The Name is how the device is labeled in the
console.
Important
The Host Name must use a unique fully-qualified domain name (FQDN).
6. Select the API Version of the keystone service from the list. The default is Keystone v2.
Important
If the keystone service is configured to use SSL, you must enter the keystone
SSL port.
7. Select the appropriate Zone for the provider. By default, the zone is set to default.
8. In the Credentials area, under Default, provide the login credentials required for the
OpenStack Infrastructure administrative user:
Click Validate to confirm that the CloudForms Management Engine can connect to the
OpenStack Infrastructure instance using the user name and password.
9. Under AMQP, provide the login credentials required for the Advanced Message Queuing
Protocol messaging service:
17
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
10. Under RSA key pair, provide the user name and private key required to connect via SSH to
all hosts in the provider:
Enter the private key from the machine on which OpenStack was deployed in the
Private Key field.
Note
CloudForms Management Engine requires that the adminURL endpoint for all OpenStack
services be on a non-private network. As a result, you should assign the adminURL
endpoint an IP address of something other than 192.168.x.x. The adminURL endpoint
must be accessible to the CFME Appliance that is responsible for collecting inventory and
gathering metrics from the OpenStack environment. In addition, make sure that all the
keystone endpoints are accessible, otherwise the refresh process will fail.
notification_driver=glance.openstack.common.notifier.rpc_notifier
notification_topics=notifications
notification_driver=messaging
notification_topics=notifications
18
CHAPTER 4. ADDING AN OPENSTACK INFRASTRUCTURE PROVIDER
2. Create an environment file called ceilometer.yaml, and add the following contents:
parameter_defaults:
CeilometerStoreEvents: true
19
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
This chapter discusses lifecycle activities that are part of the CloudForms Management Engine
Automate component; these activies can include the provisioning and retirement of instances.
CloudForms Management Engine Automate enables real-time, bidirectional process integration and
adaptive automation for management events and administrative or operational activities.
Resource Management - including datastore cleanup, snapshot aging and enforcement, and
virtual machine/instance aging and retirement.
Important
Provisioning requires that the Automation Engine server role be enabled. Check your
server role settings in Configure > Configuration > Server > Server
Control.
5.1. PROVISIONING
When a virtual machine or cloud instance is provisioned, it goes through multiple phases:
Phase 1 - the request must be made, and includes ownership information, tags, virtual hardware
requirements, the operating system, and any customization of the request.
Phase 2 - the request must go through an approval phase, either automatic or manual.
Phase 3 - the request is executed. This part of provisioning consists of pre-processing and post-
processing. Pre-processing acquires IP addresses for the user, creates CMDB instances, and
creates the virtual machine or instance based on information in the request. Post-processing
activates the CMDB instance and emails the user. The steps for provisioning may be modified at
any time using CloudForms Management Engine.
20
CHAPTER 5. CLOUDFORMS LIFECYCLE MANAGEMENT
3. Select an OpenStack image from the list presented. These images must be available on
your OpenStack provider.
4. Click Continue.
5. On the Request tab, enter information about this provisioning request. In Request
Information, type in at least a first and last name and an email address. This email is used
to send the requester status emails during the provisioning process for items such as auto-
approval, quota, provision complete, retirement, request pending approval, and request
denied. The other information is optional. If the CloudForms Management Engine Server is
configured to use LDAP, you can use the Look Up button to populate the other fields based
on the email address.
Note
Parameters with a * next to the label are required to submit the provisioning
request.
6. Click the Purpose tab to select the appropriate tags for the provisioned instance.
a. To change the image to use as a basis for the instance, select it from the list of
images.
8. Click the Environment tab to select the instance’s Tenant, Availabilty Zones, Cloud
Network, Security Groups, and Public IP Address. If no specific Tenant is required, select
the Choose Automatically checkbox.
9. Click the Properties tab to set provider options such as flavors and security settings.
a. Under Credentials, enter a Root Password for the root user access to the
instance.
b. Enter IP Address Information for the instance. Leave as DHCP for automatic IP
assignment from the provider.
d. Use Customize Template to configure additional instance settings. You can select
from the Cloud-Init scripts stored on your appliance.
21
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
11. Click the Schedule tab to set the provisioning and retirement date and time.
b. In Lifespan, select whether to power on the instances after they are created, and
whether to set a retirement date. If you select a retirement period, you will be
prompted for when to receive a retirement warning.
The provisioning request is sent for approval. For the provisioning to begin, a user with the admin,
approver, or super admin account role must approve the request. The admin and super admin roles
can also edit, delete, and deny the requests. You will be able to see all provisioning requests where
you are either the requester or the approver.
After submission, the appliance assigns each provision request a Request ID. If an error occurs
during the approval or provisioning process, use this ID to locate the request in the appliance logs.
The Request ID consists of the region associated with the request followed by the request number.
As regions define a range of one trillion database IDs, this number can be several digits long.
Request ID Format
This procedure allows you to control the power states of an instance using the CloudForms
Management Engine console.
3. Click Power Operations, then click the button for the desired power operation:
4. Click OK.
22
CHAPTER 5. CLOUDFORMS LIFECYCLE MANAGEMENT
This procedure allows you to review the capacity and utilization data for instances that are part of a
cluster.
Note
To use this feature, you must have a server assigned to the Capacity & Utilization
Collector server role. In additon, this server will require network visibility of the cloud
provider. For more information, see the CloudForms General Configuration guide.
5. Select to view hourly, most recent hour, or daily data points for the dates to view data.
Note
Daily charts only include full days of data; this means that CloudForms Management
Engine requires a complete 24 data point range for that day.
23
Red Hat OpenStack Platform 8 QuickStart Guide for CloudForms with Red Hat OpenStack Platform
Note
Red Hat OpenStack Platform is the only OpenStack cloud provider supported by Red Hat
CloudForms.
24