Release Notes

Red Hat CloudForms 4.7

Summary of new features, corrections, and known bugs for Red Hat CloudForms Management Engine 5.10

Red Hat CloudForms Documentation Team

Abstract

A summary of enhancements, known bugs, and support information for Red Hat CloudForms 4.7.
If you have a suggestion for improving this guide or have found an error, please submit a Bugzilla report at http://bugzilla.redhat.com against Red Hat CloudForms Management Engine for the Documentation component. Please provide specific details, such as the section number, guide name, and CloudForms version so we can easily locate the content.

1. Introduction

Red Hat CloudForms Management Engine (CFME) delivers the insight, control, and automation enterprises need to address the challenges of managing virtual environments, which are far more complex than physical ones. This technology enables enterprises with existing virtual infrastructures to improve visibility and control, and those just starting virtualization deployments to build and operate a well-managed virtual infrastructure.

Red Hat CloudForms 4.7 is comprised of a single component, the CloudForms Management Engine. It has the following feature sets:

  • Insight: Discovery, Monitoring, Utilization, Performance, Reporting, Analytics, Chargeback, and Trending.
  • Control: Security, Compliance, Alerting, Policy-Based Resource and Configuration Management.
  • Automate: IT Process, Task and Event, Provisioning, Workload Management and Orchestration.
  • Integrate: Systems Management, Tools and Processes, Event Consoles, CMDB, RBA, and Web Services.

1.1. Getting Support

If you experience difficulty with a procedure described in this documentation, visit the Red Hat Customer Portal at http://access.redhat.com. Through the customer portal, you can:

  • Search or browse through a knowledgebase of technical support articles about Red Hat products
  • Submit a support case to Red Hat Global Support Services (GSS)
  • Access other product documentation

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.

1.2. Red Hat CloudForms Life Cycle

For an overview of the life cycle phases for Red Hat CloudForms and the status of support for this product, see Red Hat Cloudforms Life Cycle.

2. Migration Considerations

2.1. Migrating to a New Appliance

If you are migrating from an existing appliance to a new one, the target appliance must be able to accommodate the new 12 Gb resource profile used by Red Hat CloudForms 4.7, even if the source appliance only uses 8 Gb.

2.2. Migrating on the same appliance

If you are migrating from a previous version of Red Hat CloudForms to Red Hat CloudForms 4.7 using the same appliance, the resource profile will remain the same. Before installing or starting any providers, however, you must assess your memory needs and adjust the resource profile accordingly to avoid performance issues.

3. Technology Preview

The following enhancements are available with this release of Red Hat CloudForms as technology preview only.

Note

For more information on the support scope for features marked as technology previews, see Technology Preview Features Support Scope

Integration with Redfish Physical Infrastructure Provider

Red Hat CloudForms supports the following Redfish physical infrastructure provider functionality:

  • Inventory
  • LED Identification Operations
  • Power Operations
  • Events
Integration with OpenShift Prometheus, Alert Management
  • Red Hat CloudForms can receive alerts from Prometheus in OpenShift Container Platform
  • Alerts generated by Prometheus are visible in the Red Hat CloudForms user interface
  • Ability to assign alerts to a user and add notes
Integration with ServiceNow CMDB
You can integrate Red Hat CloudForms into ServiceNow to enable authentication with an existing ServiceNow database and add/amend items in the ServiceNow database during state machine processing, such as the virtual machine provisioning state machine.
Red Hat Insights Plug-In
You can access Red Hat Insights directly from the Red Hat CloudForms appliance web user interface. Red Hat Insights is an automated service that provides information that helps you to rapidly identify key issues in your Red Hat CloudForms deployment.

4. Enhancements

The following enhancements are available with Red Hat CloudForms 4.7 (CFME 5.10).

4.1. Maintenance

