Release Notes

Red Hat Satellite 6.9

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

Red Hat Satellite Documentation Team

Abstract

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.9.

You can install Red Hat Satellite 6.9 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.9. 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, Capsule, and Maintenance

The following table lists the repositories for Satellite Server, Capsule Server, and Satellite Maintenance.

Table 2.1. Red Hat Satellite, Capsule, and Maintenance

Repository NameRepository Label

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

rhel-7-server-satellite-6.9-rpms

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

rhel-7-server-satellite-6.9-isos

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

rhel-7-server-satellite-capsule-6.9-rpms

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

rhel-7-server-satellite-maintenance-6-rpms

2.2. Red Hat Satellite Tools

The following tables list the repositories for Red Hat Satellite Tools.

Table 2.2. Red Hat Satellite Tools for Red Hat Enterprise Linux 6

Repository NameRepository Label

Red Hat Satellite Tools 6.9 (for RHEL 6 Server - ELS) (RPMs)

rhel-6-server-els-satellite-tools-6.9-rpms

Red Hat Satellite Tools 6.9 (for RHEL 6 for System Z - ELS) (RPMs)

rhel-6-for-system-z-els-satellite-tools-6.9-rpms

Table 2.3. Red Hat Satellite Tools for Red Hat Enterprise Linux 7

Repository NameRepository Label

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

rhel-7-desktop-satellite-tools-6.9-rpms

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

rhel-7-server-satellite-tools-6.9-rpms

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

rhel-7-server-eus-satellite-tools-6.9-rpms

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

rhel-7-server-e4s-satellite-tools-6.9-rpms

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

rhel-7-server-tus-satellite-tools-6.9-rpms

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

rhel-7-server-aus-satellite-tools-6.9-rpms

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

rhel-7-workstation-satellite-tools-6.9-rpms

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

rhel-7-for-system-z-satellite-tools-6.9-rpms

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

rhel-7-for-system-z-eus-satellite-tools-6.9-rpms

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

rhel-7-for-power-satellite-tools-6.9-rpms

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

rhel-7-for-power-eus-satellite-tools-6.9-rpms

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

rhel-7-for-power-le-satellite-tools-6.9-rpms

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

rhel-7-for-power-le-eus-satellite-tools-6.9-rpms

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

rhel-7-for-power-le-e4s-satellite-tools-6.9-rpms

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

rhel-7-for-hpc-node-satellite-tools-6.9-rpms

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

rhel-7-for-hpc-node-eus-satellite-tools-6.9-rpms

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

rhel-7-for-power-9-satellite-tools-6.9-rpms

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

rhel-7-for-arm-64-satellite-tools-6.9-rpms__7Server

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

rhel-7-for-system-z-a-satellite-tools-6.9-rpms__7Server

Table 2.4. Red Hat Satellite Tools for Red Hat Enterprise Linux 8

Repository NameRepository Label

Red Hat Satellite Tools 6.9 for RHEL 8 x86_64 (RPMs)

satellite-tools-6.9-for-rhel-8-x86_64-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 s390x (RPMs)

satellite-tools-6.9-for-rhel-8-s390x-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 ppc64le (RPMs)

satellite-tools-6.9-for-rhel-8-ppc64le-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 aarch64 (RPMs)

satellite-tools-6.9-for-rhel-8-aarch64-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 x86_64 - Extended Update Support (RPMs)

satellite-tools-6.9-for-rhel-8-x86_64-eus-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 IBM z Systems - Extended Update Support (RPMs)

satellite-tools-6.9-for-rhel-8-s390x-eus-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 Power, little endian - Extended Update Support (RPMs)

satellite-tools-6.9-for-rhel-8-ppc64le-eus-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 ARM 64 - Extended Update Support (RPMs)

satellite-tools-6.9-for-rhel-8-aarch64-eus-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 x86_64 - Update Services SAP Solutions (RPMs)

satellite-tools-6.9-for-rhel-8-x86_64-e4s-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 Power, little endian - Update Services SAP Solutions (RPMs)

satellite-tools-6.9-for-rhel-8-ppc64le-e4s-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 x86_64 - Advanced Mission Critical Update Support (RPMs)

satellite-tools-6.9-for-rhel-8-x86_64-aus-rpms

