Red Hat Training

A Red Hat training course is available for Red Hat Satellite

Release Notes

Red Hat Satellite 6.4

Product notes, new features, and known bugs for Red Hat Satellite.

Red Hat Satellite Documentation Team


This document contains product notes, brief descriptions of new features, and known bugs for Red Hat Satellite.

Chapter 1. Introduction

Red Hat Satellite is a system management solution that enables you to deploy, configure, and maintain your systems across physical, virtual, and cloud environments. Satellite provides provisioning, remote management and monitoring of multiple Red Hat Enterprise Linux deployments with a single, centralized tool.

Red Hat Satellite Server synchronizes the content from Red Hat Customer Portal and other sources, and provides functionality including fine-grained life cycle management, user and group role-based access control, integrated subscription management, as well as advanced GUI, CLI, or API access.

Red Hat Satellite Capsule Server mirrors content from Red Hat Satellite Server to facilitate content federation across various geographical locations. Host systems can pull content and configuration from the Capsule Server in their location and not from the central Satellite Server. The Capsule Server also provides localized services such as Puppet Master, DHCP, DNS, or TFTP. Capsule Servers assist you in scaling Red Hat Satellite as the number of managed systems increases in your environment.

1.1. Satellite 6 Component Versions

Red Hat Satellite is a combination of a number of upstream projects. For the full details of the major projects included, and the version of those projects included in each major and minor release of Red Hat Satellite, see Satellite 6 Component Versions.

1.2. Red Hat Satellite and Proxy Server Life Cycle

For an overview of the life cycle phases for Red Hat Network Satellite and Red Hat Satellite and the status of support for these products, see Red Hat Satellite and Proxy Server Life Cycle.

1.3. Red Hat Satellite FAQ

For a list of frequently asked questions about Red Hat Satellite 6, see Red Hat Satellite 6 FAQ.

Chapter 2. Content Delivery Network Repositories

This section describes the repositories required to install Red Hat Satellite 6.4.

You can install Red Hat Satellite 6.4 through the Content Delivery Network (CDN). To do so, configure subscription-manager to use the correct repository for your operating system version and variant.

Run the following command to enable a CDN repository:

# subscription-manager repos --enable=[reponame]

Run the following command to disable a CDN repository:

# subscription-manager repos --disable=[reponame]

The following sections outline the repositories required by Red Hat Satellite 6.4. When one of these repositories is required to install a package, the steps to enable the required repositories are included in the documentation.

2.1. Red Hat Satellite

The following table lists the repositories for Red Hat Satellite Server.

Table 2.1. Red Hat Satellite

ChannelRepository Name

Red Hat Satellite 6.4 (for RHEL 7 Server) (RPMs)


Red Hat Satellite 6.4 (for RHEL 7 Server) (ISOs)


2.2. Red Hat Satellite Capsule

The following table lists the repositories for Red Hat Satellite Capsule Server.

Table 2.2. Red Hat Satellite Capsule

ChannelRepository Name

Red Hat Satellite Capsule 6.4 (for RHEL 7 Server) (RPMs)


Red Hat Satellite Capsule 6.4 (for RHEL 7 Server) (ISOs)


2.3. Red Hat Satellite Maintenance

The following table lists the repositories for Red Hat Satellite Maintenance.

Table 2.3. Red Hat Satellite Maintenance

ChannelRepository Name

Red Hat Satellite Maintenance 6 (for RHEL 7 Server) (RPMs)


2.4. Red Hat Satellite Tools

The following table lists the repositories for Red Hat Satellite Tools.

Table 2.4. Red Hat Satellite Tools

ChannelRepository Name

Red Hat Satellite Tools 6.4 (for RHEL 5 for System Z - ELS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 5 Server - AUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 5 Server - ELS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 Desktop) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 for Scientific Computing - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 for Scientific Computing) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 for IBM Power - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 for IBM Power) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 for System Z - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 for System Z) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 Server - AUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 Server - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 Server) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 6 Workstation) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 Desktop) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for ARM) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for Scientific Computing - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for Scientific Computing) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for POWER9) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for IBM Power - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for IBM Power LE - Update Services SAP Solutions) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for IBM Power LE - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for IBM Power LE) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for IBM Power) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for IBM System z - Structure A) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for System Z - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 for System Z) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 Server - Update Services SAP Solutions) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 Server - AUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 Server - EUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 Server) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 Server - TUS) (RPMs)


Red Hat Satellite Tools 6.4 (for RHEL 7 Workstation) (RPMs)


Chapter 3. Key Changes to the Documentation Set

Several notable changes were made to the Red Hat Satellite documentation set for this release. The following list outlines and explains these changes.

Architecture Guide