This release of Red Hat CloudForms contains the following new features and enhancements to the general functionality of Red Hat CloudForms:

  • It is now possible to create a database dump from the appliance_console menu.
  • It is now possible to specify AWS S3 as a backup destination for the Red Hat CloudForms database.
  • It is now possible to export custom buttons by running the following command:

    # rake evm:export:custom_buttons -- --directory <directory_name>
  • It is now possible to use the groupMembership attribute for LDAP searches.
  • It is now possible to collect logs for the Automate model and service dialogs.
  • It is now possible to create a chargeback report in a global region for the same tenant across all sub-regions.
  • It is now possible to initiate SmartState Analysis container image scans via the REST API.
  • It is now possible to receive more detailed information about infrastructure providers via the REST API.
  • It is now possible to delete datastores via the REST API.
  • It is now possible to tag cloud network, subnets, flavors, availability zones, routers and security groups via the REST API.
  • It is now possible to delete groups when the user in that group belong to another group.
  • A new report is now available for the number of hypervisor cores.
  • Common settings for appliances in the same zone are now inherited from the region.

4.2. Providers

Amazon EC2

This release of Red Hat CloudForms contains the following new features and enhancements for Amazon EC2 providers:

  • It is now possible to add and remove volumes to and from instances.
  • It is now possible to specify a custom endpoint for Amazon EC2 providers.
Ansible

This release of Red Hat CloudForms contains the following new features and enhancements for Ansible providers:

  • Integration with external Ansible Tower workflows.
  • RBAC controls are now available for playbooks, repositories, and credentials.
Microsoft Azure

This release of Red Hat CloudForms contains the following new features and enhancements for Microsoft Azure providers:

  • It is now possible to perform targeted refresh of Microsoft Azure providers.
Red Hat Virtualization

This release of Red Hat CloudForms contains the following new features and enhancements for Red Hat Virtualization providers:

  • It is now possible to unregister a virtual machine.
  • It is now possible to use Sysprep to customize virtual machines provisioned through Red Hat Virtualization.
Nuage Networks Provider

This release of Red Hat CloudForms supports the following Nuage Networks provider functionality:

  • Monitor events and alarms from Nuage VSP environment
  • Leverage events and alarms for automation reporting
  • Visibility in Nuahe VSP tenants, overlay networks, security groups and ports
  • Relationships between Nuage entities
Lenovo Physical Infrastructure Provider

This release of Red Hat CloudForms supports the following Lenovo XClarity Administrator provider functionality:

  • Manage physical-infrastructure providers
  • Manage physical servers
  • Manage physical chassis
  • Manage physical racks, storage systems, switches
  • Events
  • Relationships between physical servers and virtual hosts

4.3. Administrative User Interface

This release of Red Hat CloudForms contains the following new features and enhancements for the administrative user interface:

  • Additional currencies have been added as options for chargeback reports.
  • It is now possible to export and import SmartState Analysis profiles.
  • It is now possible to rename virtual machines from the administrative user interface.
  • It is now possible to edit the settings of other appliances from the administrative user interface.
  • It is now possible to receive a notification when a worker exceeds or is close to exceeding its memory threshold.

4.4. Security

This release of Red Hat CloudForms contains the following new features and enhancements for alerts and notifications:

  • An event is now raised in CloudForms when a user logs in using external authentication for the first time.
  • An event is now raised in CloudForms on a failed login attempt.

5. Deprecated Functionality in Next Major Version

The following will be deprecated with the next release of Red Hat CloudForms (CFME 5.11).

No longer supported as a Host:

  • Amazon EC2
  • Microsoft Azure
  • Google Compute Engine
  • Red Hat OpenShift Platform

No longer supported for Management:

  • Google Compute Engine

No longer supported for Cloud Intelligence:

  • RSS Feed
  • Timelines

No longer supported for Optimization:

  • Bottleneck
  • Planning

Additional deprecations:

  • All Public Providers Load Balancer Inventory

6. Changing the User Interface Locale

Red Hat CloudForms allows you to change the locale of the user interface to one of several preset locales.

This procedure outlines how to change the user interface locale.

  1. Navigate to SettingsMy Settings from the navigation bar.
  2. Select the user interface locale from the Locale list in the Display Settings area.
  3. Click Save.

6.1. User Interface Locales

This table outlines the user interface locales provided in this release of Red Hat CloudForms.

Table 1. User Interface Locales

LocaleLanguage

English

English

Español

Spanish

Français

French

日本語

Japanese

简体中文

Simplified Chinese

7. Changes in the Core Set of Ruby Gems