Red Hat Satellite Tools 6.9 for RHEL 8 x86_64 - Telecommunications Update Service (RPMs)

satellite-tools-6.9-for-rhel-8-x86_64-tus-rpms

Chapter 3. Key Changes to the Documentation Set

The following notable changes were made to the Red Hat Satellite documentation set for this release:

Configuring Satellite to Use Ansible
The documentation now includes a new guide, Configuring Satellite to Use Ansible, that improves clarity for users who want to use Red Hat Satellite with Ansible. Information about using Ansible in the Administering Red Hat Satellite and Managing Hosts guides has been removed and compiled in the Configuring Satellite to Use Ansible guide.
Conscious Language Initiative
Red Hat is committed to replacing problematic language in our code, documentation and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, please see our CTO Chris Wright’s message.

Chapter 4. Technology Preview Features

Important

Technology Preview features are not supported with Red Hat production service-level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them for production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. For more information, see Red Hat Technology Preview Features Support Scope.

The following features are available as Technology Previews in Red Hat Satellite:

Container-native Virtualization plug-in
Provisioning virtual machines with Container-native Virtualization.
Kernel execution (kexec) template
Kernel execution template for PXE-less boot methods.

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. Enhancements

This release of Red Hat Satellite 6 features the following enhancements:

Ability to deploy SSH keys to hosts during registration
Satellite can now deploy SSH keys to hosts automatically when registering hosts to Satellite using the global registration template.
Ability to register hosts to Red Hat Insights during registration
Satellite users can now install and configure hosts with Insights during registration using the global registration template.
Ability to set or edit a system purpose on multiple hosts
Satellite users can now set or edit a system purpose on multiple hosts using bulk action and remote execution.
Ability to authenticate using Red Hat SSO with Time-Based One-Time Password (TOTP)
Satellite can now authenticate using Red Hat SSO with Time-Based One-Time Password.
Template writing reference document in the Satellite web UI
Satellite now provides a template writing reference document in the Satellite web UI.
Enables inventory upload by default
Satellite now enables inventory upload by default.
Ability to discover Insights actions
Satellite users are now directed to recommended Insights actions and can see Insights hits on host pages.
Ability to enforce playbook verification
Satellite now has the ability to enforce playbook verification. If cloud.redhat.com tries to execute a forged playbook with a wrong or missing signature, the playbook execution will fail. This protection is now enabled by default.
Simple Content Access (SCA) is enabled by default for Satellite Manifests (RHSM)

New Satellite installations (or new organizations in an existing Satellite) will now have SCA as their content access mode by default.

Note
  • Satellite upgraded from the previous version (or organizations in an upgraded Satellite) will continue to have their existing content access mode.
  • You can enable or disable SCA for a manifest from the Satellite web UI.
Foreman service and Puma web server

Satellite will no longer use the Passenger web server. It now uses the Puma web server, which is a multi-process and multi-threaded app server for the Ruby application. By default, Puma has been deployed with 2 workers and each worker can max out at 16 threads. With this change, Satellite introduces a standalone service (foreman.service) and socket (foreman.socket) under which the Ruby web application runs. Apache now acts as a reverse proxy that handles SSL termination.

foreman.socket features:

  • It is a systemd socket that can hold open connections.
  • It can activate foreman.service if it is not running. For example, if foreman.service is being restarted or, say, it shuts down for some reason, you can make a request and Apache will communicate to foreman.socket. As a result, foreman.socket will hold the connection open and trigger foreman.service to come back up.

foreman.service features:

  • The primary service, if it needs to ever be restarted (or status checked), is foreman. You can restart the service by running the command:

    # systemctl restart foreman
  • The Ruby web application can be restarted without shutting down Apache (for example, Pulp).
  • Apache can be restarted faster, and without restarting the web application.
  • The foreman service runs via unix socket and Apache talks over the unix socket.

See https://puma.io for more information about the web server.

5.2. Known Issues

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

Hammer task resume command

The hammer task resume command is not resuming all paused tasks and produces the following error: "Please provide at least one of the search or task_ids parameters in the request.”

BZ#1895324

Repository enable fails on http-proxy configured Satellite setup

Enabling a repository on a Satellite installation with http-proxy configured fails with a 404 error.

