Chapter 1. 4.0 Release Notes
1.1. Key Changes to the Documentation Set
The following changes were made to the RHUI documentation set for this release:
- Modular Documentation
- The Red Hat Update Infrastructure documentation is now available as task-focused guides and topics instead of a single guide that covers all the information. Additional features and product documentation will be available in this format in the future. For more information about modular documentation, see Red Hat’s product documentation is changing .
- Installation Guide
- The documentation includes a new guide, Installing Red Hat Update Infrastructure. The guide lists the components required for installation and provides detailed instructions to help cloud providers install Red Hat Update Infrastructure.
- Migration Guide
- The documentation includes a new guide, Migrating Red Hat Update Infrastructure. The guide lists the requirements and provides detailed instructions to help cloud providers migrate to Red Hat Update Infrastructure 4.
- Configuration and Management Guide
- The documentation includes a new guide, Configuring and Mananging Red Hat Update Infrastructure. The guide provides detailed instructions to help cloud providers set up and revise Red Hat Update Infrastructure 4.
- 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.
1.2. New Features
This part describes new features and major enhancements introduced in Red Hat Update Infrastructure 4.
- Red Hat Update Infrastructure now works on RHEL 8
- With this release, the RHUI source code has been ported to Python 3. This allows RHUI to run on RHEL 8 systems.
- Red Hat Update Infrastructure now supports Ansible
- With this release, Ansible support has been added to RHUI. This makes the RHUI installation process easier. It also makes debugging and maintaining the installation process more convenient.
- Pulp rebased to version 3
- With this release, the Pulp repository management platform has been rebased to version 3. This version provides many bug fixes and enhancements over the previous version, most notably it uses PostgreSQL instead of MongoDB to manage your data.
- Red Hat Update Infrastructure now supports faster synchronization of repositories
- With this release, the data in repositories is mirrored from the source rather than being generated locally. This allows RHUI to synchronize the repositories significantly faster.
- Ability to configure the number of stored repository versions
- With this release, you can use Pulp to limit the number of package versions to retain. This allows you to configure the number of repository versions stored by Pulp and reduces the size of repositories and metadata.
- Repository migration from RHUI 3 to RHUI 4
-
With this release, you can migrate repositories from your RHUI 3 environment to your new RHUI 4 environment using the
rhui-manager migrate
command. For more information, see Migrating Red Hat Update Infrastructure. rhui-manager
no longer fails to run in non-interactive mode-
Previously, when the
rhui-manager
command was run with the--noninteractive
option, it authenticated with the Pulp API using stored cookies. However, if these cookies had expired,rhui-manager
failed to run. Consequently, automatic synchronization of repositories on RHUA nodes failed. With this update,rhui-manager
reads stored credentials when run in a non-interactive mode, and the repository synchronization no longer fails. rhui-manager repo add_by_repo
command works as expected-
Previously, the
rhui-manager repo add_by_repo
command failed if a non-existent repository ID was specified in the command. Consequently,rhui-manager
exited indicating the status as1
, and failed to add any of the other valid repositories that may also have been specified in the command. With this update, ifrhui-manager
is run with a non-existent repository ID, it adds the other valid repositories specified in the command and indicates the status as0
. Otherwise, if it is unable to add any of the specified repositories, it indicates the status as1
. - CDS authorizer-cert plug-in no longer loads the incorrect certificate path
-
Previously, the CDS authorizer-cert plug-in loaded the SSL certificate path from the RHUA section of the
rhui-tools.conf
file. Consequently, the plug-in failed to function as expected. With this update, the issue has been fixed, and the plug-in now loads the SSL certificate path from the security section. rhui-subscription-sync
no longer fails to update existing repositories-
Previously, when the entitlement certificate was updated, the
rhui-subscription-sync
script failed to update existing repositories with the new certificate. Consequently, the repositories failed to synchronize. With this update, the script ensures that the existing repositories are properly updated with the new CA and entitlement certificates. As a result, the repositories no longer fail to synchronize. - FIPS mode is now supported in
rhui-manager
-
With this update, Federal Information Processing Standards (FIPS) mode is now supported in
rhui-manager
, which enables you to validate the quality of cryptographic modules.
RHUI will not be fully FIPS compliant until Pulp for RHUI is rebased to a version which is also FIPS compliant.
- Ansible playbook logs are now available
-
With this update, both
rhui-installer
andrhui-manager
logs are now available when the Ansible playbook is executed. These logs are available in the/var/log/rhui/
directory. - New command:
rhui-manager repo export
-
This update introduces the
rhui-manager repo export
command. You can use this command to export a repository to the file system from the command line. Note that the text-based RHUI user interface already contains this feature.
1.3. Deprecated Functionality
This part provides an overview of functionality that has been deprecated in Red Hat Update Infrastructure 4.
- Gluster is no longer supported
- Using Gluster to configure shared storage on RHUI 4 is no longer supported. Although you can still use Gluster to configure your storage, Gluster’s life cycle is coming to an end, therefore RHUI will not support Gluster for the remainder of its life cycle. It is recommended that you use NFS for shared storage instead.
1.4. Removed Functionality
This part provides an overview of functionality that has been removed in Red Hat Update Infrastructure 4.
- OSTree and container image are no longer supported
- OSTree and container image repositories can no longer be added to your RHUI systems. It is recommended that you use Yum repositories for managing your packages.
pulp-admin
command has been removed-
The
pulp-admin
command has been removed. The related sections of the documentation have been updated to reflect this change.
1.5. Technology Previews
This part provides a list of all Technology Previews available in Red Hat Update Infrastructure 4.
For information on Red Hat scope of support for Technology Preview features, see Technology Preview Features Support Scope.
- Repository version retention is now available as a Technology Preview
- The Pulp 3 version retention feature is now available as a Technology Preview. Using this feature you can set a retention value and configure pulp to store the corresponding number of repository versions.
1.6. Known Issues
This part describes known issues in Red Hat Update Infrastructure 4.
- Repository synchronization can sometimes fail
- Using Pulp to synchronize your repositories can sometimes fail. To work around this problem, try synchronizing the repositories again, the second iteration should be successful.
- Using
--remote-fs-type other
withrhui-installer
fails -
Setting the file system type as other, using
--remote-fs-type other
, when installing RHUI using therhui-installer
command does not set a valid file system type. As a result, the installation fails. To work around this problem, set the file system as NFS instead,--remote-fs-server <nfs_server>:/
. - Uploading package groups to custom repositories is currently not available
-
The
add_comps
sub-command is currently not available in RHUI 4.0. As a result, it is not possible to install package groups from custom repositories. There is no workaround available at the moment. - Creating an alternate source configuration does not work as expected
Using
rhui-manager
to create an alternate source client configuration repository fails with the following error:No usable repository found, not building the RPM.
There is no workaround available at the moment