Users of Red Hat CloudForms can construct custom automation methods in Ruby to extend the product. Red Hat CloudForms ships with a core set of Ruby gems used by the CloudForms Management Engine (CFME) Rails Application. The Ruby gems in this set are subject to change, and have changed since the previous release. If you are calling gems using Automate that are no longer in the CloudForms Management Engine Appliance, you can install them by using the gem install command.

While gems can be imported into automation methods using require, it is recommended that the authors of the automation methods clearly document the use of gems either in the core set or a custom set. It is the responsibility of the author of such custom automation to own the life cycle of any gem being referenced in those methods.

You can find a list of all gems included in the appliance in /var/www/miq/vmdb/log/gem_list.txt

To get lists of all gems for different CloudForms Management Engine releases, see the following resource:

7.1. Red Hat CloudForms 4.7.0

This section outlines the changes to the core set of Ruby gems included in this release.

7.1.1. New Ruby Gems in Red Hat CloudForms 4.7.0

The following Ruby gems have been added:

Table 2. New Ruby Gems in Red Hat CloudForms 4.7.0

Ruby GemVersion in Red Hat CloudForms 4.7.0

digest-crc

0.4.1

dry-inflector

0.1.2

fog-kubevirt

0.1.8

graphql

1.8.11

graphql-batch

0.3.10

graphql-preload

1.0.4

inventory_refresh

0.1.2

json-schema

2.8.1

manageiq-graphql

0.1.0

manageiq-providers-kubevirt

0.0.1

manageiq-providers-redfish

0.1.0

manageiq-v2v

0.0.1

promise.rb

0.7.4

redfish_client

0.4.1

ruby-kafka

0.7.4

server_sent_events

0.1.2

7.1.2. Updated Ruby Gems in Red Hat CloudForms 4.7.0

The following Ruby gems have been updated:

Table 3. Updated Ruby Gems in Red Hat CloudForms 4.7.0

Ruby GemVersion in Red Hat CloudForms 4.7.0

actioncable

5.0.7.1

actionmailer

5.0.7.1

actionpack

5.0.7.1

actionview

5.0.7.1

activejob

5.0.7.1

activemodel

5.0.7.1

activerecord

5.0.7.1

activerecord-id_regions

0.2.2

activerecord-session_store

1.1.1

activesupport

5.0.7.1

acts_as_tree

2.8.0

ansible_tower_client

0.19.0

autoprefixer-rails

9.4.3

aws-sigv4

1.0.3

concurrent-ruby

1.1.4

crass

1.0.4

default_value_for

3.0.5

domain_name

0.5.20180417

dry-core

0.4.7

dry-equalizer

0.2.1

dry-types

0.13.3

dry-validation

0.12.2

excon

0.62.0

faker

1.8.7

ffi-vix_disk_lib

1.0.4

fog-google

1.8.1

fog-json

1.2.0

fog-openstack

0.1.29

fog-vcloud-director

0.3.0

font-fabulous

1.0.3

gettext

3.2.9

gettext_i18n_rails_js

1.3.0

google-api-client

0.23.9

http

3.3.0

http-form_data

2.1.1

httpi

2.4.4

i18n

0.9.5

image-inspector-client

2.0.0

jbuilder

2.8.0

jmespath

1.4.0

jquery-rails

4.3.3

kubeclient

4.1.2

linux_admin

1.2.2

loofah

2.2.3

mail

2.7.1

manageiq-api

4.0.0

manageiq-api-client

0.3.2

manageiq-appliance_console

3.3.0

manageiq-messaging

0.1.2

manageiq-postgres_ha_admin

3.0.0

method_source

0.9.2

mini_mime

1.0.1

monetize

1.9.0

money

6.13.1

money-rails

1.13.0

nakayoshi_fork

0.0.4

openscap

0.4.8

patternfly-sass

3.54.8

prometheus-api-client

0.6.1

public_suffix

3.0.3

rack

2.0.6

rails

5.0.7.1

rails-html-sanitizer

1.0.4

rails-i18n

5.1.2

railties

5.0.7.1

rake

12.3.2

recursive-open-struct

1.1.0

retriable

3.1.2

ripper_ruby_parser