The Architecture Guide included in the Red Hat Satellite 6.3 documentation suite has now been renamed Planning for Red Hat Satellite 6 to more closely reflect the content it contains:

Installation Guide

The Installation Guide included in the Red Hat Satellite 6.3 documentation suite has now been broken out into the following three titles to clarify the separate workflows required:

Hammer Cheat Sheet

The Hammer Cheat Sheet included in the Red Hat Satellite 6.3 documentation suite as a KBase article has now been converted into a standard title so that it can be downloaded in PDF format:

Load Balancing Guide

The Load Balancing Guide is a new title that describes how to configure load balanced Capsule pools:

Monitoring Red Hat Satellite

The Monitoring Red Hat Satellite guide is a new title that describes how to gather metrics from Red Hat Satellite 6 for analysis:

Chapter 4. New Features and Enhancements

This chapter introduces new features in Red Hat Satellite 6.4, and links to further information.

Ansible Enhancements
  • The Satellite installer now installs Ansible Core and required Foreman modules.
  • Remote execution of Ansible jobs is now handled by the Capsule Server.
  • Ansible integration in Satellite has been improved.
  • Red Hat Insights can now be deployed to hosts using Ansible, either when hosts are provisioned or later.
Support for Ansible in Satellite
  • Satellite 6.4 supports importing Red Hat Enterprise Linux System Roles, which were introduced in Red Hat Enterprise Linux 7.4.
  • Satellite 6.4 supports Red Hat Enterprise Linux System Roles to add Ansible roles to make configuration faster and easier.
  • Satellite 6.4 does not support any other roles or playbooks unless you also have a valid Ansible Engine subscription.
  • You can import custom Ansible roles from external locations such as Ansible Galaxy. However, these additional roles and playbooks are not supported through your Satellite or Smart Management subscription.
  • Ansible playbooks that you create, from a support perspective, are considered part of a scripting framework. Red Hat Support will assist in the usage and syntax of commands. For debugging or authoring of a playbook on behalf of a customer, Red Hat Consulting services might be engaged to meet this requirement. For more information, see How does Red Hat support scripting frameworks? and the Scope of Coverage section of Red Hat Ansible Engine Life Cycle.
Auditing Enhancements

Auditing of management events has been improved to include:

  • Changes to role-based access control configuration
  • Changes to the content management life cycle
  • Changes to Satellite’s taxonomy
  • User interactions
Discovery plug-in
You can now enable a Capsule Server to be a Template Capsule for a discovery subnet. Template Capsule provides a proxy service for provisioning templates for a discovery subnet.
Composite Content View Republishing
A Composite Content View is now republished when a component Content View is republished.
Custom Configuration Enhancements
Custom configuration values recommended by Red Hat are no longer overwritten by the Satellite installer.
Load Balancing
You can now set up a load-balanced Capsule pool to provide resilience against planned and unplanned outages.
Manifest and Subscription Management Enhancements
You can now edit your imported manifest and manage the subscription allocations directly in the Satellite web UI.
Puppet 5 Support
Red Hat Satellite 6.4 now uses Puppet 5.
Provisioning on AWS GovCloud
You can use Amazon Web Services GovCloud regions in host provisioning.
RHV 4 API Support
You can now use RHV 4 API to evaluate the new engine API. This item is provided as a technology preview feature.
RSS Feed Support
With the new RSS feed, you can access the Red Hat Satellite blog from the Satellite web UI. You can also enable or disable update notifications for the RSS feed.
Support for External Databases
You can now use a remote database that runs on a separate server to Satellite Server. You can either migrate an existing internal database to a server or create a database on another server. This helps improve performance in larger deployments.
Support for Private Docker Registries
You can now synchronize images from your custom repositories that you create in private registries on Docker Hub.
Support for Performance Co-Pilot
You can now access Red Hat Enterprise Linux 7’s Performance Co-Pilot(PCP) suite of tools for acquiring, storing, and analyzing system-level performance measurements.
User Interface Enhancements
Satellite introduces vertical navigation that is optimized for large screens, as well as improvements to navigation and search functionality for easier repository retrieval.
satellite-maintain alias added
The satellite-maintain alias has been added for the foreman-maintain command.

Chapter 5. Release Information

These release notes highlight technology preview items, recommended practices, known issues, and deprecated functionality to be taken into consideration when deploying this release of Red Hat Satellite 6.

Notes for updates released during the support lifecycle of this Red Hat Satellite 6 release will appear in the advisory text associated with each update.

5.1. Release Notes

This section outlines important details about the release, including recommended practices and notable changes to Red Hat Satellite. You must take this information into account to ensure the best possible outcomes for your deployment.

