diskimage-builder/diskimage_builder/elements/redhat-common
Carlos Goncalves 3ff7365ee8 Install rng-tools in Red Hat family distro images
Make sure rngd, a hardware RNG entropy gatherer daemon, is installed on
all DIB-built Red Hat family distro images. rngd comes installed by
default in a typical base installation as it's proven to help speed
things up.

Nova attaches the virtio-rng-pci device to VMs. virtio-rng-pci is a
device that provides feed random data. However, it is of little to no
use if the virtual machine is not configured to make use of given
device. That is where rngd can help by facilitating entropy to the pool
from virtio-rng-pci.

$ openstack image set --property hw_rng_model=virtio [...]
$ openstack flavor set --property hw_rng:allowed=True [...]

DIB-built minimal images do not come with rngd installed. This patch
makes sure the daemon is installed. Its systemd service comes already
enabled.

Change-Id: I34a989dbfc57d4c98113ac25c81dfb500945ff0a
2019-12-12 20:26:06 +00:00
..
bin Add version-less RHEL element for RHEL7 and RHEL8 2019-05-29 11:28:53 +03:00
environment.d Introduce manual setting of DIB_INIT_SYSTEM 2019-11-21 12:38:15 +11:00
finalise.d Fix latest-limit command line 2017-07-18 13:17:10 +10:00
element-deps Clear /etc/machine-id to avoid duplicate machine-ids 2017-08-06 13:56:58 -04:00
package-installs.yaml Install rng-tools in Red Hat family distro images 2019-12-12 20:26:06 +00:00
pkg-map Update redhat-common pkg-map for centos 8 2019-10-03 00:22:18 +00:00
README.rst Move elements & lib relative to diskimage_builder package 2016-11-01 17:27:41 -07:00

=============
redhat-common
=============
Image installation steps common to RHEL, CentOS, and Fedora.

Requirements:

If used to build an image form a cloud image compress with xz
(the default in centos), this element uses "unxz" to decompress
the image. Depending on your distro you may need to install either
the xz or xz-utils package.

Environment Variables
---------------------

DIB_LOCAL_IMAGE
  :Required: No
  :Default: None
  :Description: Use the local path of a qcow2 cloud image. This is useful in
   that you can use a customized or previously built cloud image from
   diskimage-builder as input. The cloud image does not have to have been built
   by diskimage-builder. It should be a full disk image, not just a filesystem
   image.
  :Example: ``DIB_LOCAL_IMAGE=rhel-guest-image-7.1-20150224.0.x86_64.qcow2``

DIB_DISABLE_KERNEL_CLEANUP
  :Required: No
  :Default: 0
  :Description: Specify if kernel needs to be cleaned up or not. When set to
   true, the bits that cleanup old kernels will not be executed.
  :Example: DIB_DISABLE_KERNEL_CLEANUP=1