1.2.0

ruby-dbus

0.15.0

sexp_processor

4.10.1

signet

0.11.0

simple-rss

1.3.3

stomp

1.4.7

sys-uname

1.0.4

temple

0.8.0

thor

0.20.3

tilt

2.0.9

trollop

2.1.3

tzinfo

1.2.5

useragent

0.16.10

uuid

2.3.9

vmware_web_service

0.3.1

websocket

1.2.8

winrm

2.3.0

winrm-fs

1.3.1

xclarity_client

0.6.5

7.1.3. Removed Ruby Gems in Red Hat CloudForms 4.7.0

The following Ruby gems have been removed:

Table 4. Removed Ruby Gems in Red Hat CloudForms 4.7.0

Ruby Gem

inflecto

lodash-rails

manageiq-providers-hawkular

minitar

miq_v2v_ui

8. Technical Notes

This chapter contains the summary text for bug fixes and enhancements in Red Hat CloudForms errata advisories. The information and procedures in this chapter are relevant to Red Hat CloudForms administrators.

8.1. Red Hat CloudForms 4.7.0

8.1.1. RHSA-2019-0212: Red Hat CloudForms 4.7 Bug Fix and Enhancement Update

The bugs contained in this section are addressed by advisory RHSA-2019:0212. Further information about this advisory is available at https://access.redhat.com/errata/RHSA-2019:0212.html.

8.1.1.1. Appliance

BZ#1535177

Alert emails now include the text displayed in a notification.
8.1.1.2. Appliance

BZ#1636547

This release of Red Hat CloudForms will introduce an alternate Apache module, mod_auth_gssapi, to support Single Sign On (SSO) via external authentication.

The current module, mod_auth_kerb, will continue to be supported for the foreseeable future but at some point will likely be deprecated from Cloudforms.

As mod_auth_gssapi is the direction forward for Apache kerberos SSO support, it is recommended, but not required to migrate from using mod_auth_kerb to mod_auth_gssapi.
8.1.1.3. Performance

BZ#1571223

This release of Red Hat CloudForms implements a UI optimization which improves performance when using Chrome as the browser accessing an appliance.
8.1.1.4. Providers

BZ#1565791

This release of Red Hat CloudForms adds support for sysprep customization templates during virtual machine provisioning.
8.1.1.5. Provisioning

BZ#1553833

This release of Red Hat CloudForms adds dynamic sysprep provisioning parameters for Red Hat virtualization provides. A new Sysprep Specification form has been added under the Customization tab when provisioning virtual machines. This new form allows users to provide sysprep parameters that are passed to the provisioned VM.

Customized templates, located at the bottom of the Customize tab, are required to use this new form.
8.1.1.6. Replication

BZ#1391095

In highly available CloudForms environments, data synchronization to the global region ceases to function after a remote region failover event. This occurs because of an issue with both primary to standby database (HA) replication configured along with region-to-region (remote/global) replication. To work around this, remove and re-create the subscription in the global region web user interface to point to the new primary database server in the remote region. After applying the workaround, replication to the global region will be restored.
8.1.1.7. UI Ops

BZ#1451300

A known issue exists presently where different CloudForms tenants can create catalogs with the same name, and consequently, CloudForms displays multiple catalogs with the same name in the Catalog dropdown menu. This can result in difficulty differentiating catalog items when an administrative user creates a service catalog item, as the user interface does not display the name of the tenant that owns the catalog. This will be fixed in a later release.

BZ#1559957

This release of Red Hat CloudForms corrects an issue whereby VMRC console credentials can be removed from a VMware provider without affecting the ability to save the update to the provider.

8.1.2. RHBA-2019-0111: CloudForms 4.7 images for OpenShift bug fix

The bugs contained in this section are addressed by advisory RHBA-2019:0213. Information about this advisory is available at https://access.redhat.com/errata/RHBA-2019:0213.html.

8.1.3. RHBA-2019-0214: CloudForms 4.7 Amazon EC2 SmartState Client Bug Fix Update

The bugs contained in this section are addressed by advisory RHBA-2019:0214. Further information about this advisory is available at https://access.redhat.com/errata/RHBA-2019:0214.html.