Starting with Satellite 6.4, two discovery rules in the same organization cannot have the same priority number. This was causing unexpected results previously. After the upgrade, discovery rules are prioritized according to the discovery framework.
Starting from Satellite 6.4, new postcreate and postupdate hook events are added to Satellite. In previous versions of Satellite, some host and hostgroup parameters were not passed to the hook object file by the create and update hook events. If you want all the host parameters fields in the hook object file, rename hooks directories from create to postcreate and from update to postupdate. No changes are required in the hook scripts.

Puppet Enterprise is not supported on Satellite Server. If you have it installed, perform the following actions to avoid conflicts after the upgrade:

  1. Move the cache from /var/lib/puppet/foreman_cache_data to /opt/puppetlabs/puppet/cache/:

    # mkdir -p /opt/puppetlabs/puppet/cache/
    # cp -r /var/lib/puppet/foreman_cache_data /opt/puppetlabs/puppet/cache/
  2. Run the satellite-installer --upgrade script to apply changes.
Starting from Satellite 6.4, the cron job to delete old reports is reconfigured to delete reports in batches of 1000 records with a fractional delay between tasks. This reduces the likelihood of updating workers becoming blocked. After the upgrade, monitor the number of reports in the database and the output of the report expiration tasks. In case of concurrency problems, update the check-in time for both the Puppet client, which is 30 minutes by default, and RHSM, which is four hours by default. This decreases the load on Satellite Server.
Satellite 6.4 introduces tighter restrictions around resource filter limitations. In previous versions of Satellite, the search query applied incorrect permissions to resources, which allowed users to perform tasks that were not permitted. This is now fixed.

In previous versions of Satellite, Satellite was able to retrieve templates from Capsules via the TFTP feature. Users were asked to enable TFTP and Templates modules on Capsules to have templating ability.

Starting from Satellite 6.4, Satellite uses the Templates feature to retrieve templates from Capsules. During the upgrade, Satellite will automatically set the Templates feature for all Capsules that also have the TFTP feature.

After the upgrade, verify that Templates feature is enabled for all Capsules that are supposed to have it. If not, navigate to Infrastructure > Capsules and click Refresh Features for all required Capsules. Then manually associate these Capsules with required subnets.


Starting from Satellite 6.4, the paths to the foreman discovery image are changed to conform with upstream:

  • boot/fdi-image-rhel_7-vmlinuz > boot/fdi-image/vmlinuz0
  • initrd=boot/fdi-image-rhel_7-img > boot/fdi-image/initrd0.img

    It was leading to issues with PXE templates previously. Now the new global templates already contains the new paths.

Telemetry in Satellite 6.4 will be functional after the pcp package version 4.1 or above is added to Red Hat Enterprise Linux Server 7. That is expected with the Red Hat Enterprise Linux 7.6 release.
In previous versions of Satellite, provisioning a host with VLAN interfaces on top of a bond interface resulted in an incorrect bond module configuration. It is now fixed with Satellite 6.4.

5.2. Deprecated Functionality

Docker plug-in

With this release, the Foreman Docker plug-in is deprecated and will be removed as part of a future release. This affects the container functionality that you can find in the Containers section of Satellite web UI.

Hammer Docker Command

With this release, the hammer docker command is deprecated and will be removed in Satellite 6.5.

Satellite Kickstart Default

With this release, the Satellite Kickstart Default provisioning templates are deprecated. All hosts consuming the now deprecated templates will be migrated automatically. Custom templates that are based on Satellite Kickstart Default are not considered during the migration, and need to be migrated manually.

Table 5.1. Deprecated Kickstart Default Templates

TemplatesReplacement Template

Satellite Kickstart Default

Kickstart Default

Satellite Kickstart Default User Data

Kickstart Default User Data

Satellite Kickstart Default Finish

Kickstart Default Finish

Satellite Atomic Kickstart Default

Atomic Kickstart Default

Satellite idm_register




Katello Service, Backup and Restore Commands

With this release, the following commands are deprecated. Ensure that you update your scripts appropriately.

Table 5.2. Deprecated Katello Commands

OptionsReplacement Options


foreman-maintain service


foreman-maintain backup


foreman-maintain restore

Installer Options

With this release, the following installer options are deprecated and removed in Satellite 6.4:

Table 5.3. Deprecated Installer Options



Superseded by


Hardcoded value for dynflowd.


Deprecated and replaced by certificates for authentication.


Deprecated parameter for configuring a yum repository from copr for EL6.


Deprecated parameter for older environment compatibility.


Replaced by foreman options.


Renamed to --katello-candlepin-oauth-{key,secret}.


Not used.


Deprecated with introduction of Puppet 5.

5.3. Known Issues

These known issues exist in Red Hat Satellite 6 at this time.


Known Issue

The change in navigation caused the Red Hat Access menu to no longer display. This issue will be fixed in an upcoming release.

Legal Notice

Copyright © 2019 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 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.