BZ#1907864

Content hosts cannot be deleted or unregistered

Content hosts registered prior to upgrade to the current version cannot be deleted or unregistered. It produces the following error. “ERROR: update or delete on table "hosts" violates foreign key constraint”

BZ#1917506

hammer scap-content bulk-upload command does not work as expected

The hammer scap-content bulk-upload command to upload default SCAP content on Satellite does not work as expected. It produces the following error. “Error: No such sub-command 'bulk-upload'.”

BZ#1905041

Global registration curl command on FIPS-enabled RHEL8 host fails with error

Running the global registration curl command on FIPS-enabled RHEL8 host fails on katello-ca-consumer installation step with the following error. “Error: Transaction test error: package katello-ca-consumer-hostname.redhat.com-1.0-1.noarch does not verify: no digest”

BZ#1923320

Upgrading Satellite to the current version changes the default_download_policy

After upgrading Satellite to this version, the default_download_policy changes from "on_demand" to "immediate".

BZ#1914751

Syncing a Capsule from Satellite fails for some appstream repos

Note that this applies only to customers using Pulp 3 in limited beta. Please consult your TAM if you have any questions.

Syncing a Capsule running pulp2 from Satellite running pulp3 fails for some appstream repos.

BZ#1954839

Publishing a Content View fails on dynamic workflow step

Note that this applies only to customers using Pulp 3 in limited beta. Please consult your TAM if you have any questions.

Publishing a Content View with filters and solve dependencies set to true (depsolve=true) results in an assert failure. It fails on dynflow step Actions::Pulp3::Repository::MultiCopyContent.

BZ#1934545

5.3. Deprecated Functionality

The items in this section are either no longer supported, or will no longer be supported in a future release.

Bootstrap.py
The bootstrap.py script that was used to register a host to Satellite Server or Capsule Server has been replaced with the curl command created with the global registration template.
Puppet External Node Classifier (ENC)
Satellite’s support for Puppet and the ability to serve as the External Node Classifier (ENC) is deprecated and will be removed in a future release. Consider moving to Ansible for your automation and configuration needs or moving to external Puppet infrastructure.
Puppet Run API
The puppet run API endpoint /api/hosts/:id/puppetrun, the built in apidoc, and the CLI command have been deprecated in this version of Satellite.
Content ISOs on the CDN
Content ISOs that were available on the CDN are now deprecated in this version and will be removed in a future release. A connected Satellite can make content ISOs.
RHEV API V3
The RHEV API v3 has been deprecated in this version and will be removed in the next release.
Katello-agent
Katello-agent is deprecated and will be removed in the next release. Transition your workloads to use the remote execution feature.
pulp-puppet-module Builder
Puppet Content Management and pulp-puppet-module builder is deprecated in this version and will be removed in the next release.
OSTree and Puppet Content Type

The following management operations of OSTree and Puppet content types are deprecated and will be removed in the next release:

  • Creating OSTree and puppet repositories.
  • Synchronizing OSTree and puppet repositories.
  • Adding repositories of OSTree and puppet content types to content view.
  • Publishing and promoting the content views containing repositories of OSTree and puppet content types across life cycle environments.
Delta RPM (drpm) Support
Delta RPM (drpm) support is deprecated in this version and will be removed in the next release.
katello-ca-consumer Package
The katello-ca-consumer package has been deprecated in this version and will be removed in a future release. Use the global registration template for registering a host to Satellite.

5.4. Removed Functionality

Puppet Run
The puppet run functionality has been removed in this version of Satellite. This includes removal of the puppet run button and settings in the Satellite web UI, puppetrun_hosts permission in roles, and related options in the installer.
Statistics (Web UI page)
The Monitor > Statistics page in the Satellite web UI was deprecated in Satellite 6.8. It has now been removed in this version of Satellite.
Trends (Web UI page)
The Monitor > Trends page in the Satellite web UI was deprecated in Satellite 6.8. It has now been removed in this version of Satellite.
Generic & Host Boot Disks
The generic & host boot disks were deprecated in Satellite 6.8 and will be disabled in a future release of Satellite. The subnet and full host boot disks will be the only supported boot disk in the future.

Legal Notice

Copyright © 2021 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, 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.